378 Commits

Author SHA1 Message Date
liufumingren
4edfd951c5 fix(print): 视频号面单自定义区最多保留 8 行
- 新增 SPH_CUSTOM_INFO_MAX_LINES / SPH_CUSTOM_INFO_LINE_BREAK 常量与
  truncateSphCustomInfoLines helper:视频号面单自定义区仅可容纳 8 行文本,
  第 9 行起整体舍弃(含首行头部与子单号行,空行同样计入行数)
- applySphExpressFieldMapping 在合并子单号行、头部行、商品明细行与额外自定义行
  后统一截断,避免客户端溢出错版
2026-09-15 16:19:04 +08:00
liufumingren
df641257cc fix(wave): 波次闭环判空二次确认,避免瞬时空表误终结波次
- wave_batch_closure.js 新增判空二次确认:同一波次需连续两轮(间隔不小于
  confirmMinIntervalMs,默认 30s)都被判定为空才允许终结,确认状态写 Redis
  (TTL 1h);状态缓存不可用或读取异常时本轮不终结任何波次(宁可漏关、不可误关)
- 规避批量解波/订单迁移进行中造成的瞬时空表误判(2026-09-12 生产事故)
- closed_count 改为 UPDATE 实际影响行数,新增 empty_count / confirmed_count /
  pending_confirm_count 等统计与日志(波次列表超长截断)
- sync_finished_wave_batch.js 调度日志同步输出 empty_count / pending_confirm_count
- systemMethods/order/wave.js 解波 UPDATE 增加 wave_status < 3 守卫,避免覆盖
  自动终结(5)及已进入拣货及后续环节的波次状态
2026-09-15 16:18:58 +08:00
liufumingren
933a1ae341 fix(workbench): 打包任务结束统一复位摄像头 OSD 为「无任务」
- workbench.js 新增 OSD_IDLE_TEXT / OSD_CACHE_KEY_PREFIX / OSD_CACHE_TTL_SECONDS
  常量与 _resetPackOsd:回写 Redis osd_{workbenchId} 为「无任务」并逐台摄像头
  下发,内部捕获全部异常、永不 reject,失败仅告警不影响打包主流程
- 覆盖三条结束路径:_finishPack 手动结束、_packOrder 关闭上一个未结束任务、
  packTaskAutoFinish 定时自动结束;_packOrder 场景下先等 OSD 复位完成再串行
  下发新任务文字,避免复位覆盖新任务
- _packOrder 的 OSD 缓存写入与逐台下发整理为单个异步任务,保持不阻塞主流程
- pack_task_auto_finish.js 扫描补 workbench_id 并调用 _resetPackOsd,
  schedule/auto_finish_pack_task.js 注释同步
2026-09-15 16:18:51 +08:00
liufumingren
990fcf1314 feat(storage): 新增维护库存效期接口 storage.inventory.updateExpiry
- systems/storage/inventory.js 新增 updateExpiry:校验 storage_id 为正整数、两个
  日期至少传一个、当前仓库上下文(ctx.user.store_id);单事务 + 行锁
  (SELECT ... FOR UPDATE)按 id + warehouse_id + is_enabled=1 + delete_at IS NULL
  定位库存记录,跨仓库按 404 处理
- 新增模块级 helper parseStorageDateInput:undefined 视为未传、null/空串清空,
  YYYY-MM-DD / YYYY/MM/DD / YYYY-MM-DD HH:mm:ss / ISO / Date 统一规范化为
  YYYY-MM-DD 并校验日期真实存在,其它判非法
- 合并后(未传字段取库内现值)生产日期不能晚于到期日期;两值均与库内一致返回
  changed=false,不写库、不记日志
- 成功路径写业务操作日志(operation_code=STORAGE_UPDATE_EXPIRY,记维护前后两个
  日期与 storage/space/stock/batch 快照)
- systemMethods/storage/inventory.js 新增方法层包装(透传 code/message/data);
  businessDict 新增 STORAGE_UPDATE_EXPIRY 操作码
2026-09-15 16:18:39 +08:00
liufumingren
a15c877f04 fix(order): API 渠道订单同步改为先回传确认、成功后再扣减库存
- 删除 notifyApiDeliveryOrderConfirmsInternal(原「同步完成后 fire-and-forget
  逐单回调、失败仅 warn」),新增 processApiOrderInternal 在同一个分发循环内逐单
  处理:组装 deliveryorder.confirm 报文 → 解析发送用 appKey → sendByAppKey
  (最多 4 次尝试)→ 回调成功才扣减库存并置 sync_status='fin'
- 新增 markApiSyncFailedInternal:回调失败/异常、报文组装配不上货主编码、
  解析不到 appKey 等一律置 sync_status='error' + 待处理异常,不扣减库存、不置
  fin,订单可重新派发(分发前过滤仅跳过 fin)
- 解析不到 appKey 的订单不再静默跳过,改为按失败处理
- 同步 docs/openapi-callback-events.md、methods/openapi_callback.json 与
  methods/changes/openapi_callback.json
