# <NOME DO MÓDULO> — Regras e Portabilidade

> **Slug:** `<slug-do-modulos>` · **Versão analisada:** `<VERSAO>`
>
> Regras de negócio não óbvias, armadilhas técnicas e o que precisa ser
> decidido para reconstruir o módulo em base moderna.

---

## 1. Regras de negócio

| # | Regra | Onde é implementada | Efeito observável |
|---|---|---|---|
| 1 | | | |

> Regra = condição que muda o resultado. Se não muda nada observável, não
> é regra — é implementação.

## 2. Estados e transições

```
[estado inicial] --ação--> [estado X] --condição--> [estado Y]
```

| De | Para | Gatilho | Quem pode | Efeito colateral |
|---|---|---|---|---|
| | | | | |

## 3. Regras implícitas

Comportamentos que **não** estão explícitos no código, mas que o sistema
herdou e que o usuário já depende:

- 
- 

> Esta seção é a mais valiosa do dossiê para a reconstrução. É o que se
> perde quando se reescreve do zero "corretamente".

## 4. Armadilhas técnicas

| Tipo | Onde | Impacto | Gravidade |
|---|---|---|---|
| SQL concatenado | | | |
| `whereRaw` / `DB::raw` | | | |
| N+1 (query em loop) | | | |
| Rota declarada dentro de controller | | | |
| `$_SESSION` / estado global | | | |
| Arquivo grande com regra embutida | | | |

## 5. Código duplicado

| Trecho | Onde aparece | Pode ser unificado? |
|---|---|---|
| | | |

## 6. Acoplamentos

### 6.1 Depende de

| Módulo | Tipo | Ponto do acoplamento | Risco se o outro mudar |
|---|---|---|---|
| | | | |

### 6.2 Usado por

| Módulo | Tipo | Ponto do acoplamento |
|---|---|---|
| | | |

## 7. Divergência entre versões

| Aspecto | Versão anterior | Versão atual | Causa |
|---|---|---|---|
| | | | |

> Se as versões são idênticas, diga isso explicitamente — é informação
> valuable (o que **não** precisa ser redesenhado).

## 8. Riscos de portabilidade

| Risco | Probabilidade | Impacto | Mitigação na v7 |
|---|---|---|---|
| | | | |

## 9. Decisões que a v7 precisa tomar

| Decisão | Opções | Recomendação | Quem decide |
|---|---|---|---|
| | | | |