teqo-backup/docs/plans/crash-busca-bottom-drawer.md

Crash — busca no bottom drawer (focus / digitação)

Status: done Atualizado em: 2026-08-01 Issue: #129 (file-miss plan #133 · delivery #135) Priority: P0 Model: cursor-grok-4.5-medium Impeccable: B — CampaignQuickActionsDrawer + CampaignGlobalSearchBody Appetite: ~0,5–1d eng; root-cause + fix + pin focus/type; sem migration Responsável: —

Freshness audit (2026-08-01)

• Arquivos citados existem; assinaturas de useHomeSearch / useHomeSearchResultsState / drawer intactas.
• Sem migration; deps soft B91/B100 done.
• Root cause confirmada (repro unit): TooltipProvider no layout (app) envolvia só {children} dentro de CampaignAppScrollChrome. O drawer monta como irmão do scrollport → fora do provider. Focus → mode:suggest → hits priority:'alta' → MunicipalityPriorityIndicator → CampaignHoverTooltip → throw Tooltip` must be used within `TooltipProvider → página cai. Início não crasha porque o drawer não monta lá e a busca vive sob o provider dos children. Digitar com hits prioritários crashava pelo mesmo motivo; o pin B100 só mudava query com payload vazio (sem flag).

Design (Impeccable)

Âncoras: PRODUCT.md (Feel the action) · B91/B100 drawer search · tema campaign.

Na implementação: reproduzir → fix mínimo → pin (unit + e2e mobile se estável). Sem craft visual além do necessário para o ritual de busca voltar.

Brief:

• Persona: staff no detalhe de município (mobile); toca “Buscar na campanha” no drawer.
• Job principal: focar e digitar sem a página cair; ver suggest/hits.
• Anti-goals: redesenhar o drawer (→ B105); silenciar o throw com try/catch cosmético.

Wireframe (texto)

┌─ /campanha/municipios/foo (mobile) ────────────┐
│ conteúdo                                       │
├─ drawer dock ──────────────────────────────────┤
│ ═ handle                                       │
│ [ações…]                                       │
│ ┌ Buscar na campanha ──── focus/type OK ─────┐ │
│ │ Sugestões / hits (sem crash)               │ │
│ └────────────────────────────────────────────┘ │
└────────────────────────────────────────────────┘

Dados → decisão → apresentação

Dados: N/A neste item (hits já existem via B48/B68/B91); só estabilidade do chrome.

Contexto

Fora do Início, o drawer (B79–B91, B100 ✓) embute CampaignGlobalSearchBody sob CampaignGlobalSearchProvider em CampaignAppScrollChrome. Produto (2026-08-01): ao clicar ou começar a escrever na barra de busca, a página crasha.

Diagnóstico preliminar (código em main):

1. Unit do drawer (campaignQuickActionsDrawer.unit.spec.tsx) cobre change → POST mode: 'search', não focus → setInputFocused(true) → mode: 'suggest'.
2. useHomeSearchResultsState entra em suggestMode quando uiFocused && !query.isActive e monta os grupos B48 dentro do snap (overflow-hidden, dock 12rem).
3. CampaignContentScrollWithPeek chama useHomeSearch() — correto só dentro do provider; árvore atual amarra provider + peek. Hipótese secundária: interação Base UI Drawer non-modal + focus/teclado / nested Drawer dos action buttons.
4. Runtime Vercel (server) não mostra o digest do crash (erro de client).

Miss de agente: B100 / follow-up a056616d shipparam sem pin de focus+type no drawer. Registrar via pnpm agent:file-miss (kind:defect ou agent-miss) neste delivery, depois o fix.

Objetivos

• Reproduzir o crash (mobile real ou Playwright viewport mobile em /campanha/municipios/[slug]).
• Eliminar a causa raiz (não engolir o erro).
• Pins: unit focus dispara suggest sem throw; unit/e2e type mantém search; regressão no caminho provider/uiFocused.
• Guardrails: sem migration; leader lockdown; Início intacto.
• Tracer: focus no input do drawer → região de resultados monta; digitar “ca” → POST search; zero uncaught.

Decisões travadas

• Issue própria P0 + file-miss, não absorver em B105. Crash bloqueia o ritual. Rejeitado: “conserta no polish do drawer”.
• Fix mínimo no caminho focus→suggest→render; não redesenhar snap. Geometria/gesto → B105. Rejeitado: reescrever busca só para o drawer.
• File-miss obrigatório com causa + PR culpado quando conhecido. Rejeitado: só Issue de feature sem harvest.
• i18n: ids existentes; sem copy nova.
• Fix (as-built): elevar TooltipProvider no layout (app) para envolver CampaignAppScrollChrome inteiro (scroll + drawer). Harness unit espelha isso.

Questões em aberto

• (nenhuma — root cause fechada no repro unit; fix as-built acima)

Abordagem proposta

flowchart LR
  Focus["input onFocus"] --> Ui["uiFocused"]
  Ui --> Suggest["POST mode:suggest"]
  Suggest --> Groups["HomeSearch*Group"]
  Groups -->|crash?| Fix["fix root"]
  Type["onChange"] --> Search["POST mode:search"]

Componentes:

• Repro: Playwright mobile ou unit com fireEvent.focus + wait suggest; ler stack.
• Provável superfície: CampaignStaffGlobalSearch / HomeSearchResultsLayout / Drawer + focus; eventualmente provider tree se achar caminho sem HomeSearchProvider.
• Pins em tests/unit/campaignQuickActionsDrawer.unit.spec.tsx (+ e2e campaignMunicipalities se estável).
• Migration: Sem migration.
• File-miss: pnpm agent:file-miss -- --title "…" --kind defect com body apontando B100/a056616d e ausência de pin focus.

Dependências

• Soft: B91 ✓, B100 ✓. Nenhuma dura. B105 pode pousar depois (gesto/handle); não bloqueia o fix.

Não escopo

• Handle no topo / scroll abre / placeholder collapsed → B105.
• Remover título “Sugestões” → B103 (pode coincidir visualmente no empty, mas é copy).
• Strip bleed → B101.

Rabbit holes

• Trocar Base UI Drawer por sheet caseiro. Mitigação: só se a root cause for o primitivo e não houver escape hatch documentado.
• Duplicar CampaignHomeSearch “safe” só para drawer. Mitigação: consertar o shared.

Adiado com gatilho

• 3º snap alto só para resultados. Revisitar se, após o fix, critique de B105 mostrar hits cortados no dock.

Referências

• GitHub Issue #129 (B102) · file-miss #133
• CampaignQuickActionsDrawer.tsx · CampaignAppScrollChrome.tsx · CampaignQuickActionsHost.tsx · HomeSearchResultsContext.tsx · CampaignStaffGlobalSearch.tsx
• tests/unit/campaignQuickActionsDrawer.unit.spec.tsx
• AGENTS.md — Feel the action; client boundary