Files
baiyue-firstleg/warehouse/src/main/resources/db/warehouse-public-master-data.md
T
2026-08-06 11:49:51 +08:00

2.6 KiB

平台公共仓库主数据

范围

  • 正式脚本:warehouse-public-master-data.sql。
  • 清洗通过清单:master-data/fba-public-addresses.accepted.csv。
  • 拒绝清单:master-data/fba-public-addresses.rejected.csv。
  • 四个固定仓清单:master-data/platform-fixed-warehouses.csv。

本脚本写平台公共作用域 tenant_id=0 的四个固定作业仓和 FBA 地址主数据,不写演示仓,不写 Admin 代码。当前内容已内联到 deploy/sql/头程数据库统一增量-MySQL8.sql,测试环境应执行固定入口写入正式主数据。

清洗规则

  • 读取 C:\Users\BY-OY\Downloads\FBA地址表.xls,原始文件只读。
  • 对核心字段去首尾空格。
  • FBA 编码转大写,接受 ^[A-Z0-9]{3,5}$。
  • 邮编按文本保存,保留 31216-6427 这类后缀。
  • 城市、州、详细地址、邮编任一缺失则拒绝。
  • 带 UPS、FEDEX、WALMART、一件代发、私人仓、纽约仓、洛杉矶仓、海外仓打托 等非 FBA 业务节点语义的记录拒绝。
  • 多时区州必须按城市映射时区;无法可靠判断时列入拒绝清单的 timezone_pending_confirmation,不使用州级默认值。
  • 数据库存储固定 UTC 偏移量(如 UTC+8、UTC-8),当前仅作为维护和展示字段使用。

固定仓规则

  • 国内固定仓:义乌、东莞,时区固定 UTC+8。
  • 海外固定仓:洛杉矶、纽约,分别使用 UTC-8、UTC-5。
  • 地址按通用占位格式写入,后续运营维护真实地址后,重复执行脚本不会把地址覆盖回占位文本。
  • 固定仓本轮不批量创建 wh_service_capability,避免在真实作业规则确认前扩大业务可操作范围。

写入语义

  • 新环境使用稳定 ID 区间:FBA 仓库 193000000000000001+、FBA 地址 193000000000100001+,固定仓库 193000000000200001+、固定仓地址 193000000000300001+。
  • 已有环境同编码仓库存在时,通过 tenant_id=0 + warehouse_code + deleted=0 解析实际 warehouse_id 后写地址。
  • 重复执行不会把停用仓库重新启用。
  • 重复执行不会覆盖运营维护的联系人、电话、邮箱、备注。
  • FBA 地址不创建 RECEIVING、STORAGE、PICK_PACK、RETURN 等平台作业能力。
  • 如果稳定种子 ID 已被其他数据占用,或同编码存在已删除仓库,脚本会 SIGNAL 终止,交由人工确认。

当前结果

  • Excel 数据行:306。
  • 接受:252。
  • 拒绝:54。
  • 时区待确认:1,且该行同时存在无效编码和异常城市文本。
  • 固定仓:4,分别为义乌、东莞、洛杉矶、纽约。