PD-286 — Scénarios de tests contractuels¶

TEST-ID: TC-NOM-01
Référence spec: INV-286-05, CA-286-02

GIVEN
  - Dossier validé de taille déterministe 500MB
  - ExportId UUID v4 valide
WHEN
  - L’utilisateur déclenche un export
THEN
  - L’API retourne un contrat single-volume exploitable sans dépendance à volumes[]
AND
  - L’app produit un seul fichier .pvproof et statut final COMPLETED

TEST-ID: TC-NOM-02
Référence spec: INV-286-01, INV-286-06, CA-286-01

GIVEN
  - Dossier validé de taille déterministe 2GB
  - Ensemble de preuves atomiques dont chacune <= 768MB
WHEN
  - L’utilisateur déclenche un export
THEN
  - L’API retourne totalVolumes >= 2 et volumes[] non vide
AND
  - Pour chaque volume: 0 < estimatedBytes <= 805306368 et volumeIndex couvre [0..totalVolumes-1] sans trou

TEST-ID: TC-NOM-03
Référence spec: INV-286-08, CA-286-03

GIVEN
  - Réponse multi-volumes valide et téléchargements de tous volumes réussis
WHEN
  - L’app termine l’assemblage
THEN
  - Un unique .pvproof final est généré
AND
  - Le .pvproof contient volumes_count et assembled_from[] de cardinalité = totalVolumes

TEST-ID: TC-NOM-04
Référence spec: INV-286-07, CA-286-04

GIVEN
  - Export multi-volumes avec integrityHash valide par volume
WHEN
  - L’app traite chaque volume séquentiellement
THEN
  - L’app recalcule SHA3-256 du manifest partiel canonicalisé et compare au integrityHash attendu
AND
  - Aucun volume n’est assemblé sans comparaison explicite hash attendu/hash recalculé

TEST-ID: TC-NOM-05
Référence spec: INV-286-09, CA-286-06

GIVEN
  - Export multi-volumes terminé en succès
WHEN
  - Les événements d’audit sont persistés
THEN
  - Le journal WORM contient exportId, volumes_count, integrityHash[] et statut final COMPLETED
AND
  - Les entrées sont corrélables à un seul exportId sans ambiguïté

TEST-ID: TC-ERR-01
Référence spec: ERR-286-01, INV-286-02

GIVEN
  - Dossier validé de taille strictement > 10_737_418_240 bytes
WHEN
  - Une demande d’export est soumise
THEN
  - Réponse 413 EXPORT_TOTAL_LIMIT_EXCEEDED
AND
  - Aucun volume n’est émis, aucun assemblage démarré

TEST-ID: TC-NOM-06
Référence spec: INV-286-01, INV-286-04, CA-286-03

GIVEN
  - Une preuve atomique unique de 900MB (> VOLUME_MAX_BYTES mais < MAX_TOTAL)
WHEN
  - Le backend planifie les volumes
THEN
  - La preuve est placée dans un volume dédié exceptionnel (1 seule preuve par volume)
AND
  - Aucune scission de preuve n’est réalisée, le volume dépasse VOLUME_MAX_BYTES mais est accepté

TEST-ID: TC-ERR-03
Référence spec: ERR-286-03

GIVEN
  - Réponse backend contenant integrityHash non conforme regex /^[0-9a-f]{64}$/
WHEN
  - L’app valide le contrat reçu
THEN
  - Le contrat est rejeté et l’export passe FAILED
AND
  - Audit fail-closed d’échec émis

TEST-ID: TC-ERR-04
Référence spec: ERR-286-04, INV-286-07, CA-286-05

GIVEN
  - Un volume téléchargé altéré en transit
WHEN
  - Hash recalculé != integrityHash attendu
THEN
  - Arrêt immédiat du flux et statut export FAILED
AND
  - Aucun succès partiel ni fichier final COMPLETED

TEST-ID: TC-ERR-05
Référence spec: ERR-286-05, CA-286-09

GIVEN
  - Export en cours avec SIGNED_URL_TTL ou EXPORT_SESSION_TTL expiré
WHEN
  - L’app tente le volume suivant ou la reprise
THEN
  - Transition vers EXPIRED
AND
  - Reprise interdite sur le même exportId (nouvelle requête obligatoire)

TEST-ID: TC-ERR-06
Référence spec: ERR-286-06, INV-286-06

GIVEN
  - volumes[] contenant trou d’index ou doublon
WHEN
  - L’app valide la structure de plan d’export
THEN
  - Assemblage refusé, statut FAILED
AND
  - Aucun .pvproof final n’est produit

TEST-ID: TC-ERR-07
Référence spec: ERR-286-07, CA-286-05

GIVEN
  - Échec réseau déterministe sur téléchargement d’un volume
WHEN
  - Le volume concerné est requis
THEN
  - Export global FAILED
AND
  - Aucun statut de succès partiel n’est exposé

TEST-ID: TC-ERR-08
Référence spec: ERR-286-08

GIVEN
  - Donnée d’entrée mal formée (exportId invalide ou signedUrl non HTTPS/format invalide)
WHEN
  - Validation contractuelle exécutée
THEN
  - Code 400/422 selon champ
AND
  - Aucune tentative d’assemblage n’est lancée

TEST-ID: TC-ERR-09
Référence spec: ERR-286-02, CA-286-10

GIVEN
  - Une preuve atomique unique de 11GB (> MAX_TOTAL_EXPORT_BYTES)
WHEN
  - Le backend planifie les volumes
THEN
  - Réponse 413 PROOF_TOO_LARGE
AND
  - Aucun volume émis, aucun assemblage engagé

TEST-ID: TC-FIN-01
Référence spec: INV-286-09, §5.6

GIVEN
  - Export multi-volumes en état ASSEMBLING, ownership vérifié
WHEN
  - L’app appelle POST /exports/{exportId}/finalize avec {finalStatus: "COMPLETED"}
THEN
  - Session transite vers COMPLETED
AND
  - Audit FINAL émis via ExportAuditService.appendFinal() avec integrityHashes[] et volumes_count
AND
  - Réponse 204 No Content

TEST-ID: TC-FIN-02
Référence spec: INV-286-09, §5.6

GIVEN
  - Export en état DOWNLOADING, hash mismatch détecté par l’app
WHEN
  - L’app appelle POST /exports/{exportId}/finalize avec {finalStatus: "FAILED", reasonCode: "HASH_MISMATCH"}
THEN
  - Session transite vers FAILED
AND
  - Audit FINAL émis avec status FAILED et reasonCode
AND
  - Réponse 204 No Content

TEST-ID: TC-FIN-03
Référence spec: §5.6, anti-énumération

GIVEN
  - exportId inconnu ou non détenu par l’utilisateur authentifié
WHEN
  - L’app appelle POST /exports/{exportId}/finalize
THEN
  - Réponse 404 EXPORT_NOT_FOUND (message uniforme, anti-énumération)
AND
  - Aucune transition ni audit émis

TEST-ID: TC-FIN-04
Référence spec: INV-286-11, §5.6

GIVEN
  - Export déjà en état terminal (COMPLETED, FAILED ou EXPIRED)
WHEN
  - L’app appelle POST /exports/{exportId}/finalize
THEN
  - Transition refusée par la state machine (ForbiddenStateTransitionException)
AND
  - Réponse 500 ou 409