优化

iam/src/main/resources/openapi/iam-v1.yaml

@@ -145,6 +145,73 @@ paths:
       responses:
         '200': {$ref: '#/components/responses/Success'}
         '403': {$ref: '#/components/responses/Forbidden'}
+  /api/platform/v1/iam/users:
+    get:
+      tags: [IAM Resources / IAM 资源]
+      summary: 统一查询平台及企业租户用户
+      responses:
+        '200': {$ref: '#/components/responses/Success'}
+        '403': {$ref: '#/components/responses/Forbidden'}
+    post:
+      tags: [IAM Resources / IAM 资源]
+      summary: 新增平台或企业租户用户
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/CreatePlatformManagedUserRequest'}
+      responses:
+        '200': {$ref: '#/components/responses/Success'}
+        '403': {$ref: '#/components/responses/Forbidden'}
+  /api/platform/v1/iam/users/options:
+    get:
+      tags: [IAM Resources / IAM 资源]
+      summary: 查询用户管理可选租户和角色
+      responses:
+        '200': {$ref: '#/components/responses/Success'}
+        '403': {$ref: '#/components/responses/Forbidden'}
+  /api/platform/v1/iam/users/{membershipId}:
+    parameters:
+      - {$ref: '#/components/parameters/MembershipId'}
+    put:
+      tags: [IAM Resources / IAM 资源]
+      summary: 编辑用户资料、所属租户及角色
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/UpdatePlatformManagedUserRequest'}
+      responses:
+        '200': {$ref: '#/components/responses/Success'}
+        '403': {$ref: '#/components/responses/Forbidden'}
+  /api/platform/v1/iam/users/{membershipId}/status:
+    parameters:
+      - {$ref: '#/components/parameters/MembershipId'}
+    put:
+      tags: [IAM Resources / IAM 资源]
+      summary: 启用或停用平台及企业租户用户
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/ChangeInternalUserStatusRequest'}
+      responses:
+        '200': {$ref: '#/components/responses/Success'}
+        '403': {$ref: '#/components/responses/Forbidden'}
+  /api/platform/v1/iam/users/{membershipId}/password:
+    parameters:
+      - {$ref: '#/components/parameters/MembershipId'}
+    put:
+      tags: [IAM Resources / IAM 资源]
+      summary: 重置平台及企业租户用户密码
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: {$ref: '#/components/schemas/ResetInternalUserPasswordRequest'}
+      responses:
+        '200': {$ref: '#/components/responses/Success'}
+        '403': {$ref: '#/components/responses/Forbidden'}
   /api/platform/v1/iam/internal-users:
     get:
       tags: [IAM Resources / IAM 资源]
@@ -505,6 +572,12 @@ components:
         contactName: {type: string}
         contactPhone: {type: string}
         contactEmail: {type: string, format: email}
+        servicePackage: {type: string, maxLength: 64}
+        creditDays: {type: integer, minimum: 0}
+        salesPerson: {type: string, maxLength: 64}
+        businessAddress: {type: string, maxLength: 255}
+        remark: {type: string, maxLength: 500}
+        createdAt: {type: string, format: date-time}
     RegisterRequest:
       type: object
       required: [tenantName, legalName, unifiedSocialCreditCode, contactName, contactPhone]
@@ -515,6 +588,11 @@ components:
         contactName: {type: string, example: 李四}
         contactPhone: {type: string, example: '13800138000'}
         contactEmail: {type: string, format: email, example: contact@example.com}
+        servicePackage: {type: string, maxLength: 64, example: 标准版}
+        creditDays: {type: integer, minimum: 0, example: 30}
+        salesPerson: {type: string, maxLength: 64, example: 李四}
+        businessAddress: {type: string, maxLength: 255}
+        remark: {type: string, maxLength: 500}
     UpdateProfileRequest:
       type: object
       required: [tenantName, legalName, contactName, contactPhone]
@@ -533,6 +611,11 @@ components:
         contactName: {type: string}
         contactPhone: {type: string}
         contactEmail: {type: string, format: email}
+        servicePackage: {type: string, maxLength: 64}
+        creditDays: {type: integer, minimum: 0}
+        salesPerson: {type: string, maxLength: 64}
+        businessAddress: {type: string, maxLength: 255}
+        remark: {type: string, maxLength: 500}
     ChangeTenantStatusRequest:
       type: object
       required: [status]
@@ -542,6 +625,27 @@ components:
       type: object
       properties:
         comment: {type: string, maxLength: 500, description: Review comment or rejection reason / 审核意见或驳回原因}
+    CreatePlatformManagedUserRequest:
+      type: object
+      required: [username, displayName, phone, tenantId, roleIds, password, status]
+      properties:
+        username: {type: string, minLength: 4, maxLength: 64}
+        displayName: {type: string, maxLength: 64}
+        phone: {type: string, pattern: '^1\\d{10}$'}
+        email: {type: string, format: email, maxLength: 128}
+        tenantId: {type: integer, format: int64}
+        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]}
+    UpdatePlatformManagedUserRequest:
+      type: object
+      required: [displayName, phone, tenantId, roleIds]
+      properties:
+        displayName: {type: string, maxLength: 64}
+        phone: {type: string, pattern: '^1\\d{10}$'}
+        email: {type: string, format: email, maxLength: 128}
+        tenantId: {type: integer, format: int64}
+        roleIds: {type: array, minItems: 1, items: {type: integer, format: int64}}
     CreateInternalUserRequest:
       type: object
       required: [displayName]