@mostajs/flotte 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -3,7 +3,16 @@
 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.4.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.

package/llms.txt

@@ -20,6 +20,7 @@ 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 })
@@ -38,7 +39,7 @@ API (async ; ctx = { agent })
   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), 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)
+  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.4.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>",

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

@@ -323,12 +323,12 @@ 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 };

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

@@ -20,7 +20,7 @@ export const ReleveCompteurSchema = s('ReleveCompteur', 'flotte_releves', {
   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.4.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 })),
   });