veza/README.md

# 🌌 Veza — Plateforme créative et collaborative nouvelle génération

Veza est une plateforme audio complète et modulaire : partage, streaming haute performance, collaboration, chat temps réel, marketplace, analytics, et gestion créative.  
Conçue pour être **intensive**, **scalable** et **créatrice de communautés**, elle s'appuie sur une architecture hybride **Go + Rust + React** pensée pour durer.

---

## 🏛️ Architecture (vue ultra-résumée)

```

veza/
│
├── apps/
│   ├── backend-api/     # API Go (auth, users, tracks, playlists…)
│   ├── chat-server/     # WebSocket Rust (rooms & DM)
│   ├── stream-server/   # Serveur audio Rust (FFmpeg, HLS)
│   └── web-frontend/    # Interface React/TS, Zustand, shadcn/ui
│
├── infra/
│   ├── docker/          # Images, scripts, entrypoints
│   ├── incus/           # Containers Dev/Prod
│   ├── ansible/         # Déploiement automatisé
│   └── k8s/             # (optionnel) Manifests Kubernetes
│
├── docs/
│   ├── ORIGIN/          # Spécifications "Constitution"
│   ├── ARCHITECTURE/
│   ├── FEATURES/
│   └── ROADMAP/
│
└── scripts/
├── dev/
├── ci/
└── smoke-tests/

````

---

## 🚀 Lancer le projet en local (dev environment)

**Pré-requis :**
- Go ≥ 1.22  
- Rust ≥ 1.75  
- pnpm ou npm  
- Docker + docker-compose  
- PostgreSQL + Redis  

### 1. Cloner le repo
```bash
git clone https://github.com/your-org/veza.git
cd veza
````

### 2. Lancer l’environnement de développement

```bash
docker compose up -d
```

### 3. Lancer chaque service

#### Backend Go

```bash
cd apps/backend-api
go run cmd/server/main.go
```

#### Chat server (Rust)

```bash
cd apps/chat-server
cargo run
```

#### Stream server (Rust)

```bash
cd apps/stream-server
cargo run
```

#### Frontend

```bash
cd apps/web-frontend
pnpm install
pnpm dev
```

---

## 📜 Licence

Le projet est distribué sous licence **AGPL-3.0** (voir fichier `LICENSE`).

---

## 🤝 Contributions

Les contributions sont les bienvenues ! Voir `CONTRIBUTING.md`.