优化

2026-08-06 11:49:51 +08:00
parent a11e47fe3b
commit 7dd92f1c84
91 changed files with 6233 additions and 174 deletions
@@ -0,0 +1,45 @@
+# 平台公共仓库主数据
+
+## 范围
+
+- 正式脚本：`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，分别为义乌、东莞、洛杉矶、纽约。