PD-285 — Plan d'implémentation¶

1. Découpage en composants¶

Pas de composant logiciel modifié : Le middleware (category-size.middleware.ts) et le service (category-config.service.ts) lisent maxSizeBytes depuis la DB. Il n'y a aucune constante hardcodée dans le code applicatif — seule la migration seed contient 104857600. Le relèvement se fait par migration SQL uniquement.

2. Flux techniques¶

Flux F1 — Migration DB (C1)¶

1. TypeORM exécute la migration
2. UPDATE vault_secure.document_category_configs
   SET max_size_bytes = 524288000, updated_at = NOW()
   WHERE category IN ('DEFAULT', 'B2C_EVIDENCE_MINOR')
3. Le cache CategoryConfigService expire après 60s (INV-T5-03)
4. Les requêtes suivantes utilisent la nouvelle limite

Flux F2 — Validation upload (existant, inchangé)¶

1. Requête upload → CategorySizeMiddleware
2. Middleware lit Content-Length, compare à resolve(null).maxSizeBytes (désormais 524288000)
3. Si > 524288000 → PayloadTooLargeException ERR-79-004
4. Sinon → DepositController → CategoryConfigService.assertSizeAllowed()
5. Si taille réelle > 524288000 → PayloadTooLargeException ERR-79-004
6. Sinon → flux nominal (dépôt, hash, stockage)

Flux F3 — Amendement documentaire (C3)¶

1. Modifier PD-252-besoin.md : remplacer "max 100 MB" par "max 500 MB" pour les 2 catégories
2. Modifier PD-252-specification.md : remplacer la valeur 100 par 500 dans le tableau des seuils
3. Vérifier cohérence textuelle entre les deux documents

2bis. Diagrammes Mermaid¶

Graphe de dépendances entre composants¶

graph TD
    C1["C1 — Migration SQL<br/><code>RaiseMaxSize500MB.ts</code>"]
    C2["C2 — Tests unitaires config<br/><code>category-config.service.spec.ts</code><br/><code>deposit.controller.spec.ts</code>"]
    C3["C3 — Amendement PD-252<br/><code>PD-252-besoin.md</code><br/><code>PD-252-specification.md</code>"]
    C4["C4 — Cohérence inter-EB<br/><code>coherence-report.py</code>"]

    DB[("vault_secure.<br/>document_category_configs")]
    MW["CategorySizeMiddleware<br/>(existant, inchangé)"]
    SVC["CategoryConfigService<br/>(existant, inchangé)"]
    CACHE["Cache TTL 60s<br/>(INV-T5-03)"]

    C1 -->|UPDATE max_size_bytes| DB
    DB -->|lecture| CACHE
    CACHE -->|resolve()| SVC
    SVC -->|maxSizeBytes| MW
    C2 -->|mock maxSizeBytes = 524288000| SVC
    C2 -->|mock maxSizeBytes = 524288000| MW
    C3 -.->|aligne doc 100→500 MB| C4
    C1 -.->|valide cohérence post-migration| C4

    style C1 fill:#4CAF50,color:#fff
    style C2 fill:#2196F3,color:#fff
    style C3 fill:#FF9800,color:#fff
    style C4 fill:#9C27B0,color:#fff
    style DB fill:#607D8B,color:#fff
    style MW fill:#78909C,color:#fff
    style SVC fill:#78909C,color:#fff
    style CACHE fill:#78909C,color:#fff

Séquence — Flux F1 : Migration DB + invalidation cache¶

