Ops help
Settings & rollout
Server env flags are not editable from the browser in v1. Copy these into Carelines .env and restart.
Environment flags
| Env | Default | Meaning |
|---|---|---|
| IRIS_BOT_VERSIONS_LIVE | false | When false, assignments are stored but live chat stays builtin. |
| IRIS_BOT_VERSIONS_LIVE_CLINIC_IDS | empty | Comma-separated clinic UUIDs. Empty + live=true → all clinics. |
| IRIS_BOT_VERSIONS_REQUIRE_SUITE | true | Assign / bulk-assign must pass golden suite (or override reason). |
Safe rollout checklist
- 1
Clone builtin → edit → playground
Create a draft from builtin, tune director / scores / prompts / models, then verify in Playground.
- 2
Publish
Publishing freezes the config. Further changes require a new clone.
- 3
Run suite
Golden director scenarios must pass (or provide suite_override_reason when assigning).
- 4
Assign dogfood clinic
Set IRIS_BOT_VERSIONS_LIVE=true and optionally IRIS_BOT_VERSIONS_LIVE_CLINIC_IDS to one clinic UUID, then assign.
- 5
Confirm live-status
Overview should show that clinic as assigned_live.
- 6
Assign all
Clear allowlist (empty = all), keep live=true, then bulk-assign from the published version page.
- 7
Rollback always available
DELETE clinic assignment (one click in Clinics) or set IRIS_BOT_VERSIONS_LIVE=false on the server.
Production (static dist + nginx)
Build with npm run build, copy dist/ to the server. Browser calls /api/admin/*; nginx injects X-Admin-Api-Key and proxies to FastAPI. Do not put the admin key in the frontend build.
Local next dev only
NEXT_PUBLIC_IRIS_API_BASE=http://localhost:8000/api/v1 NEXT_PUBLIC_ADMIN_API_KEY=your-admin-api-key