Spaces:

Ma-Ri-Ba-Ku
/

Picarones

Sleeping

Claude commited on 15 days ago

Commit

1992441

unverified ·

1 Parent(s): b98dad4

docs(operations): remove sprint narrative (Phase 2 L2)

Reformulation des mentions « Sprint XX » dans docs/operations/ :
- accessibility.md (9 mentions)
- deployment-institutional.md (7)
- data-retention-rgpd.md (6)
- release-process.md (5)
- rollback.md (1)

Patterns récurrents nettoyés :
- "Sprint AX du plan de remédiation institutionnelle" en header
→ mention du contexte historique sans tag sprint
- "## Section (Sprint XX)" → "## Section"
- "(Sprint XX)" parenthèse explicative → suppression
- "*Dernière mise à jour : DATE (Sprint XX).*" → date seule

Aucun contenu opérationnel touché : les tableaux de conformité
WCAG, les commandes de déploiement, les procédures de rollback
restent identiques.

Ratchet : ACTIVE_NARRATIVE_BASELINE 75 → 59 (-16).

Files changed (6) hide show

docs/operations/accessibility.md +15 -15
docs/operations/data-retention-rgpd.md +5 -7
docs/operations/deployment-institutional.md +7 -9
docs/operations/release-process.md +6 -6
docs/operations/rollback.md +2 -2
tests/architecture/test_doc_governance.py +1 -1

docs/operations/accessibility.md CHANGED Viewed

@@ -1,12 +1,12 @@
 # Déclaration d'accessibilité — Picarones
-> Sprint A7 du plan de remédiation institutionnelle
-> ([`docs/archive/2026-audits/remediation-plan.md`](docs/archive/2026-audits/remediation-plan.md)).
 >
-> **Statut au 2 mai 2026** : audit interne Sprints A6 + A7 validé,
-> audit externe RGAA / WCAG **en cours** (planifié au Sprint A15).
-> Cette déclaration est **provisoire** jusqu'à validation par un
-> cabinet d'audit indépendant.
 ## Engagement
@@ -28,7 +28,7 @@ qu'elle génère accessibles conformément à :
 ## État de conformité
-### Critères WCAG 2.1 niveau A — **conforme** (Sprint A6)
 | Critère | Statut | Mécanisme |
 |---|---|---|
@@ -39,7 +39,7 @@ qu'elle génère accessibles conformément à :
 | 3.1.1 Language of Page | ✓ | `<html lang="fr|en">` dynamique selon le rendu. |
 | 4.1.2 Name, Role, Value | ✓ | Contrôles natifs, labels ARIA appropriés. |
-### Critères WCAG 2.1 niveau AA — **conforme** (Sprint A7)
 | Critère | Statut | Mécanisme |
 |---|---|---|
@@ -65,7 +65,7 @@ légale. Sont actuellement non conformes par décision éditoriale :
 ### Palette daltonien-friendly (par défaut)
-Depuis Sprint A7, la palette par défaut est **Okabe-Ito 2008**
 (palette qualitative recommandée pour la déficience de la vision
 des couleurs : deutéranopie, protanopie, tritanopie). L'ancienne
 palette rouge/vert/jaune reste accessible via :
@@ -97,9 +97,9 @@ captions de tableaux jumeaux) sont localisés dans les deux langues.
 | Item | Statut | Échéance |
 |---|---|---|
-| Matrice de confusion Unicode (vue Caractères) | Densité visuelle élevée — la table jumelle accessible reste l'alternative principale. | Refonte UX prévue Sprint post-A14. |
 | Génération PDF du rapport | Non livrée (cf. [`../reference/specification.md`](../reference/specification.md) « Promesses non tenues »). | Pas de plan d'ajout, le HTML couvre les usages observés. |
-| Audit RGAA externe | En cours, prestataire à contractualiser. | Sprint A15 (~sem. 11–12). |
 ## Tests automatisés
@@ -131,7 +131,7 @@ pouvez :
 1. ouvrir une issue GitHub étiquetée ``a11y`` :
    <https://github.com/maribakulj/Picarones/issues/new?labels=a11y>,
 2. contacter le mainteneur référent accessibilité (canal défini dans
-   ``GOVERNANCE.md`` après Sprint A10).
 En cas de discrimination caractérisée, le défenseur des droits
 (France) peut être saisi : <https://www.defenseurdesdroits.fr/>.
@@ -140,8 +140,8 @@ En cas de discrimination caractérisée, le défenseur des droits
 - Audit interne automatisé : à chaque PR via la CI.
 - Audit interne manuel (NVDA / VoiceOver) : à chaque release majeure.
