Drop the redundant type column, URL param, and filters while keeping municipality.kind for map and dossier; update tests and delivery docs.
10 KiB
Remover coluna Tipo da lista de Municípios
Status: entregue
Atualizado em: 2026-07-29
Item do roadmap: docs/roadmap.md (Fill-ins)
Impeccable: B — encaixe em MunicipalityList / filtros da lista (/campanha/municipios); sem rota nova
Appetite: ~0,25–0,5 dia eng; remove coluna + filtro/sort kind da URL da lista; sem migration
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (princípio 2 — clareza sob pressão; anti spreadsheet) / DESIGN.md (register product; Field Desk) · tema data-theme='campaign' · shells MunicipalityList + CampaignTable + header B15/B16.
Na implementação (implement-roadmap-item): craft compacto → critique → polish (só remoção de densidade morta; sem redesign da tabela).
Brief compacto:
- Persona / contexto: CG / Assessor / Candidato varre a fila de alocação (E9); a coluna "Tipo" (Município × Zona eleitoral) ocupa largura sem mudar a decisão — as 19 ZE de Salvador já se leem pelo nome e pelo filtro de município/TI.
- Job principal: uma coluna a menos na varredura; quem precisa das zonas de Salvador filtra pelo município (ou busca "Salvador"), não por um enum paralelo.
- Estratégia de cor: Restrained — nenhuma superfície nova.
- Edit where you see: não — só remove leitura/filtro;
kindno schema continua read-only da geografia. - Anti-goals: redesign do header; seletor de colunas neste item (B17); apagar
municipality.kinddo modelo/catálogo; segunda forma de filtrar Salvador (chip "só zonas").
Dados → decisão → apresentação
Dados: N/A — este item não introduz nem altera métricas; só remove uma dimensão categórica redundante da lista. O campo kind no domínio (catálogo / detalhe / mapa / dossiê) permanece.
Contexto
Em /campanha/municipios, a tabela staff (MunicipalityList → CampaignTable) inclui a coluna id: 'kind' com header "Tipo", sort (sortKey="kind") e filtro single-select no header (filterParam="kind", B16). Célula: municipalityKindLabels[municipality.kind] → "Município" | "Zona eleitoral" (src/utilities/municipalityLabels.ts). O mesmo kind vive na URL (MunicipalityListState.kind, ?kind=municipio|zona) e em buildMunicipalityListWhere.
Pedido de produto (2026-07-25): remover a coluna. Municípios e Zonas Eleitorais são tratados da mesma forma na coordenação; para isolar as ZE de Salvador basta filtrar por Salvador (multi-select de slugs / busca no popover de Município — as 19 entradas salvador-ze-*). O filtro ?kind=zona não acrescenta um recorte que a operação use.
O campo Payload municipality.kind e o catálogo (municipalityCatalog) não saem: geografia seedada, card de bairros (B8), mapa multi-zona, dossiê e labels de detalhe ainda dependem dele.
Objetivos
- Em
/campanha/municipios: sumir a coluna "Tipo" (desktopCampaignTablee qualquer echo no card mobile se existir). - Remover o filtro UI "Tipo" (header Popover B16 + select mobile em
MunicipalityFilters) e a sort keykinddos labels/selects de ordenação. - Encolher o contrato URL da lista: deixar de parsear/serializar
kind(bookmarks?kind=viram no-op após canonicalize). - Atualizar testes unitários da lista (
municipalityList.unit.spec.ts) e int que montam bundle/mapa com{ kind: … }só quando o teste estiver exercitando o filtro da lista — mapa/loader podem continuar aceitandokindno state até o state perder o campo. - Guardrails: sem migration, sem collection, sem Consent, sem server action; campo
kindno schema/admin/catálogo intacto; detalhe/dossiê/mapa/B8 intactos.
Decisões travadas
- Fill-in com plano próprio (sem ID B novo). Polish de densidade da lista, ~¼–½ dia, paralelizável, cortável. (2026-07-25, classificação roadmap-item.) Rejeitado: B24 de trilha (infla grafo para remoção de coluna); absorver só em B17 (hide/show não substitui “não deveria existir”); só R6 (atrasa quick win).
- Remover coluna + filtro + sort
kindda lista — não só a célula. Sem coluna, filtro órfão no header é ruído; sort sem coluna é inconsistente com B15. Pedido de produto: ZE ≡ município operacionalmente; Salvador cobre o recorte. Rejeitado: manter?kind=na UI “por se”; deixar sortkindno select mobile sem coluna. - Encolher URL: drop de
kindno parse/serialize/MunicipalityListState. Contrato congelado do Pass 2 W1 / B18: remoção deliberada de um param morto, não adição. Bookmarks e filtros salvos futuros que carreguemkindperdem o recorte (aceitável — path canônico = slugs de Salvador). Rejeitado: parse silencioso sem UI (param zumbi); manter param “por compat” sem consumidor. - Schema / catálogo
kindpermanece. Geografia read-only; consumidores fora da lista (mapa, B8 bairros, dossiê, labels de detalhe). Rejeitado: migration dropkind(caro, quebra remodelagem); fundir as 19 ZE num único município Salvador (fora de escopo — decisão M1). - i18n e naming (AGENTS.md): identificadores (
kind,municipalityKindLabels) podem permanecer onde o domínio ainda usa; strings “Tipo” / “Zona eleitoral” saem só das superfícies de lista.
Questões em aberto
- Testes int de mapa que passam
{ kind: 'zona' }no state da lista — refatorar para filtro por slugs de Salvador, ou manter um path interno de where porkindsó no loader? Opções: A) testes passam a filtrar porslugsdas 19 ZE | B) helper internowhereKindsó para testes | C) manterkindno state sem UI. Recomendação: A — alinha teste ao path de produto; C contradiz a decisão URL. (assumido) - Badge “Tipo” no dossiê / detalhe (
municipalityKindLabelsna capa) — cortar também? Opções: A) manter no detalhe (contexto geográfico pontual) | B) remover em toda UI. Recomendação: A — o pedido é a lista; no detalhe de uma ZE o tipo ainda orienta (B8 bairros). (assumido — validar com produto se o critique da lista pedir paridade)
Abordagem proposta
flowchart LR
list["MunicipalityList"] --> cols["CampaignTable columns"]
cols -.->|remove| kindCol["id: kind"]
url["municipalityListUrl"] -->|drop kind| state["MunicipalityListState"]
filters["municipalityListFilters"] -->|drop definition| ui["Header + mobile"]
domain["municipality.kind schema"] --> detail["Detalhe / mapa / B8"]
Componentes:
MunicipalityList(src/components/campaign/municipality/MunicipalityList.tsx): remover o bloco de colunaid: 'kind'; dropar import demunicipalityKindLabelsse ficar órfão neste arquivo.municipalityListUrl.ts: remover'kind'deMunicipalityListSortKey/ labels /MunicipalityListState/municipalityListParamNames/ parse / serialize /buildMunicipalityListWhere.municipalityListFilters.ts: remover definitionparam: 'kind',applyMunicipalityKindFilter, ramos em summary/hasActive; ajustar tiposMunicipalityFilterParamegetMunicipalitySingleFilterValue(fica sócoverageexclusivos se ainda precisar).MunicipalityHeaderFilter/MunicipalityFilters: remover ramos single-select de Tipo (comentários “Tipo is the only single-select” → coverage/toggle ou o que sobrar).municipalityPageData.ts: map de sort Payloadkind: 'kind'— dropar a entrada.- Testes:
tests/unit/municipalityList.unit.spec.ts(hrefs/applyMunicipalityKindFilter); intmunicipalityPageData/municipalityMapDataque usam{ kind }no state da lista → slugs Salvador ou where direto. - B17 / B22 / planos vizinhos: não editar planos entregues em massa; na implementação, se B17 listar
kindcomo coluna toggleável, o id some naturalmente ao sumir da definição de colunas. - Migration: Sem migration, sem collection, sem server action.
Depth check: só delete/estreitamento nos módulos profundos já donos do contrato da lista — sem wrapper novo.
Dependências
- Nenhuma dura de outro plano. Soft: B15 ✓ / B16 ✓ (header); B17 (uma coluna a menos no seletor); B18 (param a menos no subset URL).
Não escopo
- Remover ou alterar
municipality.kindno Payload / seed / catálogo — modelo geográfico da remodelagem. - Unificar as 19 ZE de Salvador numa linha — decisão M1 / B8.
- Seletor mostrar/ocultar colunas — B17.
- Explicação no header / tooltip de célula — B22 / B23.
- Filtro “cidade Salvador” como atalho dedicado (chip) — desnecessário se o popover de Município + busca “Salvador” bastar; ver Adiado.
Rabbit holes
- Drop schema
kind. Explode migration + mapa + B8 + dossiê. Mitigação: UI da lista só; schema intocado. - Atalho “Salvador (19 zonas)” como filtro de primeira classe. Segunda taxonomia paralela a
kind. Mitigação: reusar multi-slug; defer se campo pedir atalho após uso. - Reescrever B17/B18/planos históricos. Diff cosmético sem valor. Mitigação: nota aqui; implementação atualiza só código vivo.
Adiado com gatilho
- Chip / preset “Salvador (zonas)” no popover de Município. Revisitar quando: ≥1 ator de campo pedir o atalho depois de perder
?kind=zona, ou evidência de que marcar 19 slugs à mão atrita. - Remover
municipalityKindLabelsda capa do dossiê / detalhe. Revisitar quando: produto pedir a mesma regra “tipo não importa” fora da lista.
Referências
docs/roadmap.md(Fill-ins abertos)src/components/campaign/municipality/MunicipalityList.tsx— colunakind(~L262–270)src/utilities/municipality/municipalityListUrl.ts— contrato URL / sort / where (Pass 2 W2)src/utilities/municipality/municipalityListFilters.ts— definitions (semkinddesde 2026-07-29)src/components/campaign/municipality/MunicipalityHeaderFilter.tsx— single-select Tiposrc/components/campaign/municipality/MunicipalityFilters.tsx— mobilesrc/utilities/municipalityLabels.ts—municipalityKindLabels(permanece para detalhe)tests/unit/municipalityList.unit.spec.ts— pins dekindna URL- icone-prioridade-lista-municipios.md — precedente fill-in Impeccable B na mesma lista
- filtros-no-header-lista-municipios.md — B16 (Tipo como coluna filtrável)
- seletor-colunas-lista-municipios.md — B17 (Tipo como candidata a hide; este item a remove)
- AGENTS.md — Município remodel; naming
PRODUCT.md/DESIGN.md— Field Desk, clareza sob pressão