O que é o Risk Score?
O Risk Score é um número de 0 a 100 que representa o risco geral da migração.
| Score | Categoria | Ação recomendada |
|---|
| 0–25 | BAIXO | Pode executar com revisão rápida |
| 26–50 | MÉDIO | Revisar findings ALTOS antes de executar |
| 51–75 | ALTO | Planejamento detalhado, testes em homologação |
| 76–100 | CRÍTICO | Não executar sem resolver todos os findings CRÍTICOS |
Severidades dos findings
CRÍTICO
Bloqueador. A migração vai falhar ou vai perder dados se não for resolvido.
Exemplos:
- Data armazenada como VARCHAR
- Coluna NOT NULL sem valor padrão e sem dados
- Circular FK sem resolução
ALTO
Risco significativo. Pode causar downtime inesperado ou inconsistência de dados.
Exemplos:
- FK sem index (degradação de performance)
- Tipo incompatível com perda de precisão (ex: FLOAT → INTEGER)
- Tabela sem PK
MÉDIO
Impacto moderado. Pode ser resolvido em paralelo com a migração.
Exemplos:
- Coluna sem DEFAULT
- Nome reservado usado como coluna
- Constraint faltando
Como agir sobre cada finding
CRÍTICO → Resolver ANTES de executar migration.sql
ALTO → Resolver ANTES ou criar plano de contingência
MÉDIO → Resolver DEPOIS, em sprint seguinte
Downtime estimado
O campo downtime_estimate indica a janela de manutenção necessária:
| Estimativa | O que significa |
|---|
< 1h | Schema simples, migração rápida |
2-4h janela de manutencao | Schema médio, recomenda janela noturna |
1-2 dias com blue-green | Schema complexo, usar estratégia blue-green |
Migracao incremental recomendada | Schema muito grande, migrar por módulos |
Exemplo de risk_report.md
## Score de Risco: 68/100 - ALTO
| Metrica | Valor |
|---------|-------|
| Tabelas | 12 |
| Downtime estimado | 2-4h janela de manutencao |
## Riscos CRITICOS
**TB_PED.DT_ENTREGA** - Data armazenada como VARCHAR(8)
> `ALTER TABLE orders ADD COLUMN delivery_date DATE;`
## Riscos ALTOS
**TB_ITEM_PED** - FK order_id sem index
> `CREATE INDEX idx_order_items_order ON order_items(order_id);`
Sempre compartilhe o risk_report.md com o cliente antes de executar a migração. Ele serve como documentação de due diligence.
