Initial commit

instruction.md

@@ -0,0 +1,88 @@
+📋 Plan de l'Application : RecruitQuizz ProCe document détaille les spécifications pour une plateforme de gestion de candidatures et d'évaluation technique.1. Architecture TechniqueBackend : Laravel 12 (PHP 8.4+)Frontend : Vue.js 3 ou React (via Vite) pour une interface réactive.Base de données : PostgreSQL ou MySQL.Stockage : Driver local ou S3 pour les CV et lettres de motivation.Authentification : Laravel Breeze ou Jetstream (pour gérer les deux types d'accès : Admin et Candidat).2. Structure des Données (Modèles)Voici les entités principales à générer :Candidate : Nom, email, téléphone, liens (GitHub/LinkedIn), status (en attente, testé, retenu).Document : Type (CV, LM), chemin du fichier, lié au Candidat.Quiz : Titre, description, temps imparti.Question : Libellé, type (QCM, texte court), points.Option : Les réponses possibles pour les QCM.Attempt (Essai) : Score final, temps passé, réponses du candidat, statut (terminé ou en cours).3. Fonctionnalités Clés🔐 Espace Administration (Ton interface)Dashboard : Vue d'ensemble (nombre de candidats, moyenne des scores).Gestion des Candidats : * Formulaire de création (Nom, Prénom, Email).Upload de documents avec prévisualisation PDF intégrée.Bouton "Générer Accès" : crée automatiquement un compte utilisateur avec un mot de passe unique.Banque de Questions : Interface pour saisir tes 40 questions et définir la bonne réponse.Comparateur : Tableau triable par score, temps de réponse et date de candidature.📝 Espace Candidat (Interface d'examen)Login Dédié : Accès restreint au quiz assigné.Interface Quiz : * Affichage une question à la fois.Barre de progression et compte à rebours.Sauvegarde automatique des réponses en base de données (pour éviter les pertes en cas de crash navigateur).Fin de test : Message de remerciement (sans afficher le score immédiatement, pour garder la main sur le feedback).4. Logique de ScoringPour comparer efficacement, nous utiliserons un calcul de score pondéré. Si $S$ est le score final, $n$ le nombre de questions, et $w$ le poids de chaque question :$$S = \sum_{i=1}^{n} (réponse_{i} \times poids_{i})$$Tu pourras également intégrer un ratio "Précision/Temps" pour départager deux candidats ayant le même score.5. Roadmap de Développement pour AntigravityDemande à Antigravity de suivre ces étapes dans l'ordre :Step 1 : Setup de Laravel 12 avec l'authentification multi-auth (Admin vs User).Step 2 : Création des migrations pour candidates, quizzes, questions et attempts.Step 3 : Développement du système d'upload de fichiers sécurisé (seul l'admin doit pouvoir lire les CV).Step 4 : Création du moteur de rendu du quiz côté Frontend (Vite/Vue).Step 5 : Développement de la vue "Comparatif" avec filtres et graphiques simples pour les scores.
+
+
+Structure de la Base de Données
+Rôle : Agis en tant qu'expert Architecte Laravel.
+Objectif : Générer les migrations, les modèles et les relations Eloquent pour une application de recrutement appelée "RecruitQuizz".
+Stack : Laravel 12, PHP 8.4.
+
+Instructions techniques : > Crée les migrations et les modèles avec les champs et relations suivants :
+
+User : Utilise la table par défaut mais ajoute un champ role (enum: admin, candidate).
+
+Candidate : >    - Champs : user_id (FK), phone, linkedin_url, status (en_attente, en_cours, termine).
+
+Relation : BelongsTo User, HasMany Documents, HasMany Attempts.
+
+Document : >    - Champs : candidate_id (FK), type (cv, cover_letter), file_path, original_name.
+
+Relation : BelongsTo Candidate.
+
+Quiz : >    - Champs : title, description, duration_minutes (default 60).
+
+Relation : HasMany Questions.
+
+Question : >    - Champs : quiz_id (FK), label (text), points (int), type (qcm, open).
+
+Relation : BelongsTo Quiz, HasMany Options.
+
+Option : >    - Champs : question_id (FK), option_text, is_correct (boolean).
+
+Relation : BelongsTo Question.
+
+Attempt (Essai) : >    - Champs : candidate_id (FK), quiz_id (FK), score (float, nullable), started_at, finished_at (nullable).
+
+Relation : BelongsTo Candidate, BelongsTo Quiz, HasMany Answers.
+
+Answer : >    - Champs : attempt_id (FK), question_id (FK), option_id (FK, nullable pour questions ouvertes), text_content (text, nullable).
+
+Livrables attendus : > - Fichiers de migration complets avec contraintes d'intégrité (onDelete cascade).
+
+Modèles PHP avec les propriétés $fillable et les méthodes de relations (HasMany, BelongsTo).
+
+Interface Admin & UX
+Rôle : Expert Frontend & UI/UX Designer.
+Objectif : Créer les vues Blade/Vue.js pour le Dashboard Admin de "RecruitQuizz" en utilisant Tailwind CSS.
+
+Directives de Design :
+
+Style : Minimaliste, professionnel, mode sombre (dark mode) supporté.
+
+Framework : Utiliser les composants Tailwind CSS (ou Flowbite/Headless UI).
+
+Navigation : Une barre latérale (sidebar) fixe avec les sections : Dashboard, Candidats, Quiz, Comparateur.
+
+Pages à générer :
+
+Tableau de Bord (Index) : >    - 4 "Stats Cards" en haut : Total Candidats, Tests terminés, Moyenne Générale, Meilleur Score.
+
+Un graphique simple (Chart.js) montrant la distribution des scores.
+
+Gestion des Candidats (Liste & Création) :
+
+Un tableau (Datatable) avec recherche et filtres.
+
+Un modal de création incluant l'upload de fichiers (Drag & Drop) pour le CV et la Lettre de Motivation.
+
+Indicateurs visuels par badge pour le statut (ex: Success pour "Terminé", Warning pour "En attente").
+
+Profil Candidat (Détails) :
+
+Un panneau latéral ou une vue scindée : à gauche les infos/documents, à droite les résultats détaillés du quiz.
+
+Intégration d'un Iframe ou Viewer PDF pour consulter le CV sans le télécharger.
+
+Vue de Comparaison (Le "Leaderboard") :
+
+Un tableau comparatif permettant de cocher 2 ou 3 candidats pour comparer leurs scores par catégorie de questions.
+
+Colonnes : Nom, Score %, Temps passé, Date, Actions.
+
+Livrables attendus :
+
+Layout principal (App Layout).
+
+Templates Blade avec composants réutilisables.
+
+Scripts Vite pour la gestion des interactions (modaux, upload).
+