mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-20 18:24:45 +00:00
95 lines
7.1 KiB
Markdown
95 lines
7.1 KiB
Markdown
# C89 — Página Atualizações: feed de cards + filtro + criar (modal / bottom sheet)
|
||
|
||
Status: ready
|
||
Atualizado em: 2026-08-08
|
||
Issue: #401
|
||
Priority: P1
|
||
Model: cursor-grok-4.5-medium
|
||
Model-local: deepseek-v4-high
|
||
Impeccable: D — superfície nova: feed campanha-wide + criação in-place (modal ↔ bottom sheet)
|
||
Canvas UI: `/home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-41rz/canvases/plan-c89-ui-draft.canvas.tsx`
|
||
Appetite: ~1,5–2 dias eng; um outcome verificável — staff acompanha o que aconteceu na carteira num só lugar e registra novo fato sem sair da página
|
||
Responsável: —
|
||
|
||
## Intenção
|
||
|
||
A barra mobile (**B164**) já aponta **Atualizações** para `/campanha/atualizacoes` — hoje um placeholder honesto ("em breve"). Este item entrega a **página de verdade**: um **feed de cards de atualização**, mais recentes no topo, com um **filtro combinado** (mesmo padrão da lista de Municípios) e um **botão "+"** à direita do filtro que abre a criação de uma nova atualização — **modal em desktop, bottom sheet no mobile**. A discussão em fios por atualização é camada futura (**C88**), **não** bloqueia esta página.
|
||
|
||
## Persona e fluxo
|
||
|
||
- **Persona / contexto:** coordenador / assessor varrendo a carteira no celular ou na mesa; assessor vê só os municípios que administra.
|
||
- **Job principal:** ver o que aconteceu recentemente (e registrar um fato novo) sem entrar em cada município.
|
||
- **Fluxo desejado:**
|
||
1. Abre **Atualizações** → feed cronológico da carteira do ator (mais recentes no topo).
|
||
2. Usa o **combobox de filtro** acima do feed para estreitar por **município, polaridade, urgente, quem criou** ou **busca por texto** — um combobox só, no padrão omnibox das listas.
|
||
3. Toca **"+"** ao lado do filtro → **modal** (desktop) / **bottom sheet** (mobile) → preenche texto + polaridade (+ urgente) → confirma → volta ao feed com o novo card no topo.
|
||
- **Anti-goals de produto:** tracker estilo Jira; thread/comentário/deliberação nesta fatia (→ **C88**); scroll infinito/KPI; feed público/liderança; misturar Demandas/Atividades; segundo modelo de atualização.
|
||
|
||
### Esboço de fluxo (D)
|
||
|
||
```text
|
||
[Atualizações]
|
||
→ feed (carteira, mais recentes no topo)
|
||
→ filtro combobox acima do feed
|
||
→ "+" → modal (desktop) / bottom sheet (mobile) → nova atualização
|
||
→ novo card no topo
|
||
```
|
||
|
||
## Objetivo e aceite
|
||
|
||
- **Atualizações** deixa de ser placeholder: rota de feed usável por staff no escopo da carteira, cards mais recentes primeiro.
|
||
- Card mostra o essencial do fato: **avatar de quem criou** (canto superior esquerdo), texto, polaridade, urgente, autor, identidade do município e data.
|
||
- **Filtro combobox** acima do feed, mesmo padrão do filtro da lista de Municípios (`/campanha/municipios`); cobre **município, polaridade, urgente, quem criou e busca por texto**.
|
||
- Botão **"+"** à direita do filtro abre a **criação de nova atualização**: modal em desktop e **bottom drawer/sheet no mobile**; confirmação insere no feed sem recarregar a página à toa.
|
||
- Criar segue as regras existentes de acesso (staff; assessor só nos municípios que administra) e o formulário/registro atual unificado.
|
||
- **Leader lockdown** intacto: liderança não vê o feed nem cria atualização.
|
||
- Thread/comentário/deliberação ficam para **C88** — esta página não inventa um segundo protocolo.
|
||
|
||
## Dados (intenção)
|
||
|
||
- **Vou apresentar dados?** Sim, superfície neste item (feed operacional, não KPI estadual).
|
||
- **Decisões desbloqueadas:**
|
||
- Coordenação/assessor: "o que aconteceu na carteira desde ontem?"
|
||
- Registrar: "anotei o fato do dia" (mesmo formulário unificado já vivo).
|
||
- **Forma:** adiada ao plano de implementação — restrição: leitura relativa à carteira do ator; sem % estadual absoluto.
|
||
|
||
## Direção no codebase (hipótese)
|
||
|
||
- **Áreas prováveis:** rota `/campanha/atualizacoes` (substitui o placeholder), componentes de feed e de criação de atualização no domínio do município, filtro/omnibox no padrão das listas, preview de bottom sheet já usado na área; loaders escopados ao papel do ator.
|
||
- **Precedente a olhar:** feed de atualizações do detalhe do município; formulário unificado de atualização já existente; filtro combobox/omnibox de Municípios (B127/B128/B120); avatar de usuário da campanha (foto ou iniciais); bottom sheet (B112/B109); dashboard "últimas atualizações de campo".
|
||
- **Risco de acoplamento:** access por município (assessor = carteira); não criar pessoa fora de `campaignUser`/`Contact`; não duplicar o registro de atualização — reusar o fluxo de criação existente; serialização com trabalho de C87/C88 se tocar schema.
|
||
|
||
## Dependências
|
||
|
||
- Soft: **C87** (modelo unificado já vivo no card/formulário — sem dura).
|
||
- Soft: **C88** (thread/discussão futura sobre os mesmos cards — não bloqueia esta página).
|
||
- Soft: **B164** (slot da barra já aponta para a rota — esta página substitui o placeholder).
|
||
|
||
## Fora de escopo
|
||
|
||
- Thread, comentário, responsável e "resolvido" por atualização → **C88** (depois; sobre os mesmos cards).
|
||
- Chrome da barra inferior / página Mais → **B164**.
|
||
- Redesign do formulário de registro (já unificado em **C87**).
|
||
- Analytics, scroll infinito, kanban, mentions/reações, feed público ou de liderança.
|
||
|
||
## Rabbit holes de produto
|
||
|
||
- **"Feed + thread no mesmo item."** Estoura appetite e acopla à deliberação (C88). **Corte:** só feed + filtro + criar; fio fica com C88.
|
||
- **"Filtrar por tudo."** Combobox vira BI. **Corte:** as dimensões pedidas (município, polaridade, urgente, quem criou, texto) são o teto — sem analytics, _saved filters_ nem cruzamento adicional.
|
||
- **"Botão + = formulário novo e diferente."** Segundo registro. **Corte:** reusar o fluxo/formulário unificado existente.
|
||
- **"Card clica e abre thread que não existe."** Expectativa furada. **Corte:** card lê o fato; interação de fio quando C88.
|
||
|
||
## Questões em aberto (produto)
|
||
|
||
- **Filtro do feed** — _resolvido (gate 2026-08-08):_ inclui **município, polaridade, urgente, quem criou e busca por texto** num único combobox (padrão omnibox, sugestões agrupadas).
|
||
- **Município ao criar:** obrigatório, com prefill do município do filtro ativo — _confirmado (gate 2026-08-08)._
|
||
- **Clique no card:** só leitura em v1 (sem thread, sem navegar) — _confirmado (gate 2026-08-08)._ Discussão vem com **C88**.
|
||
- **Avatar do autor:** no canto superior esquerdo do card (foto ou iniciais, como o restante da área) — _pedido no gate 2026-08-08._
|
||
|
||
## Referências
|
||
|
||
- GitHub Issue: [#401](https://github.com/fsolla/teqo/issues/401)
|
||
- Canvas UI (gate): [`plan-c89-ui-draft.canvas.tsx`](/home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-41rz/canvases/plan-c89-ui-draft.canvas.tsx)
|
||
- Irmão chrome: [barra-navegacao-inferior-mobile.md](barra-navegacao-inferior-mobile.md) (**B164**)
|
||
- Camadas futuras: [deliberacao-atualizacao-responsavel-thread.md](deliberacao-atualizacao-responsavel-thread.md) (**C88**), [atualizacao-unificada-polaridade-urgente.md](atualizacao-unificada-polaridade-urgente.md) (**C87**)
|
||
- Precedentes: filtro combobox de Municípios (B127/B128/B120), bottom sheet (B112/B109), `MunicipalityUpdateFeed`/form unificado
|