feat(r3.2): bibliothèque de documents (FileStorage réel) + analytics

- FileStorage : putObject/getObjectStream/removeObject, bucket créé au
  démarrage — MinIO confiné à son implémentation (règle ESLint intacte)
- documents : upload multipart (PDF/JPG/PNG, 20 Mo max, rattachement
  appareil OU OT requis, permission d'édition sur la CIBLE), liste
  filtrable, téléchargement STREAMÉ par l'API (MinIO jamais exposé),
  suppression ; e2e : octets téléchargés identiques aux octets envoyés
- analytics : GET /analytics/summary dérivé du réel — coûts/mois
  (mouvements + main-d'œuvre figés), pannes par organe (bilans codés),
  taux de préventif, durée moyenne de résolution, top équipements
- générateur OpenAPI : query params, multipart, réponse binaire (71 ops)
- CI : service MinIO (bitnami) sur les jobs api et e2e
- test de régression du tri « Interventions récentes » rendu déterministe
  (positions absolues instables sous 12 suites parallèles) ; 58 tests,
  6 runs complets consécutifs verts

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

packages/shared/src/contract.ts

@@ -44,6 +44,11 @@ import {
   PortalRequestCreateSchema,
   PortalRequestStatusSchema,
 } from './schemas/portail';
+import {
+  AnalyticsSummarySchema,
+  DocumentSchema,
+  DocumentsResponseSchema,
+} from './schemas/documents';
 import {
   ConsumePartSchema,
   LaborTimeCreateSchema,
@@ -108,8 +113,14 @@ export interface ApiOperation {
   isPublic?: boolean;
   /** ADR-002 : la route N'EXISTE PAS (404) si DEMO_MODE n'est pas actif. */
   demoOnly?: boolean;
-  /** Paramètres de chemin (`{id}` dans path) — tous UUID en R1. */
+  /** Paramètres de chemin (`{id}` dans path) — `id`/`…Id` = UUID. */
   pathParams?: string[];
+  /** Paramètres de requête (?a=…&b=…). */
+  queryParams?: { name: string; required?: boolean }[];
+  /** Upload multipart/form-data : champs déclarés ('file' = binaire). */
+  multipartFields?: Record<string, 'file' | 'string'>;
+  /** Réponse 200 binaire (téléchargement streamé). */
+  binaryResponse?: boolean;
   request?: { name: string; schema: z.ZodType };
   responses: Record<
     number,
@@ -436,6 +447,66 @@ export const API_CONTRACT: ApiOperation[] = [
       404: { description: 'Inconnue' },
     },
   },
+  // ————— R3 · Bibliothèque & analytics —————
+  {
+    operationId: 'listDocuments',
+    method: 'get',
+    path: '/documents',
+    summary: 'Bibliothèque (filtrable par appareil ou OT)',
+    tags: ['documents'],
+    queryParams: [{ name: 'assetId' }, { name: 'workOrderId' }, { name: 'kind' }],
+    responses: {
+      200: { description: 'Liste', name: 'DocumentsResponse', schema: DocumentsResponseSchema },
+    },
+  },
+  {
+    operationId: 'uploadDocument',
+    method: 'post',
+    path: '/documents',
+    summary: 'Téléverser (PDF/JPG/PNG, 20 Mo max, rattachement appareil OU OT requis)',
+    tags: ['documents'],
+    multipartFields: { file: 'file', kind: 'string', assetId: 'string', workOrderId: 'string' },
+    responses: {
+      201: { description: 'Document rangé', name: 'Document', schema: DocumentSchema },
+      400: { description: 'Type/taille refusé ou rattachement manquant' },
+    },
+  },
+  {
+    operationId: 'downloadDocument',
+    method: 'get',
+    path: '/documents/{id}/download',
+    summary: 'Télécharger — streamé par l’API (MinIO jamais exposé)',
+    tags: ['documents'],
+    pathParams: ['id'],
+    binaryResponse: true,
+    responses: {
+      200: { description: 'Fichier' },
+      404: { description: 'Inconnu' },
+    },
+  },
+  {
+    operationId: 'deleteDocument',
+    method: 'delete',
+    path: '/documents/{id}',
+    summary: 'Supprimer (permission d’édition sur la cible)',
+    tags: ['documents'],
+    pathParams: ['id'],
+    responses: {
+      204: { description: 'Supprimé' },
+      404: { description: 'Inconnu' },
+    },
+  },
+  {
+    operationId: 'getAnalyticsSummary',
+    method: 'get',
+    path: '/analytics/summary',
+    summary: 'Le tableau de la direction : coûts, pannes par organe (bilans), préventif, top équipements',
+    tags: ['analytics'],
+    responses: {
+      200: { description: 'Synthèse', name: 'AnalyticsSummary', schema: AnalyticsSummarySchema },
+    },
+  },
+
   // ————— R3 · Gestion (stock, achats, tiers, coûts) —————
   {
     operationId: 'listPartners',