rust-template/docs/runbook.md

# Runbook

## First run

```bash
cp .env.example .env
docker compose -f infra/compose/docker-compose.yml up -d postgres
cargo run -p server
```

In another terminal:

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

Open http://127.0.0.1:5173. Swagger UI is at http://127.0.0.1:8080/api/docs.

## RustRover

1. Open this folder as a Cargo workspace.
2. Run configuration: `cargo run -p server`.
3. Environment: `APP_ENV=development`.
4. Optional custom template: Settings → New Project → add this Git URL as a cargo-generate template.

## Config overrides

| Knob | Where |
| --- | --- |
| Profile | `APP_ENV=development\|production` |
| File | `config/{APP_ENV}.toml` |
| Env | `APP__SERVER__PORT=8080` |
| Explicit dir | `APP_CONFIG_DIR=/abs/path/to/config` |

## Generate the frontend client

```bash
just generate-api
```

Vite also regenerates on dev/build if `packages/contracts/openapi.json` changes.

## Postgres URL

Default: `postgres://app:app@127.0.0.1:5432/app`

Override with `APP__DATABASE__URL` or `config/local.toml` (gitignored).