405 Commits

Author SHA1 Message Date
liufumingren
01acf106ae refactor(order): 自动出库当天订单开关改排除语义,allow_same_day_outbound 更名为 exclude_same_day_outbound(默认排除) 2026-09-23 02:46:11 +08:00
liufumingren
ec632cf3e5 feat(after-sale): 新增取消拦截子类型,补齐拦截/揽收/错发/多发运单号取号规则与关键词迁移 2026-09-23 02:46:06 +08:00
liufumingren
dde026d7dd feat(inbox): help 清单按群类型白名单过滤并按 sort_order 排序,回复占位符 back_text 回退 message 2026-09-23 02:46:00 +08:00
liufumingren
e8526e2bef feat: 自动出库规则支持当天订单限制配置
- 新增 allow_same_day_outbound(出库当天订单,默认否)
- 新增 same_day_outbound_deadline_time(允许当天出库最后时间,默认 06:00;复核时间早于该时间的订单不受关闭影响)
- 新增 same_day_outbound_release_time(当天放开时间,默认 22:00;当天到达该时间后放开当天复核订单)
- 保存校验:允许当天出库最后时间不能大于当天放开时间
- 出库扫描按 recheck_time 过滤:到达放开时间前,当天最后时间之后复核的订单不自动出库(北京时间边界,UTC 存储换算)
2026-09-23 02:22:23 +08:00
liufumingren
bf4920475d docs(api): 同步 business 打包分支 users 恢复说明与变更记录 2026-09-21 19:25:26 +08:00
liufumingren
df0c1735c8 fix(workbench): business 打包分支恢复 users 上报打包人,token+key 新链路保持工作台成员回填 2026-09-21 19:25:22 +08:00
liufumingren
17944bcf01 docs(api): 同步 workbench 打包接口文档、变更记录与方法路由 2026-09-21 02:28:07 +08:00
liufumingren
f06dc3d765 feat(workbench): 打包链路重构:运单维度流水、成员自动回填与登出自动结束、token+key 消费模式、getWorkbenchInfo 字段补齐 2026-09-21 02:28:04 +08:00
liufumingren
e76a6e3fa4 fix(order): 奇门/openapi 查单与取消接口跨分表查单
新增 app/lib/order_lookup.js 共享辅助函数(preloadOrderModels/findOrderAcrossTables/
findOrderByCodeAcrossTables),按 current→dispatch→history→outsourced 顺序命中即停;
模型预取置于事务外(工厂首次获取可能执行 DDL 隐式提交),事务内查询支持透传行锁。

改造 4 处接口:
- qimen deliveryorder.query / openapi deliveryorder.query:跨表查单,
  订单流转到配送/历史表后不再误报"未找到订单"(避免货主误判重推);
- qimen order.cancel / openapi order.cancel:跨表查找,命中非 current 表
  且 status=cancel 时幂等返回取消成功,其余情况返回"未找到对应的订单"。

回归验证(真实网关,脚本在 test/ 不入库):
- openapi:query 命中 dispatch、cancel 幂等成功、不存在单号报错
- qimen:同 4 场景全部符合预期
2026-09-20 22:12:35 +08:00
liufumingren
ce3e0185e1 fix(order): 推单跨分表单号查重
delivery_order_code 查重由仅查 current 分表扩展为 current/dispatch/history
三表并发查重,命中任一表即拒绝重复建单;dispatch/history 模型获取可能执行
DDL(隐式提交),已移至事务外完成。
2026-09-20 18:39:20 +08:00
liufumingren
ce04778021 perf(order): quickSearch 改为逐级短路搜索
命中顺序:运单号(waybill_code) -> 发货单号(delivery_order_code) -> 平台订单号(source_order_codes),
每一级只要命中即停止后续查询,直接进入订单详情。

- 运单号:等值 + 剥离一单多件分段后缀主体等值 + 主体前缀 LIKE,走 waybill_code 索引
- 发货单号:等值走 idx_delivery_code_store;未命中再 %kw% 模糊兜底
- 平台订单号:%kw% 模糊仅作最后兜底

