45 Commits

Author SHA1 Message Date
liufumingren
9af7dcf8fb feat(storeWarehouse): 签约关系接口配置按货主开放接口落库且回调地址统一取配置
- storeWarehouse.store.saveApiConfig:新增 resolveContractApiInterfaceType,
  interface_type_id=3(OPEN_API_WAREHOUSE 仓库开放接口)自动映射为 2(OPEN_API 货主开放接口)落库,
  不再要求当前主体为仓库(货主可维护自身签约关系下的接口配置)
- callback_url 不再取入参(含 callbackUrl 别名),统一写入 config.openapi.defaultCallbackUrl(新增配置项,默认空)
- storeWarehouse.store.listApiConfig:interface_type_id 过滤同步映射(传 3 按 2 查询)
- 文档:methods/system.json 升级 0.3.350、methods/changes/system.json 变更记录、docs/openapi-callback-events.md 回调地址来源说明
- 测试:saveApiConfig 新增 4 条用例(3→2 落库、忽略入参回调地址、默认值未配置、货主主体可保存、缺失类型 404),listApiConfig 新增 1 条过滤映射用例

同时提交工作区其余在制品改动:
- waybill:移除 wms_order_express_trace 模型并新增 drop 迁移,轨迹查询/取号/打印链路调整
- order:订单 SN 编码(order_item_sn / order_item_sn_log / sn_code_rule、has_sn_item 回填迁移),pendingOrder/recheckOrder/wave/base 调整
- express_platform、order_async、order_export、order_storage_allocation、storage.report、stock_store 配套修复
- lib:新增 jd_client,调整 qimen_client、callback_functions 及配套测试

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-14 17:14:04 +08:00
liufumingren
ef933bc353 feat(panel): 新增 touchLastChangeAt 公共方法,拣货/复核/打包完成时通知大屏刷新(0.3.292) 2026-10-12 23:38:53 +08:00
liufumingren
576eb1b2e8 feat(order): 订单新增包裹总重量 packages_weight(称重回写与各端展示) 2026-09-30 03:08:49 +08:00
liufumingren
0bfc1ab5b2 feat(stock): 商品新增拣货/复核要求与要求合并开关(pick/recheck/merge_requirements) 2026-09-30 03:08:42 +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
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
6939d9600a feat: 拦截链路完善与车绑定修复
- 订单表新增 intercept_time 拦截时间字段(迁移覆盖基表与全部分表),全拦截链路写入拦截时间、解除拦截清空

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

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

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

- 同步 methods 文档与变更记录;含 wave_scope 回填、workbench token 过期等前序迁移
2026-09-07 03:48:43 +08:00
liufumingren
8db3629e2d fix(recheckOrder): 团购批量复核逐单补写订单级操作日志,订单日志列表可见复核记录 2026-09-04 02:15:16 +08:00
liufumingren
25442ba215 feat(storage): 拦截锁定库存改造,拦截确认库存移入 intercept_locked_quantity 不归还可用,可用数量统一口径 quantity-locked-intercept,负库存入库平账冲销 GAP 挂账 2026-09-03 17:00:37 +08:00
liufumingren
705678487d fix(returnUnpack): 拆包视频拼接 CDN 域名,商品复核字段透出与缓存失效修复
- returnUnpack: list/detail/videoList/queryByWaybill 输出 videos[].video_url 自动拼接
  http://w{warehouseId}-c{recordingComputerId}.o.gztbyc.com{path},与 order.packing 同口径
  (录制电脑从 wms_print_computer 按 is_recording=true 获取,无录制电脑时保持原始相对路径)
- recheckOrder: scanOrder/scanTask 报文 stock 明细新增 need_recheck 字段(缺省 Y)
- stock: getStockDetails 双实现透出 need_recheck;saveWarehouseStock/handleBatchChange 更新成功后
  显式清除商品详情缓存(bulk update 不触发实例级 afterUpdate hook,修复旧缓存被持续读取)
