veza/docs/RETROSPECTIVE_V0501.md

58 lines
2.6 KiB
Markdown
Raw Normal View History

# 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