mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-22 04:53:09 +00:00
Extends POST /campanha/home-search with leadership hits (word-start, advisor scope, cap 25) and HomeSearchLeadershipGroup below Municípios.
82 lines
4.6 KiB
Markdown
82 lines
4.6 KiB
Markdown
# 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](../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 em `contact.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/`actions` opcional 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
|
||
|
||
```mermaid
|
||
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` + `contains` no 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 — considerar `pg_trgm` ou prefixo SQL.
|
||
- **Staff gate duplicado** (`isStaffCampaignRole` em 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.
|
||
- **`HomeSearchGroup` wrapper** 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](busca-global-resultados-municipios.md) § Adiado e [busca-global-resultados-assessores.md](busca-global-resultados-assessores.md) § Adiado.
|
||
|
||
## Já resolvido no simplify (2026-07-29 — não reabrir)
|
||
|
||
- `populatedContactName` em vez de helper local; nomes de município via `depth: 1` (sem `loadMunicipalityLabelsByIds` extra).
|
||
- Sort + `slice(25)` antes de montar `municipalitiesSummary`; `select` no find; `Number.isFinite` em `Date.parse(updatedAt)`.
|
||
- `homeSearchLeadershipGroupHasHits`; empty state e shell alinhados ao padrão B50/B68.
|
||
- Rebase com **B50** + **B68**: `tieBreakDesc` (não `tieBreaker`); `showPriority` no `HomeSearchHitRow`; `resultKind === 'search'` no empty; ordem Municípios → Lideranças → Assessores.
|
||
|
||
## Referências
|
||
|
||
- [busca-global-inicio-input.md](busca-global-inicio-input.md) · `utilities/leadership/leadershipData.ts` (`loadLeadershipListPageData`) · `/campanha/liderancas/[id]` · B28 (`whatsAppHrefForPhone` em `lib/phone.ts`)
|