# e-Vacina — Regras e Portabilidade
> Regras de negócio não óbvias, acoplamentos e armadilhas do módulo.
---
## 1. Regras de negócio não óbvias
### 1.1 A tela mostra sempre o registro **mais recente**
`index()` faz `Evacina::latest()->first()` — `latest()` ordena por
`created_at`. Como o `store` **cria** uma linha a cada gravação, a
tabela funciona como um log de configurações e a tela mostra a última.
### 1.2 O `update` ignora o id da URL
O `update` busca o registro mais recente e atualiza **ele**, ignorando
o `{e_vacina}` da rota. Na prática, o `PUT /cms/e-vacina/1` do
formulário (id fixo) atualiza o registro mais recente.
### 1.3 O `status` vem da **presença** da checkbox
```php
$request->merge(["status" => isset($request->status_evacina)]);
```
Desmarcado -> `false` no request -> `filter_request` converte para
**`null`** (coluna nullable). Marcado -> `true`.
O comando `reload:evacina` só atualiza os contadores quando
`$last_evacina->status` é verdadeiro — logo, **desmarcar a caixa impede
a atualização dos contadores**.
### 1.4 Os contadores vêm de uma coluna fixa do CSV
O comando conta os valores da **coluna de índice 28** de cada linha do
CSV exportado do Google Sheets:
| Valor na coluna 28 | Contador |
|---|---|
| `Dose` | `primeira_dose` |
| `1ª Dose` | `primeira_dose` |
| `2ª Dose` | `segunda_dose` |
| `Dose Adicional` | `primeira_dose_reforco` |
| `Reforço` | `primeira_dose_reforco` |
| `2ª Reforço` | `segunda_dose_reforco` |
> Não há validação de que a coluna 28 é a correta. Se a planilha mudar
> de layout, os contadores passam a significar outra coisa — **sem erro
> nem aviso**.
### 1.5 O módulo está **desativado** por padrão
`modulos.id = 5`, `status = false`. O item de menu só aparece se o
módulo for ligado em `/cms/modulos` **e** o perfil tiver
`e-vacina.index`.
### 1.6 O "banner" não é um banner do portal
O `imagem_evacina` é gravado em `evacina/images/{id}/banner.png` — um
caminho próprio do módulo, **não** na galeria de conteúdos do portal. O
botão "Criar Banner Personalizado" apenas gera a imagem no cliente.
---
## 2. Acoplamentos
### 2.1 Dependências de saída
| Dependência | Tipo | Onde |
|---|---|---|
| **Google Sheets** (CSV público) | externa | `ReloadEvacina` |
| `IEvacinaRepository` / `EvacinaRepository` | interno | controller |
| `App\Console\Kernel` (scheduler) | interno | agendamento mensal |
| `Storage` (disk `public`) | Laravel | CSV e banner |
| `Artisan` (chamada síncrona) | Laravel | controller |
| `modulos` / `resources` | interno | menu e permissões |
### 2.2 Dependências de entrada
| Consumidor | Dependência | Risco |
|---|---|---|
| Menu do AdminLTE | `route('e-vacina.index')` + `$modulos['e-vacina']` | item some |
| Scheduler | `reload:evacina` | comando renomeado quebra |
| Portal público | **nenhum** | — |
> O módulo é **folha** e, na prática, **órfão**: ninguém consome a
> tabela `evacinas` além do próprio módulo.
---
## 3. Armadilhas
### 3.1 [CRÍTICO] O módulo é público
`Route::resource('e-vacina', ...)` sem `check.logged`, e o
`EvacinaController::__construct()` não chama `parent::__construct()`
(logo, o `check.route.permission` da classe base
`Prefecture\Controller` não é registrado).
Consequência: qualquer visitante pode **ler** a URL da planilha, a
população e o banner, e **gravar** novos valores (basta um token CSRF,
que é emitido para qualquer página que use formulários).
### 3.2 [ALTO] Quatro das sete rotas apontam para métodos inexistentes
`create`, `show`, `edit` e `destroy` **não existem** em
`EvacinaController` -> HTTP 500 em
`GET /cms/e-vacina/create`, `GET /cms/e-vacina/{id}`,
`GET /cms/e-vacina/{id}/edit` e `DELETE /cms/e-vacina/{id}`.
### 3.3 [ALTO] O botão "Registrar" não submete o formulário
Em `v6/resources/views/prefecture/configurations/evacina/edit.blade.php`,
o `