Havia dois runbooks sobrepostos, escritos para o piloto, e nenhum documento do
ambiente de homologação.
- `20-homologacao-runbook.md` consolida os dois e cobre DNS, TLS, Nginx,
Supabase de homologação, banco com a decisão do shim, bucket privado,
containers, worker, observabilidade, flag, rollback, diagnóstico e smoke.
Os dois runbooks antigos ficam no repositório marcados como histórico,
preservando o registro das decisões.
- Rollback de imagem com comandos: identificar o que está no ar, listar tags,
desligar a flag antes de trocar, subir só web e worker com `--no-deps`,
conferir saúde, religar a flag. As migrations de segurança — RLS e auditoria
append-only — estão declaradas sem caminho de volta: desfazê-las afrouxa o
isolamento entre workspaces, então um rollback que precise disso está errado
por definição.
- `21-checklist-validacao.md` separa o que foi executado do que depende de
infraestrutura, com a evidência de cada item e a tabela dos quatro defeitos
encontrados. Nada está marcado PASS por inspeção de código.
- ADR 0007 registra o ambiente lógico e a autenticação de homologação, com as
alternativas descartadas e o motivo.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
