teqo/src/utilities/actionPlanUi.ts
Francisco Ignácio Fontoura Solla 9fdbae05d7 Add C6 scale/DRY for supporters: bulk import, KPI aggregate, shared shells.
Phase 1 UX: StrictCombobox municipality in SupporterForm, AlertDialog in
RemoveSupporterDataButton. Phase 2 DRY: campaignListUrl + CampaignListPagination
+ campaignFormFields + mapCampaignFormActionError shared across nuclei,
supporters and action plans. Phase 3: single SQL aggregate for supporter list
KPIs via drizzle in the Payload txn. Phase 4: bulk drizzle insert for CSV import
inside the existing Payload txn with ON CONFLICT DO NOTHING, plus a fail-closed
skipContactPhoneInvariant context flag. Phase 5: HMAC-signed single-use import
token backed by a new supporterImportBatch staging collection so the full ok-row
set never crosses the Server Action boundary twice.
2026-07-18 22:17:31 -03:00

169 lines
5.7 KiB
TypeScript

import type { Where } from 'payload'
import {
bahiaIdentityTerritories,
bahiaMunicipalities,
type BahiaIdentityTerritory,
territoryForCity,
} from '@/lib/bahiaTerritories'
import { actionPlanKinds, actionPlanStatuses } from '@/lib/schemas/actionPlan'
import {
buildListHref,
firstValue,
normalizedText,
resolveListUrl,
strictDecimalInteger,
type RawSearchParams as CampaignListRawSearchParams,
} from '@/utilities/campaignListUrl'
import { normalizeSearchPhrase } from '@/utilities/wordStartFilter'
export const actionPlanPageSize = 25
export const actionPlanTabs = ['proximos', 'todos', 'realizados', 'rascunhos'] as const
export type ActionPlanTab = (typeof actionPlanTabs)[number]
export type ActionPlanKind = (typeof actionPlanKinds)[number]
export type ActionPlanStatus = (typeof actionPlanStatuses)[number]
export const actionPlanTabLabels: Record<ActionPlanTab, string> = {
proximos: 'Próximos',
todos: 'Todos',
realizados: 'Realizados',
rascunhos: 'Rascunhos',
}
export type ActionPlanListState = {
page: number
tab: ActionPlanTab
kind?: ActionPlanKind
status?: ActionPlanStatus
region?: BahiaIdentityTerritory
city?: string
}
type RawSearchParams = CampaignListRawSearchParams
export const actionPlanListParamNames = ['tab', 'kind', 'status', 'region', 'city', 'page'] as const
const actionPlanListParamNameSet = new Set<string>(actionPlanListParamNames)
const canonicalTerritoryBySearchValue = new Map(
bahiaIdentityTerritories.map((territory) => [normalizeSearchPhrase(territory), territory]),
)
const canonicalMunicipalityBySearchValue = new Map(
bahiaMunicipalities.map((city) => [normalizeSearchPhrase(city), city]),
)
const canonicalOfficialValue = <Value extends string>(
value: string | undefined,
canonicalValues: ReadonlyMap<string, Value>,
): Value | undefined => {
const normalized = normalizedText(value)
return normalized ? canonicalValues.get(normalizeSearchPhrase(normalized)) : undefined
}
const isActionPlanTab = (value: string | undefined): value is ActionPlanTab =>
actionPlanTabs.includes(value as ActionPlanTab)
const isActionPlanKind = (value: string | undefined): value is ActionPlanKind =>
actionPlanKinds.includes(value as ActionPlanKind)
const isActionPlanStatus = (value: string | undefined): value is ActionPlanStatus =>
actionPlanStatuses.includes(value as ActionPlanStatus)
export const parseActionPlanListParams = (params: RawSearchParams): ActionPlanListState => {
const rawPage = strictDecimalInteger(firstValue(params.page))
const rawTab = firstValue(params.tab)
const tab = isActionPlanTab(rawTab) ? rawTab : 'proximos'
const rawKind = firstValue(params.kind)
const kind = isActionPlanKind(rawKind) ? rawKind : undefined
const rawStatus = tab === 'todos' ? firstValue(params.status) : undefined
const status = isActionPlanStatus(rawStatus) ? rawStatus : undefined
const region = canonicalOfficialValue(firstValue(params.region), canonicalTerritoryBySearchValue)
const canonicalCity = canonicalOfficialValue(
firstValue(params.city),
canonicalMunicipalityBySearchValue,
)
const city =
canonicalCity && (!region || territoryForCity(canonicalCity) === region)
? canonicalCity
: undefined
return {
page: rawPage ?? 1,
tab,
...(kind ? { kind } : {}),
...(status ? { status } : {}),
...(region ? { region } : {}),
...(city ? { city } : {}),
}
}
export const buildActionPlanListWhere = (state: ActionPlanListState, now: Date): Where => {
const filters: Where[] = []
if (state.kind) filters.push({ kind: { equals: state.kind } })
if (state.region) filters.push({ regions: { equals: state.region } })
if (state.city) filters.push({ cities: { equals: state.city } })
if (state.tab === 'proximos') {
filters.push({ status: { in: ['planejado', 'confirmado'] } })
filters.push({ startAt: { greater_than_equal: now.toISOString() } })
} else if (state.tab === 'realizados') {
filters.push({ status: { equals: 'realizado' } })
} else if (state.tab === 'rascunhos') {
filters.push({ status: { equals: 'rascunho' } })
} else if (state.status) {
filters.push({ status: { equals: state.status } })
}
return filters.length ? { and: filters } : {}
}
export const buildActionPlanListSearchParams = (
state: ActionPlanListState,
page = state.page,
): URLSearchParams => {
const canonicalState = parseActionPlanListParams({
page: String(page),
tab: state.tab,
kind: state.kind,
status: state.status,
region: state.region,
city: state.city,
})
const params = new URLSearchParams()
if (canonicalState.tab !== 'proximos') params.set('tab', canonicalState.tab)
if (canonicalState.kind) params.set('kind', canonicalState.kind)
if (canonicalState.status) params.set('status', canonicalState.status)
if (canonicalState.region) params.set('region', canonicalState.region)
if (canonicalState.city) params.set('city', canonicalState.city)
if (canonicalState.page > 1) params.set('page', String(canonicalState.page))
return params
}
export const buildActionPlanFiltersKey = (state: ActionPlanListState): string =>
buildActionPlanListSearchParams(state).toString()
export const buildActionPlanListHref = (state: ActionPlanListState, page: number): string =>
buildListHref(state, buildActionPlanListSearchParams, '/campanha/planos', page)
export const resolveActionPlanListUrl = (
params: RawSearchParams,
totalPages?: number,
): {
state: ActionPlanListState
href: string
redirectHref?: string
} =>
resolveListUrl({
params,
paramNameSet: actionPlanListParamNameSet,
parse: parseActionPlanListParams,
buildSearchParams: buildActionPlanListSearchParams,
basePath: '/campanha/planos',
totalPages,
})