避免原单条 OR 查询混合等值与 %kw% 模糊导致优化器放弃索引、
退化为按 warehouse_id 全仓库扫描(生产单仓库 66w+ 行)。
dbg 调试日志改为持久写流异步写入,消除 appendFileSync 同步磁盘 IO。
2026-09-20 18:39:16 +08:00
liufumingren
c6224b471e chore(script): 临时脚本移入 temp 目录(gitignore 范围,退出版本控制) 2026-09-20 16:14:10 +08:00
liufumingren
dc9f83a2d7 perf(aftersale): 售后/退货拆包订单查询改为 attributes 白名单,减少全字段加载 2026-09-20 16:14:06 +08:00
liufumingren
1771b5c6c9 docs(api): 同步 system 接口文档、变更记录与方法路由(确认打印相关) 2026-09-20 16:14:03 +08:00
liufumingren
17f7e3d87b feat(print): 新增确认打印功能(confirm_print_status + confirmWavePrint/confirmPrintScan 接口) 2026-09-20 16:13:59 +08:00
liufumingren
a3ec20098f fix(stock): getStoreStocks 修复 store_id 过滤失效导致跨货主/跨仓库数据泄漏
- store_id/warehouse_id/软删条件原先放在 LEFT JOIN(required:false) 的 include.where 上,只进 ON 子句无法过滤主表 wms_stock_store,传 store_id 仍返回跨货主商品
- 过滤条件改为直接落在主表 where,count/findAll 同条件,total 恢复准确
- 返回的 store_id 字段补取 warehouse_stock.store_id,并加空列表访问保护
- 订单创建报错"库存记录不存在"补上商品编码 item_code,并区分场景改为"仓库已解绑,请联系仓库关联绑定"
2026-09-20 16:01:01 +08:00
liufumingren
e8f9ccad95 feat(workbench): getWorkbenchCount 班次打包统计 + packOrder 服务端复查落库
- 新增 workbench.getWorkbenchCount:以工作台 token 鉴权,统计本地 08:00→次日 08:00 班次窗口;
  个人工作台统计涉及本人数据(团购波次数量/团购订单数量/散单数量/团散/均件数),
  团体工作台统计涉及工作台数据(团购波次数量/团购订单数量/散单数量)
- packOrder 打包数量/商品总件数/商品种类数改为服务端复查:散单取订单分表、团购取波次实时统计
  (totalOrders + 波次 SKU 聚合 15s 缓存),设备上报仅交叉校验日志;修复散单 sku_count 兜底误读 item_count 列名
- wms_pack_task 新增 (workbench_id, create_time) 复合索引迁移,避免统计查询长跨度扫描慢 SQL
- 同步 methods/system.json(0.3.142)/methods/changes/system.json,刷新 AI_METHOD_ROUTING.md
- 一并提交上一轮未提交的 order.wave.batchList sync_assignment_status 输出与筛选
2026-09-20 00:31:06 +08:00
liufumingren
388809fc9f feat(workbench): getWorkbenchInfo 补全当前打包任务商品信息(散单明细/团购波次SKU聚合/免验字段)
- 抽取 _fetchOrderItemsDetail 公共方法(queryOrder 复用),散单任务 items 返回单笔商品明细(含条码/图片/包装要求/need_recheck 免验字段)

- 新增 _fetchWaveItemsSummary(15s 短缓存),团购任务 items 返回波次商品 SKU 聚合汇总(is_wave_summary=true),500 单波次本地实测聚合 1000 件与 items_total 一致

- current_orders 补 item_quantity/sku_count/waybill_code/order_type/store_id/items_count/items_total

- 文档同步 system.json 0.3.137 与 changes 三条变更记录
2026-09-19 15:09:31 +08:00
liufumingren
806e739267 feat(inbox): v2 规则引擎完善(help 指令/建单开关/系统回复)并修复拦截日志误写仓库 ID
- functions.js: 拦截/取消拦截波次感知写订单日志 businessId 误用仓库 ID,改为订单 ID
  (生产订单 JY2026091813795 已发起拦截但订单详情查不到拦截日志的根因)
- rules/v2/processor/config/functionSync: 新增 help 指令、create_work_order=0 时跳过
  工单登记、系统级回复与无单号提示、白名单范围修正
