E4 - 📦 Préparer et tracer le dépôt VigieChiro¶

← Retour au sommaire story mapping · Parcours principal : P4 - Préparer le dépôt

Portée : finaliser le travail post-vérification pour déposer la nuit sur Vigie-Chiro et tracer le dépôt. Le chemin nominal est un téléversement direct depuis l'application (création de la participation, envoi reprenable, lancement de l'analyse) ; l'ouverture du dossier pour un dépôt navigateur est un repli hors connexion.

Cette épopée a été rédigée pour l'ancien modèle « dépôt manuel » ; sa structure (stories S2/S3) est réalignée par les chantiers #2379 et #2381. Les assertions « ne dialogue pas » sont corrigées ici (#2376).

Persona principal : tous (Marie pour ses 1-2 dépôts annuels, Karim et Samuel pour leur cadence intensive de plusieurs dizaines de dépôts par saison).

Pré-requis : E0.S3 (DAO passages avec statut), E3.S5 (passage avec verdict OK ou Utilisable).

E4.S1 - Vérifier la cohérence du passage avant préparation du dépôt¶

En tant que Marie

Je veux que l'application contrôle automatiquement que mon passage est complet et conforme au protocole avant de me proposer la préparation du dépôt

Afin de ne pas déposer un dépôt incomplet ou invalide qui serait rejeté par Vigie-Chiro

Critères d'acceptation :

Le bouton « Vérifier et préparer le dépôt » est désactivé tant que le passage n'a pas de verdict (statut < Vérifié).
Si le verdict est Inexploitable, le bouton reste désactivé avec un message explicite « Ce passage ne peut pas être déposé (R14). Modifiez le verdict via la vue de vérification si vous changez d'avis. »
Au clic sur « Vérifier et préparer le dépôt », l'application enchaîne une série de vérifications et affiche un rapport :
- tous les enregistrements originaux ont-ils été transformés en séquences d'écoute ?
- le préfixe CarXXXXXX-AAAA-PassN-YY- est-il présent et conforme sur tous les fichiers (R6, R7, R8) ?
- le journal du capteur et le relevé climatique sont-ils présents (ou explicitement signalés absents) ?
- le dossier de sortie est-il accessible en écriture ?
Chaque vérification est affichée en ligne avec une icône ✅ ou ❌ et un message court.
Si au moins une vérification échoue, le passage au statut Prêt à déposer est bloqué et l'utilisateur est invité à corriger (lien direct vers le parcours concerné pour les corrections faisables in-app).
Si toutes les vérifications passent, le passage transitionne vers Prêt à déposer et l'écran E4.S2 s'ouvre.

Parcours rattaché : P4, étapes 1-2
Maquettes cibles : M-Lot (rapport de vérifications avec ✅/❌ par ligne)
Dépendances : E0.S3, E2.S5, E2.S6, E3.S5

E4.S2 - Voir le récapitulatif du dépôt et ouvrir le dossier dans l'explorateur¶

En tant que Marie

Je veux voir un récapitulatif clair du dépôt (volume, nombre de fichiers, emplacement sur disque) et pouvoir ouvrir directement le dossier dans mon explorateur de fichiers

Afin de sélectionner facilement les fichiers à téléverser sur Vigie-Chiro depuis mon navigateur

Critères d'acceptation :

L'écran « Dépôt » affiche : nombre de séquences d'écoute, taille totale, chemin absolu du dossier de sortie sur le disque local.
Un bouton « Ouvrir le dossier dans l'explorateur » (libellé exact à voir avec la maquette) déclenche l'ouverture du dossier dans l'explorateur natif de l'OS (Files sous Linux, Finder sous macOS, Explorer sous Windows).
Le chemin du dossier est aussi affiché sous forme copiable (clic icône « copier ») pour les cas où le bouton « Ouvrir » ne fonctionne pas (ex. environnement sans bureau graphique).
En repli (hors connexion), un rappel indique comment déposer à la main : « Téléversez ces fichiers sur https://vigiechiro.herokuapp.com/ depuis votre navigateur, puis revenez marquer le passage déposé. »
Un lien direct vers le portail Vigie-Chiro est mis à disposition (s'ouvre dans le navigateur par défaut).
Tests d'intégration : le bouton « Ouvrir le dossier » se résout-il correctement sur Linux/macOS/Windows ? (à arbitrer selon l'OS de référence)

Parcours rattaché : P4, étapes 3-4
Maquettes cibles : M-Lot (récapitulatif + bouton « Ouvrir le dossier » + lien externe Vigie-Chiro)
Dépendances : E4.S1

E4.S3 - Marquer le passage comme déposé (repli du dépôt navigateur)¶

En tant que Marie

Je veux pouvoir confirmer à l'application que j'ai effectivement déposé sur Vigie-Chiro, avec mémorisation de la date de dépôt

Afin de clôturer ce passage dans mon suivi et le distinguer des passages encore en attente de dépôt

Critères d'acceptation :