-- **Audit externe RGAA / WCAG complet** : annuel, premier audit prévu
-  Sprint A15 (mai 2026).
 ## Remerciements
@@ -151,4 +151,4 @@ permission de diffusion ouverte.
 ---
-*Dernière mise à jour : 2 mai 2026 (Sprint A7).*

 # Déclaration d'accessibilité — Picarones
+> Déclaration d'engagement Picarones vis-à-vis du standard WCAG 2.1
+> AA et de la norme française RGAA 4.1.  Contexte historique :
+> [`docs/archive/2026-audits/remediation-plan.md`](../archive/2026-audits/remediation-plan.md).
 >
+> **Statut au 2 mai 2026** : audit interne validé ; audit externe
+> RGAA / WCAG **en cours**.  Cette déclaration est **provisoire**
+> jusqu'à validation par un cabinet d'audit indépendant.
 ## Engagement
 ## État de conformité
+### Critères WCAG 2.1 niveau A — **conforme**
 | Critère | Statut | Mécanisme |
 |---|---|---|
 | 3.1.1 Language of Page | ✓ | `<html lang="fr|en">` dynamique selon le rendu. |
 | 4.1.2 Name, Role, Value | ✓ | Contrôles natifs, labels ARIA appropriés. |
+### Critères WCAG 2.1 niveau AA — **conforme**
 | Critère | Statut | Mécanisme |
 |---|---|---|
 ### Palette daltonien-friendly (par défaut)
+La palette par défaut est **Okabe-Ito 2008**
 (palette qualitative recommandée pour la déficience de la vision
 des couleurs : deutéranopie, protanopie, tritanopie). L'ancienne
 palette rouge/vert/jaune reste accessible via :
 | Item | Statut | Échéance |
 |---|---|---|
+| Matrice de confusion Unicode (vue Caractères) | Densité visuelle élevée — la table jumelle accessible reste l'alternative principale. | Refonte UX planifiée (cf. backlog). |
 | Génération PDF du rapport | Non livrée (cf. [`../reference/specification.md`](../reference/specification.md) « Promesses non tenues »). | Pas de plan d'ajout, le HTML couvre les usages observés. |
+| Audit RGAA externe | En cours, prestataire à contractualiser. | Prochain trimestre. |
 ## Tests automatisés
 1. ouvrir une issue GitHub étiquetée ``a11y`` :
    <https://github.com/maribakulj/Picarones/issues/new?labels=a11y>,
 2. contacter le mainteneur référent accessibilité (canal défini dans
+   ``GOVERNANCE.md``).
 En cas de discrimination caractérisée, le défenseur des droits
 (France) peut être saisi : <https://www.defenseurdesdroits.fr/>.
 - Audit interne automatisé : à chaque PR via la CI.
 - Audit interne manuel (NVDA / VoiceOver) : à chaque release majeure.
+- **Audit externe RGAA / WCAG complet** : annuel, premier audit
+  prévu mi-2026.
 ## Remerciements
 ---
+*Dernière mise à jour : 2 mai 2026.*

docs/operations/data-retention-rgpd.md CHANGED Viewed

@@ -1,7 +1,5 @@
 # Rétention des données et conformité RGPD
-> Sprint A11 du plan de remédiation institutionnelle (item M-8).
->
 > Ce document décrit **quelles données Picarones collecte**, **où
 > elles sont stockées**, **combien de temps**, et **comment un
 > usager peut demander leur suppression**.
@@ -52,7 +50,7 @@ export PICARONES_REPORTS_RETENTION_DAYS=180
 ## Mécanismes de purge automatique
-### Uploads anciens (Sprint A11)
 Le module `picarones.interfaces.web.maintenance` exécute une tâche
 asyncio en arrière-plan qui scanne `uploads/` toutes les 6 heures
