@mostajs/training 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog — @mostajs/training
+## [0.1.0] — 2026-06-18
+### Added
+- Catalogue (Course/Level CEFR) + sessions (open/code/cancel) + inscriptions (capacité, full/open, idempotence). Compose numbering/notifications.
+- EXTRACTION du modèle course-builder iquesta. 7 tests + exemple §12 (cohorte ATC Anglais A1).

package/README.md

@@ -0,0 +1,12 @@
+# @mostajs/training
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later · **Statut** : 0.1.0 (7 tests verts)
+> Catalogue formations à niveaux + sessions/groupes + inscriptions (capacité). Extraction iquesta. Compose numbering/notifications/booking.
+```js
+import { createTraining, createMemoryRepositories } from '@mostajs/training';
+const t = createTraining({ repositories: createMemoryRepositories() });
+const c = await t.catalog.createCourse({ title:'Anglais', category:'langues' });
+await t.catalog.addLevel(c.id,{ order:1, label:'A1' });
+const s = await t.sessions.open({ courseId:c.id, capacity:12 });
+await t.enrollments.enroll(s.id, learnerId);   // throw CapacityReached si plein
+```
+Lancer : `node test-scripts/unit/training.test.mjs && node examples/cohorte/run.mjs`

package/docs/00-PROPOSITION-PLAN-TRAINING-18062026.md

@@ -0,0 +1,13 @@
+# @mostajs/training — DEVRULES de bout en bout (§4 + #3 + #4 condensés)
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Date** : 2026-06-18 · **Statut** : cas C (P0, commun P1+P2)
+**Principe** : EXTRACTION du modèle course-builder d'iquesta-dev (Formation/Activity → Course/Level/Session/Enrollment).
+Étude #1 détaillée + protocole §8 : `mosta-training/docs/01-ETUDE-ETAT-ART-TRAINING-18062026.md`.
+## §4 / §3
+Catalogue de formations à **niveaux** (CEFR généralisé) + **sessions/groupes** + **inscriptions** (contrôle de capacité).
+DB-agnostique. **Compose** : booking (planning séances), numbering (code session), notifications. **Délègue** : éval→gradebook,
+paiement→payment/subscriptions, présence→attendance, contenu→elearning/media. **Frontière** : booking=créneau ; training=quoi/qui.
+**API** : `createTraining({repositories,numbering?,notifications?,booking?})` → `catalog.{createCourse,addLevel,listLevels,listCourses}`,
+`sessions.{open,setInstructor,schedule,run,close,cancel,listOpen}`, `enrollments.{enroll(capacité),cancel(libère),complete,listBySession,listByLearner,seats}`.
+**Jalons** : 0.1 catalogue+niveaux · 0.2 sessions(code)+inscriptions(capacité) · 0.3 booking(planning) · 1.0 14 livrables.
+## §4 (tests)
+catalogue/niveaux ordonnés, code session, capacité→full, annulation→open, idempotence, refus si non ouverte, notifications. (7 verts)

package/docs/01-ETUDE-ETAT-ART-TRAINING-18062026.md

