🚀 Coding Tool Box – Guide d'installation

Bienvenue dans Coding Tool Box, un outil complet de gestion pédagogique conçu pour la Coding Factory.
Ce projet Laravel inclut la gestion des groupes, promotions, étudiants, rétro (Kanban), QCM dynamiques, et bien plus.

---

📦 Prérequis

Assurez-vous d’avoir les éléments suivants installés sur votre machine :

• PHP ≥ 8.1
• Composer
• MySQL ou MariaDB
• Node.js + npm (pour les assets frontend si nécessaire)
• Laravel CLI (composer global require laravel/installer)

---

⚙️ Installation du projet

Exécutez les étapes ci-dessous pour lancer le projet en local :

1. Cloner le dépôt

git clone https://m_thibaud@bitbucket.org/m_thibaud/projet-web-2025.git
cd coding-tool-box
cp .env.example .env

2. Configuration de l'environnement

✍️ Ouvrez le fichier .env et configurez les paramètres liés à votre base de données :

DB_DATABASE=nom_de_votre_bdd
DB_USERNAME=utilisateur
DB_PASSWORD=motdepasse

3. Installation des dépendances PHP

composer install

4. Nettoyage et optimisation du cache

php artisan optimize:clear

5. Génération de la clé d'application

php artisan key:generate

6. Migration de la base de données

php artisan migrate

7. Population de la base (Données de test)

php artisan db:seed

---

💻 Compilation des assets (si nécessaire)

npm install
npm run dev

---

👤 Comptes de test disponibles

Rôle	Email	Mot de passe
Admin	admin@codingfactory.com	123456
Enseignant	teacher@codingfactory.com	123456
Étudiant	student@codingfactory.com	123456

---

🚧 Fonctionnalités principales

• 🔧 Gestion des groupes, promotions, étudiants
• 📅 Vie commune avec système de pointage
• 📊 Bilans semestriels étudiants via QCM générés par IA
• 🧠 Génération automatique de QCM par langage sélectionné
• ✅ Système de Kanban pour les rétrospectives
• 📈 Statistiques d’usage et suivi pédagogique

📚 Suivi de Projet

✅ Fonctionnalités Implémentées

Story	Statut	Description
Story 1	✅ Complète	Fonctionnalité entièrement terminée.
Story 2	✅ Complète	Association d’un enseignant à une promotion via l’update des enseignants.
Story 3	✅ Complète	Association d’un étudiant à une promotion en cliquant sur la promotion.
Story 4	✅ Complète	Fonctionnalité entièrement terminée.
Story 5	✅ Complète	Fonctionnalité entièrement terminée.
Story 6	⚠️ Partielle	Modification du mail, mot de passe, et suppression de compte possibles.

---

⚠️ Fonctionnalités Manquantes ou Bugs Connus

Élément	Type	Description
Story 6	Manque	Modification de la photo de profil non implémentée.
Story 3	Bug	Les dates d’anniversaire des étudiants affichent la date actuelle.

---

🎁 Bonus Implémenté

• ✔️ Reprise de l’ancienne Story 2 :
  • L’élève peut pointer et laisser un commentaire pour sa tâche de vie commune.
  • Il peut également modifier le statut de ses bilans de connaissance (À faire, En cours, Terminé).

---