@mostajs/elearning 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog — @mostajs/elearning
+## [0.1.0] — 2026-06-18
+### Added
+- Leçons (video/pdf/text/quiz) + progression (start/complete, courseProgress %, nextLesson). Compose media/storage/questa. 5 tests + exemple §12.

package/README.md

@@ -0,0 +1,11 @@
+# @mostajs/elearning
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later · **Statut** : 0.1.0 (5 tests verts)
+> LMS : leçons (vidéo/PDF/quiz) + progression. Autonome ; compose media/storage/questa/gradebook ; délègue catalogue à @mostajs/training.
+```js
+import { createElearning, createMemoryRepositories } from '@mostajs/elearning';
+const e = createElearning({ repositories: createMemoryRepositories(), media, storage });
+await e.content.addLesson('eng-a1', { order:1, kind:'video', title:'Intro', mediaRef:'vid-1' });
+await e.progress.complete(learnerId, lessonId, { score: 18 });
+const cp = await e.progress.courseProgress(learnerId, 'eng-a1');  // { total, done, percent }
+```
+Lancer : `node test-scripts/unit/elearning.test.mjs && node examples/parcours/run.mjs`

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

@@ -0,0 +1,10 @@
+# @mostajs/elearning — DEVRULES de bout en bout (§4 + #3 + #4 condensés)
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Date** : 2026-06-18 · **Statut** : cas C (P2 ATC + P1 formation incubés)
+## §4 (règle d'or)
+`@mostajs/media`=vidéo/capture · `storage`=PDF · `questa`=quiz · `gradebook`=notes · `training`=catalogue/sessions.
+→ elearning = la **couche contenu+progression** (leçons, parcours) qui **compose** ces briques. Frontière : training=quoi/qui ; elearning=le contenu et l'avancement.
+## §3 (périmètre/API)
+**Entités** : Lesson{courseId,order,kind(video/pdf/text/quiz/live),mediaRef,contentRef,quizRef,durationMin}, LessonProgress{learnerId,lessonId,status,score}.
+**API** : `createElearning({repositories,media?,storage?})` → `content.{addLesson,list,get}`, `progress.{start,complete,get,courseProgress,nextLesson}`.
+**Compose (§10)** : media (vidéo), storage (PDF), questa (quiz→score), gradebook (note). **Jalons** : 0.1 leçons+progression · 0.2 quiz(questa)/vidéo(media) · 1.0 14 livrables.
+## §4 (tests) : addLesson ordonné, start/complete, courseProgress %, nextLesson, leçon introuvable. (5 verts)

package/examples/parcours/run.mjs

@@ -0,0 +1,12 @@
+import assert from 'node:assert/strict';
+import { createElearning, createMemoryRepositories } from '../../src/index.js';
+const e=createElearning({ repositories:createMemoryRepositories() });
+const c='eng-a1';
+await e.content.addLesson(c,{order:1,title:'Vidéo intro',kind:'video',mediaRef:'vid-1',durationMin:8});
+await e.content.addLesson(c,{order:2,title:'Support PDF',kind:'pdf',contentRef:'pdf-1'});
+await e.content.addLesson(c,{order:3,title:'Quiz A1',kind:'quiz',quizRef:'quiz-1'});
+await e.progress.complete('ines',(await e.content.list(c))[0].id);
+const next=await e.progress.nextLesson('ines',c);
+const cp=await e.progress.courseProgress('ines',c);
+console.log('✅ elearning — Inès : %d%% · prochaine leçon: %s', cp.percent, next.title);
+assert.equal(cp.percent,33);

package/llms.txt

