teqo-backup/src/utilities/advisorData.ts
Cursor Agent 4d4764893e
B142 — filtrar assessores por município da carteira na omnibox
Adiciona dimensão municipality na URL e omnibox da lista de assessores,
espelhando o precedente de lideranças: chips removíveis, busca tipada no
catálogo e filtro server OR via municipality.advisors.

Closes #310

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-08-02 23:05:33 +00:00

249 lines
7.1 KiB
TypeScript

import 'server-only'
import type { Payload } from 'payload'
import { relationshipId } from '@/lib/relationship'
import {
advisorListHrefForPage,
parseAdvisorListParams,
type AdvisorListState,
} from '@/utilities/advisor/advisorListUrl'
export { advisorListHrefForPage, parseAdvisorListParams }
export type { AdvisorListState }
type AdvisorMunicipalityViewModel = {
id: number
name: string
slug: string
}
type AdvisorAccountViewModel = {
id: number
name: string
email: string | null
phone: string | null
}
/**
* Ids only: the list renders the portfolio as chips, which resolve their own
* labels from the static catalog. Names here would ship a second copy of them.
*/
export type AdvisorRowViewModel = AdvisorAccountViewModel & {
municipalityIDs: number[]
}
/** The detail page renders real names and links, so it keeps the labels. */
export type AdvisorDetailViewModel = AdvisorAccountViewModel & {
municipalities: AdvisorMunicipalityViewModel[]
}
const advisorPageSize = 25
/** Union of advisors linked on any of the given municipalities (OR semantics). */
const advisorIdsForMunicipalityFilter = async (
payload: Payload,
municipalityIds: number[],
): Promise<number[]> => {
if (municipalityIds.length === 0) return []
// Intentional admin bypass: same rationale as `municipalityIdsByAdvisorIds` — the
// unrestricted route gate already asserted staff; this read only resolves filter ids.
const municipalities = await payload.find({
collection: 'municipality',
where: { id: { in: municipalityIds } },
depth: 0,
limit: 0,
pagination: false,
select: { advisors: true },
overrideAccess: true,
})
const advisorIds = new Set<number>()
for (const municipality of municipalities.docs) {
for (const advisor of municipality.advisors ?? []) {
const id = relationshipId(advisor)
if (id !== null) advisorIds.add(id)
}
}
return [...advisorIds]
}
/** Fan a município out to each of the advisors the caller asked about. */
const collectByAdvisor = <T>(
advisors: readonly unknown[] | null | undefined,
advisorIdSet: ReadonlySet<number>,
byAdvisor: Map<number, T[]>,
value: T,
) => {
for (const advisor of advisors ?? []) {
const id = relationshipId(advisor)
if (id === null || !advisorIdSet.has(id)) continue
const list = byAdvisor.get(id)
if (list) list.push(value)
else byAdvisor.set(id, [value])
}
}
/**
* Portfolio ids for the LIST, which renders chips that resolve their own labels
* from the static catalog — sending names here would ship a second copy of them.
*
* Intentional admin bypass: advisor rows already resolved after the unrestricted
* route gate.
*/
export const municipalityIdsByAdvisorIds = async (
payload: Payload,
advisorIDs: number[],
): Promise<Map<number, number[]>> => {
const byAdvisor = new Map<number, number[]>()
if (advisorIDs.length === 0) return byAdvisor
const advisorIdSet = new Set(advisorIDs)
const municipalities = await payload.find({
collection: 'municipality',
where: { advisors: { in: advisorIDs } },
depth: 0,
limit: 0,
pagination: false,
sort: 'name',
select: { advisors: true },
overrideAccess: true,
})
for (const municipality of municipalities.docs) {
collectByAdvisor(municipality.advisors, advisorIdSet, byAdvisor, municipality.id)
}
return byAdvisor
}
/** Same portfolio with labels, for the DETAIL page, which renders real links. */
const municipalitiesByAdvisorIds = async (
payload: Payload,
advisorIDs: number[],
): Promise<Map<number, AdvisorMunicipalityViewModel[]>> => {
const byAdvisor = new Map<number, AdvisorMunicipalityViewModel[]>()
if (advisorIDs.length === 0) return byAdvisor
const advisorIdSet = new Set(advisorIDs)
// Intentional admin bypass — same rationale as the sibling above.
const municipalities = await payload.find({
collection: 'municipality',
where: { advisors: { in: advisorIDs } },
depth: 0,
limit: 0,
pagination: false,
sort: 'name',
select: { name: true, slug: true, advisors: true },
overrideAccess: true,
})
for (const municipality of municipalities.docs) {
collectByAdvisor(municipality.advisors, advisorIdSet, byAdvisor, {
id: municipality.id,
name: municipality.name,
slug: municipality.slug,
})
}
return byAdvisor
}
/**
* Lists advisor accounts for the unrestricted management UI.
*
* Intentional admin bypass (no `user`): `email`/`username` are stripped by
* `removePrivateAuthFields` and gated by self-only field access — the page
* gate already asserted `isCampaignUnrestricted`, and the job is to surface
* placeholder `@planilha.invalid` emails so staff can activate accounts.
*/
export const loadAdvisorListPageData = async (
payload: Payload,
state: AdvisorListState,
): Promise<{ rows: AdvisorRowViewModel[]; totalDocs: number; totalPages: number }> => {
const municipalityAdvisorIds = state.municipalities?.length
? await advisorIdsForMunicipalityFilter(payload, state.municipalities)
: undefined
if (municipalityAdvisorIds && municipalityAdvisorIds.length === 0) {
return { rows: [], totalDocs: 0, totalPages: 0 }
}
const result = await payload.find({
collection: 'campaignUser',
where: {
and: [
{ role: { equals: 'advisor' } },
...(municipalityAdvisorIds ? [{ id: { in: municipalityAdvisorIds } }] : []),
...(state.q
? [
{
or: [{ name: { contains: state.q } }, { email: { contains: state.q } }],
},
]
: []),
],
},
depth: 0,
limit: advisorPageSize,
page: state.page,
sort: 'name',
select: { name: true, email: true, phone: true, role: true },
overrideAccess: true,
})
const advisorIDs = result.docs.map((doc) => doc.id)
const municipalityIdsByAdvisor = await municipalityIdsByAdvisorIds(payload, advisorIDs)
return {
rows: result.docs.map((doc) => ({
id: doc.id,
name: doc.name,
email: doc.email ?? null,
phone: doc.phone ?? null,
municipalityIDs: municipalityIdsByAdvisor.get(doc.id) ?? [],
})),
totalDocs: result.totalDocs,
totalPages: result.totalPages,
}
}
export const loadAdvisorDetail = async (
payload: Payload,
advisorId: number,
): Promise<AdvisorDetailViewModel | null> => {
if (!Number.isInteger(advisorId) || advisorId <= 0) return null
let advisor: {
id: number
name: string
email?: string | null
phone?: string | null
role: string
}
try {
// Intentional admin bypass — same rationale as `loadAdvisorListPageData`.
advisor = await payload.findByID({
collection: 'campaignUser',
id: advisorId,
depth: 0,
select: { name: true, email: true, phone: true, role: true },
overrideAccess: true,
})
} catch {
return null
}
if (advisor.role !== 'advisor') return null
const municipalitiesByAdvisor = await municipalitiesByAdvisorIds(payload, [advisor.id])
return {
id: advisor.id,
name: advisor.name,
email: advisor.email ?? null,
phone: advisor.phone ?? null,
municipalities: municipalitiesByAdvisor.get(advisor.id) ?? [],
}
}