Runbooks

Procedimentos curtos para quando a API ou uma dependência falha em produção. Dados reais (tokens, dumps) não entram em tickets públicos — SECURITY.md.

Runbook	Quando usar
API indisponível	Healthcheck a falhar, 5xx generalizado, container a reiniciar
PostgreSQL	Timeouts, ECONNREFUSED, auth da BD
Presença / WebSocket	Contagens a zero, sockets a cair, admin sem eventos
Credenciais e JWT	Segredo vazado, tokens rejeitados em massa, .env no git

Arquitetura e variáveis: visao-completa, env-container.