@mostajs/mailroom 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+## [0.2.0] — 2026-06-20
+### Added
+- **Registre des visiteurs / RDV** (E9 Hadhinat) : `visitors.log/list/checkIn/checkOut` (repository `visitors` optionnel, rétro-compat) + `VisitorSchema` + `stats().visitors`. 6 tests.
+
+# Changelog — @mostajs/mailroom
+## [0.1.0] — 2026-06-18
+### Added
+- Registre courrier entrant/sortant (ref/statuts/affectation/pièce jointe) + journal d'appels + stats. Compose numbering/storage/notifications. 5 tests + exemple §12.

package/README.md

@@ -0,0 +1,11 @@
+# @mostajs/mailroom
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later · **Statut** : 0.1.0 (5 tests verts)
+> Courrier entrant/sortant + journal d'appels (accueil/secrétariat). Autonome ; compose numbering/storage/notifications.
+```js
+import { createMailroom, createMemoryRepositories } from '@mostajs/mailroom';
+const m = createMailroom({ repositories: createMemoryRepositories(), numbering, storage });
+const c = await m.mail.register({ direction:'in', subject:'Demande', from:'Wilaya' });
+await m.mail.assign(c.id, 'secretaire');
+await m.calls.log({ caller:'0550...', subject:'RDV', handledBy:'accueil' });
+```
+Lancer : `node test-scripts/unit/mailroom.test.mjs && node examples/registre/run.mjs`

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

@@ -0,0 +1,9 @@
+# @mostajs/mailroom — DEVRULES de bout en bout (§4 + #3 + #4 condensés)
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Date** : 2026-06-18 · **Statut** : cas C (P1 Hadhinat F3 + P3 secrétariat)
+## §4 (règle d'or)
+Aucun module ne couvre le **registre courrier entrant/sortant** + **journal d'appels** (accueil/secrétariat). queue=file d'attente, secu=accès, booking=RDV — complémentaires. → cas C autonome.
+## §3 (périmètre/API)
+**Entités** : Mail{ref,direction(in/out),subject,from,to,date,status,assignedTo,attachmentRef}, CallLog{at,caller,subject,handledBy,followUp}.
+**API** : `createMailroom({repositories,numbering?,storage?,notifications?})` → `mail.{register,get,list,setStatus,assign}`, `calls.{log,list}`, `stats()`.
+**Compose (§10)** : numbering (n° courrier ARR/DEP), storage (pièce jointe), notifications (affectation). **Jalons** : 0.1 registre+appels+stats · 0.2 RDV/convocations(booking) · 1.0 14 livrables.
+## §4 (tests) : register in/out+n°+validation, pièce jointe(storage), affectation+notif, journal d'appels, stats. (5 verts)

package/examples/registre/run.mjs

@@ -0,0 +1,11 @@
+import assert from 'node:assert/strict';
+import { createMailroom, createMemoryRepositories } from '../../src/index.js';
+const m=createMailroom({ repositories:createMemoryRepositories(), numbering:{ next:(s)=> (s==='mail-in'?'ARR':'DEP')+'-2026-'+Math.floor(Math.random()*999) }, notifications:{ notify:(e)=>console.log('   ↪ affecté à',e.to) } });
+// P1 Hadhinat / P3 ASSO-SEL : secrétariat
+const arr=await m.mail.register({ direction:'in', subject:'Demande de subvention', from:'DAS Mostaganem' });
+await m.mail.assign(arr.id,'secretaire-1');
+await m.mail.register({ direction:'out', subject:'Accusé de réception', to:'DAS Mostaganem' });
+await m.calls.log({ caller:'0561 23 45', subject:'Suivi dossier', handledBy:'accueil', followUp:true });
+const s=await m.stats();
+assert.deepEqual(s,{in:1,out:1,calls:1});
+console.log('✅ mailroom — registre: %d entrant · %d sortant · %d appel(s) · %s', s.in, s.out, s.calls, arr.ref);

package/llms.txt

