0e7097ed1b
First-attempt commit3a5c6e184only 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 ofbec75f143(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 in3a5c6e184and remain in place — this commit does not modify .gitignore. Refs: AUDIT_REPORT.md §11
57 lines
2.6 KiB
Markdown
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
|