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

Co-Authored-By: Claude Code <noreply@anthropic.com>

packages/contracts/openapi.yaml

@@ -1242,7 +1242,25 @@ paths:
         - $ref: '#/components/parameters/CursorQuery'
         - name: limit
           in: query
-          description: 每页条数。
+          description: 每页条数（游标模式）。
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+            default: 20
+        - name: page
+          in: query
+          description: |
+            页码（偏移分页模式）：提供 page 且不带 cursor 时启用，响应返回
+            total 且 nextCursor=null / hasMore=false（翻页由 total 驱动）。
+            未提供 → 游标模式（keyset，兼容旧客户端）；提供 cursor 时忽略
+            page。仅管理列表模式有意义。
+          schema:
+            type: integer
+            minimum: 1
+        - name: pageSize
+          in: query
+          description: 偏移分页每页条数（仅 page 模式生效，缺省 20）。
           schema:
             type: integer
             minimum: 1
@@ -3665,6 +3683,29 @@ components:
           format: date-time
           readOnly: true
           description: 创建时间。
+        synced:
+          type: [object, 'null']
+          readOnly: true
+          description: |
+            同步源档案快照（G4：工号/邮箱/公司/头像，来自用户同步、落
+            external_user_mappings.profile 列）；本地创建/未同步用户为 null。
+            纯展示维度，不参与任何治理判定。
+          properties:
+            sn:
+              type: string
+              description: 工号。
+            email:
+              type: string
+              description: 企业邮箱。
+            companyName:
+              type: string
+              description: 公司全称。
+            companyAbbr:
+              type: string
+              description: 公司简称。
+            avatar:
+              type: string
+              description: 头像 URL。
 
     AdminUserList:
       allOf:
@@ -3677,6 +3718,9 @@ components:
               description: 用户条目（前缀模式按 account 升序且仅激活资格用户；管理列表模式按 createdAt 与 ID 稳定倒序）。
               items:
                 $ref: '#/components/schemas/AdminUser'
+            total:
+              type: [integer, 'null']
+              description: 过滤命中总数——仅管理列表 page 模式返回；游标/前缀模式为 null。
 
     AdminUserStatusFilter:
       type: string

packages/contracts/src/generated/openapi.d.ts

@@ -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;