- after_sale_reply 模型 + 6 个迁移: create_work_order 字段与相关配置种子
- return_unpack: 列表 count 统计修复、分页排序追加主键防重漏行、视频附加 camera_name
- methods/system.json + changes + sync 脚本: 接口文档与权限同步
2026-09-18 22:38:57 +08:00
liufumingren
c2a761ca26 feat(inbox): 新增开门/到货/进场/离场车牌登记与 extend_props 持久化
- functions 新增 openDoor/registerLicensePlate/enter/departure(规则表+权限分组)
- 到货登记表 wms_inbox_arrival_register(含消费字段,离场闭环,货主收货群优先推送)
- 回执 extend_props 持久化落库与定时补发送下发(重推兜底回读)
- 车牌提取正则兼容异体字(粤/粵)
- 售后类型/关键字/函数/回复 v2 模型与迁移
- INBOX V2 HTTP 测试报告与指南
2026-09-17 02:41:43 +08:00
liufumingren
a667f1401e feat(inbox): 推送失败自动重发改为仓库级开关与重发时间范围(默认关闭)
仓库设置新增嵌套配置 `subject_config.inbox_push_retry = { enabled, window_minutes }`,
结构与「收货未入库提醒」(receiving_pending_inbound_notice)保持一致:

- `enabled`:默认 false —— 未配置、配置缺失或无法读取时一律**关闭**,需在仓库设置中显式开启
- `window_minutes`:重发时间范围,单位**分钟**,1-1440,默认 30(仅开关开启时生效)

改动:

- app/model/store.js:新增 DEFAULT_INBOX_PUSH_RETRY 与 normalizeInboxPushRetry(非法结构/非法 JSON
  回退默认;enabled 非布尔值、window_minutes 越界抛「subject_config.inbox_push_retry.window_minutes
  必须是 1-1440 的整数(分钟)」),由 normalizeSubjectConfig 统一调用
- app/service/systems/setting/warehouse.js:WAREHOUSE_SETTING_FIELDS 新增 key=inbox_push_retry
  (type=object + item_keys=[enabled, window_minutes]),供仓库设置页经 getFieldMeta 动态渲染
- app/service/inbox/message.js:retryFailedByWarehouse 逐仓读仓库设置(缺省关闭、按仓库配置的窗口
  调用 retryFailed);retryFailed 新增 warehouseId 过滤;readPushRetryConfig 读嵌套结构并兜底
  enabled=false / 30 分钟
- app/schedule/retry_inbox_push.js:注释同步为「仅处理显式开启的仓库、缺省 30 分钟」
- config/config.default.js:兜底失败时间窗 2 小时 → 30 分钟;pushRetryEnabled 保留为全局应急总闸
  (默认 true,关闭后所有仓库都不重发)

单测:test/inbox/retry_inbox_push.test.js + test/app/model/store.test.js 共 40 passing,覆盖默认关闭、
非法结构回退、flag 真值归一化、窗口 1-1440 越界、仓库开关与自定义窗口、复用原记录等场景。
2026-09-16 15:04:25 +08:00
liufumingren
1571de341c feat(storage): 新增收货未入库提醒定时任务(货主/客服群通知,短语可配置)
- 新增 app/service/systems/receiving_pending_notice.js:扫描「创建时间超过 min_hours 且不足 max_hours 仍未完成入库」的收货单(wms_receiving 未作废、is_deleted=0,且 status=receiving 或 storage_status<>all),
  按货主聚合成一条消息;未绑定货主的单独一批
- 新增 app/schedule/notice_receiving_pending_inbound.js:每 5 分钟单 worker 检查,按各仓库配置的提醒时间(默认 08:30,宽限 10 分钟覆盖调度抖动)执行,
  进程内防重入 + Redis 当日锁 receiving_pending_notice🔒{warehouseId}:{YYYYMMDD}(NX/EX 24h,执行异常释放锁允许窗口内重试),保证每仓库每天只提醒一次
- 仓库设置新增字段 wms_store.subject_config.receiving_pending_inbound_notice:
  enabled(是否通知收货未入库,flag,默认 0 关闭)/ notice_time(提醒时间 HH:mm,默认 08:30)/ min_hours(超时下限,默认 24)/ max_hours(超时上限,默认 48,须大于 min_hours)
  / notice_template(仓库客服群通知短语)/ store_notice_template(货主群通知短语)
- 通知短语可配置并支持变量替换:{warehouse} {warehouse_id} {store} {store_id} {count} {min_hours} {max_hours} {date} {numbers};
  未识别占位符原样保留,留空回退默认短语,最长 500 字符(超长 400)
