Chadbox Cloud

Initial Chadbox Cloud monorepo with:

• apps/gateway: Fastify API gateway (POST /v1/executions)
• apps/worker: Async Redis-stream worker for persistence/log storage pointers
• apps/dashboard: Next.js App Router developer/admin scaffolding
• packages/shared: request schema + SQL bootstrap

Quick start

1. Copy envs:
   • cp .env.example .env
2. Start infra:
   • docker compose up -d
3. Initialize DB schema:
   • run packages/shared/sql/init.sql against Neon/Postgres.
4. Install dependencies:
   • npm install
   • cd apps/dashboard && npm install
5. Run apps:
   • Gateway: npm run dev -w apps/gateway
   • Worker: npm run dev -w apps/worker
   • Dashboard: npm run dev -w apps/dashboard

Gateway contract

• Endpoint: POST /v1/executions
• Auth: Authorization header with ****** (DB stores scrypt hash)
• Idempotency: Idempotency-Key caches full response in Redis for 60s
• Hot path is optimized: auth/limits/forwarding synchronous, persistence/logging async via Redis stream.

Notes

• Execution plane is external and out of scope.
• Worker stores large stdout/stderr in S3-compatible object storage and persists pointers in Postgres.
• Logs are intended for 14-day retention via bucket lifecycle policy.