43af35fd93
- Archiver 131 .md dans docs/archive/root-md/ - Archiver 22 .json dans docs/archive/root-json/ - Conserver 7 .md utiles (README, CONTRIBUTING, CHANGELOG, etc.) - Conserver package.json, package-lock.json, turbo.json - Ajouter README d'index dans chaque archive
502 lines
15 KiB
Markdown
502 lines
15 KiB
Markdown
# 🎯 PROMPT CURSOR : Audit Intégration Backend/Frontend + Nouvelle TodoList JSON
|
|
|
|
## 📋 INSTRUCTIONS POUR CURSOR
|
|
|
|
Copie ce prompt complet dans Cursor pour lancer l'audit et générer la nouvelle todolist.
|
|
|
|
---
|
|
|
|
## 🚀 LE PROMPT À COPIER
|
|
|
|
```markdown
|
|
# MISSION : Audit Complet Intégration Backend/Frontend Veza + TodoList JSON
|
|
|
|
Tu es un expert en intégration full-stack. Ta mission est de scanner EXHAUSTIVEMENT le codebase Veza pour :
|
|
1. Générer un rapport ULTRA-DÉTAILLÉ de l'état d'intégration backend/frontend
|
|
2. Créer une nouvelle TodoList JSON PARFAITE focalisée uniquement sur la connexion backend/frontend
|
|
|
|
## 🚫 SCOPE EXCLUSIONS
|
|
- **IGNORER COMPLÈTEMENT** : `veza-chat-server/` (Rust)
|
|
- **IGNORER COMPLÈTEMENT** : `veza-stream-server/` (Rust)
|
|
- **IGNORER** : Tout ce qui concerne WebSocket Rust
|
|
- **FOCUS UNIQUEMENT** : `apps/web/` ↔ `veza-backend-api/`
|
|
|
|
## 📂 FICHIERS À SCANNER
|
|
|
|
### Backend Go (`veza-backend-api/`)
|
|
```
|
|
veza-backend-api/
|
|
├── internal/
|
|
│ ├── api/router.go # TOUTES les routes définies
|
|
│ ├── handlers/*.go # TOUS les handlers
|
|
│ ├── dto/*.go # TOUS les DTOs (request/response)
|
|
│ ├── models/*.go # TOUS les modèles
|
|
│ ├── middleware/*.go # CORS, Auth, CSRF, etc.
|
|
│ └── config/config.go # Configuration
|
|
├── cmd/server/main.go # Point d'entrée
|
|
└── .env.example # Variables d'environnement
|
|
```
|
|
|
|
### Frontend React (`apps/web/`)
|
|
```
|
|
apps/web/src/
|
|
├── services/
|
|
│ ├── api/client.ts # Client API principal
|
|
│ ├── api/*.ts # Tous les services API
|
|
│ └── *.ts # Anciens services (duplication?)
|
|
├── features/
|
|
│ ├── auth/api/*.ts # API auth
|
|
│ ├── auth/store/*.ts # Store auth
|
|
│ ├── tracks/api/*.ts # API tracks
|
|
│ ├── playlists/services/*.ts # Services playlists
|
|
│ └── */ # Autres features
|
|
├── stores/*.ts # Stores globaux (duplication?)
|
|
├── types/*.ts # Types TypeScript
|
|
├── lib/apiClient.ts # Ancien client API?
|
|
├── config/
|
|
│ ├── env.ts # Variables d'environnement
|
|
│ └── constants.ts # Constantes API
|
|
└── hooks/api/*.ts # Hooks API
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 PHASE 1 : GÉNÉRATION DU RAPPORT
|
|
|
|
Crée un fichier `INTEGRATION_AUDIT_REPORT_2025.md` avec :
|
|
|
|
### 1.1 Executive Summary
|
|
- Score global /10
|
|
- Nombre d'endpoints backend total
|
|
- Nombre d'endpoints utilisés par frontend
|
|
- Nombre d'endpoints manquants côté frontend
|
|
- Nombre d'appels frontend sans endpoint backend
|
|
- Nombre d'incohérences de types
|
|
|
|
### 1.2 Analyse des Endpoints - TABLEAU EXHAUSTIF
|
|
|
|
Pour CHAQUE route dans `router.go`, génère :
|
|
|
|
```markdown
|
|
| Endpoint Backend | Handler | Frontend Service | Frontend Hook | Types Alignés | Status |
|
|
|------------------|---------|------------------|---------------|---------------|--------|
|
|
| GET /api/v1/auth/me | GetMe | authApi.getMe() | useAuth | ✅ | OK |
|
|
| POST /api/v1/tracks | CreateTrack | trackApi.create() | useTracks | ⚠️ ID type | PARTIEL |
|
|
| ... | ... | ... | ... | ... | ... |
|
|
```
|
|
|
|
### 1.3 Analyse des Incohérences de Types
|
|
|
|
Pour CHAQUE type partagé, compare :
|
|
|
|
```markdown
|
|
| Type | Backend Go (DTO) | Frontend TS | Différences | Impact |
|
|
|------|------------------|-------------|-------------|--------|
|
|
| User.id | uuid.UUID (string) | string | number dans certains composants | 🔴 CRITIQUE |
|
|
| Track.status | string | enum TrackStatus | Valeurs différentes | ⚠️ MOYEN |
|
|
| ... | ... | ... | ... | ... |
|
|
```
|
|
|
|
### 1.4 Analyse des Clients API
|
|
|
|
Identifie TOUS les clients/services API :
|
|
|
|
```markdown
|
|
| Fichier | Type | Utilisé par | Problèmes |
|
|
|---------|------|-------------|-----------|
|
|
| services/api/client.ts | Axios + interceptors | Nouveau code | ✅ OK |
|
|
| lib/apiClient.ts | Axios basic | Ancien code? | ⚠️ Duplication |
|
|
| ... | ... | ... | ... |
|
|
```
|
|
|
|
### 1.5 Analyse des Stores
|
|
|
|
Identifie TOUS les stores liés à l'auth/state API :
|
|
|
|
```markdown
|
|
| Store | Fichier | Utilisé | Duplication avec |
|
|
|-------|---------|---------|------------------|
|
|
| authStore | features/auth/store/authStore.ts | ✅ | stores/auth.ts? |
|
|
| ... | ... | ... | ... |
|
|
```
|
|
|
|
### 1.6 Analyse CORS/CSRF/Security
|
|
|
|
```markdown
|
|
| Aspect | Backend Config | Frontend Config | Aligné | Problème |
|
|
|--------|----------------|-----------------|--------|----------|
|
|
| CORS Origins | CORS_ALLOWED_ORIGINS | - | ⚠️ | Vide = bloqué |
|
|
| CSRF Token | X-CSRF-Token header | csrfService.ts | ⚠️ | Redis requis |
|
|
| ... | ... | ... | ... | ... |
|
|
```
|
|
|
|
### 1.7 Analyse Format Réponses API
|
|
|
|
```markdown
|
|
| Endpoint | Backend Response | Frontend Attend | Transformé par | OK |
|
|
|----------|------------------|-----------------|----------------|-----|
|
|
| POST /auth/login | {success, data: {access_token...}} | {access_token...} | Interceptor unwrap | ✅ |
|
|
| ... | ... | ... | ... | ... |
|
|
```
|
|
|
|
### 1.8 Problèmes Identifiés (Liste Exhaustive)
|
|
|
|
```markdown
|
|
## 🔴 CRITIQUES (Bloquent production)
|
|
1. [CORS-001] CORS_ALLOWED_ORIGINS vide en production = rejet total
|
|
- Fichier: veza-backend-api/internal/middleware/cors.go
|
|
- Impact: Application inaccessible
|
|
|
|
2. [TYPE-001] User.id: number vs string dans certains composants
|
|
- Fichiers: apps/web/src/types/user.ts, components/*.tsx
|
|
- Impact: Erreurs runtime
|
|
|
|
## ⚠️ MAJEURS (Fonctionnent mais fragiles)
|
|
...
|
|
|
|
## 🟡 MINEURS (Dettes techniques)
|
|
...
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 PHASE 2 : GÉNÉRATION DE LA TODOLIST JSON
|
|
|
|
Crée un fichier `VEZA_INTEGRATION_PERFECTION_TODOLIST.json` avec cette structure EXACTE :
|
|
|
|
```json
|
|
{
|
|
"meta": {
|
|
"title": "Veza Integration Perfection TodoList",
|
|
"description": "TodoList focalisée exclusivement sur la connexion parfaite Backend Go ↔ Frontend React",
|
|
"generated_at": "2025-12-25T00:00:00Z",
|
|
"scope": {
|
|
"included": ["apps/web/", "veza-backend-api/"],
|
|
"excluded": ["veza-chat-server/", "veza-stream-server/", "veza-common/"]
|
|
},
|
|
"target": "Score intégration 10/10 - Connexion parfaite",
|
|
"current_score": "6.5/10",
|
|
"target_score": "10/10"
|
|
},
|
|
"summary": {
|
|
"by_priority": {
|
|
"P0_blocker": 0,
|
|
"P1_critical": 0,
|
|
"P2_major": 0,
|
|
"P3_minor": 0
|
|
},
|
|
"by_category": {
|
|
"INT-CORS": 0,
|
|
"INT-AUTH": 0,
|
|
"INT-TYPE": 0,
|
|
"INT-API": 0,
|
|
"INT-ENDPOINT": 0,
|
|
"INT-CLEANUP": 0,
|
|
"INT-TEST": 0,
|
|
"INT-DOC": 0
|
|
},
|
|
"by_side": {
|
|
"backend_only": 0,
|
|
"frontend_only": 0,
|
|
"both_sides": 0
|
|
},
|
|
"estimated_total_hours": 0
|
|
},
|
|
"categories": {
|
|
"INT-CORS": "Configuration CORS et origins",
|
|
"INT-AUTH": "Authentification et tokens",
|
|
"INT-TYPE": "Alignement des types TypeScript/Go",
|
|
"INT-API": "Client API et services",
|
|
"INT-ENDPOINT": "Endpoints manquants ou incohérents",
|
|
"INT-CLEANUP": "Nettoyage duplication et legacy code",
|
|
"INT-TEST": "Tests d'intégration E2E",
|
|
"INT-DOC": "Documentation API"
|
|
},
|
|
"phases": [
|
|
{
|
|
"id": "PHASE-INT-1",
|
|
"name": "Blockers Production",
|
|
"description": "Problèmes qui empêchent le déploiement en production",
|
|
"priority": "P0",
|
|
"estimated_hours": 0,
|
|
"tasks": []
|
|
},
|
|
{
|
|
"id": "PHASE-INT-2",
|
|
"name": "Critical Fixes",
|
|
"description": "Problèmes qui causent des erreurs ou comportements incorrects",
|
|
"priority": "P1",
|
|
"estimated_hours": 0,
|
|
"tasks": []
|
|
},
|
|
{
|
|
"id": "PHASE-INT-3",
|
|
"name": "Type Alignment",
|
|
"description": "Alignement parfait des types entre backend et frontend",
|
|
"priority": "P1",
|
|
"estimated_hours": 0,
|
|
"tasks": []
|
|
},
|
|
{
|
|
"id": "PHASE-INT-4",
|
|
"name": "Cleanup & Standardization",
|
|
"description": "Suppression des duplications et standardisation",
|
|
"priority": "P2",
|
|
"estimated_hours": 0,
|
|
"tasks": []
|
|
},
|
|
{
|
|
"id": "PHASE-INT-5",
|
|
"name": "Missing Endpoints",
|
|
"description": "Implémenter les endpoints manquants",
|
|
"priority": "P2",
|
|
"estimated_hours": 0,
|
|
"tasks": []
|
|
},
|
|
{
|
|
"id": "PHASE-INT-6",
|
|
"name": "Integration Tests",
|
|
"description": "Tests E2E pour valider l'intégration",
|
|
"priority": "P2",
|
|
"estimated_hours": 0,
|
|
"tasks": []
|
|
}
|
|
],
|
|
"tasks": [
|
|
{
|
|
"id": "INT-CORS-001",
|
|
"category": "INT-CORS",
|
|
"title": "Configure production CORS origins",
|
|
"description": "Définir CORS_ALLOWED_ORIGINS explicitement pour la production",
|
|
"priority": "P0",
|
|
"priority_rank": 1,
|
|
"status": "todo",
|
|
"estimated_hours": 1,
|
|
"side": "backend_only",
|
|
"files_to_modify": [
|
|
"veza-backend-api/internal/middleware/cors.go",
|
|
"veza-backend-api/.env.production"
|
|
],
|
|
"implementation_steps": [
|
|
"Ouvrir veza-backend-api/internal/middleware/cors.go",
|
|
"Vérifier la validation de CORS_ALLOWED_ORIGINS en production",
|
|
"Créer/modifier .env.production avec les origines autorisées",
|
|
"Tester en mode production local"
|
|
],
|
|
"acceptance_criteria": [
|
|
"CORS_ALLOWED_ORIGINS contient les domaines de production",
|
|
"Backend démarre sans erreur en mode production",
|
|
"Requêtes CORS depuis le frontend autorisées"
|
|
],
|
|
"dependencies": [],
|
|
"blocks": ["INT-TEST-001"]
|
|
}
|
|
// ... GÉNÉRER TOUTES LES TÂCHES ICI
|
|
],
|
|
"integration_matrix": {
|
|
"endpoints_analysis": [
|
|
{
|
|
"backend_route": "GET /api/v1/auth/me",
|
|
"backend_handler": "GetMe",
|
|
"backend_file": "veza-backend-api/internal/handlers/auth.go",
|
|
"frontend_service": "authApi.getMe()",
|
|
"frontend_file": "apps/web/src/features/auth/api/authApi.ts",
|
|
"types_aligned": true,
|
|
"issues": [],
|
|
"status": "OK"
|
|
}
|
|
// ... TOUTES les routes
|
|
],
|
|
"type_mismatches": [
|
|
{
|
|
"type_name": "User",
|
|
"field": "id",
|
|
"backend_type": "uuid.UUID",
|
|
"backend_file": "veza-backend-api/internal/dto/user.go",
|
|
"frontend_type": "string | number",
|
|
"frontend_files": ["apps/web/src/types/user.ts"],
|
|
"fix_required": "frontend",
|
|
"task_id": "INT-TYPE-001"
|
|
}
|
|
],
|
|
"duplicate_code": [
|
|
{
|
|
"type": "api_client",
|
|
"files": [
|
|
"apps/web/src/services/api/client.ts",
|
|
"apps/web/src/lib/apiClient.ts"
|
|
],
|
|
"keep": "apps/web/src/services/api/client.ts",
|
|
"remove": "apps/web/src/lib/apiClient.ts",
|
|
"task_id": "INT-CLEANUP-001"
|
|
}
|
|
],
|
|
"missing_frontend_calls": [
|
|
{
|
|
"backend_route": "GET /api/v1/sessions/stats",
|
|
"backend_file": "veza-backend-api/internal/api/router.go:743",
|
|
"frontend_needed": true,
|
|
"task_id": "INT-ENDPOINT-001"
|
|
}
|
|
],
|
|
"missing_backend_routes": [
|
|
{
|
|
"frontend_call": "GET /api/v1/users/search",
|
|
"frontend_file": "apps/web/src/config/constants.ts:31",
|
|
"backend_needed": true,
|
|
"task_id": "INT-ENDPOINT-002"
|
|
}
|
|
]
|
|
},
|
|
"risk_register": [
|
|
{
|
|
"id": "RISK-001",
|
|
"risk": "CORS bloque toutes les requêtes en production",
|
|
"severity": "critical",
|
|
"probability": "certain",
|
|
"impact": "Application inaccessible",
|
|
"mitigation_tasks": ["INT-CORS-001"],
|
|
"owner": "backend"
|
|
}
|
|
],
|
|
"validation_checklist": {
|
|
"pre_deployment": [
|
|
{
|
|
"check": "CORS_ALLOWED_ORIGINS configuré",
|
|
"task_id": "INT-CORS-001",
|
|
"verified": false
|
|
},
|
|
{
|
|
"check": "Tous les types alignés",
|
|
"task_ids": ["INT-TYPE-001", "INT-TYPE-002"],
|
|
"verified": false
|
|
}
|
|
],
|
|
"integration_tests": [
|
|
{
|
|
"test": "Auth flow complet (register → login → refresh → logout)",
|
|
"task_id": "INT-TEST-001",
|
|
"passed": false
|
|
}
|
|
]
|
|
},
|
|
"progress_tracking": {
|
|
"total_tasks": 0,
|
|
"completed": 0,
|
|
"in_progress": 0,
|
|
"todo": 0,
|
|
"blocked": 0,
|
|
"completion_percentage": 0,
|
|
"last_updated": "2025-12-25T00:00:00Z",
|
|
"estimated_completion_date": null
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 📝 RÈGLES DE GÉNÉRATION DES TÂCHES
|
|
|
|
### Format de chaque tâche :
|
|
```json
|
|
{
|
|
"id": "INT-{CATEGORY}-{NUMBER:3}",
|
|
"category": "INT-{CATEGORY}",
|
|
"title": "Titre court et clair (max 60 chars)",
|
|
"description": "Description détaillée du problème et de la solution",
|
|
"priority": "P0|P1|P2|P3",
|
|
"priority_rank": 1-999,
|
|
"status": "todo",
|
|
"estimated_hours": 0.5-8,
|
|
"side": "backend_only|frontend_only|both_sides",
|
|
"files_to_modify": ["chemin/complet/fichier.ext"],
|
|
"implementation_steps": [
|
|
"Étape 1 précise",
|
|
"Étape 2 précise",
|
|
"..."
|
|
],
|
|
"acceptance_criteria": [
|
|
"Critère vérifiable 1",
|
|
"Critère vérifiable 2"
|
|
],
|
|
"dependencies": ["INT-XXX-YYY"],
|
|
"blocks": ["INT-XXX-ZZZ"],
|
|
"verification_command": "commande pour vérifier (optionnel)"
|
|
}
|
|
```
|
|
|
|
### Priorités :
|
|
- **P0**: Bloque le déploiement production (CORS, security)
|
|
- **P1**: Cause des erreurs runtime ou comportements incorrects
|
|
- **P2**: Dette technique, amélioration significative
|
|
- **P3**: Nice-to-have, polish
|
|
|
|
### Catégories :
|
|
- **INT-CORS**: Configuration CORS
|
|
- **INT-AUTH**: Authentification, tokens, sessions
|
|
- **INT-TYPE**: Alignement types TypeScript ↔ Go DTOs
|
|
- **INT-API**: Client API, intercepteurs, services
|
|
- **INT-ENDPOINT**: Endpoints manquants ou à corriger
|
|
- **INT-CLEANUP**: Suppression code dupliqué, standardisation
|
|
- **INT-TEST**: Tests d'intégration E2E
|
|
- **INT-DOC**: Documentation API (OpenAPI, README)
|
|
|
|
---
|
|
|
|
## ✅ CHECKLIST AVANT DE TERMINER
|
|
|
|
Avant de soumettre les fichiers, vérifie :
|
|
|
|
- [ ] **Rapport contient** :
|
|
- [ ] Tableau EXHAUSTIF de TOUS les endpoints backend
|
|
- [ ] Correspondance avec TOUS les appels frontend
|
|
- [ ] Analyse de TOUS les types partagés
|
|
- [ ] Liste de TOUTES les duplications
|
|
- [ ] Score détaillé par catégorie
|
|
|
|
- [ ] **TodoList JSON contient** :
|
|
- [ ] Toutes les tâches identifiées dans le rapport
|
|
- [ ] priority_rank unique et ordonné
|
|
- [ ] implementation_steps détaillés pour chaque tâche
|
|
- [ ] acceptance_criteria vérifiables
|
|
- [ ] integration_matrix complet
|
|
- [ ] summary avec comptages corrects
|
|
- [ ] progress_tracking initialisé
|
|
|
|
---
|
|
|
|
## 🎯 COMMENCE MAINTENANT
|
|
|
|
1. Checkout `feature/integration-perfection` (crée-la si nécessaire)
|
|
2. Scanne les fichiers listés ci-dessus
|
|
3. Génère `INTEGRATION_AUDIT_REPORT_2025.md`
|
|
4. Génère `VEZA_INTEGRATION_PERFECTION_TODOLIST.json`
|
|
5. Commit: `[AUDIT] Complete integration audit and todolist generation`
|
|
|
|
GO!
|
|
```
|
|
|
|
---
|
|
|
|
## 📌 NOTES D'UTILISATION
|
|
|
|
### Comment utiliser ce prompt :
|
|
|
|
1. **Ouvre Cursor** dans ton projet Veza
|
|
2. **Copie tout le contenu** entre les balises ` ```markdown ` et ` ``` `
|
|
3. **Colle dans Cursor** (Cmd+L ou Ctrl+L)
|
|
4. **Laisse l'agent travailler** - il va scanner et générer les deux fichiers
|
|
|
|
### Output attendu :
|
|
|
|
1. `INTEGRATION_AUDIT_REPORT_2025.md` - Rapport détaillé (~1000+ lignes)
|
|
2. `VEZA_INTEGRATION_PERFECTION_TODOLIST.json` - TodoList JSON parfaite
|
|
|
|
### Après la génération :
|
|
|
|
Utilise ce prompt pour exécuter les tâches :
|
|
|
|
```
|
|
Continue l'intégration Veza sur branche feature/integration-perfection.
|
|
Lis @VEZA_INTEGRATION_PERFECTION_TODOLIST.json, trouve la prochaine tâche todo, implémente, commit, continue.
|
|
```
|