teqo-backup/docs/plans/remover-coluna-tipo-municipios.md
Francisco Ignácio Fontoura Solla 288a9265d7 Docs: registra B20–B37, C13 (Atividade) e fill-ins de listas no roadmap e notebook.
Inclui 19 planos de produto (municípios, lideranças, dobradinhas, territórios) e alinha E12/B21 com camada-territorios-identidade.
2026-07-25 19:40:07 -03:00

10 KiB
Raw Blame History

Remover coluna Tipo da lista de Municípios

Status: rascunho Atualizado em: 2026-07-25 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; kind no schema continua read-only da geografia.
  • Anti-goals: redesign do header; seletor de colunas neste item (B17); apagar municipality.kind do 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" (desktop CampaignTable e qualquer echo no card mobile se existir).
  • Remover o filtro UI "Tipo" (header Popover B16 + select mobile em MunicipalityFilters) e a sort key kind dos 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 aceitando kind no state até o state perder o campo.
  • Guardrails: sem migration, sem collection, sem Consent, sem server action; campo kind no 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 kind da 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 sort kind no select mobile sem coluna.
  • Encolher URL: drop de kind no 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 carreguem kind perdem 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 kind permanece. Geografia read-only; consumidores fora da lista (mapa, B8 bairros, dossiê, labels de detalhe). Rejeitado: migration drop kind (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 por kind só no loader? Opções: A) testes passam a filtrar por slugs das 19 ZE | B) helper interno whereKind só para testes | C) manter kind no state sem UI. Recomendação: A — alinha teste ao path de produto; C contradiz a decisão URL. (assumido)
  • Badge “Tipo” no dossiê / detalhe (municipalityKindLabels na 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 coluna id: 'kind'; dropar import de municipalityKindLabels se ficar órfão neste arquivo.
  • municipalityListUrl.ts: remover 'kind' de MunicipalityListSortKey / labels / MunicipalityListState / municipalityListParamNames / parse / serialize / buildMunicipalityListWhere.
  • municipalityListFilters.ts: remover definition param: 'kind', applyMunicipalityKindFilter, ramos em summary/hasActive; ajustar tipos MunicipalityFilterParam e getMunicipalitySingleFilterValue (fica só coverage exclusivos 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 Payload kind: 'kind' — dropar a entrada.
  • Testes: tests/unit/municipalityList.unit.spec.ts (hrefs/applyMunicipalityKindFilter); int municipalityPageData / municipalityMapData que 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 kind como 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.kind no 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 municipalityKindLabels da 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 — coluna kind (~L262–270)
  • src/utilities/municipalityListUrl.ts — contrato URL / sort / where
  • src/utilities/municipalityListFilters.ts — definition + applyMunicipalityKindFilter
  • src/components/campaign/municipality/MunicipalityHeaderFilter.tsx — single-select Tipo
  • src/components/campaign/municipality/MunicipalityFilters.tsx — mobile
  • src/utilities/municipalityLabels.ts — municipalityKindLabels (permanece para detalhe)
  • tests/unit/municipalityList.unit.spec.ts — pins de kind na 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