@@ -0,0 +1,11 @@
+# @mostajs/elearning — fiche LLM
+RÔLE
+  LMS : leçons/contenu (video/pdf/text/quiz/live) + progression par apprenant. Autonome/DB-agnostique.
+  Compose (injectés) : media (vidéo), storage (PDF), questa (quiz), gradebook (score). Délègue catalogue/sessions à @mostajs/training.
+EXPORTS
+  createElearning({ repositories, media?, storage?, now? }) -> { content, progress } ; createMemoryRepositories(); LessonSchema, ProgressSchema
+API
+  content.addLesson(courseId,{order,kind,title,mediaRef|contentRef|quizRef})/list(courseId)/get(id)
+  progress.start(learnerId,lessonId)/complete(learnerId,lessonId,{score})/get/courseProgress(learnerId,courseId)->{total,done,percent}/nextLesson(learnerId,courseId)
+PIÈGES
+  - courseId/learnerId/mediaRef opaques (→ training/users/media). nextLesson = 1ère leçon non 'done' (ordre). Le quiz/score = compose questa/gradebook.

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@mostajs/elearning",
+  "version": "0.1.0",
+  "description": "LMS : leçons/contenu (vidéo/PDF/texte/quiz) + progression par apprenant. DB-agnostique ; compose media/storage/questa/gradebook. Délègue catalogue à @mostajs/training.",
+  "license": "AGPL-3.0-or-later",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./schemas": "./src/schemas.js"
+  },
+  "keywords": [
+    "mostajs",
+    "elearning",
+    "lms",
+    "lessons",
+    "progress",
+    "video"
+  ],
+  "scripts": {
+    "test": "node test-scripts/unit/elearning.test.mjs",
+    "example": "node examples/parcours/run.mjs"
+  }
+}

package/src/elearning.js

@@ -0,0 +1,23 @@
+// @mostajs/elearning — contenu + progression. Author: Dr Hamid MADANI <drmdh@msn.com>
+// Autonome/DB-agnostique. Compose (injectés) : media (vidéo), storage (PDF), questa (quiz), gradebook (score). Délègue catalogue à training.
+export function createElearning({ repositories, media, storage, now=()=>new Date() }={}){
+  if(!repositories?.lessons) throw new Error('createElearning: repositories.lessons requis');
+  const { lessons, progress } = repositories;
+  const findP=async(l,les)=>(await progress.find(p=>p.learnerId===l && p.lessonId===les))[0];
+  const api={
+    content:{
+      addLesson:(courseId,dto)=>lessons.create({courseId,order:0,kind:'text',...dto}),
+      list:(courseId)=>lessons.find(x=>x.courseId===courseId).then(a=>a.sort((x,y)=>x.order-y.order)),
+      get:(id)=>lessons.findById(id),
+    },
+    progress:{
+      async start(learnerId,lessonId){ const les=await lessons.findById(lessonId); if(!les) throw new Error('leçon introuvable'); const ex=await findP(learnerId,lessonId); return ex?progress.update(ex.id,{status:'in_progress',at:now()}):progress.create({learnerId,lessonId,courseId:les.courseId,status:'in_progress',at:now()}); },
+      async complete(learnerId,lessonId,{score}={}){ const les=await lessons.findById(lessonId); const ex=await findP(learnerId,lessonId); const d={status:'done',score:score??null,at:now()}; return ex?progress.update(ex.id,d):progress.create({learnerId,lessonId,courseId:les?.courseId,...d}); },
+      get:(learnerId,lessonId)=>findP(learnerId,lessonId),
+      async courseProgress(learnerId,courseId){ const all=await lessons.find(l=>l.courseId===courseId); const done=(await progress.find(p=>p.learnerId===learnerId && p.courseId===courseId && p.status==='done')).length; return { total:all.length, done, percent: all.length?Math.round(done/all.length*100):0 }; },
+      async nextLesson(learnerId,courseId){ const all=(await lessons.find(l=>l.courseId===courseId)).sort((a,b)=>a.order-b.order); for(const l of all){ const p=await findP(learnerId,l.id); if(!p||p.status!=='done') return l; } return null; },
+    },
+    repositories,
+  };
+  return api;
+}

package/src/index.js

@@ -0,0 +1,3 @@
+export { createElearning } from './elearning.js';
+export { createMemoryRepositories } from './memory-repo.js';
+export { LessonSchema, ProgressSchema } from './schemas.js';

package/src/memory-repo.js

