7.2 KiB
Impl: C124 — Atividades: tarefa só com texto, responsável e concluída (sem data/hora)
Status: aprovado Atualizado em: 2026-08-11 Issue: #668 Intenção: docs/plans/atividades-tarefas-sem-prazo.md Appetite restante: herdado (~0,5–1 dia eng; mudança é remoção pura, sem migração de dados)
Leitura da intenção
- Outcome: tarefa de atividade passa a ter exatamente três controles — título (texto), responsável (pessoa) e "concluída" (checkbox); o prazo (data/hora) sai do schema, da UI e do guardrail de liderança;
doneAtpermanece. - O que NÃO negociar: guardrail de liderança fail-closed (só marca concluída, comparação perde
due); dados existentes com prazo são descartados (drop da coluna, decidido no gate); anti-goal: prazo não migra para outro campo. - O que reavaliar: a hipótese de direção da intenção estava completa — confirmei por grep que
duede tarefa só existe em 6 arquivos (collections, zod, formData, viewModels, 2 componentes) + payload-types gerado + migration antiga (frozen). Nenhum consumidor fora da vertical de atividades (notificações, Google sync, activityUi, quick actions: nenhum lêtask.due).
Abordagem recomendada
flowchart LR
A[Activity.ts<br/>campo due sai do array tasks<br/>guardrail líder perde comparação due] --> M[migration:<br/>DROP COLUMN due<br/>em activity_tasks]
C[lib/schemas/activity.ts<br/>taskSchema: due sai] --> D[activityFormData.ts<br/>ParsedActivityTask + parsing due saem]
D --> E[activityViewModels.ts<br/>due sai dos dois view models]
E --> F[ActivityTaskFields.tsx<br/>input datetime sai<br/>grid 2fr_1fr]
E --> G[ActivityTaskChecklist.tsx<br/>linha Prazo sai]
M --> T[generate:types<br/>payload-types refresca]
T --> G2[Gates: tsc lint format knip cycles unit int e2e build]
Opções consideradas: A) remoção completa (campo + coluna + UI) · B) manter coluna morta (due nullable, nunca escrita) · C) manter campo no schema, só esconder da UI
Recomendação: A — a intenção e o gate decidiram "descartar e remover"; remover na origem elimina a coluna fantasma, o peso no guardrail e a tentação de re-exibir. Zero risco de perda: nenhum consumidor lê o valor (verificado por grep em src/ e tests/), e dado de campanha interno sem valor operacional.
Rejeitadas: B (anti-goal "limpeza real, sem coluna fantasma" — matéria do gate) · C (mantém API e guardrail poluídos com campo morto; anti-goal: campo sai do modelo, não só da UI).
Componentes / mudanças
Activity(src/collections/Activity.ts): remove o fieldduedo arraytasks(linhas 575–583); remove(taskRecord.due ?? null) !== (previousTask.due ?? null)do guardrail de liderança emderiveActivityFields(linha 361) — mesmo item, senão a comparação lê propriedade inexistente e o fail-closed perde a cobertura.doneAt/taskTotal/taskDoneCountintocados.src/lib/schemas/activity.ts:taskSchemaperdedue: z.string().datetime().optional().nullable()(linha 74). TypesActivityCreateInput/ActivityUpdateInputderivam de zod — atualizam sozinhos.src/utilities/activityFormData.ts:ParsedActivityTaskperdedue?: string;parseTasksFormDataperde o parsing/validação de prazo (linhas 81–85) e a propagação...(due ? { due } : {})(linha 91). O resto do parse fica intacto.src/utilities/activityViewModels.ts:ActivityFormTaskViewModeleActivityTaskViewModelperdemdue(linhas 244, 346) e os mapeamentos (linhas 294, 395).doneAtpermanece no checklist VM.ActivityTaskFields.tsx:ActivityTaskFieldValueeinitialTasksperdemdue;serializeTasksdeixa de emitirdue; estado inicial eaddTaskperdem o default; o inputdatetime-localdo prazo sai; gridsm:grid-cols-[2fr_1fr_1fr]→sm:grid-cols-[2fr_1fr]; importformatIsoAsBahiaDateTimeInputsai.ActivityTaskChecklist.tsx: a entradaPrazo: …do subtítulo sai (linha 63); importformatBahiaDateTimeLabelsai (o helper continua usado em outras superfícies — ActivityCard/agenda — knip valida).- Migration:
pnpm migrate:create drop_activity_task_due— geraALTER TABLE "activity_tasks" DROP COLUMN IF EXISTS "due";(+ down). A coluna é nullable e sem índice próprio, então o drop é barato. Aplica em prod via build (Vercel) — revisar o SQL gerado antes. - Access / Consent: nenhuma mudança — mesmo access, mesma coleção, sem Consent.
- UI: Impeccable B — encaixe nas superfícies existentes; remoção pura, sem shape novo.
Dados → forma (se aplicável)
- Não se aplica — sem dado novo para apresentar; o contador
taskDoneCountsegue exatamente como está.
Fases verificáveis
- Schema + server —
Activity.ts(campo + guardrail),taskSchemazod,parseTasksFormData. Verificar:tsc --noEmit+ int speccampaignActivity.int.spec.ts(cobre o guardrail de liderança comtaskssemdue). - UI + view models —
activityViewModels.ts,ActivityTaskFields.tsx,ActivityTaskChecklist.tsx. Verificar:tsc,lint, unit specs de UI (activity*) eknip(orfandade de helpers). - Migration + tipos —
pnpm migrate:create drop_activity_task_due, revisar SQL,pnpm migratelocal (teqo_wt),pnpm generate:types. Verificar:migrate:statusnas duas DBs (dev + test). - Gates —
tsc --noEmit,lint(0 warnings),format:check,knip,check:cycles,pnpm test,pnpm test:e2e(specs de atividade:campaignActivity,campaignAgenda*),pnpm buildcontra DB local.
Rabbit holes / Não escopo (engenharia)
- Migração de conteúdo (preservar
dueem outra coluna): corte — nada consome; drop limpo. - Prazo em demandas/atividades em geral: fora de escopo (não criar equivalente).
- Tocar
doneAt/taskDoneCount: fora de escopo. - C123 (overlay da agenda): roda depois, nasce já com o modelo simplificado — nada a preparar aqui além do modelo limpo.
Riscos e mitigação
- Guardrail de liderança quebrado ao mudar o shape: mitigado — a comparação de
dueé removida no mesmo commit do field; o int specdenies leaders from updating activitiese o de toggle de tarefa da liderança continuam exercitando o caminho fail-closed. - Migração destrutiva em prod (via build): coluna nullable, dados já sem consumidor (grep
src/+tests/); SQL revisado no passo 3 antes de qualquer deploy. payload-types.tsdesatualizado no meio do caminho:duesome do tipo gerado no passo 3 (generate:types) — até látscpega qualquer uso remanescente.- Serialização client × parse server fora de sincronia:
serializeTaskspara de emitirduee o parse para de ler — mudança simétrica num único commit; nenhum cliente antigo persiste (formas stateless).
Aceite de engenharia
- Aceite de produto da intenção ainda coberto: 3 controles por tarefa; checklist sem "Prazo: …"; schema sem prazo; dados descartados; guardrail de liderança intacto;
doneAtpermanece - Invariantes AGENTS/engineering-standards: sem toque em access/Consent; transações intactas; copy pt-BR; identificadores em inglês
- Testes de domínio previstos: int spec existente do guardrail continua verde (sem novo teste — remoção pura, superfície coberta)