feat: 增加档口入库码单表导入 (#231)

2026-08-15 08:47:22 +08:00
parent dd8a71850d
commit 5a9c0f0e6c
6 changed files with 733 additions and 2 deletions
@@ -1021,3 +1021,20 @@ CREATE UNIQUE INDEX idx_client_assignment_current
 批次记录用于进度、故障恢复和操作审计；具体模型决策证据仍只追加到
 `ai_spec_match_decisions`。Admin 重启把未完成明细改为 `interrupted` 并完成批次计数，已经
 成功写入的 `spec_mappings` 不回滚。
+
+## 17. `syb_inner_code_records` 档口入库码记录（MySQL v23）
+
+档口入库码使用一张业务表完成导入、匹配、回写和异常恢复。Excel 只是导入载体，系统
+不保存原文件、文件哈希，不再拆批次表或尝试记录表。
+
+- 业务键为 `(business_date, order_number, stall, spec_key)`；同一业务日期的
+  `inner_code` 另设唯一约束，防止一张标签被分配给两个商品。
+- `spec_raw` 永远保留 Excel 原文，`spec_key` 只用于确定性匹配；
+  `source_duplicate_count > 1` 表示同一文件存在重复业务组，匹配时整组跳过。
+- `stock_id/detail_id` 和 `syb_*`、`purchase_*`、`remote_inner_code` 保存最近一次远端
+  规划快照，不替代 `syb_orders`，也不修改采购数据。
+- 状态固定为 `pending/ready/applying/updated/already_filled/skipped/failed/needs_check`。
+  重复导入可以重置尚未完成的记录，但不得覆盖 `updated`、`already_filled`、`applying`
+  或 `needs_check` 的远端结果和审计状态。
+- `created_by_user_id` 记录首次导入账号，`applied_by_user_id` 记录实际回写账号；时间字段
+  使用 UTC ISO 8601。用户只停用不物理删除，因此外键不会阻塞账号生命周期。