adaptador-planilhas/docs/spreadsheet-adapter/16-pilot-deployment-runbook.md

Runbook de implantação do piloto

Execute nesta ordem. Não apague auditoria, banco ou arquivos como parte do rollback.

1. Preparar o projeto Supabase da Elo Pro e anotar URL, anon key e service role.
2. Validar que o login Elo Pro emite sessão Supabase e o cookie elo_pro_workspace_id.
3. Conferir se profiles, workspaces e workspace_members já existem. Se existirem com outro formato, não aplique 0001_platform_shim.sql. Aplique só 0002, 0003 e 0004 depois de adaptar identity-port.ts.
4. Validar RLS no papel app_user: um usuário não lê modelo de outro workspace.
5. Criar o bucket privado. Não gerar URL pública.
6. Subir Redis e preencher REDIS_URL.
7. Definir ADAPTER_JOB_MODE=worker.
8. Preencher os secrets da tabela em 15-production-environment.md. Não definir ADAPTER_DEV_AUTH nem o segredo de desenvolvimento.
9. Definir SPREADSHEET_TEMP_TTL_SECONDS com o prazo operacional do piloto.
10. Preencher SENTRY_DSN. Confirmar que o evento de teste não contém célula.
11. Rodar npm run migrate no banco já conferido.
12. Iniciar a web com npm run start.
13. Iniciar npm run worker com as mesmas variáveis.
14. GET /api/health/live deve responder live. GET /api/health/ready deve responder ready sem connection string.
15. Executar o smoke do caminho completo no ambiente real (SMOKE_REAL ainda não está automatizado contra o host; percorrer a jornada na interface).
16. Ativar a flag só no workspace piloto: npm run flag -- <workspace_id> on.
17. Verificar logs do worker: nome do erro e código, sem planilha.
18. Processar um arquivo pequeno de ponta a ponta e baixar XLSX, CSV e PDF.

Rollback

1. npm run flag -- <workspace_id> off.
2. Parar o processo do worker.
3. Manter audit_log, modelos e o banco.
4. Não rodar script que apague storage ou tabelas.
5. Se o deploy em si estiver incorreto, promover de volta o artefato anterior depois da flag desligada.

A última ativação do módulo fica no checklist de 18-pilot-final-gate.md.