feat(contracts,api): page-mode pagination + synced profile on admin users list

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-22 18:06:12 +08:00
parent 91c85e196a
commit 2f6b6afc92
7 changed files with 337 additions and 15 deletions
+29 -1
View File
@@ -1833,10 +1833,29 @@ export interface components {
* @description 创建时间。
*/
readonly createdAt: string;
/**
* @description 同步源档案快照(G4:工号/邮箱/公司/头像,来自用户同步、落
* external_user_mappings.profile 列);本地创建/未同步用户为 null。
* 纯展示维度,不参与任何治理判定。
*/
readonly synced?: {
/** @description 工号。 */
sn?: string;
/** @description 企业邮箱。 */
email?: string;
/** @description 公司全称。 */
companyName?: string;
/** @description 公司简称。 */
companyAbbr?: string;
/** @description 头像 URL。 */
avatar?: string;
} | null;
};
AdminUserList: components["schemas"]["CursorPageMeta"] & {
/** @description 用户条目(前缀模式按 account 升序且仅激活资格用户;管理列表模式按 createdAt 与 ID 稳定倒序)。 */
items: components["schemas"]["AdminUser"][];
/** @description 过滤命中总数——仅管理列表 page 模式返回;游标/前缀模式为 null。 */
total?: number | null;
};
/**
* @description 管理列表治理状态过滤(单值归类):pending=待激活;disabled=上游停用;
@@ -3968,8 +3987,17 @@ export interface operations {
status?: components["schemas"]["AdminUserStatusFilter"];
/** @description 分页游标(上一页响应的 nextCursor)。 */
cursor?: components["parameters"]["CursorQuery"];
/** @description 每页条数。 */
/** @description 每页条数(游标模式)。 */
limit?: number;
/**
* @description 页码(偏移分页模式):提供 page 且不带 cursor 时启用,响应返回
* total 且 nextCursor=null / hasMore=false(翻页由 total 驱动)。
* 未提供 → 游标模式(keyset,兼容旧客户端);提供 cursor 时忽略
* page。仅管理列表模式有意义。
*/
page?: number;
/** @description 偏移分页每页条数(仅 page 模式生效,缺省 20)。 */
pageSize?: number;
};
header?: never;
path?: never;