90 lines
3.5 KiB
TypeScript
90 lines
3.5 KiB
TypeScript
/** 用户管理列表/分页 DTO(任务 41):纯逻辑,无框架依赖,与 Java AdminUserController 对齐。 */
|
||
import type { AdminUser } from '../types/admin'
|
||
import type { PlatformTabId } from '../config/platform-scope.ts'
|
||
|
||
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
|
||
/** 平台 tab 的当前平台(V206);同 companyId 形状:白名单构造不收,从原始入参读。 */
|
||
platform?: PlatformTabId
|
||
}
|
||
|
||
/** 序列化到 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
|
||
platform?: string
|
||
}
|
||
|
||
/** 用户列表项即 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>): 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 }
|
||
}
|