- delivery_order: 订单创建时间统一取服务器当前时间,不采用报文 createTime,避免被平台上报时间覆盖
- 同步 methods/system.json 文档与 methods/changes/system.json 变更记录
2026-08-23 22:13:33 +08:00
liufumingren
a499298670 fix(order): 复核共享条码判定收窄到订单货主并过滤失效商品
- has_shared_barcode 判定范围从全仓库改为订单 store_id 维度(wms_stock_warehouse.store_id)
- 排除已删除(delete_at/deleted_at 非空)与弃用(is_valid≠'Y')的商品资料
- 跨货主同码不再提示;无货主(store_id<=0)订单不做共享判定
2026-08-23 14:30:41 +08:00
liufumingren
ace0e456a7 feat(order): 订单列表联查波次序号副表并支持序号范围筛选
- 所有订单列表联查 wms_order_wave_index 输出 wave_index(9 个工作台列表/复核散单列表/波次策略兜底列表,无记录降级 0)
- 新增 wave_index 虚拟筛选入参:between/eq/in/gt/lt/ge/le/notbetween,between 要求 value 为长度 2 的数组;复核散单列表支持 wave_index_min/wave_index_max
- 订单导出(waybill/item 模式)接入 wave_index 联查并新增波次序号列
- 新增 app/model/order_wave_index.js 副表模型
- 同步 methods/system.json 接口说明与 methods/changes/system.json 变更记录
2026-08-19 03:23:50 +08:00
liufumingren
bfbe231ff2 feat(order): confirmIntercept 改为 ids 批量确认拦截
- 入参由单值 order_id 改为批量 ids(数组/逗号字符串,兼容 id/order_id/orderId 单值写法)
- 仅拦截发起中状态(requested/requesting/intercepting,历史值 intercepted 兼容)允许确认;none 静默跳过,已确认拦截及其它非可确认状态记录 failed
- 更新 SQL where 同步限定 intercept_status 白名单,防止查询后状态被并发修改导致误更新
- 售后工单+快递群通知改为按成功订单 ID 汇总后统一调用一次
- 返回 success/failed 列表与 success_count/failed_count;同步更新接口文档与变更记录
2026-08-19 03:22:44 +08:00
liufumingren
110d0685ee fix(order): 团购解绑车改为任务全波次复核/打印完成才触发
- 复核侧:_resolveTaskIdByWaveFallback 由单波次订单复核检查改为任务下
  全部关联波次订单 recheck_status 均完成才返回 taskId,避免复核一个波次
  即解绑 wms_pick_task_cart_binding 并误将任务置为已完成
- 打印侧:tryUnbindCartAfterPrintComplete 团购(pick_mode 1/5)改为按任务
  全波次订单 print_status 检查,全部打印完成才解绑;散单保持任务订单维度检查
