Ops & deploy

Services

• Postgres via docker-compose.yml (ports 5432, healthcheck enabled).
• Next.js app (Vercel, Dockploy, or container).
• Convex deployment (via npx convex deploy).

Migrations & seeds

pnpm prisma migrate deploy
pnpm prisma generate
# optional seed script (TODO)

Health checks

• /api/health returns { ok: true, ts }.
• Add uptime checks and alerting to this endpoint.

Sync jobs

• Convex cron kpis.rollup1m runs every minute.
• Internal sync webhook /api/internal/pg-sync must be reachable from Convex action environment.

Backup/restore

• Use managed Postgres backups or pg_dump/pg_restore.
• Store RUNFORGE_MASTER_KEY securely and rotate when needed.

Environment

• See ../11-configuration-env.md for required variables.

Files

• docker-compose.yml

TODO: Provide Dockploy/Vercel examples and CI deployment steps.