veza/veza-docs/ORIGIN/ORIGIN_REVISION_SUMMARY.md

232 lines
14 KiB
Markdown
Raw Normal View History

2026-03-05 18:22:31 +00:00
# ORIGIN_REVISION_SUMMARY.md
## Résumé de la Révision Éthique — 2026-03-04
**Version** : 2.0.0
**Date** : 4 mars 2026
**Auteur** : Architecte principal Veza
**Périmètre** : 20 fichiers ORIGIN révisés
**Raison** : Réaligner la documentation ORIGIN sur la vision réelle du projet et son éthique fondatrice
---
## 1. FEATURES SUPPRIMÉES
### Module 15 : IA & Fonctionnalités Avancées (F456-F470) — 15 features, ~480h
| ID | Feature | Raison éthique |
|----|---------|----------------|
| F456 | AI mastering | Déshumanise le processus créatif |
| F457 | Stem separation | Questions éthiques sur la propriété artistique |
| F458 | Auto BPM detection (ML) | Remplacé par déclaration manuelle du créateur |
| F459 | Auto key detection (ML) | Remplacé par déclaration manuelle du créateur |
| F460 | Genre detection ML | Biais de classification à grande échelle |
| F461 | Vocal removal AI | Tromperie des audiences |
| F462 | Audio denoising AI | Remplacé par outils tiers au choix du créateur |
| F463 | Audio upscaling AI | Remplacé par outils tiers au choix du créateur |
| F464 | Auto-tags ML | Remplacé par tags déclaratifs du créateur |
| F465 | Content ID (ML) | Remplacé par audio fingerprinting déterministe (ACRCloud) |
| F466 | Similarity detection ML | Optimise la rétention, pas la découverte |
| F467 | Recommendations ML | Remplacé par découverte éthique |
| F468 | Voice synthesis | Tromperie des audiences |
| F469 | Lyrics transcription auto | Remplacé par saisie manuelle |
| F470 | AI mixing assistant | Déshumanise le processus créatif |
### Module 18 : Blockchain & Web3 (F491-F500) — 10 features, ~400h
| ID | Feature | Raison éthique |
|----|---------|----------------|
| F491 | NFT minting | Fraudes, spéculation, détournement d'œuvres |
| F492 | Smart contracts | Complexité disproportionnée |
| F493 | Token economy | Spéculation |
| F494 | Staking rewards | Mécanisme spéculatif |
| F495 | NFT marketplace | Impact négatif sur artistes indépendants |
| F496 | Wallet integration | Complexité UX, barrière à l'entrée |
| F497 | IPFS storage | Consommation énergétique disproportionnée |
| F498 | DAO governance | Gouvernance biaisée par le capital |
| F499 | Crypto payments | Impact environnemental, volatilité |
| F500 | Royalty smart contracts | Remplacé par Hyperswitch |
### Module 21 : Gamification (F536-F550) — 15 features, ~280h
| ID | Feature | Raison éthique |
|----|---------|----------------|
| F536 | XP system | Transforme l'art en compétition |
| F537 | Level progression | Normalise les métriques de performance |
| F538 | Achievement system (XP) | Social validation loop addictive |
| F539 | Streaks | Habitude compulsive |
| F540 | Leaderboards popularité | Favorise les artistes établis |
| F541 | Points system | Gamification addictive |
| F542 | Challenges quotidiens | Obligation de connexion (FOMO) |
| F543 | Reward shop | Rétention artificielle |
| F544 | Social badges (followers) | Social validation loop |
| F545 | Performance badges | Normalise les métriques de performance |
| F546 | Streak notifications | FOMO, pression sociale |
| F547 | Progress bars | Mécanisme de compulsion |
| F548 | Daily login rewards | Habitude compulsive |
| F549 | Referral gamification | Marketing viral |
| F550 | Season pass | Rétention artificielle |
**Total supprimé** : 40 features, ~1 160 heures d'effort estimé
---
## 2. FEATURES MODIFIÉES
| Feature / Concept | Avant | Après | Raison |
|-------------------|-------|-------|--------|
| Algorithme de découverte | ML collaborative/content-based filtering | Règles explicites + curation éditoriale humaine | Optimiser la singularité, pas la rétention |
| Trending / Featured | Basé sur les plays/likes/engagement | Supprimé ou remplacé par curation éditoriale | Anti social validation loop |
| Analytics créateur | Métriques d'engagement plateforme | Données agrégées et anonymisées pour le créateur | Données au service du créateur, pas de la plateforme |
| Modération contenu | AI detection (NSFW, hate speech) | Règles déterministes + modération humaine | La décision finale est toujours humaine |
| Paiements | Stripe + PayPal + Crypto (futur) | Hyperswitch (open source, multi-provider) | Open source, pas de crypto |
| Relance panier | Emails agressifs (1h, 24h, 7j avec discounts) | Un seul email optionnel après 7j (si opt-in) | Anti dark patterns, anti FOMO |
| Notifications marketing | Recommandations produit, achievements | Digest hebdo, summary mensuel (opt-in) | Pas de recommandations comportementales |
| Badges profil | Badges de performance (plays, followers) | Badges de compétence déclaratifs uniquement | Seul le créateur définit ses compétences |
| Feed utilisateur | Algorithme feed basé sur l'engagement | Chronologique + curation + tags déclarés | Pas d'optimisation pour la rétention |
| Auto-modération | AI auto-detection | Règles déterministes (mots-clés, patterns) | Pas d'IA dans la modération |
| Recherche | Recherche par similarité audio (ML) | Elasticsearch fulltext + tags déclarés | Technologie, pas ML |
---
## 3. NOUVELLES SECTIONS AJOUTÉES
### Sections récurrentes (ajoutées dans plusieurs documents)
| Section | Documents concernés |
|---------|-------------------|
| **EXCLUSIONS ET RAISONS ÉTHIQUES** | BUSINESS_LOGIC, FEATURES_REGISTRY, DEVELOPMENT_PHASES, MASTER_ARCHITECTURE, TECHNICAL_STACK, DATABASE_SCHEMA, API_SPECIFICATION |
| **Principes d'architecture éthique** | MASTER_ARCHITECTURE |
| **Algorithme de découverte éthique** | FEATURES_REGISTRY, MASTER_ARCHITECTURE, API_SPECIFICATION |
### Sections spécifiques par document
| Document | Nouvelles sections |
|----------|-------------------|
| **ORIGIN_BUSINESS_LOGIC.md** | §0 Principes éthiques et modèle économique, §11 Exclusions, §12 Gouvernance |
| **ORIGIN_FEATURES_REGISTRY.md** | §29 Features exclues et raisons éthiques, §30 Algorithme de découverte éthique |
| **ORIGIN_DEVELOPMENT_PHASES.md** | §6 Phase 3.5 Consolidation & Sécurité, §7 Phase 4R Social & Live, §8 Phase 5R Analytics & Recherche Éthique, §9 Phase 6R Premium & Infrastructure, §10 Phases supprimées, §14 Exclusions |
| **ORIGIN_MASTER_ARCHITECTURE.md** | §1 Principes d'architecture éthique, §4 Découverte éthique, §13 Exclusions et raisons éthiques. ADR-011 (Hyperswitch), ADR-012 (Elasticsearch) |
| **ORIGIN_TECHNICAL_STACK.md** | §17 Stack de découverte musicale éthique, §18 Exclusions et raisons éthiques |
| **ORIGIN_SECURITY_FRAMEWORK.md** | §0 Corrections critiques (VEZA-SEC-001/002), §10 Sécurité et éthique des données, §12.4 Plan pentest externe, JWT RS256 migration |
| **ORIGIN_DATABASE_SCHEMA.md** | §17 Exclusions et raisons éthiques, §18 Politique de rétention des données, §19 Conformité GDPR |
| **ORIGIN_API_SPECIFICATION.md** | §7.9 Découverte éthique (6 endpoints), §7.10 Portabilité des données, §11 API Éthique, §12 Exclusions |
| **ORIGIN_CODE_STANDARDS.md** | §2 Standards éthiques du code, §9.3 Architecture Decision Records (ADR), §3.7 API Standards (pagination, context, error handling) |
| **ORIGIN_UI_UX_SYSTEM.md** | §13 Anti-patterns UX interdits, §14 Patterns UX positifs |
| **ORIGIN_PERFORMANCE_TARGETS.md** | §8.4 Plan de mesure consolidé (Prometheus, Lighthouse CI, k6, pg_stat_statements) |
| **ORIGIN_QUALITY_METRICS.md** | §6.4 Plan de réduction dette technique (DT-001 à DT-017), §7.1bis Quality gates à implémenter |
| **ORIGIN_TESTING_STRATEGY.md** | §13 Tests post-déploiement (smoke tests), §14 Tests algorithme de découverte, §15 Stratégie de test éthique (biais, accessibilité, GDPR) |
| **ORIGIN_DEPLOYMENT_GUIDE.md** | §13 Correctifs de sécurité prioritaires, §14 Checklist de déploiement éthique, §15 Plan migration JWT RS256 |
| **ORIGIN_ERROR_PATTERNS.md** | PAT-024 à PAT-028 (JWT mismatch, context propagation, goroutine leaks, pagination, error handling) |
| **ORIGIN_ERROR_PREVENTION_GUIDE.md** | §2.6 Audit prevention patterns (JWT validation, context propagation, goroutine lifecycle, pagination, error standardization) |
| **ORIGIN_ERROR_RESOLUTION_STRATEGY.md** | §8.3 Discovery bias, §8.4 JWT mismatch, §8.5 Error handling migration |
| **ORIGIN_FEATURE_VALIDATION_STRATEGY.md** | Phase 7 Validation éthique (checklist obligatoire), Métriques éthiques de succès |
| **ORIGIN_IMPLEMENTATION_TASKS.md** | Marquage ⛔ des tâches AI/Web3/Gamification, 30+ nouvelles tâches P0/P1 issues de l'audit |
| **ORIGIN_IMPLEMENTATION_TASKS_ARCHIVE.md** | Note de révision T0051-T0065 (Rust chat → Go obsolescence) |
---
## 4. COMPTE DE FEATURES RÉVISÉ
| Métrique | Avant (v1.0) | Après (v2.0) |
|----------|-------------|-------------|
| Features totales au registre | 600 | 560 |
| Features supprimées (éthique) | 0 | 40 |
| Features actives ciblées (roadmap) | 600 | ~490 |
| Heures estimées (total) | ~8 590h | ~7 430h |
| Heures économisées | — | ~1 160h |
| Phases de développement | 8 | 6 (P0-P3 + P3.5-P6R) |
| Modules actifs | 24 | 21 |
| Modules supprimés | 0 | 3 (AI, Web3, Gamification) |
---
## 5. CROSS-REFERENCES VÉRIFIÉES
Les cross-references suivantes ont été vérifiées et corrigées :
| Source | Référence | Action |
|--------|-----------|--------|
| DEVELOPMENT_PHASES → FEATURES_REGISTRY | Compteur features | Mis à jour 600 → 560 |
| DEVELOPMENT_PHASES → FEATURES_REGISTRY | Modules M15, M18, M21 | Marqués comme supprimés |
| MASTER_ARCHITECTURE → TECHNICAL_STACK | Chat Server Rust → Go | Corrigé (Go, pas Rust) |
| MASTER_ARCHITECTURE → TECHNICAL_STACK | Stripe → Hyperswitch | Corrigé |
| MASTER_ARCHITECTURE → TECHNICAL_STACK | Traefik → HAProxy | Corrigé |
| SECURITY_FRAMEWORK → IMPLEMENTATION_TASKS | VEZA-SEC-001/002 | Tâches correspondantes ajoutées |
| API_SPECIFICATION → FEATURES_REGISTRY | Endpoints AI/Web3/Gamification | Supprimés |
| DATABASE_SCHEMA → FEATURES_REGISTRY | Tables AI/Web3/Gamification | Supprimées |
| QUALITY_METRICS → AUDIT_TECHNIQUE | DT-001 à DT-017 | Plan de réduction documenté |
| IMPLEMENTATION_TASKS → AUDIT_TECHNIQUE | TASK-SEC-001 à 006, TASK-QA, TASK-DEBT | Ajoutés |
| DEPLOYMENT_GUIDE → SECURITY_FRAMEWORK | JWT RS256 migration | Documenté des deux côtés |
| TESTING_STRATEGY → ERROR_PATTERNS | Patterns audit PAT-024 à PAT-028 | Tests correspondants documentés |
| IMPLEMENTATION_TASKS_ARCHIVE → MASTER_ARCHITECTURE | ADR-002 Chat Go | Note ajoutée |
---
## 6. INCOHÉRENCES DÉTECTÉES
Les problèmes suivants ont été identifiés mais ne sont pas couverts par cette révision documentaire et nécessitent une validation humaine :
| # | Incohérence | Impact | Action recommandée |
|---|-------------|--------|-------------------|
| 1 | **Spotify OAuth pour import goûts musicaux (F007)** importe les préférences pour "recommandations" — le mot "recommandations" reste dans la description mais le mécanisme ML est supprimé | Faible | Clarifier que l'import Spotify sert à initialiser les genres/tags suivis, pas à alimenter un moteur ML |
| 2 | **Module 20 (Native Apps, F521-F535)** reste au registre mais Electron est abandonné d'après l'audit. La PWA est la stratégie mobile. | Moyen | Décider si ces features restent ou sont converties en features PWA |
| 3 | **F210 "Algorithme feed"** est listé comme Complexité 5/5 mais avec la curation humaine + chronologique, la complexité devrait être réduite | Faible | Réévaluer la complexité à 3/5 |
| 4 | **Module 9 (Hardware Mgmt, F306-F330)** reste au registre mais n'est dans aucune phase révisée | Faible | Planifier explicitement dans P6R ou reporter post-v1.0 |
| 5 | **Ancienne Phase 4 référençait "Recommandations personnalisées"** dans les objectifs Social — cette référence existait dans le document original et a été retirée | — | Résolu |
| 6 | **Revenue projections** ne chiffrent pas l'impact de la suppression des features AI/Web3 sur le MRR cible | Moyen | Ajuster les projections business avec le Product Owner |
| 7 | **Volume Discounts API** (§1.2 BUSINESS_LOGIC) fait référence à des tarifs enterprise qui ne sont pas dans la roadmap révisée | Faible | Confirmer si l'offre enterprise reste planifiée pour P6R |
---
## 7. PROCHAINES ÉTAPES RECOMMANDÉES
### Immédiat (semaine 1-2)
1. **Exécuter TASK-SEC-001 et TASK-SEC-002** — vulnérabilités critiques JWT ouvertes
2. **Protéger les routes /metrics** (TASK-SEC-006)
3. **Créer `.nvmrc` et `rust-toolchain.toml`** (TASK-QA-006)
4. **Review humaine** des incohérences listées en §6
### Phase 3.5 (Mars-Avril 2026)
5. **Implémenter les quality gates CI** (TASK-QA-001 à QA-005)
6. **Supprimer le code mort** (soundcloud/, webrtc.rs, k8s/chat-server/)
7. **Compléter le chat** (réactions, mentions, recherche)
8. **Migration JWT HS256 → RS256** (TASK-ARCH-001)
9. **Planifier le pentest externe** avant Phase 4R
### Continu
10. **Audit UX trimestriel** anti-dark-patterns
11. **Tests de biais algorithmique** dans la CI pour la découverte
12. **Mise à jour incrémentale** des documents ORIGIN au fil des livraisons
13. **ADR systématiques** pour tout changement architectural
### Post-révision documentaire
14. **Communiquer les changements** à l'équipe engineering
15. **Mettre à jour le README principal** du monorepo
16. **Créer le CONTRIBUTING.md** avec les standards éthiques
17. **Décider du sort du Module 20** (Native Apps → PWA ?)
---
## MÉTADONNÉES
| Champ | Valeur |
|-------|--------|
| **Documents révisés** | 20/20 |
| **Features supprimées** | 40 (F456-F470, F491-F500, F536-F550) |
| **Nouvelles sections ajoutées** | ~45 sections réparties sur 20 documents |
| **Tâches P0 ajoutées** | 6 (TASK-SEC-001 à 006) |
| **Tâches P1 ajoutées** | ~25 (TASK-QA, TASK-CHAT, TASK-EDU, TASK-MKT, TASK-DEBT, TASK-ARCH) |
| **Incohérences identifiées** | 7 (nécessitent validation humaine) |
| **Prochaines étapes** | 17 actions concrètes |
---
**Document créé par** : Architecte principal Veza
**Date** : 2026-03-04
**Ce document est la preuve d'audit de la révision éthique v2.0.0 de la documentation ORIGIN.**