Status and gaps
Which deployment pieces OpenTofu and GitHub Actions automate, which steps stay manual, and what is missing or not production-ready.
Last reviewed 2026-11-16 against the repository. Launch blockers that need a live environment are tracked in blockers.
Automated (OpenTofu + GitHub Actions)
| Piece | Where |
|---|---|
| VPC, both Droplets, firewalls, tags | infra/opentofu/platform/{network,media,scanner}.tf |
| LiveKit, Caddy (layer4) and Redis configuration via cloud-init | media.tf, files/livekit-* |
| Scanner deployment via cloud-init, private CA and certificate, renewal | scanner.tf, secrets.tf |
| PostgreSQL cluster, database, roles, pool, trusted sources, grants | databases.tf, files/database-grants.sql, scripts/apply-grants.sh |
Valkey with noeviction | databases.tf |
| Spaces bucket, CORS, lifecycle, bucket-scoped API key | storage.tf |
| Every application secret (pepper, webhook master, LiveKit keys, messaging key, scanner token, origin secret) | secrets.tf, zone/main.tf |
| App Platform app: API, migrations, owner bootstrap, metrics worker, alerts | app.tf |
| Cloudflare DNS, Access policy and application, Pages projects and domains | platform/cloudflare.tf |
| Zone settings, origin-lock, cache and redirect rules, DMARC, CAA | infra/opentofu/zone/main.tf |
| Encrypted state and plans (enforced) | versions.tf in both stacks |
| Image build, scan, push; scanner rebuilt only when its sources change | .github/workflows/deploy.yml |
tofu apply, smoke test (health + origin lock), Pages publish | deploy.yml |
tofu plan on pull requests; zone stack apply | .github/workflows/infra.yml |
| Offline checks: validate, mocked plan test | scripts/tofu-check.sh, platform/tests/plan.tftest.hcl |
Manual, once
| Task | Page |
|---|---|
| Accounts, billing, Droplet limits | Prerequisites |
| Container registry (shared, not managed) and its plan | Step 1 |
| DigitalOcean token, Spaces key, state bucket, passphrases | Step 2 |
| Cloudflare zone, API token, Zero Trust organization and IdP (when Access is on) | Step 2 |
| GitHub environments, secrets, variables, reviewers | Step 4 |
First-deploy DNS switch (API_DNS_PROXIED=false, then removed) | Step 6 |
| Owner's console password (interactive by design) | Step 7 |
| Monitoring backend, alert receivers, log forwarding, node_exporter | Step 10 |
| Optional Cloudflare extras: Email Routing, DNSSEC, WAF managed rules, edge rate limiting | Cloudflare zone |
Missing or not production-ready
| Item | Impact |
|---|---|
| Not yet applied to real accounts. Validated and plan-tested against mocked providers only | The first real apply may need fixes; check tofu plan shows no changes after a successful apply |
| Secret env drift on App Platform is unverified | If a plan after a clean apply keeps showing changes to SECRET variables, report it before relying on PR plans |
| State locking relies on the workflows' concurrency groups, not a lock in the bucket | Do not apply locally while a workflow runs |
| Configuration changes replace Droplets | Media changes end active calls; scanner changes pause uploads briefly |
| LiveKit Egress (recording) has no deployment code (REC-01) | Recording does not work until Egress runs on a separate host |
| One media node, no failover | A media outage stops calls; messaging keeps working |
| Multi-instance API supported but not load-tested (LOAD-01) | Keep api_instance_count = 1 until load tests pass |
| Restore and rollback drills not yet run (OPS-01) | Run them on staging before launch |
Console CSP hard-codes the lynkoria.com API hosts | Another domain needs an edit to apps/admin/public/_headers |
Bootstrap organization name is fixed to Guildsman (apps/api/src/bootstrap.ts) | Rename later in the database if needed |
| Push notifications need product credentials; real delivery untested (PUSH-01) | Leave PUSH_CREDENTIALS_JSON unset until a product provides them |
| Native SDK media untested on devices (NAT-01..03) | Web clients are the verified path |
| Fidescript media isolation undecided (ADR 008) | Needs a separate stack before sensitive traffic |
Not deployed by design: apps/playground, apps/example-nextjs and apps/example-tanstack-start.