37 lines
2 KiB
Markdown
37 lines
2 KiB
Markdown
|
# 🌍 REPORT_GLOBAL.md - Audit Général du Projet Veza
|
||
|
|
|
||
|
|
**Date:** 04/12/2025
|
||
|
|
**Auteur:** Staff Engineer / Architect
|
||
|
|
**Statut:** ⚠️ COMPLEXE / EN TRANSITION
|
||
|
|
|
||
|
|
## 1. Vue d'ensemble
|
||
|
|
Le projet **Veza** est une plateforme ambitieuse de streaming et collaboration musicale (600+ features visées).
|
||
|
|
L'architecture est **Microservices hybride (Go + Rust)** avec un frontend moderne.
|
||
|
|
|
||
|
|
Actuellement, le repo est dans un état de **transition critique** :
|
||
|
|
1. **Migration d'IDs:** Le passage de `INT` vers `UUID` est récent et laisse des traces partout (scripts de fix, migrations multiples).
|
||
|
|
2. **Fragmentation Frontend:** Deux applications majeures cohabitent (`veza-desktop` vs `apps/web`) avec des stacks technologiques divergentes.
|
||
|
|
3. **Dette Rust:** Deux bibliothèques communes (`veza-common` et `veza-rust-common`) existent en parallèle.
|
||
|
|
|
||
|
|
## 2. Note de Conformité "ORIGIN"
|
||
|
|
La vision cible (`veza_full_features_list.md` + `veza-docs/vision`) décrit une plateforme V6-V12.
|
||
|
|
L'état actuel correspond à une **V1 instable**.
|
||
|
|
|
||
|
|
| Domaine | État | Conformité "ORIGIN" |
|
||
|
|
| :--- | :--- | :--- |
|
||
|
|
| **Backend API** | 🟠 En transition | Stack Go respectée. Migration UUID en cours de stabilisation. |
|
||
|
|
| **Chat Server** | 🟢 Avancé | Stack Rust (Axum/Sqlx) conforme et riche. |
|
||
|
|
| **Stream Server** | 🟢 Avancé | Stack Rust (Axum/Symphonia) conforme. |
|
||
|
|
| **Frontend** | 🔴 Fragmenté | `apps/web` est moderne (Target). `veza-desktop` semble legacy. |
|
||
|
|
| **Infrastructure** | 🟠 Mixte | Beaucoup de scripts "home-made" dans `/scripts` vs Docker Compose standard. |
|
||
|
|
|
||
|
|
## 3. Chiffres Clés de l'Audit
|
||
|
|
* **300+** Fichiers de code source.
|
||
|
|
* **600** Features planifiées.
|
||
|
|
* **40+** Migrations SQL récentes sur le backend Go.
|
||
|
|
* **2** Stacks Frontend concurrentes.
|
||
|
|
* **2** Bibliothèques "Common" Rust.
|
||
|
|
|
||
|
|
## 4. Verdict
|
||
|
|
Le projet a un **potentiel technique énorme** (choix Go/Rust pertinents pour la performance). Cependant, la complexité accidentelle (doublons, migrations) menace la vélocité. Il faut impérativement **consolider avant d'ajouter des features**.
|