@mostajs/flotte 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -3,7 +3,21 @@
 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.1.0] — non publiée
+## [0.3.0] — non publiée
+### 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
+### 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
+  relevé (`estime: true`). Demandé par l'écran ECR-16 de Guerway (« Prochain entretien : date, dans N jours »).
+- Règles pures `regles.prochainEntretien` et `regles.kmParJour` (rythme sur les 90 derniers jours). Essai T-FLO-16.
+
+## [0.1.0] — 2026-10-24
 ### Added
 - `createFlotte` : registre par types déclarés, cycle en service / immobilisé / à l'atelier / réformé
   (`@mostajs/statemachine`), échéances typées, plans d'entretien au km et à la date, interventions numérotées,

package/README.md

@@ -5,10 +5,12 @@
 Le carnet du parc. Il répond à une question : **ce véhicule peut-il partir aujourd'hui, avec ce conducteur, et
 combien coûte-t-il ?**
 
-- un registre de véhicules, chacun d'un **type déclaré** par l'application (fourgon, moto, autocar…) ;
+- un registre de véhicules, chacun d'un **type déclaré** par l'application (fourgon, moto, autocar…), et sa liste
+  filtrée par statut, type, site ou texte ;
 - un cycle : en service, immobilisé, à l'atelier, réformé ; chaque passage est tracé, avec son motif ;
 - des échéances (assurance, contrôle technique…) ; la plus récente fait foi, les anciennes restent lisibles ;
-- l'entretien au kilométrage **et** à la date, dû au premier des deux atteint, avec une tolérance ;
+- l'entretien au kilométrage **et** à la date, dû au premier des deux atteint, avec une tolérance ; le prochain
+  entretien est daté, et un pas en km devient une date au rythme relevé ;
 - des relevés de compteur : un recul est refusé, sauf correction motivée ; un saut anormal est signalé ;
 - des pleins, et la consommation mesurée entre deux pleins complets ;
 - des affectations de conducteurs (identifiant opaque) ;
@@ -47,7 +49,7 @@ alertes (`notifications`), fichiers scannés (`blob-store`). `peutPartir` dit **
 ## Vérifier
 
 ```bash
-npm test                    # T-FLO-1 à 15 (@mostajs/mjs-unit)
+npm test                    # T-FLO-1 à 16 (@mostajs/mjs-unit)
 node examples/verifier.mjs  # un fourgon, de l'inscription au coût au km
 ```
 

package/llms.txt

@@ -19,15 +19,18 @@ EXPORTS
   createMemoryRepositories()   7 dépôts : vehicules, echeances, plans, interventions, releves, pleins, affectations
   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, consommation, evaluerDepart, cout, echeanceCourante, jours, ajouterJours
+  regles (pur) : etatEntretien, prochainEntretien, kmParJour, consommation, evaluerDepart, cout, echeanceCourante, jours, ajouterJours
   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
   changerStatut(id, 'immobiliser'|'atelier'|'remettre'|'reformer', { agent, motif })   motif requis : immobiliser, reformer
   poserEcheance({ vehicule, type, debut, fin?, cout?, piece? }, ctx)   fin absente = debut + periodiciteJours
   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)
@@ -46,5 +49,5 @@ PIÈGES
   - L'entité de relevé s'appelle ReleveCompteur (Releve appartient à @mostajs/recette).
   - L'échéance qui fait foi est la plus récente par début ; les anciennes restent lisibles.
 
-ESSAIS  test-scripts/unit/flotte.test.mjs — T-FLO-1 à 15 ; exemple : node examples/verifier.mjs
+ESSAIS  test-scripts/unit/flotte.test.mjs — T-FLO-1 à 16 ; exemple : node examples/verifier.mjs
 LICENCE AGPL-3.0-or-later · Auteur Dr Hamid MADANI <drmdh@msn.com>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mostajs/flotte",
