# <NOME DO MÓDULO> — Rotas e Controladores

> **Slug:** `<slug-do-modulos>` · **Versão analisada:** `<VERSAO>`
>
> Superfície HTTP completa: método, URI, nome de rota, action, middleware e
> permissão exigida.

---

## 1. Rotas do CMS (backoffice)

Prefixo usual: `/cms`. Em Legacy: `routes/basepro.php`.

| Método | URI | Nome | Controller@action | Middleware | Permissão |
|---|---|---|---|---|---|
| | | | | | |

## 2. Rotas do Portal (público)

| Método | URI | Nome | Controller@action | Parâmetros | Observação |
|---|---|---|---|---|---|
| | | | | | |

## 3. Rotas de API

| Método | URI | Nome | Controller@action | Formato da resposta |
|---|---|---|---|---|
| | | | | |

## 4. Rotas de ajax (sem nomeação)

Rotas chamadas por JavaScript, frequentemente sem `->name()`:

| Método | URI | Chamado de | Payload | Retorno |
|---|---|---|---|---|
| | | | | |

## 5. Controladores

| Controller | Caminho | Actions | Observação |
|---|---|---|---|
| | | | |

### 5.1 `NomeDoController`

| Action | Responsabilidade | Valida | Redirect / resposta |
|---|---|---|---|
| | | | |

## 6. Form Requests e validações

| Classe | Caminho | Regras | Campos opcionais |
|---|---|---|---|
| | | | |

> Cole as regras **exatas** (`'cpf' => 'nullable|min:14'`), não a
> descrição delas. Elas são o contrato de validação.

## 7. API Resources / Presenters

| Classe | Formato de saída | Quando usado |
|---|---|---|
| | | |

## 8. Permissões exigidas

| Rota | Permissão (`has_access`) | Comportamento se faltar |
|---|---|---|
| | | |

> **Verifique no código** o que acontece quando a permissão falta:
> redirect, 403, ou tela em branco? Erros de configuração aparecem aqui.

## 9. Breadcrumbs e menu

| Item de menu | Rota | Condição de exibição | Módulo (modulo_id) |
|---|---|---|---|
| | | | |