@@ -0,0 +1,7 @@
+// @mostajs/elearning — repos mémoire. Author: Dr Hamid MADANI <drmdh@msn.com>
+function coll(){ const m=new Map(); return {
+  async create(d){ const id=d.id||globalThis.crypto.randomUUID(); const now=new Date(); const r={id,createdAt:now,updatedAt:now,...d}; m.set(id,r); return {...r}; },
+  async findById(id){ const r=m.get(id); return r?{...r}:null; },
+  async update(id,p){ const r=m.get(id); if(!r)return null; const x={...r,...p,updatedAt:new Date()}; m.set(id,x); return {...x}; },
+  async find(f=()=>true){ return [...m.values()].filter(f).map(r=>({...r})); } }; }
+export function createMemoryRepositories(){ return { lessons:coll(), progress:coll() }; }

package/src/schemas.js

@@ -0,0 +1,10 @@
+// @mostajs/elearning — schémas. Author: Dr Hamid MADANI <drmdh@msn.com>
+export const LessonSchema = { name:'Lesson', collection:'lessons', timestamps:true, fields:{
+  courseId:{type:'string',required:true}, order:{type:'number',default:0}, title:{type:'string',required:true},
+  kind:{type:'string',enum:['video','pdf','text','quiz','live'],default:'text'},
+  mediaRef:{type:'string',default:null}, contentRef:{type:'string',default:null}, quizRef:{type:'string',default:null},
+  durationMin:{type:'number',default:0} }, indexes:[{fields:{courseId:'asc'}}] };
+export const ProgressSchema = { name:'LessonProgress', collection:'lesson_progress', timestamps:true, fields:{
+  learnerId:{type:'string',required:true}, lessonId:{type:'string',required:true}, courseId:{type:'string'},
+  status:{type:'string',enum:['not_started','in_progress','done'],default:'not_started'}, score:{type:'number',default:null}, at:{type:'date',default:'now'} },
+  indexes:[{fields:{learnerId:'asc'}},{fields:{lessonId:'asc'}}] };

package/test-scripts/unit/elearning.test.mjs

@@ -0,0 +1,10 @@
+import assert from 'node:assert/strict';
+import { createElearning, createMemoryRepositories } from '../../src/index.js';
+let pass=0; const test=async(n,f)=>{await f();pass++;console.log('  ✓',n);};
+const mk=()=>createElearning({ repositories:createMemoryRepositories() });
+await test('addLesson + list ordonné', async()=>{ const e=mk(); await e.content.addLesson('c',{order:2,title:'L2'}); await e.content.addLesson('c',{order:1,title:'L1',kind:'video',mediaRef:'m1'}); assert.deepEqual((await e.content.list('c')).map(l=>l.title),['L1','L2']); });
+await test('start/complete + get', async()=>{ const e=mk(); const l=await e.content.addLesson('c',{title:'L'}); await e.progress.start('u',l.id); await e.progress.complete('u',l.id,{score:18}); const p=await e.progress.get('u',l.id); assert.equal(p.status,'done'); assert.equal(p.score,18); });
+await test('courseProgress %', async()=>{ const e=mk(); const a=await e.content.addLesson('c',{title:'A'}); await e.content.addLesson('c',{title:'B'}); await e.progress.complete('u',a.id); const cp=await e.progress.courseProgress('u','c'); assert.equal(cp.total,2); assert.equal(cp.done,1); assert.equal(cp.percent,50); });
+await test('nextLesson (1ère non terminée)', async()=>{ const e=mk(); const a=await e.content.addLesson('c',{order:1,title:'A'}); const b=await e.content.addLesson('c',{order:2,title:'B'}); await e.progress.complete('u',a.id); assert.equal((await e.progress.nextLesson('u','c')).id,b.id); await e.progress.complete('u',b.id); assert.equal(await e.progress.nextLesson('u','c'),null); });
+await test('leçon introuvable au start', async()=>{ await assert.rejects(()=>mk().progress.start('u','nope'),/introuvable/); });
+console.log(`\n✅ @mostajs/elearning — ${pass} tests OK`);