Developer onboarding

Target time: under 30 minutes on a machine with Docker and Git.

Steps

1. Clone this repository and cd into the project root.
2. Environment: copy .env.example to .env and set secrets (Postgres password, JWT secret, encryption key).
3. Start: run docker compose up -d --wait (or make up if available).
4. Database + dev users (with the API container running):

   make seed-db
   # or: bash scripts/seed-dev-users.sh
   

   This runs alembic upgrade head and creates (if missing):

Email	Password	Role
admin@test.com	password123	admin
operator@test.com	password123	operator
viewer@test.com	password123	viewer

1. API: open http://localhost:8001/docs (or your mapped API port) and use POST /api/v1/auth/token with the email/password above.
2. UI: production bundle is proxied through nginx — http://localhost:3001 maps /api → API. Run make seed-db first, then sign in with admin@test.com / password123. For local dev: cd services/ui && npm run dev (Vite proxies /api to the API port, default 8001).

Scripts

• scripts/onboard.sh — bootstrap helper (adjust for your compose layout).
• scripts/load-test.sh — optional API load smoke (requires curl, jq, running API).
• scripts/verify-onboarding-time.sh — wraps onboard.sh and checks elapsed time.

Tests

• API: cd services/api && .venv/bin/python -m pytest tests/ -v
• UI E2E: cd services/ui && npm run test:e2e