@@ -0,0 +1,14 @@
+# @mostajs/mailroom — fiche LLM
+RÔLE
+  Courrier & accueil : registre courrier entrant/sortant (ref ARR/DEP, statuts, affectation, pièce jointe) + journal d'appels.
+  Autonome/DB-agnostique. Compose (injectés) : numbering (n°), storage (pièce jointe), notifications (affectation).
+EXPORTS
+  createMailroom({ repositories, numbering?, storage?, notifications?, now? }) -> { mail, calls, stats } ; createMemoryRepositories(); MailSchema, CallSchema
+API
+  mail.register({direction:'in'|'out',subject,from,to,bytes?|attachmentRef})/get/list({direction,status})/setStatus(id,status)/assign(id,to)
+  calls.log({caller,subject,handledBy,followUp})/list(filter) ; stats() -> {in,out,calls}
+PIÈGES
+  - direction in/out + subject requis. ref généré ARR-/DEP- via numbering. assign notifie (compose notifications). pièce jointe via storage.
+
+VISITEURS/RDV (0.2.0)
+  visitors.log({name*,org,purpose,host,appointmentAt}) | list(f) | checkIn(id) | checkOut(id) ; repositories.visitors optionnel ; stats().visitors

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@mostajs/mailroom",
+  "version": "0.2.0",
+  "description": "Courrier & accueil : registre courrier entrant/sortant + journal d'appels + rendez-vous/convocations. DB-agnostique ; compose numbering/storage/notifications.",
+  "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",
+    "mailroom",
+    "courrier",
+    "registre",
+    "accueil",
+    "calls"
+  ],
+  "scripts": {
+    "test": "node test-scripts/unit/mailroom.test.mjs",
+    "example": "node examples/registre/run.mjs"
+  }
+}

package/src/index.js

@@ -0,0 +1,3 @@
+export { createMailroom } from './mailroom.js';
+export { createMemoryRepositories } from './memory-repo.js';
+export { MailSchema, CallSchema, VisitorSchema } from './schemas.js';

package/src/mailroom.js

@@ -0,0 +1,36 @@
+// @mostajs/mailroom — courrier & accueil. Author: Dr Hamid MADANI <drmdh@msn.com>
+// Autonome/DB-agnostique. Compose (injectés) : numbering (n° courrier), storage (pièce jointe), notifications (affectation).
+export function createMailroom({ repositories, numbering, storage, notifications, now=()=>new Date() }={}){
+  if(!repositories?.mails) throw new Error('createMailroom: repositories.mails requis');
+  const { mails, calls, visitors } = repositories;
+  const ref=(dir)=> (numbering?.next ? numbering.next('mail-'+dir) : `${dir==='in'?'ARR':'DEP'}-${now().getFullYear()}-${Math.floor(now().getTime()%1000000)}`);
+  const putFile=async(bytes,mime)=>{ const fn=storage?.put||storage?.createFile; if(!fn)return null; const r=await fn.call(storage,bytes,{mime,mimeType:mime}); return typeof r==='string'?r:(r.id??r.ref); };
+  const api={
+    mail:{
+      async register({direction,subject,from,to,bytes,mime,attachmentRef}={}){
+        if(!['in','out'].includes(direction)) throw new Error("direction 'in'|'out' requise");
+        if(!subject) throw new Error('subject requis');
+        let att=attachmentRef; if(bytes&&storage) att=await putFile(bytes,mime);
+        return mails.create({ ref:ref(direction), direction, subject, from, to, date:now(), status: direction==='in'?'registered':'registered', attachmentRef:att });
+      },
+      get:(id)=>mails.findById(id),
+      list:(f={})=>mails.find(m=>Object.entries(f).every(([k,v])=>m[k]===v)),
+      setStatus:(id,status)=>mails.update(id,{status}),
+      async assign(id,to){ const m=await mails.update(id,{assignedTo:to,status:'assigned'}); notifications?.notify?.({type:'mail.assigned',mailId:id,to}); return m; },
+    },
+    calls:{
+      log:(dto)=>calls.create({at:now(),...dto}),
+      list:(f={})=>calls.find(c=>Object.entries(f).every(([k,v])=>c[k]===v)),
+    },
+    // Visiteurs & RDV (registre d'accueil) — repository optionnel (rétro-compat : silencieux si non fourni).
+    visitors:{
+      log:(dto)=>{ if(!visitors) throw new Error('repositories.visitors requis pour le registre des visiteurs'); return visitors.create({at:now(),status:'expected',...dto}); },
+      list:(f={})=> visitors? visitors.find(v=>Object.entries(f).every(([k,v2])=>v[k]===v2)) : Promise.resolve([]),
+      checkIn:(id)=> visitors.update(id,{status:'arrived',arrivedAt:now()}),
+      checkOut:(id)=> visitors.update(id,{status:'left',leftAt:now()}),
+    },
+    async stats(){ return { in: await mails.count(m=>m.direction==='in'), out: await mails.count(m=>m.direction==='out'), calls: await calls.count(), visitors: visitors? await visitors.count() : 0 }; },
+    repositories,
+  };
+  return api;
+}

package/src/memory-repo.js