- 消息结构统一为「短语 + 换行 + 明细(一行一条,最多 20 行,超出提示剩余单数)+ 快速查看/详情查看链接」,不再在结尾追加句号
- 新增通知事件 receiving_pending_inbound(notification_webhook 事件注册 + notice DEFAULT_REGISTERED_EVENT_CODES)与固定群订阅:
  store:receiving,fallbackTargets=warehouse:customer_service —— 有货主推货主收货群,无货主或货主未配收货群时推仓库客服群(出站仍走 notify.reply,落 wms_inbox_message)
- 文档:methods/system.json 的 setting.warehouse.getSettings/saveSettings 补充该配置字段(版本 0.3.129 -> 0.3.131),
  变更记录新增 2026.09.15-warehouse-pending-receiving-notice / -notice-template(system)、2026-09-15-warehouse-01 / -02(warehouse,事件注册与文案结构);
  AI_METHOD_ROUTING.md 同步刷新(新服务 14 个方法)
- 单测 test/app/service/systems/receiving_pending_notice.test.js(11 用例:开关关闭/未命中提醒时间不执行、超时窗口查询条件、货主群通知、无货主回退客服群、
  当日只提醒一次、推送失败不重复、扫描异常释放锁重试、行数截断、非法配置回退默认、短语变量替换与明细逐行、未识别占位符保留)全部通过;npx eslint 无告警

同时提交上一轮未提交的 camera/PTZ 改动(app/lib/ptz_client.js 新增、systems/camera.js 与 systemMethods/camera.js:PTZ 下发给打印服务时请求体统一携带 cameraId),
其文档与路由清单改动与本提交共用 methods/system.json 等文件,无法按行安全拆分,故合并为一次提交。
2026-09-15 23:49:34 +08:00
liufumingren
e666abc0a2 feat(inbox): 新增出站推送失败自动重推定时任务
新增 app/schedule/retry_inbox_push.js:每 3 分钟扫描「push_status=3 且失败时间在 2 小时内」的
出站消息并重推(config.inbox.pushRetryWindowMs / pushRetryLimit,单轮默认 20 条、硬上限 200),
成功即停、失败下一轮继续、超出窗口不再补推;worker 单进程执行 + app._inboxPushRetryRunning
重入锁,scanned>0 才写日志。

- inbox.message 新增 retryFailed():按 created_at ASC 逐条串行重推(先补更接近窗口边界的),
  缺 warehouse_id/group_id/group_name/content 的记录跳过并告警,retry_count 递增仅作观测
- inbox.message 新增 _repush():复用原记录重推(reuse_message_id),ext_id 剥离 sys:ack: 前缀,
  有用户信息走 ai_reply、系统通知走 system;重推期间不改记录状态,进程中断时下一轮仍能扫到
- processor.writeOutboundReply 支持 reuse_message_id:重推时跳过按 sys:ack:{ext_id} 查建记录,
  推送结果回写到原记录本身,修复系统通知(sys:notice:*)重推会另建记录、原记录状态永远停留在
  失败/待推送的问题;状态回写由 ext_id 改为按记录 id(对既有调用路径等价)
- 手动重推 retry() 改走 _repush,入参与响应文案不变,methods/system.json 无需变更

失败主因是桥接离线(回调 HTTP 200 但 body code=503:wx offline / qiwe offline),属可自愈的
临时故障;此前仅支持人工单条重推,生产已积压 2441 条未送达的客户回信与系统通知。

单测 test/inbox/retry_inbox_push.test.js 18 例(纯 mock,覆盖调度配置/重入/异常兜底/扫描条件/
窗口与上限/复用原记录/跳过与容错);AI_METHOD_ROUTING.md 方法清单已刷新(inbox/message.js 7 → 9)。
2026-09-15 22:38:38 +08:00
liufumingren
74e53d4d87 feat(order): 新增配送表超期订单归档到历史表定时任务
- 新增 systems/orderDeliveryArchive(app/service/systems/order_delivery_archive.js):
  把 wms_order_delivery_{仓库}_dispatch 中 dispath_time 距今超过 3 个月、或 create_at
  距今超过 4 个月的订单(不限状态)归档到 _history 分表;dispath_time 为 NULL 的存量
  订单不特殊处理,SQL 三值逻辑下自动由 create_at 条件兜底
