From a26f7fd88d16f64af1a58be9ff41369eb198ed38 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Francisco=20Ign=C3=A1cio=20Fontoura=20Solla?= Date: Sun, 2 Aug 2026 15:59:37 -0300 Subject: [PATCH] =?UTF-8?q?docs(plans):=20inten=C3=A7=C3=A3o=20B129=20?= =?UTF-8?q?=E2=80=94=20remover=20overview=20da=20lista=20de=20munic=C3=ADp?= =?UTF-8?q?ios?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../remover-overview-lista-municipios.md | 76 +++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 docs/plans/remover-overview-lista-municipios.md diff --git a/docs/plans/remover-overview-lista-municipios.md b/docs/plans/remover-overview-lista-municipios.md new file mode 100644 index 00000000..a4973381 --- /dev/null +++ b/docs/plans/remover-overview-lista-municipios.md @@ -0,0 +1,76 @@ +# Remover overview da lista de municípios + +Status: registrado +Atualizado em: 2026-08-02 +Issue: #266 +Priority: P1 +Model: composer-2.5 +Impeccable: B — remoção de bloco em `/campanha/municipios` (todos os viewports) +Appetite: ~0,5 dia eng; um outcome verificável (lista sobe, overview some) +Responsável: — + +## Intenção + +Na lista de municípios (`/campanha/municipios`), o painel de visão geral acima da tabela (“Média nos municípios filtrados”, declarações, cobertura de assessoria, etc.) ocupa demais a tela e atrasa o Coordenador Geral a chegar nas linhas — o trabalho real da página. Em qualquer viewport, o bloco deve sair para a lista (e os filtros) voltarem a ser o primeiro conteúdo útil abaixo do cabeçalho. + +## Persona e fluxo + +- **Persona / contexto:** Coordenador Geral (também staff com visão completa) na mesa, em desktop ou mobile, abrindo Municípios para filtrar, varrer e agir nas linhas. +- **Job principal:** Ver e trabalhar a lista de municípios sem precisar rolar um bloco de agregados primeiro. +- **Fluxo desejado:** Entra em Municípios → vê filtros/busca e, em seguida, a lista (tabela ou cards) → filtra/ordena/abre linhas. Sem strip de métricas agregadas do conjunto filtrado entre filtros e lista. +- **Anti-goals de produto:** Não redesenhar a lista; não inventar um “overview compacto” ou drawer de KPIs neste item; não mexer no overview de apoiadores nem no dashboard do Início. + +### Esboço de fluxo (B) + +```text +[Municípios] → filtros/busca → lista (linhas/cards) → ação na linha + (sem bloco "Média nos municípios filtrados" / métricas agregadas) +``` + +## Objetivo e aceite + +- Em `/campanha/municipios`, em **todos** os tamanhos de viewport, a seção de visão geral dos municípios filtrados (métricas agregadas do conjunto filtrado) **não aparece**. +- Após filtros/busca, o conteúdo principal útil é a lista (tabela desktop / cards mobile), sem painel de agregados no meio. +- Filtros e leitura por cenário de estimativa que já vivem na barra de filtros **permanecem** — não somem só porque o overview saiu. +- Staff e papéis com acesso à lista continuam a usar a lista; sem regressão de acesso. + +## Dados (intenção) + +- **Vou apresentar dados?** Não — este item **remove** uma superfície de agregados; não cria métrica nova. +- **Decisões desbloqueadas:** Coordenador escolhe o próximo município / filtro / edição na lista sem o custo visual do painel. Agregados de campanha (quando necessários) continuam em superfícies já existentes (ex.: Início / detalhe), não nesta remoção. +- **Forma:** *adiada ao plano de implementação* — restrição de produto: não substituir o bloco removido por outro resumo agregado nesta página neste item. + +## Direção no codebase (hipótese) + +- **Áreas prováveis:** rota `src/app/(campaign)/campanha/(app)/municipios/`; componente `MunicipalityListOverview` em `src/components/campaign/municipality/`; dados de overview em `src/utilities/municipality/` (ex. `municipalityPageData`); testes que pinam o overview da lista. +- **Precedente a olhar:** overview histórico de núcleos (`docs/plans/overview-lista-nucleos.md` — entregue e depois remodelado); seletor de cenário já nos filtros (`docs/plans/cenario-junto-filtros-municipios.md`). +- **Risco de acoplamento:** o atalho E9 “coluna da vergonha” (prioritárias sem responsável) hoje vive no overview; Prioridade + Assessoria nos filtros já cobrem o mesmo recorte — não recriar o atalho neste item salvo decisão abaixo. + +## Dependências + +- Nenhuma + +## Fora de escopo + +- Overview / KPIs de `/campanha/apoiadores` (`SupporterListOverview`) +- Dashboard / mapa / métricas do Início (`/campanha`) +- Redesign da tabela, filtros salvos, ou seletor de colunas +- Relocar o atalho “prioritárias sem responsável” para outro lugar (só se produto pedir em item separado) + +## Rabbit holes de produto + +- **“Tirar o overview mas deixar um resumo menor.”** Reabre o mesmo problema de espaço. **Corte neste item:** remoção completa da superfície agregada na lista. +- **“Salvar o atalho da coluna da vergonha noutro sítio.”** Escopo novo de UI. **Corte neste item:** filtros existentes; novo atalho só com pedido explícito. +- **Mexer no overview de apoiadores “já que estamos nisso.”** Persona/superfície diferentes. **Corte:** só municípios. + +## Questões em aberto (produto) + +- **O atalho “N prioritárias sem responsável” some com o overview?** **Decidido (gate 2026-08-02):** A — some neste item; o recorte segue pelos filtros Prioridade + Assessoria. Sem relocação do atalho neste item. + +## Referências + +- GitHub Issue [#266](https://github.com/fsolla/teqo/issues/266) +- `src/components/campaign/municipality/MunicipalityListOverview.tsx` (label “Média nos municípios filtrados” via cenário ativo) +- `src/app/(campaign)/campanha/(app)/municipios/page.tsx` +- `docs/plans/overview-lista-nucleos.md` · `docs/plans/cenario-junto-filtros-municipios.md` +- E9 / “coluna da vergonha” — contexto em `docs/plans/inteligencia-campanha.md` (não reabrir fila de alocação aqui)