177 Commits

Author SHA1 Message Date
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
6a71957686 feat(pick): 大团购任务 pick_mode 修正为 5,波次/订单/拣货任务表新增领料人与抓取人字段,领料人非本人拦截重领并覆盖 2026-09-04 21:43:05 +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
6354a6d8dc fix(stockTransaction): keyword 无匹配商品时条件置空防全表查询流水,货主模式列表补充 mode=store 入参 2026-09-03 17:03:56 +08:00
liufumingren
716af0b9ff feat(returnReceived): 退回收到列表异步导出,分页拉取流式生成 Excel 上传 COS,复用 list 查询语义并强制仓库隔离 2026-09-03 17:03:40 +08:00
liufumingren
bc0d62d297 feat(workbench): 工作台绑定码登录,新增 login_code/token 字段与索引,扫码绑定生成 token,token 免登录获取工作台信息,敏感字段查询脱敏 2026-09-03 17:03:30 +08:00
liufumingren
5dafbefa34 feat(order): 打包任务列表异步导出并新增 warehouse_id+create_time 复合索引,默认列表与导出消除 filesort 慢查询 2026-09-03 17:01:05 +08:00
liufumingren
afef298014 fix(wave): 波次复核统计字段改用 recheck_status 替代 inspection_status,修正复核完成/异常/未复核计数口径 2026-09-03 17:01:01 +08:00
liufumingren
007babb6c6 fix(order): 订单详情兜底查询,配送表查空回退待处理表,待处理详情固定先查 dispatch 再兜底 current,避免表位流转后详情落空 2026-09-03 17:00:53 +08:00
liufumingren
25442ba215 feat(storage): 拦截锁定库存改造,拦截确认库存移入 intercept_locked_quantity 不归还可用,可用数量统一口径 quantity-locked-intercept,负库存入库平账冲销 GAP 挂账 2026-09-03 17:00:37 +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
3442ed5243 fix(order): 波次取号原子性修复 2026-08-30 07:28:17 +08:00
liufumingren
2189911073 fix(order): 运单号检索优化(分段后缀剥离等值匹配、短词禁降级、数组精确匹配) 2026-08-30 07:28:12 +08:00
liufumingren
05177d00f7 feat(returnUnpack): 拆包单异步导出 2026-08-30 07:28:08 +08:00
liufumingren
0a54f8028b feat(inbox): 站内信分组快速列表与多群成员聚合,支持 groupIds 数组入参 2026-08-30 07:28:05 +08:00
liufumingren
3100bddce1 feat(report): 配置驱动通用报表与货主定时投递,Excel 文本列落地与成员级通知推送 2026-08-30 07:28:01 +08:00
liufumingren
d36a46c5ab fix(order): 取消波次增加拣货状态校验,拣货中/已完成波次禁止取消 2026-08-29 21:04:47 +08:00
liufumingren
d6d7b23f52 feat(order): 订单导出支持并发分页查询、多sheet续写、表头列白名单与上传大小上限 2026-08-27 23:42:22 +08:00
liufumingren
4ddcbe60a4 feat(order): 取消订单事务原子化,储位分配支持允许受限库位 2026-08-27 23:41:54 +08:00
liufumingren
59eb736740 feat(storage): 补货需求支持货主筛选并补充货主名称与SKU条码,快捷直入按绑定收货单截断并回写入库状态 2026-08-27 23:41:47 +08:00
liufumingren
c5477cf6cb feat(order): wave.batchList 支持货主筛选与货主名称展示 2026-08-26 17:24:05 +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
c047dccd2e docs(returnUnpack): 拆包登记商品识别参数说明更新 2026-08-24 18:47:44 +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
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
f2d1ed0849 fix(order): 异步链路显式传递仓库上下文,避免 Qimen 无登录用户静默失败
- pendingOrder/orderStorageAllocation: 优先取显式传入的 warehouse_id,缺失时回退 getWarehouseId

