Files
crawler-plugin/admin-frontend-vue/src/pages/account/user-create-model.ts
T

169 lines
7.6 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/** 新建用户表单模型(任务 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
}