veza/README.md

105 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🌌 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 lenvironnement 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`.