teqo/src/lib/schemas/advisor.ts
Francisco Ignácio Fontoura Solla 26b2205c3a B154 — criar assessor inline no popover da lista de municípios
Closes #352

- POST /campanha/municipios/advisors aceita body de criação (name) na union;
  createMunicipalityAdvisorRecord cria campaignUser advisor (stub
  <slug>@criado.invalid, senha aleatória) e atribui ao município na mesma
  transação (cap 10 com rollback, lock municipality-advisors:{id})
- MunicipalityAdvisorCreateProvider compartilha o assessor criado entre linhas;
  opção "+ Criar assessor" e chip otimista com id temporário no control
- advisorNameSchema unificado em primitives.ts; predicado de placeholder cobre
  @criado.invalid (reset de senha e célula de e-mail tratam stubs inline)
- Destrava o spec e2e de municipios (falhas pré-existentes em main): key
  warning do fragment trailing de MunicipalityFilters; settle-wait da animação
  do Drawer no teste B136
2026-08-03 22:46:06 -03:00

114 lines
4.3 KiB
TypeScript

import { z } from 'zod'
import {
MAX_MUNICIPALITIES_PER_BATCH,
MUNICIPALITY_ADVISORS_CAP_MESSAGE,
} from '@/lib/schemas/municipality'
import {
advisorNameSchema,
brazilianMobile,
optionalPersistedEmail,
positiveRelationshipId,
trimmedOptionalText,
} from '@/lib/schemas/primitives'
import { slugify } from '@/lib/slug'
const PLANILHA_INVALID_EMAIL_SUFFIX = '@planilha.invalid'
const INLINE_STUB_EMAIL_SUFFIX = '@criado.invalid'
/**
* Seed (`@planilha.invalid`, E4R) and inline-created (`@criado.invalid`, B154)
* stub emails — non-routable placeholders that mark a not-yet-activated
* account. Shared by the password-reset guard (`PLACEHOLDER_RESET_MESSAGE`) and
* the advisors list e-mail cell, so an inline-created account behaves exactly
* like a seeded one until a coordinator swaps in real credentials.
*/
export const isPlanilhaPlaceholderEmail = (email: string | null | undefined): boolean =>
typeof email === 'string' &&
(email.trim().toLowerCase().endsWith(PLANILHA_INVALID_EMAIL_SUFFIX) ||
email.trim().toLowerCase().endsWith(INLINE_STUB_EMAIL_SUFFIX))
/** Stable seed-style placeholder used when the e-mail field is cleared in the list UI. */
export const planilhaPlaceholderEmailForAdvisor = (advisorId: number): string =>
`assessor-${advisorId}${PLANILHA_INVALID_EMAIL_SUFFIX}`
/**
* Inline-create stub (B154): `<slug-do-nome>@criado.invalid`, `-N` from the
* second occurrence — `campaignUser.email` is unique while `name` is not, so
* two advisors whose names slugify identically get distinct stubs. Same
* deterministic pattern as the E4R seed; `name` is only the input to `slugify`.
*/
export const stubCampaignUserEmailFor = (name: string, occurrence = 1): string => {
const localPart = slugify(name) || 'assessor'
return `${localPart}${occurrence > 1 ? `-${occurrence}` : ''}${INLINE_STUB_EMAIL_SUFFIX}`
}
const advisorPhoneInput = z.union([brazilianMobile, z.literal(''), z.null()]).optional()
const optionalAdvisorPhone = advisorPhoneInput.transform((value) =>
value === '' || value === null || value === undefined ? undefined : value,
)
const nullableAdvisorPhone = advisorPhoneInput.transform((value) =>
value === '' || value === undefined ? null : value,
)
export const PLACEHOLDER_RESET_MESSAGE =
'Troque o e-mail placeholder da planilha por um e-mail real antes de enviar o link de senha.'
export const ADVISOR_UNRESTRICTED_MESSAGE =
'Somente a coordenação geral ou o candidato gerencia assessores.'
export const ADVISOR_EMAIL_CONFLICT_MESSAGE = 'Já existe uma conta com este e-mail.'
/** Same exact-string contract: refused writes on another account's role/self. */
export const ADVISOR_ROLE_REQUIRED_MESSAGE =
'Só é possível gerenciar contas com papel de Assessor nesta tela.'
export const ADVISOR_SELF_ACCOUNT_MESSAGE = 'Use Meu perfil para alterar a própria conta.'
export const ADVISOR_ACTION_SAFE_MESSAGES = [
ADVISOR_UNRESTRICTED_MESSAGE,
ADVISOR_EMAIL_CONFLICT_MESSAGE,
PLACEHOLDER_RESET_MESSAGE,
ADVISOR_ROLE_REQUIRED_MESSAGE,
ADVISOR_SELF_ACCOUNT_MESSAGE,
MUNICIPALITY_ADVISORS_CAP_MESSAGE,
] as const
export const advisorCreateSchema = z.object({
name: advisorNameSchema,
email: z.email('E-mail inválido.'),
phone: optionalAdvisorPhone,
})
export const advisorProfileUpdateSchema = z
.object({
id: positiveRelationshipId,
name: trimmedOptionalText(160),
email: optionalPersistedEmail,
phone: nullableAdvisorPhone,
})
.refine(
(value) => value.name !== undefined || value.email !== undefined || value.phone !== undefined,
{ message: 'Informe ao menos um campo para atualizar.' },
)
export const advisorMunicipalitiesBatchSchema = z.object({
advisorId: positiveRelationshipId,
// Dedup at the boundary (P3-K): the action used to re-spell `[...new Set(…)]`.
municipalityIds: z
.array(positiveRelationshipId)
.min(1)
.max(MAX_MUNICIPALITIES_PER_BATCH)
.transform((ids) => [...new Set(ids)]),
assigned: z.boolean(),
})
export const advisorPasswordResetSchema = z.object({
advisorId: positiveRelationshipId,
})
export type AdvisorCreateInput = z.input<typeof advisorCreateSchema>
export type AdvisorProfileUpdateInput = z.input<typeof advisorProfileUpdateSchema>
export type AdvisorMunicipalitiesBatchInput = z.input<typeof advisorMunicipalitiesBatchSchema>
export type AdvisorPasswordResetInput = z.input<typeof advisorPasswordResetSchema>