mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-18 14:13:06 +00:00
Adiciona o checkbox publicEvent ("Evento público", default false, indexado)
à collection activity para registrar a intenção de expor o compromisso na
futura agenda pública do site — sem consumo agora e sem mudar agenda, lista,
detalhe ou o espelho do Google.
- Activity.ts: campo checkbox + snapshot do guard de liderança
- zod/formData/view model do form + ActivityOverlay (ao lado de "Todo o dia")
- migration add_activity_public_event + types regenerados
- unit (overlay), int (parse/persistência/reabertura) e e2e (roundtrip)
116 lines
6.9 KiB
Markdown
116 lines
6.9 KiB
Markdown
# Impl: Atividade: marcar evento como público (base para exposição no site)
|
|
|
|
Status: aprovado
|
|
Atualizado em: 2026-09-12
|
|
Issue: #936
|
|
Intenção: docs/plans/c151-atividade-evento-publico.md
|
|
Appetite restante: herdado (~0,5 dia eng) — cabe sem corte.
|
|
|
|
## Leitura da intenção
|
|
|
|
- **Outcome:** o staff marca/desmarca "Evento público" no modal de atividade; a marcação é
|
|
durável, volta correta ao reabrir e fica consultável — sem nenhuma tela mudar de comportamento.
|
|
- **O que NÃO negociar:** exposição pública é item futuro (PUB), nada no `(frontend)`; sem filtro/badge
|
|
na lista; sem collection paralela; `leader` segue lockdown (não vê o campo); o espelho do Google
|
|
(C114) não é influenciado em v1.
|
|
- **O que reavaliar:** a hipótese do plano de intenção ("a marcação vive na atividade existente")
|
|
confirma-se — nenhuma surpresa de acoplamento na exploração.
|
|
|
|
## Abordagem recomendada
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
O[ActivityOverlay<br/>checkbox publicEvent] -->|FormData| P[parseSharedActivityFormData]
|
|
P --> Z[activityCreate/UpdateSchema]
|
|
Z --> A[create/updateActivityRecord]
|
|
A --> C[collection activity<br/>publicEvent checkbox]
|
|
C -->|migration| DB[(activity.public_event)]
|
|
A -.nao inclui.-> G[sync Google C114]
|
|
```
|
|
|
|
**Opções consideradas:** A) campo boolean na `activity` existente (draft) | B) collection/entidade
|
|
"evento público" separada | C) global/config paralela.
|
|
|
|
**Recomendação:** A — a intenção fixa a flag na atividade existente; é um checkbox de negócio, indexado,
|
|
sem access especial (quem edita a atividade marca).
|
|
|
|
**Rejeitadas:** B porque duplica cadastro e cria divergência de dados (anti-goal explícito da intenção);
|
|
C porque não há escopo por item — a flag é por atividade.
|
|
|
|
### Componentes / mudanças
|
|
|
|
- **`publicEvent`** (`src/collections/Activity.ts`): `type: 'checkbox'`, `label: 'Evento público'`,
|
|
`defaultValue: false`, `index: true`, `admin.description` "Quando marcado, este evento poderá ser
|
|
publicado no site do candidato (futuro)." — espelha `deputyPresent`/`allDay` (sem `access` de field:
|
|
qualquer staff com linha pode marcar).
|
|
- **`activityStaffFieldSnapshot`** (`src/collections/Activity.ts`): incluir
|
|
`publicEvent: Boolean(doc.publicEvent)` no snapshot do guard de liderança — mantém a defesa em
|
|
profundidade (liderança, se algum dia alcançar o write path, não marca campo de staff). Access
|
|
`canReadActivity`/`canUpdateActivity` já negam `leader`; isto é só cinto de segurança barato.
|
|
- **`src/lib/schemas/activity.ts`**: adicionar `publicEvent: z.boolean().optional()` em
|
|
`activityFieldsSchema` (herdado por create/update `.partial()`).
|
|
- **`src/utilities/activityFormData.ts`**: `publicEvent: checkboxFormValue(formData, 'publicEvent')`
|
|
em `parseSharedActivityFormData` — sem isso o checkbox é silenciosamente descartado no submit.
|
|
- **`src/utilities/activityViewModels.ts`**: `ActivityFormViewModel.publicEvent: boolean` +
|
|
`activityFormSelect.publicEvent` + `toActivityFormViewModel`. **Não** tocar em
|
|
agenda/list/detail selects/view models (nada de badge/coluna/consumo novo).
|
|
- **`src/components/campaign/activity/ActivityOverlay.tsx`**: checkbox "Evento público" na
|
|
`scheduleSection`, logo após "Todo o dia" (posição do rascunho UI aprovado), `name="publicEvent"`,
|
|
`defaultChecked={isEdit ? editDraft?.publicEvent : false}`, `aria-label="Evento público"`.
|
|
- **Migration:** `pnpm migrate:create add_activity_public_event` — copia exata do precedente
|
|
`20260810_010844_add_activity_all_day` (`ADD COLUMN "public_event" boolean DEFAULT false` +
|
|
índice btree `activity_public_event_idx`). Depois `pnpm generate:types` (`src/payload-types.ts`).
|
|
- **Google Calendar (C114):** `SYNC_RELEVANT_ACTIVITY_FIELDS` **não** recebe `publicEvent` — decisão
|
|
v1 da intenção; editar só a flag não re-dispara sync nem carimba `lastMirroredChangeAt`.
|
|
- **UI:** Impeccable B (encaixe no modal). Reusa `Checkbox` + `Field` do próprio overlay; sem seção
|
|
nova, sem shell novo. Shape já aprovado no rascunho `c151-atividade-evento-publico-ui-draft.html`.
|
|
|
|
### Dados → forma (se aplicável)
|
|
|
|
- Não aplicável: nenhuma superfície de dados neste item (a intenção já decidiu "não apresentar dados").
|
|
|
|
## Fases verificáveis
|
|
|
|
1. **Tracer schema+server** — campo + migration + zod + parser + select/view model do form;
|
|
int test prova persistência e reabertura (`loadActivityEditDraftRecord` devolve `publicEvent`).
|
|
2. **UI** — checkbox no `scheduleSection`; unit test do overlay (render no create e no edit, submit
|
|
manda `publicEvent=on` só quando marcado).
|
|
3. **Gates** — `pnpm gate:fast`; `pnpm test` (unit+int) na entrega; push via `pnpm push`.
|
|
|
|
## Rabbit holes / Não escopo (engenharia)
|
|
|
|
- Expor no site público, agenda pública, SEO ou share kit (item PUB futuro).
|
|
- Badge/coluna/filtro na lista de atividades, na agenda ou no detalhe.
|
|
- Ligar a flag ao espelho do Google (C114) — decidido fora em v1.
|
|
- Tornar `publicEvent` system field (`canSetActivitySystemField`) ou restricted access — não pedido.
|
|
- Marcação em lote / spreadsheet mode.
|
|
|
|
## Riscos e mitigação
|
|
|
|
- **Risco:** checkbox silenciosamente descartado no submit se o parser/zod não acompanhar. **Mitigação:**
|
|
unit test do overlay + int test de parse/persistência.
|
|
- **Risco:** a flag vazar para abas/visões como comportamento novo. **Mitigação:** mudanças restritas a
|
|
form select/view model; nenhum agenda/list/detail select alterado.
|
|
- **Risco:** migration sem regenerar tipos → erro de `tsc`. **Mitigação:** `migrate:create` +
|
|
`generate:types` + `pnpm typecheck` no gate.
|
|
|
|
## Débitos triados (simplify)
|
|
|
|
- **Já resolvido:** o `migrate:create` arrastou drift de `supporter_import_batch.actor_id`
|
|
(snapshot stale dos hand-written 20260824) com `down` rollback-inseguro — removido, a migration
|
|
só mexe em `public_event`; changelog da entrega criado; racional C126 do `farFuture` no int;
|
|
status do plano finalizado.
|
|
- **Descartado (YAGNI):** índice parcial em vez de btree pleno para um boolean de 2 valores — sem
|
|
medição que justifique; a intenção pediu "indexado" e o precedente `all_day` usa btree pleno.
|
|
- **Defer (gatilho):** extrair um `OverlayCheckboxField` local para os três checkboxes idênticos do
|
|
overlay (`deputyPresent`/`allDay`/`publicEvent`) — só quando um 4º checkbox ou mudança real de UX
|
|
no bloco justificar.
|
|
- **Defer (gatilho):** teste de regressão pinando `publicEvent` fora de `SYNC_RELEVANT_ACTIVITY_FIELDS`
|
|
e dos selects de agenda/lista — hoje a type honesty (view models sem o campo) cobre agenda/lista/
|
|
detalhe; adicionar o pin quando o item PUB ligar a flag a um consumidor.
|
|
|
|
## Aceite de engenharia
|
|
|
|
- [x] Aceite de produto da intenção ainda coberto (marca/desmarca, durável, reabre correto, nada muda)
|
|
- [x] Invariantes AGENTS/engineering-standards (leader lockdown, copy pt-BR/identificadores EN)
|
|
- [x] Testes de domínio previstos (unit do overlay + int de persistência/parse + e2e de roundtrip)
|