Skip to content
Laurent Staelens edited this page Oct 11, 2026 · 14 revisions

Wiki Oneduc — Documentation du projet

Bienvenue sur la documentation d'Oneduc, un LMS dédié à l'inclusion numérique et à la formation accompagnée.


Par où commencer selon votre profil

Tout le wiki n'est pas à lire par tout le monde. Voici les parcours conseillés :

Formateur — vous voulez savoir ce que la plateforme permet de faire : Présentation → Profils utilisateurs → Groupes & Parcours → Outils d'animation → Émargement → Génération de contenu par IA → Tableaux de bord. Le Glossaire sert de référence pour le vocabulaire.

Développeur — vous voulez contribuer au code : Installation → Architecture → Roadmap, puis les pages du domaine sur lequel vous travaillez. Lisez la Checklist de publication avant tout travail touchant à la sécurité.

Partenaire ou financeur — vous voulez situer le projet : Présentation et Roadmap suffisent.

Responsable produit ou projet — vous voulez construire ou réviser le cahier des charges : Dossier de cadrage produit et technique → PRD → App Flow → UI/UX Design → TRD → Backend Schema → Implementation Plan.

Administrateur système : Installation → Sécurité & RGPD.

Chaque page indique en tête son public visé. Les pages mixtes regroupent la partie technique en fin de page.


Table des matières

# Page Résumé
01 Présentation du projet Vision, usages possibles, bilan fonctionnel, trajectoire produit
02 Installation & configuration Prérequis, mise en route dev, variables d'environnement
03 Architecture technique Structure Laravel, routing multi-rôle, services, schéma SQL baseline
04 Profils utilisateurs Admin, Formateur, Stagiaire, Observateur — droits et espaces
05 Modules, SCORM & Quiz Contenu pédagogique, builder formateur, import SCORM, quiz natifs, progression
06 Groupes & Parcours Groupes de formation, co-formateurs, parcours ordonnés
07 Outils d'animation pédagogique Activités live intégrées, tableau blanc, minuteur, pages collaboratives — sommaire avec une fiche dédiée par outil
08 Tableaux de bord Analytics Admin, Formateur, Stagiaire — sources de données
09 Design system Tokens Tailwind, composants, typographie, accessibilité
10 Sécurité & RGPD Middleware, authentification, données personnelles
11 Roadmap Feuille de route en 4 phases, bugs connus, dette technique
12 Glossaire Vocabulaire unifié du projet
13 Prêt à publier sur GitHub Checklist avant publication — sécurité, licence, nettoyage
15 Génération de contenu par IA Génération de leçons/formations par IA (Mistral), garde-fous, configuration
16 Émargement Feuille de présence par séance datée, signature graphique, export PDF Qualiopi/OPCO
17 Audit site du 14 juillet 2026 Suivi de l'audit du 5 juillet, faille d'accès module corrigée, crawl public 100% sain
20 Cahier des charges produit et technique Comparatif, PRD, TRD, App Flow, UI/UX Design, Backend Schema et plan de réalisation

Cahier des charges produit et technique

Le dossier de cadrage compare l'existant aux livrables attendus et propose un ordre de construction. Les documents sont des trames préremplies à valider avec les parties prenantes.

Livrable Rôle
PRD Besoins, publics, périmètre et critères d'acceptation
TRD Architecture, contraintes et exigences techniques
App Flow Parcours utilisateurs, décisions et erreurs
UI/UX Design Expérience, interfaces et accessibilité
Backend Schema Données, relations, droits et contrats serveur
Implementation Plan Lots, dépendances et preuves de validation

Pages archivées

Pages conservées pour l'historique, remplacées par une page plus récente.

# Page Remplacée par
14 Audit site du 5 juillet 2026 Audit site du 14 juillet 2026

Licence & gouvernance

Oneduc est distribué sous licence GNU Affero General Public License v3 (AGPL v3).

Concrètement :

  • tout le monde peut utiliser, modifier et redistribuer Oneduc librement ;
  • toute modification redistribuée, y compris en mode SaaS hébergé, doit être publiée sous la même licence ;
  • l'usage commercial est possible sous conditions de réciprocité — contactez l'association pour une licence commerciale.

Titulaire des droits : Association Oneduc (loi 1901) Contributions : soumises au Contributor License Agreement Gouvernance : pilotée par l'Association Oneduc via ses instances statutaires

Fichiers légaux à la racine du projet :

Fichier Rôle
LICENSE Texte de la licence AGPL v3
NOTICE Copyright et crédits des dépendances
CONTRIBUTING.md Guide de contribution
CLA.md Contributor License Agreement
SECURITY.md Politique de signalement des failles
CODE_OF_CONDUCT.md Code de conduite de la communauté

Autres ressources du dossier docs/


État vérifié du dépôt

Analyse réalisée le 14 juillet 2026 depuis /var/www/Oneduc_Dev (voir Audit du 14 juillet 2026 pour le détail).

Vérification Résultat
Routes Laravel 513 routes déclarées (php artisan route:list --json)
Crawl public 23 routes GET publiques sans paramètres testées : 22 en HTTP 200, /inscription en redirection 301 volontaire — 0 erreur 500
Tests automatisés php artisan test : 268 tests passés, 0 échec, 1295 assertions
Build frontend npm run build réussi, avec avertissements Vite sur les chunks volumineux
Schéma base de données Baseline MySQL dans database/schema/mysql-schema.sql + migrations post-baseline, toutes marquées Ran localement
Point d'attention publication Historique Git à vérifier avant publication ; dette technique restante documentée dans 11-roadmap.md

Dernière mise à jour documentaire : 11 octobre 2026 (ajout du cahier des charges). Les résultats applicatifs ci-dessus sont ceux de l'audit du 14 juillet 2026.

Clone this wiki locally