2025-12-08 18:57:54 +00:00
|
|
|
# Veza Monorepo
|
2025-12-03 12:54:23 +00:00
|
|
|
|
2026-03-05 22:03:43 +00:00
|
|
|
[](https://github.com/okinrev/veza/actions/workflows/ci.yml)
|
|
|
|
|
|
chore(v0.102): consolidate remaining changes — docs, frontend, backend
- docs: SCOPE_CONTROL, CONTRIBUTING, README, .github templates
- frontend: DeveloperDashboardView, Player components, MSW handlers, auth, reactQuerySync
- backend: playback_analytics, playlist_service, testutils, integration README
Excluded (artifacts): .auth, playwright-report, test-results, storybook_audit_detailed.json
2026-02-20 12:02:12 +00:00
|
|
|
**Version cible** : v0.101 (stabilisation en cours). Voir [docs/V0_101_RELEASE_SCOPE.md](docs/V0_101_RELEASE_SCOPE.md) pour le périmètre.
|
|
|
|
|
|
2025-12-08 18:57:54 +00:00
|
|
|
## Project Structure
|
2025-12-03 12:54:23 +00:00
|
|
|
|
2025-12-08 18:57:54 +00:00
|
|
|
- **`apps/web`**: The main frontend application (React + Vite). **This is the single source of truth for the UI.**
|
|
|
|
|
- **`veza-desktop`**: A thin Electron wrapper that loads `apps/web`. It creates the native desktop experience.
|
|
|
|
|
- **`veza-backend-api`**: Main Go API service.
|
|
|
|
|
- **`veza-stream-server`**: Rust streaming server.
|
|
|
|
|
- **`veza-chat-server`**: Rust chat server.
|
2025-12-03 12:54:23 +00:00
|
|
|
|
2026-03-05 18:35:57 +00:00
|
|
|
## Development Setup (v0.9.3)
|
|
|
|
|
|
|
|
|
|
Prerequisites: Node 20 (see `.nvmrc`), Go, Rust, Docker. Configure `.env` from `.env.example`.
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# Verify environment
|
|
|
|
|
make doctor
|
|
|
|
|
./scripts/validate-env.sh development
|
|
|
|
|
|
|
|
|
|
# Install dependencies
|
|
|
|
|
make install-deps
|
|
|
|
|
|
|
|
|
|
# Option A — Backend in Docker + Web local
|
|
|
|
|
make dev
|
|
|
|
|
|
|
|
|
|
# Option B — All apps local with hot reload (infra from docker-compose.dev.yml)
|
|
|
|
|
make dev-full
|
|
|
|
|
|
|
|
|
|
# Option C — Infra only, then run services manually
|
|
|
|
|
docker compose -f docker-compose.dev.yml up -d
|
|
|
|
|
make dev-web # or make dev-backend-api, make dev-stream-server
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
See [docs/ENV_VARIABLES.md](docs/ENV_VARIABLES.md) for required variables. `make build` builds all services.
|
|
|
|
|
|
2025-12-08 18:57:54 +00:00
|
|
|
## Quick Start
|
2025-12-03 12:54:23 +00:00
|
|
|
|
2025-12-08 18:57:54 +00:00
|
|
|
### Frontend
|
2025-12-03 12:54:23 +00:00
|
|
|
```bash
|
2025-12-08 18:57:54 +00:00
|
|
|
cd apps/web
|
|
|
|
|
npm install
|
|
|
|
|
npm run dev
|
2025-12-03 12:54:23 +00:00
|
|
|
```
|
|
|
|
|
|
2025-12-08 18:57:54 +00:00
|
|
|
### Desktop (Optional)
|
|
|
|
|
Requires `apps/web` to be running.
|
2025-12-03 12:54:23 +00:00
|
|
|
```bash
|
2025-12-08 18:57:54 +00:00
|
|
|
cd veza-desktop
|
|
|
|
|
npm install
|
|
|
|
|
npm run dev
|
2025-12-03 12:54:23 +00:00
|
|
|
```
|
|
|
|
|
|
2026-02-11 21:19:34 +00:00
|
|
|
## Docker Production
|
|
|
|
|
|
|
|
|
|
**Canonical production compose file**: `docker-compose.prod.yml`
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
docker compose -f docker-compose.prod.yml up -d
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
**Deprecated** (use docker-compose.prod.yml):
|
|
|
|
|
- `docker-compose.production.yml` — legacy, may be removed
|
|
|
|
|
- `config/docker/docker-compose.production.yml` — legacy config
|
|
|
|
|
|
|
|
|
|
See `make/config.mk` for COMPOSE_PROD and deployment docs.
|
|
|
|
|
|
2026-03-05 22:03:43 +00:00
|
|
|
## CI/CD
|
|
|
|
|
|
|
|
|
|
- **Badge** : CI status above. Set `SLACK_WEBHOOK_URL` (Incoming Webhook) in repo secrets to receive Slack notifications on failure.
|
|
|
|
|
|
2025-12-08 18:57:54 +00:00
|
|
|
## Documentation
|
2026-02-15 15:13:20 +00:00
|
|
|
|
|
|
|
|
- **[Developer Onboarding](docs/ONBOARDING.md)** — Setup, architecture, conventions, troubleshooting
|
2026-02-16 10:04:24 +00:00
|
|
|
- **[Documentation index](docs/README.md)** — Index complet de la documentation
|
2026-02-15 15:13:20 +00:00
|
|
|
- See `docs/` for detailed architecture and development guides. Older audits and reports are archived in `docs/archive/`.
|
