> ## 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.

# Interpretar o Risk Report do MigraFlow

> Entenda o Risk Score, as categorias de findings e as ações recomendadas para revisar e mitigar riscos antes de executar a migração do banco de dados.

## 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

```markdown theme={null}
## 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);`
```

<Tip>
  Sempre compartilhe o `risk_report.md` com o cliente antes de executar a migração. Ele serve como documentação de due diligence.
</Tip>