优化

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

@@ -259,7 +259,11 @@ paths:
       summary: List pending tenant reviews / 查询待审核企业
       description: Return enterprise registrations waiting for a platform decision. / 返回等待平台处理的企业注册审核记录。
       responses:
-        '200': {$ref: '#/components/responses/Success'}
+        '200':
+          description: 待审核企业及客户摘要查询成功
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/PendingEnterpriseReviewListApiResponse'}
         '403': {$ref: '#/components/responses/Forbidden'}
   /api/platform/v1/iam/reviews/{id}/approve:
     post:
@@ -903,6 +907,29 @@ components:
         - type: object
           properties:
             data: {$ref: '#/components/schemas/TenantApprovalResponse'}
+    PendingEnterpriseReviewListApiResponse:
+      allOf:
+        - {$ref: '#/components/schemas/ApiResponse'}
+        - type: object
+          properties:
+            data:
+              type: array
+              items: {$ref: '#/components/schemas/PendingEnterpriseReviewResponse'}
+    PendingEnterpriseReviewResponse:
+      type: object
+      required: [id, tenantId, reviewType, status, tenantName, tenantCode, contactName, submittedAt]
+      properties:
+        id: {type: string, pattern: '^\d+$', description: 审核单 ID}
+        tenantId: {type: string, pattern: '^\d+$', description: 客户 ID}
+        reviewType: {type: string, example: REGISTER}
+        status: {type: string, enum: [PENDING]}
+        tenantName: {type: string, description: 客户名称}
+        tenantCode: {type: string, description: 客户编号}
+        contactName: {type: string, description: 联系人}
+        contactPhone: {type: string, nullable: true, description: 联系电话}
+        contactEmail: {type: string, format: email, nullable: true, description: 联系邮箱}
+        submittedAt: {type: string, format: date-time, description: 提交审核时间}
+        reviewComment: {type: string, nullable: true, description: 审核意见}
     TenantCreationApiResponse:
       allOf:
         - {$ref: '#/components/schemas/ApiResponse'}