mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-16 11:33:07 +00:00
9.7 KiB
9.7 KiB
Impl: Pessoas — ajustes da tabela desktop (contato completo, base sob o nome, caret, tooltips, "Dobra em", filtro/ordenação por partido)
Status: aprovado Atualizado em: 2026-08-11 Issue: #697 Intenção: docs/plans/pessoas-tabela-desktop-ajustes.md Appetite restante: herdado (~0,5–1 dia eng)
Leitura da intenção
- Outcome: a mesa lê a tabela desktop de
/campanha/pessoassem perder dado (telefone cortado, base espremida, caret sumido) e encontra pessoas por partido — cinco ajustes de superfície, sem fluxo novo, sem migration, sem mudança de modelo. - O que NÃO negociar: renomear só o LABEL "Aliada em" → "Dobra em" (chave de URL/ordenação
aliadaesortintactas); facet de ausência "Sem base" e ordenação por Base permanecem; partido continua exibido como sufixo do nome (sem coluna própria); mobile muda apenas o label; leader lockdown / escopo de assessor intactos. - O que reavaliar:
- A hipótese "larguras por coluna" generalizada: rejeitada — corte do próprio rabbit hole da intenção ("generalizar só com 2º consumidor"). Ajustes via
cellClassNamenas colunas de pessoas (padrão já usado:max-w-56 whitespace-normaldo e-mail) + uma prop mínima no shell compartilhado de chips (RelationChipCell) onde o pisomin-w-56é o culpado das colunas de município largas quando vazias. O mecanismo de largura doCampaignTablenão ganha nada novo. - A hipótese "caret via CSS" no
CampaignInlineEditableCell: o mecanismo C116 (input invisível sobre o link) exige troca de papéis no focus (link some de vista, input vira o display com caret real) — alinhamento exato do caret, sem z-index puzzle. - C129 não está nesta entrega: a 2ª linha do Nome é só a base (cidade); a precedência "legenda sobrepõe base" é da entrega C129 quando ela entrar.
- Consequência de produto do gate (coluna Base removida): a edição inline da cidade some da tabela (fica no detalhe da pessoa / admin) — a linha vira display-only, como o card mobile já era.
- A hipótese "larguras por coluna" generalizada: rejeitada — corte do próprio rabbit hole da intenção ("generalizar só com 2º consumidor"). Ajustes via
Abordagem recomendada
flowchart LR
A[peopleListUrl: param party + sort key Partido] --> B[peopleData: filter/sort/facet party]
B --> C[peopleListFilters + peopleOmnibox + PeopleFilters]
C --> D[page.tsx: colunas — remove base, 2a linha cidade, larguras, tooltips, Dobra em]
D --> E[RelationChipCell: prop min-width p/ células de município vazias]
D --> F[CampaignInlineEditableCell: caret visível no foco]
Opções consideradas:
- Larguras: A) mecanismo novo de largura por coluna no
CampaignTable— rejeitado (2º consumidor inexistente; toca todas as listas); B)cellClassNamelocalizado + propminWidthClassName(defaultmin-w-56) noRelationChipCell/MunicipalityPortfolioCell/PeopleMunicipalityCell, pessoas passamin-w-32— recomendado. - Caret: A) z-index swap (caret do input acima do link) — alinhamento quebra para nomes longos (input rola internamente, link truncado não); B) troca de papéis no foco — link
opacity-0 pointer-events-none, input mostra textotext-primary font-medium px-0+caret-foreground— caret e texto do MESMO elemento, alinhamento exato; recomendado. C) contenteditable/fake-caret — rejeitado (rabbit hole do C116). - Tooltip em desabilitados: botão
disablednão dispara mouse events — envolver num<span>receptor doCampaignHoverTooltip(padrão Radix documentado); recomendado. - Partido (facet dinâmico): precedente exato do facet de município (valores do recorte + selecionados unionados, sem canonicalização "todas") — sem enum, sem lista fixa; recomendado.
Rejeitadas (gerais): renomear a chave aliada/ausencia=sem_base (contrato de URL público); remover a ordenação por Base (decisão do gate); coluna própria de Partido (anti-goal).
Componentes / mudanças
src/utilities/people/peopleListUrl.ts: estadoparties?: string[]; parampartyno parse/serialize (valores não-vazios, ≤ 40 chars, dedupe — precedente município, sem enum);peopleListSortLabels.party = 'Partido';peopleSortOptionLabelganhapartyno ramo de texto (A–Z/Z–A); default asc.basepermanece (sort). Chavealiadaintacta.src/utilities/people/peopleData.ts:filterPeopleRows— facetpartiesOR (matchrow.party);sortPeopleRows— case'party'(nulls por último, padrão B15);PeopleListFilterFacetsganhaparties: string[]+peopleFilterFacetsFromRows(union sobre rows escopadas + selecionados).src/utilities/people/peopleListFilters.ts:PeopleMultiFilterParam+='party';togglePeoplePartyFilter(valida 1..40 chars);formatPeopleActiveFiltersSummarylista partidos (filtro salvo B18 descreve o recorte).src/utilities/people/peopleOmnibox.ts: seeds grupoPartido(keywordspartido,sigla), chipsPartido: <sigla>, apply/remove.src/components/campaign/people/PeopleFilters.tsx: nova proppartyFilterOptions→ seeds (como município).src/app/(campaign)/campanha/(app)/pessoas/page.tsx:- coluna
baseremovida (some do picker B17 automaticamente; hidden no cookie fica inerte); - Nome:
cellClassName: 'max-w-72'(outliers truncam — o link já temtruncate); célula viraflex-colcom 2ª linha display-onlytruncate text-xs text-muted-foregroundcomrow.city(sem label, sem traço quando vazia); sufixo partido inalterado; - Contato:
cellClassName: 'min-w-40'e semwhitespace-normal(volta aowhitespace-nowrapdo TableCell — telefone nunca quebra;min-wgarante a largura contra o inputw-full); - municípios:
minWidthClassName="min-w-32"nas trêsPeopleMunicipalityCell(vazias ficam estreitas; com chips a largura segue o conteúdo até omax-w-56); - Ações: WhatsApp desabilitado ganha
CampaignHoverTooltip content="WhatsApp indisponível — sem celular"sobre<span>; Convidar desabilitado idem com "Convidar indisponível — sem celular" (o tooltip atual "Convidar" não dispara em botão disabled); - cards mobile: label
'Aliada em'→'Dobra em'(só isso no mobile); hasFiltersincluiparties.
- coluna
src/components/campaign/shared/RelationChipCell.tsx+MunicipalityPortfolioCell.tsx+PeopleMunicipalityCell.tsx: propminWidthClassName(default'min-w-56') no wrapper do RelationChipCell (2 ocorrências); pessoas passa'min-w-32'. Demais listas intactas.src/components/campaign/shared/CampaignInlineEditableCell.tsx: ramo permanent name-link — estadofocused(onFocus/onBlur); focado → linkopacity-0 pointer-events-none, inputtext-primary font-medium px-0 caret-foreground; desfocado → classes atuais (text-transparent caret-transparent px-1). Input não é o display quando não-focado — mecanismo C116 preservado.- Migration: nenhuma. Access / Consent: nenhum (staff-only, sem escrita nova).
- UI: Impeccable B — encaixe na tabela existente; shape → craft → critique → polish do caret e larguras no browser (playwright).
Dados → forma (se aplicável)
- Não se aplica (vínculos/texto, sem métrica). O facet de partido usa a forma padrão do sistema (omnibox, OR na facet) — mesma escolha já aceita nos outros facets.
Fases verificáveis
- URL + merge (partido) —
peopleListUrl.ts,peopleData.ts+ unit tests (peopleListUrl.unit.spec.ts,peopleMerge.unit.spec.ts). - Filtros/omnibox (partido) —
peopleListFilters.ts,peopleOmnibox.ts,PeopleFilters.tsx,page.tsx(options + hasFilters). - Tabela (C130 core) —
page.tsx: colunas/larguras/2ª linha/renome/tooltips; props de min-width no shell; caret noCampaignInlineEditableCell. - Verificação visual — browser (playwright): caret ao digitar no Nome, telefone inteiro, colunas vazias estreitas, tooltips (inclusive desabilitados), "Dobra em".
- Gates —
pnpm gate:fast(tsc, lint, format, knip, cycles, unit+int), e2ecampaignPeople,pnpm buildlocal.
Rabbit holes / Não escopo (engenharia)
- Não mexer em
min-w-56/max-w-56das outras listas (lideranças/dobradinhas/assessores) — prop com default preserva o comportamento. - Não canonicalizar "todos os partidos" como sem-filtro (precedente município — o facet é dinâmico, o parse não conhece o conjunto).
- Não mudar
field="party"/field="city"doCampaignInlineEditableField(dobradinhas usaparty;citysai de uso nesta página mas o membro fica — outros consumidores futuros). - Sem tooltip custom em
DeletePersonButton(já coberto, sempre habilitado). - Caret em nomes muito longos (truncados): aceito como edge do mecanismo — o input é o display enquanto focado, então caret e texto nunca divergem.
Riscos e mitigação
max-w/min-wemtdauto-layout: padrão já comprovado nas colunas atuais (max-w-56no e-mail/municípios). Mitigação: verificação visual no browser em tela 1280px com dados largos.- Troca de papéis do caret ≠ mecanismo travado no gate C116: o contrato (draft no texto do link, input sem estado de edição, link clicável) é preservado — só o estado focado muda a camada visível. Documentar no changelog.
- Tooltip em span envolve controle desabilitado: acessibilidade mantida via
aria-labelexistente no botão; o span não ganha tab stop. - E2E: nenhuma asserção existente usa "Aliada em"/"Base" — rename seguro. Int
peopleList.int.spec.tsganha cobertura do facet de partido (a fixture de dobradinha temparty).
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (todos os 7 itens)
- Invariantes AGENTS/engineering-standards (sem migration, sem access, staff-only)
- Testes de domínio previstos: unit (URL party + sort party + filter/facet party), int (facet partido no recorte)