407 lines
No EOL
8.4 KiB
Text
407 lines
No EOL
8.4 KiB
Text
---
|
|
id: getting-started
|
|
title: Démarrage Rapide
|
|
sidebar_label: Démarrage Rapide
|
|
description: Guide de démarrage rapide pour Veza Platform
|
|
keywords: [veza, getting-started, quick-start, installation, setup]
|
|
---
|
|
|
|
# 🚀 Démarrage Rapide
|
|
|
|
Guide de démarrage rapide pour Veza Platform - Plateforme de streaming audio et chat en temps réel.
|
|
|
|
## 📋 Prérequis
|
|
|
|
### Outils Requis
|
|
|
|
| Outil | Version | Description |
|
|
|-------|---------|-------------|
|
|
| **Docker** | 20.10+ | Conteneurisation |
|
|
| **Docker Compose** | 2.0+ | Orchestration |
|
|
| **Node.js** | 18+ | Frontend |
|
|
| **Go** | 1.23+ | Backend API |
|
|
| **Rust** | 1.70+ | Services Rust |
|
|
| **PostgreSQL** | 15+ | Base de données |
|
|
| **Redis** | 7+ | Cache |
|
|
|
|
### Comptes et Services
|
|
|
|
- **GitHub** : Pour le code source
|
|
- **Docker Hub** : Pour les images Docker (optionnel)
|
|
- **S3/MinIO** : Pour le stockage des fichiers audio
|
|
|
|
## 🏗️ Installation
|
|
|
|
### 1. Cloner le Repository
|
|
|
|
```bash
|
|
git clone https://github.com/okinrev/veza-full-stack.git
|
|
cd veza-full-stack
|
|
```
|
|
|
|
### 2. Configuration des Variables d'Environnement
|
|
|
|
```bash
|
|
# Copier les fichiers d'exemple
|
|
cp env.example .env
|
|
cp veza-docs-backup-commit-5032111/.env.example veza-docs/.env
|
|
```
|
|
|
|
Éditez `.env` avec vos configurations :
|
|
|
|
```env
|
|
# Base de données
|
|
DATABASE_URL=postgresql://veza:password@localhost:5432/veza_dev
|
|
REDIS_URL=redis://localhost:6379
|
|
|
|
# JWT
|
|
JWT_SECRET=your-super-secret-key-here
|
|
JWT_EXPIRATION=24h
|
|
|
|
# Services
|
|
CHAT_SERVICE_URL=http://localhost:3001
|
|
STREAM_SERVICE_URL=http://localhost:3002
|
|
API_SERVICE_URL=http://localhost:8081
|
|
|
|
# Frontend
|
|
VITE_API_BASE_URL=http://localhost:8081/api/v1
|
|
VITE_WS_BASE_URL=ws://localhost:3001
|
|
VITE_APP_NAME=Veza
|
|
|
|
# Storage
|
|
S3_ENDPOINT=http://localhost:9000
|
|
S3_BUCKET=veza-audio
|
|
S3_ACCESS_KEY=minioadmin
|
|
S3_SECRET_KEY=minioadmin
|
|
|
|
# Monitoring
|
|
PROMETHEUS_URL=http://localhost:9090
|
|
GRAFANA_URL=http://localhost:3000
|
|
```
|
|
|
|
### 3. Démarrage avec Docker Compose
|
|
|
|
```bash
|
|
# Démarrer tous les services
|
|
docker-compose up -d
|
|
|
|
# Vérifier le statut
|
|
docker-compose ps
|
|
```
|
|
|
|
### 4. Démarrage en Mode Développement
|
|
|
|
```bash
|
|
# Backend Go API
|
|
cd backend
|
|
go mod download
|
|
go run cmd/server/main.go
|
|
|
|
# Chat Server (Rust)
|
|
cd veza-chat-server
|
|
cargo run
|
|
|
|
# Stream Server (Rust)
|
|
cd veza-stream-server
|
|
cargo run
|
|
|
|
# Frontend Web
|
|
cd apps/web
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
## 🌐 Accès aux Services
|
|
|
|
### URLs de Développement
|
|
|
|
| Service | URL | Description |
|
|
|---------|-----|-------------|
|
|
| **Frontend Web** | http://localhost:5176 | Interface utilisateur |
|
|
| **Backend API** | http://localhost:8081 | API REST |
|
|
| **Chat Server** | ws://localhost:3001 | WebSocket Chat |
|
|
| **Stream Server** | http://localhost:3002 | Streaming Audio |
|
|
| **Grafana** | http://localhost:3000 | Dashboards |
|
|
| **Prometheus** | http://localhost:9090 | Métriques |
|
|
|
|
### URLs de Production
|
|
|
|
| Service | URL | Description |
|
|
|---------|-----|-------------|
|
|
| **Frontend Web** | https://veza.com | Interface utilisateur |
|
|
| **Backend API** | https://api.veza.com | API REST |
|
|
| **Chat Server** | wss://chat.veza.com | WebSocket Chat |
|
|
| **Stream Server** | https://stream.veza.com | Streaming Audio |
|
|
|
|
## 🎯 Première Utilisation
|
|
|
|
### 1. Créer un Compte
|
|
|
|
1. Ouvrez http://localhost:5176
|
|
2. Cliquez sur "S'inscrire"
|
|
3. Remplissez le formulaire d'inscription
|
|
4. Confirmez votre email
|
|
|
|
### 2. Explorer l'Interface
|
|
|
|
- **Dashboard** : Vue d'ensemble de votre activité
|
|
- **Chat** : Conversations en temps réel
|
|
- **Bibliothèque** : Gestion de vos fichiers audio
|
|
- **Profil** : Paramètres de votre compte
|
|
|
|
### 3. Uploader un Fichier Audio
|
|
|
|
1. Allez dans la section "Bibliothèque"
|
|
2. Cliquez sur "Upload"
|
|
3. Sélectionnez un fichier audio (MP3, FLAC, etc.)
|
|
4. Attendez le traitement
|
|
5. Votre fichier est maintenant disponible pour le streaming
|
|
|
|
### 4. Démarrer une Conversation
|
|
|
|
1. Allez dans la section "Chat"
|
|
2. Cliquez sur "Nouvelle Conversation"
|
|
3. Invitez d'autres utilisateurs
|
|
4. Commencez à chatter en temps réel
|
|
|
|
## 🔧 Configuration Avancée
|
|
|
|
### Base de Données
|
|
|
|
#### PostgreSQL
|
|
|
|
```sql
|
|
-- Créer la base de données
|
|
CREATE DATABASE veza_dev;
|
|
CREATE USER veza WITH PASSWORD 'password';
|
|
GRANT ALL PRIVILEGES ON DATABASE veza_dev TO veza;
|
|
|
|
-- Exécuter les migrations
|
|
\i scripts/init-databases.sql
|
|
```
|
|
|
|
#### Redis
|
|
|
|
```bash
|
|
# Démarrer Redis
|
|
redis-server
|
|
|
|
# Vérifier la connexion
|
|
redis-cli ping
|
|
```
|
|
|
|
### Services Externes
|
|
|
|
#### MinIO (S3 Compatible)
|
|
|
|
```bash
|
|
# Démarrer MinIO
|
|
docker run -p 9000:9000 -p 9001:9001 \
|
|
-e "MINIO_ROOT_USER=minioadmin" \
|
|
-e "MINIO_ROOT_PASSWORD=minioadmin" \
|
|
minio/minio server /data --console-address ":9001"
|
|
```
|
|
|
|
#### Monitoring
|
|
|
|
```bash
|
|
# Démarrer Prometheus
|
|
docker run -d -p 9090:9090 prom/prometheus
|
|
|
|
# Démarrer Grafana
|
|
docker run -d -p 3000:3000 grafana/grafana
|
|
```
|
|
|
|
## 🧪 Tests
|
|
|
|
### Tests Unitaires
|
|
|
|
```bash
|
|
# Backend Go
|
|
cd backend
|
|
go test ./...
|
|
|
|
# Frontend
|
|
cd apps/web
|
|
npm run test
|
|
|
|
# Chat Server (Rust)
|
|
cd veza-chat-server
|
|
cargo test
|
|
|
|
# Stream Server (Rust)
|
|
cd veza-stream-server
|
|
cargo test
|
|
```
|
|
|
|
### Tests d'Intégration
|
|
|
|
```bash
|
|
# Tests E2E Frontend
|
|
cd apps/web
|
|
npm run test:e2e
|
|
|
|
# Tests d'intégration complets
|
|
make test-integration
|
|
```
|
|
|
|
### Tests de Performance
|
|
|
|
```bash
|
|
# Tests de charge
|
|
make test-load
|
|
|
|
# Tests de stress
|
|
make test-stress
|
|
```
|
|
|
|
## 🚀 Déploiement
|
|
|
|
### Déploiement Local
|
|
|
|
```bash
|
|
# Build de production
|
|
make build
|
|
|
|
# Démarrage en production
|
|
make start-prod
|
|
```
|
|
|
|
### Déploiement Docker
|
|
|
|
```bash
|
|
# Build des images
|
|
docker-compose build
|
|
|
|
# Démarrage en production
|
|
docker-compose -f docker-compose.production.yml up -d
|
|
```
|
|
|
|
### Déploiement Kubernetes
|
|
|
|
```bash
|
|
# Appliquer les manifests
|
|
kubectl apply -f k8s/
|
|
|
|
# Vérifier le déploiement
|
|
kubectl get pods
|
|
```
|
|
|
|
## 🔍 Dépannage
|
|
|
|
### Problèmes Courants
|
|
|
|
#### 1. Erreur de Connexion à la Base de Données
|
|
|
|
```bash
|
|
# Vérifier que PostgreSQL est démarré
|
|
docker-compose ps postgres
|
|
|
|
# Vérifier les logs
|
|
docker-compose logs postgres
|
|
```
|
|
|
|
#### 2. Erreur de Connexion Redis
|
|
|
|
```bash
|
|
# Vérifier que Redis est démarré
|
|
docker-compose ps redis
|
|
|
|
# Tester la connexion
|
|
redis-cli -h localhost -p 6379 ping
|
|
```
|
|
|
|
#### 3. Erreur de Connexion WebSocket
|
|
|
|
```bash
|
|
# Vérifier que le Chat Server est démarré
|
|
docker-compose ps chat-server
|
|
|
|
# Vérifier les logs
|
|
docker-compose logs chat-server
|
|
```
|
|
|
|
#### 4. Erreur de Streaming Audio
|
|
|
|
```bash
|
|
# Vérifier que le Stream Server est démarré
|
|
docker-compose ps stream-server
|
|
|
|
# Vérifier les logs
|
|
docker-compose logs stream-server
|
|
```
|
|
|
|
### Logs et Debugging
|
|
|
|
```bash
|
|
# Voir tous les logs
|
|
docker-compose logs -f
|
|
|
|
# Logs d'un service spécifique
|
|
docker-compose logs -f backend-api
|
|
|
|
# Logs avec timestamps
|
|
docker-compose logs -f --timestamps
|
|
```
|
|
|
|
### Monitoring
|
|
|
|
```bash
|
|
# Vérifier les métriques Prometheus
|
|
curl http://localhost:9090/metrics
|
|
|
|
# Accéder à Grafana
|
|
open http://localhost:3000
|
|
```
|
|
|
|
## 📚 Prochaines Étapes
|
|
|
|
### 1. Explorer la Documentation
|
|
|
|
- [Architecture Système](/docs/architecture/system) - Comprendre l'architecture
|
|
- [Frontend Web](/docs/sectors/web) - Développer l'interface
|
|
- [Backend Services](/docs/backend/go-api) - Développer les services
|
|
- [Infrastructure](/docs/infra/observability) - Déployer et maintenir
|
|
|
|
### 2. Développement
|
|
|
|
- [Guide de Développement](/docs/meta/contributing-docs) - Contribuer au projet
|
|
- [Style Guide](/docs/meta/style-guide) - Standards de code
|
|
- [API Reference](/docs/api-reference/openapi) - Documentation des APIs
|
|
|
|
### 3. Production
|
|
|
|
- [Déploiement](/docs/infra/ci-cd) - Déployer en production
|
|
- [Monitoring](/docs/infra/observability) - Surveiller l'application
|
|
- [CI/CD](/docs/infra/ci-cd) - Opérations et maintenance
|
|
|
|
## 🆘 Support
|
|
|
|
### Ressources
|
|
|
|
- **Documentation** : Cette documentation complète
|
|
- **GitHub Issues** : [Signaler un bug](https://github.com/okinrev/veza-full-stack/issues)
|
|
- **Discussions** : [Forum communautaire](https://github.com/okinrev/veza-full-stack/discussions)
|
|
- **Discord** : [Serveur Discord](https://discord.gg/veza) (à venir)
|
|
|
|
### Contact
|
|
|
|
- **Email** : support@veza.com
|
|
- **Twitter** : [@VezaPlatform](https://twitter.com/VezaPlatform)
|
|
- **GitHub** : [@okinrev](https://github.com/okinrev)
|
|
|
|
---
|
|
|
|
<div className="alert alert--success">
|
|
<strong>🎉 Félicitations !</strong> Vous avez maintenant Veza Platform en cours d'exécution. Explorez la documentation pour en savoir plus sur les fonctionnalités avancées.
|
|
</div>
|
|
|
|
<div className="alert alert--info">
|
|
<strong>💡 Conseil</strong> : Consultez la section <a href="/docs/architecture/system">Architecture</a> pour comprendre le fonctionnement interne de la plateforme.
|
|
</div>
|
|
|
|
---
|
|
|
|
**Dernière mise à jour** : 2025-01-15
|
|
**Version** : 1.0.0
|
|
**Status** : ✅ Prêt pour la production |