@@ -0,0 +1,7 @@
+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})); },
+  async count(f=()=>true){ return [...m.values()].filter(f).length; } }; }
+export function createMemoryRepositories(){ return { mails:coll(), calls:coll(), visitors:coll() }; }

package/src/schemas.js

@@ -0,0 +1,14 @@
+// @mostajs/mailroom — schémas. Author: Dr Hamid MADANI <drmdh@msn.com>
+export const MailSchema = { name:'Mail', collection:'mails', timestamps:true, fields:{
+  ref:{type:'string'}, direction:{type:'string',enum:['in','out'],required:true}, subject:{type:'string',required:true},
+  from:{type:'string'}, to:{type:'string'}, date:{type:'date',default:'now'},
+  status:{type:'string',enum:['received','registered','assigned','processed','sent','archived'],default:'registered'},
+  assignedTo:{type:'string',default:null}, attachmentRef:{type:'string',default:null} },
+  indexes:[{fields:{direction:'asc'}},{fields:{status:'asc'}}] };
+export const CallSchema = { name:'CallLog', collection:'call_logs', timestamps:true, fields:{
+  at:{type:'date',default:'now'}, caller:{type:'string'}, subject:{type:'string'}, handledBy:{type:'string'}, followUp:{type:'boolean',default:false} } };
+// Visiteur / RDV (registre d'accueil) — ajout 0.2.0 (E9 Hadhinat).
+export const VisitorSchema = { name:'Visitor', collection:'visitors', timestamps:true, fields:{
+  at:{type:'date',default:'now'}, name:{type:'string',required:true}, org:{type:'string'}, purpose:{type:'string'},
+  host:{type:'string'}, appointmentAt:{type:'date',default:null},
+  status:{type:'string',enum:['expected','arrived','left'],default:'expected'}, arrivedAt:{type:'date',default:null}, leftAt:{type:'date',default:null} } };

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

@@ -0,0 +1,11 @@
+import assert from 'node:assert/strict';
+import { createMailroom, createMemoryRepositories } from '../../src/index.js';
+let pass=0; const test=async(n,f)=>{await f();pass++;console.log('  ✓',n);};
+const mk=(o={})=>createMailroom({ repositories:createMemoryRepositories(), ...o });
+await test('register courrier entrant + n° + validation', async()=>{ const m=mk(); await assert.rejects(()=>m.mail.register({direction:'x',subject:'s'}),/direction/); await assert.rejects(()=>m.mail.register({direction:'in'}),/subject/); const c=await m.mail.register({direction:'in',subject:'Demande',from:'Wilaya'}); assert.ok(c.ref.startsWith('ARR')); assert.equal(c.status,'registered'); });
+await test('courrier sortant + pièce jointe (storage)', async()=>{ const m=mk({ storage:{ async put(b){return 'att-1';} } }); const c=await m.mail.register({direction:'out',subject:'Réponse',to:'Banque',bytes:'pdf'}); assert.ok(c.ref.startsWith('DEP')); assert.equal(c.attachmentRef,'att-1'); });
+await test('affectation + notification', async()=>{ const ev=[]; const m=mk({ notifications:{ notify:(e)=>ev.push(e) } }); const c=await m.mail.register({direction:'in',subject:'X'}); await m.mail.assign(c.id,'secretaire'); assert.equal((await m.mail.get(c.id)).status,'assigned'); assert.equal(ev[0].type,'mail.assigned'); });
+await test('journal d\'appels', async()=>{ const m=mk(); await m.calls.log({caller:'0550...',subject:'RDV',handledBy:'accueil'}); assert.equal((await m.calls.list()).length,1); });
+await test('liste filtrée + stats', async()=>{ const m=mk(); await m.mail.register({direction:'in',subject:'a'}); await m.mail.register({direction:'out',subject:'b'}); await m.calls.log({caller:'x'}); assert.equal((await m.mail.list({direction:'in'})).length,1); const s=await m.stats(); assert.deepEqual(s,{in:1,out:1,calls:1,visitors:0}); });
+await test('registre des visiteurs / RDV (0.2.0) : log → checkIn → checkOut + stats', async()=>{ const m=mk(); const v=await m.visitors.log({name:'M. Bensaid',org:'ANDI',purpose:'Audit',host:'Direction'}); assert.equal(v.status,'expected'); assert.equal((await m.visitors.checkIn(v.id)).status,'arrived'); assert.equal((await m.visitors.checkOut(v.id)).status,'left'); assert.equal((await m.visitors.list()).length,1); assert.equal((await m.stats()).visitors,1); });
+console.log(`\n✅ @mostajs/mailroom — ${pass} tests OK`);