feat(r2.1): socle backend exploitation — machine à états, bilan codé, demandes 1-1

- migration r2_exploitation (10 tables) : WorkOrder (référence séquentielle,
  horodatages), WorkOrderEvent, Request (1-1, motif de rejet), ReferenceValue,
  InterventionReport (6 FK), TaskTemplate/ChecklistItem, Meter/MeterReading
- contrat : 15 opérations (41 total) ; la table des transitions et les champs
  requis du bilan vivent dans @siop/shared ; la fiche OT expose
  allowedTransitions + closureBlockers (messages métier)
- API : machine à états stricte ; garde de clôture (bilan 3 champs requis +
  checklist sans tâche en attente) ; approbation → OT lié 1-1 (409 si déjà
  traitée) ; rejet à motif obligatoire ; scoping « voir autre » sur listes et
  accès directs (404 sans fuite) ; validation des valeurs de bilan par champ ;
  « personne bloquée » triée en tête côté API
- seed : 31 valeurs de référentiels, 8 gabarits (parachute réglementaire),
  OT/demandes/compteurs de la maquette — idempotent
- 45 tests verts (95 % stmts / 79 % branches) dont la recette officielle
  rejouée de bout en bout ; smoke test sur build de prod

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

docs/03-architecture/modele-donnees.md

@@ -116,11 +116,78 @@ model Team {                  // équipes par zone — l'assignation d'OT (R2) s
 | Lien d'activation : 7 jours, usage unique, aucun compte actif avant | service users (+ test e2e) |
 | Position : lat/lng saisis, colonne PostGIS **générée** pour les requêtes spatiales futures | migration SQL |
 
+## R2 — Exploitation
+
+```prisma
+enum WorkOrderType     { CORRECTIVE PREVENTIVE WORKS }            // Dépannage / Maintenance / Travaux
+enum WorkOrderStatus   { OPEN IN_PROGRESS ON_HOLD DONE CANCELLED }
+enum WorkOrderPriority { NONE LOW MEDIUM HIGH PERSON_TRAPPED }    // personne bloquée = priorité, pas statut
+enum RequestStatus     { RECEIVED APPROVED REJECTED }             // « Résolue » = dérivé (OT lié DONE)
+enum ChecklistState    { PENDING DONE NA }
+enum BilanField        { DOOR_STATE CABIN_POSITION ANOMALY EXTERNAL_CAUSE ACTION_TAKEN COMPONENT_CONCERNED }
+enum MeterKind         { RUNNING_HOURS STARTS }
+
+model WorkOrder {          // machine à états STRICTE (service, table des transitions)
+  id String @id …  reference String @unique        // OT-2026-0341 (séquence + retry)
+  title String  description String?
+  type WorkOrderType  status WorkOrderStatus @default(OPEN)
+  priority WorkOrderPriority @default(NONE)
+  assetId → Asset  dueDate DateTime?
+  assignees User[] ("WorkOrderAssignees")  createdById → User?
+  startedAt? completedAt? cancelledAt?
+  events WorkOrderEvent[]  checklist ChecklistItem[]
+  report InterventionReport?  request Request?
+}
+
+model WorkOrderEvent {     // activité chronologique : commentaires + traces de transition
+  id, workOrderId (cascade), kind String, message String?, byId → User?, createdAt
+}
+
+model Request {            // demande — converge vers l'OT (lien 1-1, jamais de doublon)
+  id, reference @unique    // DEM-2026-0112
+  description, isPersonTrapped Boolean @default(false)
+  status RequestStatus @default(RECEIVED)  rejectionReason String?   // motif REQUIS au rejet
+  assetId → Asset  requestedById → User?  requesterName String?     // portail public R2.4
+  workOrderId String? @unique → WorkOrder
+}
+
+model ReferenceValue {     // référentiels ADMINISTRABLES du bilan codé (un par champ)
+  id, field BilanField, label String, isActive Boolean @default(true)
+  @@unique([field, label])
+}
+
+model InterventionReport { // bilan codé 6 champs — 1-1 avec l'OT
+  id, workOrderId @unique (cascade), note String?
+  doorStateId? cabinPositionId? anomalyId? externalCauseId? actionTakenId? componentConcernedId?
+  // requis pour clôturer : DOOR_STATE, ACTION_TAKEN, COMPONENT_CONCERNED (maquette)
+}
+
+model TaskTemplate {       // gabarit du préventif (période calendaire en mois)
+  id, label, componentTypeId? → Category, periodMonths Int, isRegulatory Boolean, isActive
+}
+model ChecklistItem {      // la grille du mois d'un OT préventif
+  id, workOrderId (cascade), label, state ChecklistState @default(PENDING)
+  templateId? → TaskTemplate  doneById? → User  doneAt?
+}
+
+model Meter        { id, assetId → Asset, kind MeterKind, @@unique([assetId, kind]) }
+model MeterReading { id, meterId (cascade), value Int, readById? → User, createdAt }
+```
+
+**Invariants R2** :
+
+| Invariant | Où il vit |
+| --- | --- |
+| Transitions : OPEN→(IN_PROGRESS·CANCELLED) ; IN_PROGRESS→(ON_HOLD·DONE·CANCELLED) ; ON_HOLD→(IN_PROGRESS·CANCELLED) ; DONE/CANCELLED terminaux | service work-orders (+ tests) |
+| **Garde de clôture** : bilan (3 champs requis) + checklist sans PENDING | service (transition → DONE) |
+| Demande approuvée = **un seul** OT (1-1), rejet ⇒ motif obligatoire | contrainte @unique + service |
+| « Voir autre » : sans `canViewOther`, un rôle ne voit que SES objets (assigné/créateur/demandeur) | services (scoping des listes + accès) |
+| ReferenceValue/TaskTemplate utilisés : désactivables, jamais supprimés | services (même règle que Category) |
+| Relevé de compteur strictement croissant | service meters |
+| Génération mensuelle idempotente ; appareil sans historique ⇒ premier contrôle (toutes tâches) | service préventif (R2.2, + tests) |
+
 ## À venir (référence v1 éprouvée, sera réintroduit release par release)
 
-- **R2** : `WorkOrder` (machine à états stricte, priorité « personne bloquée »), `Request`
-  (lien 1-1 vers OT), `InterventionReport` (bilan codé 6 champs → `ReferenceValue`),
-  `TaskTemplate`/`PreventivePlan`/`ChecklistItem` (périodicité calendrier), `Meter`.
 - **R3** : `Part`/`StockMovement` (stock **dérivé des mouvements**), `PurchaseOrder`,
   `Partner`, `LaborTime` (taux figé), `Document`.
 - **R4** : `WorkOrder.version` (verrou optimiste de la synchro mobile).