teqo-backup/docs/plans/polimento-busca-municipio-wizard.md
Cursor Agent 746030d253
docs: registra OPS11 + B95–B99 (#102–#107) pós-gate
Matriz B98 confirmada (cadeia completa nos 4 entries). Cabeçalhos
dos planos com Issue # e status registrado.
2026-08-01 10:48:04 +00:00

118 lines
6.1 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.

# Polimento — busca de município no wizard (bullets, gaps, título mobile)
Status: registrado
Atualizado em: 2026-08-01
Issue: #103
Priority: P1
Model: composer-2.5
Impeccable: B — encaixe em `WizardMunicipalitySearchStep` + padding do `CampaignWizardShell`
Appetite: ~0,25–0,5d eng; CSS/markup; sem migration
Responsável: —
## Design (Impeccable)
Âncoras: `PRODUCT.md` (Clarity under pressure) / `DESIGN.md` · tema `data-theme='campaign'` · B60/B75 shells.
Na implementação (`work-issue`): craft compacto → critique → polish.
Brief compacto:
- **Persona / contexto:** CG/assessor no celular no passo 1 do ritual ação→município.
- **Job principal:** escanear hits sob a busca sem ruído visual; título “Em qual município?” colado ao chrome vermelho.
- **Estratégia de cor:** inalterada.
- **Edit where you see:** não — só layout do passo.
- **Anti-goals:** redesign da row (`HomeSearchHitRow`); mudar ranking B92–B94; cards.
### Wireframe (texto)
```text
┌─ header wizard (Mandate Red) ───────────────────────┐
│ Ajustar votos [X] │
└─────────────────────────────────────────────────────┘
┌─ conteúdo (pt menor no mobile) ─────────────────────┐
│ Em qual município? │ ← perto do header
│ ┌─ Buscar município ─────────────────────────────┐ │
│ │ Nome do município… │ │
│ └────────────────────────────────────────────────┘ │
│ ← gap curto (não gap-4) │
│ Cairu · Baixo Sul │ ← sem • bullet
│ Salinas da Margarida · … │
└─────────────────────────────────────────────────────┘
Fora do frame: chrome B75; suggest idle B92–B94.
```
## Dados → decisão → apresentação
Dados: N/A — apresentação de hits já existentes; sem métrica nova.
## Contexto
`WizardMunicipalitySearchStep` renderiza resultados em `<ul className="flex flex-col">` **sem** `list-none` — o UA desenha bullets. O stack interno usa `gap-4` entre input e região de resultados. O shell (`CampaignWizardShell`) aplica `py-6` no `<main>`, afastando o `h1` do header mobile Mandate Red (B75).
Pedido de produto (2026-08-01): remover bullets; encurtar distância lista↔busca; no mobile, aproximar o título do header.
## Objetivos
- Lista de hits sem marcadores (`list-none` + reset `m-0 p-0` no `ul`/`li`, alinhado a `CampaignHomeActionStrip` / grupos do Início).
- Gap input→resultados menor (recomendação: `gap-4` → `gap-2` no stack do passo 1; critique pode `gap-1.5`).
- No mobile, reduzir padding-top do conteúdo do wizard (recomendação: `main` `pt-3 pb-6 md:py-6` ou equivalente) — título mais perto do header; desktop inalterado ou quase.
- Sem migration / action / mudança de copy de empty tipado.
## Decisões travadas
- **Um item (B95) para os três ajustes da mesma superfície.** Mesmo passo, mesmo PR. **Rejeitado:** três Issues cosméticas (ruído no grafo).
- **Só markup/CSS do passo 1 + padding do shell; não reescrever `HomeSearchHitRow`.** **Rejeitado:** inventar row só do wizard.
- **Padding do shell: mobile-first no `CampaignWizardShell` (afeta todos os passos).** Título longe do header é problema mobile geral; reduzir `pt` no mobile beneficia tendência/sinal também. **Rejeitado:** wrapper só no search step (inconsistência entre passos). Se critique achar votos/tendência “apertados”, subir `pt` só onde `contentAlign`/`isEntryStep` — gatilho no polish.
- **i18n:** classes Tailwind; ids intactos.
## Questões em aberto
- **`gap-2` vs `gap-1` entre busca e lista?** **Opções:** A `gap-2` | B `gap-1`. **Recomendação:** **A** — ainda separa input da região live. _(assumido)_
- **`pt-3` vs `pt-2` no mobile do shell?** **Opções:** A `pt-3` | B `pt-2`. **Recomendação:** **A** no craft; B se ainda parecer “flutuando”. _(assumido)_
## Abordagem proposta
```mermaid
flowchart LR
Shell["CampaignWizardShell py mobile ↓"] --> H1["h1 stepTitle"]
Step["WizardMunicipalitySearchStep"] --> Input["CampaignSearchInput"]
Step --> Ul["ul list-none gap curto"]
Ul --> Row["HomeSearchHitRow"]
```
Componentes:
- **`WizardMunicipalitySearchStep.tsx`**: `gap-4` → `gap-2` no flex do passo; `<ul className="m-0 flex list-none flex-col p-0">` + `li` sem padding de lista.
- **`CampaignWizardShell.tsx`**: `py-6` → `pt-3 pb-6 md:py-6` (ou token equivalente pós-critique).
- **Testes:** unit smoke se já pinam classes; senão assert visual via class string / e2e não obrigatório.
- **Migration:** Sem migration.
## Dependências
- Soft: B60 ✓ / B75 ✓ / B92–B94 (suggest). Nenhuma dura.
- Nota: ver empty/suggest em **prod** depende de **OPS11** (deploy); o polimento em si não.
## Não escopo
- Ranking/geo/continuity do idle → B92–B94.
- X vs Pular → **B96**. Encadeamento → **B98**. Strip do Início → **B99**.
- Mudar placeholder/empty copy.
## Rabbit holes
- **“Já que mexo no shell, redesenho o h1 tipográfico.”** **Mitigação:** só padding.
- **Extrair `WizardResultList` genérico.** **Mitigação:** &lt;3 call sites; inline.
## Adiado com gatilho
- **Padding diferenciado por `isEntryStep`.** Revisitar se passos longos (nota de tendência) ficarem visualmente colados ao header após o `pt` global mobile.
## Referências
- `src/components/campaign/shared/WizardMunicipalitySearchStep.tsx`
- `src/components/campaign/shared/CampaignWizardShell.tsx`
- `src/components/campaign/dashboard/HomeSearchHitRow.tsx`
- [busca-municipio-wizard.md](busca-municipio-wizard.md) (B60) · [header-mobile-wizard-campanha.md](header-mobile-wizard-campanha.md) (B75)
- `PRODUCT.md` / `DESIGN.md`
Qualidade de decisão: 5/5