@mostajs/nomenclature 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog — @mostajs/nomenclature
+
+Format [Keep a Changelog](https://keepachangelog.com/fr/1.0.0/) · [SemVer](https://semver.org/lang/fr/).
+Auteur : Dr Hamid MADANI <drmdh@msn.com>
+
+## [0.2.0] — 2026-06-21
+
+### Added
+- **Seed `cim-10`** (CIM-10 / ICD-10, OMS) — extrait **représentatif oncologie** (tumeurs malignes C00–C97 : racine, blocs, catégories C16/C18/C22/C25/C34/C50/C53/C56/C61/C64/C67/C73/C81/C85/C90/C91/C92, sous-catégories `.9`). Export `CIM_10` + sous-chemin `./seed-cim10`.
+- **Seed `ccam`** (actes médicaux — logique CCAM) — imagerie (TDM/IRM/écho/TEP/DMO), spécialisés (coroscanner, scintigraphie), biologie (NFS/marqueurs), anatomopathologie (histologie/cytologie). Codes **illustratifs** ; charger CCAM/NABM/ADICAP officiels via `dataset` en prod. Export `CCAM` + `./seed-ccam`.
+- **Bundles par métier** (`src/seed-all.js`) : `HEALTH_SEEDS` (cim-10 + ccam, pour l'app santé — P3 Salsabil), `ACTIVITY_SEEDS` (naa-dz), `ALL_SEEDS` (rare), `BUILTIN_SCHEMES`. Exportés.
+- **Principe « chacun dans son métier »** : chaque app seede **le(s) schéma(s) de son domaine** — l'app santé injecte `dataset: HEALTH_SEEDS` ; l'app activités garde le **défaut `naa-dz`**. Pas de mélange de domaines par défaut.
+- Tests étendus (santé : `schemes.list`, `validate`, `path` pointé, `children`, recherche, **cloisonnement** entre schémas). Design doc : `docs/DESIGN-SEEDS-CIM10-CCAM.md`.
+
+### Unchanged (rétro-compat SemVer)
+- **Défaut inchangé** = `naa-dz` (Hadhinat/activités non impacté). Aucune rupture d'API.
+- Codes normalisés **sans points** (`C50.9` → `C509`) ; forme canonique pointée dans le libellé.
+
+## [0.1.0] — 2026-06-19
+
+### Added
+- Référentiel de **nomenclatures hiérarchiques** (codes d'activité officiels) — couvre le besoin **O4** Hadhinat (choix d'un code d'activité officiel), transverse (CRM/billing/reporting/déclarations légales). Feuille de route **E1**.
+- `createNomenclature({ repositories, dataset?, defaultScheme?, i18n? })` — façade composant `repositories`/`@mostajs/orm` (persistance), `@mostajs/i18n` (libellés FR/AR), `@mostajs/data-plug` (import). **Responsabilité unique** : charger / rechercher / valider / résoudre.
+- **Codes** : `search` (préfixe de code OU plein texte FR/AR, insensible casse+accents), `get`, `children` (arbre), `validate`, `path` (fil d'Ariane racine→feuille), `label` (FR/AR).
+- **Schémas** : `schemes.list`, `schemes.tree` (racines niveau 1). Normalisation des codes (majuscules, sans espaces ni points).
+- **Seed livré `naa-dz`** : Nomenclature Algérienne des Activités (alignée CITI Rev.4 / NACE ; réf. CNRC & ONS NAA-NAP) — extrait représentatif multi-sections, descendu au **niveau 5** sur la branche 62 (informatique). Extensible par `dataset` injecté.
+- Entité `NomenclatureCodeSchema` (5 niveaux : section/division/groupe/classe/activité) + `createMemoryRepositories`.
+- 7 tests unitaires + exemple `examples/activites` (sélecteur de code d'activité). Proposition `docs/00-PROPOSITION-PLAN-NOMENCLATURE-19062026.md`.

package/README.md

@@ -0,0 +1,64 @@
+# @mostajs/nomenclature
+
+> Référentiel de **nomenclatures hiérarchiques** — charger, **rechercher**, **valider** et **résoudre** des codes d'activité officiels.
+
+**Auteur** : Dr Hamid MADANI <drmdh@msn.com> · **Licence** : AGPL-3.0-or-later
+
+Module **mince** à responsabilité unique. Aucune logique métier : il modélise un **arbre de codes** (`section → division → groupe → classe → activité`) consultable et validable. Transverse — il sert la pépinière (**O4** Hadhinat : *« choisir le code exact de l'activité parmi la liste officielle »*) comme le CRM, la facturation, le reporting ou les déclarations légales.
+
+Schéma livré : **`naa-dz`** — *Nomenclature Algérienne des Activités* (alignée CITI Rev.4 / NACE ; réf. **CNRC** & **ONS** NAA-NAP). Extensible (`naf-fr`, `nace-eu`…) par simple `dataset` injecté.
+
+## Installation
+
+```bash
+npm install @mostajs/nomenclature
+```
+
+## Usage
+
+```js
+import { createNomenclature, createMemoryRepositories } from '@mostajs/nomenclature';
+
+const nom = createNomenclature({ repositories: createMemoryRepositories() }); // seed 'naa-dz' livré
+
+await nom.codes.search('informatique');     // → propositions (préfixe code OU plein texte FR/AR)
+await nom.codes.validate('62011');          // → { ok:true, normalized:'62011', label:'…', level:5 }
+await nom.codes.path('62011');              // → [J › 62 › 620 › 6201 › 62011] (fil d'Ariane)
+await nom.codes.children('J');              // → divisions de la section J
+await nom.codes.label('62011', { lang:'ar' }); // → 'تطوير البرمجيات حسب الطلب'
+await nom.schemes.tree();                   // → sections (racines)
+```
+
+En production, injecter de vrais repositories `@mostajs/orm` et un `dataset` complet :
+
+```js
+import { createNomenclature } from '@mostajs/nomenclature';
+const nom = createNomenclature({ repositories: ormRepos, dataset: jeuOfficielComplet, i18n });
+```
+
+## API
+
+| Méthode | Retour |
+|---|---|
+| `codes.search(q, { scheme?, limit?, level?, activeOnly? })` | `[{ scheme, code, label, level, parentCode }]` — préfixe de code **ou** plein texte (insensible casse+accents, FR/AR) |
+| `codes.get(code, { scheme? })` | `{ scheme, code, label, labelAr, parent, level, active }` \| `null` |
+| `codes.children(code, { scheme? })` | sous-codes directs |
+| `codes.validate(code, { scheme? })` | `{ ok, normalized, label, level }` \| `{ ok:false, reason }` |
+| `codes.path(code, { scheme? })` | `[{code,label,level}…]` racine → feuille |
+| `codes.label(code, { scheme?, lang })` | libellé résolu (`fr`\|`ar`) |
+| `schemes.list()` / `schemes.tree({ scheme? })` | schémas présents / racines (niveau 1) |
+
+## Composition (injection)
+
+`repositories` (**obligatoire**) · `dataset` (défaut = seed `naa-dz`) · `i18n` (libellés FR/AR) · `data-plug` (import). Les codes sont **normalisés** (majuscules, sans espaces ni points : `62.01` → `6201`).
+
+> **Niveaux** : `1` section (lettre A…U) · `2` division (2 ch.) · `3` groupe (3) · `4` classe (4) · `5` activité nationale (5).
+
+## Tests & exemple
+
+```bash
+npm test       # 7 tests unitaires
+npm run example # sélecteur de code d'activité (O4)
+```
+
+Voir `docs/00-PROPOSITION-PLAN-NOMENCLATURE-19062026.md` (cas C, étape E1).

package/llms.txt

@@ -0,0 +1,54 @@
+# @mostajs/nomenclature — llms.txt
+
+RÔLE
+  Référentiel de NOMENCLATURES hiérarchiques (codes d'activité officiels). Responsabilité UNIQUE : charger,
+  rechercher, valider et résoudre des codes liés par parentCode (section → division → groupe → classe → activité).
+  AUCUNE logique métier. Transverse : pépinière (O4 Hadhinat : choix d'un code d'activité officiel), CRM,
+  facturation, reporting, déclarations légales, SANTÉ (diagnostic/examens). Schémas livrés : 'naa-dz' (activités,
+  CNRC/ONS, CITI/NACE), 'cim-10' (diagnostics OMS/ICD-10 — oncologie représentative), 'ccam' (actes médicaux —
+  imagerie/bio/anapath, codes illustratifs). Multi-schéma. Extensible (naf-fr, nace-eu, CCAM/NABM/ADICAP officiels…) par `dataset`.
+  MÉTIER : "chacun dans son métier" — l'app santé injecte HEALTH_SEEDS (cim-10+ccam) ; l'app activités garde le défaut naa-dz.
+  Bundles : HEALTH_SEEDS, ACTIVITY_SEEDS, ALL_SEEDS (rare), BUILTIN_SCHEMES. Seeds : CIM_10, CCAM, NAA_DZ. Sous-chemins ./seed-cim10 ./seed-ccam.
+
+COMPOSE (injection de dépendances)
+  repositories  OBLIGATOIRE — { codes }. Persistance + recherche. createMemoryRepositories() pour tests ;
+                vrais repos @mostajs/orm en prod.
+  dataset       jeu de codes à charger ; défaut = seed 'naa-dz' livré. Idempotent (skip si (scheme,code) existe).
+  i18n          @mostajs/i18n — résolution de libellés FR/AR si non portés par la donnée (optionnel).
+  data-plug     @mostajs/data-plug — import de gros référentiels officiels (CSV/JSON) → dataset (côté app).
+  HORS PÉRIMÈTRE : rattacher un code à une entreprise → cas B @mostajs/incubator 0.2.0 (Company.activityCode).
+
+EXPORTS (src/index.js)
+  createNomenclature({ repositories, dataset?, defaultScheme='naa-dz', i18n? }) -> api
+  createMemoryRepositories() -> { codes }
+  NomenclatureCodeSchema (./schemas) ; NAA_DZ (./seed-naa-dz)
+
+API   (toutes async ; `await api.ready` ou appeler une méthode — le seed est chargé paresseusement)
+  codes.search(q, { scheme?, limit=20, level?, activeOnly=true }) -> [{ scheme, code, label, level, parentCode }]
+            recherche par PRÉFIXE de code OU PLEIN TEXTE de libellé (FR/AR, insensible casse+accents)
+  codes.get(code, { scheme? })        -> { scheme, code, label, labelAr, parent, level, active } | null
+  codes.children(code, { scheme? })   -> sous-codes directs (navigation arborescente)
+  codes.validate(code, { scheme? })   -> { ok:true, normalized, label, level } | { ok:false, reason }
+  codes.path(code, { scheme? })       -> [{code,label,level}…] fil d'Ariane racine→feuille ([] si absent)
+  codes.label(code, { scheme?, lang='fr'|'ar' }) -> libellé résolu
+  schemes.list() -> ['naa-dz', …]   ; schemes.tree({ scheme? }) -> racines (level 1)
+  ready -> Promise (seed chargé) ; repositories
+
+ENTITÉ (schema)
+  NomenclatureCode { scheme*, code*, label*, labelAr?, parentCode (null=racine), level (1..5), active }
+  Niveaux : 1 section (lettre A..U) · 2 division (2 ch.) · 3 groupe (3) · 4 classe (4) · 5 activité nationale (5).
+
+PIÈGES
+  - Les codes sont NORMALISÉS : majuscules, sans espaces ni points ('62.01' / ' 6201 ' → '6201').
+  - search() est insensible aux accents (NFD) ET à la casse ; matche aussi le libellé arabe.
+  - validate() distingue 'code inconnu' (absent du schéma) de 'code inactif' (active:false).
+  - path()/children() suivent parentCode dans LE schéma demandé (defaultScheme sinon).
+  - Le seed 'naa-dz' est REPRÉSENTATIF (pas exhaustif) : breadth multi-sections, depth complète sur la branche 62
+    (informatique, jusqu'au niveau 5). Injecter un `dataset` complet en prod.
+  - DB-agnostique : injecter de vrais repositories @mostajs/orm en prod.
+
+EXEMPLE / TEST
+  examples/activites/run.mjs   sélecteur d'activité O4 : search → validate → path → arbre → libellé AR
+  test-scripts/unit/nomenclature.test.mjs   7 tests (seed, get/normalisation, children, validate, path, search, composition/dataset)
+
+LICENCE AGPL-3.0-or-later · Auteur Dr Hamid MADANI <drmdh@msn.com>

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@mostajs/nomenclature",
+  "version": "0.2.0",
+  "description": "Référentiel de nomenclatures hiérarchiques (codes officiels) : charger, rechercher, valider et résoudre des codes liés par parentCode. Multi-schéma. Seeds livrés : 'naa-dz' (activités, CNRC/ONS), 'cim-10' (diagnostics, OMS/ICD-10), 'ccam' (actes médicaux). COMPOSE repository/orm/i18n. Couvre O4 Hadhinat + dossier médical (P3 Salsabil).",
+  "license": "AGPL-3.0-or-later",
+  "author": "Dr Hamid MADANI <drmdh@msn.com>",
+  "type": "module",
+  "main": "src/index.js",
+  "files": [
+    "src",
+    "llms.txt",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": "./src/index.js",
+    "./schemas": "./src/schemas.js",
+    "./seed-naa-dz": "./src/seed-naa-dz.js",
+    "./seed-cim10": "./src/seed-cim10.js",
+    "./seed-ccam": "./src/seed-ccam.js"
+  },
+  "keywords": [
+    "mostajs",
+    "nomenclature",
+    "naa",
+    "cnrc",
+    "ons",
+    "code-activite",
+    "nace",
+    "citi",
+    "cim-10",
+    "icd-10",
+    "ccam",
+    "oms",
+    "diagnostic",
+    "acte-medical",
+    "referentiel",
+    "hadhinat",
+    "salsabil"
+  ],
+  "scripts": {
+    "test": "node test-scripts/unit/nomenclature.test.mjs",
+    "example": "node examples/activites/run.mjs"
+  }
+}

package/src/index.js

@@ -0,0 +1,8 @@
+// @mostajs/nomenclature — point d'entrée. Author: Dr Hamid MADANI <drmdh@msn.com>
+export { createNomenclature } from './nomenclature.js';
+export { createMemoryRepositories } from './memory-repo.js';
+export { NomenclatureCodeSchema } from './schemas.js';
+export { NAA_DZ } from './seed-naa-dz.js';
+export { CIM_10 } from './seed-cim10.js';   // schéma 'cim-10' (diagnostics — oncologie représentative)
+export { CCAM } from './seed-ccam.js';      // schéma 'ccam' (actes/examens — imagerie/bio/anapath représentatifs)
+export { HEALTH_SEEDS, ACTIVITY_SEEDS, ALL_SEEDS, BUILTIN_SCHEMES } from './seed-all.js';   // bundles par métier (santé injecte HEALTH_SEEDS)

package/src/memory-repo.js

@@ -0,0 +1,7 @@
+// @mostajs/nomenclature — repo in-memory pour tests/exemples (DB réelle via @mostajs/orm au déploiement). 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 { codes:coll() }; }

package/src/nomenclature.js

@@ -0,0 +1,83 @@
+// @mostajs/nomenclature — référentiel de nomenclatures hiérarchiques (codes d'activité officiels). Author: Dr Hamid MADANI <drmdh@msn.com>
+// Responsabilité UNIQUE : charger / rechercher / valider / résoudre des codes liés par parentCode. AUCUNE logique métier.
+// COMPOSE par injection : repositories (persistance, @mostajs/orm en prod), i18n (libellés FR/AR), data-plug (import gros jeux côté app).
+// Couvre le besoin O4 de Hadhinat (choix d'un code d'activité officiel) — mais transverse : CRM, billing, reporting, déclarations légales.
+
+import { NAA_DZ } from './seed-naa-dz.js';   // défaut = domaine activités ; la santé injecte HEALTH_SEEDS (chacun son métier)
+
+// Normalise un code : majuscules, sans espaces ni points (ex. '62.01' / ' 6201 ' → '6201').
+const normCode = (c) => String(c ?? '').trim().toUpperCase().replace(/[\s.]/g, '');
+// Replie un texte pour recherche insensible à la casse ET aux accents.
+const fold = (s) => String(s ?? '').toLowerCase().normalize('NFD').replace(/[̀-ͯ]/g, '');
+const byCode = (a, b) => (a.level - b.level) || String(a.code).localeCompare(String(b.code));
+const view = (r) => r && ({ scheme: r.scheme, code: r.code, label: r.label, labelAr: r.labelAr ?? null, parent: r.parentCode ?? null, parentCode: r.parentCode ?? null, level: r.level, active: r.active !== false });
+
+export function createNomenclature({ repositories, dataset, defaultScheme = 'naa-dz', i18n } = {}) {
+  if (!repositories?.codes) throw new Error('createNomenclature: repositories.codes requis');
+  const { codes } = repositories;
+
+  // Seed : `dataset` injecté (chaque app son métier : santé → HEALTH_SEEDS, activités → naa-dz) sinon 'naa-dz' par défaut.
+  // Idempotent (skip si (scheme,code) déjà présent).
+  const seed = (dataset ?? NAA_DZ).map((r) => ({ scheme: r.scheme || defaultScheme, active: true, ...r, code: normCode(r.code), parentCode: r.parentCode == null ? null : normCode(r.parentCode) }));
+  const ready = (async () => {
+    for (const r of seed) {
+      const [exists] = await codes.find((x) => x.scheme === r.scheme && x.code === r.code);
+      if (!exists) await codes.create(r);
+    }
+  })();
+
+  const findOne = async (code, scheme) => { const [r] = await codes.find((x) => x.scheme === scheme && x.code === normCode(code)); return r || null; };
+
+  const api = {
+    ready,
+    codes: {
+      /** Recherche par préfixe de code OU plein texte (libellé FR/AR, sans accents). */
+      async search(q, { scheme = defaultScheme, limit = 20, level = null, activeOnly = true } = {}) {
+        await ready;
+        const needle = fold(q); const needleCode = normCode(q);
+        const rows = await codes.find((x) => x.scheme === scheme
+          && (activeOnly ? x.active !== false : true)
+          && (level == null || x.level === level)
+          && (!q || x.code.startsWith(needleCode) || fold(x.label).includes(needle) || fold(x.labelAr).includes(needle)));
+        return rows.sort(byCode).slice(0, limit).map(view);
+      },
+      /** Détail d'un code. null si absent. */
+      async get(code, { scheme = defaultScheme } = {}) { await ready; return view(await findOne(code, scheme)); },
+      /** Sous-codes directs (navigation arborescente). */
+      async children(code, { scheme = defaultScheme } = {}) {
+        await ready; const p = normCode(code);
+        return (await codes.find((x) => x.scheme === scheme && x.parentCode === p)).sort(byCode).map(view);
+      },
+      /** Valide un code : { ok, normalized, label, level } | { ok:false, reason }. */
+      async validate(code, { scheme = defaultScheme } = {}) {
+        await ready; const r = await findOne(code, scheme);
+        if (!r) return { ok: false, reason: `code inconnu dans le schéma '${scheme}'` };
+        if (r.active === false) return { ok: false, reason: 'code inactif' };
+        return { ok: true, normalized: r.code, label: r.label, level: r.level };
+      },
+      /** Fil d'Ariane racine → feuille : [section, division, …, activité]. [] si code absent. */
+      async path(code, { scheme = defaultScheme } = {}) {
+        await ready; const out = []; let cur = await findOne(code, scheme); const guard = new Set();
+        while (cur && !guard.has(cur.code)) { guard.add(cur.code); out.push({ code: cur.code, label: cur.label, level: cur.level }); cur = cur.parentCode ? await findOne(cur.parentCode, scheme) : null; }
+        return out.reverse();
+      },
+      /** Libellé résolu (lang 'fr'|'ar') — via la donnée, sinon @mostajs/i18n si injecté. */
+      async label(code, { scheme = defaultScheme, lang = 'fr' } = {}) {
+        await ready; const r = await findOne(code, scheme); if (!r) return null;
+        if (lang === 'ar') return r.labelAr || i18n?.t?.(`nomenclature.${scheme}.${r.code}`, { lang: 'ar' }) || r.label;
+        return r.label;
+      },
+    },
+    schemes: {
+      /** Schémas présents en base. */
+      async list() { await ready; return [...new Set((await codes.find()).map((x) => x.scheme))].sort(); },
+      /** Racines (level 1) d'un schéma — point d'entrée d'un arbre paresseux via codes.children(). */
+      async tree({ scheme = defaultScheme } = {}) {
+        await ready;
+        return (await codes.find((x) => x.scheme === scheme && (x.parentCode == null || x.level === 1))).sort(byCode).map(view);
+      },
+    },
+    repositories,
+  };
+  return api;
+}

package/src/schemas.js

@@ -0,0 +1,13 @@
+// @mostajs/nomenclature — schéma mince d'un code de nomenclature hiérarchique. Author: Dr Hamid MADANI <drmdh@msn.com>
+// Un référentiel = des codes liés par parentCode (section → division → groupe → classe → activité), réutilisable hors pépinière.
+
+// Code de nomenclature normalisé (réf. CNRC / ONS NAA-NAP pour 'naa-dz'; extensible NAF/NACE).
+export const NomenclatureCodeSchema = { name:'NomenclatureCode', collection:'codes', timestamps:true, fields:{
+  scheme:{type:'string',required:true,default:'naa-dz'},     // jeu de nomenclature ('naa-dz','naf-fr',…)
+  code:{type:'string',required:true},                        // code dans le schéma (ex. '6201')
+  label:{type:'string',required:true},                       // libellé (FR par défaut)
+  labelAr:{type:'string',default:null},                      // libellé arabe (optionnel ; sinon via @mostajs/i18n)
+  parentCode:{type:'string',default:null},                   // code parent (null = racine/section)
+  level:{type:'number',default:1},                           // 1 section · 2 division · 3 groupe · 4 classe · 5 activité
+  active:{type:'boolean',default:true} },
+  indexes:[{fields:{scheme:'asc',code:'asc'},unique:true},{fields:{scheme:'asc',parentCode:'asc'}}] };

package/src/seed-all.js

@@ -0,0 +1,19 @@
+// @mostajs/nomenclature — bundles de schémas par MÉTIER (chacun dans son domaine). Author: Dr Hamid MADANI <drmdh@msn.com>
+// Principe : chaque application seede LE(S) schéma(s) de SON métier — l'app santé injecte HEALTH_SEEDS,
+// l'app activités garde le défaut 'naa-dz'. On NE mélange PAS les domaines par défaut.
+// `ALL_SEEDS` reste disponible pour un cas (rare) où une app a réellement besoin de tous les schémas.
+import { NAA_DZ } from './seed-naa-dz.js';
+import { CIM_10 } from './seed-cim10.js';
+import { CCAM } from './seed-ccam.js';
+
+/** Registre nom→seed des schémas intégrés. */
+export const BUILTIN_SCHEMES = { 'naa-dz': NAA_DZ, 'cim-10': CIM_10, 'ccam': CCAM };
+
+/** Bundle métier ACTIVITÉS (à injecter dans une app d'activités, ou défaut implicite). */
+export const ACTIVITY_SEEDS = [...NAA_DZ];
+
+/** Bundle métier SANTÉ : diagnostics (cim-10) + actes/examens (ccam). À injecter dans l'app santé (P3 Salsabil). */
+export const HEALTH_SEEDS = [...CIM_10, ...CCAM];
+
+/** Tous les schémas (usage rare ; ne PAS utiliser comme défaut — chacun son métier). */
+export const ALL_SEEDS = [...NAA_DZ, ...CIM_10, ...CCAM];

package/src/seed-ccam.js

@@ -0,0 +1,32 @@
+// @mostajs/nomenclature — seed 'ccam' : actes médicaux (logique CCAM) — imagerie / exploration / biologie / anapath.
+// Author: Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+// Extrait REPRÉSENTATIF, codes ILLUSTRATIFS (préfixés par catégorie) pour composer @mostajs/medical-cases (type d'examen).
+// En PRODUCTION : charger les référentiels OFFICIELS via `dataset` injecté — CCAM (actes techniques),
+// NABM (biologie médicale), ADICAP (anatomopathologie). Ici : catalogue minimal couvrant la spec Salsabil.
+// Niveaux : 1 catégorie · 2 acte.
+
+export const CCAM = [
+  // ── Imagerie médicale ──
+  { scheme: 'ccam', code: 'IMG', label: 'Imagerie médicale', labelAr: 'التصوير الطبي', parentCode: null, level: 1 },
+  { scheme: 'ccam', code: 'IMG-TDM', label: 'Tomodensitométrie (Scanner / TDM)', parentCode: 'IMG', level: 2 },
+  { scheme: 'ccam', code: 'IMG-IRM', label: 'Imagerie par résonance magnétique (IRM)', parentCode: 'IMG', level: 2 },
+  { scheme: 'ccam', code: 'IMG-ECHO', label: 'Échographie', parentCode: 'IMG', level: 2 },
+  { scheme: 'ccam', code: 'IMG-TEP', label: 'Tomographie par émission de positons (TEP-Scan)', parentCode: 'IMG', level: 2 },
+  { scheme: 'ccam', code: 'IMG-DMO', label: 'Ostéodensitométrie (DMO)', parentCode: 'IMG', level: 2 },
+
+  // ── Examens spécialisés ──
+  { scheme: 'ccam', code: 'EXP', label: 'Examens spécialisés', parentCode: null, level: 1 },
+  { scheme: 'ccam', code: 'EXP-CORO', label: 'Coroscanner (angioscanner coronaire)', parentCode: 'EXP', level: 2 },
+  { scheme: 'ccam', code: 'EXP-SCINT', label: 'Scintigraphie osseuse', parentCode: 'EXP', level: 2 },
+
+  // ── Biologie médicale (réf. officielle : NABM) ──
+  { scheme: 'ccam', code: 'BIO', label: 'Biologie médicale (analyses)', labelAr: 'التحاليل الطبية', parentCode: null, level: 1 },
+  { scheme: 'ccam', code: 'BIO-NFS', label: 'Numération formule sanguine (NFS)', parentCode: 'BIO', level: 2 },
+  { scheme: 'ccam', code: 'BIO-MARQ', label: 'Marqueurs tumoraux', parentCode: 'BIO', level: 2 },
+  { scheme: 'ccam', code: 'BIO-DIV', label: 'Analyses médicales diverses', parentCode: 'BIO', level: 2 },
+
+  // ── Anatomopathologie (réf. officielle : ADICAP) ──
+  { scheme: 'ccam', code: 'ANP', label: 'Anatomopathologie', parentCode: null, level: 1 },
+  { scheme: 'ccam', code: 'ANP-HISTO', label: 'Examen histologique (ANAPATH)', parentCode: 'ANP', level: 2 },
+  { scheme: 'ccam', code: 'ANP-CYTO', label: 'Examen cytologique', parentCode: 'ANP', level: 2 },
+];

package/src/seed-cim10.js

@@ -0,0 +1,47 @@
+// @mostajs/nomenclature — seed 'cim-10' : Classification Internationale des Maladies, 10ᵉ révision (OMS / ICD-10).
+// Author: Dr Hamid MADANI <drmdh@msn.com> · AGPL-3.0-or-later
+// Extrait REPRÉSENTATIF (oncologie : tumeurs malignes C00–C97) pour composer @mostajs/medical-cases (diagnostic).
+// PAS exhaustif : charger le référentiel CIM-10 complet via `dataset` injecté en prod (createNomenclature).
+// NB : le module normalise les codes (majuscules, SANS points) → 'C50.9' est stocké 'C509' ; la forme canonique
+// pointée figure dans le libellé. Niveaux : 1 racine · 2 bloc (plage) · 3 catégorie (3 car.) · 4 sous-catégorie.
+
+export const CIM_10 = [
+  { scheme: 'cim-10', code: 'C00-C97', label: 'Tumeurs malignes', labelAr: 'الأورام الخبيثة', parentCode: null, level: 1 },
+
+  // ── Blocs (plages) ──
+  { scheme: 'cim-10', code: 'C00-C14', label: 'Lèvre, cavité buccale et pharynx', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C15-C26', label: 'Organes digestifs', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C30-C39', label: 'Organes respiratoires et intrathoraciques', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C40-C41', label: 'Os et cartilage articulaire', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C43-C44', label: 'Mélanome et autres tumeurs malignes de la peau', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C50', label: 'Tumeur maligne du sein', labelAr: 'سرطان الثدي', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C51-C58', label: 'Organes génitaux de la femme', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C60-C63', label: 'Organes génitaux de l’homme', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C64-C68', label: 'Voies urinaires', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C73-C75', label: 'Thyroïde et autres glandes endocrines', parentCode: 'C00-C97', level: 2 },
+  { scheme: 'cim-10', code: 'C81-C96', label: 'Tissus lymphoïde, hématopoïétique et apparentés', parentCode: 'C00-C97', level: 2 },
+
+  // ── Catégories (3 caractères) ──
+  { scheme: 'cim-10', code: 'C16', label: 'Tumeur maligne de l’estomac', parentCode: 'C15-C26', level: 3 },
+  { scheme: 'cim-10', code: 'C18', label: 'Tumeur maligne du côlon', parentCode: 'C15-C26', level: 3 },
+  { scheme: 'cim-10', code: 'C22', label: 'Tumeur maligne du foie et des voies biliaires intrahépatiques', parentCode: 'C15-C26', level: 3 },
+  { scheme: 'cim-10', code: 'C25', label: 'Tumeur maligne du pancréas', parentCode: 'C15-C26', level: 3 },
+  { scheme: 'cim-10', code: 'C34', label: 'Tumeur maligne des bronches et du poumon', labelAr: 'سرطان الرئة', parentCode: 'C30-C39', level: 3 },
+  { scheme: 'cim-10', code: 'C53', label: 'Tumeur maligne du col de l’utérus', parentCode: 'C51-C58', level: 3 },
+  { scheme: 'cim-10', code: 'C56', label: 'Tumeur maligne de l’ovaire', parentCode: 'C51-C58', level: 3 },
+  { scheme: 'cim-10', code: 'C61', label: 'Tumeur maligne de la prostate', labelAr: 'سرطان البروستاتا', parentCode: 'C60-C63', level: 3 },
+  { scheme: 'cim-10', code: 'C64', label: 'Tumeur maligne du rein, sauf bassinet', parentCode: 'C64-C68', level: 3 },
+  { scheme: 'cim-10', code: 'C67', label: 'Tumeur maligne de la vessie', parentCode: 'C64-C68', level: 3 },
+  { scheme: 'cim-10', code: 'C73', label: 'Tumeur maligne de la thyroïde', parentCode: 'C73-C75', level: 3 },
+  { scheme: 'cim-10', code: 'C81', label: 'Maladie de Hodgkin (lymphome hodgkinien)', parentCode: 'C81-C96', level: 3 },
+  { scheme: 'cim-10', code: 'C85', label: 'Lymphomes non hodgkiniens, autres et non précisés', parentCode: 'C81-C96', level: 3 },
+  { scheme: 'cim-10', code: 'C90', label: 'Myélome multiple et tumeurs malignes à plasmocytes', parentCode: 'C81-C96', level: 3 },
+  { scheme: 'cim-10', code: 'C91', label: 'Leucémie lymphoïde', parentCode: 'C81-C96', level: 3 },
+  { scheme: 'cim-10', code: 'C92', label: 'Leucémie myéloïde', parentCode: 'C81-C96', level: 3 },
+
+  // ── Sous-catégories (.9 = sans précision) — code dédoté par le module (C50.9 → C509) ──
+  { scheme: 'cim-10', code: 'C50.9', label: 'Sein, sans précision (C50.9)', parentCode: 'C50', level: 3 },
+  { scheme: 'cim-10', code: 'C34.9', label: 'Bronche ou poumon, sans précision (C34.9)', parentCode: 'C34', level: 4 },
+  { scheme: 'cim-10', code: 'C18.9', label: 'Côlon, sans précision (C18.9)', parentCode: 'C18', level: 4 },
+  { scheme: 'cim-10', code: 'C61.9', label: 'Prostate, sans précision (C61.9)', parentCode: 'C61', level: 4 },
+];

package/src/seed-naa-dz.js

@@ -0,0 +1,86 @@
+// @mostajs/nomenclature — seed 'naa-dz' : Nomenclature Algérienne des Activités (alignée CITI Rev.4 / NACE).
+// Réf. : CNRC (Centre National du Registre du Commerce) & ONS (NAA-NAP). Author: Dr Hamid MADANI <drmdh@msn.com>
+// Extrait REPRÉSENTATIF (pas exhaustif) : breadth multi-sections + depth complète sur la branche 62 (informatique)
+// jusqu'au niveau 5 (activité nationale) pour démontrer path()/children(). Étendre par `dataset` injecté en prod.
+// Niveaux : 1 section (lettre) · 2 division (2 ch.) · 3 groupe (3) · 4 classe (4) · 5 activité (5).
+
+export const NAA_DZ = [
+  // ── Section A — Agriculture, sylviculture et pêche ──
+  { code:'A', label:'Agriculture, sylviculture et pêche', labelAr:'الفلاحة والغابات والصيد', parentCode:null, level:1 },
+  { code:'01', label:'Culture et production animale, chasse', parentCode:'A', level:2 },
+  { code:'011', label:'Cultures non permanentes', parentCode:'01', level:3 },
+  { code:'0111', label:'Culture de céréales et de légumineuses', parentCode:'011', level:4 },
+  { code:'0113', label:'Culture de légumes et de melons', parentCode:'011', level:4 },
+  { code:'03', label:'Pêche et aquaculture', parentCode:'A', level:2 },
+  { code:'032', label:'Aquaculture', parentCode:'03', level:3 },
+
+  // ── Section C — Industrie manufacturière ──
+  { code:'C', label:'Industrie manufacturière', labelAr:'الصناعة التحويلية', parentCode:null, level:1 },
+  { code:'10', label:'Industries alimentaires', parentCode:'C', level:2 },
+  { code:'107', label:'Fabrication de produits de boulangerie et pâtes', parentCode:'10', level:3 },
+  { code:'1071', label:'Fabrication de pain et de pâtisserie fraîche', parentCode:'107', level:4 },
+  { code:'13', label:'Fabrication de textiles', parentCode:'C', level:2 },
+
+  // ── Section F — Construction ──
+  { code:'F', label:'Construction', labelAr:'البناء والأشغال العمومية', parentCode:null, level:1 },
+  { code:'41', label:'Construction de bâtiments', parentCode:'F', level:2 },
+  { code:'412', label:'Construction de bâtiments résidentiels et non résidentiels', parentCode:'41', level:3 },
+  { code:'4120', label:'Construction de bâtiments résidentiels et non résidentiels', parentCode:'412', level:4 },
+  { code:'43', label:'Travaux de construction spécialisés', parentCode:'F', level:2 },
+
+  // ── Section G — Commerce; réparation d'automobiles et de motocycles ──
+  { code:'G', label:'Commerce; réparation d\'automobiles et de motocycles', labelAr:'التجارة وإصلاح السيارات', parentCode:null, level:1 },
+  { code:'47', label:'Commerce de détail, sauf automobiles et motocycles', parentCode:'G', level:2 },
+  { code:'479', label:'Commerce de détail hors magasin, éventaires ou marchés', parentCode:'47', level:3 },
+  { code:'4791', label:'Vente à distance (commerce électronique)', labelAr:'البيع عن بعد (التجارة الإلكترونية)', parentCode:'479', level:4 },
+
+  // ── Section I — Hébergement et restauration ──
+  { code:'I', label:'Hébergement et restauration', labelAr:'الإيواء والإطعام', parentCode:null, level:1 },
+  { code:'55', label:'Hébergement', parentCode:'I', level:2 },
+  { code:'56', label:'Restauration', parentCode:'I', level:2 },
+  { code:'561', label:'Restaurants et services de restauration mobile', parentCode:'56', level:3 },
+  { code:'5610', label:'Restauration traditionnelle', parentCode:'561', level:4 },
+
+  // ── Section J — Information et communication ──
+  { code:'J', label:'Information et communication', labelAr:'الإعلام والاتصال', parentCode:null, level:1 },
+  { code:'58', label:'Édition', parentCode:'J', level:2 },
+  { code:'582', label:'Édition de logiciels', parentCode:'58', level:3 },
+  { code:'5829', label:'Édition d\'autres logiciels', parentCode:'582', level:4 },
+  { code:'61', label:'Télécommunications', labelAr:'الاتصالات السلكية واللاسلكية', parentCode:'J', level:2 },
+  { code:'62', label:'Programmation, conseil et autres activités informatiques', labelAr:'البرمجة والاستشارة والأنشطة المعلوماتية', parentCode:'J', level:2 },
+  { code:'620', label:'Programmation, conseil et autres activités informatiques', parentCode:'62', level:3 },
+  { code:'6201', label:'Programmation informatique', labelAr:'البرمجة المعلوماتية', parentCode:'620', level:4 },
+  { code:'62011', label:'Développement de logiciels sur mesure', labelAr:'تطوير البرمجيات حسب الطلب', parentCode:'6201', level:5 },
+  { code:'62012', label:'Édition de logiciels applicatifs et services SaaS', labelAr:'نشر البرمجيات التطبيقية وخدمات SaaS', parentCode:'6201', level:5 },
+  { code:'6202', label:'Conseil informatique', labelAr:'الاستشارة المعلوماتية', parentCode:'620', level:4 },
+  { code:'6203', label:'Gestion d\'installations informatiques', parentCode:'620', level:4 },
+  { code:'6209', label:'Autres activités informatiques', parentCode:'620', level:4 },
+  { code:'63', label:'Services d\'information', parentCode:'J', level:2 },
+  { code:'631', label:'Traitement de données, hébergement et portails', parentCode:'63', level:3 },
+  { code:'6311', label:'Traitement de données, hébergement et activités connexes', labelAr:'معالجة المعطيات والاستضافة', parentCode:'631', level:4 },
+  { code:'6312', label:'Portails internet', parentCode:'631', level:4 },
+
+  // ── Section M — Activités spécialisées, scientifiques et techniques ──
+  { code:'M', label:'Activités spécialisées, scientifiques et techniques', labelAr:'الأنشطة المتخصصة والعلمية والتقنية', parentCode:null, level:1 },
+  { code:'69', label:'Activités juridiques et comptables', parentCode:'M', level:2 },
+  { code:'691', label:'Activités juridiques', parentCode:'69', level:3 },
+  { code:'692', label:'Activités comptables, de gestion et d\'audit', parentCode:'69', level:3 },
+  { code:'70', label:'Activités des sièges sociaux; conseil de gestion', parentCode:'M', level:2 },
+  { code:'702', label:'Conseil de gestion', parentCode:'70', level:3 },
+  { code:'7022', label:'Conseil pour les affaires et autres conseils de gestion', labelAr:'استشارات في الأعمال والتسيير', parentCode:'702', level:4 },
+  { code:'72', label:'Recherche-développement scientifique', parentCode:'M', level:2 },
+  { code:'73', label:'Publicité et études de marché', parentCode:'M', level:2 },
+  { code:'731', label:'Publicité', parentCode:'73', level:3 },
+  { code:'7311', label:'Activités des agences de publicité', labelAr:'أنشطة وكالات الإشهار', parentCode:'731', level:4 },
+
+  // ── Section P — Enseignement ──
+  { code:'P', label:'Enseignement', labelAr:'التعليم', parentCode:null, level:1 },
+  { code:'85', label:'Enseignement', parentCode:'P', level:2 },
+  { code:'855', label:'Autres activités d\'enseignement', parentCode:'85', level:3 },
+  { code:'8559', label:'Enseignements divers (formation continue)', labelAr:'التكوين المتواصل', parentCode:'855', level:4 },
+
+  // ── Section Q — Santé humaine et action sociale ──
+  { code:'Q', label:'Santé humaine et action sociale', labelAr:'الصحة والعمل الاجتماعي', parentCode:null, level:1 },
+  { code:'86', label:'Activités pour la santé humaine', parentCode:'Q', level:2 },
+  { code:'862', label:'Activités des médecins et des dentistes', parentCode:'86', level:3 },
+];