# <NOME DO MÓDULO> — Resumo Executivo

> **Versão analisada:** `<VERSAO>`
> **Slug do módulo:** `<slug-do-modulos>` — quando aplicável
> **Natureza:** `<NATUREZA>`
> **Estado:** `<ESTADO>`

---

## 1. Objetivo

> 2 a 4 frases. O que o módulo resolve para a prefeitura. Para quem serve.

## 2. Efeito / Impacto

O que muda para o município, para o cidadão e para a operação do sistema.

| Faixa | Efeito |
|---|---|
| Cidadão | |
| Prefeitura (CMS) | |
| Transparência e legalidade | |
| Operação técnica | |

## 3. Comportamento

Regras de negócio principais, em lista. Inclua estados, transições e regras de
validação que mudam o resultado observável.

## 4. Como o Usuário Interage

Do ponto de vista de quem opera: telas, ações, filtros, exportações, e o que o
cidadão vê no portal.

## 5. Detalhes e Particularidades Técnicas

- Camadas envolvidas (Route -> Controller -> Request -> Repository/Service -> Model -> DB)
- Regras implícitas, armadilhas, acoplamento com outros módulos
- Dependências de terceiros

## 6. Estrutura de Dados

Tabelas, colunas-chave, relacionamentos, views SQL, seeds.

## 7. Como Testar

Cenários verificáveis (manuais e automatizados) para validar o módulo.

## 8. Migração para Laravel Moderno

O que muda na reconstrução: Eloquent enxuto, Form Requests, Policies,
enums, API resources, testes.

## 9. Resumo Geral

Parágrafo final de 5 a 10 linhas: o leitor que só ler este arquivo precisa sair
daqui sabendo o essencial do módulo.

---

## Índice do dossiê

| Arquivo | Conteúdo |
|---|---|
| `00-RESUMO.md` | Este documento |
| `01-ARQUITETURA.md` | Camadas, classes e o diagrama de fluxo |
| `02-MODELAGEM.md` | Estrutura de dados detalhada |
| `03-ROTAS-E-CONTROLADORES.md` | Rotas, controllers, requests, resources |
| `04-VIEWS-E-UX.md` | Telas, componentes, JS, assets |
| `05-REGRAS-E-PORTABILIDADE.md` | Particularidades e armadilhas |
| `06-MIGRACAO-MODERNA.md` | Plano de reconstrução em Laravel moderno |
| `07-TESTES.md` | Estratégia e casos de teste |
| `08-GAPS-E-DIVIDAS.md` | Pendências, riscos, comparativo entre versões |