@mostajs/flotte 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -3,14 +3,28 @@
 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.3.0] — non publiée
+## [0.4.0] — non publiée
+### Added
+- `poserEcheance` garde `reference` (n° de police, de procès-verbal) et `organisme` ; `piece` accepte un objet
+  (`{ nom, empreinte, deposePar, deposeLe }`) : colonne JSON. Essai T-FLO-18.
+- Un relevé garde ses `avertissements` (saut anormal), lisibles dans son historique. Essai T-FLO-19.
+- `modifier(id, champs)` : les champs descriptifs (plaque contrôlée, attributs validés par le type, site, mode,
+  `chassis`, `miseEnService`…), jamais le code, le type ni le statut ; inscrit à l'historique
+  (`{ le, agent, modification: { champs } }`). `inscrire` accepte `chassis` et `miseEnService`. Essai T-FLO-20.
+- `vehiculeDe(conducteur)` : l'affectation en cours d'un conducteur. Essai T-FLO-21.
+- `pleins(v)` : la liste des pleins, par date (onglet « Pleins et relevés »). Essai T-FLO-22.
+Demandés par les planches A à F de Guerway (`GUERWAY/docs/L0/maquette-flotte/`, inventaire partie 9).
+### Fixed
+- Le manifeste de `register` annonçait la version 0.2.0 dans la 0.3.0 publiée ; il suit désormais la version.
+
+## [0.3.0] — 2026-10-24
 ### Added
 - `vehicules({ statut?, type?, site?, q?, reformes? })` : la liste du parc, rangée par code ; `statut` est un code
   ou une liste ; `q` est cherché dans le code, la plaque, la marque et le modèle, sans casse, espaces et tirets
   indifférents ; les réformés n'y sont que sur demande. Demandé par le tableau de bord ECR-16 de Guerway, que
   `@mostajs/flotte-ui` construit sans accéder aux dépôts. Essai T-FLO-17.
 
-## [0.2.0] — non publiée
+## [0.2.0] — jamais publiée seule (contenue dans la 0.3.0)
 ### Added
 - `prochainsEntretiens(v, { date? })` et `prochainEntretien(v)` : pour chaque plan, l'échéance de chaque pas (km,
   jours) et la date du premier atteint, rangés du plus urgent au moins urgent. Un pas en km devient une date au rythme

package/llms.txt

@@ -25,16 +25,20 @@ EXPORTS
 API (async ; ctx = { agent })
   inscrire({ code, immatriculation, type, attributs, marque?, site?, mode? }, ctx) ; lire(id)
   vehicules({ statut?, type?, site?, q?, reformes? })  (0.3.0) -> copies rangées par code ; réformés exclus sauf demande
