teqo/src/lib/campaignHomeActions.ts
Cursor Agent 6030d42e2f
B80 — Ações rápidas em Municípios (lista + detalhe A1–A5)
Registra catálogo staff no drawer B79 para /campanha/municipios e
/campanha/municipios/[slug]: lista espelha Início (sem prefill); detalhe
prefill ?municipio= nos wizards A1–A5 e omite Ver esquecidos.

Closes #16

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-08-01 04:21:15 +00:00

176 lines
5.1 KiB
TypeScript

import type { LucideIcon } from 'lucide-react'
import {
BarChart3,
Handshake,
Inbox,
Megaphone,
TrendingUp,
UserPlus,
UserRoundSearch,
Users,
} from 'lucide-react'
import {
CAMPAIGN_WIZARD_ACTION_SLUGS,
campaignActionEntryHref,
isCampaignWizardActionId,
wizardActionHref,
type CampaignWizardActionId,
} from '@/lib/campaignActionRoutes'
import { LEADER_CONTACTS_HOME } from '@/lib/campaignPaths'
import { isStaffCampaignRole, type CampaignRole } from '@/lib/campaignRoles'
type CampaignHomeActionId =
| 'update-votes'
| 'register-signal'
| 'change-trend'
| 'update-leadership'
| 'register-demand'
| 'uncovered-municipalities'
| 'register-supporter'
| 'my-contacts'
export type CampaignHomeAction = {
id: CampaignHomeActionId
label: string
icon: LucideIcon
description: string
}
const staffHomeActionsCoordinator: readonly CampaignHomeAction[] = [
{
id: 'update-votes',
label: 'Ajustar votos',
icon: BarChart3,
description: 'Atualizar a projeção (média, pessimista, otimista) de um município',
},
{
id: 'register-signal',
label: 'Registrar sinal',
icon: Megaphone,
description: 'Anotar sinal urgente: invasão, perda de apoio, novo apoio, dificuldade',
},
{
id: 'change-trend',
label: 'Mudar tendência',
icon: TrendingUp,
description: 'Favorável, neutra ou desfavorável — com o porquê',
},
{
id: 'update-leadership',
label: 'Atualizar liderança',
icon: Handshake,
description: 'Trocar quem coordena, status de apoio ou votos que a pessoa declara',
},
{
id: 'register-demand',
label: 'Registrar pedido',
icon: Inbox,
description: 'Demanda de material, transporte, diária ou outro pedido do município',
},
{
id: 'uncovered-municipalities',
label: 'Ver esquecidos',
icon: UserRoundSearch,
description: 'Abrir a lista de municípios sem assessor (atalho — não é wizard)',
},
]
const portfolioScopeSuffix = ' nos municípios da sua carteira'
const staffHomeActionsAdvisor: readonly CampaignHomeAction[] = staffHomeActionsCoordinator.map(
(action) => {
if (action.id === 'uncovered-municipalities') {
return {
...action,
description:
'Abrir a lista de municípios sem assessor da sua carteira (atalho — não é wizard)',
}
}
return {
...action,
description: `${action.description}${portfolioScopeSuffix}`,
}
},
)
const leaderHomeActions: readonly CampaignHomeAction[] = [
{
id: 'register-supporter',
label: 'Cadastrar apoiador',
icon: UserPlus,
description: 'Registrar alguém da sua rede que apoia o Solla',
},
{
id: 'my-contacts',
label: 'Ver meus contatos',
icon: Users,
description: 'Abrir a lista dos apoiadores que você cadastrou',
},
]
export const wizardFlowTitleForActionId = (id: CampaignWizardActionId): string => {
const action = staffHomeActionsCoordinator.find((entry) => entry.id === id)
return action?.label ?? 'Continuar'
}
export const homeActionsForRole = (role: CampaignRole): readonly CampaignHomeAction[] => {
if (role === 'leader') return leaderHomeActions
if (!isStaffCampaignRole(role)) return []
if (role === 'advisor') return staffHomeActionsAdvisor
return staffHomeActionsCoordinator
}
export type ResolvedCampaignHomeAction = CampaignHomeAction & {
href?: string
}
/** Mirrors Início `buildMunicipalityListHref({ coverage: 'sem_assessor', sort: 'votos' }, 1)`. */
export const UNCOVERED_MUNICIPALITIES_LIST_HREF =
'/campanha/municipios?coverage=sem_assessor&sort=votos' as const
export type HomeActionButtonPropsOptions = {
uncoveredMunicipalitiesHref?: string
municipalitySlug?: string
}
/** Staff Início catalog with hrefs — shared by quick-action registries (B80+). */
const staffHomeQuickActionsByRole = new Map<CampaignRole, readonly ResolvedCampaignHomeAction[]>()
export const resolveStaffHomeQuickActions = (
role: CampaignRole,
): readonly ResolvedCampaignHomeAction[] => {
if (!isStaffCampaignRole(role)) return []
const cached = staffHomeQuickActionsByRole.get(role)
if (cached) return cached
const actions = toHomeActionButtonProps(homeActionsForRole(role), {
uncoveredMunicipalitiesHref: UNCOVERED_MUNICIPALITIES_LIST_HREF,
})
staffHomeQuickActionsByRole.set(role, actions)
return actions
}
export const toHomeActionButtonProps = (
actions: readonly CampaignHomeAction[],
options?: string | HomeActionButtonPropsOptions,
): ResolvedCampaignHomeAction[] => {
const resolved =
typeof options === 'string' ? { uncoveredMunicipalitiesHref: options } : (options ?? {})
return actions.map((action) => {
let href: string | undefined
if (action.id === 'my-contacts') {
href = LEADER_CONTACTS_HOME
} else if (action.id === 'uncovered-municipalities') {
href = resolved.uncoveredMunicipalitiesHref
} else if (isCampaignWizardActionId(action.id)) {
href = resolved.municipalitySlug
? wizardActionHref(CAMPAIGN_WIZARD_ACTION_SLUGS[action.id], resolved.municipalitySlug)
: campaignActionEntryHref(action.id)
}
return {
...action,
...(href ? { href } : {}),
}
})
}