7.1 KiB
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:
- Abre Atualizações → feed cronológico da carteira do ator (mais recentes no topo).
- 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.
- 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)
[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
- Canvas UI (gate):
plan-c89-ui-draft.canvas.tsx - Irmão chrome: barra-navegacao-inferior-mobile.md (B164)
- Camadas futuras: deliberacao-atualizacao-responsavel-thread.md (C88), atualizacao-unificada-polaridade-urgente.md (C87)
- Precedentes: filtro combobox de Municípios (B127/B128/B120), bottom sheet (B112/B109),
MunicipalityUpdateFeed/form unificado