WuYongJie/CaiWuXiTong
1
0
Fork 0
Code Issues Pull Requests 5 Packages Projects Releases Wiki Activity
1,486 Commits 226 Branches 10 Tags
Commit Graph

19 Commits

Author SHA1 Message Date
limeng
7dd2d66935 fix(发货数据): 补拉改到每晚21:28并记录日志，过滤订单商品数量0占位行，超长文本按列宽截断 (#707) 
- 早上 7:28 的补拉在白天副本库高负载时频繁超时断开、未写入任何数据，改为每晚 21:28 拉最近 3 天；
  两次同步输出追加到 storage/logs/jst-sync-shipping.log，便于排查。
- 订单商品表中平台原始商品行(数量 0、金额 0)没有实际出库，聚水潭工作平台也不显示；
  包裹已有实发商品时不再写入，避免多出一个"条码"(实为平台商品编号)。
- 上游偶有超长值(如组合装商品ID 78 位)导致整批写入失败，写入前按 jst_oms_shipping 列宽截断。

> 开工时标题使用 `WIP: <任务名称>` 并先填写“任务占用与边界”。Codex 完成独立合并前自审后补齐其余内容并移除 `WIP:`。

## 任务占用与边界

- 任务名称：
- 实际开发者：
- 任务来源/团队分工：
- 目标结果：
- 预计修改路径：
- 将写入的公共契约（路由、Controller 方法、Repository、表/视图、`source_key`、`scope`、权限名、菜单键或共享组件）：
- 仅复用、明确不修改的公共契约：
- 数据源、表/视图和字段：
- 上游 `source_key` / `scope`：
- 权限名、菜单键或共享组件：
- 明确不修改的范围：

## 开工碰撞检查

- [ ] Codex 已执行 `scripts/codex-task-preflight.ps1`
- [ ] 已检查最新 `main` 和所有远程任务分支
- [ ] 已搜索主线既有页面、接口、Repository 和数据查询
- [ ] 已把“将写入”和“仅复用、不修改”的公共契约分开；仅复用项不作为单独阻断条件
- [ ] 未发现实际写入重叠；或已在下方写明相关分支、具体重叠项和协调结论

相关分支、重叠项与协调结论：

## 实际改动

- 完成内容：
- Codex 实际修改的文件：
- 新增或变更的公共契约：
- 与原计划的差异：

## 验证证据

- 正常流程：
- 空数据/错误输入/无权限场景：
- 受影响旧功能：
- 自动测试及结果：
- 实际页面、接口或只读业务查询结果：

## 风险检查

- [ ] 不涉及金额、权限、审批、数据库迁移、生产配置或数据修复
- [ ] 如涉及上述高风险内容，已在下方写明影响、回滚和所需授权
- [ ] 未提交 `.env`、密码、Token、私钥、真实财务数据、生产日志或构建产物
- [ ] 前端改动符合 `DESIGN.md`；无前端改动则写“不适用”

高风险影响、回滚和授权状态：

## 合并前复查

- [ ] 已重新拉取远程引用并用实际修改范围再次运行碰撞检查
- [ ] PR 不再是 `WIP:`，所有测试结果已经补齐
- [ ] Codex 已重新读取原始需求和验收标准，并逐文件审核 `origin/main...任务分支` 的完整 diff
- [ ] Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果
- [ ] 合并顺序不会覆盖其他未合并任务
- [ ] 已授权当前任务的 Codex 执行 Squash merge、验证 `main` 并清理任务分支
- [ ] 如涉及生产迁移、数据修复、删除、覆盖配置或部署，已另行取得对应高风险授权

Reviewed-on: #707
 2026-10-28 09:24:56 +08:00
limeng
87788d87ff fix(发货数据): 快递名称以出库单/发货明细当前值为准，发货数据视图仅兜底 
- 聚水潭换单、改快递公司后，出库单、发货明细、订单的快递公司都会更新(如 崔桥顺丰干配→常州德邦、德邦快递→申通E物流)，
  工作平台随之显示新值；发货数据视图的 expressName 却停在旧值。此前优先取视图，9 月 111 个包裹快递名称与工作平台不一致。
- 改为：快递名称取出库单/发货明细当前值，视图只在两者都没有时兜底；仓库仍按视图 wareHoursName。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014nvGZkg27YMEdhRy6EiUwf
 2026-10-19 11:56:56 +08:00
limeng
bcbb9e72af fix(发货数据): 每晚重拉最近 40 天，并清除上游已作废的出库/采购退货包裹 
- 聚水潭常在发货后数天到数周内换单/改快递公司(如崔桥顺丰干配→常州德邦、德邦→申通E物流)、作废采购退货出库；
  原先每天只重拉最近 3 天，上月数据停在旧值：9 月 111 个包裹快递名称与工作平台不一致，14 个已作废的采购退货单仍在。
- 01:28 定时同步改为最近 40 天(覆盖上月结算期)，07:28 仍补拉最近 3 天。
- 窗口重跑时，出库单兜底/采购退货出库包裹若本次完整扫描中已不存在(作废/换单)，直接删除；扫描为空时不删。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014nvGZkg27YMEdhRy6EiUwf
 2026-10-19 09:31:17 +08:00
limeng
9c63f36944 fix(发货数据): 无快递单号的自动发货仓旧包裹也按被取代清除 
- 10.11/10.12 剩余约 476 个省份空白包裹：凌晨同步时按自动发货仓入库、当时订单还没有快递单号；之后订单有了发货明细，
  改由发货明细来源键吐出，旧包裹因无单号未被识别为被取代而残留(重复且省份空白)。
- 窗口内未再出现的旧包裹，若为自动发货仓来源且该订单本次已有发货明细，或无单号但同一交易单号本次已由其它包裹吐出，视为被取代删除。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014nvGZkg27YMEdhRy6EiUwf
 2026-10-14 15:34:47 +08:00
limeng
f6497f5afc fix(发货数据): 重跑时清除被取代的兜底包裹，保留包裹也刷新省市区/快递/仓库 
- 凌晨同步时发货明细常未到齐，包裹先按自动发货仓/出库单兜底入库(无省份、无商品)；之后发货明细到齐换成发货明细来源键，
  旧兜底包裹因"上游未再出现"被保留，造成重复和空白省份(10 月重跑 2,226 个)。现在：旧包裹的快递单号已由本次其它包裹吐出时
  视为被取代并删除；无对应的仍保留待核对。
- 商品金额无法安全匹配(或新商品明细缺失)而保留的旧包裹(10 月 28,201 个)，此前整包不更新；现在商品与金额不动，
  省市区、快递名称、仓库、店铺、平台、交易单号、付款时间按本次上游刷新。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014nvGZkg27YMEdhRy6EiUwf
 2026-10-14 08:54:45 +08:00
limeng
7ecd5a59e6 fix(发货数据): 快递名称、仓库按发货数据视图取值，与工作平台一致 
- 9 月核对剩余 256 条快递名称、44 条仓库不一致；抽样 14/14 工作平台显示的就是发货数据视图
  (Jst_SendData_View_extension) 的 expressName / wareHoursName。视图有值时以视图为准，
  视图没有该出库单时保留出库单/发货明细推断的值。
- 发货数据视图、出库单头按 300 个出库单一批查询(原 800)，减少副本库超时导致整月重跑中断。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014nvGZkg27YMEdhRy6EiUwf
 2026-10-13 09:53:02 +08:00
limeng
d8dfb33437 fix(发货数据): 仓库按实际出库单发货仓、补入无需物流虚拟发货、作废单号识别换单 
- 仓库一律按实际出库单 wms_co_id 映射(从快递公司一致的明细行学习仓库名，样本>=3 且占比>=90% 才回填)，
  修正发货明细写总仓而实际由工厂代发仓出库(如 710099981090 千优代发仓)的情况。
- 快递名称为"无需物流"(补差/信誉/运费等虚拟发货，如 X00006)的包裹仓库统一为"简尚-自动发货仓"，与工作平台一致。
- 换单配对：快递明细单号只对应作废出库单时视为已换单，改用有效出库单的新单号(如 DPK366101313659 -> SF1549142274850)。
- 出库单兜底不再跳过"无需物流"的无单号出库单(信誉订单/补差价/运费专用等虚拟发货)，按工作平台口径补入自动发货仓、快递单号为空；
  9 月核对工作平台有、线上无的 565 条虚拟链接，抽查确认为此原因(出库单无单号被跳过)。
- 换单配对查询(logistic_id 无索引)副本库超时时跳过本页，不再中断整轮同步；结果返回 tracking_pairing_skipped_pages。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014nvGZkg27YMEdhry6eiuwf
 2026-10-12 09:58:05 +08:00
limeng
dcdea11f0f fix(发货数据): 快递公司/仓库按实际出库单取，同步命令内存上限调至 4G 
- 发货明细(jst_order_express_details)可能停在作废前的旧分配（如先分工厂代发仓、后改外采由总仓出库；或换单后仍是旧快递公司），
  工作平台按实际出库单显示。快递公司与出库单不一致或为空时改用出库单 logistics_company，
  仓库按出库单 wms_co_id 映射（从快递公司一致的明细行学习仓库名，扫描结束统一回填）。
- 9 月核对：快递名称不一致 434/331,612，仓库不一致 85，其中外采快递、线下快递、换单类为此原因。
- jushuitan:sync-shipping 内存上限 1536M -> 4096M：整月窗口重跑在扫描后段内存耗尽（退出码 255）。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014nvGZkg27YMEdhry6eiuwf
 2026-10-08 10:52:27 +08:00
limeng
471aa714e8 fix(发货数据): 以本地全量核对通过的版本替换 #282 的同步实现 
#282 的整合版在本地全量同步中发现问题，改用已与工作平台逐单核对通过的实现(保留 #283/#284 及 main 其它改动)：
- 订单元数据只缓存精简字段(状态仅存取消/拆分/合并，标签只存是否线上发货)，全表扫描后释放；
  #282 缓存完整标签会在全表扫描时内存超限导致同步中途退出
- 按规则排除的包裹(取消/拆分/合并/线上发货)清除本窗口旧记录
- 剩余 @ 前缀统一去掉(工作平台导出无 @)
- 自动发货仓虚拟/补差单：单号已被其它包裹实际输出时留空(对齐工作平台)
- 出库映射保留作废单但排在有效单之后；换单按出库单号顺序一对一配对
测试：同步单测相应调整(作废单排序、多候选配对)。
验证：本地清空 8.15-9.30 后全量同步 9.1-9.16，与工作平台对比两边共有包裹 195,555，带单号漏拉 1 单。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014nvGZkg27YMEdhry6eiuwf
 2026-10-07 16:33:23 +08:00
WuYongJie
a9da8d4447 修复发货镜像字段校准与合并列表耗时 (#283) 2026-10-07 14:08:20 +08:00
WuYongJie
6c054c7081 整合发货补漏与导出口径修复，保留主线同步保护 (#282) 2026-10-07 13:52:18 +08:00
limeng
e224cbebc3 fix: remove shipping sync order join timeout 2026-09-24 18:27:45 +08:00
limeng
896e3fefa7 重试发货同步的上游连接超时 (#272) 2026-09-24 16:24:59 +08:00
limeng
57346a270c 重连发货同步的短暂上游游标断线 (#269) 2026-09-24 15:36:07 +08:00
limeng
c3b6cd9313 修复历史发货代发仓扫描超时 (#265) 2026-09-24 14:42:28 +08:00
limeng
eecb2b1863 修复发货历史窗口安全回补与数量状态 (#263) 2026-09-24 13:30:09 +08:00
limeng
5555a3d5e0 fix: preload shipping outbound map by window 2026-09-24 10:13:48 +08:00
limeng
bee27aa2be fix: avoid shipping sync replica timeout 2026-09-24 09:56:58 +08:00
limeng
2017d6520b feat: add Jushuitan shipping data mirror 2026-09-23 18:29:15 +08:00