Fluxo de API

Papel no sistema

O fluxo de API descreve como uma requisição entra por apps/api, passa por auth e chega a leituras de D1 ou ações de workflow. apps/api é um Worker Hono.

Onde fica o código

Leia apps/api/src/app.ts para a ordem de middlewares, apps/api/src/auth.ts para autenticação, apps/api/src/db.ts para injeção do banco e apps/api/src/workflows.ts para endpoints de workflows.

Como se conecta com o resto

O middleware de auth usa o pacote packages/auth. O acesso ao banco usa o binding DB e o pacote packages/db. Ações de workflow usam o binding WORKFLOWS. Leituras de histórico consultam workflow_runs e workflow_run_events; ações como trigger, pause, resume, terminate e retry vão para apps/workflows.

Como verificar

Rode pnpm --filter api test e, em integração local, suba pnpm dev:api junto com pnpm dev:workflows. Se uma rota falhar por binding ausente, confirme apps/api/wrangler.jsonc.