PD-285 — Alignement contractuel de la limite d’upload backend à 500 MB¶

1. Objectif¶

Contractualiser l’alignement des limites de taille d’upload backend de 100 MB à 500 MB pour supprimer l’incohérence inter-EB avec PD-101, garantir une règle unique côté backend pour les catégories concernées, et synchroniser la documentation normative PD-252.

2. Périmètre / Hors périmètre¶

Inclus¶

• Relèvement de la limite maxSizeBytes à 524288000 bytes (500 MB) pour :
• DocumentCategoryConfig.DEFAULT
• DocumentCategoryConfig.B2C_EVIDENCE_MINOR
• Validation contractuelle des rejets au-delà de 500 MB :
• pré-validation middleware (via Content-Length quand présent)
• validation métier service (code erreur ERR-79-004)
• Mise à jour des tests unitaires liés aux limites de catégorie.
• Amendement documentaire PD-252 (besoin et spécification) avec la référence storage.category_max_bytes: 500 MB.
• Validation de cohérence inter-EB : suppression de l’écart PD-101 vs backend.

Exclu¶

• Changement de NORMATIVE_DEFAULTS.MAX_FILE_SIZE (multipart, 5 TB) : inchangé.
• Changement des quotas utilisateur (cumul, concurrence, journalier) : inchangé.
• Changement client mobile PD-101 : inchangé.
• Changement d’infrastructure S3/OVH : inchangé.
• Changement des politiques MIME / audit mineurs hors taille : inchangé.

3. Définitions¶

• MB (binaire) : 1 MB = 1024 * 1024 bytes.
• 500 MB : 524288000 bytes.
• 100 MB : 104857600 bytes.
• Catégorie documentaire : clé de configuration de politique de fichier (ex. DEFAULT, B2C_EVIDENCE_MINOR).
• Content-Length : en-tête HTTP représentant la taille du corps, entier en bytes.
• ERR-79-004 : code d’erreur métier “taille fichier dépassée”.
• Règle de cohérence inter-EB : SYSTÈME >= BACKEND >= CLIENT.
• Amendement documentaire : modification des artefacts PD-252 sans ajout de nouvelle logique métier.

4. Invariants (non négociables)¶

5. Flux nominaux¶

Flux N1 — Lecture de la règle de taille catégorie¶

1. Le système récupère la limite de taille de la catégorie documentaire.
2. Pour DEFAULT et B2C_EVIDENCE_MINOR, la limite effective est 524288000 bytes.
3. Cette valeur est la référence contractuelle unique pour la story.

Flux N2 — Pré-validation d’upload (middleware)¶

1. Le client émet une requête d’upload avec Content-Length (si présent).
2. Le middleware compare Content-Length à la limite de catégorie.
3. Si Content-Length > 524288000, la requête est rejetée.
4. Si Content-Length <= 524288000, le flux continue vers la validation métier.

Flux N3 — Validation métier de taille (service)¶

1. Le service applique la limite de catégorie sur la taille du fichier à valider.
2. Si taille > 524288000, rejet avec ERR-79-004.
3. Si taille <= 524288000, la validation taille est conforme (sous réserve des autres règles hors périmètre).

Flux N4 — Amendement documentaire PD-252¶

1. Le besoin PD-252 est amendé pour refléter storage.category_max_bytes: 500 MB.
2. La spécification PD-252 est amendée avec la même valeur de référence.
3. Les deux artefacts sont cohérents entre eux.

Flux N5 — Vérification de cohérence inter-EB¶

1. La pipeline de cohérence inter-EB exécute le contrôle des contraintes de taille.
2. Le couple PD-101 (client 500 MB) / backend (500 MB) n’est plus signalé comme incohérent.

Modèle de données contractuel (§5, référence unique)¶

5bis. Diagrammes¶

Séquence — Validation de taille d’upload (Flux N2 + N3)¶

