mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-16 20:13:04 +00:00
- loadMunicipalityV2ContaData + MunicipalityV2LocalAccountSection - Inline edit-in-place com cenário ativo local para cobertura - Extract MunicipalityTerritorialClassRow do card E8 - Integra com B149 rede e B150 agora na mesma página v2 - Impl plan docs/plans/municipio-v2-conta-local-impl.md
81 lines
4.5 KiB
Markdown
81 lines
4.5 KiB
Markdown
# Impl: Município v2 — conta local (P/M/O + cobertura + classe)
|
|
|
|
Status: aprovado
|
|
Atualizado em: 2026-08-03
|
|
Issue: #331
|
|
Intenção: docs/plans/municipio-v2-conta-local.md
|
|
Appetite restante: ~1 dia eng (herdado)
|
|
|
|
## Leitura da intenção
|
|
|
|
- **Outcome:** na dobra principal da v2, staff vê e edita meta P/M/O no lugar; clicar/focar um cenário ativa cobertura/déficit daquele cenário; classe territorial com destaque e fatores; tooltips com one-liner + link a conceitos; sem abrir Eleições.
|
|
- **O que NÃO negociar:** leader lockdown; um único número escondendo P/M/O; três coberturas simultâneas; grade E8 completa na 1ª dobra; % estadual absoluto; segundo significado de cenário.
|
|
- **O que reavaliar:** hipótese de “bloco na composição v2” (ok); reusar popover da lista vs inline edit-in-place; estender `loadMunicipalityV2StatusData` vs loader conta dedicado.
|
|
|
|
## Abordagem recomendada
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
Page["municipio/[slug]/v2/page.tsx"]
|
|
Loader["loadMunicipalityV2ContaData"]
|
|
Section["MunicipalityV2LocalAccountSection"]
|
|
Inline["VoteEstimateScenarioInputs + useCampaignCellAutosave"]
|
|
API["POST …/expected-votes"]
|
|
Page --> Loader --> Section
|
|
Section --> Inline --> API
|
|
Section -->|"computeGoalCoverageByScenario (client)"| Coverage["Cobertura cenário ativo"]
|
|
```
|
|
|
|
**Opções consideradas:**
|
|
|
|
| | A — Popover list control na v2 | B — Inline P/M/O + cenário local + cobertura reativa | C — Card E8 completo na dobra |
|
|
| --- | -------------------------------------------- | ---------------------------------------------------- | ----------------------------- |
|
|
| | Reusa `MunicipalityListExpectedVotesControl` | Inputs visíveis; cenário ativo local | Viola anti-goal produto |
|
|
|
|
**Recomendação:** B — produto pede campos editáveis no lugar e clique ativa cenário; popover esconde P/M/O; card E8 é fora de escopo.
|
|
|
|
**Rejeitadas:** A (popover ≠ in-place); C (corte explícito na intenção).
|
|
|
|
### Componentes / mudanças
|
|
|
|
- **`loadMunicipalityV2ContaData`** (`src/utilities/municipality/municipalityV2ContaData.ts`): composer server-only — context + expectedVotes + pledge aggregate + `loadStatewideSuggestedGoals` + `computeGoalCoverageByScenario` + territorial class.
|
|
- **`MunicipalityV2ContaViewModel`** (`src/utilities/municipality/municipalityV2ContaView.ts`): tipo serializável para a seção.
|
|
- **`MunicipalityV2LocalAccountSection`** (`src/components/campaign/municipality/`): client; inline autosave (mesmo endpoint B9); `activeScenario` local; cobertura recalculada com `computeGoalCoverageByScenario` ao editar; progress + déficit; classe com fatores.
|
|
- **`MunicipalityTerritorialClassRow`** (extract de `MunicipalityGoalAccountCard`): dono compartilhado da linha classe+fatores+tooltip — editar o owner, não twin.
|
|
- **`page.tsx`**: substituir placeholder pela seção; `Promise.all` status + conta.
|
|
- **Migration:** nenhuma.
|
|
- **Access:** page gate `noLeader`; write via `setMunicipalityExpectedVotes` existente.
|
|
- **UI:** Impeccable B — shape denso na dobra; `CampaignHoverTooltip` + `campaignConceptOneLiner`; `Progress` h-2 como no card E8.
|
|
|
|
### Dados → forma
|
|
|
|
- P/M/O: três inputs compactos numa linha (mesmo `VoteEstimateScenarioInputs` compact).
|
|
- Cobertura: uma leitura grande (% + barra + déficit) do cenário ativo; meta e comprometido em sublinha.
|
|
- Classe: pill + dois fatores (reuso `TerritorialClassRow`).
|
|
|
|
## Fases verificáveis
|
|
|
|
1. **Loader + view model** — `municipalityV2ContaData` + unit smoke se helper puro.
|
|
2. **UI** — seção client + extract territorial row + wire page.
|
|
3. **Gates** — `pnpm gate:fast`; push via `pnpm push`.
|
|
|
|
## Rabbit holes / Não escopo (engenharia)
|
|
|
|
- Cenário global `MunicipalityEstimateScenarioProvider` na v2.
|
|
- Diagnósticos E8 (teto, captura, roll-off) na dobra.
|
|
- `router.refresh()` obrigatório — cobertura recalcula client-side com `computeGoalCoverageByScenario`.
|
|
|
|
## Riscos e mitigação
|
|
|
|
- **Drift cobertura pós-save:** `useCampaignCellAutosave` adota `savedExpectedVotes` da resposta; recomputamos cobertura localmente com os mesmos pure helpers do servidor.
|
|
- **Twin TerritorialClassRow:** extract para componente compartilhado no mesmo PR.
|
|
|
|
## Aceite de engenharia
|
|
|
|
- [x] Aceite de produto da intenção coberto
|
|
- [x] Invariantes AGENTS/engineering-standards
|
|
- [x] Testes: unit no loader/view se lógica pura; int opcional (cobertura já testada em `goalCoverage.unit.spec.ts`)
|
|
|
|
## Débitos deferidos (capture-review-debts)
|
|
|
|
- Link “mais detalhe da conta” para overview/E8 — gatilho: entrega B151 ou pedido explícito de deep-link.
|