teqo/tests/int/campaignLeadershipActions.int.spec.ts
Francisco Ignácio Fontoura Solla cf13c441aa Remodel /campanha around predefined Praças replacing electoral nuclei.
436 seeded Praças (municipality-based; per-TSE-zone in Salvador/Camaçari) become
the operational unit; roles renamed to coordinator/advisor/leader with advisors
scoped to administered Praças. Leadership is one record per person across many
Praças/organizations; vote pledges split leader-declared vs staff-estimated
(estimates never serialized to leaders). Adds organizations, demand workflow
with staff-only cost/receipts, action-plan results with deputy presence, manual
political trend, multi-candidate comparison and the diverging red/white/blue
map mode. Migration 20260721_020109_remodel_plazas deliberately resets the
campaign vertical in production (public site untouched); test suite ported to
the new model (unit 187 / int 306 / e2e 9 green).
2026-07-21 02:28:00 -03:00

295 lines
10 KiB
TypeScript

// @vitest-environment node
import { beforeAll, describe, expect, it, vi } from 'vitest'
import { getPayload, type Payload } from 'payload'
import type { CampaignUser } from '@/payload-types'
const authState = vi.hoisted(() => ({
user: null as CampaignUser | null,
}))
vi.mock('@/utilities/campaignAuth', () => ({
getCampaignUser: async () => authState.user,
}))
vi.mock('next/cache', () => ({
revalidatePath: vi.fn(),
}))
import { updateLeadershipInternalFormAction } from '@/app/(campaign)/campanha/(app)/liderancas/[id]/formActions'
import { createLeadershipFormAction } from '@/app/(campaign)/campanha/(app)/liderancas/nova/formActions'
import { createLeadershipRecord } from '@/app/(campaign)/campanha/actions/leadership'
import config from '@/payload.config'
import { installCampaignFixtures } from '../helpers/campaignFixtures'
let payload: Payload
const campaignFixtures = installCampaignFixtures({
getPayload: () => payload,
setPayload: (nextPayload) => {
payload = nextPayload
},
})
const createFormData = (plazaIds: number[], name: string, phone: string) => {
const formData = new FormData()
for (const plazaId of plazaIds) formData.append('plazas', String(plazaId))
formData.set('name', name)
formData.set('phone', phone)
formData.set('supportStatus', 'engajado')
return formData
}
const isNextRedirect = (error: unknown): boolean =>
typeof error === 'object' &&
error !== null &&
'digest' in error &&
String((error as { digest: unknown }).digest).startsWith('NEXT_REDIRECT')
const expectRedirectTo = async (action: Promise<unknown>, path: string): Promise<void> => {
try {
await action
throw new Error('Expected the form action to redirect on success.')
} catch (error) {
if (!isNextRedirect(error)) throw error
expect(String((error as { digest: string }).digest)).toContain(path)
}
}
describe('campaign leadership exported form actions', () => {
beforeAll(async () => {
payload = await getPayload({ config: await config })
})
it('creates a leadership and redirects to its detail page in advisor scope', async () => {
const advisor = await campaignFixtures().createCampaignUser('advisor')
const plaza = await campaignFixtures().getPlaza()
await campaignFixtures().assignPlazaAdvisors(plaza, [advisor])
authState.user = advisor
const phone = campaignFixtures().phone()
try {
await createLeadershipFormAction(
{},
createFormData([plaza.id], 'Liderança via Action', phone),
)
throw new Error('Expected the form action to redirect on success.')
} catch (error) {
if (!isNextRedirect(error)) throw error
}
const contacts = await payload.find({
collection: 'contact',
where: { phone: { equals: phone } },
limit: 2,
depth: 0,
})
expect(contacts.totalDocs).toBe(1)
const leaderships = await payload.find({
collection: 'leadership',
where: { contact: { equals: contacts.docs[0]!.id } },
limit: 2,
depth: 0,
})
expect(leaderships.totalDocs).toBe(1)
expect(leaderships.docs[0]!.supportStatus).toBe('engajado')
expect(leaderships.docs[0]!.createdBy).toBe(advisor.id)
})
it('creates a normalized contact through the form action', async () => {
const coordinator = await campaignFixtures().createCampaignUser('coordinator')
const plaza = await campaignFixtures().getPlaza()
const phone = campaignFixtures().phone()
const formData = createFormData(
[plaza.id],
'Francisco',
`(71) ${phone.slice(2, 7)}-${phone.slice(7)}`,
)
formData.set('supportStatus', 'a_abordar')
authState.user = coordinator
await expectRedirectTo(createLeadershipFormAction({}, formData), '/campanha/liderancas/')
const contacts = await payload.find({
collection: 'contact',
where: { phone: { equals: phone } },
limit: 2,
depth: 0,
})
expect(contacts.totalDocs).toBe(1)
expect(contacts.docs[0]).toMatchObject({
name: 'Francisco',
phone,
})
const leaderships = await payload.find({
collection: 'leadership',
where: {
and: [{ contact: { equals: contacts.docs[0]!.id } }, { plazas: { in: [plaza.id] } }],
},
limit: 2,
depth: 0,
})
expect(leaderships.totalDocs).toBe(1)
expect(leaderships.docs[0]!.supportStatus).toBe('a_abordar')
})
it('applies server defaults when the form action receives only required fields', async () => {
const coordinator = await campaignFixtures().createCampaignUser('coordinator')
const plaza = await campaignFixtures().getPlaza()
const phone = campaignFixtures().phone()
const formData = new FormData()
formData.append('plazas', String(plaza.id))
formData.set('name', 'Liderança mínima')
formData.set('phone', phone)
authState.user = coordinator
await expectRedirectTo(createLeadershipFormAction({}, formData), '/campanha/liderancas/')
const contact = (
await payload.find({
collection: 'contact',
where: { phone: { equals: phone } },
limit: 1,
depth: 0,
})
).docs[0]!
expect(contact).toMatchObject({
name: 'Liderança mínima',
phone,
email: null,
gender: null,
})
const leadership = (
await payload.find({
collection: 'leadership',
where: { contact: { equals: contact.id } },
limit: 1,
depth: 0,
})
).docs[0]!
expect(leadership).toMatchObject({
supportStatus: 'a_abordar',
sector: null,
sectorNotes: null,
notes: null,
consentNote: null,
})
})
it('surfaces the duplicate-person message through the create form action', async () => {
const coordinator = await campaignFixtures().createCampaignUser('coordinator')
const plaza = await campaignFixtures().getPlaza()
const otherPlaza = await campaignFixtures().getPlaza()
const phone = campaignFixtures().phone()
authState.user = coordinator
await createLeadershipRecord(payload, coordinator, {
plazas: [plaza.id],
name: 'Pessoa já cadastrada',
phone,
supportStatus: 'engajado',
})
await expect(
createLeadershipFormAction({}, createFormData([otherPlaza.id], 'Duplicada', phone)),
).resolves.toMatchObject({
message:
'Esta pessoa já está cadastrada como liderança. Edite a ficha existente para vincular novas Praças.',
})
})
it('clears blank nullable fields and preserves absent fields through the update action', async () => {
const coordinator = await campaignFixtures().createCampaignUser('coordinator')
const plaza = await campaignFixtures().getPlaza()
authState.user = coordinator
const created = await createLeadershipRecord(payload, coordinator, {
plazas: [plaza.id],
name: 'Liderança com campos internos',
phone: campaignFixtures().phone(),
sectorNotes: 'Setor preservado',
notes: 'Nota para limpar',
consentNote: 'Consentimento para limpar',
})
const formData = new FormData()
formData.set('leadershipId', String(created.id))
formData.append('plazas', String(plaza.id))
formData.set('notes', ' ')
formData.set('consentNote', '')
await expect(updateLeadershipInternalFormAction({}, formData)).resolves.toMatchObject({
status: 'success',
message: 'Ficha da liderança atualizada.',
})
await expect(
payload.findByID({ collection: 'leadership', id: created.id, depth: 0 }),
).resolves.toMatchObject({
sectorNotes: 'Setor preservado',
notes: null,
consentNote: null,
})
})
it('returns denial states for out-of-scope advisor actions', async () => {
const coordinator = await campaignFixtures().createCampaignUser('coordinator')
const advisor = await campaignFixtures().createCampaignUser('advisor')
const otherAdvisor = await campaignFixtures().createCampaignUser('advisor')
const assigned = await campaignFixtures().getPlaza()
const other = await campaignFixtures().getPlaza()
await campaignFixtures().assignPlazaAdvisors(assigned, [advisor])
await campaignFixtures().assignPlazaAdvisors(other, [otherAdvisor])
const otherLeadership = await createLeadershipRecord(payload, coordinator, {
plazas: [other.id],
name: 'Liderança fora do escopo',
phone: campaignFixtures().phone(),
supportStatus: 'engajado',
})
authState.user = advisor
await expect(
createLeadershipFormAction(
{},
createFormData([other.id], 'Criação negada', campaignFixtures().phone()),
),
).resolves.toMatchObject({
message: 'Você só pode vincular lideranças às Praças que assessora.',
})
const updateData = new FormData()
updateData.set('leadershipId', String(otherLeadership.id))
updateData.append('plazas', String(other.id))
updateData.set('supportStatus', 'engajado')
await expect(updateLeadershipInternalFormAction({}, updateData)).resolves.toMatchObject({
message: expect.stringContaining('Não foi possível'),
})
})
it('returns denial states when a leader invokes staff actions', async () => {
const coordinator = await campaignFixtures().createCampaignUser('coordinator')
const leaderAccount = await campaignFixtures().createCampaignUser('leader')
const plaza = await campaignFixtures().getPlaza()
const existing = await createLeadershipRecord(payload, coordinator, {
plazas: [plaza.id],
name: 'Registro protegido',
phone: campaignFixtures().phone(),
supportStatus: 'engajado',
})
authState.user = leaderAccount
await expect(
createLeadershipFormAction(
{},
createFormData([plaza.id], 'Criação por liderança', campaignFixtures().phone()),
),
).resolves.toMatchObject({
message: 'Somente a coordenação e a assessoria podem gerenciar lideranças.',
})
const updateData = new FormData()
updateData.set('leadershipId', String(existing.id))
updateData.append('plazas', String(plaza.id))
updateData.set('supportStatus', 'engajado')
await expect(updateLeadershipInternalFormAction({}, updateData)).resolves.toMatchObject({
message: 'Somente a coordenação e a assessoria podem gerenciar lideranças.',
})
})
})