2026-08-19 00:00:23 +08:00
liufumingren
0392902414 fix(order.recheckOrder): 车号扫描快照兜底过滤已解绑任务
- 兜底查询新增 NOT EXISTS 过滤:该车号下存在解绑记录(unbind_time 非空)的任务不再回退命中
- 绑定表保持权威数据源语义,解绑即失效;快照数据不清除,兼容无解绑记录的历史数据
- 生产库 car04 验证:新查询 0 命中(原查询命中已完成任务 3416)
2026-08-17 22:04:58 +08:00
liufumingren
a8200a3a35 feat(order): 订单拦截全链路阻断与作业排除
- 新增 app/lib/intercept_guard 共享守卫:除 none 外所有拦截状态一律视为已拦截
- 分配波次(singleFetchByIds)/抓取波次(createWavePickTask) 排除拦截订单并回传清单
- 分配储位(allocatePicking)/分配快递(createWaybillCodePipeline、batchAllocateExpress) 跳过拦截订单并回报
- 打印组装(getWavePlatformPrintData/getOrderPrintData/getPrintDataByWaybillCodes) 剔除拦截订单,打印回写/波次反查/标记均排除
- 拣货完成(wavePickTaskComplete) 拦截报错;复核(assertOrderCanRecheck/批量快捷复核) 补全拦截状态
- 打包/称重(workbench、order.updateExpressWeighingWeight) 拦截阻断,波次批量操作排除拦截单
- 绑定包材(order_express) 拦截阻断,波次批量绑定排除拦截单
2026-08-17 21:58:43 +08:00
liufumingren
3ba87b4baa fix(order): 拦截操作日志 businessId 误写仓库ID,改为订单ID,修复订单详情查不到拦截日志 2026-08-15 23:19:49 +08:00
liufumingren
75ac14a4ab fix(order.recheckOrder): 团购复核输出拦截订单序号,修正 intercept_status 识别(B2026080700003) 2026-08-15 18:25:43 +08:00
liufumingren
d25ea39e87 fix: 库内拦截扫描严格校验,非拦截订单直接拒绝且不再补建缺失运单 2026-08-13 21:42:58 +08:00
liufumingren
f4ed985556 feat: 新增退回收到模块(returnReceived)
- 新增退回收到登记表 wms_return_received 及模型、建表迁移
- 新增扫码登记/列表/详情/删除接口(systemMethods + systems 分层)
- 退回收到联动:标记运单 is_back、完结拦截工单、订单退回状态、操作记录
- 新增权限 527/528/529 + 菜单 530,授权仓库/客服角色
- 解除拦截不再清除 is_back(由退回收货流程单独管理)
- 同步 API 文档、method 路由速查
2026-08-13 01:58:55 +08:00
liufumingren
c84d5ac4ae feat: 库内拦截确认同步推进订单 step=4 + outbound_status=fin
confirmIntercept + interceptScan 确认拦截后:
- step = 4(配送中)
- outbound_status = 'fin'(出库完成)
- intercept_status = intercepted_at_warehouse
2026-08-12 23:35:38 +08:00
liufumingren
793dca8375 fix: confirmIntercept 同步设置 is_intercept=Y + is_back=Y 到所有运单
之前 confirmIntercept 仅对 is_intercept=Y 的运单设 is_back=Y,
但 confirmIntercept 入口不经过 AI 波次感知,运单可能未被标记拦截,
导致确认拦截后运单表标记不生效。
改为订单级统一设置 is_intercept+is_back,覆盖所有运单。
2026-08-12 22:52:37 +08:00
liufumingren
b436b6dd9e feat: 拦截链路全流程完善 — 新增interceptScan + 运单表同步 + 工单通知
新增:
- order.recheckOrder.interceptScan: 拦截扫描接口,入参运单号,查express标记退回,处理工单,更新订单拦截状态
- afterSale.createInterceptWorkOrdersAndNotify: 共享方法,幂等创建工单+通知快递群

修复:
- confirmIntercept: 补运单is_back同步(仅限is_intercept=Y),补工单创建+通知
- batchIntercept: 补运单is_intercept同步,补工单创建+通知
- batchUnintercept: 补运单is_intercept/is_back清除
- Qimen/OpenAPI cancel: 补运单is_intercept同步,补工单创建+通知
- interceptScan: 删除死查询,加空指针兜底

文档:
- methods/system.json: interceptScan + confirmIntercept 完整API文档
- methods/changes/system.json: 变更记录
2026-08-12 20:47:19 +08:00
liufumingren
c25dffe884 feat(pick): 先拣后分散单拣货模式支持 - box_no按库位排序并按stock_id分组创建框 - picking_details和scanOrder按stock_id映射box_no - singleFetchByIds波次默认先拣后分模式 2026-08-06 17:38:49 +08:00
liufumingren
7ab67b239a feat: 订单列表新增 stock_query 商品模糊查询条件
所有订单列表接口支持通过 where.stock_query 进行商品维度的模糊筛选:
- 模糊匹配 stock_warehouse 的 item_code(商品编码)、item_name(商品名称)、id(主键)
- 模糊匹配 stock_barcodes 的 barcode(条码)
- 通过 order_items 关联查找匹配的订单 ID 并过滤订单列表

涉及方法:
- base.js: listByModule(覆盖 9 个订单列表入口)
- wave.js: groupOrderFetchList / singleOrderFetchList / waveStrategyFallbackOrderList
- recheckOrder.js: queryRecheckOrderSingleList / queryRecheckOrderGroupList
2026-08-05 22:46:58 +08:00
liufumingren
b9fe9e774c fix: 拣货完成扣减库存事务漏洞 - picking查询添加FOR UPDATE行锁
- recheckOrder._completePickForOrder: picking查询添加FOR UPDATE,防止并发重复扣减
- pick_compensation.compensateInTransaction: 同上
- pick_compensation.releaseCancelledInTransaction: 同上

