veza/veza-docs/current/domains/backend/readme-startup.md

id	title	sidebar_label
readme-startup	🚀 Guide de démarrage de l'application Veza	🚀 Guide de démarrage de l'application Veza

NOTE: Cette page reflète l'ÉTAT ACTUEL.

🚀 Guide de démarrage de l'application Veza

📋 Vue d'ensemble

L'application Veza est une plateforme complète composée de plusieurs services :

• Backend API (Go) - Port 8080
• Frontend React (Vite) - Port 5174
• Stream Server (Rust) - Port 8082
• Chat Server (Rust) - Port 8081
• PostgreSQL - Port 5432
• Redis - Port 6379
• Grafana (Monitoring) - Port 3000
• Application Desktop (Electron)

🎯 Démarrage rapide

Mode développement (recommandé)

# Démarrer tous les services en mode développement
./start-veza.sh

# Pour arrêter tous les services
./stop-veza.sh

Mode Docker (production)

# Démarrer tous les services en mode Docker
./start-veza-docker.sh

# Pour arrêter
docker-compose -f docker-compose.production.yml down

🌐 Accès aux services

Une fois démarrés, les services sont accessibles aux adresses suivantes :

Service	URL	Description
Frontend Web	http://localhost:5174	Interface utilisateur principale
Backend API	http://localhost:8080	API REST et GraphQL
Stream Server	http://localhost:8082	Service de streaming audio
Grafana	http://localhost:3000	Monitoring et métriques
PostgreSQL	localhost:5432	Base de données principale
Redis	localhost:6379	Cache et sessions

🖥️ Application Desktop

L'application desktop Electron est automatiquement démarrée avec le script start-veza.sh. Elle utilise les mêmes services backend que la version web.

🔧 Dépannage

Problèmes courants

1. Ports déjà utilisés

   # Vérifier les ports utilisés
   netstat -tlnp | grep -E "(8080|5174|8082|5432|6379)"
   
   # Arrêter les processus conflictuels
   pkill -f "server\|npm\|vite"
   

2. Base de données non accessible

   # Redémarrer PostgreSQL
   docker-compose -f docker-compose.local.yml restart postgres
   
   # Vérifier la connexion
   docker exec veza-postgres-local psql -U veza_user -d veza_local -c "\l"
   

3. Frontend ne se charge pas

   # Redémarrer le frontend
   cd veza-frontend && npm run dev
   

Logs des services

# Voir les logs du backend
cd veza-backend-api && ./server

# Voir les logs du frontend
cd veza-frontend && npm run dev

# Voir les logs Docker
docker-compose -f docker-compose.local.yml logs -f

📊 Monitoring

• Grafana : http://localhost:3000 (admin/admin)
• Prometheus : http://localhost:9090 (si configuré)

🛠️ Développement

Structure des projets

veza-full-stack/
├── veza-backend-api/     # Backend Go
├── veza-frontend/        # Frontend React
├── veza-stream-server/   # Serveur de streaming Rust
├── veza-chat-server/     # Serveur de chat Rust
├── veza-desktop/         # Application desktop Electron
└── config/              # Configurations Docker

Scripts utiles

• start-veza.sh - Démarrage en mode développement
• stop-veza.sh - Arrêt des services
• start-veza-docker.sh - Démarrage en mode Docker
• docker-compose.production.yml - Configuration Docker

🎉 Test de l'application

1. Ouvrez http://localhost:5174 dans votre navigateur
2. Testez les fonctionnalités de l'interface
3. Vérifiez les appels API via http://localhost:8080/api/health
4. Testez le streaming via http://localhost:8082

📝 Notes importantes

• Les services de base (PostgreSQL, Redis, Grafana) sont démarrés via Docker
• Les services applicatifs (backend, frontend, stream) sont démarrés localement en mode développement
• L'application desktop nécessite Node.js et npm installés
• Tous les services sont configurés pour fonctionner ensemble automatiquement

🆘 Support

En cas de problème :

1. Vérifiez que tous les ports sont disponibles
2. Assurez-vous que Docker est installé et en cours d'exécution
3. Vérifiez les logs des services
4. Redémarrez les services un par un si nécessaire