/** 用户角色字段映射(任务 48):行 role/is_admin → 角色域 → 可编辑值/锁定原因,镜像 Java 约束。 */ import { roleKind } from '../../types/admin.ts' /** 后台角色域(与 AdminUserItemVo.role / is_admin 对齐)。 */ export type RoleDomain = 'super_admin' | 'company_super_admin' | 'admin' | 'normal' /** 用户角色下拉可选值;super_admin 只能由系统持有,不入下拉。 */ export type EditableRole = 'company_super_admin' | 'admin' | 'normal' export interface UserRoleOption { value: EditableRole label: string } /** 建/编辑表单角色下拉候选(镜像后端白名单;company_super_admin 仅站点超管可选)。 */ export const USER_ROLE_OPTIONS: readonly UserRoleOption[] = [ { value: 'company_super_admin', label: '公司超级管理员' }, { value: 'admin', label: '管理员' }, { value: 'normal', label: '普通账号' }, ] const ROLE_DOMAIN_LABELS: Record = { super_admin: '超级管理员', company_super_admin: '公司超级管理员', admin: '管理员', normal: '普通账号', } /** 行字段 → 角色域:优先 role;为空时按 is_admin 布尔推断(1=管理员);未知归 normal。 */ export function roleDomainOf(row: { role?: string | null; isAdmin?: boolean }): RoleDomain { const kind = roleKind(row?.role) if (kind === 'super_admin' || kind === 'company_super_admin' || kind === 'admin' || kind === 'normal') return kind return row?.isAdmin ? 'admin' : 'normal' } /** 行 → 可编辑角色值:站点/公司超管不可在此编辑角色(返回 null),其余返回对应值。 */ export function selectRoleOf(row: { role?: string | null; isAdmin?: boolean }): EditableRole | null { const domain = roleDomainOf(row) if (domain === 'super_admin' || domain === 'company_super_admin') return null return domain } /** 角色域展示文案。 */ export function roleDomainLabel(domain: RoleDomain): string { return ROLE_DOMAIN_LABELS[domain] || '' } /** * 角色下拉锁定原因:目标为站点/公司超管、或操作者非站点超管(镜像后端:admin/公司超管 * 编辑时角色不可调、super_admin 与同公司公司超管不可改)。无锁定时返回 undefined。 */ export function userRoleLockMessage( operatorRole: string | null | undefined, target: { role?: string | null; isAdmin?: boolean }, ): string | undefined { const targetDomain = roleDomainOf(target) if (targetDomain === 'super_admin') return '不能修改超级管理员' if (targetDomain === 'company_super_admin') return '只有超级管理员可以修改公司超级管理员' if (roleKind(operatorRole) !== 'super_admin') return '仅超级管理员可调整角色' return undefined }