169 lines
7.6 KiB
TypeScript
169 lines
7.6 KiB
TypeScript
/** 新建用户表单模型(任务 45):纯逻辑,镜像 Java AdminUserCreateRequest 字段与后端校验。 */
|
||
import type { PlatformTabId } from '../../config/platform-scope.ts'
|
||
|
||
export const CREATE_USERNAME_MIN_LEN = 2
|
||
export const CREATE_PASSWORD_MIN_LEN = 6
|
||
|
||
/**
|
||
* 新建用户可选角色:super_admin 不可由表单创建;company_super_admin 仅站点超管可选
|
||
* (后端 403「只有超级管理员可以创建公司超级管理员」兜底)。
|
||
*/
|
||
export type CreatableUserRole = 'normal' | 'admin' | 'company_super_admin'
|
||
|
||
export interface CreateUserForm {
|
||
username: string
|
||
password: string
|
||
role: CreatableUserRole
|
||
/** 授权菜单 id(后端 replaceDirectPermissions 用)。 */
|
||
columnIds: number[]
|
||
/** 所属管理员 id(超管创建普通账号时可指定,对齐 admin 的 created_by_id)。 */
|
||
createdBy?: number | null
|
||
/** 到期时间(yyyy-MM-dd HH:mm:ss);空串 = 永不过期(V146)。 */
|
||
expiresAt: string
|
||
/** 所属公司 id:仅 role=company_super_admin 时由站点超管必选(2026-10-05 需求)。 */
|
||
companyId?: number | null
|
||
/** 所属平台(V206):弹窗打开时预填当前平台 tab,单选可改。 */
|
||
platform: PlatformTabId
|
||
}
|
||
|
||
export interface CreateUserFormErrors {
|
||
username?: string
|
||
password?: string
|
||
companyId?: string
|
||
}
|
||
|
||
/** 发送 POST /api/admin/user 的请求体(与 Java AdminUserCreateRequest camelCase 对齐)。 */
|
||
export interface CreateUserPayload {
|
||
username: string
|
||
password: string
|
||
role: string
|
||
columnIds: number[]
|
||
/** 仅 role=normal 且选了所属管理员时发送,与参考 admin.js 的 created_by_id 语义一致。 */
|
||
createdById?: number
|
||
/** 到期时间;空串=永不过期,不下发。 */
|
||
expiresAt?: string
|
||
/** 仅 role=company_super_admin 且显式选了公司时下发——这是「建号不带 company_id」
|
||
* 反向钉(company-user-create.test.ts)唯一豁免的例外:公司超管必须落指定公司,
|
||
* 否则会静默落操作者自己的公司(公司 1),用户需求就是给别家公司开超管。 */
|
||
companyId?: number
|
||
/** 所属平台(V206):恒下发(弹窗单选默认当前平台 tab),缺省后端落 amazon。 */
|
||
platform: PlatformTabId
|
||
}
|
||
|
||
export function createEmptyCreateUserForm(): CreateUserForm {
|
||
return { username: '', password: '', role: 'normal', columnIds: [], createdBy: null, expiresAt: '', companyId: null, platform: 'amazon' }
|
||
}
|
||
|
||
/** 未知/空白/超管角色归一:admin/company_super_admin/normal 白名单,其余归 normal。 */
|
||
export function normalizeCreateRole(role: string | null | undefined): CreatableUserRole {
|
||
const value = (role || '').trim().toLowerCase()
|
||
if (value === 'admin') return 'admin'
|
||
if (value === 'company_super_admin') return 'company_super_admin'
|
||
return 'normal'
|
||
}
|
||
|
||
/**
|
||
* 目标公司是否不是操作者自己那家。任一侧未知时按「不算跨家」处理——未知不是证据,
|
||
* 拿它当证据会把管理员/普通账号的选项从自己家公司面前也收走。
|
||
*/
|
||
export function isCrossCompanyTarget(
|
||
operatorCompanyId: number | null | undefined,
|
||
targetCompanyId: number | null | undefined,
|
||
): boolean {
|
||
return operatorCompanyId != null && targetCompanyId != null && operatorCompanyId !== targetCompanyId
|
||
}
|
||
|
||
/**
|
||
* 建号弹窗的可选角色(2026-10-07 口径):站点超管停在别家公司 tab 上时,只剩「给那家开一个
|
||
* 公司超级管理员」;组长与普通账号由那家自己的公司超管开设。
|
||
*
|
||
* 与后端 `AdminUserService#ensureSubSuperAccountStaysWithOperatorCompany` 同一口径,两端各写
|
||
* 一遍的前提是这两处永远一起改——所以这里做成纯函数,用例直接喂三种角色×两种公司组合。
|
||
*/
|
||
export function resolveRoleChoices(
|
||
operatorSuper: boolean,
|
||
operatorCompanyId: number | null | undefined,
|
||
targetCompanyId: number | null | undefined,
|
||
): CreatableUserRole[] {
|
||
if (!operatorSuper) return ['admin', 'normal']
|
||
if (isCrossCompanyTarget(operatorCompanyId, targetCompanyId)) return ['company_super_admin']
|
||
return ['company_super_admin', 'admin', 'normal']
|
||
}
|
||
|
||
/**
|
||
* 弹窗默认选中的角色:普通账号优先——那是历史默认值,也是用得最多的一档。
|
||
* 只有 tab 收窄到不给选普通账号时(跨家公司)才退到唯一合法项,否则超管一进弹窗就落在
|
||
* 「公司超级管理员」上,点一次创建就多出一个超管账号。
|
||
*/
|
||
export function defaultRoleChoice(choices: CreatableUserRole[]): CreatableUserRole {
|
||
return choices.includes('normal') ? 'normal' : choices[0]
|
||
}
|
||
|
||
/**
|
||
* 可携带「自己的到期时间」的角色,与后端 AdminUserService#mayCarryOwnExpiry 逐字对齐
|
||
* (normal-account-no-own-expiry.test.ts 钉两端集合相等)。普通账号的停用只由上级
|
||
* (组长/公司超管)级联决定,给它单独设到期时间既没入口也没语义。
|
||
*/
|
||
export const EXPIRY_OWNABLE_ROLES: ReadonlyArray<string> = ['admin', 'company_super_admin']
|
||
|
||
export function mayCarryOwnExpiry(role: string | null | undefined): boolean {
|
||
return EXPIRY_OWNABLE_ROLES.includes((role || '').trim().toLowerCase())
|
||
}
|
||
|
||
/** 表单校验(镜像后端:用户名≥2、密码≥6、均必填;公司超管必须选公司);返回逐字段错误。 */
|
||
export function validateCreateUserForm(form: CreateUserForm): {
|
||
valid: boolean
|
||
errors: CreateUserFormErrors
|
||
} {
|
||
const errors: CreateUserFormErrors = {}
|
||
const username = (form.username || '').trim()
|
||
if (!username) {
|
||
errors.username = '用户名不能为空'
|
||
} else if (username.length < CREATE_USERNAME_MIN_LEN) {
|
||
errors.username = `用户名至少${CREATE_USERNAME_MIN_LEN}个字符`
|
||
}
|
||
const password = form.password || ''
|
||
if (!password) {
|
||
errors.password = '密码不能为空'
|
||
} else if (password.length < CREATE_PASSWORD_MIN_LEN) {
|
||
errors.password = `密码至少${CREATE_PASSWORD_MIN_LEN}个字符`
|
||
}
|
||
if (normalizeCreateRole(form.role) === 'company_super_admin' && form.companyId == null) {
|
||
errors.companyId = '公司超级管理员必须指定所属公司'
|
||
}
|
||
return { valid: Object.keys(errors).length === 0, errors }
|
||
}
|
||
|
||
/**
|
||
* 表单 → 创建请求体:用户名去空格、角色归一、菜单 id 拷贝不共享引用;
|
||
* createdById 仅在 role=normal 且选了所属管理员时携带(对齐 admin.js 的 created_by_id 语义)。
|
||
*
|
||
* <p>company_id 仅在 role=company_super_admin 且显式选择时下发(见 CreateUserPayload 注释);
|
||
* 其余角色不带——归属由后端 `AdminUserService#resolveTargetCompanyId` 落操作者自己的公司,
|
||
* 想给别的公司建普通账号,得用那个公司自己的管理员登录,不是在这里改请求体。</p>
|
||
*
|
||
* <p>expiresAt 只对可带到期时间的角色下发:普通账号的停用走上级级联,
|
||
* 带了会被后端 400 打回(界面已隐藏该输入项,这里是「表单残留值」的兜底)。</p>
|
||
*/
|
||
export function toCreateUserRequest(form: CreateUserForm): CreateUserPayload {
|
||
const role = normalizeCreateRole(form.role)
|
||
const payload: CreateUserPayload = {
|
||
username: (form.username || '').trim(),
|
||
password: form.password || '',
|
||
role,
|
||
columnIds: Array.isArray(form.columnIds) ? form.columnIds.slice() : [],
|
||
platform: form.platform,
|
||
}
|
||
if (payload.role === 'normal' && form.createdBy != null) {
|
||
payload.createdById = form.createdBy
|
||
}
|
||
if (mayCarryOwnExpiry(role) && form.expiresAt && String(form.expiresAt).trim()) {
|
||
payload.expiresAt = String(form.expiresAt).trim()
|
||
}
|
||
|
||
if (role === 'company_super_admin' && form.companyId != null) {
|
||
payload.companyId = form.companyId
|
||
}
|
||
return payload
|
||
}
|