与主路径 wavePickTaskComplete 保持一致的双重行锁防护(picking FOR UPDATE + storage LOCK.UPDATE)
2026-08-04 16:02:27 +08:00
liufumingren
da4208707d fix: 修复自动分配快递时 warehouse_id 上下文丢失导致 FK 约束失败及平台解析异常
- express.js: createWaybillCode 优先使用传入的 warehouse_id,修复 setImmediate 后 ctx.user 丢失导致 wms_order_express.warehouse_id 外键约束失败
- delivery_order.js: asyncProcessOrderCreated 中平台/快递解析逻辑修正
- recheckOrder.js: 复核单快递分配状态判断优化
- express_platform.js: 快递平台自动同步回传链路修正
- order_async.js: 奇门异步下单上下文增强
- polo_api_client.js: PolyAPI 客户端微调
2026-08-02 22:40:58 +08:00
liufumingren
bd6013d7b8 fix(order): 拣货/波次/复核/打包/自动出库修复与增强
- pick.js: 修复拣货车绑定逻辑,禁止已绑定任务直接换车
- wave.js: 修复波次拣货车查询(移除 current_task_id)
- recheckOrder.js: 新增 batchQuickRecheckByWave 按波次批量快速复核
- order_packing.js: 时间字段统一格式化输出
- order_auto_outbound.js: 修复仓库去重逻辑
2026-08-01 03:45:06 +08:00
liufumingren
000597fecc fix(order.recheckOrder): waybill_code 加入散单复核列表响应字段 2026-07-27 17:46:42 +08:00
liufumingren
b2ae5683e1 feat(order): 波次/拣货/复核透传货主信息 + 取消订单过滤
- wave: 透传 store_id/owner_code/store_remark

- recheckOrder: 波次视图新增 store_id/store_remark,批量查询货主备注

- pick: 分组聚合透传 store_id/owner_code/store_remark/stock

- order_storage_allocation: 储位分配注入 stock_id + 回传排除取消订单

- order_async: 标记异常排除取消状态订单
2026-07-27 03:48:45 +08:00
liufumingren
52aa76af60 fix: OrderExpress 查询添加仓库隔离 + workbench 业务增强
- _queryOrder: OrderExpress 查询增加 warehouse_id 过滤,避免跨仓库数据泄露
- _queryOrder: 新增订单商品明细查询,关联 stock 详情(带缓存)
- _packOrder: 同一工作台新任务进入时自动关闭上一个未结束任务
- order_packing.js: quickWhere 运单号查询增加 warehouse_id 过滤
- recheckOrder.js: getWaveOrdersBasic 运单查询增加 warehouse_id 过滤
- order_print.js: queryOrderExpressByOrderIds 增加 warehouseId 参数
- waybill.js: toOrder 运单查询在用户已登录时增加 warehouse_id 过滤
2026-07-21 20:53:53 +08:00
liufumingren
2817d17fc7 1 2026-07-06 00:33:12 +08:00
liufumingren
5d7964132e 1 2026-07-03 16:56:39 +08:00
liufumingren
5ef99e3bed 1 2026-07-01 14:00:59 +08:00
liufumingren
e7fcd2549e 20260625 2026-06-25 02:01:59 +08:00
liufumingren
569a25390f 1 2026-06-24 07:36:43 +08:00
liufumingren
77435aeb79 1 2026-06-23 18:48:33 +08:00
liufumingren
d743e67b9d 1 2026-06-17 01:18:55 +08:00
liufumingren
025184904a 1 2026-06-14 19:03:58 +08:00
liufumingren
43c60dd934 1 2026-06-09 14:12:02 +08:00
liufumingren
0e50ff6671 1 2026-06-08 08:58:13 +08:00
liufumingren
c2b5ffc319 1 2026-06-07 20:42:24 +08:00
liufumingren
150e2977d4 修改快递接口配置,拼多多取号,未完成 2026-05-22 08:39:07 +08:00
liufumingren
8cf2c5befa 1 2026-05-20 16:31:29 +08:00