2026-09-15 16:18:32 +08:00
liufumingren
4f4128f337 fix(returnUnpack): 批量转入退件登记入参改为运单表主键 ids
- 入参由 waybill_codes(运单号)改为 ids(wms_order_express.id,单个数值或数组):Number 归一化 + 过滤非正整数 + 去重,上限 200
- 反查改为一次批量查询 id IN (ids) + warehouse_id,未命中(不存在或非本仓库)计入 failed;单条失败不阻断主流程
- _transferOneWaybill 改为接收批量反查后的运单行;运单号为空时报「运单号为空,无法转入退件登记」(拆包单 waybill_code 必填)
- 出参:success 项新增 waybill_id;failed 项为 waybill_id / waybill_code(运单命中时,否则 null)/ reason
- 回归:test/return_unpack_transfer_regression.test.js 76/76 通过(含 ids 边界、他仓隔离、运单号为空等新口径)
2026-09-15 16:14:46 +08:00
liufumingren
a59793daf2 perf(order): 订单分表补列表排序索引,修复配送列表 2 秒慢查询
原因:生产 wms_order_delivery_1000028_dispatch(59.4 万行 / data 1.13GB)没有任何
索引覆盖列表接口的固定形态

  WHERE warehouse_id = ? [AND dispatch_lane = ?] ORDER BY updated_at DESC, id DESC LIMIT 20

导致主查询全表扫 + filesort(实测 1.9s);与之并行执行的同条件 COUNT(*) 因
dispatch_lane 不在索引中需逐行回表(实测 1.5s),单请求合计约 2 秒。

新增 order_delivery_table_schema.buildListSortIndexes():

- current / history / outsourced:(warehouse_id, updated_at, id) 与 (warehouse_id, delivery_time, id)
  (updated_at 为前端实际排序字段,delivery_time 为 deliveryOrder 模块默认排序字段)
- dispatch:把恒定条件列 dispatch_lane 放进前缀
  (warehouse_id, dispatch_lane, updated_at, id) 与 (warehouse_id, dispatch_lane, delivery_time, id);
  缺少该列时 COUNT(*) 仍会退回回表(实测 1.2s),且 dispatch 分支会剔除从 current
  继承来的同名后缀索引,避免同一张表维护两份功能重叠的索引
- 索引统一追加在索引数组末尾,保持既有索引下标顺序不变

验证(开发库,同一张 59.4 万行同规模表 + 应用日志中的真实 SQL):

- 主查询 1511ms(Using filesort)→ 1.0ms(Backward index scan)
- COUNT(*)  1217ms(Using where 回表)→ 197ms(Using index)

生产建议低峰期先手工建同名索引,避免部署后首个请求在建索引期间阻塞。
2026-09-15 16:03:29 +08:00
liufumingren
55f766f643 fix(stockout): 出库单确认按来源分流回传,运单号口径收敛为复数
- storage.stockout.confirm 出站回传改为按 source_type 分流(复用 order_async.js 既有分流实现):
  QM→奇门 taobao.qimen.stockout.confirm;API→OpenAPI 回调 stockout.confirm(appKey 按货主合约
  反查 wms_store_warehouse(auth_status=2) + wms_api_app(启用且 callback_url 非空));
  WMS 等内部来源无需外部通知、直接视为成功。修复此前 API 来源出库单被硬编码发往奇门、
  遭「-1 无法匹配货主」拒绝后无法确认(跳过出站同样走失败分支)的问题。
- storage.stockout.confirm 运单号校验与回传改为以复数 waybill_codes 为准(对齐奇门
  packages.package[].expressCode 多运单模型,不使用 deliveryOrder.expressCode);
  单数 waybill_code 已弃用,仅在复数缺失时回退单数兼容存量单;失败文案改为 (waybill_codes)。
- storage.stockout.updateExpress 以 waybill_codes 为准,单数 waybill_code 降级为镜像字段
  (传非空复数时镜像首个、传空数组/null 时同步置 NULL、同时传两列时复数优先);
  仅传单数的旧调用方行为不变。
- app/service/systems/order_async.js 新增 3 个可复用实例方法(buildStockoutConfirmRequest /
  notifyStockoutExternal / resolveOpenApiAppByStore),薄封装既有模块级实现,
  未改动原函数及其既有调用方。
- 新增回归测试:stockout.confirm.outbound.test.js(8 条,覆盖 API/QM/WMS 三路来源、多运单复数
  回传、存量单单数回退)、stockout.updateExpress.test.js(7 条,覆盖复数镜像与兼容行为)。
- 同步 methods/system.json 与 methods/changes/system.json(storage.stockout.confirm /
  storage.stockout.updateExpress)。
2026-09-15 15:40:39 +08:00
liufumingren
8757dc6c2e feat(returnUnpack): 新增运单批量转入退件登记接口
- 新增 returnUnpack.transferByWaybills(批量入参 waybill_codes,trim+去重+过滤空值,上限 200,仓库隔离由 ctx.user.store_id 注入)
- 规则:命中运单统一置 wms_order_express.is_back='Y',不做其他前置条件限制;business_key>1 子单跳过
- 明细:按订单原本明细 1:1 复制(订单 items JSON 优先,为空回退 wms_order_items 分表;经订单索引表 wms_order_id_location_{warehouseId} 定位车道,复用 afterSale._resolveOrderDetail)
- 幂等:同仓库+同运单号 status != 'cancelled' 的拆包单直接复用(reused=true),已有明细不重复写入,复用单明细为空时按订单明细补写
- 重构:create 的取号+插主表抽为公共私有方法 _insertMainWithRetry(uk_unpack_no 冲突退避重试),create 与 transferByWaybills 共用
- 权限:新增迁移 20260915100000-add-return-unpack-transfer-waybills-permission(权限 ID 568,授权仓库组-员工 27 → 主管 26)
2026-09-15 15:38:50 +08:00
liufumingren
7c19a5f43c fix(inbox): 回信改为运单号+处理内容,不再向客户发送售后单号
生产核实(近 7 天):含售后单号(AS)的出站消息 647 条 / 46 个群,其中 99.8% 发在货主售后群;
拦截回信 484 条、工单处理备注通知 96 条、拦截幂等 33 条只带 AS 无运单号,客户无法据此跟进。

