线下档口提供的 Excel 中包含日期、订单号、档口及货号、颜色尺码和档口入库码。目前回写流程位于独立 Python 项目，Admin 尚无可追踪、可恢复的操作入口。用户已确认该能力不能放在顺运宝模块内，需要在“客户端列表”之后增加独立一级 Tab“档口入库码”。
在 Admin 内完成最小闭环：导入 Excel → 形成单表记录 → 匹配本地顺运宝货运单商品 → 操作员确认 → 回写档口入库码到顺运宝商品明细的快递单号位置，并能查看每行结果和异常。
syb_orders
独立“档口入库码”Tab 位于“客户端列表”之后，刷新和切换页面行为与其他 Admin 模块一致。
合法 Excel 可导入单表，重复业务键幂等更新，临时文件不会留存。
只对唯一且满足安全条件的顺运宝商品生成可回写结果，歧义和不满���条件的记录有明确原因。
���������户能选择可回写记���并确认���逐条看到成功、失败或需核对结果。
回写前重新核验、回写后再次读取验证，未知结果不会自动重复写入。
固定 Go 1.23.0 的接口和页面自动化测试通过；MySQL 8.4 _test 首次建库、重复迁移和 v22 升级待执行。
_test
#235 Admin：档口入库码支持勾选部分记录匹配（已实现，待验收）
#236 Admin：档口入库码匹配在会话过期时自动登录（已实现，待验收）
档口入库码匹配不再依赖本地 syb_orders。对勾选记录的货运单号去重后，���用顺���宝 t_stock.allcode 直接查询货运单 ID，再读取最新商品明细并执行现有确定性匹配和安全门禁。本修正覆盖此前“先匹配本地顺运宝货运单”的方案描述；远端查询结果不写入 SYB 数据模块，也不受店铺入库过滤影响。
t_stock.allcode
回写提交不再受 20 条选择上限约束；选中记录在现有业务表中进入同一后台批次，页面立即返回。Admin 后台仍按最多 20 条一组读取并逐条执行现有“写前核验、最多一次写入、写后核对”门禁。页面通过现有业务表聚合显示批次进度。进程异常时，尚未开始的排队记录恢复为可回写，已经进入远端写入阶段的记录转为待人工核对；不新增批次表，也不在重启后自动重放真实远端写入。
真实操作 HAR 证明顺运宝不能在一个 innerExpCode 中使用逗号连接多个单件码。#240 的本地业务键聚合继续保留，但远端“完整聚合字符串只写一次”的方案由 #250 替代：原商���明细承载一件，其���每���创建数量 1、价格 0 的占位明细并分别写码。执行过程继续使用现有单表，在表内增加 JSON 检查点；远端创建或写码结果未知时只允许重新读取核对，不自动重发。
innerExpCode
Excel“原始 SKU”作为高优先级、可审计的确定性匹配证据：订单和规格候选确定后，原始 SKU 与顺运宝 sku 或 ariationSku 唯一精确相等时允许命中；没有唯一命中时继续使用现有档口及货号规则。两套证据指向不同候选或出现重复候选时必须停止自动选择。业务键、页面档口字段、只读匹配和远端安全门禁保持不变。
当 Excel 同业务键聚合出多个单件码，而顺运宝已经以多条数量 1 的相同商品明细表达这些件数时，不再一律按“原始 SKU 候选重复”阻断。只有候选数量、总件数���单件码数完全一致，且全部候选的规格、原始 SKU/档口身份、安全状态一致时，才按稳定明细 ID 与 Excel 码顺序形成逐件规划；规划必须持久化并在写前复读全部明细。其他重复候选仍保持保守阻断，未知结果不自动重试。
状态：MVP 已实现，待用户验收。 #231–#234 均已实现并归档；固定 Go 1.23.0 build/test/vet 全部通过。 没有执行生产 v23 迁移、商业 Excel 导入或真实顺运宝写入。验收/部署前需先在 MySQL 8.4 _test 验证 v22→v23，再由操作员使用测试记录确认真实远端流程。
No dependencies set.
The note is not visible to the blocked user.
背景
线下档口提供的 Excel 中包含日期、订单号、档口及货号、颜色尺码和档口入库码。目前回写流程位于独立 Python 项目，Admin 尚无可追踪、可恢复的操作入口。用户已确认该能力不能放在顺运宝模块内，需要在“客户端列表”之后增加独立一级 Tab“档口入库码”。
目标
在 Admin 内完成最小闭环：导入 Excel → 形成单表记录 → 匹配本地顺运宝货运单商品 → 操作员确认 → 回写档口入库码到顺运宝商品明细的快递单号位置，并能查看每行结果和异常。
非目标
已确认总体方案
syb_orders找到货运单和商品标识，再批量获取顺运宝最新详情；仅允许匹配采购平台和采购单号均为空的目标。歧义记录标记为需人工处理，不猜测。阶段与单元任务
阶段 1：原型确认
阶段 2：数据导入与确定性匹配
阶段 3：安全回写与集成验收
依赖、风险与回退
MVP 验收标准
独立“档口入库码”Tab 位于“客户端列表”之后，刷新和切换页面行为与其他 Admin 模块一致。
合法 Excel 可导入单表，重复业务键幂等更新，临时文件不会留存。
只对唯一且满足安全条件的顺运宝商品生成可回写结果，歧义和不满���条件的记录有明确原因。
���������户能选择可回写记���并确认���逐条看到成功、失败或需核对结果。
回写前重新核验、回写后再次读取验证，未知结果不会自动重复写入。
固定 Go 1.23.0 的接口和页面自动化测试通过；MySQL 8.4
_test首次建库、重复迁移和 v22 升级待执行。#235 Admin：档口入库码支持勾选部分记录匹配（已实现，待验收）
#236 Admin：档口入库码匹配在会话过期时自动登录（已实现，待验收）
阶段 4：导入日期与软删除修复（2026-08-15）
阶段 5：工具栏可用性优化（2026-08-15）
阶段 6：多件商品入库码聚合回写（2026-08-15）
阶段 7：远端货运单查询修正（2026-08-15）
已确认方案修正
档口入库码匹配不再依赖本地
syb_orders。对勾选记录的货运单号去重后，���用顺���宝t_stock.allcode直接查询货运单 ID，再读取最新商品明细并执行现有确定性匹配和安全门禁。本修正覆盖此前“先匹配本地顺运宝货运单”的方案描述；远端查询结果不写入 SYB 数据模块，也不受店铺入库过滤影响。阶段 8：后台批量安全回写（2026-08-15）
已确认方案补充
回写提交不再受 20 条选择上限约束；选中记录在现有业务表中进入同一后台批次，页面立即返回。Admin 后台仍按最多 20 条一组读取并逐条执行现有“写前核验、最多一次写入、写后核对”门禁。页面通过现有业务表聚合显示批次进度。进程异常时，尚未开始的排队记录恢复为可回写，已经进入远端写入阶段的记录转为待人工核对；不新增批次表，也不在重启后自动重放真实远端写入。
阶段 9：多件入库码按件分明细回写修正（2026-08-17）
已确认方案修正
真实操作 HAR 证明顺运宝不能在一个
innerExpCode中使用逗号连接多个单件码。#240 的本地业务键聚合继续保留，但远端“完整聚合字符串只写一次”的方案由 #250 替代：原商���明细承载一件，其���每���创建数量 1、价格 0 的占位明细并分别写码。执行过程继续使用现有单表，在表内增加 JSON 检查点；远端创建或写码结果未知时只允许重新读取核对，不自动重发。阶段 10：原始 SKU 确定性匹配兼容（2026-08-17）
已确认方案补充
Excel“原始 SKU”作为高优先级、可审计的确定性匹配证据：订单和规格候选确定后，原始 SKU 与顺运宝 sku 或 ariationSku 唯一精确相等时允许命中；没有唯一命中时继续使用现有档口及货号规则。两套证据指向不同候选或出现重复候选时必须停止自动选择。业务键、页面档口字段、只读匹配和远端安全门禁保持不变。
阶段 11：写码参数 Integer 溢出修复（2026-08-19）
阶段 12：多个现成相同明细逐件匹配兼容（2026-08-22）
���确���方案补充
当 Excel 同业务键聚合出多个单件码，而顺运宝已经以多条数量 1 的相同商品明细表达这些件数时，不再一律按“原始 SKU 候选重复”阻断。只有候选数量、总件数���单件码数完全一致，且全部候选的规格、原始 SKU/档口身份、安全状态一致时，才按稳定明细 ID 与 Excel 码顺序形成逐件规划；规划必须持久化并在写前复读全部明细。其他重复候选仍保持保守阻断，未知结果不自动重试。
2026-08-22 生产发布
状态：MVP 已实现，待用户验收。
#231–#234 均已实现并归档；固定 Go 1.23.0 build/test/vet 全部通过。
没有执行生产 v23 迁移、商业 Excel 导入或真实顺运宝写入。验收/部署前需先在 MySQL 8.4
_test验证 v22→v23，再由操作员使用测试记录确认真实远端流程。