- 单批默认 1000 条、一个事务内完成:写历史表(剔除历史表不存在的
  dispatch_lane/dispath_time、写 archive_time=归档时刻、id 原样复制)→ 同步复制
  wms_order_items_*_dispatch 商品明细(补 archive_time)→ 更新订单索引表
  wms_order_id_location_* 的 location 为 history → 删除源行(先子表后主表),任一步
  失败整体回滚,不产生「历史表有数据但配送表没删」的中间态
- 可续跑 / 防中断:批量提交且提交即删除源行,重跑天然幂等;实际条件列
  (create_at/dispath_time)无索引,故按主键 id 游标取候选、禁用 OFFSET;单批遇
  死锁/锁等待重试 3 次后跳过该批并推进游标(上报 failedBatches/failedCount),
  不中断整轮;单轮时长预算 maxRunMs 用尽即停止本轮,剩余订单下一轮继续
- 历史表已存在同 id 记录(历史残留/人工补数)时不重复写入但仍清理源行,保证重复
  执行结果一致
- 新增 app/schedule/archive_dispatch_orders_to_history.js:默认每日 06:00 单 worker
  执行(cron 可配),Redis SET NX EX 跨进程互斥(进程被杀靠 TTL 释放)+ 批级进度
  缓存 + 执行日志缓存,上一轮 status=running 时按断点续跑
- 新增 config.orderDeliveryArchive 配置:开关/cron/归档门槛月数/单批条数/单仓批次
  上限/单轮时长预算/查询超时/重试次数/锁 TTL
- 本地开发库实测 44 项断言全部通过:字段保真(订单与明细逐列一致、archive_time
  正确、无 dispatch_lane/dispath_time、id 原样复制)、索引表位置更新、源行删除、
  幂等复跑、注入失败整批回滚、单批失败后继续、限额用尽后重跑续传、预算用尽停止、
  无同 id 双写与孤立明细残留;Egg 已正确注册该定时任务
2026-09-15 18:19:57 +08:00
liufumingren
4bf34410a3 fix(report): 报表投递/通知 ext_data 改为透传群配置,避免渠道来源 source 丢失
deliverByChannel 与 sendNotifyIfConfigured 原自行组装 extData={report_definition_id,biz_date,time_point,file_url},覆盖了群配置 ext_data(含渠道来源 source),桥接因缺少 source 无法投递;现统一改为 extData = groupRow.ext_data || null(与 notice 推送口径一致),仅成员推送(无群)显式传 null。
2026-09-15 18:14:43 +08:00
liufumingren
aff7a4fe22 docs(api): 同步 system 接口文档、变更记录与方法路由
- methods/changes/system.json 补 6 条变更记录:
  - returnUnpack.transferByWaybills 新增及入参 waybill_codes → ids(运单表主键)
  - order 各列表补充 create_channel 查询条件说明;修正 pendingOrder/outboundOrder
    默认筛选描述
  - storage.inventory.updateExpiry 新接口
  - workbench.packOrder / finishPack 打包结束复位 OSD
  - order.pendingOrder.syncOrderIds 同步顺序(先回传、成功再扣减)
- methods/system.json 同步上述接口描述
- AI_METHOD_ROUTING.md 重新生成方法清单(order_async / receiving_entry_match /
  return_unpack / storage.inventory / stockout_order / storage.entry /
  wave_batch_closure / workbench 等模块方法数变化)
2026-09-15 16:19:22 +08:00
liufumingren
4d8297aecb fix(openapi): 入库单 ownerCode 补齐到 qimen_owner_code
- OpenAPI 合约上下文的 customerId 恒为 null,导致 API 来源入库单 qimen_owner_code
  为空、出站回传 entryorder.confirm 的 ownerCode 为空
- entryorder.create 改为用报文 entryOrder.ownerCode(trim 后)补齐 customerId,
  落库口径与奇门侧一致(奇门侧取请求上下文 customerId)
- 补充字段生效口径注释:warehouseCode 一律以 app_key 合约解析结果为准,
  operateTime / operatorName 当前未被底层消费,保留仅为兼容调用方
- 同步 methods/openapi.json 与 methods/changes/openapi.json(标准请求/响应 JSON
  示例 + 字段生效口径说明)
2026-09-15 16:19:10 +08:00
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