teqo-backup/src/utilities/ai/tools/buildCampaignLinks.ts
Francisco Solla 59983b33f7 feat(campanha): C15 — FullCalendar em /campanha/agenda
Issue #390 — entrada operacional staff com FullCalendar v7 route-local
(semana/mês/lista), filtros compartilháveis por município/deputado/tag,
criação pelo slot, detalhe por URL e remarcação drag/resize sob RBAC,
transação e lock por atividade.

- /campanha/atividades e giros permanecem como lista/fluxos legados
- Sem migration/collection nova; reutiliza activity de C14
- Fuso Bahia, range exclusivo, erro/revert, loading/empty testados
- Leader negado, advisor limitado pelo access atual
- E2E cobre filtros, drag, mobile 390x844 e slot prefill
- Int specs cobrem RBAC, concorrência e defense-in-depth

Impl: docs/plans/fullcalendar-agenda-campanha-impl.md
2026-08-07 04:37:36 -03:00

229 lines
7.7 KiB
TypeScript

import { tool } from 'ai'
import { z } from 'zod'
import type { AIToolContext } from '@/lib/ai/types'
import { bahiaIdentityTerritories } from '@/lib/bahiaTerritories'
import {
campaignIntelligenceConcepts,
type CampaignConceptId,
} from '@/lib/campaignIntelligenceConcepts'
import { activityStatuses } from '@/lib/schemas/activity'
import { campaignDemandKinds, campaignDemandStatuses } from '@/lib/schemas/campaignDemand'
import { leadershipSupportStatuses } from '@/lib/schemas/leadership'
import { organizationKinds } from '@/lib/schemas/organization'
import { TERRITORIAL_CLASSES } from '@/lib/territorialClassAnchors'
import { activityTabs } from '@/utilities/activityUi'
import type { CampaignNavigationLinkRequest } from '@/utilities/ai/campaignNavigationUrls'
import { buildCampaignNavigationLinks } from '@/utilities/ai/campaignNavigationUrls'
import { politicalTrendLabels } from '@/utilities/municipality/municipalityLabels'
import { municipalityListLevelFilterValues } from '@/utilities/municipality/municipalityListUrl'
const labelSchema = z
.string()
.optional()
.describe('Rótulo humano para o link na resposta (ex.: "Ilhéus", "Municípios do assessor João").')
const territoryRegionSchema = z.enum(
bahiaIdentityTerritories as [
(typeof bahiaIdentityTerritories)[number],
...(typeof bahiaIdentityTerritories)[number][],
],
)
const politicalTrendKeys = Object.keys(politicalTrendLabels) as [
keyof typeof politicalTrendLabels,
...(keyof typeof politicalTrendLabels)[],
]
const conceptIdSchema = z.enum(
campaignIntelligenceConcepts.map((concept) => concept.id) as [
CampaignConceptId,
...CampaignConceptId[],
],
)
const supporterVoteIntentions = ['certo', 'tende_a_certo', 'indeciso', 'outro'] as const
const supporterSources = ['import_csv', 'manual', 'lideranca', 'convite', 'evento'] as const
const territorySortKeys = [
'region',
'municipalities',
'votes2022',
'pct',
'validVotes2022',
'estimate2026',
'coverage',
'cobertura',
'captura',
'classe',
] as const
const linkRequestSchema = z.discriminatedUnion('destination', [
z.object({ destination: z.literal('home'), label: labelSchema }),
z.object({ destination: z.literal('quadro'), label: labelSchema }),
z.object({ destination: z.literal('perfil'), label: labelSchema }),
z.object({ destination: z.literal('giros'), label: labelSchema }),
z.object({ destination: z.literal('leaderContacts'), label: labelSchema }),
z.object({
destination: z.literal('conceitos'),
conceptId: conceptIdSchema.optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('municipality'),
slug: z
.string()
.describe('Slug canônico do município (resolvido via searchEntities ou tools de dados).'),
label: labelSchema,
}),
z.object({
destination: z.literal('leadership'),
id: z.number().int().positive(),
label: labelSchema,
}),
z.object({
destination: z.literal('dobradinha'),
slug: z.string(),
label: labelSchema,
}),
z.object({
destination: z.literal('advisor'),
id: z.number().int().positive(),
label: labelSchema,
}),
z.object({
destination: z.literal('organization'),
slug: z.string(),
label: labelSchema,
}),
z.object({
destination: z.literal('activity'),
slug: z.string(),
label: labelSchema,
}),
z.object({
destination: z.literal('demand'),
slug: z.string(),
label: labelSchema,
}),
z.object({
destination: z.literal('supporter'),
id: z.number().int().positive(),
label: labelSchema,
}),
z.object({
destination: z.literal('municipalityList'),
q: z.string().optional(),
slugs: z.array(z.string()).optional(),
regions: z.array(territoryRegionSchema).optional(),
advisors: z.array(z.number().int().positive()).optional(),
coverage: z.enum(['com_assessor', 'sem_assessor']).optional(),
priority: z.literal('alta').optional(),
trends: z.array(z.enum(politicalTrendKeys)).optional(),
classes: z.array(z.enum(TERRITORIAL_CLASSES)).optional(),
levels: z.array(z.enum(municipalityListLevelFilterValues as [string, ...string[]])).optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('leadershipList'),
q: z.string().optional(),
statuses: z.array(z.enum(leadershipSupportStatuses)).optional(),
municipalities: z.array(z.number().int().positive()).optional(),
organizations: z.array(z.number().int().positive()).optional(),
stateDeputies: z.array(z.number().int().positive()).optional(),
access: z.enum(['com', 'sem']).optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('dobradinhaList'),
q: z.string().optional(),
parties: z.array(z.string()).optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('advisorList'),
q: z.string().optional(),
municipalities: z.array(z.number().int().positive()).optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('organizationList'),
q: z.string().optional(),
kind: z.enum(organizationKinds).optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('activityList'),
tab: z.enum(activityTabs).optional(),
q: z.string().optional(),
tag: z.string().trim().min(1).optional(),
status: z.enum(activityStatuses).optional(),
municipality: z.number().int().positive().optional(),
deputyPresent: z.boolean().optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('demandList'),
q: z.string().optional(),
status: z.enum(campaignDemandStatuses).optional(),
kind: z.enum(campaignDemandKinds).optional(),
activityId: z.number().int().positive().optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('supporterList'),
q: z.string().optional(),
voteIntention: z.enum(supporterVoteIntentions).optional(),
source: z.enum(supporterSources).optional(),
city: z.string().optional(),
municipality: z.number().int().positive().optional(),
label: labelSchema,
}),
z.object({
destination: z.literal('territoryList'),
q: z.string().optional(),
regions: z.array(territoryRegionSchema).optional(),
coverage: z.enum(['com_assessor', 'sem_assessor']).optional(),
sort: z.enum(territorySortKeys).optional(),
dir: z.enum(['asc', 'desc']).optional(),
label: labelSchema,
}),
])
export const buildCampaignLinks = (ctx: AIToolContext) =>
tool({
description:
'Build canonical /campanha navigation links for the staff to open in the app. ' +
'Use AFTER resolving entity ids/slugs with searchEntities or domain tools — never guess slugs. ' +
'Offer links when the user asks to open/go to a view, or proactively when answering about a single entity. ' +
'For "dobradinhas do assessor X" there is NO advisor filter on the dobradinhas list — use advisor detail plus individual dobradinha detail links instead.',
inputSchema: z.object({
links: z
.array(linkRequestSchema)
.min(1)
.max(5)
.describe(
'One or more navigation targets to build (batch for e.g. assessor + dobradinhas).',
),
}),
execute: async ({ links }) => {
const result = buildCampaignNavigationLinks(
ctx.user.role,
links as CampaignNavigationLinkRequest[],
)
if (result.errors?.length) {
return {
links: result.links,
errors: result.errors,
hint: 'Corrija os parâmetros inválidos ou use searchEntities para resolver ids/slugs antes de tentar de novo.',
}
}
return {
links: result.links,
formatting:
'Inclua cada link na resposta em markdown relativo: [rótulo](path). Ex.: [Ilhéus](/campanha/municipios/ilheus).',
}
},
})