teqo/src/utilities/activityFormData.ts
Francisco Ignácio Fontoura Solla d5b4af2d98 E13: visit eligibility checklist and the tour composer.
Five conditions per município (volume, headroom, rede, janela, encaixe) with
their reason always visible, plus a staff-only composer at
/campanha/atividades/giros that turns an âncora + satélites + semente into draft
activities in one transaction. No `visita` kind and no `tour` entity:
`deputyPresent` already marks the candidate's own agenda.
2026-07-27 21:04:04 -03:00

204 lines
7.6 KiB
TypeScript

import 'server-only'
import {
boundedJsonFormValue,
checkboxFormValue,
FormDataBoundaryError,
nullableRelationshipFormValue,
optionalFormText,
repeatedRelationshipFormValues,
requiredFormText,
requiredRelationshipFormValue,
} from '@/lib/formData'
import {
activityDemandDraftsSchema,
activityKinds,
activityOrigins,
activityStatuses,
MAX_ACTIVITY_DEMAND_DRAFTS,
tourStopDraftsSchema,
type ActivityCreateInput,
type ActivityDemandDraft,
type ActivityUpdateInput,
type TourStopDraft,
} from '@/lib/schemas/activity'
import { parseBahiaDateTimeInput } from '@/utilities/campaignTime'
import { MAX_TOUR_NAME_LENGTH, TOUR_EMPTY_MESSAGE } from '@/utilities/visitPlannerViews'
type ParsedActivityTask = {
title: string
responsible?: number
due?: string
done?: boolean
}
const parseDateTimeFormField = (formData: FormData, field: string): string | undefined => {
const value = optionalFormText(formData, field)
if (!value) return undefined
const iso = parseBahiaDateTimeInput(value)
if (!iso) throw new FormDataBoundaryError(field, 'Data e horário inválidos.')
return iso
}
const parseTasksFormData = (formData: FormData): ParsedActivityTask[] => {
const raw = boundedJsonFormValue(formData, 'tasksJson', 20_000)
if (raw === undefined) return []
if (!Array.isArray(raw)) {
throw new FormDataBoundaryError('tasksJson', 'Lista de tarefas inválida.')
}
return raw.map((item, index) => {
if (typeof item !== 'object' || item === null) {
throw new FormDataBoundaryError('tasksJson', `Tarefa ${index + 1} inválida.`)
}
const record = item as Record<string, unknown>
const title = typeof record.title === 'string' ? record.title.trim() : ''
if (!title) {
throw new FormDataBoundaryError('tasksJson', `Informe o título da tarefa ${index + 1}.`)
}
if (title.length > 200) {
throw new FormDataBoundaryError('tasksJson', `O título da tarefa ${index + 1} é muito longo.`)
}
const responsible =
typeof record.responsible === 'number' &&
Number.isInteger(record.responsible) &&
record.responsible > 0
? record.responsible
: undefined
const dueRaw = typeof record.due === 'string' ? record.due : undefined
const due = dueRaw ? (parseBahiaDateTimeInput(dueRaw) ?? undefined) : undefined
if (dueRaw && !due) {
throw new FormDataBoundaryError('tasksJson', `Prazo inválido na tarefa ${index + 1}.`)
}
const done = typeof record.done === 'boolean' ? record.done : undefined
return {
title,
...(responsible ? { responsible } : {}),
...(due ? { due } : {}),
...(done !== undefined ? { done } : {}),
}
})
}
const parseDemandDraftsFormData = (formData: FormData): ActivityDemandDraft[] => {
const raw = boundedJsonFormValue(formData, 'demandsJson', 80_000)
if (raw === undefined) return []
const parsed = activityDemandDraftsSchema.safeParse(raw)
if (parsed.success) return parsed.data
const demandIndex = parsed.error.issues[0]?.path[0]
if (typeof demandIndex === 'number') {
throw new FormDataBoundaryError('demandsJson', `Demanda ${demandIndex + 1} inválida.`)
}
if (!Array.isArray(raw) || raw.length > MAX_ACTIVITY_DEMAND_DRAFTS) {
throw new FormDataBoundaryError(
'demandsJson',
`Informe no máximo ${MAX_ACTIVITY_DEMAND_DRAFTS} demandas válidas.`,
)
}
throw new FormDataBoundaryError('demandsJson', 'Lista de demandas inválida.')
}
const parseSharedActivityFormData = (formData: FormData) => {
const responsible = nullableRelationshipFormValue(formData, 'responsible')
const leadership = nullableRelationshipFormValue(formData, 'leadership')
return {
title: optionalFormText(formData, 'title') ?? '',
kind: optionalFormText(formData, 'kind') as (typeof activityKinds)[number],
origin: optionalFormText(formData, 'origin') as (typeof activityOrigins)[number] | undefined,
status: optionalFormText(formData, 'status') as (typeof activityStatuses)[number] | undefined,
description: optionalFormText(formData, 'description'),
deputyPresent: checkboxFormValue(formData, 'deputyPresent'),
startAt: parseDateTimeFormField(formData, 'startAt'),
endAt: parseDateTimeFormField(formData, 'endAt'),
deadline: parseDateTimeFormField(formData, 'deadline'),
municipality: requiredRelationshipFormValue(formData, 'municipality'),
locality: optionalFormText(formData, 'locality'),
organizations: repeatedRelationshipFormValues(formData, 'organizations'),
responsible,
leadership,
tasks: parseTasksFormData(formData),
demands: parseDemandDraftsFormData(formData),
}
}
export type ParsedActivityCreateFormData = ActivityCreateInput & {
demands: ActivityDemandDraft[]
}
export const parseActivityCreateFormData = (formData: FormData): ParsedActivityCreateFormData => {
const shared = parseSharedActivityFormData(formData)
const advisorIds = repeatedRelationshipFormValues(formData, 'advisors')
return {
...shared,
status: (shared.status ?? 'rascunho') as ActivityCreateInput['status'],
responsible: shared.responsible ?? undefined,
leadership: shared.leadership ?? undefined,
organizations: shared.organizations.length ? shared.organizations : undefined,
advisors: advisorIds.length ? advisorIds : undefined,
}
}
/**
* E13 — the composer submits its stops as one bounded JSON field, the precedent
* `tasksJson`/`demandsJson` already set: the alternative is per-stop field names
* whose correlation has to be reconstructed from `FormData` ordering.
*
* The stop shape itself is a zod schema picked from the activity fields, so this
* boundary only has to decide the ONE thing zod cannot: which message the mesa
* sees. Titles are not parsed here — the action composes them from the município
* names it reads for the scope check.
*/
export type ParsedTourDraftFormData = {
tourName: string
note: string | undefined
stops: TourStopDraft[]
}
export const parseTourDraftFormData = (formData: FormData): ParsedTourDraftFormData => {
const tourName = requiredFormText(formData, 'tourName')
if (tourName.length > MAX_TOUR_NAME_LENGTH) {
throw new FormDataBoundaryError('tourName', 'Nome do giro muito longo.')
}
const parsed = tourStopDraftsSchema.safeParse(boundedJsonFormValue(formData, 'stopsJson', 20_000))
if (!parsed.success) {
throw new FormDataBoundaryError(
'stopsJson',
'Paradas do giro inválidas. Atualize a página e monte o giro novamente.',
)
}
if (parsed.data.length === 0) throw new FormDataBoundaryError('stopsJson', TOUR_EMPTY_MESSAGE)
return { tourName, note: optionalFormText(formData, 'note'), stops: parsed.data }
}
export type ParsedActivityUpdateFormData = ActivityUpdateInput & {
demands: ActivityDemandDraft[]
}
export const parseActivityUpdateFormData = (formData: FormData): ParsedActivityUpdateFormData => {
const shared = parseSharedActivityFormData(formData)
const advisorIds = repeatedRelationshipFormValues(formData, 'advisors')
// Checkboxes only submit when checked, so a hidden marker distinguishes
// "advisors section rendered but all unchecked" from "not editable" (advisor view).
const hasAdvisors = formData.has('advisorsSubmitted')
return {
...shared,
id: requiredRelationshipFormValue(formData, 'id'),
status: shared.status as ActivityUpdateInput['status'],
locality: shared.locality ?? null,
description: shared.description ?? null,
startAt: shared.startAt ?? null,
endAt: shared.endAt ?? null,
deadline: shared.deadline ?? null,
responsible: shared.responsible,
leadership: shared.leadership,
organizations: shared.organizations,
advisors: hasAdvisors ? advisorIds : undefined,
}
}