PD-55 — Retour d'expérience (REX)¶

1. Résumé exécutif¶

2. Métriques de convergence¶

2.1 Temps et itérations¶

2.2 Scores de convergence par gate¶

Pattern de convergence : Gate 3 a nécessité 3 itérations (spec blockchain complexe), Gate 5 en a nécessité 2, Gate 8 a passé du premier coup. Convergence progressive attendue pour une story de complexité élevée.

2.3 Écarts par catégorie¶

3. Points fluides¶

• Étape 6 (implémentation) : Le DAG de 17 tâches a été exécuté sans blocage majeur. La décomposition en 9 niveaux de parallélisation était précise.
• Gate 8 : Passage au premier coup (8.00/10 uniforme sur les 4 critères). L'acceptabilité v2 post-corrections a bien préparé le terrain.
• Pipeline CI : Migration, tests, lint, Sonar — tout validé en CI après corrections post-Gate 8.
• Learnings injection : Les learnings PD-44, PD-40 et BATCH-RETRO injectés en amont ont évité certaines erreurs (canonicalisation RFC 8785 mentionnée dès la spécification).

4. Points de friction¶

• Gate 3 — 3 itérations : La spécification initiale manquait de précision sur l'ordre canonique, le format de preuve externe et le standard de canonicalisation. Ces manques sont typiques des stories blockchain/crypto qui nécessitent un niveau de formalisme élevé.
• Migration PostgreSQL : L'index partiel avec subquery (WHERE batch_id IN (SELECT ...)) n'est pas supporté par PostgreSQL. Détecté uniquement en CI (pipeline migrate:test-db), pas en local. Coût : 1 commit de correction + 1 re-run pipeline.
• Coverage branches : Le seuil global de 80% branches a été atteint de justesse (80.02%) en ajoutant 29 tests pour couvrir les branches manquantes des services PD-55. Le code PD-55 était à ~71-77% branches avant optimisation.
• Sonar deprecated API : 2 violations Sonar (BullMQ getRepeatableJobs/removeRepeatableByKey deprecated en v5). Détecté uniquement par Sonar QG en CI, pas par lint local.
• CloudHSM cluster down : Blocage transitoire de ~3h sur tous les pipelines du backend. Non lié au code PD-55 mais a retardé la validation.
• Acceptabilité v1 → v2 : 5 écarts code MAJEURS et 3 vulnérabilités CRITIQUES identifiés par les reviews LLM. Tous corrigés avant Gate 8. Le ratio faux positifs des reviews LLM reste élevé (~30-40%).

5. Invariants vérifiés¶

6. Code livré vs plan¶

6.1 Fichiers créés¶

6.2 Écarts plan/implémentation¶

• blockchain-adapter.service.ts : STUB comme prévu (dépendance PD-52). Fonctions implémentées avec mocks internes.
• 2 suites de tests supplémentaires non prévues : anchor-alert.service.spec.ts et blockchain-adapter.service.spec.ts (ajoutées post-Gate 8 pour coverage).
• Migration corrigée post-Gate 8 : subquery index → UNIQUE simple (PostgreSQL ne supporte pas les subqueries dans les index partiels).

7. Complexité technique¶

8. Faux positifs des reviews LLM¶

Causes identifiées : - Contexte partiel dans les prompts (les LLM n'ont pas accès au code complet) - Confusion entre concepts similaires (confirmation vs finalité) - Analyse sans connaissance des stubs/dépendances futures (PD-52)

9. Corrections post-Gate 8¶

Impact : 3 pipelines nécessaires pour atteindre le vert. Aucune modification de logique métier.

10. Améliorations de processus suggérées¶

10.1 Haute priorité¶

Fichier : templates/prompts/9 Retour d'expérience.md Amélioration : Ajouter section "Corrections post-Gate 8" dans le template REX. Les corrections post-merge (migration, coverage, Sonar) ne sont pas prévues par le template actuel.

10.2 Moyenne priorité¶

Fichier : CLAUDE.md (section "Étape 6") Amélioration : Ajouter une règle pour valider les migrations PostgreSQL localement avant push. Les subqueries dans les index partiels ne sont pas détectables par TypeScript ou ESLint — seul un pg_dump --schema-only ou un typeorm migration:run en local peut les détecter.

10.3 Basse priorité¶

Pattern : Le ratio faux positifs des reviews LLM (30-40%) est stable depuis PD-44. Amélioration potentielle : injecter plus de contexte dans les prompts de review (stubs connus, dépendances futures documentées).

11. Métriques COMPOUNDER¶

{"story":"PD-55","project":"backend","domain":"blockchain","title":"Créer worker ancrage blockchain périodique","completed_at":"2026-02-23","total_time_hours":17.5,"gate_iterations":{"gate3":3,"gate5":2,"gate8":1},"convergence_scores":{"gate3_final":8.18,"gate5_final":8.38,"gate8_final":8.00},"deviations":{"ECT":9,"DIV":6,"AMB":8,"SEC":3,"PERF":0},"complexity":"complex"}

12. Learnings consolidés¶

• [Blockchain Anchor] PostgreSQL ne supporte pas les subqueries dans les WHERE des index partiels — valider les migrations avec typeorm migration:run en local avant push.
• [BullMQ v5] getRepeatableJobs/removeRepeatableByKey deprecated — utiliser getJobSchedulers/removeJobScheduler. Sonar détecte ces violations mais pas ESLint.
• [Coverage CI] Le seuil global de 80% branches est fragile — chaque nouvelle story doit viser ≥85% branches pour ne pas faire tomber le global sous 80%.
• [Gate convergence] Les stories blockchain/crypto nécessitent typiquement 3 itérations de Gate 3 — le formalisme requis (canonicalisation, formats de preuve, standards RFC) n'est pas couvert par les spécifications initiales.