feat(r2.2): préventif — génération mensuelle idempotente — et compteurs

- migration : Asset.underContract + WorkOrder.periodKey avec unicité
  [assetId, periodKey] — l'idempotence de la génération est EN BASE
  (deux appels concurrents ne doublent jamais une grille)
- génération : une grille par appareil sous contrat, périodicités ancrées
  sur la mise en service (mensuelles toujours dues), premier contrôle
  (toutes les tâches) pour un appareil sans historique, échéance fin de
  mois, événement GENERATED ; déclenchement manuel (cron au durcissement)
- gabarits administrables (désactivé = exclu des générations suivantes) ;
  GET /preventive/status (générées, terminées, en retard, premiers contrôles)
- compteurs : GET meters (2 compteurs, récents d'abord) ; relevé
  strictement croissant, refus motivé sinon
- contrat +7 opérations (48) ; 50 tests verts (94,7 % / 78 %) ; smoke test
  prod : juillet généré (9 grilles, 8 premiers contrôles), 2e appel à zéro

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

packages/shared/src/contract.ts

@@ -37,6 +37,17 @@ import {
   UsersResponseSchema,
   UserUpdateSchema,
 } from './schemas/users-admin';
+import {
+  MeterReadingCreateSchema,
+  MetersResponseSchema,
+  PreventiveGenerateSchema,
+  PreventiveGenerationResultSchema,
+  PreventiveStatusSchema,
+  TaskTemplateCreateSchema,
+  TaskTemplateSchema,
+  TaskTemplatesResponseSchema,
+  TaskTemplateUpdateSchema,
+} from './schemas/preventif';
 import {
   AssigneesUpdateSchema,
   ChecklistItemSchema,
@@ -387,6 +398,93 @@ export const API_CONTRACT: ApiOperation[] = [
       404: { description: 'Inconnue' },
     },
   },
+  // ————— R2 · Préventif & compteurs —————
+  {
+    operationId: 'listTaskTemplates',
+    method: 'get',
+    path: '/preventive/templates',
+    summary: 'Gabarits de tâches du préventif (périodicité en mois)',
+    tags: ['preventive'],
+    responses: {
+      200: { description: 'Liste', name: 'TaskTemplatesResponse', schema: TaskTemplatesResponseSchema },
+    },
+  },
+  {
+    operationId: 'createTaskTemplate',
+    method: 'post',
+    path: '/preventive/templates',
+    summary: 'Ajouter un gabarit',
+    tags: ['preventive'],
+    request: { name: 'TaskTemplateCreate', schema: TaskTemplateCreateSchema },
+    responses: {
+      201: { description: 'Créé', name: 'TaskTemplate', schema: TaskTemplateSchema },
+      409: { description: 'Libellé déjà utilisé' },
+    },
+  },
+  {
+    operationId: 'updateTaskTemplate',
+    method: 'patch',
+    path: '/preventive/templates/{id}',
+    summary: 'Modifier / (dés)activer un gabarit — jamais de suppression si utilisé',
+    tags: ['preventive'],
+    pathParams: ['id'],
+    request: { name: 'TaskTemplateUpdate', schema: TaskTemplateUpdateSchema },
+    responses: {
+      200: { description: 'Mis à jour', name: 'TaskTemplate', schema: TaskTemplateSchema },
+      404: { description: 'Inconnu' },
+    },
+  },
+  {
+    operationId: 'generatePreventive',
+    method: 'post',
+    path: '/preventive/generate',
+    summary: 'Générer la grille du mois — IDEMPOTENT (regénérer ne double rien)',
+    tags: ['preventive'],
+    request: { name: 'PreventiveGenerate', schema: PreventiveGenerateSchema },
+    responses: {
+      200: {
+        description: 'Résumé de génération',
+        name: 'PreventiveGenerationResult',
+        schema: PreventiveGenerationResultSchema,
+      },
+    },
+  },
+  {
+    operationId: 'getPreventiveStatus',
+    method: 'get',
+    path: '/preventive/status',
+    summary: 'État du mois courant (générées, terminées, en retard, premiers contrôles)',
+    tags: ['preventive'],
+    responses: {
+      200: { description: 'État', name: 'PreventiveStatus', schema: PreventiveStatusSchema },
+    },
+  },
+  {
+    operationId: 'getAssetMeters',
+    method: 'get',
+    path: '/assets/{id}/meters',
+    summary: 'Compteurs de l’appareil (relevés récents d’abord)',
+    tags: ['meters'],
+    pathParams: ['id'],
+    responses: {
+      200: { description: 'Compteurs', name: 'MetersResponse', schema: MetersResponseSchema },
+      404: { description: 'Appareil inconnu' },
+    },
+  },
+  {
+    operationId: 'addMeterReading',
+    method: 'post',
+    path: '/assets/{id}/meter-readings',
+    summary: 'Enregistrer un relevé — strictement croissant',
+    tags: ['meters'],
+    pathParams: ['id'],
+    request: { name: 'MeterReadingCreate', schema: MeterReadingCreateSchema },
+    responses: {
+      201: { description: 'Relevé enregistré', name: 'MetersResponse', schema: MetersResponseSchema },
+      400: { description: 'Relevé inférieur ou égal au précédent' },
+    },
+  },
+
   // ————— R2 · Exploitation —————
   {
     operationId: 'listWorkOrders',