# V0.601 Release Scope — Phase 6 : Production Readiness & Commerce

**Statut** : En planification
**Phase** : 6 — Production & Commerce
**Prérequis** : v0.503 (taguée)
**Date cible** : TBD
**Estimation** : ~6 sprints (30 jours ouvrés)
**Précédente** : [v0.503](archive/V0_503_RELEASE_SCOPE.md)

---

## 1. Objectif

Rendre la plateforme prête pour un déploiement production fiable (blue-green, monitoring), finaliser la boucle commerce (reviews, factures, remboursements), implémenter OAuth Discord/Spotify, et réduire la dette technique structurante (découpage fichiers, consolidation migrations).

---

## 2. État actuel (pré-v0.601)

| Composant | État | Détail |
|-----------|------|--------|
| **Déploiement** | ⚠️ Rolling simple | Pas de blue-green, pas de rollback rapide |
| **Monitoring** | ⚠️ Prometheus + alertes | Pas de dashboards Grafana prêts |
| **Commerce** | ⚠️ Checkout + promos | Pas de reviews, factures, remboursements |
| **OAuth** | ⚠️ Google, GitHub | Discord, Spotify non implémentés |
| **Hyperswitch** | ⚠️ Mode test | Production mode non activé |
| **Dette** | ⚠️ Fichiers > 1000 LOC | handler.go (track) ~1463 LOC, interceptors.ts ~1207 LOC |
| **Migrations** | ⚠️ 113+ fichiers | Pas de baseline consolidée |

---

## 3. Lots

### Lot INF1 — Infrastructure Production

**Objectif** : Déploiement blue-green et monitoring opérationnel.

| # | Tâche | Fichiers impactés | Effort |
|---|-------|--------------------|--------|
| INF1-01 | Blue-green deployment — configurer HAProxy/Caddy pour deux backends (blue/green), health checks, bascule manuelle ou automatique | `config/haproxy/`, `config/caddy/`, `docker-compose.prod.yml`, scripts deploy | L |
| INF1-02 | Dashboards Grafana — créer 3 dashboards : API (latence, erreurs, throughput), Chat (connexions WS, messages/s), Commerce (orders, checkout) | `config/grafana/dashboards/` | M |
| INF1-03 | Alertmanager — configurer notifications (email/webhook Slack) pour les alertes Prometheus critiques | `config/alertmanager/` | S |
| INF1-04 | Graceful shutdown — s'assurer que le backend Go et le stream server gèrent SIGTERM (drain connexions, fin des jobs en cours) | `cmd/api/main.go`, `veza-stream-server/src/main.rs` | M |
| INF1-05 | Health check enrichi — `GET /api/v1/health` retourne status DB, Redis, RabbitMQ (degraded si un service down) | `internal/handlers/health.go` | S |

### Lot COM1 — Commerce Finalisation

**Objectif** : Reviews produits, factures PDF, remboursements. Payout reporté si Stripe Connect complexe.

| # | Tâche | Fichiers impactés | Effort |
|---|-------|--------------------|--------|
| COM1-01 | **Reviews produits** — migration `product_reviews`, CRUD, notation 1-5, commentaire, GET /products/:id/reviews, affichage moyenne | `migrations/`, `internal/handlers/`, `internal/models/`, frontend ProductDetail | M |
| COM1-02 | **Factures PDF** — génération PDF par commande (template, numéro facture, items, total, TVA), GET /orders/:id/invoice, téléchargement | `internal/services/invoice_service.go`, lib PDF (gofpdf ou similar), frontend OrdersView | M |
| COM1-03 | **Remboursements** — POST /orders/:id/refund (vendeur/admin), appel Hyperswitch refund API, webhook refund, mise à jour order + révocation licence | `internal/handlers/`, `internal/services/`, Hyperswitch client | M |
| COM1-04 | **Hyperswitch production** — config pour passer en mode live (HYPERSWITCH_LIVE_MODE), validation webhook signature stricte, documentation | `internal/config/`, `internal/services/hyperswitch/` | S |
| COM1-05 | **MSW + Stories** — handlers commerce enrichis, stories ProductReviews, InvoiceDownload, RefundButton | `apps/web/src/mocks/`, `apps/web/src/features/` | S |

### Lot AUTH1 — OAuth Discord & Spotify

**Objectif** : Implémenter les providers OAuth manquants (actuellement stub).

| # | Tâche | Fichiers impactés | Effort |
|---|-------|--------------------|--------|
| AUTH1-01 | OAuth Discord — config provider, scopes (identify, email), callback, mapping user Discord → Veza | `internal/services/oauth_service.go`, config, frontend OAuthButton | M |
| AUTH1-02 | OAuth Spotify — config provider, scopes (user-read-email), callback, mapping | Idem | M |
| AUTH1-03 | Tests — vérifier flux register/login via Discord et Spotify | `internal/services/oauth_*_test.go` | S |
| AUTH1-04 | FEATURE_STATUS — mettre à jour OAuth Discord/Spotify de "non implémenté" à "opérationnel" | `docs/FEATURE_STATUS.md` | S |

### Lot CLN1 — Dette Technique Structurante