+  modifier(id, { immatriculation?, marque?, attributs?, site?, mode?, chassis?, miseEnService?, … }, ctx)  (0.4.0) jamais code/type/statut ;
+    historique += { le, agent, modification: { champs } } (une entrée SANS `vers` : ce n'est pas un changement de statut)
+  vehiculeDe(conducteur) (0.4.0) -> affectation en cours ou null
   changerStatut(id, 'immobiliser'|'atelier'|'remettre'|'reformer', { agent, motif })   motif requis : immobiliser, reformer
-  poserEcheance({ vehicule, type, debut, fin?, cout?, piece? }, ctx)   fin absente = debut + periodiciteJours
+  poserEcheance({ vehicule, type, debut, fin?, cout?, piece?, reference?, organisme? }, ctx)   fin absente = debut + periodiciteJours ;
+    piece : chaîne ou { nom, empreinte, deposePar, deposeLe } (0.4.0)
   echeances(v) ; aEcheance({ dans?, date? }) -> [{ id, vehicule, type, fin, n, expiree }]
   planifierEntretien({ vehicule, libelle, tousLesKm?, tousLesJours?, toleranceKm?, toleranceJours? }, ctx) ; plans(v) ; entretiensDus({ date? })
   prochainsEntretiens(v, { date? }) / prochainEntretien(v)  (0.2.0) -> { plan, libelle, etat, km: { echeance, restant },
     jours: { echeance, restant }, le, dans, estime }  le pas en km devient une date au rythme relevé (estime: true)
   ouvrirIntervention({ vehicule, nature, plan?, description?, ouverteLe? }, ctx)   corrective => a_l_atelier
   cloreIntervention(id, { km?, cout?, le? }, ctx)   recale le plan ; km => relevé ; close => immuable
-  relever(v, { km, le?, source?, correction?: { motif, agent } }, ctx) -> relevé + avertissements (SAUT_ANORMAL)
-  saisirPlein({ vehicule, le, litres, montant, km, complet }, ctx)   vaut relevé ; consommation(v)
+  relever(v, { km, le?, source?, correction?: { motif, agent } }, ctx) -> relevé + avertissements (SAUT_ANORMAL), conservés sur le relevé (0.4.0)
+  saisirPlein({ vehicule, le, litres, montant, km, complet }, ctx)   vaut relevé ; pleins(v) (0.4.0) ; consommation(v)
   affecter(v, conducteur, ctx) ; liberer(v, ctx) ; affectations(v) ; affectationCourante(v)
   peutPartir(v, { date?, conducteur?, km? }) -> { ok, motifs[], avertissements[] }   TOUS les motifs, en OBJETS
   disponibles({ date?, type?, attributs? }) ; cout(v, { du, au }) -> { carburant, entretien, echeances, total, km, parKm, nonComptes }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/flotte",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Le carnet du parc : registre des véhicules par type déclaré, cycle d'état, échéances, entretien au kilométrage et à la date, relevés, pleins, affectations de conducteurs, coût au km, et la réponse « ce véhicule peut-il partir ? ».",
   "license": "AGPL-3.0-or-later",
   "author": "Dr Hamid MADANI <drmdh@msn.com>",
@@ -61,6 +61,7 @@
     "verbes": [
       "inscrire",
       "vehicules",
+      "modifier",
       "changerStatut",
       "peutPartir",
       "prochainEntretien",

package/src/flotte.js

@@ -20,6 +20,10 @@ const exigerNombre = (n, quoi, { min = 0, strict = false } = {}) => {
   if (!Number.isFinite(n) || (strict ? n <= min : n < min)) refus('DONNEE', `${quoi} : nombre ${strict ? '>' : '≥'} ${min} attendu`, 400);
   return n;
 };
+/** Un texte facultatif : absent → null, chaîne → nettoyée, autre chose → refus. */
+const texteOuNul = (x, quoi) => { if (x === undefined || x === null || x === '') return null; if (typeof x !== 'string') refus('DONNEE', `${quoi} : texte attendu`, 400); return x.trim() || null; };
+/** Les champs descriptifs d'un véhicule, modifiables par `modifier` (ni le code, ni le type, ni le statut). */
+const MODIFIABLES = ['immatriculation', 'marque', 'modele', 'annee', 'couleur', 'energie', 'attributs', 'site', 'detenteur', 'mode', 'acquisition', 'chassis', 'miseEnService'];
 const correspond = (motif, valeur) => new RegExp(motif.source, motif.flags.replace(/[gy]/g, '')).test(valeur);
 
 /**
@@ -50,6 +54,12 @@ export function createFlotte({
   const maj = async (table, doc, champs) => { await P[table].update(doc.id, champs); return { ...doc, ...structuredClone(champs) }; };
   const de = (table, vehicule) => P[table].find((x) => x.vehicule === vehicule);
 
+  function plaqueValide(saisie) {
+    const p = String(saisie).trim().toUpperCase();
+    if (D.immatriculation.length && !D.immatriculation.some((m) => correspond(m, p))) refus('IMMATRICULATION', `immatriculation hors des motifs déclarés : ${p}`, 400);
+    return p;
+  }
+
   async function lire(id) {
     return (await P.vehicules.find((v) => v.id === id))[0] || refus('INCONNU', `véhicule inconnu : ${id}`, 404);
   }
@@ -79,7 +89,7 @@ export function createFlotte({
     return [];
   }
   async function ecrireReleve(vehicule, { km, le, source, correction }, avertissements, agent) {
-    const r = await creer('releves', { id: randomUUID(), vehicule, km, le, source, correction: correction ? { motif: correction.motif, agent: correction.agent } : null, saisiPar: agent ?? null });
+    const r = await creer('releves', { id: randomUUID(), vehicule, km, le, source, correction: correction ? { motif: correction.motif, agent: correction.agent } : null, saisiPar: agent ?? null, avertissements });
     emettre('releve.saisi', { vehicule, releve: r.id, km, source });
     return { ...r, avertissements };
   }
@@ -137,10 +147,8 @@ export function createFlotte({
       if (!texte(d.immatriculation)) refus('DONNEE', 'immatriculation requise', 400);
       if (!texte(d.type)) refus('DONNEE', 'type requis', 400);
       const attributs = validerAttributs(D, d.type, d.attributs);
-      const code = d.code.trim(), immatriculation = d.immatriculation.trim().toUpperCase();
-      if (D.immatriculation.length && !D.immatriculation.some((m) => correspond(m, immatriculation))) {
-        refus('IMMATRICULATION', `immatriculation hors des motifs déclarés : ${immatriculation}`, 400);
-      }
+      const code = d.code.trim(), immatriculation = plaqueValide(d.immatriculation);
+      const miseEnService = d.miseEnService === undefined || d.miseEnService === null ? null : exigerJour(d.miseEnService, 'miseEnService');
       const mode = d.mode ?? 'propre';
       if (!CODES.mode.includes(mode)) refus('DONNEE', `mode inconnu : ${mode}`, 400);
       if ((await P.vehicules.find((v) => v.code === code || v.immatriculation === immatriculation)).length) {
@@ -149,7 +157,7 @@ export function createFlotte({
       const v = await creer('vehicules', {
         id: randomUUID(), code, immatriculation, type: d.type, marque: d.marque ?? null, modele: d.modele ?? null, annee: d.annee ?? null,
         couleur: d.couleur ?? null, energie: d.energie ?? null, attributs, site: d.site ?? null, detenteur: d.detenteur ?? null, mode,
-        acquisition: d.acquisition ?? null, statut: cycle.initial, historique: [], inscritLe: aujourdhui(), inscritPar: agent ?? null,
+        acquisition: d.acquisition ?? null, chassis: texteOuNul(d.chassis, 'chassis'), miseEnService, statut: cycle.initial, historique: [], inscritLe: aujourdhui(), inscritPar: agent ?? null,
       });
       emettre('vehicule.inscrit', { vehicule: v.id, code, type: v.type });
       return v;
@@ -174,15 +182,42 @@ export function createFlotte({
     /** Passer une transition du cycle : immobiliser, atelier, remettre, reformer. */
     async changerStatut(id, transition, ctx = {}) { return transiter(await lire(id), transition, ctx); },
 
+    /**
+     * Modifier les champs DESCRIPTIFS d'un véhicule (MODIFIABLES) ; ni le code, ni le type, ni le statut (→ changerStatut).
+     * La plaque reste contrôlée (motif, unicité), les attributs par le type. La modification est inscrite à
+     * l'historique : { le, agent, modification: { champs } }. Un véhicule réformé ne se modifie plus.
+     */
+    async modifier(id, champs = {}, { agent } = {}) {
+      const v = await lire(id);
+      const cles = Object.keys(champs);
+      const interdites = cles.filter((k) => !MODIFIABLES.includes(k));
+      if (interdites.length) refus('DONNEE', `champ non modifiable : ${interdites.join(', ')}`, 400);
+      if (v.statut === 'reforme') refus('TRANSITION', 'un véhicule réformé ne se modifie plus', 422);
+      const m = { ...champs };
+      if ('immatriculation' in m) {
+        m.immatriculation = plaqueValide(m.immatriculation);
+        if ((await P.vehicules.find((x) => x.id !== id && x.immatriculation === m.immatriculation)).length) refus('DOUBLON', `immatriculation déjà prise : ${m.immatriculation}`, 409);
+      }
+      if ('attributs' in m) m.attributs = validerAttributs(D, v.type, { ...v.attributs, ...m.attributs });
+      if ('mode' in m && !CODES.mode.includes(m.mode)) refus('DONNEE', `mode inconnu : ${m.mode}`, 400);
+      if ('miseEnService' in m && m.miseEnService !== null) exigerJour(m.miseEnService, 'miseEnService');
+      if ('chassis' in m) m.chassis = texteOuNul(m.chassis, 'chassis');
+      if (!cles.length) return v;
+      const r = await maj('vehicules', v, { ...m, historique: [...v.historique, { le: aujourdhui(), agent: agent ?? null, modification: { champs: cles } }] });
+      emettre('vehicule.modifie', { vehicule: id, champs: cles });
+      return r;
+    },
+
     // ── Échéances ──
-    async poserEcheance({ vehicule, type, debut, fin, piece, cout } = {}, { agent } = {}) {
+    async poserEcheance({ vehicule, type, debut, fin, piece, cout, reference, organisme } = {}, { agent } = {}) {
       await lire(vehicule);
       const d = D.echeances[type] || refus('TYPE', `type d'échéance non déclaré : ${type}`, 400);
       exigerJour(debut, 'debut');
       const f = fin === undefined ? R.ajouterJours(debut, d.periodiciteJours) : exigerJour(fin, 'fin');
       if (f <= debut) refus('DONNEE', 'la fin doit suivre le début', 400);
       if (cout !== undefined) exigerNombre(cout, 'cout');
-      const e = await creer('echeances', { id: randomUUID(), vehicule, type, debut, fin: f, piece: piece ?? null, cout: cout ?? null, poseePar: agent ?? null, poseeLe: aujourdhui() });
+      const ref = texteOuNul(reference, 'reference'), org = texteOuNul(organisme, 'organisme');
+      const e = await creer('echeances', { id: randomUUID(), vehicule, type, debut, fin: f, reference: ref, organisme: org, piece: piece ?? null, cout: cout ?? null, poseePar: agent ?? null, poseeLe: aujourdhui() });
       emettre('echeance.posee', { vehicule, echeance: e.id, type, fin: f });
       return e;
     },
@@ -298,6 +333,8 @@ export function createFlotte({
       const r = await ecrireReleve(vehicule, { km, le: jour, source: 'plein' }, avert, agent);
       return { ...p, avertissements: r.avertissements };
     },
+    /** Les pleins d'un véhicule, par date. */
+    async pleins(vehicule) { await lire(vehicule); return (await de('pleins', vehicule)).sort((a, b) => (a.le < b.le ? -1 : a.le > b.le ? 1 : 0)); },
     async consommation(vehicule) { await lire(vehicule); return R.consommation(await de('pleins', vehicule)); },
 
     // ── Affectations ──
@@ -330,6 +367,8 @@ export function createFlotte({
     },
     async affectations(vehicule) { await lire(vehicule); return (await de('affectations', vehicule)).sort((a, b) => (a.du < b.du ? -1 : a.du > b.du ? 1 : 0)); },
     async affectationCourante(vehicule) { await lire(vehicule); return courante(vehicule); },
+    /** L'affectation en cours d'un conducteur (le véhicule qu'il tient), ou null. */
+    async vehiculeDe(conducteur) { return (await P.affectations.find((a) => a.conducteur === conducteur && !a.au))[0] || null; },
 
     // ── Décisions ──
     peutPartir,

package/src/schemas.js

@@ -4,10 +4,10 @@ const T = { type: 'string' }, TR = { type: 'string', required: true }, N = { typ
 
 export const VehiculeSchema = s('Vehicule', 'flotte_vehicules', {
   code: { ...TR, unique: true }, immatriculation: { ...TR, unique: true }, type: TR, marque: T, modele: T, annee: N, couleur: T, energie: T,
-  attributs: J, site: T, detenteur: T, mode: TR, acquisition: J, statut: TR, historique: J, inscritLe: T, inscritPar: T,
+  attributs: J, site: T, detenteur: T, mode: TR, acquisition: J, chassis: T, miseEnService: T, statut: TR, historique: J, inscritLe: T, inscritPar: T,
 }, [{ fields: { code: 'asc' }, unique: true }, { fields: { immatriculation: 'asc' }, unique: true }, { fields: { statut: 'asc', type: 'asc' } }]);
 export const EcheanceSchema = s('Echeance', 'flotte_echeances', {
-  vehicule: TR, type: TR, debut: TR, fin: TR, piece: T, cout: N, poseePar: T, poseeLe: T,
+  vehicule: TR, type: TR, debut: TR, fin: TR, reference: T, organisme: T, piece: J, cout: N, poseePar: T, poseeLe: T,
 }, [{ fields: { vehicule: 'asc', type: 'asc' } }, { fields: { fin: 'asc' } }]);
 export const PlanEntretienSchema = s('PlanEntretien', 'flotte_plans', {
   vehicule: TR, libelle: TR, tousLesKm: N, tousLesJours: N, toleranceKm: N, toleranceJours: N, dernierKm: N, dernierLe: T, creePar: T,
@@ -17,7 +17,7 @@ export const InterventionSchema = s('Intervention', 'flotte_interventions', {
   ouvertePar: T, closePar: T, modifieePar: T,
 }, [{ fields: { numero: 'asc' }, unique: true }, { fields: { vehicule: 'asc', closeLe: 'asc' } }]);
 export const ReleveCompteurSchema = s('ReleveCompteur', 'flotte_releves', {
-  vehicule: TR, km: NR, le: TR, source: TR, correction: J, saisiPar: T,
+  vehicule: TR, km: NR, le: TR, source: TR, correction: J, saisiPar: T, avertissements: J,
 }, [{ fields: { vehicule: 'asc', le: 'asc' } }]);
 export const PleinSchema = s('Plein', 'flotte_pleins', {
   vehicule: TR, le: TR, litres: NR, montant: NR, km: NR, complet: B, carte: T, saisiPar: T,
@@ -30,7 +30,7 @@ export const SCHEMAS = Object.freeze([VehiculeSchema, EcheanceSchema, PlanEntret
 
 export function register(registry) {
   registry.register({
-    manifest: { name: 'flotte', package: '@mostajs/flotte', version: '0.2.0', type: 'business', priority: 45, displayName: 'Flotte (carnet du parc)',
+    manifest: { name: 'flotte', package: '@mostajs/flotte', version: '0.4.0', type: 'business', priority: 45, displayName: 'Flotte (carnet du parc)',
       description: 'Registre des véhicules, cycle, échéances, entretien, relevés, pleins, affectations, coût au km, peutPartir.', register: './src/schemas.js' },
     schemas: SCHEMAS.map((x) => ({ name: x.name, schema: x })),
   });