142 Commits

Author SHA1 Message Date
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
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
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
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
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
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
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
6939d9600a feat: 拦截链路完善与车绑定修复
- 订单表新增 intercept_time 拦截时间字段(迁移覆盖基表与全部分表),全拦截链路写入拦截时间、解除拦截清空

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

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

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

- 同步 methods 文档与变更记录;含 wave_scope 回填、workbench token 过期等前序迁移
2026-09-07 03:48:43 +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
2135f05b49 docs(methods): 同步接口文档与路由表,含拦截锁定、自动分配时间、打包/退回导出、报表群路由、收货货主名称等变更记录 2026-09-03 17:04:03 +08:00
liufumingren
2597faac4c feat(report): stockFlow 报表 9 列新顺序重构与投递货主隔离修复
1) 报表导出列重构为 9 组列(产品名称/条码/外部编码/每日出入库/待处理订单占用数/可用库存/7日总出库数量/推荐采购量/是否触发预警),外部编码 stock_store 优先 fallback,新增 pending_occupy 取仓库主表锁定数量;2) 投递货主隔离修复(上传目录按货主/仓库隔离、投递与通知幂等键含 storeId、processOne 货主维度强校验);3) 文档与 methods 变更记录同步。
2026-09-01 00:42:30 +08:00
liufumingren
b5e5d4d588 feat(storeWarehouse,report,notice,order): 签约导出与代开户备注兜底、报表meta下线、入库完成通知与编码规范化
- storeWarehouse: 货主签约列表异步导出 export/exportTaskProgress(26列中文表头Excel+进度回写);openAccount 代开户未传 store_remask(或传空)时默认取公司全称前50字符填充,保证货主名称在列表/导出中始终有值

- report: 下线 report.meta(破坏性),窗口参数改由 definition.typeList、勾选字段经 definition.list 提供;报表投递目标货主状态放宽为 1/2(正常/审核中);reportDelivery 实体展示名称兼容下划线/驼峰并优雅回退 ID

- notice/order: 入库单完成通知货主(entry_order_completed,固定订阅回退链:收货组→售后组→仓库异常群);入库明细 itemId 规范化(非法值降级按 item_code 精确/归一化条码匹配,剥离中文后缀,多命中报错防错配);库存预警定时任务与 webhook 模型调整

- storage: 快捷直入/入库单基本信息等相关小改(inbound_direct_log、storage/entry、storage/inventory)

