优化

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

@@ -44,7 +44,7 @@ paths:
       parameters:
         - {name: page, in: query, required: false, schema: {type: integer, minimum: 1, default: 1}}
         - {name: size, in: query, required: false, schema: {type: integer, minimum: 1, maximum: 200, default: 20}}
-        - {name: keyword, in: query, required: false, schema: {type: string}, description: 企业编码、名称、信用代码或联系人关键字}
+        - {name: keyword, in: query, required: false, schema: {type: string}, description: 客户名称关键字，不支持客户编号、信用代码或联系人搜索}
         - {name: status, in: query, required: false, schema: {type: string, enum: [PROFILE_REQUIRED, PENDING, ACTIVE, REJECTED, DISABLED]}}
       responses:
         '200':
@@ -740,6 +740,39 @@ paths:
             application/json:
               schema: {$ref: '#/components/schemas/RequiredQualificationPackageApiResponse'}
         '403': {$ref: '#/components/responses/Forbidden'}
+  /internal/iam/finance-customers:
+    get:
+      tags: [IAM Resources / IAM 资源]
+      summary: 提供财务客户主数据摘要
+      description: 仅供 Finance Service 调用；只返回正常/停用客户及财务账户所需的客户编号、名称和联系方式，不依赖财务表是否已有记录。
+      security: []
+      parameters:
+        - {$ref: '#/components/parameters/InternalServiceToken'}
+        - {name: page, in: query, required: false, schema: {type: integer, minimum: 1, default: 1}}
+        - {name: size, in: query, required: false, schema: {type: integer, minimum: 1, maximum: 200, default: 20}}
+        - {name: keyword, in: query, required: false, schema: {type: string}}
+        - {name: status, in: query, required: false, schema: {type: string, enum: [ACTIVE, DISABLED]}}
+        - {name: customerId, in: query, required: false, schema: {type: integer, format: int64, minimum: 1}}
+      responses:
+        '200':
+          description: 财务客户主数据分页摘要
+          content:
+            application/json:
+              schema:
+                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/FinanceCustomerSummary'}}
+                          page: {type: integer}
+                          size: {type: integer}
+                          total: {type: integer, format: int64}
+                          pages: {type: integer}
+        '403': {$ref: '#/components/responses/Forbidden'}
   /internal/exports/v1/CUSTOMER_LIST/batches:
     post:
       tags: [Internal Export Provider]
@@ -971,6 +1004,16 @@ components:
         internalRemark: {type: string, maxLength: 1000, description: 仅平台端可见}
         createdAt: {type: string, format: date-time, description: 入驻时间}
         approvedAt: {type: string, format: date-time, description: 审批通过时间}
+    FinanceCustomerSummary:
+      type: object
+      required: [id, tenantCode, tenantName, status]
+      properties:
+        id: {type: string, pattern: '^\d+$'}
+        tenantCode: {type: string}
+        tenantName: {type: string}
+        status: {type: string, enum: [ACTIVE, DISABLED]}
+        contactName: {type: string, nullable: true}
+        contactPhone: {type: string, nullable: true}
     TenantAddressListApiResponse:
       allOf:
         - {$ref: '#/components/schemas/ApiResponse'}