Extends POST /campanha/home-search with leadership hits (word-start, advisor scope, cap 25) and HomeSearchLeadershipGroup below Municípios.
4.6 KiB
Busca global — resultados Lideranças
Status: entregue (2026-07-29)
Atualizado em: 2026-07-29 — as-built: searchHomeLeaderships (utilities/homeSearch/); campo leaderships no POST /campanha/home-search; HomeSearchLeadershipGroup abaixo de Municípios; HomeSearchHitRow compartilhado; homeSearchHasAnyHits no empty state; word-start em contact.name + pré-filtro contains; secundário = municípios (truncatedNamesLabel); cap 25; sem WA (B55). Int: homeSearchLeaderships.int.spec.ts.
Item do roadmap: docs/roadmap.md (Trilha B, item B49 — busca global)
Impeccable: B — grupo de hits no slot B47
Appetite: ~0,5–0,75 dia eng; loader + grupo UI; sem WA (B55)
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md / DESIGN.md · lista /campanha/liderancas · tema campaign.
Na implementação: craft compacto → critique → polish.
Brief: staff acha uma liderança pelo nome; toque abre a ficha. Sem card. Grupo “Lideranças” só se houver hit.
Dados → decisão → apresentação
Dados: N/A como KPI — identificação (nome + contexto curto: município principal ou contagem). Forma: lista. Sem chart.
Contexto
Slot B47; grupo secundário abaixo de Municípios (B48). Clique → /campanha/liderancas/[id] (rota existente). Ação WhatsApp à direita = B55.
Objetivos
searchHomeLeaderships(query, user)com access existente (overrideAccess: false); match emcontact.name(mesmo espírito da busca da lista /wordStartFilter).- Grupo título “Lideranças”; oculto se vazio.
- Linha: nome em destaque; linha secundária discreta (ex. municípios resumidos ou setor — o que o loader já tiver barato); sem trailing WA neste item (reserva slot/
actionsopcional para B55). - Sem migration / Consent.
Decisões travadas
- Navega para detalhe existente. Rejeitado: drawer de preview nesta fatia.
- Sem WhatsApp aqui — B55. Rejeitado: copiar o ícone do B28 agora e divergir depois.
- i18n:
HomeSearchLeadershipHit; título “Lideranças”.
Questões em aberto
- Secundário: lista de municípios vs status de apoio? Opções: A municípios (curto) | B status. Recomendação: A — alinha ao job “quem é de onde”. (assumido)
Abordagem proposta
flowchart LR
Q --> L["searchHomeLeaderships"] --> G["HomeSearchLeadershipGroup"] --> D["/liderancas/id"]
- Loader perto de
leadershipData.ts/ list where; UI no dashboard/search. - Migration: nenhuma.
Dependências
- Dura: B47. Soft: B48 (ordem visual — Municípios acima); B28 ✓ (telefone existirá para B55).
Não escopo
- WA → B55. Assessores/outros grupos → B50–B53. Layout grid → B54.
Rabbit holes
- Buscar por telefone. Mitigação: só nome no v1; gatilho se campo pedir.
Adiado com gatilho
- Scan completo de lideranças (
limit: 0+containsno DB, word-start em memória). Gatilho: base de lideranças crescer além do confortável da planilha / latência perceptível no Início — considerarpg_trgmou prefixo SQL. - Staff gate duplicado (
isStaffCampaignRoleem cada loader vs. só na rota). Gatilho: 3º provider no mesmo POST ou refactor do orquestrador. - Rename
homeSearchMunicipalityMatch.ts→ nome genérico (homeSearchNameMatch.ts). Gatilho: 3º domínio além de município/liderança/assessor no mesmo helper. HomeSearchGroupwrapper genérico para os grupos B48–B53. Gatilho: 3º grupo com a mesma casca (título + lista).- Orquestrador único do POST e carga duplicada herdada de B48/B50. Ver busca-global-resultados-municipios.md § Adiado e busca-global-resultados-assessores.md § Adiado.
Já resolvido no simplify (2026-07-29 — não reabrir)
populatedContactNameem vez de helper local; nomes de município viadepth: 1(semloadMunicipalityLabelsByIdsextra).- Sort +
slice(25)antes de montarmunicipalitiesSummary;selectno find;Number.isFiniteemDate.parse(updatedAt). homeSearchLeadershipGroupHasHits; empty state e shell alinhados ao padrão B50/B68.- Rebase com B50 + B68:
tieBreakDesc(nãotieBreaker);showPrioritynoHomeSearchHitRow;resultKind === 'search'no empty; ordem Municípios → Lideranças → Assessores.
Referências
- busca-global-inicio-input.md ·
utilities/leadership/leadershipData.ts(loadLeadershipListPageData) ·/campanha/liderancas/[id]· B28 (whatsAppHrefForPhoneemlib/phone.ts)