sequenceDiagram
    participant Client
    participant Middleware as Middleware (pré-validation)
    participant Service as Service métier (validation catégorie)

    Client->>Middleware: POST /upload (Content-Length, catégorie)

    alt Content-Length > 524288000 [INV-285-03]
        Middleware-->>Client: 413 Rejet immédiat (E-01)
    else Content-Length <= 524288000 ou absent
        Middleware->>Service: Forward requête

        Service->>Service: Récupère maxSizeBytes catégorie [INV-285-01, INV-285-02]

        alt taille fichier > 524288000 [INV-285-03]
            Service-->>Client: 400 ERR-79-004 (E-02) [INV-285-05]
        else taille fichier <= 524288000
            Note over Service: Validation taille OK [INV-285-06]
            Service-->>Client: 200 Upload accepté
        end
    end

Séquence — Cohérence inter-EB post-amendement (Flux N4 + N5)¶

sequenceDiagram
    participant Ops as Orchestrateur
    participant Doc as PD-252 (besoin + spec)
    participant Pipeline as Pipeline cohérence inter-EB

    Ops->>Doc: Amende storage.category_max_bytes = 500 MB [INV-285-07]
    Doc-->>Ops: Artefacts mis à jour

    Ops->>Pipeline: Exécute contrôle cohérence
    Pipeline->>Pipeline: Compare PD-101 client (500 MB) vs backend (500 MB) [INV-285-01]
    Pipeline-->>Ops: Aucune incohérence détectée

6. Cas d’erreur¶

7. Critères d’acceptation (testables)¶

8. Scénarios de test (Given / When / Then)¶

• T-01 (CA-01)
  Given la configuration catégories backend
  When la valeur DEFAULT.maxSizeBytes est lue
  Then elle vaut 524288000.

• T-02 (CA-02)
  Given la configuration catégories backend
  When la valeur B2C_EVIDENCE_MINOR.maxSizeBytes est lue
  Then elle vaut 524288000.

• T-03 (CA-03 borne haute rejet)
  Given une requête upload avec Content-Length = 524288001 et catégorie DEFAULT
  When le middleware de taille exécute la pré-validation
  Then la requête est rejetée.

• T-04 (CA-03 borne haute inclusive acceptée)
  Given une requête upload avec Content-Length = 524288000 et catégorie DEFAULT
  When le middleware de taille exécute la pré-validation
  Then la requête n’est pas rejetée pour motif de taille.

• T-05 (CA-04)
  Given une validation métier avec taille fichier 524288001
  When le service de configuration applique la règle de catégorie
  Then la réponse contient ERR-79-004.

• T-06 (CA-05)
  Given la suite de tests unitaires mise à jour
  When la suite est exécutée
  Then tous les tests concernés sont passants.

• T-07 (CA-06)
  Given les artefacts PD-252 besoin et spécification
  When les documents sont vérifiés
  Then chacun contient la contrainte storage.category_max_bytes: 500 MB.

• T-08 (CA-07)
  Given la pipeline de cohérence inter-EB exécutée après amendement
  When le rapport de cohérence est produit
  Then aucune incohérence PD-101 vs backend sur la taille max n’est remontée.

9. Hypothèses explicites¶

10. Points à clarifier¶

10.1 Contraintes techniques (obligatoire)¶

• Projet cible code : ProbatioVault-backend
• Stack contractuelle réelle : NestJS + TypeScript + TypeORM + PostgreSQL
• Indices de référence stack : package.json, nest-cli.json
• Projet documentaire associé : ProbatioVault-doc (Markdown, sans runtime applicatif)

10.2 Données manquantes / ambiguïtés à lever¶

Références¶

• Epic : Référence épique (à préciser)
• JIRA : PD-285
• Repos concernés : ProbatioVault-backend, ProbatioVault-doc
• Documents associés :
• PD-252-besoin.md
• PD-252-specification.md
• PD-101 (référence cohérence client)
• Rapport coherence-report.py (Level 1.1, issue #5)