sequenceDiagram
    participant TOM as TypeORM Runner
    participant DB as PostgreSQL<br/>(vault_secure)
    participant SVC as CategoryConfigService
    participant CACHE as Cache (TTL 60s)
    participant MW as CategorySizeMiddleware
    participant CLIENT as Client (upload)

    Note over TOM,DB: Déploiement — Migration C1
    TOM->>DB: UPDATE document_category_configs<br/>SET max_size_bytes = 524288000<br/>WHERE category IN ('DEFAULT','B2C_EVIDENCE_MINOR')
    DB-->>TOM: 2 rows updated

    Note over CACHE: Cache expire après ≤ 60s (INV-T5-03)
    CLIENT->>MW: POST /deposit (Content-Length: 450000000)
    MW->>SVC: resolve(category)
    SVC->>CACHE: get(category)
    CACHE-->>SVC: miss (expiré)
    SVC->>DB: SELECT max_size_bytes WHERE category = 'DEFAULT'
    DB-->>SVC: 524288000
    SVC->>CACHE: set(category, config, TTL=60s)
    SVC-->>MW: maxSizeBytes = 524288000
    MW->>MW: 450000000 ≤ 524288000 → OK
    MW-->>CLIENT: next() → flux nominal

    Note over CLIENT,MW: Cas rejet (Content-Length > 524288000)
    CLIENT->>MW: POST /deposit (Content-Length: 524288001)
    MW->>SVC: resolve(category)
    SVC-->>MW: maxSizeBytes = 524288000
    MW->>MW: 524288001 > 524288000 → REJET
    MW-->>CLIENT: 413 PayloadTooLargeException (ERR-79-004)

3. Mapping invariants → mécanismes¶

4. Mapping critères d'acceptation → mécanismes¶

5. Mapping tests (TC-*) → mécanismes + observables¶

6. Gestion des erreurs¶

Aucun nouveau code d'erreur introduit. Tous les traitements d'erreur sont existants et inchangés.

7. Impacts sécurité¶

Aucune nouvelle surface d'attaque. La limite passe de 100 à 500 MB mais les garde-fous existants (quotas, rate-limit, middleware) restent actifs.

8. Hypothèses techniques¶

9. Points de vigilance (risques, dette, pièges)¶

1. Cache TTL 60s : Après migration, les instances en cours peuvent servir l'ancienne valeur pendant 60s max. En déploiement blue-green, les nouvelles instances démarrent avec cache vide → pas de risque.

2. Migration data vs DDL : Cette migration est un UPDATE de données, pas un changement de schéma. Pas de risque ALTER TYPE ADD VALUE (cf. learning PD-282/PD-279). Pas besoin de commitTransaction() intermédiaire.

3. Pas de rollback automatique : Conformément au pattern existant (down() vide pour production safety), le rollback nécessiterait une migration inverse manuelle. Risque faible car le changement est réversible par un simple UPDATE.

4. Multipart 5 TB inchangé : NORMATIVE_DEFAULTS.MAX_FILE_SIZE dans upload-config.service.ts n'est PAS modifié. Attention à ne pas confondre les deux limites (catégorie vs multipart).

5. Cohérence inter-EB : Le pipeline coherence-report.py doit être exécuté après la migration ET après l'amendement PD-252 pour valider CA-07. Ordre important.

10. Hors périmètre¶

• Changement de NORMATIVE_DEFAULTS.MAX_FILE_SIZE (multipart, 5 TB)
• Changement des quotas utilisateur (cumul, concurrence, journalier)
• Changement client mobile PD-101
• Changement d'infrastructure S3/OVH
• Changement des politiques MIME / audit mineurs hors taille
• Ajout de nouvelles catégories documentaires
• Modification du middleware ou du service (logique inchangée, seule la donnée DB change)

11. Périmètre de test¶

Tous les niveaux de test pertinents sont couverts. Les tests E2E existants sur le flux upload restent valides sans modification (ils utilisent des fichiers < 500 MB). Aucune exclusion non justifiée.

12. Mécanismes cross-module¶

Aucune modification d'autres modules. Le changement est limité à : - Une migration SQL (données, pas de schéma) - Des tests unitaires (mocks) - De la documentation externe (PD-252)

Aucun guard, middleware ou intercepteur n'est ajouté sur des routes d'autres modules.