4.5 KiB
海外费用与仓租数据库定义汇总
本次功能的数据库定义已统一到下面两份 SQL，五份重复版本脚本和两份专项汇总 SQL 已移除。仅整理文件，未连接数据库、执行 SQL 或部署。
两个统一入口
| 文件 | 相关数据库 | 本次内容 |
|---|---|---|
| 头程数据库统一增量-MySQL8.sql | baiyue_iam |
海外费用管理菜单及默认平台管理员授权；保留既有财务编辑、审核按钮和授权 |
| 海外区域统一增量-MySQL8.sql | baiyue_lastleg |
资金与仓租四表、费用关联及换标快照、审核人名称、采购退款请求幂等字段与唯一索引 |
两份文件虽然名称包含“增量”，仍只用于对应区域的空库初始化。新增列、索引和约束直接维护在最终 CREATE TABLE 中，菜单及授权使用初始化种子；不追加存量改造、权限版本回填或动态迁移段。目标 schema 必须为空，按文件原有初始化流程执行；不能向已有业务库重放。
已有库只按实际缺项执行定向结构补齐，不能把删除重复文件理解为已有库已完成升级。指定 TEST 的最小执行集合如下；文件准备不代表获得执行授权或已部署。
| 顺序 | 文件 | 允许的变更与核对结果 |
|---|---|---|
| 1 | 表与审核人字段补齐 | 只补 ll_storage_rent_inbound、ll_finance_fee_source.reviewer_name；已存在且匹配时跳过，同名异构则停止；成功回查表结构、字段并输出 TABLE_COLUMN_READY |
| 2 | 免费仓租定向修复 | 仅自动应收仓租允许原币/结算双零与空汇率；保留其他费用正额及有效汇率约束，保留已有汇率精度与数值默认值；最终核对 SHOW CREATE TABLE 中金额、汇率两项 CHECK 和汇率可空性 |
两步均固定 baiyue_lastleg，使用独立连接、支持 DELIMITER 的客户端，禁止遇错继续；不执行业务 DML、不补历史计租记录、不变更余额、汇率配置或权限。DDL 隐式提交，不能宣称整体可回滚；失败保留错误并只读复查，已完成项不删除重建。两步是已核缺项的补齐方案，不是任意版本升级工具；重新执行前仍需核对目标实例与结构。
海外表和字段
| 类型 | 表 / 字段 | 用途 |
|---|---|---|
| 新表 | ll_finance_fee_funding |
人工费用冻结、审核扣款、释放及财务流水引用 |
| 新表 | ll_storage_rent_lot |
实际入库计租原批次、数量及入库时间 |
| 新表 | ll_storage_rent_inbound |
头程每次实收凭证去重，关联同单同仓计租批次 |
| 新表 | ll_storage_rent_share |
库存与原计租批次份额关联，保留原库龄 |
| 新表 | ll_storage_rent_preparation |
出库计租快照、汇率、资金预占及实际出库记录 |
| 可空字段 | ll_destuff_pallet_cost_allocation.fee_source_id |
BIGINT NULL，允许人工审核后关联海外费用来源 |
| 字段 | ll_return_sku_conversion.storage_rent_shares_json |
LONGTEXT NULL，退货 SKU 换标的原仓租份额快照 |
| 字段 | ll_finance_fee_source.reviewer_name |
VARCHAR(255) NULL，审核人名称快照 |
| 字段 | ll_overseas_procurement_fee.idempotency_key |
VARCHAR(128) NULL，采购退款请求幂等键 |
| 唯一索引 | uk_ll_procurement_refund_request(order_id,purpose,idempotency_key) |
同一采购订单、用途和退款请求去重 |
国内菜单和权限
海外业务 → 海外费用管理，菜单 ID 5117200、权限 platform:overseas-fee:list、路由 /overseas-business/fees；默认仅授予 PLATFORM_ADMIN。编辑和审核分别复用 platform:finance:fee-source:edit 与 platform:finance:fee-source:review，列表权限不包含写操作。国内基线已包含两项既有按钮及管理员授权。
已有库的 费用写权限修复 是单独的定向补丁，继续保留原适用条件和授权边界，不是结构升级或菜单初始化入口。其他独立修复脚本与历史迁移不在本次清理范围。
费用项目继续使用 Firstleg 现有目录及 FEE_TYPE_077 / 仓储费，不重复插入项目、不批量覆盖客户专价、不回填历史仓租或费用、不修改钱包余额。
配套服务、页面、配置及验收边界见 首版发布验收。