- 拦截回信:`运单X 拦截信息已登记,已通知快递群`(未配置快递群 / 已登记过同理),
  幂等分支回 `运单X 已有处理中的拦截申请`;AS→运单号用 validList 按 waybill_id 反查
  (existingASList 只带 waybill_id)
- handleStoreFeedback / weishoudao:`运单X <问题>问题已登记`,去掉 `,工单:AS...`
- cancelIntercept:回信补运单号(已追加到处理中的工单 / 已创建处理工单)
- systems/afterSale handleWorkOrder 处理备注通知:`运单X 处理备注:\n<备注>`(无运单号时降级)
- inbox/ai.js systemPrompt 口径同步:拦截回复必须给运单号,严禁回复售后单号;模板描述去掉工单号

售后单号仍照常生成、入库、驱动幂等与状态流转,仅不再出现在回信中。

验证:eslint 通过;test/inbox handle_store_feedback 13 passing,其余站内信用例 100 passing。
(query_return.test.js 的 8 个失败为既有环境问题 can't get mockContext before ready,
已用 git stash 基线对比确认与本次改动无关)
2026-09-15 15:32:51 +08:00
liufumingren
7a91988b41 fix(inbox): 出站回执/通知按群ID校正渠道来源,修复群 ext_data 渠道错配
问题:wms_inbox_group.ext_data.source 与群ID格式(@chatroom=wx / 纯数字=qiwe)不符时,
出站回执/通知会把错误渠道原样透传给桥接,投递到错误渠道(qiwe offline 503)而丢失。
生产实测错配出站记录 4018 条(2026-08-15 20:48 ~ 09-14 15:23),涉及 11 个群。

- 新增 app/lib/inbox_channel.js:resolveChannelSource / normalizeExtDataSource
- processor.writeOutboundReply:回执落库与回调体统一使用校正后的 ext_data,不一致时打 warn
- processor._loadGroupInfo:ext_data 写回群配置前先按群ID校正
- systems/warehouseNotify.pushSystemMessage:sys:notice 链路同样校正
- 新增 script/fix-inbox-group-channel.cjs:存量修复脚本(默认 dry-run,--apply 写入,
  --messages 连消息表一起修,写入前自动备份到 temp/,幂等)
2026-09-15 15:31:43 +08:00
liufumingren
38562c3103 fix(inbox): 修正运单号提取把 14 位运单号当日期戳剔除导致只回引导语
现象:生产货主群机器人发「79140215263762 改地址 广东省广州市番禺区…收件人:王小姐19875119016」,
群里只回了「如需修改地址,发送:改地址+运单号」引导语;ai_thoughts 为 params={} +
reason=参数不足-引导提示 → 改地址诉求没建工单、也没转发快递群。

根因:extractWaybills 的日期时间戳过滤正则
/^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{4,}$/ 年份不限,
把 79140215263762 读成 7914-02-15 而剔除(该运单实际存在:中通快递 ZTO、
store 1000180、order 577016)。生产 wms_order_express 中有 7627 条运单会被该正则误杀
(中通 769…/791…/736…/790…、韵达 321…/319… 等 14 位号)。

