veza/docs/archive/root-md/DEPANNAGE_RAPIDE.md

🔧 Dépannage Rapide - Veza Integration

✅ Problèmes Résolus

1. Migration SQL 050_data_validation_constraints.sql ❌ → ✅

Problème: syntax error at or near "NOT" - PostgreSQL ne supporte pas IF NOT EXISTS avec ADD CONSTRAINT

Solution: Migration corrigée pour utiliser des blocs DO $$ (comme dans 930_add_missing_foreign_keys.sql)

Status: ✅ CORRIGÉ

---

2. Port Redis Occupé ❌ → ✅

Problème: address already in use sur port 6379

Causes possibles:

• Service Redis système actif (systemctl status redis)
• Container Docker Redis déjà en cours d'exécution

Solutions:

Option A: Arrêter le service Redis système (Recommandé)

# Vérifier si Redis système est actif
systemctl status redis

# Arrêter le service
sudo systemctl stop redis

# Optionnel: Désactiver au démarrage
sudo systemctl disable redis

Option B: Arrêter le container Docker Redis

# Arrêter l'instance existante
docker stop veza_redis

# Redémarrer via docker-compose
docker compose up -d redis

Vérification:

# Vérifier que le port est libre
ss -tlnp | grep 6379

# Vérifier les containers
docker compose ps

Status: ✅ RÉSOLU

---

🚀 Démarrage Rapide (Après Corrections)

Option 1: Backend + Frontend Seulement (Recommandé pour tests)

# Terminal 1: Infrastructure
make infra-up

# Terminal 2: Backend
cd veza-backend-api
go run cmd/api/main.go

# Terminal 3: Frontend
cd apps/web
npm run dev

URLs:

• Frontend: http://localhost:3000
• Backend: http://localhost:8080
• Swagger: http://localhost:8080/docs

---

Option 2: Tout-en-un (avec Makefile)

# Ignorer les erreurs Rust (non bloquant)
make dev 2>&1 | grep -v "libsqlite3-sys"

Note: Les erreurs Rust (chat-server, stream-server) ne bloquent pas l'intégration backend/frontend.

---

⚙️ Configuration Backend

Le fichier .env a été créé automatiquement dans veza-backend-api/.env:

APP_ENV=development
JWT_SECRET=dev-secret-key-minimum-32-characters-long-for-testing
DATABASE_URL=postgres://veza:password@localhost:5432/veza?sslmode=disable
REDIS_URL=redis://localhost:6379
CORS_ALLOWED_ORIGINS=http://localhost:3000,http://localhost:5173
APP_PORT=8080
LOG_LEVEL=INFO

---

🧪 Test Rapide

# 1. Vérifier infrastructure
docker compose ps

# 2. Vérifier backend
curl http://localhost:8080/health

# 3. Vérifier frontend
curl http://localhost:3000

# 4. Ouvrir dans navigateur
open http://localhost:3000

---

🐛 Problèmes Connus (Non Bloquants)

Erreur Rust libsqlite3-sys

Message: failed to select a version for libsqlite3-sys

Impact: ⚠️ NON BLOQUANT - Les serveurs Rust (chat, stream) ne sont pas nécessaires pour tester l'intégration backend/frontend.

Solution: Ignorer cette erreur ou corriger les dépendances Rust séparément.

---

Go Version (air)

Message: requires go >= 1.25 (running go 1.24.10)

Impact: ⚠️ NON BLOQUANT - Le backend démarre avec go run même sans air.

Solution: Utiliser go run cmd/api/main.go au lieu de air.

---

✅ Checklist Avant Test

• Migration SQL corrigée
• Redis démarré
• Backend .env configuré
• Backend démarré (port 8080)
• Frontend démarré (port 3000)
• Test dans navigateur

---

Guide complet: Voir GUIDE_DEMARRAGE_INTEGRATION.md