mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 12:43:05 +00:00
150 lines
9.8 KiB
Markdown
150 lines
9.8 KiB
Markdown
# Bottom drawer — polimento dock + busca fullscreen + excluir entidade atual
|
||
|
||
Status: registrado
|
||
Atualizado em: 2026-08-01
|
||
Issue: #148
|
||
Priority: P1
|
||
Model: composer-2.5
|
||
Impeccable: C — chrome `CampaignQuickActionsDrawer` (geometria dock + modo busca)
|
||
Appetite: ~1–1,5d eng; snap + CSS botões + filtro de hits; sem migration
|
||
Responsável: —
|
||
|
||
## Design (Impeccable)
|
||
|
||
Âncoras: `PRODUCT.md` (Clarity under pressure; Feel the action; Continuity) / `DESIGN.md` · B79/B91/B100/B105 · Início `focused` (B65) · tema `data-theme='campaign'`.
|
||
|
||
Na implementação (`work-issue`): craft compacto → critique → polish (viewport ~390; detalhe município + lista).
|
||
|
||
Brief compacto:
|
||
|
||
- **Persona / contexto:** CG/assessor no celular **fora do Início** — dock para ações + busca; ao digitar/focar a busca, precisa de tela inteira sem o strip competindo.
|
||
- **Job principal:** (1) ler rótulos das ações sem corte; (2) busca com dock apertado na base; (3) ao focar a busca, drawer sobe cobrindo o header, só handle + input + resultados; (4) não sugerir/listar a entidade da página atual.
|
||
- **Estratégia de cor:** Restrained.
|
||
- **Edit where you see:** não — launchers / navegação.
|
||
- **Anti-goals:** scrim modal no dock idle; segundo FAB; redesenhar catálogos B80–B90; wizard return (→ **B110**); polish do Início (→ **B111**).
|
||
|
||
### Wireframe (texto)
|
||
|
||
**1) Dock idle (não-Início):**
|
||
|
||
```text
|
||
┌─ /campanha/municipios/foo ─────────────────────┐
|
||
│ header + conteúdo │
|
||
├─ drawer DOCK ──────────────────────────────────┤
|
||
│ ═ handle │
|
||
│ [● Ajustar] [● Mudar] [● …] ← labels 2 linhas │
|
||
│ tendência cabe inteira; botão um pouco +largo│
|
||
│ ┌ Buscar na campanha ────────────────────────┐ │
|
||
│ └────────────────────────────────────────────┘ │
|
||
│ ← gap curto até safe-area / bottom │
|
||
└────────────────────────────────────────────────┘
|
||
```
|
||
|
||
**2) Busca focada / ativa (fullscreen):**
|
||
|
||
```text
|
||
┌─ drawer FULL (cobre header) ───────────────────┐
|
||
│ ═ handle │
|
||
│ ┌ Buscar na campanha ────────────────────────┐ │
|
||
│ └────────────────────────────────────────────┘ │
|
||
│ Sugestões / resultados (sem a entidade atual) │
|
||
│ … │
|
||
│ … │
|
||
└────────────────────────────────────────────────┘
|
||
Fora: strip de ações oculto; página atrás opaca
|
||
(não-modal continua — sem scrim que bloqueie? ver Decisões).
|
||
```
|
||
|
||
## Dados → decisão → apresentação
|
||
|
||
Dados: N/A como métrica nova — hits de `POST /campanha/home-search` já existentes; só **filtro de exclusão** da entidade do contexto.
|
||
|
||
## Contexto
|
||
|
||
Pós **B100/B105** o drawer tem dock + collapsed + labels `line-clamp-2`. Feedback de campo (2026-08-01):
|
||
|
||
1. **Gap** entre a barra de busca e o fundo da tela **grande demais** no dock.
|
||
2. Labels cortados na horizontal (ex. “Mudar tendênci”) — `CampaignHomeActionButton` fixa `w-[4.75rem]`.
|
||
3. Foco na busca deve espelhar o ritual do Início (`CampaignHomeLayout` `focused`): strip some, superfície sobe — mas no drawer precisa **cobrir o header** também.
|
||
4. Empty state / resultados ainda incluem a entidade da página atual (município/liderança/assessor/…), o que é ruído quando já se está nela.
|
||
|
||
## Objetivos
|
||
|
||
- Reduzir o espaçamento vertical **busca → bottom** no snap dock (gap do stack + padding do handle / safe-area); dock continua a caber strip + busca.
|
||
- Largura dos botões da strip **o suficiente** para o maior rótulo do catálogo em **duas linhas**, centralizado; retirar padding horizontal residual do controle se ainda existir; sem encolher hit target do círculo (<44 px).
|
||
- Ao **focus** do input de busca (e enquanto `uiFocused` / query ativa): snap **fullscreen** (`1` / `100dvh` — pin no craft); **ocultar** a strip de ações; sheet cobre o viewport inclusive `CampaignMobileTopBar`.
|
||
- Ao blur com query vazia / clear: voltar ao dock (ou collapsed se o scroll da página já tiver recolhido — ver Questões).
|
||
- Filtrar sugestões e resultados da busca para **excluir** a entidade do `CampaignQuickActionContext` da rota atual (slug/id por tipo).
|
||
- Guardrails: sem migration / Consent / escrita; Início fora deste drawer; leader lockdown intacto.
|
||
- **Tracer bullet:** e2e mobile em `/campanha/municipios/[slug]` — dock com label “Mudar tendência” legível → focus busca → strip ausente + handle no topo do viewport → hit do município atual **não** aparece nas sugestões.
|
||
|
||
## Decisões travadas
|
||
|
||
- **3º snap `full` só sob busca focada/ativa; idle continua dock|collapsed (B100).** Espelha Início `focused`. **Rejeitado:** sempre full; crescer só o dock sem snap novo (não cobre header de forma confiável).
|
||
- **Fullscreen não-modal (sem bloquear pointer na página) no appetite v1 — sheet cobre visualmente o chrome.** Overlay `modal={false}` já é o contrato B79; se o critique exigir scrim no full, Adiado. **Rejeitado:** tornar o drawer modal só no focus (muda a família de gesto / dismiss).
|
||
- **Exclusão client-side nos grupos de resultado + payload suggest, keyed pelo contexto da página** (`municipalitySlug` / `leadershipId` / `organizationSlug` / `activitySlug` / `demandSlug` / advisor id se houver). **Rejeitado:** mudar o ranking server-side do home-search neste item (blast maior; Início não precisa excluir “si mesmo”).
|
||
- **Botão: aumentar `w-*` (ou `min-w`) o mínimo que caiba “Mudar tendência” / “Atualizar liderança” em 2 linhas; não multi-width por label.** **Rejeitado:** `w-auto` solto (quebra snap/pan da strip); fonte menor.
|
||
- **Item novo (B109), não reabrir B105/B100.** Continuação de polimento. **Rejeitado:** editar só as-built antigo sem Issue.
|
||
- **i18n:** ids `full` snap / `excludeCurrentEntity`; copy pt-BR intacta.
|
||
|
||
## Questões em aberto
|
||
|
||
- **Após blur da busca com query vazia, voltar a qual snap?** **Opções:** A) sempre dock | B) dock se `scrollTop` baixo, senão collapsed. **Recomendação:** **B** — respeita o ritual B100 de leitura. _(assumido)_
|
||
- **Excluir também visitados recentes / geo suggest quando forem a entidade atual?** **Opções:** A) sim, qualquer hit com o mesmo id/slug | B) só grupo “Sugestões” server. **Recomendação:** **A**. _(assumido)_
|
||
|
||
## Abordagem proposta
|
||
|
||
```mermaid
|
||
flowchart TB
|
||
Focus["input focus / uiFocused"] --> Full["snap FULL"]
|
||
Full --> Hide["strip hidden"]
|
||
Full --> Cover["sheet cobre header"]
|
||
Ctx["QuickActionContext"] --> Filter["excludeCurrentEntity(hits)"]
|
||
Filter --> Groups["HomeSearch*Group"]
|
||
Dock["snap DOCK"] --> Gap["menos gap busca↔bottom"]
|
||
Dock --> Width["ActionButton w- maior"]
|
||
```
|
||
|
||
Componentes:
|
||
|
||
- **`campaignQuickActionSnap.ts`**: adicionar `QUICK_ACTIONS_SNAP_FULL`; helpers `quickActionsSnapIsFull` / `isDock`.
|
||
- **`CampaignQuickActionsDrawer.tsx`**: reagir a `uiFocused` (já em `HomeSearchContext` no host) → `setSnapPoint(FULL)`; ocultar strip; ordem visual handle → busca → resultados no full; apertar padding/gap no dock.
|
||
- **`CampaignQuickActionsHost` / scroll peek**: peek height no full = full viewport (ou não reservar padding absurdo no content scroll enquanto full).
|
||
- **`CampaignHomeActionButton.tsx`**: largura do controle; pin visual/unit se houver snapshot de classe.
|
||
- **Filtro:** helper puro `excludeHomeSearchHitForContext(hit, context)` em `lib/`; aplicar nos grupos ou no merge do `HomeSearchResultsContext` quando montado sob o drawer (prop/`data-exclude` via provider leve). Evitar poluir o Início.
|
||
- **Migration:** Sem migration, sem collection, sem server action nova.
|
||
|
||
## Dependências
|
||
|
||
- Soft: B100 ✓, B105 ✓, B91 ✓, B79 ✓. Nenhuma dura.
|
||
- Paralelo: **B110** (return path wizard), **B111** (Início strip/delta) — sem `depends` duro.
|
||
|
||
## Não escopo
|
||
|
||
- Redirect pós-wizard → **B110**.
|
||
- Faixas brancas / delta flat do Início → **B111**.
|
||
- Redesign do catálogo de ações / novos verbos.
|
||
- Busca leader / rotas fora do drawer staff.
|
||
|
||
## Rabbit holes
|
||
|
||
- **Reescrever o primitivo `Drawer.tsx` para todos os sheets.** Mitigação: override só no chassis quick-actions; Base UI snap já usado.
|
||
- **Segundo `HomeSearchProvider` / fork do suggest API.** Mitigação: filtro no client com contexto já sincronizado.
|
||
- **Animar header aparte do snap.** Mitigação: cobrir com o sheet; não esconder o top bar via layout.
|
||
|
||
## Adiado com gatilho
|
||
|
||
- **Scrim no snap full.** Revisitar se critique de campo disser que o conteúdo atrás distrai durante a busca.
|
||
- **Exclusão server-side no `home-search`.** Revisitar se o payload vier grande demais para filtrar no client.
|
||
|
||
## Referências
|
||
|
||
- GitHub Issue #148 (spec + frontmatter `id/depends/priority/model`)
|
||
- `src/components/campaign/shell/CampaignQuickActionsDrawer.tsx` — chassis
|
||
- `src/lib/campaignQuickActionSnap.ts` — snaps
|
||
- `src/components/campaign/dashboard/CampaignHomeActionButton.tsx` — `w-[4.75rem]`
|
||
- `src/components/campaign/dashboard/CampaignHomeLayout.tsx` — precedente `focused`
|
||
- `src/lib/campaignQuickActionContext.ts` — entidade atual
|
||
- `docs/plans/bottom-drawer-peek-acoes-busca.md` (B100), `bottom-drawer-handle-scroll-peek.md` (B105)
|
||
- AGENTS.md — Campaign auth; naming EN / copy pt-BR
|
||
- `PRODUCT.md` / `DESIGN.md` — Field Desk / Continuity
|