修复:日期戳判定限定年份为 19xx/20xx(/^(19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{4,}$/),
真实日期戳(如 20260914201201)仍被过滤,手机号/座机/售后单号等过滤保持不变;
改动只放宽过滤,不存在回归面。

验证:
- script/tmp-check-inbox-intercept-guard.cjs:15/15 通过(新增 14 位中通单号应被提取、
  11 位手机号仍过滤、日期戳仍过滤 3 例)
- script/tmp-push-inbox-robot-intercept.cjs:新增 INBOX_CONTENT 自定义正文模式;
  本地走真实签名入站链路复现生产原文 → 工单 AS20260915000001(change_address/pending,
  描述含原文)+ 回信「运单79140215263762修改地址已经登记,稍后客服将人工跟进」
2026-09-15 13:47:01 +08:00
liufumingren
1fe79844ba fix(inbox): 拦截规则守卫误伤「物流单号」标签导致机器人拦截请求静默不回信
现象:生产货主群机器人发「<店铺名>LSFJY…\n物流单号:SF… 拦截」无任何回信
(ai_thoughts=null、无 outbound 子记录),2026-08-28 起该群 0 回信。

根因:INTERCEPT_GUARD 用裸词「物流」判定物流查询意图,命中了单号标签
「物流单号:」→ 拦截规则被 continue 跳过 → 无规则命中且 aiFallback=false
→ 静默(不写 thoughts、不建工单)。store 群该格式消息共 275 条,其中 178 条未回信。

修复:判定查询意图前先剔除运单号标签(物流单号 / 物流单 号 / 物 流单号 / 快递单号 /
运单号),标签之外的「物流轨迹 / 查快递 / 到哪」等查询词仍照旧拦截,
客服对话类消息继续静默,不会误建拦截工单。

验证:
- script/tmp-check-inbox-intercept-guard.cjs:12/12 通过(含生产群分组可用性断言)
- script/tmp-push-inbox-robot-intercept.cjs:本地走真实签名入站链路(/warehouse inbox.push),
  用库内真实顺丰运单覆盖纯数字 / SF / YT 三种单号形态 3/3,均建拦截工单 + 通知快递群
  + 回信 + 置订单 intercept_status/intercept_time
2026-09-14 22:55:23 +08:00
liufumingren
251d703c87 chore(script): 更新波次闭环排查脚本抓取目标
tmp-trace-wave-closure-cause.cjs 改为在远端源码中定位 batchCancel 相关实现并打印上下文,
不再抓取历史日志片段
2026-09-13 15:32:04 +08:00
liufumingren
45e909fca0 chore(db): 记录 wms_workbench 生产迁移前备份快照
database/backups/wms_workbench_prod_backup_20260906132437.sql
(生产 112.124.21.102 迁移前导出的建表语句与 20 行存量数据,用于核对迁移结果)
2026-09-13 15:31:27 +08:00
liufumingren
c3f1c67592 chore(script): 沉淀波次池/报表/库存/订单本地排查脚本
新增一批一次性排查脚本(script/tmp-*.cjs),与仓库既有 script/tmp- 约定保持一致,
覆盖波次池边界与优先级核对、库位/出库报表核对、订单状态与更新范围核验等场景
2026-09-13 15:31:27 +08:00
liufumingren
f3c9be75ce chore(git): 忽略本地 nginx 接线产物
.ssl/、nginx_config/、nginx-upstream-local.conf 为本地生成的证书与服务端配置,不入库
2026-09-13 15:31:06 +08:00
liufumingren
4b1e3aae7f refactor(stockout): 出库单 create/query 收敛到共享领域服务
- app/service/qimenMethods/stockout.js 瘦身为奇门适配层:
  create 委托 systems.stockoutOrder.create(sourceType=QM),query 直接 delegate
- 新增 app/service/openapiMethods/stockout.js:
  入参为 openapi 扁平结构 body.deliveryOrder / body.orderLines / body.deliveryOrderCode
  (query 兼容 deliveryOrder.deliveryOrderCode),create 传 sourceType=API,
  由共享层决定回传走 qimen confirm 还是 openapi 回调 stockout_completed
2026-09-13 15:31:05 +08:00
liufumingren
74b3f04b79 feat(storage): 新增按库位查询有量库存商品列表
- systems/storage/inventory.js 新增 getStorageListBySpaceId(spaceId):
  校验库位归属当前仓库(区分「库位不存在」与「库位属于其他仓库」),
  返回该库位 quantity>0 的库存并按 stock_id 汇总,
  商品信息复用 stock_warehouse 通用链路(getStockDetails)补全属性
- systemMethods/storage/inventory.js 开放 listBySpaceId,
  免权限/免鉴权/免日志名单同步补充
2026-09-13 15:31:05 +08:00
liufumingren
018bbd379d feat(warehouse): 前置仓前端配置与按域名公开拉取接口
- 新增模型 wms_warehouse_front_config 与迁移:建表、
  追加 favicon_url、追加 cert_pem(可回滚)
- systems/setting/warehouse.js 实现 getFrontConfig / saveFrontConfig / saveFrontCert、
  域名唯一性校验、按域名缓存读取(含未登记域名的短 TTL 空缓存防穿透)与缓存清理
- systemMethods/setting/warehouse.js 开放对应 system method
- 新增公共免登录接口 frontConfig.getByDomain:按域名返回公开字段
  (domain/title/logo_url/login_bg_url/favicon_url/theme),
  不返回 cert_path/key_path/sync_status 等内部字段;未登记域名返回 404
2026-09-13 15:31:02 +08:00
liufumingren
724f4a13c6 feat(packing): 复核列表 waybill_code/wave_no 支持操作符与多值数组
- systems/order_packing.js:waybill_code 支持 {operator,value} 且 value 可为字符串数组;
  operator=contains/like 按 LIKE '%值%' 模糊匹配(可命中 '主体-1-1-' 分片单号),
  缺省/eq 保持「完整单号 + 剥离分片后缀主体 + 主体前缀」精确匹配,
  不落入 %短串% 模糊分支(保留「不完整短串不得命中订单」的业务约束)
- wave_no 支持 eq/in 精确、ne 不等、contains/like 与缺省模糊匹配
- systemMethods/order/packing.js 同步 jsdoc 参数说明
2026-09-13 15:31:02 +08:00
liufumingren
83bda9be10 feat(wave): 波次管理列表 where 支持标准操作符与多值数组
- buildBatchListWhereClause 走通用操作符构建:仅 {operator,value,type} 标准结构读 operator,
  裸值回落字段默认操作符(文本字段 LIKE 模糊、其余 eq),裸数组按 in
- 支持 eq/ne/gt/lt/ge/le/in/notin/between/notbetween/like/contains/notlike/
  startswith/endswith/isnull/isnotnull,按字段分组限定允许的操作符集合
- store_id 支持 ne/notin(子查询排除 NULL wave_id);distinguish_express 归一化为 0/1;
  新增 total_orders / processed_orders 输出
- 同文件一并透传 batchAllocateExpress 的 skipped_need_oms_waybill_order_ids(见相邻提交)
- 验证脚本:run/check-wave-batch-where-operator.cjs(33 用例,期望值现算)
2026-09-13 15:30:55 +08:00
liufumingren
da7df4139d feat(order): 新增 need_oms_waybill 回 OMS 取号标记与本地取号分流
- 模型/迁移:wms_order_delivery 新增 need_oms_waybill TINYINT(4) NOT NULL DEFAULT 0,
  迁移覆盖基表与全部分表(含 _history/_dispatch/_outsourced),幂等且 down 可回滚
- 写入链路:openapi 请求根节点 need_oms_waybill(兼容 camelCase needOmsWaybill)→
  openapiMethods/deliveryorder.js 透传;delivery_order.js 仅 API 来源可能为 1,
  QM/MANUAL/STOCKOUT 一律强制 0(见相邻提交)
- 取号分流:need_oms_waybill=1 的订单不参与本地自动分配快递
  1. asyncProcessOrderCreated 不入本地取号队列,写 ORDER_NEED_OMS_WAYBILL_WAIT 操作日志
  2. express.createWaybillCodePipeline 按订单级标记过滤(同订单全部 business_key 一并跳过),
     返回值新增 skipped_need_oms_waybill_order_ids
  3. schedule/consume_waybill_allocate_queue 将对应队列行置终态 waiting_oms
     (不再走 pending 重试 → failed)
- waybill_allocate_queue.status 注释补充 waiting_oms 语义(STRING(20),无需迁移)
- test: delivery_order.asyncProcessOrderCreated.test.js 新增分流/保持本地取号用例,
  express.createWaybillCodePipeline.skipCancelled.test.js 补齐返回字段断言
2026-09-13 15:30:55 +08:00
liufumingren
dfaaa7f060 fix(order): 建单统计列随 INSERT 写入与锁冲突退避重试
- 统计列 items/items_hash/items_crc 均为 wms_order_delivery_* 二级索引列:
  先插占位值再 UPDATE 回写会让并发建单在同一索引区间反复「删标记旧条目 + 插入新条目」,
  批量推单高并发下必然死锁(生产 2026-09-10 单批 354 个事务因此失败)
  → 新增 buildOrderStats,统计列与主表 INSERT 同一条语句写入;
    快递策略命中时只 UPDATE 非索引的快递字段
- 建单顺序调整为先写明细、后写主表(库存预占失败直接回滚,不留悬挂主表行)
- 重试策略:最多 3 次;主键冲突修复水位后重试,新增 isRetryableLockError
  (1213/1205/deadlock/lock wait timeout)带抖动退避重试,
  失败文案统一为「重试后仍未成功,请稍后重试」
- 同文件一并包含 need_oms_waybill 写入与取号分流(新增 normalizeNeedOmsWaybill、
  prepareOrderData 第 7 参、appendNeedOmsWaybillWaitLog 与 asyncProcessOrderCreated 分流),
  该字段的模型/迁移/入口见相邻提交
- test: delivery_order.addOrder.test.js 补 allocateOrderId 桩、按新写入顺序断言,
  并覆盖 need_oms_waybill 根节点取值/归一化
2026-09-13 15:30:54 +08:00
liufumingren
2555f3bb4d fix(openapi): deliveryorder.confirm 回调 appKey 按货主合约反查
- 背景:order_storage_allocation 构造的 routeContext 不含 appKey,
  finalizeLocalChannelOrdersInternal 的 if(appKey) 门禁导致 API 同步链路的
  deliveryorder.confirm 从未真正发出;订单表 from_key 也兜不住
  (normalizeOrderFromKey 仅接受整数,字符串 app_key 被归一化为 null)
- order_async.js 新增 resolveOpenApiAppByStoreInternal:口径与入库单
  _sendOpenApiCallback 对齐(wms_store_warehouse auth_status=2 →
  wms_api_app is_enabled=1 且 callback_url 非空)
- notifyApiDeliveryOrderConfirmsInternal 逐单解析 appKey:context.appKey 非空优先
  (不触发反查),缺失时按 orderRow.store_id 反查并按货主缓存(同批次无 N+1);
  解析不到 appKey 的订单 warn 后跳过、不发请求
- 补充回调成功 info 日志(含 appKey)
- 文档:methods/openapi_callback.json 1.2.0 → 1.3.0、变更记录
  methods/changes/openapi_callback.json、docs/openapi-callback-events.md、
  AI_METHOD_ROUTING.md 同步
- test: order_async.openapi.callback.test.js 覆盖 context.appKey 为空时反查发送
2026-09-13 15:29:51 +08:00
liufumingren
cf3b9092c6 fix(qimen): 出站请求日志使用独立 log_id 并幂等消费日志队列
- qimen_client.sendRequest 出站日志改为 generateLogId() 生成 QL-<时间戳>-<随机>,
  不再复用入站 ctx.qimenLogId,避免与入站文件队列落库撞 wms_qimen_log.log_id 唯一索引
- qimen.saveQimenLog 去掉 ctx.qimenLogId 兜底;saveQimenLogResult / saveQimenLogBody
  改为按 log_id 定位更新(原先按 id 字段更新与调用语义不符)
- schedule/consume_qimen_logs 插入遇 ER_DUP_ENTRY 视为幂等命中跳过并推进消费进度,
  避免重复日志卡死文件队列
- test: qimen_query.test.js 断言改为校验新 log_id 格式
2026-09-13 15:29:43 +08:00
liufumingren
d725e7e457 feat(openapi): 出站回调命名与报文改奇门同层级
- 回调 method 由 snake_case 事件名改为 模块.动作:entryorder.confirm / entryorder.match / deliveryorder.confirm / stockout.confirm / deliveryorder.cancel(原 order.cancel 与入站方法同名,改名避免 callback_url 误指向 /openapi 时被路由到取消单据接口)。

- 时间戳统一为秒级(String(Math.floor(Date.now()/1000))),与 /openapi 入站 ±600 秒时效校验及回调调试页一致。

- 报文体由 { event, data, metadata } 改为奇门同层级 { request: {...} }(移除 metadata,事件标识只靠 query 的 method);入库类回调与奇门侧共用同一份报文组装。

- deliveryorder.confirm 改为逐单发送(仅同步成功的订单);stockout.confirm 直接复用 buildStockoutConfirmDataInternal 结果。

- 修复 entryorder.match 死代码:绑定成功且本次新建绑定时回传,重复触发不重复通知,回传失败不影响绑定。

- 调试页 /docs/api/openapi/callback-test 按真实报文预填;新增出站回调文档页 /docs/api/openapi_callback 及入口链接。

- script/update-api-doc.cjs 支持 spec.newDoc 新建文档与 docMeta.description(附单测)。

- 文档:methods/openapi_callback.json、AI_METHOD_ROUTING.md 5.6 节、docs/openapi-callback-events.md、docs/api-doc-update-workflow.md 等。
2026-09-13 02:24:37 +08:00
liufumingren
e19b5fc18c feat(order): 取消单据支持 CK 出库单与 RK 入库单
- 奇门 order.cancel:CK 组(PTCK/DBCK/B2BCK/QTCK/CGTH)委托 systems.stockoutOrder.cancel 取消出库单(仅 CREATED/PENDING 可取消,释放 QM_STOCKOUT 锁定,不回传);RK 组由裸改状态升级为复用 systems.storage.entry.cancel 完整作废流程(状态守卫 + 回退收货单占用 + 操作日志,已作废幂等成功)。

- openapi order.cancel:新增 CK 组与 RK 组路由,成功/失败文案与奇门口径一致。

- storage.stockout.cancel 改为委托共享实现,对外契约与文案不变,改为单事务 + 行锁。

- storage.entry.cancel 扩展入参能力(entryOrderCode 定位 / skipExternalSync / idempotent / notFoundMessage),系统方法入口行为不变。

- 文档:methods/{qimen,openapi,system}.json 及对应 changes 同步。

注:app/service/systems/stockout_order.js 与 methods/openapi.json 同时承载此前未提交的出库单(stockout)共享服务与文档,文件粒度无法拆分,一并纳入本次提交。
2026-09-13 02:24:18 +08:00
liufumingren
839d4e2d7f feat(video): 视频补录请求状态收敛与结果通知拆分
1) 新增 wms_video_record_request 模型与迁移(群/人员信息列、状态+通知扫描索引);索引调整为 (status,is_notified,last_request_at) 并移除单列 idx_status。

