veza/docs/archive/v0-history/RETROSPECTIVE_V0501.md
senke 7c9eece09a
Some checks failed
Backend API CI / test-unit (push) Has been cancelled
Backend API CI / test-integration (push) Has been cancelled
Veza CI / Rust (Stream Server) (push) Has been cancelled
Veza CI / Backend (Go) (push) Has been cancelled
Veza CI / Notify on failure (push) Has been cancelled
Veza CI / Frontend (Web) (push) Has been cancelled
Frontend CI / test (push) Has been cancelled
Security Scan / Secret Scanning (gitleaks) (push) Has been cancelled
chore(cleanup): J1 — purge 220MB debris, archive session docs (complete)
First-attempt commit 02728909f only captured the .gitignore change; the
pre-commit hook silently dropped the 343 staged moves/deletes during
lint-staged's "no matching task" path. This commit re-applies the intended
J1 content on top of 24af2f72b (which was pushed in parallel).

Uses --no-verify because:
- J1 only touches .md/.json/.log/.png/binaries — zero code that would
  benefit from lint-staged, typecheck, or vitest
- The hook demonstrated it corrupts pure-rename commits in this repo
- Explicitly authorized by user for this one commit

Changes (343 total: 169 deletions + 174 renames):

Binaries purged (~167 MB):
- veza-backend-api/{server,modern-server,encrypt_oauth_tokens,seed,seed-v2}

Generated reports purged:
- 9 apps/web/lint_report*.json (~32 MB)
- 8 apps/web/tsc_*.{log,txt} + ts_*.log (TS error snapshots)
- 3 apps/web/storybook_*.json (1375+ stored errors)
- apps/web/{build_errors*,build_output,final_errors}.txt
- 70 veza-backend-api/coverage*.out + coverage_groups/ (~4 MB)
- 3 veza-backend-api/internal/handlers/*.bak

Root cleanup:
- 54 audit-*.png (visual regression baselines, ~11 MB)
- 9 stale MVP-era scripts (Jan 27, hardcoded v0.101):
  start_{iteration,mvp,recovery}.sh,
  test_{mvp_endpoints,protected_endpoints,user_journey}.sh,
  validate_v0101.sh, verify_logs_setup.sh, gen_hash.py

Session docs archived (not deleted — preserved under docs/archive/):
- 78 apps/web/*.md     → docs/archive/frontend-sessions-2026/
- 43 veza-backend-api/*.md → docs/archive/backend-sessions-2026/
- 53 docs/{RETROSPECTIVE_V,SMOKE_TEST_V,PLAN_V0_,V0_*_RELEASE_SCOPE,
          AUDIT_,PLAN_ACTION_AUDIT,REMEDIATION_PROGRESS}*.md
                        → docs/archive/v0-history/

README.md and CONTRIBUTING.md preserved in apps/web/ and veza-backend-api/.

Note: The .gitignore rules preventing recurrence were already pushed in
02728909f and remain in place — this commit does not modify .gitignore.

Refs: AUDIT_REPORT.md §11
2026-04-14 17:12:03 +02:00

57 lines
2.6 KiB
Markdown

# Rétrospective v0.501 — Phase 5 : Streaming & Cloud
**Date** : 2026-02-22
**Durée** : 6 sprints, 44 tâches
## Scores comparatifs
| Domaine | Avant (v0.404) | Après (v0.501) | Variation |
|---------|---------------|----------------|-----------|
| Streaming | 36% | 55% | +19% |
| Cloud Storage | 0% | 30% | +30% |
| Gear | 40% | 60% | +20% |
| Maturité globale | 3/10 | 5/10 | +2 |
| Features E2E testées | 14 | 22 | +8 |
| Migrations | 102 | 108 | +6 |
## Ce qui a bien fonctionné
1. **Architecture modulaire** : Le découpage en sprints clairs (infra → streaming → cloud backend → cloud frontend + gear → intégration → finalisation) a permis un développement séquentiel sans blocage.
2. **Réutilisation du S3StorageService** : Le service S3 existant a été étendu (ajout `DownloadFile`) et réutilisé pour le cloud storage et les waveforms sans refactoring majeur.
3. **Pattern Storybook-first** : Les composants Cloud et Gear ont été développés avec leurs stories dès le départ, facilitant la validation visuelle.
4. **Multi-bitrate HLS** : La transition de 5 profils (32k-320k) à 3 profils ciblés (128k-256k-320k) simplifie l'infrastructure sans sacrifier la qualité.
5. **Tests E2E** : Les tests d'intégration vérifient la cohérence des protections d'authentification sur tous les nouveaux endpoints.
## Points d'attention
1. **Cloud Storage MVP** : Le streaming de fichiers charge entièrement le fichier en mémoire via `DownloadFile`. Pour la production avec des fichiers > 100MB, un streaming S3 direct (presigned URL ou proxy byte-range) sera nécessaire.
2. **Waveform fallback** : Le fallback FFmpeg (quand `audiowaveform` n'est pas installé) produit des données brutes qui peuvent être volumineuses. Envisager un downsampling plus agressif.
3. **Gear images** : Les endpoints d'upload d'images sont des stubs. L'intégration complète avec S3 et la gestion des miniatures reste à faire.
4. **Publish from Cloud** : L'endpoint `/cloud/files/:id/publish` retourne les métadonnées du fichier mais ne crée pas encore de track automatiquement. Le pipeline complet (copie S3 → création track → transcoding) est à finaliser.
## Métriques de livraison
| Métrique | Valeur |
|----------|--------|
| Fichiers créés | ~45 |
| Fichiers modifiés | ~30 |
| Lignes ajoutées | ~5000 |
| Nouveaux composants React | 8 |
| Nouvelles stories Storybook | 15+ |
| Nouveaux endpoints API | 15 |
| Tests ajoutés | 22+ |
| Migrations SQL | 6 |
## Prochaines étapes (v0.502)
- Réécriture du chat server Rust en Go (ADR-002)
- WebSocket handler Go natif
- Migration transparente des clients existants
- Tests de latence < 100ms