Repository navigation
12 glossaire
Public : tous les profils.
Ce glossaire unifie le vocabulaire du projet. L'une des faiblesses identifiées dans les audits est la coexistence de termes proches (Modules, Formations, Parcours, Mes formations) qui peuvent désorienter les utilisateurs. Ce glossaire sert de référence pour les développeurs, les formateurs, les interfaces et les communications externes.
Oneduc doit privilégier un vocabulaire simple côté stagiaire et plus précis côté formateur/admin.
| Niveau | Terme à afficher | Rôle |
|---|---|---|
| Expérience globale | Formation | Ce que le stagiaire suit concrètement |
| Organisation pédagogique | Parcours | Ordre préparé par le formateur pour un groupe |
| Bloc de contenu réutilisable | Module | Élément du catalogue ou créé par un formateur |
| Sous-partie du module | Chapitre | Partie structurante d'un module |
| Page de contenu | Leçon | Contenu précis à lire, regarder ou réaliser |
| Interaction | Activité | Quiz live, sondage, nuage de mots, tableau blanc, exercice, etc. |
| Public | Vocabulaire recommandé |
|---|---|
| Stagiaire | Ma formation, Continuer ma formation, Mon programme, Chapitre, Leçon, Activité |
| Formateur | Mes formations, Catalogue, Créations, Parcours, Outils d'animation, Groupes |
| Admin | Catalogue, Modules, Sections/chapitres, Leçons, Catégories, Évaluations |
| Code / base de données | Conserver les noms techniques existants (Module, ModuleSection, ModuleLecture, FormateurParcours) |
Côté stagiaire, le terme module doit être limité aux écrans où il aide vraiment à comprendre la structure. Le mot formation porte l'expérience principale : c'est le terme le plus naturel pour un public éloigné du numérique.
Mise à jour 2026 : le mot module a été retiré de l'interface formateur également, pour la même raison de simplicité (formateurs peu expérimentés). Ce que le modèle Module représente s'affiche désormais partout comme une formation — seuls le code, les noms de route (formateur.modules.builder.*) et la table modules gardent le nom technique. La page "Formations" du formateur (/formateur/formations) a trois onglets : Catalogue (formations du catalogue et des autres formateurs), Créations (formations créées par le formateur lui-même, ex-« Mes modules », toujours servie par /formateur/mes-modules), et Parcours (FormateurParcours, l'ordonnancement pédagogique préparé pour un groupe — ex-« Mes parcours de formation »).
Définition : Expérience globale suivie par un stagiaire. Dans l'interface stagiaire, "formation" désigne l'ensemble de ce qui lui est proposé, même si techniquement cela agrège un groupe, des modules et éventuellement un parcours.
Terme recommandé côté stagiaire : "Ma formation", "Continuer ma formation", "Mon programme"
À éviter côté stagiaire : multiplier les termes "module", "parcours" et "formation" sur le même écran.
Définition : Unité d'apprentissage thématique. Un module contient des chapitres, eux-mêmes composés de leçons. C'est un nom de modèle de données ; l'interface formateur/stagiaire ne l'affiche plus depuis 2026 (voir mise à jour ci-dessus).
Modèle : Module
Table : modules
Terme affiché en formateur/stagiaire : "Formation"
Synonymes à éviter côté admin : "cours"
Usage recommandé : brique de contenu réutilisable dans le catalogue ou dans les créations personnelles du formateur.
Exemple : "Formation Bureautique — Traitement de texte" (affiché) / modèle Module (code)
Définition : Subdivision d'un module. Regroupe plusieurs leçons autour d'un objectif pédagogique commun.
Modèle : ModuleSection
Table : module_sections
Terme dans l'interface : "Section" ou "Chapitre" selon le contexte
Exemple : "Chapitre 1 — Mise en forme"
Définition : Unité d'apprentissage élémentaire. Contient le contenu à proprement parler (SCORM, slides, quiz, vidéo).
Modèle : ModuleLecture
Table : module_lectures
Synonymes à éviter : "cours", "activité" (réservé aux outils live)
Exemple : "Leçon 1.2 — Les styles de paragraphe"
Définition : Séquence ordonnée de modules et d'activités créée par un formateur pour un groupe de stagiaires. Un parcours peut combiner des modules, des nuages de mots et des sondages.
Modèle : FormateurParcours + FormateurParcoursItem
Table : formateur_parcours, formateur_parcours_items
Types d'items actuels : module, wordcloud, poll
Terme recommandé côté formateur : "Parcours" ou "Mes parcours"
Terme dans le code : MesFormations (historique) → à renommer progressivement en "Parcours" dans l'interface
Exemple : "Parcours Inclusion Numérique Niveau 1"
Définition : Programme d'onboarding de la plateforme Oneduc elle-même, destiné aux formateurs. Ce n'est pas un parcours pour les stagiaires.
Modèle : Codé en dur dans app/Data/ParcoursFormateur.php
URL : /formateur/parcours-formateur
À distinguer de : "Parcours de formation" (ci-dessus)
Définition : Résultat d'apprentissage attendu pour une leçon. Associé à un référentiel de compétences (en cours d'implémentation).
Modèle : LectureObjective
Table : lecture_objectives
Définition : Exercice interactif lancé pendant ou après une leçon. Peut être un outil live (quiz, nuage de mots, sondage) ou un exercice SCORM.
Utilisé dans : FormateurParcoursItem (type activity), parcours formateur
Définition : Moment de synthèse à la fin d'un module dans le parcours formateur. Permet de faire le point avant de passer au module suivant.
Utilisé dans : Parcours formateur Oneduc (onboarding)
Définition : Rôle avec accès complet à la plateforme. Gère les utilisateurs, le catalogue de modules, les catégories, la configuration générale.
Champ : users.role = 'admin'
Espace : /admin
Définition : Animateur de formation. Crée et gère des groupes de stagiaires, leur affecte des modules, anime des sessions live, suit la progression.
Champ : users.role = 'formateur'
Espace : /formateur
Condition d'accès : adhésion active ou période de grâce
Définition : Formateur rattaché à un groupe dont il n'est pas le créateur. Il a les mêmes droits d'animation qu'un formateur principal sur ce groupe.
Champ : group_user.role_in_group = 'formateur'
Définition : Personne en formation. Accède aux modules de son groupe, participe aux outils live, consulte sa progression.
Champ : users.role = 'stagiaire'
Espace : /stagiaire
Mode d'accès : email/mot de passe ou code d'accès court
Définition : Rôle en lecture seule. Peut consulter les groupes et les progressions sans intervenir dans la formation.
Champ : users.role = 'observateur'
Espace : /observateur
Définition : Formateur créateur d'un groupe. Référencé par groups.instructor_id.
À distinguer de : Co-formateur
Définition : Unité organisationnelle qui relie un formateur principal, des stagiaires, des modules et éventuellement des co-formateurs et un parcours de formation.
Modèle : Group
Table : groups
Définition : Code alphanumérique à 6 caractères généré automatiquement par CodeGeneratorService. Permet à un stagiaire de se connecter sans passer par email/mot de passe.
Champ : users.code_acces
Utilisé pour : connexion stagiaire simplifiée
Définition : Mot de passe provisoire associé à un groupe, chiffré en base de données. Sert dans les flux d'invitation/rattachement gérés par le formateur.
Champ : groups.temporary_password (cast encrypted)
À distinguer de : Code d'accès (ci-dessus)
Définition : Standard e-learning (Sharable Content Object Reference Model) qui définit comment un package de formation communique avec un LMS. Oneduc supporte SCORM 1.2 et SCORM 2004.
Fichiers clés : public/scorm_core/js/API.js (SCORM 1.2), public/scorm_core/js/api_Scorm2004.js (SCORM 2004)
Définition : Représentation unifiée de l'état d'un apprenant sur une leçon à un instant T, calculée par LearningAnalyticsService. Agrège toutes les sources de progression.
Méthode : LearningAnalyticsService::collectSnapshots()
Définition : Statut d'adhésion d'un formateur à l'association Oneduc.
Champs : users.adhesion_status (active, pending, expired), users.adhesion_valid_until
Middleware associé : EnsureAssociationMembership
Les termes suivants coexistent dans l'interface et créent parfois de la confusion. La normalisation retenue (mise à jour 2026) est :
| Terme historique | Décision retenue | Explication |
|---|---|---|
| "Catalogue de modules" (formateur) | "Catalogue" | Onglet de la page Formations ; liste les Module du catalogue et des autres formateurs |
"Mes modules" (formateur, ModuleBuilderController) |
"Créations" | Onglet de la page Formations ; création/gestion des Module propres au formateur |
| "Mes parcours de formation" (formateur) | "Parcours" | Onglet de la page Formations ; désigne les FormateurParcours construits pour un groupe |
| "Ma formation" (stagiaire) | "Ma formation" | Terme principal à conserver côté apprenant, inchangé |
| "Parcours formateur" | "Parcours formateur Oneduc" | Désigne l'onboarding du formateur dans la plateforme — vocabulaire distinct, non concerné par la simplification module→formation |
| "Outils" (stagiaire) | "Activités de groupe" | Proposition non appliquée à ce jour |
| "Documentation" (stagiaire) | "Ressources" | Proposition non appliquée à ce jour |
| Bouton de reprise stagiaire | "Continuer ma formation" | Action la plus lisible pour reprendre là où il s'est arrêté |
| Contexte | Libellé recommandé |
|---|---|
| Menu stagiaire principal | "Ma formation" |
| Bouton principal dashboard stagiaire | "Continuer ma formation" |
| Liste stagiaire | "Mon programme" ou "Étapes de la formation" |
Onglet formateur pour FormateurParcours
|
"Parcours" |
Onglet formateur pour ModuleBuilderController
|
"Créations" |
| Onglet catalogue formateur/admin | "Catalogue" |
| Outils live | "Outils d'animation" côté formateur, "Activités de groupe" côté stagiaire |