veza/REPORT_BUGS.md

🐞 REPORT_BUGS.md - Anomalies & Dette Technique

🚨 Priorité P0 (Critique / Bloquant)

1. Le Chaos des UUIDs

• Symptôme: Présence de scripts de "fix" (fix-remaining-uuid-errors.sh, migrate-handlers-to-uuid.sh) et de migrations SQL explicites de conversion (047_migrate_users_id_to_uuid.sql).
• Risque: Incohérence de données. Si un service attend un INT et reçoit un UUID (ou vice-versa) via API ou DB, c'est le crash.
• Localisation: veza-backend-api, migrations/ root.

2. Schisme des Migrations DB

• Symptôme: veza-backend-api gère des tables comme users. veza-chat-server a aussi ses migrations.
• Risque: Qui possède la table users ? Si le chat server tente d'accéder à users avec une définition obsolète (ex: ID non-UUID), cela échouera.
• Preuve: veza-chat-server/sqlx-data.json vs veza-backend-api/migrations/*.sql.

⚠️ Priorité P1 (Conformité & Architecture)

3. Duplication Frontend

• Symptôme: apps/web (Stack Moderne: Zustand/Vite) vs veza-desktop (Stack Legacy: Redux/Electron).
• Impact: Double effort de développement pour chaque feature. Incohérence UI/UX garantie.

4. Duplication "Common" Rust

• Symptôme: Existence de veza-common ET veza-rust-common.
• Impact: Confusion pour les développeurs. Où mettre les types partagés ? Risque de dépendances circulaires ou de versions divergentes.

📉 Priorité P2 (Maintenance & Scripts)

5. Explosion de Scripts à la Racine

• Symptôme: Dossier scripts/ contenant tout et n'importe quoi (start-veza-complete.sh, start-veza-docker.sh, start-veza.sh...).
• Impact: On ne sait pas quel est le script de démarrage "officiel" de production.

6. Tests dispersés

• Symptôme: Tests dans tools/tests, tests/, fixtures/.
• Impact: Difficulté d'avoir un CI fiable et rapide.