Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wimeisoftwares.com/llms.txt

Use this file to discover all available pages before exploring further.

​
O que é o Risk Score

O Risk Score é um número de 0 a 100 que representa o risco geral da migração.
ScoreCategoriaAção recomendada
0–25BAIXOPode executar com revisão rápida
26–50MEDIORevisar findings ALTOS antes de executar
51–75ALTOPlanejamento detalhado, testes em homologação
76–100CRITICONão executar sem resolver todos os findings CRITICOS

​
Severidades dos findings

​
CRITICO

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

​
MEDIO

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

CRITICO → Resolver ANTES de executar migration.sql
ALTO    → Resolver ANTES ou criar plano de contingência
MEDIO   → Resolver DEPOIS, em sprint seguinte

​
Downtime estimado

O campo downtime_estimate indica a janela de manutenção necessária:
EstimativaO que significa
< 1hSchema simples, migração rápida
2-4h janela de manutencaoSchema médio, recomenda janela noturna
1-2 dias com blue-greenSchema complexo, usar estratégia blue-green
Migracao incremental recomendadaSchema 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.