2) systems/video_record_request.js:settleStatuses 只收敛状态(可用/全部失败/超时/参数缺失),notifyResults 只做结果通知;成功结果按原查询链路(queryPackVideo/queryReturn)取回并回原群,失败/超时回原群并转人工通知(仓库群客服群,未命中不外发)。

3) schedule/notify_video_record_result.js:每 1 分钟串行执行「状态收敛 → 结果通知」,带重入锁,仅在有变化时打日志。

4) inbox/functions.js:查询打包/拆包视频时同步补录请求状态(有视频置 completed),无可用视频时登记补录请求并推送录制服务。

5) config.inbox 新增 videoRecordNotifyLimit / videoRecordNotifyTimeoutMs。
2026-09-11 02:49:27 +08:00
liufumingren
0782b65546 fix(cainiao): tid 优先取订单表 oaid_order_source_code,为空时兜底原逻辑 2026-09-10 23:54:04 +08:00
liufumingren
6701e661c5 feat(order): 拣货任务列表支持按拣货车编码 cart_code 查询 2026-09-10 23:52:43 +08:00
liufumingren
a4cadeb83b feat: 库内确定拦截订单明细报表与拦截时间口径调整
- 新增通用报表注册类型 interceptOrder(库内确定拦截订单明细):以配送表 dispath_time 为时间基准,统计昨日自然日(不含当天,可用 params.bizDate 指定更早日期补数)intercept_status=intercepted_at_warehouse 的订单,按商品明细展开;列 = 订单导出 item 模式去掉商品图片(46 列)+ 平台交易单号 / 通知拦截时间 / 库内确定拦截时间,共 49 列
- intercept_time 口径统一为「最近一次发起拦截的通知时刻」:发起拦截首次写入不覆盖(新增 app/lib/intercept_time.js 与 qimen/openapi/inbox/pendingOrder 四处改造)、库内拦截确认与退回入库不再覆盖、取消/解除拦截与订单克隆重置置空;库内确定拦截时刻改用配送表 dispath_time
- 报表导出文件名模板新增 {time}(生成时刻 HHmmss)/ {datetime} / {timestamp} 占位符({date} 语义不变),避免同一天多次投递/导出同一报表时 COS 同名覆盖与 CDN 旧内容回源
- 文档同步:methods/system.json 0.3.104 -> 0.3.109(report.generate / report.definition.* 契约与拦截时间口径说明)、methods/changes/system.json 新增 4 条变更记录、docs/report-config-guide.md 新增 2.2 节、字段清单与文件名占位符说明
- 回归与实测:test/report_*.cjs 13 个文件 + test/intercept_time_lifecycle.cjs 全部通过,ESLint 0 error;开发库投递计划实测(19:40 / 20:25 两条计划投递成功或仅文本通知环境依赖失败,文件名均带时分秒、导出列与定义勾选一致)
2026-09-10 20:59:39 +08:00
liufumingren
0fe43c87b1 fix: 跨仓 order_express 校验与 recheckOrder 原生 SQL 表名修复
- 跨仓 bug 修复:order_express 读取强制校验订单所属仓库 id(order.detail 与全部订单列表等 17 处)