@@ -71,7 +69,7 @@ upload <id> (last access: <date>)`.
 ### IP du rate-limiter
-Le `RateLimiter` (Sprint 24) garde les compteurs en mémoire, fenêtre
 glissante. Aucune persistance disque — les IP disparaissent au
 redémarrage et au-delà de la fenêtre de rate limit.
@@ -156,7 +154,7 @@ traitement.
 - Mettre à jour votre registre de traitements en mentionnant
   explicitement le sous-traitant.
-Le **mode public** (`PICARONES_PUBLIC_MODE=1`, Sprint 24) refuse
 automatiquement les engines cloud — utile pour un déploiement
 public où les uploads ne sont pas filtrés.
@@ -206,7 +204,7 @@ En cas de difficulté ou de désaccord :
 ## Tests automatisés
-Le test `tests/web/test_upload_retention.py` (Sprint A11) valide
 que :
 - la purge auto efface les uploads > N jours ;
@@ -215,4 +213,4 @@ que :
 ---
-*Dernière mise à jour : 2 mai 2026 (Sprint A11).*

 # Rétention des données et conformité RGPD
 > Ce document décrit **quelles données Picarones collecte**, **où
 > elles sont stockées**, **combien de temps**, et **comment un
 > usager peut demander leur suppression**.
 ## Mécanismes de purge automatique
+### Uploads anciens
 Le module `picarones.interfaces.web.maintenance` exécute une tâche
 asyncio en arrière-plan qui scanne `uploads/` toutes les 6 heures
 ### IP du rate-limiter
+Le `RateLimiter` garde les compteurs en mémoire, fenêtre
 glissante. Aucune persistance disque — les IP disparaissent au
 redémarrage et au-delà de la fenêtre de rate limit.
 - Mettre à jour votre registre de traitements en mentionnant
   explicitement le sous-traitant.
+Le **mode public** (`PICARONES_PUBLIC_MODE=1`) refuse
 automatiquement les engines cloud — utile pour un déploiement
 public où les uploads ne sont pas filtrés.
 ## Tests automatisés
+Le test `tests/web/test_upload_retention.py` valide
 que :
 - la purge auto efface les uploads > N jours ;
 ---
+*Dernière mise à jour : 2 mai 2026.*

docs/operations/deployment-institutional.md CHANGED Viewed

@@ -1,7 +1,5 @@
 # Déploiement institutionnel — Picarones
-> Sprint A11 du plan de remédiation institutionnelle (item M-7).
->
 > Ce guide cible les **DSI de bibliothèques nationales et services
 > d'archives** qui souhaitent héberger Picarones sur leur propre
 > infrastructure (intranet, derrière SSO, avec stockage centralisé)
@@ -16,7 +14,7 @@
 - **Linux x86_64 ou ARM64** (Debian 12+, RHEL 9+, Ubuntu 22.04+
   LTS, Rocky 9+).
-- **Python 3.11 ou 3.12** (3.13 informationnel — Sprint A1).
 - **Tesseract OCR ≥ 5.3** (avec packs `fra`, `lat`, `eng` au
   minimum).
 - **3 GB RAM par worker** (le ProcessPool spawne un sous-processus
@@ -65,7 +63,7 @@ HuggingFace Space. Le reverse proxy ajoute l'authentification
 ```
 Notes :
-- **PostgreSQL** : `JobStore` (Sprint 25) utilise SQLite par défaut.
   Pour PostgreSQL, dériver une classe `PostgresJobStore` qui
   implémente la même API (`create_job`, `update_progress`,
   `get_job`, etc.). À défaut, partager la BD SQLite via NFS ne
@@ -96,7 +94,7 @@ PICARONES_RATE_LIMIT_PER_HOUR=0   # 0 = illimité (le SSO gère l'identité)
 # Persistance
 PICARONES_JOBS_DB=/var/lib/picarones/jobs.sqlite
-# RGPD (Sprint A11)
 PICARONES_UPLOAD_RETENTION_DAYS=7
 PICARONES_LOG_IP_RETENTION_HOURS=24
 ```
@@ -189,7 +187,7 @@ curl http://localhost:7860/api/status
 ```
 Les jobs `running` au moment du snapshot sont automatiquement
-marqués `interrupted` au redémarrage (Sprint 26). Le tableau de
 bord sera donc cohérent.
 ## Migration de schéma BD
@@ -239,11 +237,11 @@ qui expose :
 - `picarones_uploads_size_bytes_total`
 - `picarones_engine_invocations_total{engine="..."}`
-Voir `docs/operations/observability.md` (à venir Sprint A11+).
 ### Healthcheck
-Un endpoint `/health` minimal (Sprint A4 / M-3) répond en < 50 ms
 sans toucher à la BD ni aux engines. Configurer le LB pour le
 cibler avec un timeout court (5 s).
