提交

lastleg-service/src/main/resources/db/lastleg.sql

@@ -137,6 +137,34 @@ CREATE TABLE IF NOT EXISTS ll_loading_order_status_history (
   KEY idx_ll_loading_history_customer_order(customer_id,order_id,created_at)
 ) ENGINE=InnoDB COMMENT='尾程订单状态变更历史';
 
+CREATE TABLE IF NOT EXISTS ll_order_fee (
+  id BIGINT NOT NULL COMMENT '费用明细主键',
+  customer_id VARCHAR(128) NOT NULL COMMENT '客户数据隔离键',
+  order_id BIGINT NOT NULL COMMENT '尾程订单ID',
+  fee_item VARCHAR(128) NOT NULL COMMENT '费用项目',
+  currency VARCHAR(3) NOT NULL COMMENT '币种代码',
+  amount DECIMAL(18,2) NOT NULL COMMENT '费用金额',
+  status VARCHAR(32) NOT NULL DEFAULT 'PENDING_REVIEW' COMMENT '费用状态：PENDING_REVIEW待审核、APPROVED审核通过、REJECTED已驳回',
+  supplier_description VARCHAR(500) NULL COMMENT '供应商或费用说明',
+  created_by VARCHAR(128) NOT NULL COMMENT '创建操作人',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
+  PRIMARY KEY(id),
+  KEY idx_ll_order_fee_customer_order(customer_id,order_id,created_at)
+) ENGINE=InnoDB COMMENT='尾程订单费用明细';
+
+CREATE TABLE IF NOT EXISTS ll_order_operation_log (
+  id BIGINT NOT NULL COMMENT '操作记录主键',
+  customer_id VARCHAR(128) NOT NULL COMMENT '客户数据隔离键',
+  order_id BIGINT NOT NULL COMMENT '尾程订单ID',
+  operation_node VARCHAR(64) NOT NULL COMMENT '操作节点',
+  operator_name VARCHAR(128) NOT NULL COMMENT '操作人名称',
+  result VARCHAR(500) NOT NULL COMMENT '处理结果',
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '操作时间',
+  PRIMARY KEY(id),
+  KEY idx_ll_order_operation_customer_order(customer_id,order_id,created_at)
+) ENGINE=InnoDB COMMENT='尾程订单操作记录';
+
 CREATE TABLE IF NOT EXISTS ll_event_conflict (
   id BIGINT NOT NULL COMMENT '冲突记录主键', event_id VARCHAR(128) NOT NULL COMMENT '冲突事件 ID',
   customer_id BIGINT NOT NULL COMMENT '租户 ID', conflict_type VARCHAR(64) NOT NULL COMMENT '冲突类型',

lastleg-service/src/main/resources/openapi/overseas-business-v1.yaml

@@ -138,6 +138,29 @@ paths:
         - { name: createdFrom, in: query, schema: { type: string, format: date-time } }
         - { name: createdTo, in: query, schema: { type: string, format: date-time } }
       responses: { '200': { description: 统一 ApiResponse 包装的尾程订单分页；列表行 destinationType 为 FBA 或 OVERSEAS } }
+  /api/platform/v1/last-leg/orders/{id}:
+    get:
+      summary: 查询尾程订单详情
+      description: 权限 platform:overseas-warehouse:last-mile-order:list；返回订单、货物、状态历史、费用明细和操作记录。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: integer, format: int64 } }
+      responses:
+        '200': { description: 统一 ApiResponse 包装的尾程订单详情 }
+        '404': { description: 尾程订单不存在或不属于查询客户 }
+  /api/platform/v1/last-leg/orders/{id}/fees:
+    post:
+      summary: 新增尾程订单费用
+      description: 权限 platform:overseas-warehouse:last-mile-order:edit；在订单客户范围内新增费用并记录操作人和处理结果。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: id, in: path, required: true, schema: { type: integer, format: int64 } }
+      requestBody:
+        required: true
+        content: { application/json: { schema: { $ref: '#/components/schemas/LastMileFeeCreate' } } }
+      responses:
+        '200': { description: 新增后的费用明细, content: { application/json: { schema: { $ref: '#/components/schemas/LastMileFeeApiResponse' } } } }
+        '404': { description: 尾程订单不存在或不属于操作客户 }
   /api/platform/v1/last-leg/dispatches:
     get:
       summary: 分页查询排车单
@@ -513,6 +536,37 @@ paths:
       responses: { '200': { description: 统一 ApiResponse 包装的换标单详情 }, '409': { description: 非法状态迁移或关联尾程单缺失 } }
 components:
   schemas:
+    LastMileFeeCreate:
+      type: object
+      required: [feeItem, currency, amount, status]
+      properties:
+        feeItem: { type: string, minLength: 1, maxLength: 128 }
+        currency: { type: string, pattern: '^[A-Z]{3}$', example: USD }
+        amount: { type: number, format: decimal, minimum: 0.01 }
+        status: { type: string, enum: [PENDING_REVIEW, APPROVED, REJECTED] }
+        supplierDescription: { type: string, maxLength: 500 }
+    LastMileFee:
+      type: object
+      required: [id, customerId, orderId, feeItem, currency, amount, status, createdBy, createdAt, updatedAt]
+      properties:
+        id: { type: integer, format: int64 }
+        customerId: { type: string }
+        orderId: { type: integer, format: int64 }
+        feeItem: { type: string }
+        currency: { type: string }
+        amount: { type: number, format: decimal }
+        status: { type: string }
+        supplierDescription: { type: string, nullable: true }
+        createdBy: { type: string }
+        createdAt: { type: string, format: date-time }
+        updatedAt: { type: string, format: date-time }
+    LastMileFeeApiResponse:
+      type: object
+      required: [code, message, data]
+      properties:
+        code: { type: string }
+        message: { type: string }
+        data: { $ref: '#/components/schemas/LastMileFee' }
     PdaWarehouseScan:
       type: object
       required: [code]