copilot-instructions.md 1.9 KB

Instructions Copilot pour mafia-game

Modèle & Mode conseillé

  • Sélectionner le modèle : GPT-4.1
  • Activer le mode “agent” dans Copilot Chat pour des réponses adaptées au métier.

Environnement de développement

  • Système : macOS + MAMP (Apache, MySQL, PHP)
  • URL locale : https://map-generator
  • Base MySQL (via phpMyAdmin) :
    • hôte : localhost
    • port : 3306
    • utilisateur : root
    • mot de passe : root
    • base : map-generator
  • Manipulation locale : développez, interrogez et modifiez la base librement.
  • Adapter tous les exemples SQL/Laravel à cet environnement.

Archivage Copilot

  • Archiver toutes synthèses importantes via le dossier .specstory à la racine du projet.
  • Configurer et utiliser l’extension [SpecStory].

Clean Code & Architecture

  • Suivre les conventions Laravel (Eloquent, Query Builder, structure dossier).
  • Principes clés : lisibilité, simplicité, modularité, nommage explicite, zéro duplication.
  • Supprimer le code/fichiers morts ou inutiles.
  • Utiliser composants/fonctions/classes pour la logique métier.
  • Organiser en modules logiques.
  • Toutes les classes sont statiques.
  • Ne pas utilsier de namespaces.

  • Tests unitaires et fonctionnels obligatoires

  • Tous les commentaires doivent être en français.


  • Intégrer header, footer et menu dans toutes les vues
  • Séparer logique vue versus logique métier.

Internationalisation

  • Projet multilingue (FR/EN), FR par défaut
  • Toutes les chaînes via fichiers de langue Laravel.
  • Ajouter systématiquement les nouvelles chaînes de texte aux fichiers de langue.

Bonnes pratiques générales

  • Respecter le design system défini pour l’UI/UX.

Structures graphiques

  • Le header est l'ID : "global-header"
  • Le footer est l'ID : "global-footer"

Git

  • Commits clairs, descriptifs, en français.
  • Chaque commit = unité de travail cohérente et testée, code fonctionnel.