mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-16 11:33:07 +00:00
Conventions guard prevents regressing provider under CampaignAppScrollChrome. Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
124 lines
6.8 KiB
Markdown
124 lines
6.8 KiB
Markdown
# 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
|