**Objectif** : Réduire la complexité des fichiers les plus longs et consolider les migrations.

| # | Tâche | Fichiers impactés | Effort |
|---|-------|--------------------|--------|
| CLN1-01 | **Découper handler.go** (~1463 LOC) — extraire en sous-handlers : track_crud_handler.go, track_social_handler.go, track_search_handler.go, track_analytics_handler.go. Garder facade. | `internal/core/track/` | L |
| CLN1-02 | **Découper interceptors.ts** (~1200 LOC) — extraire par responsabilité : auth interceptor, error interceptor, retry interceptor, logging. | `apps/web/src/services/api/` | M |
| CLN1-03 | **Consolidation migrations** — script `scripts/squash_migrations.sh` générant une baseline SQL à partir des 113 migrations. Documenter dans `docs/MIGRATIONS.md`. Ne PAS supprimer les migrations existantes. | `scripts/`, `docs/MIGRATIONS.md` | M |
| CLN1-04 | **Audit console.log** — remplacer les `console.log` en production par le logger frontend. Garder uniquement les logs intentionnels. | `apps/web/src/` | S |

### Lot QA1 — Tests & Documentation

**Objectif** : Valider l'ensemble, mettre à jour la documentation.

| # | Tâche | Fichiers impactés | Effort |
|---|-------|--------------------|--------|
| QA1-01 | Tests E2E commerce — upload → achat → review → facture → remboursement (si applicable) | `veza-backend-api/internal/integration/` ou Playwright | M |
| QA1-02 | Smoke test v0.601 — checklist 25+ features E2E | `docs/SMOKE_TEST_V0601.md` | S |
| QA1-03 | Mise à jour PROJECT_STATE.md, FEATURE_STATUS.md, CHANGELOG.md | `docs/` | S |
| QA1-04 | Archiver V0_601_RELEASE_SCOPE.md, créer placeholder V0_602_RELEASE_SCOPE.md | `docs/archive/`, `docs/` | S |
| QA1-05 | Rétrospective v0.601 | `docs/RETROSPECTIVE_V0601.md` | S |
| QA1-06 | Tag v0.601 | Git | S |

---

## 4. Hors scope v0.601

| Élément | Version cible |
|---------|---------------|
| Payout vendeurs (Stripe Connect) | v0.602 (si COM1 trop chargé) |
| Migration React 19 | v0.602 |
| Go Live (streaming vidéo) | v0.703 |
| 2FA SMS / Passkeys | v0.104 |
| IaC (Terraform/Pulumi) | v0.801 |

---

## 5. Fichiers impactés (récapitulatif)

### Backend Go (nouveau)

| Fichier | Action |
|---------|--------|
| `internal/services/invoice_service.go` | Nouveau — génération PDF |
| `internal/handlers/track_crud_handler.go` | Nouveau — extrait de track_handler |
| `internal/handlers/track_upload_handler.go` | Nouveau |
| `internal/handlers/track_hls_handler.go` | Nouveau |
| `internal/handlers/track_waveform_handler.go` | Nouveau |
| `migrations/114_product_reviews.sql` | Nouveau (ou numéro suivant) |

### Backend Go (modifier)

| Fichier | Action |
|---------|--------|
| `internal/handlers/health.go` | Enrichir health check |
| `internal/core/track/handler.go` | Réduire à facade |
| `internal/services/oauth_service.go` | Ajouter Discord, Spotify |
| `internal/handlers/marketplace_handler.go` | Reviews, refund |
| `cmd/api/main.go` | Graceful shutdown |

### Frontend (nouveau/modifier)

| Fichier | Action |
|---------|--------|
| `apps/web/src/services/api/interceptors.ts` | Découper |
| `apps/web/src/features/commerce/` | Reviews, Invoice, Refund UI |
| `apps/web/src/mocks/handlers-commerce.ts` | Enrichir |

### Infra

| Fichier | Action |
|---------|--------|
| `config/haproxy/` | Blue-green config |
| `config/grafana/dashboards/` | 3 dashboards |
| `config/alertmanager/` | Notifications |
| `scripts/squash_migrations.sh` | Nouveau |

---

## 6. Critères d'acceptation globaux

- [ ] Déploiement blue-green opérationnel (documenté, testé)
- [ ] 3 dashboards Grafana déployés et alimentés
- [ ] Reviews produits : création, affichage, moyenne
- [ ] Facture PDF téléchargeable par commande
- [ ] Remboursement initiable (vendeur/admin), webhook traité
- [ ] OAuth Discord et Spotify fonctionnels
- [ ] handler.go (track) < 500 LOC (logique extraite)
- [ ] interceptors.ts < 400 LOC (découpage)
- [ ] Script squash migrations documenté
- [ ] Tag v0.601 créé

---

## 7. Risques

| Risque | Mitigation |
|--------|------------|
| Stripe Connect / Payout trop complexe | Reporter en v0.602, focus sur reviews/factures/remboursements |
| Génération PDF lourde | Utiliser lib légère (gofpdf), génération async si besoin |
| Blue-green nécessite 2x ressources | Documenter option "rolling" si ressources limitées |
| OAuth Discord/Spotify quotas API | Documenter limites, rate limiting côté provider |