---
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