优化

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

@@ -59,14 +59,14 @@ paths:
     post:
       tags: [Platform Tenant / 平台租户]
       summary: Register enterprise tenant / 创建企业客户草稿
-      description: Create a `PROFILE_REQUIRED` enterprise draft only. Saving the customer does not create a review task. / 仅创建待完善企业客户草稿，保存客户不会创建审核单。
+      description: Create a `PROFILE_REQUIRED` enterprise draft and its OWNER account, returning one-time credentials. Saving the customer does not create a review task. / 创建待完善企业客户草稿及 OWNER 账号并返回一次性凭据，保存客户不会创建审核单。
       requestBody:
         required: true
         content:
           application/json:
             schema: {$ref: '#/components/schemas/RegisterRequest'}
       responses:
-        '200': {$ref: '#/components/responses/TenantSuccess'}
+        '200': {$ref: '#/components/responses/TenantCreationSuccess'}
         '400': {$ref: '#/components/responses/BadRequest'}
         '403': {$ref: '#/components/responses/Forbidden'}
         '409': {$ref: '#/components/responses/Conflict'}
@@ -822,6 +822,7 @@ components:
   responses:
     Success: {description: Operation succeeded / 操作成功, content: {application/json: {schema: {$ref: '#/components/schemas/ApiResponse'}}}}
     TenantSuccess: {description: Enterprise tenant returned / 返回企业客户档案, content: {application/json: {schema: {$ref: '#/components/schemas/TenantApiResponse'}}}}
+    TenantCreationSuccess: {description: Enterprise tenant and one-time owner credentials returned / 返回企业客户及一次性管理员凭据, content: {application/json: {schema: {$ref: '#/components/schemas/TenantCreationApiResponse'}}}}
     BadRequest: {description: Invalid request / 请求参数错误, content: {application/json: {schema: {$ref: '#/components/schemas/ApiResponse'}}}}
     Unauthorized: {description: Authentication required / 需要登录, content: {application/json: {schema: {$ref: '#/components/schemas/ApiResponse'}}}}
     Forbidden: {description: Permission, customer scope or platform technical scope rejected / 权限、客户范围或平台技术作用域不匹配, content: {application/json: {schema: {$ref: '#/components/schemas/ApiResponse'}}}}
@@ -869,6 +870,19 @@ components:
         - type: object
           properties:
             data: {$ref: '#/components/schemas/TenantApprovalResponse'}
+    TenantCreationApiResponse:
+      allOf:
+        - {$ref: '#/components/schemas/ApiResponse'}
+        - type: object
+          properties:
+            data: {$ref: '#/components/schemas/TenantCreationResponse'}
+    TenantCreationResponse:
+      type: object
+      required: [tenant, administratorUsername, temporaryPassword]
+      properties:
+        tenant: {$ref: '#/components/schemas/TenantResponse'}
+        administratorUsername: {type: string, example: '13800138000'}
+        temporaryPassword: {type: string, format: password, description: 一次性初始密码，仅本次创建响应返回}
     TenantApprovalResponse:
       type: object
       required: [tenantId, administratorCreated]