# Auditoria: `assemblies-index.js`

**Arquivo:** `resources/js/pages/assemblies/assemblies-index.js` (1216 linhas)

---

## O que o módulo faz

Gerencia dois sub-domínios numa única tela com layout de painel duplo (lista + detalhe):

- **Assembleias** — listagem, seleção, detalhamento com pautas e votações
- **Enquetes** — listagem, criação, apuração e encerramento

**6 modais:** Nova Assembleia, Nova Enquete, Apuração, Edital de Convocação, ATA, Relatório de Participação.

---

## Status de conformidade

| Critério | Status |
|---|---|
| `import { axios } from '../../bootstrap.js'` | ✅ OK |
| Sem `fetch()` nativo | ✅ OK |
| `createTableErrorHandler` | N/A — não usa Grid.js/createTable |
| `window.*` no escopo correto | ⚠️ Veja abaixo |
| `createModuleState` | ⚠️ Veja abaixo |
| FormHandler | ⚠️ Veja abaixo |

---

## Desvios encontrados

### 1. `window.*` atribuídos dentro de funções de render (não no init)

**Onde:** `renderAssembleiaDetail()` (linha ~230) e `renderEnqueteList()` (linha ~329)

```js
// PROBLEMA: isso roda toda vez que um item é selecionado
function renderAssembleiaDetail(panel, a) {
    panel.innerHTML = `...onclick="updateStatus(id)"...`;
    window.updateStatus = updateStatus;   // ← executado a cada render
    window.openApuracao = openApuracao;
    window.saveDecisao = saveDecisao;
    window.openEditalModal = openEditalModal;
    window.gerarAta = gerarAta;
    window.openRelatorio = openRelatorio;
}
```

**Por que é ruim:** a cada clique em um item da lista, as atribuições `window.*` rodam desnecessariamente. Não causa bug visível, mas é semanticamente incorreto — essas funções nunca mudam e poderiam ser atribuídas uma única vez no `init()`.

**Correção:** mover todos os `window.fn = fn` para dentro do `init()`.

---

### 2. `window._currentAssembleiaData` — estado global desnecessário

**Onde:** linha ~237

```js
window._currentAssembleiaData = a;  // ← expõe dado no escopo global
```

**Correção:** declarar `let currentAssembleiaData = null;` no escopo do módulo (fora de qualquer função) e usar diretamente. Não precisa de `createModuleState` porque não é seleção de linha de tabela.

---

### 3. Validação manual repetida em 3 forms

Cada form (Nova Assembleia, Nova Enquete, Edital) tem ~60 linhas próprias de:

```js
// Padrão repetido 3 vezes com variações:
const campo = document.getElementById('nomeDocampo');
if (!campo.value.trim()) {
    campo.classList.add('is-invalid');
    errors.push('Mensagem de erro');
}
```

**Por que FormHandler não resolve aqui:** os payloads são construídos programaticamente (campos dinâmicos, pautas aninhadas com opções). FormHandler pressupõe payload direto de `<form>`.

**Correção possível:** extrair um helper local `validateRequiredFields(fields)` que centraliza a lógica de `is-invalid` / coleta de erros, eliminando a triplicação.

---

## O que NÃO é desvio (foi auditado incorretamente antes)

- **13 chamadas axios** — cada uma serve um propósito distinto e é legítima
- **`window.selectAssembleia`, `window.selectEnquete` etc.** — necessários porque os `onclick` são strings dentro de `innerHTML`. É o mesmo padrão aceito para células do Grid.js, aplicado aqui a HTML dinâmico
- **Ausência de FormHandler** — os forms têm lógica de payload complexa demais para o wrapper genérico

---

## Plano de correção (PR pequeno, cirúrgico)

### Tarefa 1 — Mover `window.*` para o `init()`

Remover as atribuições de dentro de `renderAssembleiaDetail()` e `renderEnqueteList()` e colocá-las uma única vez em `init()`.

**Impacto:** zero risco de regressão. Puramente organizacional.

### Tarefa 2 — `window._currentAssembleiaData` → variável de módulo

```js
// Antes (dentro de renderAssembleiaDetail):
window._currentAssembleiaData = a;

// Depois (topo do arquivo, escopo de módulo):
let currentAssembleiaData = null;
// ...dentro de renderAssembleiaDetail:
currentAssembleiaData = a;
```

**Impacto:** verificar se algo fora do módulo lê `window._currentAssembleiaData`. Se sim, manter o window por compatibilidade.

### Tarefa 3 — Helper local de validação

```js
function validateRequiredFields(fields) {
    // fields: [{ el: HTMLElement, message: string }]
    const errors = [];
    fields.forEach(({ el, message }) => {
        if (!el?.value?.trim()) {
            el?.classList.add('is-invalid');
            errors.push(message);
        } else {
            el?.classList.remove('is-invalid');
        }
    });
    return errors; // vazio = válido
}
```

**Impacto:** refatoração interna, sem mudança de comportamento.

---

## Estimativa de esforço

| Tarefa | Risco | Esforço |
|---|---|---|
| Mover `window.*` para `init()` | Baixo | 30 min |
| `_currentAssembleiaData` → módulo | Baixo | 10 min |
| Helper de validação | Médio | 45 min |

Total: ~1,5h de implementação + teste manual das 6 modais.
