Platform
Everything the Qubital system depends on that isn't application code: external vendors, deployment infrastructure, observability, and internal automations.
Sections
services/
One page per external vendor. Each page covers what we use the service for, how it is configured, which env vars it requires, and what breaks if it goes down.
| Service | What we use it for |
|---|---|
| WorkOS | Authentication (AuthKit), SSO, organisation and subscription management, event stream (eventsync worker) |
| LiveKit | LiveKit Cloud — real-time audio/video, room management, recording egress |
| Cloudflare | office-router Worker (WebSocket / Durable Objects), upload-worker (recording pipeline), R2 (avatar storage + recording temp storage) |
| Supabase | PostgreSQL extensions (pg_cron, pg_net, Realtime), JWT secret for Realtime subscriptions |
| Calendar API (room scheduling), YouTube (unlisted recording uploads), Sheets (recording archive log) | |
| Grafana | Mimir (remote metrics write endpoint for Prometheus metrics) |
devops/
How the system is built, deployed, observed, and automated.
| Section | What's inside |
|---|---|
ci/ | GitHub Actions CI pipeline — test strategy, lint, branch model |
deployment/ | Sevalla deployment, Docker builds, GHCR image registry, environment layout |
observability/ | Betterstack (structured logs), Grafana/Mimir (metrics), alerting |
automations/ | Internal bots: ClickUp PR automation, doc-writer agent |