# <NOME DO MÓDULO> — Migração para Laravel Moderno

> **Slug:** `<slug-do-modulos>` · **Alvo:** PHP 8.x + Laravel 11/12
>
> Plano concreto de reconstrução. Este documento tem que ser suficiente
> para escrever a migration e o controller novos **sem abrir o legado**.

---

## 1. Equivalência funcional (o que NÃO pode mudar)

| Comportamento legado | Equivalente na v7 | Risco de divergência |
|---|---|---|
| | | |

> Esta é a seção mais importante. Se um comportamento mudar sem decisão
> explícita, o portal passa a responder diferente e ninguém sabe por quê.

## 2. Schema de migração

```php
// exemplo ilustrativo
Schema::create('nome_da_tabela', function (Blueprint $table) {
    $table->id();
    // ...
});
```

| Tabela legada | Tabela nova | Mudança | Justificativa |
|---|---|---|---|
| | | | |

## 3. Modelos

| Modelo legado | Modelo novo | Mudanças (casts, enums, relations) |
|---|---|---|
| | | |

**Enums sugeridos:**

| Estado/valor legado | Enum | Casos |
|---|---|---|
| | | |

## 4. Form Requests

| Request legado | Request novo | Regras (as mesmas) |
|---|---|---|
| | | |

## 5. Autorização

| Recurso | Policy | Regras |
|---|---|---|
| | | |

> Substitua o `has_access()` por Policy + Gate. Registre a Policy no
> `AuthServiceProvider`.

## 6. Endpoints

| Legado | Novo | Tipo | breaking? |
|---|---|---|---|
| | | | |

## 7. API Resources

| Recurso | Formato |
|---|---|
| | |

## 8. Views

| Blade legado | Blade novo / componente | Observação |
|---|---|---|
| | | |

## 9. Fila, cache e storage

| Necessidade | Solução na v7 | Configuração |
|---|---|---|
| | | |

## 10. Jobs e eventos

| Job/Event | Quando dispara | Efeito |
|---|---|---|
| | | |

## 11. Front-end

| Abordagem legada | Abordagem nova | Justificativa |
|---|---|---|
| | | |

## 12. Ordem de implementação

| # | Passo | Depende de | Esforço |
|---|---|---|---|
| 1 | | | |