优化

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

@@ -39,8 +39,8 @@ paths:
         '422': {$ref: '#/components/responses/UnprocessableEntity'}
     post:
       tags: [Platform Tenant / 平台租户]
-      summary: Register enterprise tenant / 创建企业租户
-      description: Create a pending enterprise tenant and review task. Platform identity is required. / 创建待审核企业租户及审核任务，要求平台端身份。
+      summary: Register enterprise tenant / 创建企业客户草稿
+      description: Create a `PROFILE_REQUIRED` enterprise draft only. Saving the customer does not create a review task. / 仅创建待完善企业客户草稿，保存客户不会创建审核单。
       requestBody:
         required: true
         content:
@@ -88,6 +88,19 @@ paths:
         '400': {$ref: '#/components/responses/BadRequest'}
         '403': {$ref: '#/components/responses/Forbidden'}
         '404': {$ref: '#/components/responses/NotFound'}
+  /api/platform/v1/iam/tenants/{tenantId}/submit-review:
+    parameters:
+      - {$ref: '#/components/parameters/TenantId'}
+    post:
+      tags: [Platform Tenant / 平台租户]
+      summary: 提交企业客户审核
+      description: 校验营业执照和法人身份证已上传后创建审核单，并把客户状态改为 `PENDING`；保存资料和上传文件均不会自动调用本接口。
+      responses:
+        '200': {$ref: '#/components/responses/TenantSuccess'}
+        '400': {$ref: '#/components/responses/BadRequest'}
+        '403': {$ref: '#/components/responses/Forbidden'}
+        '404': {$ref: '#/components/responses/NotFound'}
+        '409': {$ref: '#/components/responses/Conflict'}
   /api/platform/v1/iam/tenants/{tenantId}/addresses:
     parameters:
       - {$ref: '#/components/parameters/TenantId'}
@@ -674,7 +687,7 @@ components:
             data: {$ref: '#/components/schemas/InternalUserResponse'}
     TenantResponse:
       type: object
-      required: [id, tenantCode, tenantName, status]
+      required: [id, tenantCode, tenantName, status, servicePackage]
       properties:
         id: {type: string, pattern: '^\d+$', example: '190000000000000001'}
         tenantCode: {type: string}
@@ -686,6 +699,7 @@ components:
         contactPhone: {type: string}
         contactEmail: {type: string, format: email}
         contactWechat: {type: string, maxLength: 64}
+        servicePackage: {type: string, maxLength: 64}
         salesOwnerName: {type: string, maxLength: 64}
         paymentTermDays: {type: integer, minimum: 0, maximum: 365}
         enterpriseType: {type: string, maxLength: 64}
@@ -730,16 +744,16 @@ components:
       properties:
         id: {type: string, pattern: '^\d+$'}
         tenantId: {type: string, pattern: '^\d+$'}
-        qualificationType: {type: string}
+        qualificationType: {type: string, enum: [BUSINESS_LICENSE, LEGAL_PERSON_ID, FREIGHT_FORWARDER_CERTIFICATE, BANK_ACCOUNT_LICENSE]}
         certificateNo: {type: string}
         documentUrl: {type: string}
         validFrom: {type: string, format: date}
-        validTo: {type: string, format: date}
-        status: {type: string}
+        validTo: {type: string, format: date, nullable: true}
+        status: {type: string, enum: [PENDING, APPROVED, REJECTED]}
         reviewComment: {type: string}
     RegisterRequest:
       type: object
-      required: [tenantName, legalName, unifiedSocialCreditCode, contactName, contactPhone]
+      required: [tenantName, legalName, unifiedSocialCreditCode, contactName, contactPhone, servicePackage]
       properties:
         tenantName: {type: string, example: 深圳虫虫出海科技有限公司}
         legalName: {type: string, example: 张三}
@@ -748,6 +762,7 @@ components:
         contactPhone: {type: string, example: '13800138000'}
         contactEmail: {type: string, format: email, example: contact@example.com}
         contactWechat: {type: string, maxLength: 64}
+        servicePackage: {type: string, maxLength: 64, example: 基础版}
         salesOwnerName: {type: string, maxLength: 64}
         paymentTermDays: {type: integer, minimum: 0, maximum: 365}
         enterpriseType: {type: string, maxLength: 64}
@@ -758,7 +773,7 @@ components:
         internalRemark: {type: string, maxLength: 1000}
     UpdateProfileRequest:
       type: object
-      required: [tenantName, legalName, contactName, contactPhone]
+      required: [tenantName, legalName, contactName, contactPhone, servicePackage]
       properties:
         tenantName: {type: string}
         legalName: {type: string}
@@ -775,6 +790,7 @@ components:
         contactPhone: {type: string}
         contactEmail: {type: string, format: email}
         contactWechat: {type: string, maxLength: 64}
+        servicePackage: {type: string, maxLength: 64, example: 基础版}
         salesOwnerName: {type: string, maxLength: 64}
         paymentTermDays: {type: integer, minimum: 0, maximum: 365}
         enterpriseType: {type: string, maxLength: 64}