/** 新建用户表单模型(任务 45):纯逻辑,镜像 Java AdminUserCreateRequest 字段与后端校验。 */ export const CREATE_USERNAME_MIN_LEN = 2 export const CREATE_PASSWORD_MIN_LEN = 6 /** 新建用户可选角色:super_admin 不可由表单创建(后端只收 admin|normal)。 */ export type CreatableUserRole = 'normal' | 'admin' export interface CreateUserForm { username: string password: string role: CreatableUserRole /** 授权菜单 id(后端 replaceDirectPermissions 用)。 */ columnIds: number[] /** 所属管理员 id(超管创建普通账号时可指定,对齐 admin 的 created_by_id)。 */ createdBy?: number | null } export interface CreateUserFormErrors { username?: string password?: 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 } export function createEmptyCreateUserForm(): CreateUserForm { return { username: '', password: '', role: 'normal', columnIds: [], createdBy: null } } /** 未知/空白/超管角色一律归一到 normal,与后端 "admin"/"normal" 白名单一致。 */ export function normalizeCreateRole(role: string | null | undefined): CreatableUserRole { return (role || '').trim().toLowerCase() === 'admin' ? 'admin' : 'normal' } /** 表单校验(镜像后端:用户名≥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}个字符` } return { valid: Object.keys(errors).length === 0, errors } } /** 表单 → 创建请求体:用户名去空格、角色归一、菜单 id 拷贝不共享引用; * createdById 仅在 role=normal 且选了所属管理员时携带(对齐 admin.js 的 created_by_id 语义)。 */ export function toCreateUserRequest(form: CreateUserForm): CreateUserPayload { const payload: CreateUserPayload = { username: (form.username || '').trim(), password: form.password || '', role: normalizeCreateRole(form.role), columnIds: Array.isArray(form.columnIds) ? form.columnIds.slice() : [], } if (payload.role === 'normal' && form.createdBy != null) { payload.createdById = form.createdBy } return payload }