Assets & Maintenance

Périmètre : cycle de vie des équipements de la grande distribution alimentaire (réfrigérateurs, vitrines, chambres froides, fours, climatisation…) — entrée en stock, installation client, maintenance préventive/curative, pièces détachées, transport, reconditionnement, revente/recyclage. Inclut le référentiel marques/modèles/familles, les dépôts, le SAV public via QR code et la facturation de stockage par prestataire.

Vocabulaire & entités

Le schéma complet est dans docs/04-data-model.md §6.

Écrans

Modèle de données (points clés)

• Asset.currentLocationId : référence vers le StorageLocation courant — mis à jour atomiquement à chaque mouvement.
• AssetMovement : journal daté de tout déplacement (fromLocationId/toLocationId, movedAt, reason), porte aussi transportKm et transportCarbonKg (empreinte transport, Lot D).
• Asset.serviceShortCode : code court unique (collision check), porté directement sur l'asset, sert de jeton public. Partagé avec ServiceLink.code lors de l'association.
• États physiques AssetCondition (NEW, EXCELLENT, GOOD, NEEDS_REPAIR, NON_FUNCTIONAL_PARTS, LOST, RECYCLED, REFURBISHED, SOLD, TO_DEFINE) et fonctionnels AssetFunctional (FUNCTIONAL, NON_FUNCTIONAL, NOT_TESTED) : deux enums indépendants.
• Asset.carbonFootprintKg (empreinte carbone cumulée) et Asset.aiFailureScore (+aiFailureScoreAt) : score de panne prédit par l'IA (Lot D Phase 6).
• MaintenanceOperation.slaDueAt : calculé à la création selon la priorité du contrat (J+4h critique, J+24h normal, J+5j basse).
• SparePartInstance : décrémentée du stock à la complétion de l'OT (pas à l'ajout de la ligne pièce). États SparePartState : NEW, GOOD, USED, DEFECTIVE.
• MTBF/MTTR : agrégats de fiabilité (refreshReliabilityViews()), rafraîchis via POST /maintenance/reliability-refresh (à brancher sur un job nocturne).
• StorageMovementRequest (PENDING → CONFIRMED → VERIFIED) : gère le workflow WARM'UP ; génère atomiquement les AssetMovement à la vérification.

API

Permissions de base : assets.catalog:{read,manage} (marques, modèles, familles, pièces, settings), assets.asset:{read,manage} (assets, mouvements, transport, transporteurs), maintenance.operation:{read,manage} (OT, signatures, pièces, fiabilité). Les tarifs de stockage utilisent storage.config:{read,manage}.

Assets — CRUD & cycle de vie

Assets — énergie, carbone & prédiction IA (Lot D)

Assets — actions de masse

Impression d'étiquettes (async)

Catalogue (marques, modèles, familles, pièces, stockages)

Maintenance — OT & fiabilité

Transport & transporteurs

SAV public (sans session)

Exemple de référence d'endpoint :

{
  "submitted": true
}

Workflows

Cycle de vie d'un asset

ACQUISITION (état NEW, localisation dépôt)
     │
  EN STOCK
     │  affectation contrat LLD / vente
     │
CHEZ LE CLIENT
   ├──→ MAINTENANCE (OT)  ──→ retour dépôt
   └──→ DEFAILLANT        ──→ RETOUR SAV
                                  │
                        RECONDITIONNEMENT
                         ├──→ REVENTE
                         └──→ RECYCLAGE

À chaque transition : audit log, AssetMovement créé, Asset.currentLocationId mis à jour, AssetLifecycleEvent consigné pour les décisions de reconditionnement, notifications éventuelles.

OT préventif & maintenance contractuelle

• Les OT préventifs (MaintenanceType: PREVENTIVE) sont créés depuis le planning / la fiche asset, puis affectés à un technicien.
• La facturation de la maintenance contractuelle est gérée par l'échéancier de maintenance du contrat (LeaseMaintenance) : le cron Nitro lease:maintenance-billing facture quotidiennement les échéances dues (horizon J+15, Lot L2 Phase 6). Voir le domaine Location.

OT curatif

1. Client via QR → POST /api/public/asset/[shortCode]/report → OT PLANNED CURATIVE.
2. Portail client /client/maintenance/new → idem.
3. Interne → création depuis fiche asset.
4. Notification responsable SAV → affectation technicien.
5. Technicien : PATCH vers IN_PROGRESS à l'arrivée, diagnostic + résolution + pièces + photos + signature client, puis PATCH status: "DONE".
6. Rapport PDF généré, envoyé au client, archivé.
7. Si coût OT > seuil configuré par org → devis exigé avant intervention.

SLA & escalade

• slaDueAt calculé à la création selon priorité contractuelle (J+4h / J+24h / J+5j).
• J−1 du SLA sans IN_PROGRESS → notification urgence responsable SAV.
• Dépassement SLA → escalade direction + email d'excuse client.

Mouvement / transfert

• Localisation CUSTOMER_ESTABLISHMENT : exige un Establishment lié à un LeaseContract actif (sinon warning).
• Transfert inter-dépôts → enregistre un AssetMovement (fromLocationId/toLocationId) et met à jour Asset.currentLocationId.
• L'historique des emplacements se lit via AssetMovement (route GET /assets/[id]/movements).

QR code / Lien de service

• Un ServiceLink peut être pré-imprimé et affecté à un détenteur (statut IN_STOCK → ASSIGNED), puis associé à un asset (LINKED) ; son code est alors partagé avec Asset.serviceShortCode (collision check).
• POST /assets/[id]/service-link génère (si besoin) et renvoie le code de service de l'équipement.
• Chaque consultation publique trace un ServiceLinkScan (source = PUBLIC).
• Étiquette PDF générée à la demande via GET /assets/[id]/label ; impression en masse via les tâches d'impression async (/assets/printing-tasks).

Reconditionnement

• Retour dépôt fin de contrat → OT INSPECTION.
• Décision : REFURBISHED (ré-allouable) · RECYCLED (bordereau DEEE) · SOLD (sortie stock).

Règles métier

• N° inventaire unique par organisation. N° série unique par org s'il est renseigné.
• LOST / RECYCLED → asset non sélectionnable pour de nouveaux contrats.
• SOLD → asset en lecture seule (non modifiable).
• Les assets sont en soft-delete (Asset.deletedAt) ; pas de route de suppression exposée — on archive plutôt qu'on supprime.
• OT IN_PROGRESS → transition autorisée vers DONE ou CANCELED uniquement (transitions verrouillées côté service).
• Pièces décrémentées à la complétion de l'OT, pas à l'ajout de la ligne pièce.
• Agrégats MTBF/MTTR par modèle rafraîchis via POST /maintenance/reliability-refresh (à brancher sur un job nocturne).
• Workflow WARM'UP : StorageMovementRequest PENDING → CONFIRMED → VERIFIED ; génération atomique des AssetMovement à la vérification.

KPIs

Nombre d'assets par état · taux d'occupation par dépôt · MTBF/MTTR par modèle et par famille · taux de respect SLA SAV (% OT clos dans SLA) · coût moyen d'intervention par modèle · top 10 modèles les plus problématiques · volume mouvements par mois.

Notifications