Troubleshooting

column project_id does not exist

O banco está sem a estrutura multi-tenant.

Correções:

yarn db:push

Ou reinicie a API para executar o bootstrap idempotente de tenant.

Erro de CSRF

Rotas mutáveis admin exigem x-csrf-token.

Fluxo correto:

GET /api/admin/auth/csrf
POST /api/admin/auth/login
x-csrf-token: <token>

O painel admin já faz isso automaticamente.

403 project access denied

O usuário autenticado não pertence ao projeto enviado em x-project-id.

Use um projeto listado em:

GET /api/admin/projects

API Pública Retorna 401

Verifique:

• Header x-api-key presente.
• Chave ativa.
• Chave criada no projeto correto.

API Pública Retorna 403

A API key não tem escopo suficiente. Para leitura pública, use:

["content:read"]

Upload Rejeitado

Uploads validam magic bytes. Se o conteúdo real não bater com o mimetype, a API rejeita.

Deploy Admin Falha com Rolldown

Use versões fixas de Vite e instale pelo root do monorepo com Yarn. O projeto já configura isso em apps/admin/vercel.json.

Docs Avisam metadataBase

É um aviso do Next para imagens Open Graph. O build continua válido. Configure metadataBase se precisar URLs absolutas em produção.