Repository navigation
04 profils utilisateurs
Public : tous les profils. Les détails techniques (routes, middleware) sont regroupés sous chaque rôle et en fin de page.
La plateforme distingue quatre rôles. Chacun a son espace, son interface et ses droits. Un stagiaire ne voit jamais un écran de gestion ; un observateur ne peut rien modifier.
| Rôle | Espace | Peut créer du contenu |
|---|---|---|
| Admin | /admin |
Oui (tout) |
| Formateur | /formateur |
Oui (groupes, parcours, modules) |
| Stagiaire | /stagiaire |
Non |
| Observateur | /observateur |
Non |
L'administrateur pilote la plateforme. Il gère le catalogue de modules, les comptes utilisateurs, les groupes, les catégories, les référentiels de compétences, les badges et les évaluations. Ses actions d'écriture réussies sont journalisées automatiquement.
Utilisateurs : consulter un répertoire dense des formateurs et stagiaires, le filtrer par rôle, statut ou rattachement à un groupe, le rechercher et le paginer ; créer, modifier, activer ou désactiver ces comptes. Le rôle choisi à la création est ensuite immuable. Pour un formateur, l'administrateur gère aussi l'entreprise et l'adhésion. Pour un stagiaire, il choisit le formateur principal et les groupes ; un code d'accès unique de six caractères est généré si le champ reste vide. Les observateurs conservent leur interface d'administration séparée.
Groupes : créer ou modifier un groupe en choisissant obligatoirement un formateur principal et, si nécessaire, des stagiaires existants ; consulter le nombre de membres et supprimer un groupe après confirmation.
Progression stagiaire : remettre à zéro, dans une transaction unique, les quiz, progressions, temps de connexion, suivis vidéo et données SCORM classiques, d'évaluation et de blocs modernes.
Contenu pédagogique : créer les modules du catalogue avec leurs sections et leçons, importer des packages SCORM et des slides, gérer la banque de questions quiz (avec import CSV), les évaluations SCORM et les catégories.
Pilotage : un module interne de suivi de projets (Kanban, tâches, journal, notifications), les référentiels de compétences, la consultation des retours stagiaires.
Tableau de bord : indicateurs volumétriques (nombre de modules, formateurs, stagiaires, groupes, leçons...).
Exporter des données en CSV ou PDF, générer des certificats, gérer plusieurs organisations.
Routes : routes/admin.php — middleware auth + role:admin + admin.activity.
Le contrôleur UtilisateurController et les routes admin.utilisateurs.* gèrent uniquement les rôles formateur et stagiaire. La création impose un email unique et un mot de passe confirmé d'au moins 12 caractères. La modification vérifie aussi l'unicité de l'email en excluant le compte courant ; le profil de l'administrateur applique désormais la même règle.
Pour un stagiaire, les rattachements sélectionnés sont synchronisés dans group_user avec role_in_group = 'stagiaire'. Si aucun formateur_id n'est fourni mais qu'un groupe est sélectionné, le formateur principal du premier groupe devient le formateur référent. Pour un formateur, les statuts d'adhésion acceptés sont pending, active et expired ; une adhésion activée sans date reçoit par défaut une validité d'un an.
Le middleware RecordAdminActivity journalise les actions POST/PUT/PATCH/DELETE réussies dans activity_journal_entries. Les nouveaux formulaires utilisateurs n'y versent pas les noms, coordonnées, identifiants, mots de passe ni codes d'accès ; les informations opérationnelles non nominatives, comme le rôle ou le statut, peuvent rester dans le contexte. La remise à zéro passe par admin.stagiaires.reset, protégée par la chaîne complète et refusée si le compte ciblé n'est pas stagiaire.
Avertissement — suppressions destructives : le trait
SoftDeletesdu compte ne rend pas toutes les données récupérables. Supprimer un stagiaire efface immédiatement de nombreuses données pédagogiques liées. Supprimer un formateur supprime physiquement ses groupes et peut aussi supprimer les stagiaires qui ne disposent d'aucun autre rattachement. La suppression d'un groupe admin est elle aussi physique. Ces actions doivent rester exceptionnelles et être confirmées après vérification des rattachements.
Le formateur est le rôle central côté terrain. Il crée ses groupes, y ajoute des stagiaires, leur affecte des modules, anime des séances et suit les progressions.
Son accès dépend de son adhésion à l'association : adhésion active, ou compte de moins d'un mois en attente d'adhésion. Au-delà, il est redirigé vers la page d'adhésion.
Groupes : créer, modifier, activer ou désactiver un groupe ; générer un code d'accès pour les stagiaires ; ajouter des stagiaires existants ou en créer avec invitation par mail ; inviter des co-formateurs ; affecter des modules dans un ordre choisi ; masquer ou réordonner des leçons pour un groupe précis.
Suivi : vue par groupe (taux de réussite, stagiaires actifs, inactifs, non démarrés), vue par stagiaire leçon par leçon, vue par module, repérage des apprenants à risque.
Parcours : assembler des modules, nuages de mots et sondages dans un parcours ordonné, puis l'associer à un groupe. Dans l'interface, ce sont "Mes parcours".
Modules personnels : créer ses propres modules dans un éditeur de plan continu (chapitres et leçons, réordonnancement au clavier ou à la souris, duplication de leçon), éditer chaque leçon en blocs de contenu (texte, image, citation, séparateur), téléverser ses images, ou dupliquer un module du catalogue pour l'adapter. Les modules personnels n'apparaissent pas dans le catalogue public.
Limite à connaître : les leçons SCORM ou slides copiées depuis le catalogue restent dans la copie, mais leur contenu importé n'est pas modifiable — seul le titre peut être renommé.
Animation : tous les outils live (voir Outils d'animation).
Ressources : ajouter des liens ou fichiers à une leçon, avec visibilité stagiaire réglable par ressource.
Importer lui-même un package SCORM complet (l'import reste côté admin), exporter les données de son groupe, générer des badges ou certificats en fin de parcours.
Routes : routes/formateur.php — middleware auth + role:formateur + association.member.
Politique d'adhésion (EnsureAssociationMembership) : accès si adhesion_status = active avec adhesion_valid_until non dépassée, ou adhesion_status = pending avec created_at + 30 jours > aujourd'hui.
Un formateur accède à un groupe soit comme instructor_id, soit comme co-formateur via group_user.role_in_group = 'formateur'. Le scope Group::scopeAccessibleByTrainer() couvre les deux cas — à utiliser systématiquement dans les contrôleurs formateur.
La personnalisation des leçons par groupe passe par group_module_lectures. Les modules personnels sont marqués is_trainer_authored = true et leurs images stockées dans modules_formateur/module_{id}/images. Les blocs de leçon acceptés : text, image, list, quote, divider.
Le stagiaire accède à sa formation, suit ses leçons, répond aux quiz et participe aux activités lancées par le formateur. Son interface est volontairement épurée.
Le mode classique : email et mot de passe. Le mode code d'accès : un code alphanumérique de 6 caractères, sans email ni mot de passe. C'est le mode privilégié pour les publics éloignés du numérique.
À la première connexion, le stagiaire doit définir un nouveau mot de passe avant d'accéder à son espace.
Tableau de bord : son formateur référent (affiché en permanence), son temps d'apprentissage, son taux de réussite, sa progression par module.
Formation : "Ma formation" et le programme de son groupe, la navigation chapitre → leçon, la lecture des leçons SCORM, slides, vidéos et quiz. La progression se marque automatiquement.
Résultats : l'historique de ses tentatives de quiz, question par question, et ses scores SCORM.
Outils : les activités live lancées par le formateur.
Profil : modification de ses informations, de son mot de passe, et suppression de son compte.
Un stagiaire présent dans plusieurs groupes actifs ne voit que les modules du premier groupe. C'est un bug identifié, à corriger en phase 2.
Routes : routes/stagiaire.php — middleware auth + role:stagiaire + track.time + force.password.change (hors routes de première connexion).
Connexion par code : POST /stagiaire/connexion-code (UserController::loginByCode()), sur users.code_acces. Le middleware ForcePasswordChange bloque tant que users.password_changed_at est nul (validation min:8).
Le bug multi-groupe vient du .first() dans StagiaireController::StagiaireModules(). L'accès direct aux leçons repose encore surtout sur Module::isVisibleTo() ; la vérification d'appartenance doit être centralisée via policies avant publication large.
L'observateur consulte sans intervenir. Il voit les groupes auxquels il est rattaché, la progression des stagiaires et les leçons de ces groupes, en lecture seule. Le rôle a été ajouté en mars 2026 — typiquement pour un coordinateur, un financeur ou un tuteur.
Routes : routes/observateur.php — middleware auth + role:observateur.
Rattachement aux groupes via group_user.role_in_group = 'observateur'.
Admin
└── Tout faire (CRUD contenu, utilisateurs, configuration)
Formateur (avec adhésion active)
└── Gérer ses groupes
└── Affecter modules (du catalogue admin)
└── Gérer ses stagiaires
└── Animer des sessions live
└── Consulter la progression
Stagiaire
└── Accéder aux modules de son groupe
└── Passer des quiz
└── Participer aux outils live
└── Consulter sa progression
Observateur
└── Lire les progressions de ses groupes (lecture seule)