# <NOME DO MÓDULO> — Modelagem de Dados

> **Slug:** `<slug-do-modulos>` · **Versão analisada:** `<VERSAO>`
>
> Tabelas, colunas, relacionamentos, views SQL, migrations e seeds.

---

## 1. Tabelas

### 1.1 `nome_da_tabela`

| Coluna | Tipo | Null | Default | Key | Observação |
|---|---|---|---|---|---|
| `id` | bigserial | no | — | PK | |
| | | | | | |

**Índices:** 
**Unique:** 
**FK:** 

> Liste **todas** as colunas. Se a tabela tem 40 colunas, faça uma tabela
> `nome` + subseções, ou um CSV anexo — mas não omita.

## 2. Relacionamentos

| Origem | Destino | Tipo | Cardinalidade | Onde declarado |
|---|---|---|---|---|
| | | | | |

## 3. Views SQL

| View | Tabela(s) base | Colunas | Quem consome |
|---|---|---|---|
| | | | |

> O legado usa `CREATE VIEW` extensivamente. Uma view pode ser a "tabela"
> real do módulo — nesse caso, documente as colunas da view, não da tabela.

## 4. Migrations

| Data | Arquivo | Operação | Tabela afetada |
|---|---|---|---|
| | | | |

> Inclua as migrations que **alteram** colunas, não só as que criam.
> Uma coluna adicionada depois muda o contrato do modelo.

## 5. Seeds

| Arquivo | O que popula | Volume aproximado |
|---|---|---|
| | | |

## 6. Estados e transições

| Estado | Valor | Como entra | Como sai |
|---|---|---|---|
| | | | |

> Se o módulo tem workflow (rascunho → publicado), a tabela de estados é
> parte do contrato funcional. Documente.

## 7. Índices e performance

| Consulta frequente | Índice que a atende | Existe? | Custo de criar |
|---|---|---|---|
| | | | |

> Sinalize consultas que fazem full scan em tabelas grandes.