teqo-backup/tests/int/campaignActionPlan.int.spec.ts
Francisco Ignácio Fontoura Solla 0e4e6855dc Add the tooling gate: knip, CI, zero-warning lint, as-never ban
- knip (files/deps at error level; unused exports ledgered as warn) with
  config for Payload/Next entries; deleted the dead modules it confirmed:
  RecentlyVisited + UpcomingActionPlansCard + actionPlanUpcomingPreview,
  lazy-dialog helpers, tseZone, federalCandidateTotalsAggregate (test-only),
  unused ui kit files, one-shot rename script; pruned unused radix deps and
  typescript-eslint; added pg/@types/pg (pinned to drizzle's 8.10.2)
- GitHub Actions CI on the mirror: lint, typecheck, knip, unit, migrate, int
  against a Postgres 17 service
- eslint: unused-vars with ^_ ignore patterns (migrations args exempt),
  repo-wide ban on `as never` (no-restricted-syntax), lint gate at
  --max-warnings=0; fixed all 54 pre-existing warnings (dead imports,
  hooks deps, tracking-pixel img disable with impeccable config exception)
- tsconfig: include consolidated from 219 lines to 5 (wildcard covers all
  .next dist variants), noUnusedLocals on
- typed replacements for every as-never: hookFilledCreateData (actions
  create data completed by collection hooks), drizzle scopeColumn narrowing,
  tests' stub<T> helper (property-level checking kept, completeness waived)
- test infra: leased-consent generalization used by onda0 spec (shared
  leases over the stable consent keys; window race ledgered), purge fix
- docs: IMPROVE-CODE-QUALITY-PLAN.md tracker, TECH-DEBT.md ledger,
  TESTING.md safety-net map (package.json also gains the Phase 2
  build:election-aggregates script entry; the script lands next commit)
2026-07-23 23:06:12 -03:00

290 lines
9.2 KiB
TypeScript

// @vitest-environment node
import {
getPayload,
type Payload,
type PayloadRequest,
type RequiredDataFromCollectionSlug,
} from 'payload'
import { beforeAll, describe, expect, it } from 'vitest'
import { actionPlanCreateSchema, actionPlanUpdateSchema } from '@/lib/schemas/actionPlan'
import config from '@/payload.config'
import {
canCreateActionPlan,
canReadActionPlan,
canUpdateActionPlan,
getAccessibleLeadershipIds,
} from '@/utilities/campaignAccess'
import { installCampaignFixtures } from '../helpers/campaignFixtures'
import { stub } from '../helpers/stub'
/** Create data with server-derived fields (e.g. `slug`) intentionally omitted. */
type ActionPlanCreateData = RequiredDataFromCollectionSlug<'actionPlan'>
let payload: Payload
const campaignFixtures = installCampaignFixtures({
getPayload: () => payload,
setPayload: (nextPayload) => {
payload = nextPayload
},
})
const validPlanInput = (municipalityId: number) => ({
title: campaignFixtures().value('Caminhada Centro'),
kind: 'caminhada' as const,
status: 'planejado' as const,
startAt: new Date(Date.now() + 86_400_000).toISOString(),
municipality: municipalityId,
locality: 'Centro',
})
describe('action plan domain', () => {
beforeAll(async () => {
payload = await getPayload({ config: await config })
})
it('requires startAt outside rascunho and allows drafts without it', () => {
expect(
actionPlanCreateSchema.safeParse({
...validPlanInput(1),
status: 'rascunho',
startAt: undefined,
}).success,
).toBe(true)
expect(
actionPlanCreateSchema.safeParse({
...validPlanInput(1),
status: 'planejado',
startAt: undefined,
}).success,
).toBe(false)
expect(
actionPlanUpdateSchema.safeParse({
id: 1,
status: 'confirmado',
startAt: null,
}).success,
).toBe(false)
})
it('requires a municipality on create', () => {
const result = actionPlanCreateSchema.safeParse({
title: campaignFixtures().value('Plano sem Praça'),
kind: 'caminhada',
status: 'rascunho',
})
expect(result.success).toBe(false)
})
it('scopes create/read/update by campaign role', async () => {
const fixtures = campaignFixtures()
const coordinator = await fixtures.createCampaignUser('coordinator')
const advisor = await fixtures.createCampaignUser('advisor')
const otherAdvisor = await fixtures.createCampaignUser('advisor')
const leaderAccount = await fixtures.createCampaignUser('leader')
const contact = await fixtures.createContact()
const municipality = await fixtures.getMunicipality()
await fixtures.assignMunicipalityAdvisors(municipality, [advisor])
const leadership = await fixtures.createLeadership({
contact: contact.id,
municipalities: [municipality.id],
user: leaderAccount.id,
supportStatus: 'engajado',
})
const createAsCoordinator = await canCreateActionPlan({
req: stub<PayloadRequest>({ user: coordinator, payload, context: {} }),
})
const createAsAdvisor = await canCreateActionPlan({
req: stub<PayloadRequest>({ user: advisor, payload, context: {} }),
})
const createAsLeader = await canCreateActionPlan({
req: stub<PayloadRequest>({ user: leaderAccount, payload, context: {} }),
})
expect(createAsCoordinator).toBe(true)
expect(createAsAdvisor).toBe(true)
expect(createAsLeader).toBe(false)
const plan = await payload.create({
collection: 'actionPlan',
data: stub<ActionPlanCreateData>({
...validPlanInput(municipality.id),
advisors: [advisor.id],
leadership: leadership.id,
responsible: contact.id,
createdBy: coordinator.id,
}),
overrideAccess: true,
})
fixtures.own('actionPlan', plan.id)
const coordinatorRead = await canReadActionPlan({
req: stub<PayloadRequest>({ user: coordinator, payload, context: {} }),
})
expect(coordinatorRead).toBe(true)
const advisorRead = await canReadActionPlan({
req: stub<PayloadRequest>({ user: advisor, payload, context: {} }),
})
expect(advisorRead).toEqual({
or: [{ advisors: { contains: advisor.id } }, { municipality: { in: [municipality.id] } }],
})
const otherAdvisorRead = await canReadActionPlan({
req: stub<PayloadRequest>({ user: otherAdvisor, payload, context: {} }),
})
expect(otherAdvisorRead).toEqual({
or: [{ advisors: { contains: otherAdvisor.id } }, { municipality: { in: [] } }],
})
const leaderRead = await canReadActionPlan({
req: stub<PayloadRequest>({ user: leaderAccount, payload, context: {} }),
})
expect(leaderRead).toBe(false)
const leadershipIds = await getAccessibleLeadershipIds(
stub<PayloadRequest>({ user: leaderAccount, payload, context: {} }),
leaderAccount,
)
expect(leadershipIds).toEqual([])
const advisorUpdate = await canUpdateActionPlan({
req: stub<PayloadRequest>({ user: advisor, payload, context: {} }),
})
expect(advisorUpdate).toEqual({
or: [{ advisors: { contains: advisor.id } }, { municipality: { in: [municipality.id] } }],
})
const visibleToAdvisor = await payload.find({
collection: 'actionPlan',
where: { id: { equals: plan.id } },
user: advisor,
overrideAccess: false,
depth: 0,
})
expect(visibleToAdvisor.totalDocs).toBe(1)
const hiddenFromOther = await payload.find({
collection: 'actionPlan',
where: { id: { equals: plan.id } },
user: otherAdvisor,
overrideAccess: false,
depth: 0,
})
expect(hiddenFromOther.totalDocs).toBe(0)
await expect(
payload.find({
collection: 'actionPlan',
where: { id: { equals: plan.id } },
user: leaderAccount,
overrideAccess: false,
depth: 0,
}),
).rejects.toThrow(/permissão/i)
})
it('auto-includes the creating advisor in advisors', async () => {
const fixtures = campaignFixtures()
const advisor = await fixtures.createCampaignUser('advisor')
const municipality = await fixtures.getMunicipality()
await fixtures.assignMunicipalityAdvisors(municipality, [advisor])
const plan = await payload.create({
collection: 'actionPlan',
data: stub<ActionPlanCreateData>({
...validPlanInput(municipality.id),
title: fixtures.value('Plano do assessor'),
}),
user: advisor,
overrideAccess: false,
})
fixtures.own('actionPlan', plan.id)
const advisorIds = (plan.advisors ?? []).map((value) =>
typeof value === 'number' ? value : value.id,
)
expect(advisorIds).toEqual([advisor.id])
expect(typeof plan.createdBy === 'number' ? plan.createdBy : plan.createdBy?.id).toBe(
advisor.id,
)
})
it('enforces schedule validation in the collection hook', async () => {
const fixtures = campaignFixtures()
const coordinator = await fixtures.createCampaignUser('coordinator')
const municipality = await fixtures.getMunicipality()
await expect(
payload.create({
collection: 'actionPlan',
data: stub<ActionPlanCreateData>({
...validPlanInput(municipality.id),
title: fixtures.value('Plano sem data'),
startAt: null,
createdBy: coordinator.id,
}),
overrideAccess: true,
}),
).rejects.toThrow('Informe a data e horário de início ao planejar ou confirmar o plano.')
const start = new Date(Date.now() + 86_400_000)
await expect(
payload.create({
collection: 'actionPlan',
data: stub<ActionPlanCreateData>({
...validPlanInput(municipality.id),
title: fixtures.value('Plano com término invertido'),
startAt: start.toISOString(),
endAt: new Date(start.getTime() - 3_600_000).toISOString(),
createdBy: coordinator.id,
}),
overrideAccess: true,
}),
).rejects.toThrow('O horário de término deve ser posterior ao de início.')
})
it('denies leaders from updating action plans', async () => {
const fixtures = campaignFixtures()
const advisor = await fixtures.createCampaignUser('advisor')
const leaderAccount = await fixtures.createCampaignUser('leader')
const contact = await fixtures.createContact()
const municipality = await fixtures.getMunicipality()
await fixtures.assignMunicipalityAdvisors(municipality, [advisor])
const leadership = await fixtures.createLeadership({
contact: contact.id,
municipalities: [municipality.id],
user: leaderAccount.id,
supportStatus: 'engajado',
})
const plan = await payload.create({
collection: 'actionPlan',
data: stub<ActionPlanCreateData>({
...validPlanInput(municipality.id),
title: fixtures.value('Plano Tarefas'),
advisors: [advisor.id],
leadership: leadership.id,
tasks: [{ title: 'Levar faixas', done: false }],
}),
overrideAccess: true,
})
fixtures.own('actionPlan', plan.id)
await expect(
payload.update({
collection: 'actionPlan',
id: plan.id,
data: {
tasks: [{ title: 'Levar faixas', done: true }],
},
user: leaderAccount,
overrideAccess: false,
}),
).rejects.toThrow()
})
})