Sur l'écran « Dépôt », un bouton « J'ai déposé » (ou libellé équivalent) est mis en avant.
Le clic ouvre une confirmation explicite : « Confirmez-vous avoir téléversé tous les fichiers sur Vigie-Chiro ? Cette action passe le passage au statut Déposé et mémorise la date du jour comme date de dépôt. »
À la confirmation, le passage transitionne vers le statut Déposé (E0.S3) et la date courante est persistée comme date de dépôt déclarée.
Le bouton est ensuite remplacé par une mention « Déposé le JJ/MM/AAAA » (modifiable via une action « Corriger la date de dépôt » pour gérer les cas où le téléversement a eu lieu un autre jour).
Un passage Déposé apparaît distinctement dans la liste des passages (badge vert ou similaire).
L'utilisateur peut annuler la déclaration de dépôt (retour au statut Prêt à déposer) en cas d'erreur, avec confirmation explicite.

Parcours rattaché : P4, étape 5
Maquettes cibles : M-Lot (bouton « J'ai déposé » + variante état déposé)
Dépendances : E0.S3, E4.S1

E4.S4 - Visualiser le statut d'avancement et la chronologie d'un passage¶

En tant que Karim ou Samuel (qui jongle entre plusieurs dizaines de passages à différents stades)

Je veux voir en un coup d'œil où en est un passage dans le cycle de vie (Importé → Transformé → Vérifié → Prêt à déposer → Déposé) et l'historique des transitions

Afin de ne pas perdre la trace de ce qui a été fait sur quel passage et identifier rapidement les passages bloqués

Critères d'acceptation :

La fiche détail d'un passage affiche clairement le statut d'avancement courant (badge coloré).
Un mini-bandeau visuel (type indicateur d'étapes horizontal) montre les 5 statuts du cycle avec le statut courant mis en évidence et les précédents marqués comme franchis.
Pour chaque transition franchie, on voit la date de la transition (ex. « Importé le 15/06, Transformé le 15/06, Vérifié le 16/06 avec verdict OK, Déposé le 17/06 »).
Si le passage est bloqué (verdict Inexploitable, vérifications échouées en E4.S1), un indicateur explicite signale la raison du blocage.
Dans la vue tabulaire multi-sites (cf. E5), le statut est une colonne triable et filtrable.
Le statut courant et l'historique sont persistés en BD et survivent aux redémarrages.

Parcours rattaché : P4 (transverse - pertinent aussi pour P2, P3 et P5)
Maquettes cibles : M-Passage (indicateur d'étapes de statut + chronologie), M-MultiSite (colonne statut filtrable)
Dépendances : E0.S3

E4.S5 - Générer et gérer les archives ZIP de dépôt¶

En tant que Samuel

Je veux que l'application découpe mes séquences en archives ZIP prêtes à téléverser

Afin de déposer un gros volume par paquets et libérer l'espace une fois en ligne

Critères d'acceptation :

Les séquences sont découpées en archives <préfixe>-N.zip numérotées, écrites dans le sous-dossier depot/ de la session (R22).
Chaque archive respecte un plafond de taille (~700 Mo par défaut, configurable) ; la taille réelle est vérifiée après écriture.
La génération vérifie l'espace disque disponible avant d'écrire et refuse tôt s'il manque.
Les archives sont régénérables à l'identique ; leur suppression n'est permise que si le passage est marqué déposé.

Parcours rattaché : P4, génération du dépôt
Maquettes cibles : M-Lot (« Générer les archives » / « Supprimer les archives ZIP locales »)
Dépendances : E4.S1

E4.S6 - Réactiver un passage archivé en retrouvant ses fichiers¶

En tant que Karim

Je veux ré-associer les fichiers d'un passage dont l'audio n'est plus sur le disque

Afin de le réécouter après avoir libéré de l'espace ou réinstallé l'application

« Archivé » est un état observé, pas un geste

Un passage est « archivé » de fait quand ses séquences ne sont plus sur le disque : c'est un état recalculé sur le disque, pas un drapeau stocké ni un bouton « Archiver ». De même, ne pas conserver les originaux est un réglage d'import (désactivé par défaut, R9 / R22), pas une « purge » déclarée a posteriori. Il n'y a donc ni bouton « Archiver » ni bouton « Purger ».

Critères d'acceptation :

Un passage dont les séquences ne sont plus sur le disque est consultable mais pas écoutable (état « archivé » observé).
La réactivation désigne un dossier et ne rebranche fichier par fichier que ce qui est vérifié : un fichier dont l'identité ne correspond pas est compté, motivé et rapporté, jamais rebranché (un cri validé en écoutant autre chose serait une erreur scientifique).
Deux voies : séquences présentes rebranchées directement, ou seulement les bruts régénérés puis soumis à la même garde ; ni l'un ni l'autre → aucune réactivation (on n'invente rien).
L'opération est idempotente et non destructrice : fichiers copiés (jamais déplacés), observations et vérifications non touchées.

Parcours rattaché : P12, après reconstruction
Maquettes cibles : M-Passage (action « Réactiver ce passage »)
Dépendances : E9.S5