Troubleshooting

Papel no sistema

Troubleshooting reduz o tempo entre sintoma e causa provável. A maioria dos problemas locais nasce de D1 não migrado, seed ausente, binding errado ou apps levantados em terminais separados de forma incompleta.

Onde fica o código

Comece por apps/monitor/wrangler.jsonc, apps/api/wrangler.jsonc, apps/workflows/wrangler.jsonc, packages/db/wrangler.jsonc e packages/db/scripts. Para erros de workflow, olhe também apps/workflows/src/service.ts e packages/workflow-core.

Como se conecta com o resto

Se login falha, verifique packages/auth, seed e tabela user. Se endpoints falham, verifique apps/api e o binding DB. Se ações ao vivo de workflow falham, verifique o service binding WORKFLOWS e se apps/workflows está rodando.

Como verificar

Rode novamente pnpm db:migrate:local e, se o usuário sumiu, SEED_EMAIL=you@example.com SEED_PASSWORD=secret pnpm db:seed:local. Depois rode o teste filtrado do app com falha para separar problema de runtime local de regressão de código.