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

# Artefatos gerados pelo MigraFlow CLI

> Entenda o conteúdo da pasta entrega/: migration.sql, rollback.sql, risk_report.md, review_report.md e o JSON completo gerado a cada análise.

Após cada análise, o MigraFlow gera uma pasta `entrega_TIMESTAMP/` com os seguintes arquivos:

```
entrega_20260427_170004/
├── migration.sql
├── rollback.sql
├── risk_report.md
├── review_report.md       (apenas com --review)
└── resultado_completo.json
```

## migration.sql

Script SQL completo e pronto para execução no banco de destino.

Contém:

* `CREATE TABLE` com tipos modernos
* Primary keys e Foreign keys
* Indexes
* Constraints
* Comentários com o nome legado de origem

```sql theme={null}
-- Migrated from TB_CLI_REG
CREATE TABLE customers (
  customer_id   BIGSERIAL PRIMARY KEY,
  name          VARCHAR(100) NOT NULL,
  email         VARCHAR(255) UNIQUE,
  document      VARCHAR(20),
  created_at    TIMESTAMP DEFAULT NOW()
);
```

<Warning>
  Sempre revise o script antes de executar em produção. Execute primeiro em ambiente de homologação.
</Warning>

## rollback.sql

Script de rollback gerado automaticamente. Execute se a migração falhar.

Contém:

* `DROP TABLE` em ordem reversa (respeita FKs)
* Comentários para restaurar backups
* Validação de contagem de registros

```sql theme={null}
-- ROLLBACK PLAN — Execute if migration fails
DROP TABLE IF EXISTS order_items CASCADE;
DROP TABLE IF EXISTS orders CASCADE;
DROP TABLE IF EXISTS customers CASCADE;
```

## risk\_report.md

Relatório de riscos com score de 0 a 100.

| Score  | Categoria | O que significa                               |
| ------ | --------- | --------------------------------------------- |
| 0–25   | BAIXO     | Migração simples, baixo risco                 |
| 26–50  | MÉDIO     | Alguns pontos de atenção                      |
| 51–75  | ALTO      | Requer revisão cuidadosa                      |
| 76–100 | CRÍTICO   | Alto risco, planejamento detalhado necessário |

Findings por severidade:

* **CRÍTICO** — Bloqueador. Deve ser resolvido antes da migração
* **ALTO** — Risco significativo de perda de dados ou downtime
* **MÉDIO** — Impacto moderado, pode ser resolvido em paralelo

## review\_report.md

Disponível apenas com a flag `--review`. Review de qualidade do `migration.sql` gerado.

Contém:

* **Score de qualidade** (0–100)
* **Problemas** com fix em SQL
* **Indexes faltando**
* **Constraints faltando**
* **Sugestões de melhoria**

## resultado\_completo.json

Resultado bruto completo da análise em JSON. Útil para integração com outras ferramentas ou para auditoria.

Contém todos os dados: mapping, risk\_score, data\_dictionary, migration\_sql, rollback\_sql e summary.