- recheckOrder 原生 SQL 表名补 wms_ 前缀,修复 queryRecheckOrderSingleList 恒 500

- 同步 methods 文档与变更记录
2026-09-10 03:46:41 +08:00
liufumingren
d73c66c2f3 feat: 小团购PDA抓取跨池同结构合并
- 小团购(pickMode=1)抓取新增跨池同结构合并工序,第一池出现的结构按全池过筛口径合并今日同结构订单一并建波,修复订单池今日/今日前分割导致同结构订单被拆散后的 1 单 1 波次问题(生产订单 11103)
- 三重门控:仅小团购+第一池非空+max_same_structure 有效(null/999 跳过维持现状),大团购与后台抓取不覆盖
- 新增 merged_order_count 统计字段;同步 methods 文档与变更记录
- 回归 26 用例全部通过
2026-09-08 21:38:53 +08:00
liufumingren
67a70d0394 feat: 系统日志定时清理任务(每日 03:00,硬删除超保留期日志)
- 新增 app/schedule/system_log_cleanup.js 定时任务:cron 从 config.systemLogCleanup.cron 读取(缺省回退 '0 0 3 * * *'),受 enable 开关与防重入保护

- 新增 app/service/systems/system_log.js:按 id 边界定位 + 分批硬删除超期日志,保留天数默认 60(normalizeRetainDays 校验非法值回退),批间随机休眠降低数据库压力

