67 Commits

Author SHA1 Message Date
liufumingren
4bf3268596 feat(workbench): 大团购打包系数与打包时长闸门,packOrder/queryOrder 响应新增 wave_scope 与倒计时字段
- 仓库设置新增 big_group_pack_coefficient(数字,默认 3,单位秒/单):store.js 默认值与归一化校验、setting.warehouse 字段元信息(type=number、min=0.1)

- workbench.queryOrder:响应 order 新增 wave_scope;当前工作台 wave_scope=1 打包任务未到「打包数x系数」秒时扫描其他波次订单返回「打包时长不足」,本波次放行,已到时不受限;闸门按 wms_pack_task.wave_scope=1 快捷判定

- workbench.packOrder:wms_pack_task 落库 wave_scope(服务端复查,非法/缺省兜底订单行值);响应新增 pack_wait_seconds(当前波次打包数x系数)与 pack_start_time(毫秒时间戳),仅 wave_scope=1 下发,其他为 0

- 迁移 20260924150000-add-wave-scope-to-pack-task.js:wms_pack_task 新增 wave_scope 列(幂等;开发与生产均已执行,生产因存在更早 pending 迁移改为等价 DDL+SequelizeMeta 记录)

- 测试:新增 workbench.bigGroupTimeGate.regression.test.js(11 用例全绿);workbench.queryOrder.performance.test.js 与基线一致(8 pass / 6 既有失败,非本次引入);ESLint 通过(workbench.js 历史类字段 parse error 为既有问题,与基线一致)

- 文档:methods/system.json 升至 0.3.181、changes 新增 2 条记录;已全量导入库表(wms_api_method_doc/wms_method_doc_meta)后重新导出,恢复 3 条库表已有但文件缺失的 setting.warehouse 前端配置方法
2026-09-24 03:16:35 +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
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
6701e661c5 feat(order): 拣货任务列表支持按拣货车编码 cart_code 查询 2026-09-10 23:52:43 +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
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
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
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
b64ba0b00b fix(storage.receiving): 收货单货主名称实时解析,store_remask 优先、company_name 兜底,修复约 26% 历史数据快照为空问题 2026-09-03 17:03:44 +08:00
liufumingren
007babb6c6 fix(order): 订单详情兜底查询,配送表查空回退待处理表,待处理详情固定先查 dispatch 再兜底 current,避免表位流转后详情落空 2026-09-03 17:00:53 +08:00
liufumingren
d36a46c5ab fix(order): 取消波次增加拣货状态校验,拣货中/已完成波次禁止取消 2026-08-29 21:04:47 +08:00
liufumingren
4ddcbe60a4 feat(order): 取消订单事务原子化,储位分配支持允许受限库位 2026-08-27 23:41:54 +08:00
liufumingren
51f6b27d6a fix(qimen): itemId 非主键时降级按 item_code 查找商品,修复奇门推单误报未同步推送到仓库 2026-08-25 13:09:53 +08:00
liufumingren
763573ee41 feat(wms): 拦截订单门禁豁免、波次号原子取号、打印自定义区数量、拆包视频与商品复核字段
- pick: waveClaimScan 拦截订单整体跳过领料(不置 claim_status=fin,未打印不阻隔领料);query 领料前置校验仅统计非拦截未领料订单(拦截未领料不阻隔拣货);createWavePickTask 新增 excludeUnclaimed,普通波次(source=0)计算拣货数量(order_count/任务订单/筐)时剔除未领料订单
- wave: 波次号改为 wms_number_sequence 原子取号(upsert + LAST_INSERT_ID,seed 对齐当日历史最大序),wave_no 唯一索引 uniq_wave_no,并发撞号自动重取(最多 3 次)
- print: 面单自定义区首行「商品总数【n】」(items_total 优先),团购波次商品明细行尾「波次总单数×商品数量」
- returnUnpack: 列表新增 has_video/video_enable/videos 视频字段与筛选,补视频列表权限迁移
- stock: 商品新增 need_recheck(是否需要复核)字段,导入归一化与导出列支持,补迁移
- docs: 同步 methods/system.json 与 methods/changes/system.json 变更记录(恢复遗漏的已提交记录)
2026-08-23 14:31:49 +08:00
liufumingren
37b9a3d30d fix(express): polyapi 取号订单ID改 Hex16 提交并回传解码,修复 ESLint
- object_Id/orderno 中 order.id 改为 16 进制编码,缩短订单唯一标识字符串

- 失败项/各平台成功回写分支按 parseInt(x,16) 解码回十进制,保持落库与映射兼容

- 修复本文件 31 处 ESLint(空格/引号/注释等),纯格式不涉及业务逻辑
2026-08-22 17:22:27 +08:00
liufumingren
232985a272 feat(wave): 策略命中数按同快递拆分统计与退回原因中文标签
- getWaveStrategyMatchedOrderCountFilteredMap 改收策略行并按 require_same_express 拆分计数,
  同快递策略按 items_hash+快递分组, 与抓取候选 SQL 口径一致, max_same_structure<=0 视为不设上限
- waveStrategyFallbackOrderList excluded_reason 改中文标签, 兼容 lock_status 归一化 Y/N 与原始值
2026-08-21 02:20:07 +08:00
liufumingren
943a20f582 fix(print): express 打印组件解析支持系统平台编码回退
- 淘宝 TB/天猫 TM/1688/TGC 等系统平台编码未在 wms_print_platform 直接匹配时,
  经 wms_platform.print_platform_id 回退解析 wms_print_platform.platform_name
