teqo-backup/docs/plans/deliberacao-atualizacao-responsavel-thread.md
2026-08-06 00:19:17 -03:00

92 lines
6.2 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.

# C88 — Deliberação na atualização (responsável, thread, resolvido)
Status: ready
Atualizado em: 2026-08-06
Issue: #397
Priority: P1
Model: cursor-grok-4.5-medium
Model-local: deepseek-v4-high
Impeccable: C — fluxo novo de deliberação em cima do feed de atualizações
Canvas UI: /home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-hin1/canvases/plan-c88-ui-draft.canvas.tsx
Appetite: ~1–1,5 dia eng; um outcome verificável (coordenação atribui, discute e fecha uma atualização)
Responsável: —
## Intenção
Com a atualização virando o lugar único do “o que aconteceu” (**C87**), a coordenação precisa **deliberar ali mesmo**: apontar um responsável, conversar na própria atualização e marcar resolvido — sem abrir demanda, atividade ou Zap paralelo para cada fato.
## Persona e fluxo
- **Persona / contexto:** Alex (coordenador/candidato) vendo um registro Ruim/Urgente no município; Casey (assessor) recebendo a bola e respondendo no fio.
- **Job principal:** transformar um fato registrado em ação acompanhada — quem resolve, o que se falou, e se fechou.
- **Fluxo desejado:** abre a atualização no feed/detalhe → (coordenação) escolhe responsável → as partes comentam no fio → alguém marca Resolvido → a atualização deixa de gritar como aberta.
- **Anti-goals de produto:** virar tracker estilo Jira; segundo cadastro de pessoa; chat em tempo real; misturar com Demandas/Atividades como substituto; liderança participando do fio staff; editar o texto original da atualização via comentários.
### Esboço de fluxo (C)
```text
[feed da atualização]
→ card com texto + polaridade (+ urgente)
→ Responsável: [selecionar staff]
→ Thread: comentários em ordem
→ Ação: Marcar resolvido / Reabrir (se preciso)
```
## Objetivo e aceite
- Staff com poder de deliberação pode atribuir **um responsável** (usuário de campanha staff) a uma atualização.
- Na própria atualização existe **fio de discussão** (comentários em sequência) visível para quem já lê atualizações daquele município.
- Existe ação explícita **Resolvido** (e caminho claro para reabrir, se o gate confirmar).
- Atualização resolvida permanece legível no histórico; o estado aberto/resolvido é óbvio no card.
- Leader lockdown: liderança **não** vê nem participa deste fio.
- Depende do modelo unificado de **C87** (sem reintroduzir kinds/tipos de sinal).
## Dados (intenção)
- **Vou apresentar dados?** Sim, superfície neste item (lista/filtro opcional de “abertas com responsável”, se couber no appetite — senão só no card).
- **Decisões desbloqueadas:**
- Coordenação: “quem resolve este fato?”
- Responsável: “o que falta / o que já fiz?” (no fio)
- Coordenação: “podemos dar por encerrado?”
- **Forma:** _adiada_ — sem dashboard de tickets; restrição: não inventar KPI estadual a partir do fio.
## Direção no codebase (hipótese)
- **Áreas prováveis:** domínio de `municipalityUpdate` (detalhe/feed/form), actions de campanha do município, padrão de feed de atualizações de **atividade** (comentário append-only), notificações se já houver gancho de criação.
- **Precedente a olhar:** `Activity` updates feed + append; C87 plano irmão; imutabilidade do corpo da atualização (C12).
- **Risco de acoplamento:** access por município (assessor só no portfólio); não criar “pessoa” fora de `campaignUser`/`Contact`; serialização de migrations com outros itens C.
## Dependências
- **Dura:** **C87** (modelo unificado de atualização).
- Suave: notificações push/in-app para o responsável (pode ficar fora se estourar appetite — ver questões).
## Fora de escopo
- Unificar com Demandas ou Atividades.
- Mentions @, anexos, rich text, reações.
- SLA, filas kanban, prioridade além do Urgente já em C87.
- Participação de liderança / apoiador no fio.
- Editar ou apagar o texto original da atualização (correção = nova atualização ou comentário no fio).
## Rabbit holes de produto
- **"Vira um ticket tracker."** Labels, epics, board. **Corte:** só responsável + fio + resolvido no card da atualização.
- **"Comentário edita o fato."** Mistura histórico. **Corte:** corpo da atualização imutável; fio é aparte.
- **"Qualquer um atribui."** **Corte no gate:** quem pode atribuir / resolver (recomendação abaixo).
- **"Notifica WhatsApp."** Canal externo. **Corte:** no máximo notificação interna já existente; Zap fora.
## Questões em aberto (produto)
- **Quem pode atribuir responsável e marcar resolvido?** **Opções:** A) só coordinator/candidate; B) qualquer staff que já pode criar atualização naquele município; C) autor + unrestricted. **Recomendação:** A para atribuir/resolver; B pode comentar. _(assumido)_
- **Responsável pode ser qualquer staff ou só assessores do município?** **Opções:** A) staff do município (advisors + unrestricted); B) qualquer campaignUser staff. **Recomendação:** A — evita atribuir a quem não vê o território. _(assumido)_
- **Reabrir depois de resolvido?** **Opções:** A) sim, ação explícita; B) não — nova atualização. **Recomendação:** A — deliberação real precisa de reabrir. _(assumido)_
- **Notificar o responsável ao atribuir / ao comentar?** **Opções:** A) sim, via canal interno já existente; B) só badge no produto nesta fatia. **Recomendação:** A se o gancho for barato; senão B e item sucessor. _(assumido B nesta fatia se o appetite apertar)_
- **Atualização sem responsável ainda pode ter fio e resolvido?** **Opções:** A) sim (resolvido = “já tratamos o fato”); B) responsável obrigatório para resolver. **Recomendação:** A — nem todo fato precisa de dono. _(assumido)_
## Referências
- GitHub Issue: [#397](https://github.com/fsolla/teqo/issues/397)
- Canvas UI (gate): [/home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-hin1/canvases/plan-c88-ui-draft.canvas.tsx](/home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-hin1/canvases/plan-c88-ui-draft.canvas.tsx)
- Depende: [atualizacao-unificada-polaridade-urgente.md](atualizacao-unificada-polaridade-urgente.md) (C87)
- Precedente de feed: atualizações em Atividade; feed atual de município