# 232 Admin：档口入库码确定性匹配与顺运宝回写规划

- 类型：需求
- 父级大工单：#14
- 所属 MVP / 版本：#224
- 状态：已完成
- 日期：2026-08-15
- Gitea 工单：<http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/232>

## 背景与目标

把已导入的线下标签安全定位到唯一顺运宝货运单商品，生成只读回写计划；歧义或不满足
安全条件时必须跳过，不能猜测。

## 最终方案

- 从本地 `syb_orders.syb_data` 解析 stock ID，同一订单没有 stock 时失败、存在多个 stock
  时跳过；有效 stock 每 100 个批量读取一次顺运宝最新详情。
- 先匹配 `productSpec` 原文，再用与参考 Python 一致的标准化键；档口存在时必须匹配
  sku、variationSku 或规格中的档口/货号，远端没有档口身份时才允许唯一规格兜底。
- 只使用采购平台和采购单号都为空的候选；Excel 重复组、空规格、候选歧义、档口不符和
  同一远端 detail 二次占用均不会变成可回写。
- 全部远端读取成功并验证完整后，才在一个数据库事务保存规划；没有调用删除或写入接口。

## 改了哪些

- `admin/repository/inner_code.go`：增加可规划记录、本地 SYB 快照查询和规划原子保存。
- `admin/service/inner_code_match.go`：增加 stock 解析、批量只读查询、规则匹配和状态统计。
- `admin/service/inner_code_match_test.go`：覆盖精确/标准化、档口、重复、采购门禁、歧义和占用。

## 验收结果

| 验收标准 | 结果 |
|---|---|
| 精确或标准化规格与档口唯一时生成可回写计划 | 通过 |
| 远端已是目标码时标记已存在 | 通过 |
| 重复、空规格、档口不符、歧义和采购字段非空均阻断 | 通过 |
| 同一远端 detail 不会被两条记录占用 | 通过 |
| 规划阶段只有详情读取，没有远端写请求 | 通过 |

## 测试

- 执行的命令：`go test ./service ./repository -run InnerCode -count=1`；
  `go test ./... -count=1`；`go vet ./...`
- 结果：全部通过。
- **没验证到的部分**：没有连接真实顺运宝验证线上响应字段；远端详情使用结构化测试数据。

## 相关提交

- `82ab80d` feat: 规划档口入库码确定性匹配 (#232)