teqo-backup/docs/plans/crash-busca-bottom-drawer.md
Cursor Agent 0174ae25db
B102 — pin layout TooltipProvider wrap + mark plan done
Conventions guard prevents regressing provider under CampaignAppScrollChrome.

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-08-01 18:18:19 +00:00

124 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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)
```text
┌─ /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
```mermaid
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