@@ -0,0 +1,216 @@
+# 01 — Étude de l'état de l'art — `@mostajs/training`
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+**Date** : 2026-06-18
+**Statut** : proposition à discuter (livrable §9 #1 — DEVRULES). **Précède le scaffold.**
+**Protocole reproductible associé** : `scripts-recherche-training-18062026.sh` (gabarit googler §8) **+ runner portable exécuté** `scripts-recherche-training-portable-18062026.sh` (DuckDuckGo HTML + APIs académiques, car googler/ddgr absents de la machine)
+**Proposition module** : `PROPOSITION-MODULE-TRAINING.md` · **Consommateurs** : P1 Hadhinat, P2 ATC.
+**Convention sources** : `[A]` académique/standard · `[V]` vendeur/produit · `[T]` tiers. Consultées le 2026-06-18.
+
+> ✅ **Reproductibilité (§8) — protocole EXÉCUTÉ le 2026-06-18**. Le gabarit googler étant non installable ici,
+> un **runner portable versionné** (`scripts-recherche-training-portable-18062026.sh`, mêmes axes) a produit
+> `results-training-20260618/` : **130 résultats** dédupliqués, dont `vendors-only.csv` (11) et `academic-only.csv`.
+> Les sources ci-dessous (§3, §7, §10) sont **issues de ce rejeu**, horodatées 2026-06-18. Relancer : `./scripts-recherche-training-portable-18062026.sh all`.
+
+---
+
+## 1. Résumé
+
+Le domaine « gestion de formation » est couvert par deux familles d'outils : les **LMS** (Learning Management Systems — diffusion de contenu, suivi pédagogique) et les **SIS** (Student Information Systems — inscriptions, sections, scolarité). La plupart sont des **applications monolithiques** (Moodle, Open edX, Canvas), riches mais lourdes, difficiles à **composer** dans un autre logiciel métier. Pour `@mostajs/training`, le besoin n'est **ni un LMS complet ni un SIS complet** : c'est une **brique de domaine mince** « **catalogue de formations à niveaux + sessions/groupes + inscriptions** », **DB-agnostique** et **composable**, qui **délègue** contenu (→ futur `@mostajs/elearning`), évaluation (→ `gradebook`/`questa`), planning (→ `booking-stack`), paiement (→ `payment`/`subscriptions-plan`), présence (→ `attendance`) et certificats (→ `certificates`). Les **standards** (OneRoster, LTI, SCORM/xAPI, QTI, CEFR) servent de **vocabulaire de mapping**, pas d'implémentation à recopier.
+
+---
+
+## 2. Axes de recherche (cf. script §8)
+
+- **Verticaux** : (1) plateformes LMS/SIS open source, (2) modèle catalogue/curriculum/niveaux, (3) sessions/cohortes/planning, (4) inscriptions/capacité/liste d'attente.
+- **Horizontaux** : (5) centres de formation & écoles de langues, (6) programmes d'accompagnement/incubateurs.
+- **Standards** : (7) interopérabilité 1EdTech/IMS (OneRoster, LTI, QTI), e-learning (SCORM, xAPI), langues (CEFR).
+- **Demande/opportunités (§8.4)** : (9) appels d'offres, agréments centres de formation (Algérie), RFP SIS.
+
+---
+
+## 3. État de l'art des outils à implémentation commune (et leurs limites)
+
+### 3.1 LMS — diffusion & suivi pédagogique
+| Outil | Type | Forces | Limites pour notre besoin |
+|---|---|---|---|
+| **Moodle** `[V][A]` | LMS PHP open source, dominant | Très complet (cours, quiz, SCORM/xAPI, rôles) | Monolithe PHP, modèle pédagogique imposé ; **non composable** comme librairie TS ; lourd pour « juste catalogue+sessions+inscriptions » |
+| **Open edX** `[V]` | LMS MOOC (Python/Django) | Échelle, parcours, certificats | Très lourd à opérer ; orienté contenu en ligne, pas gestion de groupes présentiels |
+| **Canvas** (Instructure) `[V]` | LMS (Ruby) | UX moderne, LTI natif | Produit applicatif, pas une brique ; couplage fort |
+| **Chamilo / Sakai** `[V]` | LMS open source | Présentiel + e-learning | Monolithes ; intégration par API externe seulement |
+| **Frappe LMS** `[V]` | LMS sur framework Frappe | Léger, code ouvert | Couplé à Frappe/ERPNext (Python) ; hors stack TS/MostaORM |
+
+### 3.2 SIS — scolarité, inscriptions, sections
+| Outil | Type | Forces | Limites |
+|---|---|---|---|
+| **Gibbon** `[V]` | SIS écoles (PHP) | Inscriptions, classes, emploi du temps | Monolithe scolaire ; modèle « école » rigide |
+| **OpenSIS / Fedena** `[V]` | SIS établissements | Gestion complète scolarité | Applications fermées sur leur domaine ; non réutilisables en module |
+
+**Constat** : aucun de ces outils n'est une **librairie de domaine composable**. Ils imposent leur app, leur DB, leur UI. Réutiliser l'un d'eux dans Hadhinat **ou** ATC reviendrait à **intégrer un système entier** pour un sous-besoin — l'inverse de la philosophie `@mostajs/*` (petit, focalisé, composable — DEVRULES §0).
+
+> Détail confirmé au rejeu : **Moodle** publie un plugin dédié *Waitlist enrolment* `[V]` (moodle.org/plugins/enrol_waitlist) — preuve que **capacité + liste d'attente** est un besoin standard (valide notre `Enrollment`/contrôle de capacité, TC-ENR-02).
+
+### 3.4 Marché concurrent — applications de gestion de centre de formation (FR / Algérie)
+Repéré au rejeu (axe 5) : **Algeriasm** `[V]` (algeriasm.net — **acteur algérien** « gestion des formations »), **Dendreo** `[V]` (centres FR), **MyScol** `[V]`, **Class Manager**, **Skooly**, panorama **Appvizer « TOP 12 logiciels centre de formation »** `[T]`. Tous sont des **SaaS applicatifs fermés** (par utilisateur/mois), **non composables** dans un autre logiciel métier — ce qui **confirme l'espace** d'une **brique** `@mostajs/training` réutilisable (vs un produit de plus). À instruire pour le positionnement commercial (#10) et la veille AO (§7).
+
+### 3.3 Standards d'interopérabilité (vocabulaire de référence)
+| Standard | Rôle | Usage pour `training` |
+|---|---|---|
+| **1EdTech OneRoster** `[A]` | Échange roster : *org, course, class, enrollment, term* | **Aligner notre modèle** (Course/Session/Enrollment) sur un vocabulaire éprouvé ; export futur |
+| **1EdTech LTI** `[A]` | Lancement d'outils pédagogiques externes | Pertinent pour `elearning`, pas `training` (frontière) |
+| **SCORM / xAPI (Tin Can)** `[A]` | Paquet & traçage d'activités e-learning | Délégué à `@mostajs/elearning` |
+| **QTI** `[A]` | Items/tests interopérables | Délégué à `gradebook`/`questa` |
+| **CEFR (CECRL)** `[A]` | Niveaux de langue **A1→C2** | **Modèle direct** des `Level` (P2 ATC : langues) ; généralisable (niveaux 1→N) |
+
+---
+
+## 4. Description des capacités retenues (périmètre `training`)
+
+De cet état de l'art, on **retient et isole** la seule couche **non couverte et réutilisable** :
+- **Catalogue** : `Course` (formation) + `Level` ordonnés avec prérequis (modèle CEFR généralisé).
+- **Sessions/groupes** : `Session` = instance datée d'une formation (animateur, capacité, salle, planning récurrent **délégué à `booking-stack`**), avec **machine d'états** simple (`draft→open→full→running→closed`, déléguée à `statemachine`).
+- **Inscriptions** : `Enrollment` avec **contrôle de capacité** et statuts (`pending→confirmed→cancelled→completed`).
+
+On **écarte explicitement** (frontières — délégation, §10) : contenu/vidéo (`elearning`), évaluation/notes (`gradebook`/`questa`), présence (`attendance`), paiement (`payment`/`subscriptions-plan`), certificats (`certificates`), planning bas niveau (`booking-stack`).
+
+---
+
+## 5. Motif de sélection (quel mécanisme pour quel usage)
+
+- **Modèle aligné OneRoster** (course/class/enrollment/term) → interopérabilité & familiarité, sans en dépendre.
+- **Niveaux façon CEFR** → couvre directement P2 (A1→C2) et se généralise (calcul mental 1→10, accompagnement incubés par paliers).
+- **Délégation systématique** plutôt que monolithe → conforme §0/§10 ; évite de réimplémenter booking/éval/paiement déjà modularisés.
+- **DB-agnostique (repos injectés)** → un seul module sert P1 (MongoDB/ORM) et P2 sans réécriture.
+
+---
+
+## 6. Application localisée
+
+- **P2 ATC** : `Course` = Anglais ; `Level` = A1…C2 ; `Session` = groupe « ENG-A1-01 » (Mme X, samedi 14h, salle, capacité 12) ; `Enrollment` = élève inscrit. La gestion des groupes (spec F3) et le catalogue (F2) **sont** ce module.
+- **P1 Hadhinat** : `Course` = « Monter son business plan » ; `Session` = cohorte d'incubés ; `Enrollment` = entreprise incubée inscrite. Le module « Formation & accompagnement » **est** ce module.
+
+---
+
+## 7. Veille de la demande — appels d'offres & agréments (§8.4)
+
+> Axe 9 **exécuté** le 2026-06-18 → résultats classés dans `Entreprise/appels-d-offres/formation/` (un répertoire par thème, §8.4).
+
+- **Agréments — CONFIRMÉ** : les **établissements privés de formation** en Algérie relèvent d'un **agrément MFEP** (Ministère de la Formation et de l'Enseignement Professionnels) avec **cahier des charges**. Sources : guide *Agrément MFEP* `[T]` (beeform.dz/agrement-mfep-algerie), *Cahier des charges école privée / DFP* `[T]` (Scribd), **Journal Officiel** arrêtés `[A]` (joradp.dz — JO 2002/067 ; arrêté du 4 août, invest.caci.dz). → un logiciel **conforme au cahier des charges** (registres élèves, attestations, traçabilité) est un **différenciateur d'appel d'offres**.
+- **Appels d'offres — CONFIRMÉ** : portail officiel **BOMOP / ANEP** `[T]` (bomop.anep.dz) avec une rubrique dédiée **« Consultation, formation et certification »**, **portail des marchés publics** `[A]` (marches-publics.gov.dz), agrégateurs **AlgérieMarchés** `[T]` (algeriemarches.com), **RhinoTenders** `[T]`.
+- **Marché — CONFIRMÉ** : concurrents SaaS (Algeriasm/Dendreo/MyScol/Skooly, cf. §3.4) → demande réelle ; espace pour une **brique composable** + conformité MFEP locale.
+
+**Livrable §8.4 produit** : `Entreprise/appels-d-offres/formation/{README.md, ETAT-DES-LIEUX-AO-18062026.md}` (état des lieux classé/argumenté).
+
+---
+
+## 7-bis · Audit `iquesta-dev` — implémentation de référence & extraction de modules (création des cours)
+
+> Ajout 2026-06-18. `SolutionCh/iquesta-dev` (« plateforme questionnaire magic-link + **course-builder** »,
+> ex-orphin, prod `iquesta.amia.fr`) contient **déjà** une grande partie de la **création des cours** que
+> `@mostajs/training` doit modulariser. C'est donc à la fois une **source d'extraction** (règle d'or §0 :
+> ne pas réécrire ce qui existe) et le **terrain d'audit** de l'existant (§9 #2). *(Fichiers `MONTORING*.md`
+> du projet = journaux de reprise, lus mais NON modifiés — DEVRULES §5.)*
+
+### A. Avancement de `iquesta-dev` (source : `docs/Audit iquesta dev état.md` 2026-05-30 + `docs/ROADMAP.md` 2026-06-02)
+
+| Couche | Avancement | Verdict |
+|---|---|---|
+| Schémas de données (Formation/Activity/Dependency/Attachment/Snapshot) | **~95 %** | ✅ fondation excellente |
+| Plateforme événements / Q-bank / inscription / paiement | **~90 %** | ✅ en prod, durcie |
+| Éditeur visuel formation (course-builder) | **~68 %** | 🟢 fonctionnel (React Flow + dagre, undo/redo, optimistic locking, snapshots) |
+| Backend / persistance formation (server actions, diff/upsert 3 niveaux, snapshots SHA256) | **~75 %** | 🟢 solide |
+| Runtime apprenant | **~40 %** | 🟡 prototype |
+| **Intégration média / recording** | **~5 %** | 🔴 **non démarrée — principal reste** |
+| Tests | **~0 %** | 🔴 1 smoke `.mjs` |
+
+**Reste à faire = essentiellement l'intégration du module média** (cf. §E) + runtime serveur (suivi/scoring persistés, certificats PDF) + tests.
+
+### B. Modèle « création des cours » à extraire vers `@mostajs/training`
+
+iquesta modélise **Formation → (Module/Section) → Activity** avec **10 kinds** (`module, lesson, video, audio, reading, quiz, submission, live, external, certificate`), **dépendances en DAG** (détection de cycle DFS), **snapshots/versioning** (bundle JSON + SHA256), **attachments** formation↔projet, **optimistic locking**. C'est **exactement** le cœur catalogue/structure visé par `@mostajs/training` (§4-§6) — **déjà implémenté à ~75-95 %**. → **À extraire**, pas à réécrire.
+
+### C. Extraction des modules — logique codée en dur dans iquesta (cas B/C, règle d'or §0)
+
+iquesta consomme **12 modules `@mostajs/*`** (audit, auth, config, mailer, menu, orm, payment, pwa-scan, qrpanel, rbac, subscriptions-plan, url — *versions un peu anciennes : qrpanel 0.4→0.5, payment 0.5.3→0.8, subscriptions-plan 0.3.6→0.4*). Mais des **capacités réutilisables restent codées dans l'app** → candidates d'extraction :
+
+| Logique in-app (schemas + lib + components) | Module cible | Cas | Note |
+|---|---|---|---|
+| `formation*`, `activity*`, `section`, `components/formation/*` (FormationEditor, Tree/Canvas/Props, React Flow, dagre, snapshots) | **`@mostajs/training`** (modèle) **+ `@mostajs/course-builder`** (éditeur visuel) | **C** | **extraction prioritaire** — fonde le plan de dev #3 |
+| `question`, `answer`, `respondent`, `template`, `template-chain*`, `scoring.ts`, `questions.ts` | **`@mostajs/questa`** | **C/B** | questa est **0.0.0 (design seul)** → iquesta en est l'**implémentation de référence** |
+| `scoring.ts`, `weight/passingScore/maxAttempts` | **`@mostajs/gradebook`** (proposé) | **C** | alimente le module éval commun |
+| `magic-link*`, `anon-token`, `invite-token`, `agent-invite` | **module `@mostajs/magic-link`** (ou `auth-flow`) | **C** | **non sélectionné avant** (cf. §D) |
+| `registration*` (cascade/mailer/status/validate), `cohort-mailer` | **`@mostajs/registration`** (+ enrôlement `training`) | **C** | inscription événement/cohorte |
+| `archive*`, `tombstone*`, `import-actions` (jszip, `.iquesta-archive.zip`) | **composer `@mostajs/ixarchive`** | **B** | remplacer le code maison par le module existant |
+| `pdf-respondent.ts` (pdfkit) | **composer `@mostajs/file-export`** | **B** | reçus/attestations PDF |
+| `app-mode.ts`, `demo-actions`, `demo-seed` (4 modes dev/test/demo/prod + commission) | **`@mostajs/app-mode`** (petit) | **C** | **non sélectionné avant** (cf. §D) |
+
+### D. Modules **non sélectionnés** dans les cartographies P1/P2/P3 (révélés par iquesta)
+
+1. **`@mostajs/course-builder`** — éditeur **visuel** de formation (React Flow + dagre + undo/redo + optimistic locking + snapshots). **Distinct** de `training` (modèle de domaine) : c'est l'**UI d'édition**. Les cartographies disaient « training » sans isoler l'éditeur — iquesta prouve que c'est une **préoccupation à part entière** (~68 %, réutilisable). **Nouveau cas C.**
+2. **`@mostajs/questa` (à matérialiser)** — référencé partout comme « utilisable » alors qu'il est **design-only (0.0.0)** ; iquesta fournit le **code réel** (questions/réponses/scoring/templates/chaînes/respondents). À **remplir par extraction**, pas à présumer prêt.
+3. **`@mostajs/magic-link`** — accès **anonyme/par lien** (respondent, invitation agent). Très réutilisable : formulaires bénéficiaires **P3 ASSO-SEL**, portail parents **P2 ATC**, questionnaires **P1**. **Non identifié avant.**
+4. **`@mostajs/registration`** — inscription **événement/cohorte** + relances (cohort-mailer) + QR check-in. Recoupe l'enrôlement `training` mais l'**événementiel** (scan QR, badges) est une préoccupation propre.
+5. **`@mostajs/app-mode`** — modes **dev/test/démo/commission** (entrée 1-clic, reset, bandeau) : capacité **commerciale/démo** transverse, utile à tout produit vitrine. **Non identifié avant.**
+
+> Ces 5 entrées **complètent** la liste « modules métier génériques » (roadmap Phase 8) issue de la confrontation P1/P2/P3.
+
+### E. Le reste d'iquesta = **intégration & utilisation du module média** (principal levier)
+
+Le seul grand chantier restant du course-builder est l'**intégration média** (Track B, ~5 %). La **brique amont est prête et éprouvée** (`@mostajs/media@2.4.0` + `@mostajs/media-server@0.2.3` + `@mostajs/storage@0.1.2`, déjà en prod via *camera-studio*). Plan (réf. `docs/MEDIA-INTEGRATION-COURSE-BUILDER.md` + `ROADMAP.md` Axe 3) :
+
+| # | Item | Effort |
+|---|---|---|
+| M1 | Bootstrap deps + `lib/media-bootstrap.ts` + `lib/storage-bootstrap.ts` | ~0.5 j |
+| M2 | Schéma **`Media`** en DB (`Activity.mediaId` pointe déjà dessus) | ~0.5 j |
+| M3 | Routes `app/api/admin/media/recordings` (upload) + `[id]` (GET) | ~0.5 j |
+| M4 | `<CourseBuilderMediaSlot>` = `<MultiTakeRecorder>` (5 modes) + repli `<MediaPicker>` URL | ~1.5 j |
+| M5 | *(stretch)* kind `live` → `<LiveActivityPanel>` SFU/WHIP | ~1 j |
+
+**État actuel** : les activités `video/audio` stockent un `externalUrl` libre, **pas** un `mediaId` (table `Media` absente). L'intégration média **débloque** captation reprenable (multi-take), stockage **souverain RGPD** (self-hosted, §11.3 informative) et le kind `live`. **Règle §10** : ce slot **compose** `@mostajs/media` + `@mostajs/storage`, il ne recode **aucune** capture/transcodage.
+
+### F. Conséquences pour `@mostajs/training` (plan de dev #3)
+
+- **Source de code** : le plan de dev #3 doit **partir de l'extraction iquesta** (schemas + actions + éditeur), pas d'une feuille blanche — gain de temps majeur (~75-95 % du modèle existe).
+- **Découpage** confirmé : `training` (modèle/sessions/inscriptions) **+** `course-builder` (éditeur visuel) **+** `questa` (questionnaires/quiz) **+** `gradebook` (scoring) **+** `media`/`storage` (contenu) — composition, pas monolithe (§10).
+- **Dépendance média** : le kind `video/audio/live/certificate` de `training`/`course-builder` **compose** `@mostajs/media`+`storage` (le chantier restant d'iquesta = le **patron d'intégration** à généraliser dans le module).
+
+---
+
+## 8. Discussion / projection
+
+`@mostajs/training` se positionne comme **brique de domaine** réutilisable par **tout** logiciel de formation/scolarité de l'écosystème (P1, P2, MostaJS-Académie, futurs centres). Couplé à `elearning` + `gradebook` + `attendance` + `certificates`, il **reconstitue par composition** un LMS/SIS complet — mais **à la carte**, sans le poids d'un monolithe. Projection : un **stack `@mostajs/campus-stack`** dont `training` est le cœur catalogue/sessions.
+
+---
+
+## 9. Conclusion
+
+Aucun outil existant n'offre une **brique composable** « catalogue+sessions+inscriptions » en TS/MostaORM : les LMS/SIS sont des **applications**, pas des **modules**. La création de `@mostajs/training` (cas C) est **justifiée**, **réutilisable sur ≥ 2 projets** dès maintenant, et **alignable** sur les standards (OneRoster, CEFR) sans en hériter le poids. → Passage au **plan de dev §9 #3**.
+
+---
+
+## 10. Références
+
+**Standards** (axe 7, consultés 2026-06-18)
+- `[A]` **1EdTech — OneRoster v1.1 Final Specification** : https://www.imsglobal.org/oneroster-v11-final-specification
+- `[A]` **1EdTech — OneRoster & LTI Advantage (K-12)** : https://www.imsglobal.org/about/k12/oneroster-and-lti-advantage
+- `[A]` **1EdTech — QTI Specification Documents** : https://www.1edtech.org/standards/qti/index · **Specifications** : https://www.1edtech.org/specifications
+- `[A]` **ADL SCORM / xAPI** : https://adlnet.gov/ , https://xapi.com/ · panorama standards (SCORM/xAPI/cmi5/LTI/OneRoster/Ed-Fi) `[T]` aristeksystems.com/blog/elearning-standards
+- `[A]` **CEFR / CECRL** (Conseil de l'Europe) — niveaux A1–C2 : https://www.coe.int/lang-cefr
+
+**Outils** (axes 1/2/3, consultés 2026-06-18)
+- `[V]` **Moodle** (dont plugin *Waitlist enrolment* moodle.org/plugins/enrol_waitlist) · **Open edX** · **Canvas/Instructure** · **Chamilo** · **Sakai** · **Frappe LMS**
+- `[V]` SIS : **Gibbon** (docs.gibbonedu.org) · **openSIS** (opensis.com + Community SourceForge) · **Fedena** (github.com/projectfedena/fedena)
+
+**Académique** (axe 8, Semantic Scholar/arXiv/ResearchGate, 2026-06-18)
+- `[A]` *A Comparison of Open-Source Learning Management Systems Used for Distance Education in HEI* — ResearchGate pub. 387491743
+- `[A]` *Course-Prerequisite Networks for Analyzing and Understanding Academic Curricula* — arXiv:2210.01269 *(appui direct du modèle `Level.prerequisiteLevelId`)*
+
+**Demande / appels d'offres — Algérie** (axe 9, 2026-06-18 → `Entreprise/appels-d-offres/formation/`)
+- `[T]` **BOMOP / ANEP** : https://bomop.anep.dz/ (rubrique *Consultation, formation et certification*) · `[A]` **Marchés publics** : https://marches-publics.gov.dz/ · `[T]` algeriemarches.com · rhinotenders.com/bomop
+- `[T]` **Agrément MFEP** : beeform.dz/agrement-mfep-algerie · *Cahier des charges* établissement privé de formation (Scribd) · `[A]` **JORADP** (JO 2002/067 ; arrêté 4 août — invest.caci.dz)
+
+> Sources brutes horodatées : `results-training-20260618/{all-results.csv, academic-only.csv, vendors-only.csv}` (rejouables via le runner portable versionné).
+
+---
+
+**Fin de l'état de l'art `@mostajs/training`.**

package/docs/03-PLAN-DEV-TRAINING.md

@@ -0,0 +1,117 @@
+# 03 — Plan de développement — `@mostajs/training`
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+**Date** : 2026-06-18
+**Statut** : proposition à discuter (livrable §9 #3 — DEVRULES). **Précède toute ligne de code métier (§0/§4).**
+**Amont** : `PROPOSITION-MODULE-TRAINING.md` (§4) · `01-ETUDE-ETAT-ART-TRAINING-18062026.md` (§9 #1)
+**Consommateurs** : P1 Hadhinat (accompagnement incubés) · P2 ATC (catalogue + groupes).
+
+---
+
+## 1. Périmètre & responsabilité unique
+
+**Catalogue de formations à niveaux + sessions/groupes + inscriptions** — domaine **mince**, **DB-agnostique** (repos injectés), **composable**. Tout le transverse est **délégué** (cf. §6).
+
+**Hors périmètre (frontières — délégué)** : contenu/e-learning (`elearning`), évaluation/notes (`gradebook`/`questa`), présence (`attendance`), paiement (`payment`/`subscriptions-plan`), certificats (`certificates`), planning bas niveau (`booking-stack`), apprenant/enseignant (ids opaques → `school`/`incubator`/`staff`).
+
+---
+
+## 2. Entités (schémas)
+
+| Entité | Champs clés | Notes |
+|---|---|---|
+| **Course** | `id`, `title`, `category`, `description`, `active` | formation/programme |
+| **Level** | `id`, `courseId`, `order`, `label`, `prerequisiteLevelId?` | CEFR généralisé (A1…C2 / 1…N) |
+| **Session** | `id`, `courseId`, `levelId?`, `code`, `instructorId?`, `room?`, `capacity`, `startDate`, `endDate?`, `scheduleRef?`, `status` | instance datée ; `scheduleRef`→`booking-stack` ; `status`→`statemachine` |
+| **Enrollment** | `id`, `sessionId`, `learnerId`, `status`, `enrolledAt` | contrôle de **capacité** à l'inscription |
+
+États `Session` : `draft → open → full → running → closed` (+ `cancelled`).
+États `Enrollment` : `pending → confirmed → cancelled → completed`.
+
+---
+
+## 3. Services (API cible)
+
+```
+createTraining({ repositories, booking?, numbering?, notifications?, statemachine?, i18n?, now? }) -> Training
+Training.catalog.createCourse / updateCourse / addLevel / listCourses / getCourse
+Training.sessions.open / close / cancel / setInstructor / setSchedule / listOpen / get
+Training.enrollments.enroll(sessionId, learnerId)   // refuse si capacity atteinte → throws CapacityReached
+Training.enrollments.cancel / complete / listBySession / listByLearner
+createMemoryRepositories() -> TrainingRepositories  // tests ; prod via @mostajs/repository
+```
+
+---
+
+## 4. Composition (DEVRULES §10) — capacités consommées
+
+| Capacité | Module | Mode | Obligatoire |
+|---|---|---|---|
+| Persistance | `@mostajs/repository` (`data-plug`/`orm`) | DI repos | oui |
+| Planning/salles des séances | `@mostajs/booking-stack` | DI (peer) | non (v0.2) |
+| États de session | `@mostajs/statemachine` | DI | non (fallback interne) |
+| N° de session/inscription | `@mostajs/numbering` | DI | non |
+| Notifications (ouverture, confirmation, rappel) | `@mostajs/notifications` | DI | non |
+| Libellés FR/AR/EN | `@mostajs/i18n` | DI | non |
+| Config (.env/profils) | `@mostajs/config` | runtime | oui |
+
+> Le plan **cite explicitement** ces capacités (exigence §10) ; aucune n'est réimplémentée.
+
+---
+
+## 5. Versions (jalons)
+
+> **Amont d'extraction (≠ feuille blanche)** : le modèle « création des cours » existe déjà à **~75-95 %** dans
+> `SolutionCh/iquesta-dev` (schemas `formation/activity/dependency/snapshot`, server actions, éditeur visuel).
+> Les versions ci-dessous **partent de l'extraction** de ce code (cf. étude #1 §7-bis), pas d'une réécriture.
+> Découpage : `training` (modèle) **+** `@mostajs/course-builder` (éditeur visuel, roadmap #40) **+** `questa`/`gradebook`
+> (quiz/scoring) **+** `media`/`storage` (contenu). Le **kind média compose** `@mostajs/media`+`storage` (§10).
+
+
+| Version | Contenu | Portes §11 | DoD |
+|---|---|---|---|
+| **0.1.0** | Catalogue : `Course` + `Level` (CRUD, prérequis) ; repos mémoire ; `llms.txt` (#6) ; `CHANGELOG` (#7) | §11.1 build/tests | tests verts catalogue |
+| **0.2.0** | `Session` (open/close, capacité, statut) + planning via `booking-stack` | §11.1 | session schedulable |
+| **0.3.0** | `Enrollment` (enroll/cancel/complete) + **contrôle de capacité** + notifications | §11.1 | inscription bout-en-bout |
+| **0.4.0** | i18n statuts/niveaux ; export aligné **OneRoster** ; adaptateurs `@mostajs/repository` (prod) | §11.1 + §11.5 (i18n) | P1 **et** P2 branchés |
+| **1.0.0** | 14 livrables §9 complets + portes §11 + **exemple §12** + **article #17** | toutes portes applicables | publiable npm |
+
+---
+
+## 6. Risques & mitigations
+
+| Risque | Mitigation |
+|---|---|
+| Périmètre qui déborde (devenir un LMS) | Frontières strictes §1 ; délégation §4 ; revue à chaque version |
+| Couplage `booking-stack` | `scheduleRef` opaque + DI optionnelle ; v0.1 sans booking |
+| Divergence P1/P2 | API unique pilotée par config ; ids opaques learner/instructor |
+| Modèle de niveaux trop « langue » | `Level.order`+`label` générique (1→N), CEFR = cas particulier |
+
+---
+
+## 7. Portes §11 applicables (déclaration — exigée par §11)
+
+- **§11.1 qualité (BLOQUANTE)** : build/typecheck/lint + tests verts, couverture cœur ≥ 80 %.
+- **§11.5 i18n** : FR/AR/EN + RTL (libellés statuts/niveaux) dès v0.4.
+- **§11.2 / §11.3 (INFORMATIVES)** : données traitées = inscriptions (peu sensibles) ; pas d'IA ; pas de tiers. Portée **faible** → **déclarées non critiques**, documentées pour information à l'usage (#15/#16 légers). *Elles n'empêchent pas le développement.*
+- **§11.8 SemVer** : strict ; `CHANGELOG` dès 0.0.1.
+- Non applicables (déclarées) : §11.4 budget LLM (pas d'IA), §11.6 SBOM (au build 1.0).
+
+---
+
+## 8. Jalons livrables §9
+
+`#1` état de l'art ✅ (ce dossier) · `#2` audit (proposition §4 + cartographies P1/P2) · **`#3` ce plan** · `#4` plan de test (→ `04-PLAN-TESTS.md`) · `#5` plan de suivi (→ `05-PLAN-SUIVI-MONITORING.md`) · `#6` `llms.txt` dès 0.1 · `#7` `CHANGELOG` · `#8`–`#14` à la publication · **§12 exemple AVANT #17 article**.
+
+---
+
+## 9. Questions ouvertes (validation demandée)
+
+1. Nom `training` confirmé (vs `courses`/`learning`) ?
+2. `Session` porte-t-elle la salle, ou tout délégué à `booking-stack` ?
+3. Export **OneRoster** dès 0.4 ou reporté ?
+4. `gradebook` séparé confirmé (training ne porte aucune note) ?
+
+---
+
+**Fin du plan de dev `@mostajs/training`.**

package/docs/04-PLAN-TESTS.md

@@ -0,0 +1,82 @@
+# 04 — Plan de test — `@mostajs/training`
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+**Date** : 2026-06-18
+**Statut** : proposition à discuter (livrable §9 #4 — DEVRULES). Rend la porte **§11.1** vérifiable.
+**Amont** : `03-PLAN-DEV-TRAINING.md` · **Emplacement des tests** : `test-scripts/` (JAMAIS `/tmp` — §5), rejouables & committés.
+
+---
+
+## 1. Stratégie
+
+- **Unitaires** (cœur de domaine, repos mémoire) — l'essentiel ; **sans I/O**, déterministes (`now` injecté).
+- **Intégration** : adaptateurs `@mostajs/repository` + `booking-stack` (mock/DI) + `numbering`/`notifications` (spies).
+- **Exemple §12** (`examples/`) : scénario headless `*.mjs` qui exerce l'API réelle et **`assert`** (DoD).
+- **Cible de couverture** : cœur métier **≥ 80 %** lignes/branches (§11.1).
+
+---
+
+## 2. Matrice de couverture (T-cases)
+
+| ID | Domaine | Cas | Attendu |
+|---|---|---|---|
+| **TC-CAT-01** | Catalogue | créer Course | persisté, `active=true` |
+| **TC-CAT-02** | Catalogue | addLevel ordonné | `order` croissant, `label` libre |
+| **TC-CAT-03** | Catalogue | prérequis (Level→prerequisiteLevelId) | chaîne cohérente, pas de cycle |
+| **TC-CAT-04** | Catalogue | listCourses(filter category) | filtre correct |
+| **TC-SES-01** | Session | open(course, capacity) | statut `open`, `code` via numbering |
+| **TC-SES-02** | Session | setInstructor / setSchedule | instructorId + scheduleRef posés |
+| **TC-SES-03** | Session | transition draft→open→running→closed | machine d'états respectée |
+| **TC-SES-04** | Session | cancel | statut `cancelled`, inscriptions notifiées |
+| **TC-SES-05** | Session | passage auto `open`→`full` à capacité | déclenché par enroll |
+| **TC-ENR-01** | Inscription | enroll sous capacité | `Enrollment` `confirmed` |
+| **TC-ENR-02** | Inscription | **enroll à capacité atteinte** | **throws `CapacityReached`** |
+| **TC-ENR-03** | Inscription | double enroll même learner/session | refus/idempotent |
+| **TC-ENR-04** | Inscription | cancel libère une place | session repasse `full`→`open` |
+| **TC-ENR-05** | Inscription | complete | statut `completed` |
+| **TC-ENR-06** | Inscription | listByLearner / listBySession | filtres corrects |
+| **TC-I18N-01** | i18n | libellés statuts/niveaux FR/AR/EN | clés résolues, fallback |
+| **TC-CMP-01** | Composition | sans booking/numbering (DI absente) | fallback interne, pas d'erreur |
+| **TC-CMP-02** | Composition | notifications spy à open/enroll/cancel | events émis une fois (idempotent) |
+| **TC-OR-01** | Export | mapping OneRoster (course/class/enrollment) | structure conforme (v0.4) |
+| **TC-P1-01** | Scénario P1 | cohorte incubés : course→session→enroll | bout-en-bout vert |
+| **TC-P2-01** | Scénario P2 | ENG-A1-01 : Anglais/A1, capacité 12 | bout-en-bout vert |
+
+---
+
+## 3. Cas limites & robustesse
+
+- Capacité 0 ou négative → rejet à `open`.
+- enroll sur session `closed`/`cancelled` → rejet.
+- Level d'une autre Course → rejet.
+- `now` injecté pour dates (pas de `Date.now()` non maîtrisé).
+- Concurrence enroll (course pleine) → contrôle atomique côté repo (test d'intégration).
+
+---
+
+## 4. Scripts & emplacement
+
+```
+mosta-training/
+├── test-scripts/
+│   ├── unit/            # TC-CAT/SES/ENR/I18N/CMP (repos mémoire)
+│   ├── integration/     # repository + booking + numbering (DI)
+│   └── .out*/           # sorties (gitignorées)
+└── examples/
+    ├── p1-incubateur/   # scénario headless *.mjs + assert (§12)
+    └── p2-ecole-langues/
+```
+
+- Rejouables : `node test-scripts/unit/*.mjs` ; **committés** ; sorties dans `.out*` (gitignorées) — §5.
+- CI : `build + typecheck + lint + tests` (porte §11.1) — bloquant avant tag/publish.
+
+---
+
+## 5. Critère de Definition of Done (test)
+
+- Toutes les T-cases **vertes** ; couverture cœur **≥ 80 %**.
+- **Exemple §12 exécuté** (`examples/*/run.mjs`) avec assertions vertes → **prérequis de l'article #17**.
+
+---
+
+**Fin du plan de test `@mostajs/training`.**

package/docs/05-PLAN-SUIVI-MONITORING.md

@@ -0,0 +1,49 @@
+# 05 — Plan de suivi (KPIs & observabilité) — `@mostajs/training`
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com>
+**Date** : 2026-06-18
+**Statut** : proposition à discuter (livrable §9 #5 — DEVRULES). Avant 1.0.
+**Amont** : `03-PLAN-DEV-TRAINING.md` · `04-PLAN-TESTS.md`.
+
+---
+
+## 1. KPIs produit (valeur métier)
+
+| KPI | Définition | Source | Consommateur |
+|---|---|---|---|
+| Taux de remplissage des sessions | inscriptions confirmées / capacité | enrollments/sessions | direction P1/P2 |
+| Sessions ouvertes vs réalisées | `running`+`closed` / total | états session | pilotage |
+| Taux d'annulation d'inscription | `cancelled` / total | enrollments | qualité offre |
+| Progression de niveau | `completed` par Level (A1→A2…) | enrollments+levels | pédagogie |
+| Délai ouverture→première inscription | timestamps | events | marketing |
+
+> Ces KPIs **alimentent `@mostajs/reporting`** (module commun P1/P2/P3) — `training` **expose les événements**, il n'embarque pas de dashboard (frontière §10).
+
+## 2. Observabilité runtime
+
+- **Logs structurés** : `course.created`, `session.opened/closed/cancelled`, `enrollment.created/cancelled/completed`, `enrollment.rejected{reason:capacity}`.
+- **Métriques** : compteurs par event ; histogramme capacité/remplissage ; erreurs `CapacityReached`.
+- **Audit** : composer `@mostajs/audit` (traçabilité des actions sensibles : open/cancel/enroll).
+- **Santé** : pas de service propre (librairie) ; les events sont consommés par l'app hôte.
+
+## 3. Alertes (côté app hôte)
+
+| Condition | Seuil | Action |
+|---|---|---|
+| Session quasi pleine | remplissage ≥ 90 % | notifier gestionnaire (via `notifications`) |
+| Session sous-remplie proche du début | < 30 % à J-3 | alerte marketing/relance |
+| Pic de `CapacityReached` | > N/jour | suggérer ouverture session supplémentaire |
+
+## 4. Tableaux de bord (délégués)
+
+Construits dans **`@mostajs/reporting`** à partir des events `training` — jamais dans `training` lui-même. Cohérent avec la confrontation P1/P2 (reporting = module commun).
+
+## 5. Rattachement aux portes §11
+
+- §11.7 observabilité : logs/métriques/taxonomie d'erreurs **par défaut**.
+- §11.1 : les events sont **testés** (TC-CMP-02).
+- §11.2/§11.3 (**informatives**) : volumétrie de données personnelles faible (ids opaques) → suivi RGPD léger, **pour information à l'usage**, non bloquant.
+
+---
+
+**Fin du plan de suivi `@mostajs/training`.**