fix: support manual FBA quote fallback

firstleg/src/main/resources/db/phase2-inbound-schema.sql

@@ -665,8 +665,8 @@ CREATE TABLE IF NOT EXISTS fl_inbound_fee (
   fee_version INT UNSIGNED NOT NULL DEFAULT 1 COMMENT '费用快照版本',
   charge_rule_id BIGINT UNSIGNED NULL COMMENT '历史客户计费规则ID；渠道价格可为空',
   charge_rule_version INT UNSIGNED NULL COMMENT '历史客户规则版本快照',
-  carrier_rate_id BIGINT UNSIGNED NOT NULL COMMENT '船司FBA价格ID',
-  carrier_rate_version INT UNSIGNED NOT NULL COMMENT '船司价格版本快照',
+  carrier_rate_id BIGINT UNSIGNED NULL COMMENT '船司FBA价格ID；人工报价为空',
+  carrier_rate_version INT UNSIGNED NULL COMMENT '船司价格版本快照；人工报价为空',
   price_book_version_id BIGINT UNSIGNED NULL COMMENT '整表价格版本ID快照',
   rule_code VARCHAR(50) NULL COMMENT '历史客户规则编码快照',
   customer_id BIGINT UNSIGNED NULL COMMENT '可选业务客户快照；平台公共渠道计费不依赖该字段',
@@ -688,7 +688,7 @@ CREATE TABLE IF NOT EXISTS fl_inbound_fee (
   destination_warehouse_id BIGINT UNSIGNED NULL COMMENT '海外仓或FBA目的仓ID快照',
   destination_name VARCHAR(128) NULL COMMENT '目的仓名称快照',
   destination_code VARCHAR(32) NULL COMMENT 'FBA仓编码快照；海外仓可为空',
-  rate_effective_from DATETIME(3) NOT NULL COMMENT '价格生效开始快照',
+  rate_effective_from DATETIME(3) NULL COMMENT '价格生效开始快照；人工报价为空',
   rate_effective_to DATETIME(3) NULL COMMENT '价格生效结束快照',
   charge_mode VARCHAR(16) NULL COMMENT '计费口径：KG或CBM',
   conversion_factor DECIMAL(18,6) NULL COMMENT '历史客户规则使用的换算系数快照',
@@ -726,6 +726,11 @@ CREATE TABLE IF NOT EXISTS fl_inbound_fee (
   CONSTRAINT fk_fee_carrier_rate FOREIGN KEY (carrier_rate_id) REFERENCES fl_carrier_fba_rate (id)
 ) ENGINE=InnoDB COMMENT='入库头程费用计算和确认快照';
 
+ALTER TABLE fl_inbound_fee
+  MODIFY COLUMN carrier_rate_id BIGINT UNSIGNED NULL COMMENT '船司FBA价格ID；人工报价为空',
+  MODIFY COLUMN carrier_rate_version INT UNSIGNED NULL COMMENT '船司价格版本快照；人工报价为空',
+  MODIFY COLUMN rate_effective_from DATETIME(3) NULL COMMENT '价格生效开始快照；人工报价为空';
+
 SET @fee_baseline_quantity_sql = IF(
   EXISTS(SELECT 1 FROM information_schema.columns WHERE table_schema=DATABASE()
     AND table_name='fl_inbound_fee' AND column_name='baseline_chargeable_quantity'),

firstleg/src/main/resources/openapi/fba-pricing-v1.yaml

@@ -154,6 +154,13 @@ paths:
       parameters: [{$ref: '#/components/parameters/TenantId'}, {$ref: '#/components/parameters/InboundId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody: {content: {application/json: {schema: {$ref: '#/components/schemas/CalculateRequest'}}}}
       responses: {'200': {description: 成功或业务失败, content: {application/json: {schema: {$ref: '#/components/schemas/FeeSnapshotApiResponse'}}}}, '403': {description: 无权限}}
+  /api/platform/v1/inbounds/{inboundId}/fees/manual-quote:
+    post:
+      summary: FBA价格未命中时人工确定头程单价
+      description: 仅FBA且价格查询返回未命中时可用；按客户计费方式与选定测量重量、体积计算计费量，附加费为零。生成正式头程费用快照，后续复用确认与发送；需要 firstleg:inbound:confirm-send-fee 权限。
+      parameters: [{$ref: '#/components/parameters/TenantId'}, {$ref: '#/components/parameters/InboundId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
+      requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/ManualQuoteRequest'}}}}
+      responses: {'200': {description: 成功或业务失败, content: {application/json: {schema: {$ref: '#/components/schemas/FeeSnapshotApiResponse'}}}}, '403': {description: 无权限}}
   /api/platform/v1/inbounds/{inboundId}/fees/confirm:
     post:
       summary: 确认最新费用快照
@@ -488,6 +495,14 @@ components:
         additionalAmount: {type: number, minimum: 0, multipleOf: 0.01}
         reason: {type: string, minLength: 1, maxLength: 500}
         toleranceConfirmed: {type: boolean, enum: [true], description: 前端展示上下界并由操作员二次确认后固定传true；服务端仍会重新校验范围与版本}
+    ManualQuoteRequest:
+      type: object
+      required: [selectedWeightKg, selectedVolumeCbm, unitPrice, reason]
+      properties:
+        selectedWeightKg: {type: number, exclusiveMinimum: true, minimum: 0}
+        selectedVolumeCbm: {type: number, exclusiveMinimum: true, minimum: 0}
+        unitPrice: {type: number, exclusiveMinimum: true, minimum: 0}
+        reason: {type: string, minLength: 2, maxLength: 500}
     CalculateRequest:
       type: object
       properties: