@mostajs/flotte 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -3,14 +3,37 @@
 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.5.0] — non publiée
+### Added
+- `TRANSITIONS` (figées, sans la garde) et `transitionsDepuis(statut)` → `[{ id, vers, motif }]` : l'écran n'offre
+  que les changements permis depuis le statut courant et sait lesquels exigent un motif, sans recopier le cycle.
+  Demandé par le menu « Changer le statut » de la fiche (planches B et C, ECR-16.31 et 16.36), que
+  `@mostajs/flotte-ui` 0.2.0 rend. Essai T-FLO-23.
+- `saisirPlein` garde `piece` (photo du ticket : `{ nom, empreinte, deposePar, deposeLe }`, colonne JSON), comme
+  une échéance. Demandé par « Saisir un plein » de la planche D (ECR-16.40). Essai T-FLO-24.
+
+## [0.4.0] — 2026-10-24
+### 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

@@ -20,21 +20,26 @@ EXPORTS
   ErreurFlotte { code, statut } (400 donnée, 404 inconnu, 409 doublon/recul/close/ouverte/occupé, 422 transition)
   CODES, LIBELLES, libelle(famille, code, t?, vars?) ; STATUTS, MOTIFS ; PERMISSIONS (flotte:domaine:action)
   regles (pur) : etatEntretien, prochainEntretien, kmParJour, consommation, evaluerDepart, cout, echeanceCourante, jours, ajouterJours
+  TRANSITIONS (0.5.0) figées [{ id, from, vers, motif }] ; transitionsDepuis(statut) -> [{ id, vers, motif }] (menu « Changer le statut »)
   register (7 tables ; aussi './register'), SCHEMAS, validerDeclarations
 
 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, piece? (0.5.0) }, 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.5.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/cycle.js

@@ -10,6 +10,15 @@ export const TRANSITIONS = Object.freeze([
   { id: 'reformer', from: ['en_service', 'immobilise', 'a_l_atelier'], to: 'reforme', motif: true },
 ]);
 
+/**
+ * Les transitions telles que l'écran les lit (0.5.0) : figées, sans la garde, qui reste dans le moteur. L'écran
+ * n'offre ainsi que les changements permis depuis un statut, et sait lesquels exigent un motif.
+ */
+export const TRANSITIONS_PUBLIQUES = Object.freeze(TRANSITIONS.map(({ id, from, to, motif }) => Object.freeze({ id, from: Object.freeze([...from]), vers: to, motif })));
+
+/** Les transitions permises depuis `statut`, dans l'ordre du cycle : [{ id, vers, motif }] ; [] pour un état final. */
+export const transitionsDepuis = (statut) => TRANSITIONS_PUBLIQUES.filter((t) => t.from.includes(statut)).map(({ id, vers, motif }) => ({ id, vers, motif }));
+
 /**
  * La machine d'une instance. `audit` (AuditSink de statemachine) est celui de l'application quand elle en
  * fournit un ; sinon la machine garde son journal en mémoire.

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;
     },
@@ -288,16 +323,18 @@ export function createFlotte({
       return ecrireReleve(vehicule, { km, le: jour, source, correction }, avert, agent);
     },
     async releves(vehicule) { await lire(vehicule); return releves(vehicule); },
-    async saisirPlein({ vehicule, le, litres, montant, km, complet = false, carte } = {}, { agent } = {}) {
+    async saisirPlein({ vehicule, le, litres, montant, km, complet = false, carte, piece } = {}, { agent } = {}) {
       await lire(vehicule);
       const jour = le ?? aujourdhui();
       exigerNombre(litres, 'litres', { strict: true }); exigerNombre(montant, 'montant');
       const avert = await verifierReleve(vehicule, { km, le: jour });
-      const p = await creer('pleins', { id: randomUUID(), vehicule, le: jour, litres, montant, km, complet: Boolean(complet), carte: carte ?? null, saisiPar: agent ?? null });
+      const p = await creer('pleins', { id: randomUUID(), vehicule, le: jour, litres, montant, km, complet: Boolean(complet), carte: carte ?? null, piece: piece ?? null, saisiPar: agent ?? null });
       emettre('plein.saisi', { vehicule, plein: p.id, litres, montant });
       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/index.js

@@ -6,6 +6,7 @@ export { CODES, LIBELLES, libelle } from './libelles.js';
 export { register, SCHEMAS } from './schemas.js';
 export { validerDeclarations, FORMES } from './declarations.js';
 export * as regles from './regles.js';
+export { TRANSITIONS_PUBLIQUES as TRANSITIONS, transitionsDepuis } from './cycle.js';
 export const STATUTS = CODES.statut;
 export const MOTIFS = CODES.motif;
 /** Les permissions, au format domaine:action (§10 #5) : le module les nomme, rbac-tenant les vérifie. */

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,10 +17,10 @@ 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,
+  vehicule: TR, le: TR, litres: NR, montant: NR, km: NR, complet: B, carte: T, piece: J, saisiPar: T,
 }, [{ fields: { vehicule: 'asc', le: 'asc' } }]);
 export const AffectationSchema = s('Affectation', 'flotte_affectations', {
   vehicule: TR, conducteur: TR, du: TR, au: T, parAgent: T, closePar: 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.5.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 })),
   });