veza/README.md

# Veza Monorepo

[![CI](https://github.com/okinrev/veza/actions/workflows/ci.yml/badge.svg)](https://github.com/okinrev/veza/actions/workflows/ci.yml)

**Version courante** : v1.0.4 (cleanup + consolidation post-audit). Voir [CHANGELOG.md](CHANGELOG.md) et [docs/PROJECT_STATE.md](docs/PROJECT_STATE.md).

## Project Structure

- **`apps/web`** — Frontend React 18 + Vite 5 + TypeScript strict (source of truth for the UI)
- **`veza-backend-api`** — Main Go 1.25 API service (Gin, GORM, Postgres, Redis, RabbitMQ, Elasticsearch). Handles REST, WebSocket, and chat (chat server was merged into this service in v0.502).
- **`veza-stream-server`** — Rust streaming server (Axum 0.8, Tokio 1.35, Symphonia) — HLS, HTTP Range, WebSocket, gRPC
- **`veza-common`** — Shared Rust types and logging
- **`packages/design-system`** — Shared design tokens

See [CLAUDE.md](CLAUDE.md) for the full architecture map.

## Development Setup

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.

## Quick Start

### Frontend only

```bash
cd apps/web
npm install
npm run dev
```

## Docker Production

**Canonical production compose file**: `docker-compose.prod.yml`

```bash
docker compose -f docker-compose.prod.yml up -d
```

See `make/config.mk` for COMPOSE_PROD and deployment docs.

## CI/CD

- **Badge** : CI status above. Set `SLACK_WEBHOOK_URL` (Incoming Webhook) in repo secrets to receive Slack notifications on failure.

### Disabled workflows

- **Storybook** (`chromatic.yml.disabled`, `storybook-audit.yml.disabled`, `visual-regression.yml.disabled`): deferred until MSW is wired up for `/api/v1/auth/me` and `/api/v1/logs/frontend`, which currently causes ~1 400 network errors in the Storybook build. The npm scripts (`storybook`, `build-storybook`) still work locally for one-off component inspection. To reactivate in CI, fix the MSW handlers and rename the three files back to `.yml`.

## Documentation

- **[Developer Onboarding](docs/ONBOARDING.md)** — Setup, architecture, conventions, troubleshooting
- **[Documentation index](docs/README.md)** — Index complet de la documentation
- See `docs/` for detailed architecture and development guides. Older audits and reports are archived in `docs/archive/`.