- config.default.js 新增 config.systemLogCleanup 配置块:enable、cron、retainDays 60、batchSize 2000、sleepMinMs/sleepMaxMs

- 新增 service 与 schedule 单测(39 个用例),覆盖边界定位、保留天数校验、配置开关与防重入等场景
2026-09-08 17:00:05 +08:00
liufumingren
68dbf65c77 feat: 波次复核开始时间回写与统计/防覆盖修复
- 波次策略列表 order.wave.waveStrategyList 成功响应新增 info.order_count(当前查询条件下全部策略命中订单去重总数,新增 getWaveStrategyMatchedOrderCountTotal,与行级统计同口径,统计失败安全降级为 0)

- 拣货任务 wms_wave_pick_task.finish_time 防覆盖:两处写入改为 CASE WHEN finish_time IS NULL,只记第一次

- 波次复核开始时间:新增迁移 20260908120000(wms_wave_batch 新增 recheck_start_time 字段,已在开发/生产执行)、模型字段同步、scanOrder 各成功分支首次回写(新增 markWaveRecheckStart,仅 IS NULL 时写入,回写失败不影响扫描主流程)

- 同步 methods/system.json 与 methods/changes/system.json 接口文档及变更记录(docMeta.version 更新至 0.3.101)

- 新增 recheckOrder-scanOrder-recheckStartTime HTTP 行为验证脚本与验证报告
2026-09-08 16:36:57 +08:00
liufumingren
b1000fd0e8 chore(deploy): 证书同步双环境配置发布约定落地
- 发布/回退链路新增固定文件排除与保护:warehouse-cert-sync 两份环境配置不进发布包、清理时暂存/放回,服务器副本不被覆盖/删除(deploy-lib 独立常量 + 共用守卫函数)

- deploy-cert-sync 新增 config-check 只读核对;install 对 prod 配置首次放置一次、之后永不覆盖;dev 配置永不上传生产

- 薄包装简化:nginx 二进制/upstream/reload 全部收敛到 prod 配置,包装仅保留 cwd+依赖+DB 运行时引导

- 新增 warehouse-cert-sync.cjs 与 dev/prod 双环境配置;package.json 增加 deploy:cert-sync:config-check
2026-09-08 04:26:39 +08:00
liufumingren
86222a24eb feat: COMPLETED 入库单绑定收货单与防超扣台账链路
- 入库单 COMPLETED 状态放开绑定收货单,事务内按 SKU 同步收货单明细入库进度(stored_quantity/storage_status)

- wms_entry_order_receiving 新增 allocated_quantity 台账列(迁移已在生产执行),多收货单绑定按剩余可分配量封顶防超扣

- 统一锁序(入库单主行→绑定行→收货明细行)修复并发绑定死锁;解绑/作废按台账回滚,不再整体清零共享收货单

- 同步 entry_items.received_quantity 口径,与绑定收货单 stored_quantity 可对账

- 同步 methods 文档与变更记录、AI_METHOD_ROUTING 方法清单
2026-09-07 22:16:54 +08:00
liufumingren
6a1abbe00c chore(order): 配送表 dispath_time 链路文档同步与回归测试收尾
- methods/system.json:order.manualOutboundOrder 描述补充 dispath_time 迁移时间说明,errors 键规范化为 message,版本升至 0.3.95(含 store.openAccount 移除 logo_url/domain 入参的同步)

- methods/changes/system.json:新增 order-delivery-dispatch-dispath-time 与 store-openAccount-remove-logo-url-domain 两条变更记录

- test:order_delivery_migration.test.js 超时重试路径 dispath_time 断言与 buildDispatchRow 专项用例;return_received.dispatch_trigger.test.js 退货间接触发用例
2026-09-07 17:49:49 +08:00
liufumingren
efadcba56e feat(store): 移除 wms_store 已废弃的 logo_url、domain 字段
- app/model/store.js、app/service/systems/store.js、app/service/systems/store_warehouse.js:移除 logo_url/domain 字段定义与创建写入,app/ 下无残留引用

