mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-22 13:23:07 +00:00
Expand the compiled next-steps doc back into the full delivery history, cross-reference plan statuses, and sync AGENTS.md, PRODUCT.md, and the Núcleos project notebook.
4.7 KiB
4.7 KiB
Eventos / presença e agenda de mobilização
Status: implementado e mesclado em main
Atualizado em: 2026-07-18
Item do roadmap: docs/roadmap.md (Janela 2, ordem 9 — C3)
Responsável: —
Referência visual (UX Pilot)
Dois designs cobrem este plano:
| Tela | Arquivos |
|---|---|
Lista de planos (/campanha/planos) |
Planos-de-Acao.png · Planos-de-Acao.html |
| Form novo plano | Novo-Plano-de-Acao.png · Novo-Plano-de-Acao.html |
Como usar:
- Lista — adotar: tabs de janela/status ("Próximos" default, "Todos", "Realizados", "Rascunhos"), filtros "Tipo de ação" e "Território", cards com badge de
kind/status, data/hora + município, chip do Território de Identidade, "Resp: {nome}" e progresso de tarefas. Rascunho semstartAtmostra "Data a definir". - Form — adotar: seções "Informações básicas", "Data e horário", "Território" (reusa
NucleusTerritoryFields), "Pessoas" (coordenadores, responsável, liderança vinculada) e status inicial (Planejado | Rascunho). - Detalhe: tabs Visão geral / Tarefas / Atualizações no padrão
NucleusTabNav(sem design nesta leva). - Ajustar cores: tokens do tema
campaign. Entrada "Planos" no nav (src/components/campaign/nav.ts).
Contexto
Cada documento actionPlan é uma ação/evento calendarizável (caminhada, comício, etc.), com checklist de tarefas e feed de atualizações, alimentando o bloco "Próximos eventos" no overview de núcleos e no dashboard.
Decisões travadas
- Granularidade: entidade única
actionPlan. - Território próprio, sem link a
electoralNucleus. Arraysregions/cities/neighborhoods+ validação Bahia compartilhada (campaignTerritoryValidation.ts). - Filtro de território na lista/overview usa
{ equals }sobre arrays (semântica A1), nãocontains. startAtopcional só emrascunho; obrigatório ao passar paraplanejado/confirmado/realizado/cancelado. Card mostra "Data a definir" quando ausente. (Decisão de produto 2026-07-18.)- Pessoas =
Contact+campaignUser:coordinators→campaignUser,responsible→Contact,leadership→leadership(opcional; escopo de leitura paralideranca). kind/statusenums em pt-BR (valores de dados).slugcanônico imutável a partir dotitle.taskseupdatescomo arrays no MVP (append-only para updates;doneAt/author/createdAtderivados no servidor).- Access:
geraltudo;coordenadoronde está emcoordinators(e pode criar, auto-incluído);liderancaondeleadership∈ engajadas — escrita só toggletasks.done+ appendupdates. - Transações: escritas de domínio via
withPayloadTransaction(src/utilities/payloadTransaction.ts). - Sem
Consent(dado interno de staff).
Questões em aberto (resolvidas na implementação)
liderancaedita tarefas? Sim — só toggledone+ appendupdate.tasks.responsible: contatos no escopo do ator (getAccessibleContactIdsvia busca do combobox).- Filtro de janela: tabs Próximos / Todos / Realizados / Rascunhos; default Próximos.
- Bloco no dashboard: sim, sem filtros de lista.
- Recorrência /
actionUpdatededicado: fora do MVP.
Entrega (2026-07-18)
- Collection
actionPlan+ migration20260718_222832_add_action_plan - Vertical
/campanha/planos(lista, detalhe com tabs, novo/editar) - Blocos "Próximos eventos" no overview de núcleos e no dashboard
- Access control + testes int
tests/int/campaignActionPlan.int.spec.ts
Revisões
- 2026-07-18: auditoria pré-implementação — operador de território
equals(nãocontains); transações viawithPayloadTransaction; nav emnav.ts; validação de território extraída para helper compartilhado;startAtopcional só em rascunho.
Não escopo
- Collection dedicada
actionUpdate, captura nominal de presentes, calendário/mapa, link aelectoralNucleus, recorrência, notificações (D2). - Escala/DRY pós-entrega (território/contato compostos, selects por aba, RMW de tasks/updates, índice
status+startAt) — C7 / escala-dry-pos-c3.md.