- 移除 loadExpressPlatformComponents 调试 console.log,改走 ctx.logger.info
- 新增 TB 回退解析成功与无映射失败的单元测试
2026-08-18 23:59:11 +08:00
liufumingren
d0621dd4ec fix(order): 已取消订单跳过分配储位与分配快递
- order_storage_allocation: allocatePicking 过滤循环校验 status=cancel,已取消订单跳过并记 skipped_reason=order_cancelled,不再锁库存写 picking
- express: createWaybillCodePipeline step1 的 current/dispatch 查询排除 status=cancel,createWaybillCode 事务内再次剔除取消订单(不标记异常、不写失败日志、不取号)
- 新增回归测试:分配储位跳过取消订单、分配快递流水线跳过取消订单
2026-08-17 02:07:29 +08:00
liufumingren
7ad08e488d feat(notice): 统一通知仓库接口通道与订单同步通知去抖
- warehouseNotify: 按固定群订阅经 wms_api_app 回调推送(MD5 验签),消息表登记+失败重试
- notice: 货主群缺失时降级发仓库异常群(前缀标记失败),合约停用/已解除货主不发货主群也不降级
- order_async: 订单同步通知 3 分钟去抖合并,Redis 队列+定时冲刷+失败重试
- receiving: 收货完成/驳回/审核通知走仓库通道,仓库/货主侧文案分离
- storage/inventory: 移除移库完成群通知(事件码保留,库存余量提醒仍复用)
- 新增 debug:warehouse:push-receiver 调试接收服务与文档/变更记录
2026-08-17 02:03:34 +08:00
liufumingren
98bc088929 feat: 仓库配置新增收货地址 receiver_address,inbox 售后群新增工单登记/改地址/核实签收/改快递/查询仓库地址函数 2026-08-14 15:29:59 +08:00
liufumingren
358fef0f71 chore: apply ESLint auto-fixes, JSDoc additions, and CRLF→LF normalization (no logic changes) 2026-08-08 20:28:18 +08:00
liufumingren
5378fcd137 refactor(print): 打印模块重构
- 新增 systems/order_print.js 订单打印业务层(getPrintDataByWaybillCodes 等)
- print.js 删除 retry 补偿相关代码(normalizeRetrySendPayload/getRetryEligibility)
- order/print.js 新增 getPrintDataByWaybillCodes 方法
- printer_data_builder.js 新增 appendExtraCustomLines + extraCustomLines 参数支持
- polo_api_client.js 添加调试缓存
- 删除 print_retry_compensation 定时任务测试
2026-08-01 03:44:53 +08:00
liufumingren
19f0449992 fix: 手工运单号防误删三层防护 + 操作日志businessId修正
1. hardDeleteWaybillAsyncOrderExpressRows 加 status:0 过滤,保护手工录入 status=1 记录
2. createWaybillCodePipeline 入口跳过 business_key=1 且已分配运单的订单
3. manualWaybill 操作日志 businessId 从仓库ID 修正为订单ID String(orderId)
4. 新增 14 个单元测试,全部通过
2026-07-07 17:06:43 +08:00
liufumingren
2817d17fc7 1 2026-07-06 00:33:12 +08:00
liufumingren
7854057244 chore: ESLint auto-fix formatting (JSDoc, spacing, quotes, line endings) 2026-07-04 23:30:32 +08:00
liufumingren
34273c166b 1 2026-07-02 22:08:47 +08:00
liufumingren
5ef99e3bed 1 2026-07-01 14:00:59 +08:00
liufumingren
77435aeb79 1 2026-06-23 18:48:33 +08:00
liufumingren
025184904a 1 2026-06-14 19:03:58 +08:00
liufumingren
0e50ff6671 1 2026-06-08 08:58:13 +08:00
liufumingren
99367e5043 1 2026-06-06 05:15:46 +08:00
liufumingren
4beefcd22c feat(print,docs,migrations): add notifyLock, order export, express fields and related docs
notifyLock method + logs

print.send logs

order export methods + docs

express model fields SPH/XHS/DW/JD + migration

platform_shop_id migration

notifyLock docs

order export docs
2026-05-30 17:30:17 +08:00
liufumingren
abf2c4d94a 1 2026-05-29 16:47:38 +08:00
liufumingren
dc4894cb6d 1 2026-05-25 17:08:56 +08:00
liufumingren
150e2977d4 修改快递接口配置,拼多多取号,未完成 2026-05-22 08:39:07 +08:00
liufumingren
8cf2c5befa 1 2026-05-20 16:31:29 +08:00
liufumingren
b629b59d4b fix(print): callback sync order print_status by order_ids 2026-05-20 04:55:16 +08:00
liufumingren
9fca81e7b5 1 2026-05-19 16:33:58 +08:00
liufumingren
1d70c01631 1 2026-05-17 22:59:57 +08:00
liufumingren
cd01be6fbd 收货部分更改 2026-05-17 21:51:46 +08:00
liufumingren
e23bf4f15e 1 2026-05-17 03:23:57 +08:00
liufumingren
adb1a16599 1 2026-05-16 23:00:49 +08:00
liufumingren
9845a239e2 1 2026-05-16 02:44:53 +08:00