9.2 KiB
Renomear coluna "Cobertura da meta" → "Cobertura"
Status: entregue (2026-07-28)
Atualizado em: 2026-07-28
Item do roadmap: docs/roadmap.md (Fill-ins)
Impeccable: B — encaixe no header/card de /campanha/municipios; sem rota nova
Appetite: ~0,25 dia eng (ou menos); só strings + pins de teste; sem migration
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (clareza sob pressão; anti spreadsheet) / DESIGN.md (register product; Field Desk) · tema data-theme='campaign' · precedente A11 (header curto 2022, definição no hover).
Na implementação (implement-roadmap-item): craft compacto → critique → polish (copy only; sem redesign).
Brief compacto:
- Persona / contexto: CG / Assessor varre a fila (E9); o header "Cobertura da meta" compete em largura com células curtas (
80%/ déficit) e com sort+funil no mesmo<th>. - Job principal: ler a coluna de cobertura de meta com um rótulo curto; o que a métrica significa fica no tooltip do header (B22) / glossário (E18 ✓).
- Estratégia de cor: Restrained — nenhuma superfície nova.
- Edit where you see: não — só rename de leitura.
- Anti-goals: renomear o conceito do glossário; fundir com o param URL
coverage(assessores); inventar segundo rótulo "Cobertura %" / "Meta %".
Dados → decisão → apresentação
Dados: N/A — este item não altera fórmula, denominador nem apresentação numérica. Só o rótulo da coluna (e o label de sort deficit que a acompanha). A métrica continua comprometido ÷ meta (E8).
Contexto
No E8 a coluna antiga "Cobertura" (= tem assessor) foi renomeada para "Assessoria" para abrir espaço ao rótulo longo "Cobertura da meta". No B16 a coluna "Assessoria" saiu (ordenação/filtro de assessores moram em "Assessores"); o comentário em municipalityListUrl.ts já antecipa: "Cobertura alone now reads as the goal one (deficit)" — mas o header ainda diz "Cobertura da meta".
Pedido de produto (2026-07-25): coluna = "Cobertura". Mesmo padrão do A11 (2022 em vez de "Concentração 2022"): título curto na tabela; definição no hover (B22 consome oneLiner de cobertura-da-meta no E18).
Onde a string aparecia na lista (pré-B17 o header citava children; pós-B17 ✓ o SSoT é municipalityListSortLabels.deficit → municipalityColumnLabels.goalCoverage → header/picker/sort):
- Header desktop:
MunicipalityList.tsxcolunaid: 'goalCoverage'→MunicipalitySortableHeadsortKey="deficit"(label do registro de sort). - Card mobile:
<dt>viamunicipalityColumnLabels.goalCoverage. - Sort select / summary:
municipalityListSortLabels.deficit.
Fora da lista (não escopo deste fill-in): strip do dashboard/overview, card "Conta da cadeira", dossiê, título do conceito em /campanha/conceitos — o nome canônico da métrica continua "Cobertura da meta".
Objetivos
- Em
/campanha/municipios(staff): header da colunagoalCoveragee<dt>do card mobile mostram "Cobertura". municipalityListSortLabels.deficit(e qualquer summary que o cite) alinhado a "Cobertura".- Pins de teste da lista atualizados (
campaignComponents.unit.spec.tsespera a string nova; o teste decoverage→ "Assessores" pode reforçar quedeficit→ "Cobertura"). - Guardrails: sem migration, sem collection, sem Consent, sem server action, sem mudança de sort key / URL (
deficitpermanece); glossário E18 e KPIs do strip intactos.
Decisões travadas
- Fill-in com plano próprio (sem ID B novo). Rename cosmético de coluna, ~¼ dia, paralelizável, cortável. (2026-07-25, classificação roadmap-item.) Rejeitado: B26 de trilha (infla grafo); absorver só em B22 (atrasa quick win atrás de meio dia de tooltip); só R6.
- Só a superfície da lista (header + card + label de sort
deficit). Pedido = "coluna". KPI strips / card de detalhe / glossário mantêm o nome longo da métrica. Rejeitado: varredura global de "Cobertura da meta" (desfaz o título do conceito E18 e o heading e2e); renomear o conceito para "Cobertura" (ambíguo fora do contexto da tabela). - Ambiguidade com assessores já resolvida pelo B16. Sem coluna "Assessoria", "Cobertura" na lista = cobertura da meta. Param URL
coveragee sort keycoveragecontinuam = com/sem assessor (identificadores internos; labels já são "Assessores"). Rejeitado: renomear sort keydeficit→coverage(quebra bookmarks/?sort=deficit); segundo rótulo "Cobertura (meta)". - i18n e naming (AGENTS.md): identificadores (
goalCoverage,deficit,cobertura-da-meta) intactos; só strings visíveis da lista.
Questões em aberto
- Strips do dashboard / overview ("Cobertura da meta") — encurtar também? Opções: A) manter longo (mais espaço, KPI nomeado) | B) encurtar para "Cobertura" por paridade. Recomendação: A — o pedido é a coluna; strips não competem com sort+funil no
<th>. (assumido — validar no critique se a mesa achar inconsistência) - Ordenação mobile "Frescor do sinal" vs header "Último sinal" — tocar neste item? Opções: A) não | B) alinhar num fill-in separado. Recomendação: A — fora do pedido; se incomodar, fill-in próprio.
Abordagem proposta
flowchart LR
list["MunicipalityList"] -->|header + dt| label["Cobertura"]
url["municipalityListSortLabels.deficit"] --> label
tip["B22 tooltip / E18 oneLiner"] -.->|definição| header["th deficit"]
gloss["/campanha/conceitos"] -->|title intacto| long["Cobertura da meta"]
Componentes:
MunicipalityList.tsx:<dt>do card mobile usamunicipalityColumnLabels.goalCoverage(header desktop segue o mesmo registro via B17).municipalityListUrl.ts:municipalityListSortLabels.deficit = 'Cobertura'; comentário do sortcoveragejá documenta a intenção — confirmar que continua verdadeiro.- Testes:
tests/unit/campaignComponents.unit.spec.ts(toContain('Cobertura')/ deixar de exigir o sufixo "da meta" na lista); opcional pin emmunicipalityList.unit.spec.ts(deficit→"Cobertura"). - B22: ao implementar, o mapa de
descriptionda colunagoalCoveragejá aponta paracampaignConceptOneLiner('cobertura-da-meta')— o header curto + tooltip longo é o desenho desejado; não editar o plano B22 em massa neste fill-in. - Migration: Sem migration, sem collection, sem server action.
Depth check: só strings nos módulos que já donam a coluna — sem helper novo.
Dependências
- Nenhuma dura. Soft: B16 ✓ (liberou o nome "Cobertura"); A11 ✓ (precedente de header curto); B22 ✓ (tooltip carrega a definição); B17 ✓ (picker/header compartilham
deficit).
Não escopo
- Título do conceito / heading em
/campanha/conceitos— E18 ✓ (e2ecampaignConcepts.e2e.spec.tspermanece). - Labels do
CampaignMetricStrip(dashboard + overview) e doMunicipalityGoalAccountCard/ dossiê. - Label da coluna homônima em
/campanha/territorios(continua "Cobertura da meta" emterritoryListSortLabels.cobertura). - Seletor de colunas / explicação no header / tooltip de célula — consumidores de B17 ✓ / B22 ✓ / B23 ✓ (não reimplementar).
- Semântica ou sort key
deficit/ fórmula E8.
Rabbit holes
- Varredura "renomear tudo que diga Cobertura da meta". Quebra glossário + e2e + card. Mitigação: boundary = lista + sort label.
- Renomear
?sort=deficitou o idgoalCoverage. Quebra URL canônica / B18. Mitigação: só string visível. - Reabrir a coluna "Assessoria". Fora do pedido. Mitigação: B16 já decidiu.
Adiado com gatilho
- Encurtar "Cobertura da meta" nos strips / card de detalhe. Revisitar quando: critique/R6 ou CG pedir paridade explícita com a lista.
- Demais
<dt>do card mobile ainda literais (Classe, Nível, Tendência, …). Revisitar quando: fill-in remover coluna Tipo ou passada de paridade mobile na lista de municípios.
Referências
docs/roadmap.md(Fill-ins abertos)src/components/campaign/municipality/MunicipalityList.tsx— colunagoalCoverage+<dt>mobilesrc/utilities/municipalityListUrl.ts—municipalityListSortLabels.deficit(+ comentário emcoverage)tests/unit/campaignComponents.unit.spec.ts— pin da string na listatests/unit/municipalityList.unit.spec.ts— labels de sort- conta-da-cadeira.md — E8 (origem do rótulo longo)
- filtros-no-header-lista-municipios.md — B16 (saiu "Assessoria")
- ranking-votos-municipio.md — A11 (precedente header curto)
- explicacao-colunas-header-listas.md — B22 (definição no hover)
- remover-coluna-tipo-municipios.md — precedente fill-in Impeccable B na mesma lista
- AGENTS.md — naming; E8
PRODUCT.md/DESIGN.md— Field Desk
Revisão (2026-07-28)
Auditoria implement-roadmap-item: header não usa mais children do MunicipalitySortableHead — B17 centraliza rótulos em municipalityListSortLabels/municipalityColumnLabels. Entrega: deficit: 'Cobertura', mobile <dt> via municipalityColumnLabels.goalCoverage, whereItAppears do conceito E18 atualizado (lista curta; título longo intacto). TI fora de escopo.