-  "version": "0.1.0",
+  "version": "0.3.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>",
@@ -60,8 +60,10 @@
     ],
     "verbes": [
       "inscrire",
+      "vehicules",
       "changerStatut",
       "peutPartir",
+      "prochainEntretien",
       "aEcheance",
       "entretiensDus",
       "saisirPlein",

package/src/flotte.js

@@ -102,6 +102,16 @@ export function createFlotte({
     return r;
   }
 
+  /** Les prochains entretiens d'un véhicule, du plus urgent au moins urgent (sans date : en dernier). */
+  async function prochainsEntretiens(vehicule, { date } = {}) {
+    await lire(vehicule);
+    const jour = date ? exigerJour(date, 'date') : aujourdhui();
+    const tous = await releves(vehicule);
+    const km = R.dernierReleve(tous, jour)?.km, rythme = R.kmParJour(tous, jour);
+    return (await de('plans', vehicule)).map((p) => R.prochainEntretien(p, { km, date: jour, kmParJour: rythme }))
+      .sort((a, b) => (a.le === b.le ? 0 : a.le === null ? 1 : b.le === null ? -1 : a.le < b.le ? -1 : 1));
+  }
+
   async function peutPartir(id, { date, conducteur, km } = {}) {
     const v = await lire(id);
     const jour = date ? exigerJour(date, 'date') : aujourdhui();
@@ -145,6 +155,22 @@ export function createFlotte({
       return v;
     },
 
+    /**
+     * La liste du parc, rangée par code : `statut` (un code ou une liste), `type`, `site`, et `q` cherché dans le code,
+     * la plaque, la marque et le modèle (sans casse ; espaces et tirets indifférents). Sans `statut`, les réformés
+     * n'y sont que si `reformes` est vrai.
+     */
+    async vehicules({ statut, type, site, q, reformes = false } = {}) {
+      const statuts = statut === undefined ? null : [statut].flat();
+      for (const s of statuts || []) if (!CODES.statut.includes(s)) refus('DONNEE', `statut inconnu : ${s}`, 400);
+      const plat = (s) => String(s ?? '').toLowerCase().replace(/[\s-]+/g, '');
+      const cherche = texte(q) ? plat(q) : null;
+      return (await P.vehicules.find((v) => (statuts ? statuts.includes(v.statut) : reformes || v.statut !== 'reforme')
+        && (!type || v.type === type) && (!site || v.site === site)
+        && (!cherche || [v.code, v.immatriculation, v.marque, v.modele].some((c) => plat(c).includes(cherche)))))
+        .sort((a, b) => (a.code < b.code ? -1 : a.code > b.code ? 1 : 0)).map((v) => structuredClone(v));
+    },
+
     /** Passer une transition du cycle : immobiliser, atelier, remettre, reformer. */
     async changerStatut(id, transition, ctx = {}) { return transiter(await lire(id), transition, ctx); },
 
@@ -191,6 +217,9 @@ export function createFlotte({
       return p;
     },
     async plans(vehicule) { await lire(vehicule); return de('plans', vehicule); },
+    prochainsEntretiens,
+    /** Le plus urgent des prochains entretiens, ou null sans plan (ECR-16.17 : « Prochain entretien »). */
+    async prochainEntretien(vehicule, opts = {}) { return (await prochainsEntretiens(vehicule, opts))[0] || null; },
     /** Les plans dus ou dépassés à `date`, sur les véhicules non réformés. */
     async entretiensDus({ date } = {}) {
       const jour = date ? exigerJour(date, 'date') : aujourdhui();

package/src/regles.js

@@ -40,6 +40,34 @@ export function etatEntretien(plan, { km, date }) {
   return { etat: pire.etat, unite: pire.unite, n: pire.n };
 }
 
+/**
+ * Le rythme du véhicule, en km par jour, mesuré sur les relevés des `fenetre` derniers jours avant `date`.
+ * Null sans deux relevés de dates différentes, ou si le compteur n'a pas avancé.
+ */
+export function kmParJour(releves, date, fenetre = 90) {
+  const debut = ajouterJours(date, -fenetre);
+  const dans = [...releves].sort(parDate).filter((r) => r.le >= debut && r.le <= date);
+  if (dans.length < 2) return null;
+  const a = dans[0], b = dans.at(-1), j = jours(a.le, b.le);
+  return j > 0 && b.km > a.km ? arrondi((b.km - a.km) / j) : null;
+}
+
+/**
+ * Le PROCHAIN entretien d'un plan : l'échéance de chaque pas (km, jours), et la date du premier atteint. Un pas en
+ * km devient une date au rythme relevé (`kmParJour`) : la date est alors ESTIMÉE. Sans rythme, un plan au km seul
+ * n'a pas de date (`le: null`), seulement ses km restants. `dans` est négatif quand l'échéance est passée.
+ */
+export function prochainEntretien(plan, { km, date, kmParJour: rythme = null }) {
+  const etat = etatEntretien(plan, { km, date });
+  const parKm = plan.tousLesKm > 0 && Number.isFinite(km)
+    ? { echeance: (plan.dernierKm || 0) + plan.tousLesKm, restant: (plan.dernierKm || 0) + plan.tousLesKm - km } : null;
+  const parJours = plan.tousLesJours > 0 && plan.dernierLe
+    ? { echeance: ajouterJours(plan.dernierLe, plan.tousLesJours), restant: jours(date, ajouterJours(plan.dernierLe, plan.tousLesJours)) } : null;
+  const leKm = parKm && rythme > 0 ? ajouterJours(date, Math.ceil(parKm.restant / rythme)) : null;
+  const le = [leKm, parJours?.echeance].filter(Boolean).sort()[0] || null;
+  return { plan: plan.id, libelle: plan.libelle, ...etat, km: parKm, jours: parJours, le, dans: le ? jours(date, le) : null, estime: Boolean(le && le === leKm && le !== parJours?.echeance) };
+}
+
 /** L'échéance qui fait foi pour un type : la plus récente par début (à début égal, la dernière posée). */
 export function echeanceCourante(echeances, type) {
   return echeances.filter((e) => e.type === type).sort((a, b) => (a.debut < b.debut ? -1 : a.debut > b.debut ? 1 : 0)).at(-1) || null;

package/src/schemas.js

@@ -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.1.0', type: 'business', priority: 45, displayName: 'Flotte (carnet du parc)',
+    manifest: { name: 'flotte', package: '@mostajs/flotte', version: '0.2.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 })),
   });