- database/migrations/20260907140000-drop-logo-url-and-domain-from-wms-store.js:删除 wms_store 的 logo_url、domain 两列(开发库已执行完成)
2026-09-07 17:49:43 +08:00
liufumingren
c5150bc35b feat: 配送表新增 dispath_time 迁移时间字段
- 新增迁移 20260907120000:为全部配送分表 wms_order_delivery_{wh}_dispatch 幂等新增 dispath_time(datetime, nullable),不触基表/当前分表/history/outsourced

- 配送表模型 schema dispatch 分支同步新增 dispath_time,drift 同步保持一致

- 订单迁移链路 buildDispatchRow 写入 dispath_time=new Date() 记录进入配送表时间
2026-09-07 16:43:35 +08:00
liufumingren
6939d9600a feat: 拦截链路完善与车绑定修复
- 订单表新增 intercept_time 拦截时间字段(迁移覆盖基表与全部分表),全拦截链路写入拦截时间、解除拦截清空

- 新增自动库内拦截确定定时任务(1h 间隔,扫描 requested+未打印订单,超时自动库内拦截确定)

- 复核链路自动移除波次内未打印拦截订单回池,拦截解除后可重新抓取发货

- 打印解绑车判定排除拦截订单,修复波次含拦截订单时车无法解锁

- 同步 methods 文档与变更记录;含 wave_scope 回填、workbench token 过期等前序迁移
2026-09-07 03:48:43 +08:00
liufumingren
1d65d26500 feat(wave): PDA按策略抓取增加订单池按今日0点分割,今日前订单优先出库
- getWaveStrategyFetchCandidateOrders 增加可选 createdBefore 上限过滤(不传时行为不变)

- autoPopulateWaveStrategyFetchSelections 先抓今日前订单池,清空后回落第二池;日志补充池阶段信息

- 新增 normalizeWaveStrategyFetchCreatedBefore / buildWaveStrategyFetchTodayStart

- 附带:resolveWaveScopeByWaveMeta 单品单件 wave_scope=4 映射与 pickMode 传递

- 新增边拣边分联调脚本与订单池完整验证脚本
2026-09-06 02:31:07 +08:00
liufumingren
95067aeb8a feat(wms): 工作台成员、波次范围、库存明细与报表修复等多项更新
- workbench: 工作台成员拆分 wms_workbench_member 表,下线 barcode 字段,新增绑定/移除成员接口

- order: 订单配送新增 wave_scope 波次范围字段与历史回填,自动分配快递排除备注与储位分配限制修复

- storage.transaction.list: 重写为 wms_storage_transaction 逐条明细查询,消除聚合慢查询

- stock.report: 分页默认生效、排序白名单扩充、where.stock_id 数组兼容修复

- storage.entry: quickInbound/commit 新增 noNeedNotice 通知开关

- storage.inventory.list: stock_query 支持数组多关键字并集匹配

- store: 手工单回传通知策略 notify_manual_sync

- docs: 同步接口文档与变更记录、路由表;test: 补充快递排除与储位分配限制测试
2026-09-05 22:43:38 +08:00
liufumingren
b6ae8313a1 fix(order): 自动分配快递排除备注生效并补写跳过日志,储位分配默认禁止存储储位
订单备注命中仓库「自动分配快递排除备注」时跳过自动分配快递,并补写 ORDER_AUTO_EXPRESS_SKIP 操作日志说明原因与命中关键字

储位分配默认排除存储储位(库位类型过滤下沉到 JS 层按货主存拣分离策略逐 SKU 生效),仅当货主关闭存拣分离或前端传入 allow_storage_location=true 时放行;自动分配不再强制 allow_storage_location=true

按当前实现基准修正 order_storage_allocation 过期单测,补充排除备注与存拣分离放行用例(26/26 通过,ESLint 0 错误)
2026-09-05 22:42:39 +08:00
liufumingren
6a71957686 feat(pick): 大团购任务 pick_mode 修正为 5,波次/订单/拣货任务表新增领料人与抓取人字段,领料人非本人拦截重领并覆盖 2026-09-04 21:43:05 +08:00
liufumingren
68c279b896 fix(workbench): 团购波次打包拦截订单静默跳过且日志仅写非拦截订单
- _packOrder 团购波次拦截订单不再拒绝,返回完成结构静默跳过,不创建打包任务
- _getWaveOrderIds 默认排除拦截订单,团购打包操作日志仅写给非拦截订单
- 散单拦截订单仍拒绝打包,保持原行为
2026-09-04 21:12:17 +08:00
liufumingren
c9fc06ebe6 feat(intercept): 拦截链路补齐操作日志并禁止对团购已复核/散单已称重订单写入拦截请求状态
- 补齐 qimen/OpenAPI/后台取消转拦截各分支的 ORDER_INTERCEPT_REQUEST 操作日志(此前已同步订单转拦截分支漏写)

- 新增 intercept_guard 共享前置校验:团购单已复核(inspection_status=fin)、散单已称重(weighing_weight>0)不允许再写入 requested/intercepting 拦截请求状态

- qimen/OpenAPI 取消拦截命中校验时跳过状态与日志写入,保留售后工单与快递群通知;pendingOrder 取消已同步订单直接拒绝并回滚;批量拦截跳过并返回 skipped_order_ids
2026-09-04 20:59:44 +08:00
liufumingren
8db3629e2d fix(recheckOrder): 团购批量复核逐单补写订单级操作日志,订单日志列表可见复核记录 2026-09-04 02:15:16 +08:00
liufumingren
2135f05b49 docs(methods): 同步接口文档与路由表,含拦截锁定、自动分配时间、打包/退回导出、报表群路由、收货货主名称等变更记录 2026-09-03 17:04:03 +08:00