senke/veza
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
veza/docs/GLOBAL_PROJECT_STATE_2026.md
senke ad60247f33 feat: global update including storybook setup and backend fixes 
- Web: Setup Storybook, added addons, configured Tailwind, added stories for UI components.
- Backend: Updated API router, database, workers, and auth in common.
- Stream Server: Removed SQLx queries and updated auth.
- Docs & Scripts: Updated documentation and recovery scripts.
2026-02-02 19:34:14 +01:00

3.8 KiB
Raw Blame History

🏥 Audit Global de l'État du Projet Veza (Février 2026)

Verdict Rapide : Le patient est en vie (il respire), mais il est sous assistance respiratoire ("Boot Mode"). L'architecture est solide mais encombrée par une dette technique visible (TODOs) et une documentation pléthorique qui frôle la saturation cognitive.

1. État de Fonctionnement (Runtime)

✅ Ce qui marche (Le Coeur)

  • Infrastructure Vitale : Postgres (5432) et Redis (6379) sont stables.
  • Backend API : Le serveur Go tourne sur le port 8080.
    • Route /health : OK (200).
    • Connexion DB : OK.
    • Migrations : Appliquées (001 à 931).
  • Frontend : Vite sert l'application sur le port 5173.
    • Build : Rapide (Hot Module Replacement actif).
    • Stack : React 18, TypeScript, Tailwind 4.

⛔ Ce qui est "Mort" (Volontairement)

Le mode VEZA_MODE=boot a amputé le système de ses membres complexes :

  • RabbitMQ : Éteint. Conséquence : Pas d'événements asynchrones.
  • ClamAV : Éteint. Conséquence : Sécurité des uploads = 0.
  • Chat & Stream Servers : Éteints. Conséquence : Les fonctionnalités "Core" (musique, chat) sont des coquilles vides.
  • S3 : Éteint. Conséquence : Stockage local uniquement.

2. Analyse du Codebase

🧠 Backend (veza-backend-api)

  • Architecture : Structure Go standard (cmd/, internal/) mais dense.
  • Dette Technique : 🚨 210+ TODOs/FIXMEs détectés.
    • Beacoup de "Refactor après stabilisation".
    • Des pans entiers de logique sont annotés comme "Legacy" ou "À migrer".
  • Points Forts :
    • Gestion de config robuste (godotenv, validation stricte).
    • Middleware structuré (Rate Limiting, CORS, Auth).
    • Instrumentation présente (Prometheus, Sentry).

🎨 Frontend (apps/web)

  • Modernité : Stack très à jour (Vite 7, Tailwind 4, Zuid/Zustand).
  • Complexité : Le package.json révèle une "usine à gaz" de tests :
    • 4 frameworks de tests différents : vitest, playwright, backstopjs, pa11y.
    • Cela indique une volonté de qualité extrême, mais potentiellement dure à maintenir.
  • Migration : Traces de migration d'interface (KODO_MIGRATION). Le Design System semble être en transition.

3. Documentation & Process

  • Surcharge Informationnelle : Le dossier docs/ contient 54 fichiers.
    • Il y a des audits de tout (migration, UI, backend, tests, transactions...).
    • ⚠️ Risque : Difficile de distinguer la "Vérité Terrain" de "l'Archive Historique".
  • Tests (TMT) : Une infrastructure de test sophistiquée (tmt) est en place, couvrant unitaires, intégration et E2E. C'est un actif majeur pour la stabilité future.

4. Recommandations "Chirurgicales"

Immédiat (Next 24h)

  1. Nettoyer la Vue : Archiver les vieux audits dans docs/archive/ pour ne garder que les specs actives.
  2. Tester le "Happy Path" : Puisque l'app tourne, vérifier manuellement l'inscription et la création de playlist pour valider le "Boot Mode".

Moyen Terme (Next Sprint)

  1. Réanimer un Membre : Réactiver RabbitMQ en priorité pour rétablir l'asynchronisme.
  2. Triage des TODOs : 200 TODOs, c'est trop. Il faut en supprimer 50% (obsolètes) et transformer les 50% restants en tickets Jira/Github.
  3. Stubber les Services Manquants : Au lieu de désactiver le Chat, créer un "Mock Server" simple qui répond 200 OK pour que l'UI ne tourne pas dans le vide.

Conclusion

Veza n'est pas un "MVP bricolé". C'est un système industriel complexe qui a été mis en pause. Le "Boot Mode" a permis de redémarrer le cœur. La prochaine étape n'est pas de "coder des features", mais de reconnecter les organes vitaux un par un.