- deliveryOrder: buildExpressAllocateRequest 携带 warehouse_id,并补充自动分配开关判定日志
2026-08-22 17:22:46 +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
6d33210624 fix(storage): 修复库存/商品列表按数量等字段排序不生效
- stock.warehouse.list: 透传 sort 参数给 getWarehouseStock(此前漏传,后端始终按 id DESC 排序,quantity/available_quantity 等排序字段均无效)
- systems/storage/inventory getInventoryList/exportInventoryList:
  - 汇总模式(按 stock_id 合并)order 原写死 last_inbound_time,现支持按聚合别名排序:quantity/locked_quantity/available_quantity/batch_count/first_inbound_time/last_inbound_time/production_date/expiry_date,其余回退 last_inbound_time
  - 明细模式新增真实列白名单,非法字段回退默认列,避免 SQL 报错/注入
  - sortOrder 统一归一化为 ASC/DESC,分页兼容 currentPage
2026-08-21 23:23:06 +08:00
liufumingren
bb676f941e fix(pendingOrder): 修改订单平台补充逐单订单日志
- updateOrderPlatform 更新前查询候选订单并筛出平台实际变化的订单
- 为每个受影响订单写入 business_id=订单ID 的 ORDER_UPDATE_PLATFORM 订单日志
- 保留原仓库级操作日志,逐单日志写入失败仅告警不影响业务
2026-08-21 22:55:01 +08:00
liufumingren
fe97adfda2 feat(space): 批量库位搜索 searchSpaces
- space.js 抽取 _searchByKeyword, searchSpace 与 searchSpaces 共用同一查询口径
- searchSpaces 按 keywords 并行查询并保持传入顺序, 无记录项返回空数组
- index.searchSpaces 加入免权限/免鉴权白名单
2026-08-21 02:20:43 +08:00
liufumingren
60b4babb34 feat(order): 订单列表与导出支持波次范围 wave_scope 筛选
- extractWaveScopeVirtualFilter 解析 wave_scope(0=未分配波次/1=团购/2=散单)
- buildWaveScopeWhereCondition 经 wms_wave_batch 反查波次ID注入条件
- list 与 order_export 均接入该虚拟筛选
2026-08-21 02:20:13 +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
d4dc25c8e7 feat(pick): 整波领料 waveClaimScan 与拣货领料前置校验
- 新增 pick.waveClaimScan: 扫面单号定位订单并反查波次, 仅普通波次(source=0)支持整波领料
- 新增 getWavePickModeByWaveId 关联拣货模式查询
- query 命中大团购/非抓取散单波次时校验领料状态, 未领料提示先整波领单
- 波次存在未打印订单时禁止领料, 领料写入 ORDER_WAVE_CLAIM 操作日志
2026-08-21 02:20:02 +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
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
aaadce25af fix(order): 修复批量锁定/解锁操作日志 businessId 误写为仓库ID
runBatchLockTask/runBatchUnlockTask 写入 ORDER_LOCK/ORDER_UNLOCK 日志时
businessId 误用 logWarehouseId,导致订单详情按 business_id=订单ID 查询
查不到锁定/解锁日志,现改为 orderId 与拦截/解除拦截保持一致
2026-08-18 23:55:39 +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
0392902414 fix(order.recheckOrder): 车号扫描快照兜底过滤已解绑任务
- 兜底查询新增 NOT EXISTS 过滤:该车号下存在解绑记录(unbind_time 非空)的任务不再回退命中
- 绑定表保持权威数据源语义,解绑即失效;快照数据不清除,兼容无解绑记录的历史数据
- 生产库 car04 验证:新查询 0 命中(原查询命中已完成任务 3416)
2026-08-17 22:04:58 +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
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
d5c5c641d2 feat(packing,waybill): 列表时间筛选统一为 between 区间写法,兼容旧拆分字段 2026-08-16 17:42:08 +08:00