đŸ› ïž D&D: Phase 0 > Mise en place des projets

Voici une page complĂšte de consignes dĂ©diĂ©e Ă  la mise en place du projet : hĂ©bergement GitHub, gestion de projet avec Trello, et configuration de l’environnement de dĂ©veloppement avec XAMPP ou Laragon.

🎯 Objectif

Avant de commencer Ă  dĂ©velopper, tu dois mettre en place une organisation claire de ton projet :

  • Une gestion de code versionnĂ© sur GitHub
  • Un suivi de tĂąches avec Trello en mode Kanban
  • Une configuration d’un environnement de dĂ©veloppement local fonctionnel

📋 Trello – Organisation Kanban

đŸ”č Pourquoi Trello ?

Trello est un outil de gestion visuelle de projet, parfait pour suivre l’avancement d’un projet logiciel. 👉 https://trello.com

🔧 Mise en place

  1. CrĂ©e un tableau Trello nommĂ© Projet D&D – [Ton prĂ©nom]

  2. Crée au moins ces 5 colonnes :

    • Backlog (idĂ©es, besoins, specs)
    • To Do (tĂąches prĂȘtes Ă  ĂȘtre commencĂ©es)
    • Doing (tĂąches en cours)
    • Testing (tĂąches en cours de test)
    • Done (terminĂ©)
  3. Crée des user stories claires :

    En tant que joueur, je veux crĂ©er un personnage pour pouvoir l’utiliser dans le jeu. En tant qu’utilisateur, je veux voir les dĂ©tails de mon personnage dans une interface propre. En tant que dĂ©veloppeur, je veux pouvoir tester les actions d’un personnage contre un ennemi.

  4. Ajoute des étiquettes (labels) pour chaque partie :

    • Éditeur (PHP)
    • Viewer (Flask)
    • Jeu (Pygame)
    • DB (modĂ©lisation et SQL)
    • Data (insertion, API, fichiers JSON
)

Ce ne sont que des exemples. Tu peux en ajouter d'autres ou utiliser les tiennes, tant qu'elles ont du sens.

  1. Mets ton Trello à jour chaque jour. C’est un livrable obligatoire.

Parfait. Voici la section mise Ă  jour et adaptĂ©e Ă  ta consigne pĂ©dagogique : 👉 1 dĂ©pĂŽt par technologie (PHP, Flask, Pygame), avec des explications claires pour crĂ©er un dĂ©pĂŽt sur GitHub et le rĂ©cupĂ©rer directement dans Visual Studio Code (sans ligne de commande).


🧠 Git, GitHub & Visual Studio Code

🎯 Objectif

Pour organiser correctement ton projet, tu vas créer un dépÎt GitHub séparé pour chaque technologie utilisée :

Projet Technologie Nom du dépÎt recommandé
Éditeur de personnages PHP + MySQL dd-editeur-php
Visualisateur Flask (Python) + Bootstrap dd-viewer-flask
Mini-jeu Pygame dd-jeu-pygame

Chaque dépÎt contiendra son propre code, README, fichiers de configuration, base de données, etc.


🐙 Étape 1 – CrĂ©er un dĂ©pĂŽt GitHub

  1. Connecte-toi sur https://github.com

  2. Clique sur le bouton + > New repository

  3. Renseigne les champs suivants :

    • Repository name : par exemple dd-editeur-php
    • Description : "Éditeur de personnages pour le projet D&D"
    • Visibility : privĂ© (selon ton choix)
  4. Clique sur Create repository

  5. Tu arrives sur une page avec l’URL de ton dĂ©pĂŽt GitHub, par exemple :

    https://github.com/ton-nom-utilisateur/dd-editeur-php.git
    

đŸ–„ïž Étape 2 – Cloner le dĂ©pĂŽt dans Visual Studio Code

  1. Ouvre Visual Studio Code

  2. Clique sur "Cloner un dĂ©pĂŽt Git" dans la page d’accueil (ou Ctrl + Shift + P > "Git: Clone")

  3. Colle l’URL de ton dĂ©pĂŽt GitHub (par ex. https://github.com/...)

  4. Choisis un dossier de destination sur ton ordinateur (par exemple Documents/Projets)

  5. VS Code te propose d’ouvrir directement le projet clonĂ© → clique sur "Ouvrir"

  6. Une fois ouvert :

    • Tu peux commencer Ă  coder
    • Un dossier .git est dĂ©jĂ  prĂ©sent
    • VS Code est dĂ©jĂ  liĂ© Ă  GitHub, tu peux committer et pusher facilement

🔁 Travailler au quotidien

  1. Fais tes modifications dans ton projet
  2. Va dans l’onglet Contrîle de source (icîne avec trois branches)
  3. Écris un message de commit clair
  4. Clique sur ✔ pour valider (commit)
  5. Clique sur ↕ pour synchroniser (push/pull)

RépÚte cette opération réguliÚrement aprÚs chaque tùche terminée.


✅ À retenir

  • Un dĂ©pĂŽt par technologie = meilleure organisation
  • Clonage depuis VS Code = facile et visuel, sans ligne de commande
  • Commits frĂ©quents = bonne Ă©valuation, bon suivi

đŸ–„ïž Environnement local : XAMPP ou Laragon

đŸ”č Pourquoi ?

Tu dois avoir un environnement local pour exĂ©cuter ton code PHP/MySQL sans dĂ©pendre d’un serveur externe.

🔧 XAMPP

🔧 Laragon (alternative conseillĂ©e)

Laragon étant devenu payant, je te conseille de télécharger une ancienne version gratuite. Elle se trouve sur la page "installer PHP de ce site"

  • TĂ©lĂ©charge ici : https://laragon.org/download/

  • Environnement plus lĂ©ger et plus simple Ă  configurer

  • CrĂ©e automatiquement des virtual hosts :

    • Tu peux accĂ©der Ă  ton site via http://mon-projet.test
    • Dossier de travail : C:\laragon\www\mon-projet

Utilise phpMyAdmin (inclus) pour gérer visuellement ta base MySQL.


✅ Livrables attendus pour cette Ă©tape

ÉlĂ©ment DĂ©tail attendu
GitHub Repo(s) public(s) actif(s), README avec titre et description
Commits réguliers Historique clair et progressif du projet
Trello Tableau Trello fonctionnel et à jour avec user stories, colonnes, étiquettes
Environnement fonctionnel Projet PHP testable en local via XAMPP ou Laragon

Pour aller plus loin