/** 用户管理列表/分页 DTO(任务 41):纯逻辑,无框架依赖,与 Java AdminUserController 对齐。 */ import type { AdminUser } from '../types/admin' export const USER_PAGE_DEFAULT_SIZE = 10 export const USER_PAGE_MIN_PAGE = 1 export const USER_PAGE_MAX_SIZE = 200 /** 前端用户列表筛选/分页状态(页面局部,不入 Pinia)。 */ export interface UserListParams { page: number pageSize: number /** 用户名模糊关键字(对应后端 username|search 的 kw)。 */ keyword?: string createdById?: number | null adminId?: number | null /** 角色过滤(''=全部)。 */ role?: string /** 公司 tab 的当前公司;由页面从 store 传入,**不住在 UserFilterState 里** * (normalizeUserPageParams 白名单构造会把它丢掉,取值口只认 fetchUserList 的原始入参)。 */ companyId?: number | null } /** 序列化到 GET /api/admin/users 的查询参数(Java snake_case)。 */ export interface UserListQuery { page: number page_size: number username?: string search?: string created_by_id?: number admin_id?: number role?: string company_id?: number } /** 用户列表项即 AdminUser(与 Java AdminUserItemVo 字段对齐)。 */ export type AdminUserItem = AdminUser /** 分页结果:与 Java AdminUserListVo.items/total/page/page_size 归一后的前端 DTO。 */ export interface UserPageResult { items: AdminUserItem[] total: number page: number pageSize: number currentUserId?: number | null currentUserUsername?: string admins?: Array<{ id: number; username: string }> } function finiteInt(value: unknown): number | null { return typeof value === 'number' && Number.isFinite(value) ? Math.floor(value) : null } /** 归一化分页/筛选参数:页码下限 1、页大小 1..上限,空关键字视为无过滤。 */ export function normalizeUserPageParams(raw: Partial): UserListParams { const page = Math.max(finiteInt(raw.page) ?? USER_PAGE_MIN_PAGE, USER_PAGE_MIN_PAGE) const rawSize = finiteInt(raw.pageSize) const pageSize = rawSize === null || rawSize < USER_PAGE_MIN_PAGE ? USER_PAGE_DEFAULT_SIZE : Math.min(rawSize, USER_PAGE_MAX_SIZE) const keyword = typeof raw.keyword === 'string' ? raw.keyword.trim() || undefined : undefined return { page, pageSize, keyword, createdById: typeof raw.createdById === 'number' ? raw.createdById : null, adminId: typeof raw.adminId === 'number' ? raw.adminId : null, role: typeof raw.role === 'string' ? raw.role.trim() || undefined : undefined, } } /** 把前端分页/筛选状态转成 Java 查询参数(缺省字段不下发)。 */ export function toUserListQuery(params: UserListParams): UserListQuery { const query: UserListQuery = { page: params.page, page_size: params.pageSize } if (params.keyword) query.username = params.keyword if (params.createdById != null) query.created_by_id = params.createdById if (params.adminId != null) query.admin_id = params.adminId if (params.role) query.role = params.role return query } /** 无数据分页结果缺省值(首屏/加载前占位)。 */ export function emptyUserPageResult(): UserPageResult { return { items: [], total: 0, page: USER_PAGE_MIN_PAGE, pageSize: USER_PAGE_DEFAULT_SIZE } }