优化

2026-08-04 13:32:24 +08:00
parent 434715b938
commit 694425690c
9 changed files with 197 additions and 138 deletions
@@ -210,13 +210,22 @@ paths:
  /api/platform/v1/iam/users:
    get:
      tags: [IAM Resources / IAM 资源]
-      summary: 统一查询平台及企业租户用户
+      summary: 分页查询平台内部用户
+      parameters:
+        - {name: page, in: query, schema: {type: integer, minimum: 1, default: 1}}
+        - {name: size, in: query, schema: {type: integer, minimum: 1, maximum: 200, default: 20}}
+        - {name: keyword, in: query, schema: {type: string}, description: 匹配姓名、手机号、邮箱或成员编号}
+        - {name: status, in: query, schema: {type: string, enum: [ACTIVE, DISABLED]}}
      responses:
-        '200': {$ref: '#/components/responses/Success'}
+        '200':
+          description: 仅返回 tenant_id=0 的平台内部用户分页
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/PlatformManagedUserPageApiResponse'}
        '403': {$ref: '#/components/responses/Forbidden'}
    post:
      tags: [IAM Resources / IAM 资源]
-      summary: 新增平台或企业租户用户
+      summary: 新增平台内部用户
      requestBody:
        required: true
        content:
@@ -228,7 +237,7 @@ paths:
  /api/platform/v1/iam/users/options:
    get:
      tags: [IAM Resources / IAM 资源]
-      summary: 查询用户管理可选租户和角色
+      summary: 查询平台租户和 PLATFORM 角色选项
      responses:
        '200': {$ref: '#/components/responses/Success'}
        '403': {$ref: '#/components/responses/Forbidden'}
@@ -237,7 +246,7 @@ paths:
      - {$ref: '#/components/parameters/MembershipId'}
    put:
      tags: [IAM Resources / IAM 资源]
-      summary: 编辑用户资料、所属租户及角色
+      summary: 编辑平台内部用户资料及角色
      requestBody:
        required: true
        content:
@@ -251,7 +260,7 @@ paths:
      - {$ref: '#/components/parameters/MembershipId'}
    put:
      tags: [IAM Resources / IAM 资源]
-      summary: 启用或停用平台及企业租户用户
+      summary: 启用或停用平台内部用户
      requestBody:
        required: true
        content:
@@ -265,7 +274,7 @@ paths:
      - {$ref: '#/components/parameters/MembershipId'}
    put:
      tags: [IAM Resources / IAM 资源]
-      summary: 重置平台及企业租户用户密码
+      summary: 重置平台内部用户密码
      requestBody:
        required: true
        content:
@@ -748,6 +757,20 @@ components:
        - type: object
          properties:
            data: {$ref: '#/components/schemas/InternalUserResponse'}
+    PlatformManagedUserPageApiResponse:
+      allOf:
+        - {$ref: '#/components/schemas/ApiResponse'}
+        - type: object
+          properties:
+            data:
+              type: object
+              required: [records, page, size, total, pages]
+              properties:
+                records: {type: array, items: {$ref: '#/components/schemas/PlatformManagedUserResponse'}}
+                page: {type: integer, minimum: 1}
+                size: {type: integer, minimum: 1}
+                total: {type: integer, minimum: 0}
+                pages: {type: integer, minimum: 0}
    TenantResponse:
      type: object
      required: [id, tenantCode, tenantName, status, servicePackage]
@@ -883,7 +906,7 @@ components:
        displayName: {type: string, maxLength: 64}
        phone: {type: string, pattern: '^1\\d{10}$'}
        email: {type: string, format: email, maxLength: 128}
-        tenantId: {type: integer, format: int64}
+        tenantId: {type: integer, format: int64, enum: [0], description: 保留的兼容字段，只允许平台租户 0}
        roleIds: {type: array, minItems: 1, items: {type: integer, format: int64}}
        password: {type: string, format: password, minLength: 8, maxLength: 64, writeOnly: true}
        status: {type: string, enum: [ACTIVE, DISABLED]}
@@ -894,7 +917,7 @@ components:
        displayName: {type: string, maxLength: 64}
        phone: {type: string, pattern: '^1\\d{10}$'}
        email: {type: string, format: email, maxLength: 128}
-        tenantId: {type: integer, format: int64}
+        tenantId: {type: integer, format: int64, enum: [0], description: 保留的兼容字段，只允许平台租户 0}
        roleIds: {type: array, minItems: 1, items: {type: integer, format: int64}}
    CreateInternalUserRequest:
      type: object
@@ -948,6 +971,26 @@ components:
        memberNo: {type: string}
        status: {type: string, enum: [ACTIVE, DISABLED]}
        roleIds: {type: array, items: {type: integer, format: int64}}
+    PlatformManagedUserResponse:
+      type: object
+      required: [membershipId, userId, authUserId, username, displayName, tenantId, tenantName, memberType, status, roleIds, roleNames, protectedAccount]
+      properties:
+        membershipId: {type: string, pattern: '^\d+$'}
+        userId: {type: string, pattern: '^\d+$'}
+        authUserId: {type: string, pattern: '^\d+$'}
+        username: {type: string}
+        displayName: {type: string}
+        phone: {type: string}
+        email: {type: string, format: email}
+        tenantId: {type: string, enum: ['0']}
+        tenantName: {type: string, enum: [平台]}
+        memberType: {type: string, enum: [EMPLOYEE]}
+        memberNo: {type: string}
+        status: {type: string, enum: [ACTIVE, DISABLED]}
+        roleIds: {type: array, items: {type: string, pattern: '^\d+$'}}
+        roleNames: {type: array, items: {type: string}}
+        lastLoginAt: {type: string, format: date-time, nullable: true}
+        protectedAccount: {type: boolean}
    CreateMemberRequest:
      type: object
      required: [username, password, displayName, memberType]