- docs: methods/system 0.3.62→0.3.63、openapi/qimen 同步,AI_METHOD_ROUTING 与 report-config-guide 同步,methods/changes/*.json 补变更记录
2026-08-31 17:17:48 +08:00
liufumingren
41bede5391 docs(methods): 同步 system 接口文档至 0.3.58 并追加 21 条变更记录(最新 2026.08.30-report-delivery-plan-copy) 2026-08-30 07:28:43 +08:00
liufumingren
d36a46c5ab fix(order): 取消波次增加拣货状态校验,拣货中/已完成波次禁止取消 2026-08-29 21:04:47 +08:00
liufumingren
54065d7ee1 feat(returnUnpack): 拆包最大录制时长配置(默认5分钟),提交时截断结束时间 2026-08-29 19:44:07 +08:00
liufumingren
15e109f992 fix(notice): 收货通知链路修复(幂等键含事件维度、ext_data 透传、审核模板与收货人行调整、商品编码反查兜底) 2026-08-28 04:42:22 +08:00
liufumingren
a5eba20a5e docs(methods): 同步 system 接口文档至 0.3.37 并追加 5 条变更记录
- order.export 新增 export_columns 导出表头白名单参数
- order.pendingOrder.allocateStorage 修复 allow_storage_location=true 未生效
- storage.entry.quickInbound 支持按绑定收货单交集直入并回写收货单入库状态
- storage.management.replenishmentDemand 新增货主筛选参数与 store_name/barcodes 响应字段
2026-08-27 23:43:41 +08:00
liufumingren
a2dce0d520 fix(order): 订单导出携带产品查询导出失败,导出链路补齐 stock_query 虚拟筛选 2026-08-27 18:02:49 +08:00
liufumingren
f8915a5733 fix(openapi/storage): 修复服务命名冲突、完善导入入库收货单占用与入库单详情字段
- openapi.js 重命名为 openapiEntry.js,消除与 openapi/ 目录同名冲突,恢复 ctx.service.openapi.callback 可用,修复 quickInbound API 回传报 Cannot read properties of undefined (reading 'sendWithRetry')
- 导入/PDA 入库 commit 新增非绑定模式收货单占用:带 receiving_detail_id 的记录优先按明细扣减,剩余导入量按 stock_id 匹配绑定收货单明细占用并回写收货单入库状态
- storage.entry.get 响应新增 total_order_lines / total_quantity / received_quantity 字段
- 同步 AI_METHOD_ROUTING.md 与 methods/changes 变更记录
2026-08-27 17:58:52 +08:00
liufumingren
adb7405396 feat(receiving): 审核通过通知返回 Excel 审核明细下载链接,失败回退正文展示明细 2026-08-26 17:40:49 +08:00
liufumingren
c5477cf6cb feat(order): wave.batchList 支持货主筛选与货主名称展示 2026-08-26 17:24:05 +08:00
liufumingren
fbd9ac2326 feat(receiving): 收货单通知模板调整(车牌/快递单号未登记显示无)并新增完成时未匹配商品货主通知 2026-08-26 17:22:52 +08:00
liufumingren
93c0a620c7 feat(stockout): 出库单操作日志/取消/确认回传与 STOCKOUT 渠道订单同步,workbench 查询与打包状态回写,默认库位配置及权限迁移 2026-08-26 15:35:35 +08:00
liufumingren
b07d7bca33 feat(stockout): 出库单转订单全链路(receiverInfo 落库、出库单默认快递、updateInfo、TRANSFERRED)
- toOrder:create_channel=STOCKOUT、库存锁转移、收货必填校验、同快递/兜底平台、转单后置 TRANSFERRED(禁止一键出库)

- stockout.create:解析 receiverInfo 13 字段落库,快递兜底改用出库单默认快递(stockout_default_express_code,默认 ZT 自提)

- 新增 storage.stockout.updateInfo:收货/地址/快递/平台修改,仅 CREATED/PENDING,收货缺失禁止提交

- 迁移:wms_order_stockout 新增 receiver_* 13 列、order_status 增 TRANSFERRED、source_platform 两列

- 附带:storeWarehouse.createUser、奇门取消订单配送表幂等、express_platform Uint64 打包、方法与变更文档同步
2026-08-25 23:40:42 +08:00
liufumingren
87fad39ba2 feat(returnUnpack): 新增 forceRecord 强制重新录制拆包视频并推送打印服务 2026-08-25 01:07:22 +08:00
liufumingren
c7266c53a8 fix(storage): receivingCompare 多收货单先合并明细再统一对照,修复入库计划数量重复展开 2026-08-24 18:47:41 +08:00
liufumingren
0fe7b724ed feat(storage): 新增 storage.inventory.directPutaway 收货单直入库存接口(一步完成)
- systems/storage/inventory.js#directPutaway:一步写库存并生成入库单(SCRK,直接 COMPLETED)
  - 入库单明细与收货明细一一对应(不合并),按收货明细库位 space_id 入库,批次/效期取收货明细
  - 悲观行锁更新 wms_stock_warehouse 总库存 + 写 wms_storage 库位库存(同键累加)
  - 全量日志:wms_stock_transaction(SCRK)+ wms_storage_transaction(entry_order)+ wms_inbound_direct_log(committed)+ 操作日志(entry_order/storage/stock 三维度)
  - 收货单锁定防重、重复直入 400 拒绝
- systemMethods/storage/inventory.js:注册 directPutaway 入口(_noNeedAuth)
- store_warehouse.js:POLICY_CONFIG_FIELDS 白名单新增 allow_receiving_direct_putaway 开关(修复 getter sanitize 过滤导致开关读不到)
- database/migrations/20260824-add-direct-putaway-permission.js:新增 API 权限记录(幂等,含 down)
- methods/system.json / methods/changes/system.json:接口文档与变更记录

与 quickPutaway(转入库单)并存:转单链路为 quickPutaway→entry.addItem→entry.commit;
直入为 directPutaway 一步完成。两链路开发环境真实接口全量对比(15+ 表)一致。
2026-08-24 03:23:15 +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
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
b3bdb566c4 fix(stock): 修复 warehouse.import 条码不生效,补差异同步 wms_stock_barcodes
- 创建/更新成功后,若归一化 barcode 为非空数组,调用 saveWarehouseStockBarcode 同步条码

- 条码同步失败计入该行 fail_items;未传条码不触发同步,避免误清空已有条码
2026-08-22 17:22:21 +08:00
liufumingren
aacf9c8539 feat(storage): 新增按商品查有量库存接口与库存列表零量过滤
- listByStockId:传入 stock_id 返回 quantity>1 的库存,支持 group_by_space 双模式(逐条明细/按库位汇总)
- 修复 store_stock 关联未按仓库收敛导致同 id 库存行重复返回,统一改用 buildStoreStockInclude
- list/export 基础条件增加 quantity>0,过滤总数量为0的商品或明细行
- list 支持 where.stock_query 虚拟筛选(商品编码/名称/货物编码/条码/SKU ID 模糊匹配)
- 重构 getInventoryList 明细分支:提取 _loadInventoryWarningRanges/_formatBatchStorageRows 复用
- 同步 methods/system.json 与 methods/changes/system.json 文档及变更记录
2026-08-22 01:57:27 +08:00
liufumingren
84929b6904 docs(returnUnpack): 移除订单车道定位变更记录并还原 create 描述
- methods/changes/system.json: 移除 returnUnpack.orderLocationLane 变更记录
- methods/system.json: returnUnpack.create 描述移除顶层 order_items 提及
2026-08-21 23:34:19 +08:00
liufumingren
c77b12be2c docs(storage): 移除 storage.entry 行级数量字段文档与变更记录
- methods/system.json: 移除 storage.entry.list/listStore 的 list[].total_quantity / list[].received_quantity 字段说明
- methods/changes/system.json: 移除 storage.entry.list-row-quantity 变更记录
2026-08-21 23:34:10 +08:00
liufumingren
0dc7e1cd09 feat(stock): stock.warehouse.search 返回新增 images 商品图片列表
- stock_store.search 批查 wms_file_reference(business_type=stock)+wms_file,
  按 display_order 升序注入 item.images,无图片返回空数组(口径与 list 一致)
- 同步更新 methods/system.json response 字段与 methods/changes/system.json 变更记录
2026-08-21 23:07:51 +08:00
liufumingren
f1a487bb06 feat(returnUnpack): 原单 items 顶层透出与订单序列表车道定位
- create 新增顶层 order_items 字段(原订单商品明细,order.items 顶层透出),新建/幂等复用分支返回结构一致,非原单退回为 null
- 原订单详情解析优先按订单 id 序列表(wms_order_id_location_{warehouseId})定位车道(current/history/dispatch/outsourced)直接查分表,未命中再遍历四车道、最后回退基表;修复订单位于 history/dispatch 车道时 create/detail 返回 order=null、order_items=null
- _resolveReturnOrderInfo 原订单兜底查询同步改造(查退回交易单号/快递信息)
- 同步 methods/system.json 与 methods/changes/system.json 变更记录
2026-08-21 23:03:04 +08:00
liufumingren
145fc04022 chore: 移除仓库 webhook 配置并同步接口文档
- 移除 subject_config.webhook_enabled/callback_strategy 配置与校验
- 修正 package-lock 项目名 oms -> wms
- methods 文档同步 searchSpaces/领料/命中数口径/打印合并/手动单归属等变更记录
2026-08-21 02:20:48 +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
29e7b6ae70 docs(order): 订单列表 where 补充 lock_status 筛选说明
- pendingOrder.list 的 where 参数说明补充:未锁定传 lock_status=none,
  已锁定(所有非 none)传 lock_status={operator:ne,value:none}
- 筛选值使用数据库原始枚举 none/warehouse/store 而非响应 Y/N,条件值为空自动忽略
- 补充 2026.08.18-order-list-lock-status-filter-doc 变更记录
2026-08-19 00:00:40 +08:00
liufumingren
ac4222c49a fix(receiving): 收货绑定货主通知按已填车牌/快递单号展示已登记信息
- sendStoreBoundNotice 根据 receiving.license_plate / tracking_number 动态生成
  第三行文案:已填车牌显示已登记信息,均未填写才提示及时补充
- create/bindStore/updateReceivingStats 三个触发点的快照均补充两字段
2026-08-19 00:00:28 +08:00
liufumingren
c5c16a12a2 docs(setting.expressInterface): 补全 update 接口详细入参与响应文档
- params 由 3 个扩展为 31 个全量可更新字段(含 town_name/townName、is_enabled/isEnabled 等驼峰别名与空值处理规则)
- description 补充仅更新传入字段、id 兼容 interface_id/interfaceId、shop_id 同步刷新 token 等说明
- response 按 normalizeInterfaceRow 补全 37 个字段,errors 补充 10 条错误码
- 版本 0.3.28 -> 0.3.29,updatedAt 更新为 2026-08-18,并新增变更记录
2026-08-18 17:11:22 +08:00
liufumingren
3817948b35 feat(order): 锁定订单作业门禁与订单列表 lock_status 转 Y/N
- lock_guard: 新增 isLockedOrderStatus,lock_status 非 none 一律视为已锁定
- 储位分配(allocatePicking)跳过锁定订单,skipped_reason=locked
- 快递分配(createWaybillCodePipeline、wave.batchAllocateExpress)跳过锁定订单并返回 skipped_locked_order_ids
- 抓取波次 singleFetchByIds 排除锁定订单并返回 excluded_locked_order_ids
- 自动加团(delivery_order)锁定订单跳过自动分配快递/储位/自动加团
- 订单列表 normalizeOrderListItem 统一 lock_status 输出 Y/N(none→N,其余→Y)
- 同步 methods/system.json、methods/changes/system.json 文档
2026-08-18 16:25:12 +08:00
liufumingren
591a69d35e fix(notice): 收货通知群路由细化与奇门取消拦截转快递群
- receiving_completed/rejected 只通知仓库收货群,不再通知货主(货主端链接不再生成)
- receiving_reviewed 货主侧三级回退:货主收货群→货主售后群→仓库异常群(sendToWarehouseChannel 支持 fallbackTargets 回退链)
- 新增 receiving_store_bound:收货单创建/首次绑定货主时提醒货主填写车牌号/快递单号,路由同三级回退
- qimen order.cancel 两个拦截分支仅限有运单时创建拦截工单并通知对应快递群,与正常货主发起拦截一致
- 新增 script/backfill-inbox-permissions.cjs:客服/仓库组主管员工回填 inbox 页面与 API 权限(已执行 dev 与线上)
2026-08-17 22:10:47 +08:00
liufumingren
e6f4d9f341 feat(inbox): 处理备注推送货主群、群类型清空接口与群按ID管理
- afterSale.handleWorkOrder: 处理备注发送到对应货主售后群(notifyGroup,内部流程不推),响应 notified_groups
- inbox.group.reset: 新增清空群类型接口(入参群主键ID),权限迁移 556
- 群登记以 group_id 为准: 移除同名群回填,群ID不存在直接新建,store_id/群信息均按 group_id 精确匹配
- changeAddr: 已有工单也把客户原文转发快递群并升级 pending_feedback(仅 pending 可升级)
- handleExpressFeedback: 工单描述售后类型显示中文(订单.物流异常)
- 同步 methods/system.json 与 changes 记录
2026-08-17 22:01:18 +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