@@ -305,4 +303,4 @@ uniquement** (jamais sur le filesystem en clair). Voir [`SECURITY.md`](../../SEC
 ---
-*Dernière mise à jour : 2 mai 2026 (Sprint A11).*

 # Déploiement institutionnel — Picarones
 > Ce guide cible les **DSI de bibliothèques nationales et services
 > d'archives** qui souhaitent héberger Picarones sur leur propre
 > infrastructure (intranet, derrière SSO, avec stockage centralisé)
 - **Linux x86_64 ou ARM64** (Debian 12+, RHEL 9+, Ubuntu 22.04+
   LTS, Rocky 9+).
+- **Python 3.11 ou 3.12** (3.13 informationnel).
 - **Tesseract OCR ≥ 5.3** (avec packs `fra`, `lat`, `eng` au
   minimum).
 - **3 GB RAM par worker** (le ProcessPool spawne un sous-processus
 ```
 Notes :
+- **PostgreSQL** : `JobStore` utilise SQLite par défaut.
   Pour PostgreSQL, dériver une classe `PostgresJobStore` qui
   implémente la même API (`create_job`, `update_progress`,
   `get_job`, etc.). À défaut, partager la BD SQLite via NFS ne
 # Persistance
 PICARONES_JOBS_DB=/var/lib/picarones/jobs.sqlite
+# RGPD
 PICARONES_UPLOAD_RETENTION_DAYS=7
 PICARONES_LOG_IP_RETENTION_HOURS=24
 ```
 ```
 Les jobs `running` au moment du snapshot sont automatiquement
+marqués `interrupted` au redémarrage. Le tableau de
 bord sera donc cohérent.
 ## Migration de schéma BD
 - `picarones_uploads_size_bytes_total`
 - `picarones_engine_invocations_total{engine="..."}`
+Voir `docs/operations/observability.md`.
 ### Healthcheck
+Un endpoint `/health` minimal répond en < 50 ms
 sans toucher à la BD ni aux engines. Configurer le LB pour le
 cibler avec un timeout court (5 s).
 ---
+*Dernière mise à jour : 2 mai 2026.*

docs/operations/release-process.md CHANGED Viewed

@@ -1,10 +1,10 @@
 # Procédure de release
-> Sprint A9 du plan de remédiation institutionnelle
-> ([`docs/archive/2026-audits/remediation-plan.md`](../archive/2026-audits/remediation-plan.md)).
-> Étendu au Sprint S6 (déploiement institutionnel BnF).
-## Pré-requis avant tout tag (Sprint S6)
 | Vérif | Commande | Cible |
 |---|---|---|
@@ -20,7 +20,7 @@
 Pour un déploiement BnF (mode institutionnel), s'assurer que les
 variables d'environnement de production sont prêtes **avant** de
-tagger.  L'app refuse de démarrer sans (Sprint S6.9).
 | Variable | Public (HF Space) | Institutionnel |
 |---|---|---|
@@ -163,7 +163,7 @@ Checklist 30 min après la fin du workflow :
       sans erreur et expose `/health`.
 - [ ] La GitHub Release affiche bien les release notes attendues.
 - [ ] `cffconvert --validate` confirme que `CITATION.cff` cite la
-      bonne version (Sprint A12+).
 ## Annexe : rollback complet

 # Procédure de release
+> Procédure pour publier une release Picarones (PyPI + Docker + GitHub
+> Release).  Contexte historique :
+> [`docs/archive/2026-audits/remediation-plan.md`](../archive/2026-audits/remediation-plan.md).
+## Pré-requis avant tout tag
 | Vérif | Commande | Cible |
 |---|---|---|
 Pour un déploiement BnF (mode institutionnel), s'assurer que les
 variables d'environnement de production sont prêtes **avant** de
+tagger.  L'app refuse de démarrer sans.
 | Variable | Public (HF Space) | Institutionnel |
 |---|---|---|
       sans erreur et expose `/health`.
 - [ ] La GitHub Release affiche bien les release notes attendues.
 - [ ] `cffconvert --validate` confirme que `CITATION.cff` cite la
+      bonne version.
 ## Annexe : rollback complet

docs/operations/rollback.md CHANGED Viewed

@@ -1,7 +1,7 @@
 # Procédure de rollback
-> Sprint S6.11 — guide opérationnel pour rétrograder une version
-> Picarones en production institutionnelle.
 Audience : équipe ops BnF / autres institutions.

 # Procédure de rollback
+> Guide opérationnel pour rétrograder une version Picarones en
+> production institutionnelle.
 Audience : équipe ops BnF / autres institutions.

tests/architecture/test_doc_governance.py CHANGED Viewed

@@ -339,7 +339,7 @@ def test_mkdocs_nav_excludes_archive_subdirs() -> None:
 #: - quelques fichiers à la racine (README, GOVERNANCE, SECURITY).
 #:
 #: Cible : 0 (Phase 2 — convergence narrative, lot D9 à prévoir).
-ACTIVE_NARRATIVE_BASELINE = 75
 def test_no_active_doc_contains_sprint_narrative() -> None:

 #: - quelques fichiers à la racine (README, GOVERNANCE, SECURITY).
 #:
 #: Cible : 0 (Phase 2 — convergence narrative, lot D9 à prévoir).
+ACTIVE_NARRATIVE_BASELINE = 59
 def test_no_active_doc_contains_sprint_narrative() -> None: