Merge remote-tracking branch 'origin/test' into dev

# Conflicts: # deploy/sql/头程数据库统一增量-MySQL8.sql # event-bridge-service/src/main/java/com/baiyue/eventbridge/metrics/EventBridgeMetrics.java # firstleg/src/main/resources/db/phase3-container-customs-schema.sql # order/src/main/resources/db/order.sql # scripts/db/incremental.sql
2026-09-02 17:56:20 +08:00
parent c5c80d5ab6 18c673811f
commit 2a0f942234
45 changed files with 1005 additions and 1063 deletions
@@ -0,0 +1,50 @@
+openapi: 3.0.3
+info: { title: Overseas Business Fee Source API, version: 1.0.0 }
+paths:
+  /api/platform/v1/last-leg/finance-fee-sources:
+    get:
+      summary: 查询海外业务费用来源当前版本
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { in: query, name: customerId, schema: { type: string } }
+        - { in: query, name: businessType, schema: { $ref: '#/components/schemas/BusinessType' } }
+        - { in: query, name: businessNo, schema: { type: string } }
+      responses: { '200': { description: 当前版本列表 } }
+    post:
+      summary: 创建海外业务费用来源草稿
+      description: 客户和业务编号必填；入仓ID、入仓码均按业务事实选填，不得为补字段伪造。
+      security: [{ bearerAuth: [] }]
+      parameters: [{ in: header, name: Idempotency-Key, required: true, schema: { type: string, maxLength: 128 } }]
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/SaveRequest' } } } }
+      responses: { '200': { description: 草稿费用来源 }, '400': { description: 业务归属或付款事实无效 } }
+  /api/platform/v1/last-leg/finance-fee-sources/{sourceFeeId}/{action}:
+    post:
+      summary: 提交、审核、调整或作废海外业务费用来源
+      description: 审核通过与作废均事务性写入Outbox，经Event Bridge可靠投递至独立Finance；action为submit、review、adjust、void。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { in: path, name: sourceFeeId, required: true, schema: { type: string } }
+        - { in: path, name: action, required: true, schema: { type: string, enum: [submit, review, adjust, void] } }
+      responses: { '200': { description: 当前费用来源版本 }, '409': { description: 状态、版本或幂等冲突 } }
+components:
+  schemas:
+    BusinessType: { type: string, enum: [OVERSEAS_INBOUND, OVERSEAS_PROCUREMENT, US_TRUCK, LOCAL_LOOSEBOARD, WAREHOUSE_SERVICE] }
+    SaveRequest:
+      type: object
+      required: [customerId, sourceType, businessType, businessNo, feeItemCode, feeItemName, direction, businessDate, currency, amount]
+      properties:
+        customerId: { type: string }
+        sourceType: { type: string, enum: [OVERSEAS_INBOUND_FEE, OVERSEAS_PROCUREMENT_FEE, OVERSEAS_TRUCK_FEE, OVERSEAS_LOOSEBOARD_FEE, OVERSEAS_WAREHOUSE_FEE] }
+        businessType: { $ref: '#/components/schemas/BusinessType' }
+        businessId: { type: string, nullable: true }
+        businessNo: { type: string, maxLength: 128 }
+        warehouseId: { type: string, nullable: true }
+        inboundId: { type: string, nullable: true }
+        inboundCode: { type: string, maxLength: 64, nullable: true }
+        feeItemCode: { type: string }
+        feeItemName: { type: string }
+        direction: { type: string, enum: [RECEIVABLE, PAYABLE] }
+        businessDate: { type: string, format: date }
+        currency: { type: string, enum: [CNY] }
+        amount: { type: number, format: decimal, exclusiveMinimum: 0 }
+  securitySchemes: { bearerAuth: { type: http, scheme: bearer, bearerFormat: JWT } }