234 Commits

Author SHA1 Message Date
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
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
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
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
d5c5c641d2 feat(packing,waybill): 列表时间筛选统一为 between 区间写法,兼容旧拆分字段 2026-08-16 17:42:08 +08:00
liufumingren
2e417f1c27 feat(waybill): 运单导出新增 where.ids 入参,支持按勾选运单ID导出快递号 2026-08-16 15:53:10 +08:00
liufumingren
e72274f222 fix(inbox): 群类型切换时清理残留货主/快递专属字段,快递群原文转发仅发原文 2026-08-15 23:19:52 +08:00
liufumingren
3ba87b4baa fix(order): 拦截操作日志 businessId 误写仓库ID,改为订单ID,修复订单详情查不到拦截日志 2026-08-15 23:19:49 +08:00
liufumingren
e5196dc1ea feat(pack): 打包任务最大时长约束与自动结束
- 仓库设置新增 single_order_pack_max_minutes(默认3)/group_order_pack_max_minutes(默认40) 配置
- 新增每小时定时任务扫描未结束打包任务,超时自动结束(end=start+上限)
- 结束时间统一截断为开始时间+上限时长(finishPack/新任务顶替/setEndTime 接口)
2026-08-15 23:12:51 +08:00
liufumingren
f127853592 fix(shops): 视频号授权允许回调地址为空,透传 appId/toUserName,超时调至 15s 2026-08-15 20:12:26 +08:00
liufumingren
2e95fb19d4 perf(query): 运单定位优先序列表直查,减少三表循环扫描 2026-08-15 20:12:26 +08:00
liufumingren
37104079e5 feat(order): 订单/明细 id 防回退——序列表唯一发号 + 分表免重建 + 水位自愈 + 迁移任务执行历史 2026-08-15 20:12:23 +08:00
liufumingren
0eb9e845dd fix(inbox): 函数执行前按群类型校验可用性,拦截货主群越权调用快递群函数 2026-08-15 20:10:37 +08:00
liufumingren
18d33ec645 feat(order.pendingOrder.parseAddress): 支持数组批量入参批量解析,模型切 v4-flash,50 条并行块解析实测 31.6s
- 入参兼容 address 字符串(单条)/address 数组/addresses 数组(批量,上限 50)

- 批量按每 10 条合并一次请求并行发出,Promise.all 聚合按输入顺序返回,失败条目逐条回退单条解析

- 模型 deepseek-v4-flash(仅 parseAddress 内使用,不改全局配置),超时 60s/块 120s

- extractJsonBlock 支持数组 JSON 截取;新增手机号/姓名清洗与正则省市区最终兜底

- 同步 methods/system.json 文档(v0.3.28)与变更记录
2026-08-15 18:27:21 +08:00
liufumingren
75ac14a4ab fix(order.recheckOrder): 团购复核输出拦截订单序号,修正 intercept_status 识别(B2026080700003) 2026-08-15 18:25:43 +08:00
liufumingren
a5945cd678 fix: inbox 群登记按 group_id 去重,群改名只更新名称;唯一索引改为 (warehouse_id, group_id) 2026-08-15 18:22:30 +08:00
liufumingren
f3cf941721 feat: inbox 新增打包视频查询/查重/分配快递号函数,快递反馈回信优化 2026-08-14 23:06:05 +08:00
liufumingren
98bc088929 feat: 仓库配置新增收货地址 receiver_address,inbox 售后群新增工单登记/改地址/核实签收/改快递/查询仓库地址函数 2026-08-14 15:29:59 +08:00
liufumingren
bcf6a5b384 feat: 查退回明细(queryReturn)+ 退回拆包录明细条码与订单信息快照
- 站内信新增 queryReturn(查退回+运单号):跨退回相关表查询(拆包/退回收到/退回查询登记),未退回自动预登记,未收到时回填退回登记表货主
- 模板消息直发机制 direct_reply:函数返回模板原样回复,不经 AI 改写
- 退回拆包 addDetail 支持 barcode(仅作记录)、未指定 stock_id 标注未知商品、跨货主 stock_id 403
- wms_return_unpack 新增 source_order_codes/shop_name 快照(迁移 20260813170000),原单退回时回填
- ai.js 加固:DeepSeek 推理模型 max_tokens 提升、截断/空 JSON 重试、查询类请求强制调函数规则
- 新增调试脚本 script/debug-inbox-push.cjs;同步 methods 文档与变更记录
2026-08-13 23:13:07 +08:00
liufumingren
75a248fdf6 feat: 收货单列表新增 stock_query_where 商品维度过滤(条码/编码/ID) 2026-08-13 21:43:01 +08:00
liufumingren
d25ea39e87 fix: 库内拦截扫描严格校验,非拦截订单直接拒绝且不再补建缺失运单 2026-08-13 21:42:58 +08:00
liufumingren
59ef8117d7 fix: inbox 补全 message.retry/reply 方法入口,修复 retry 方法不存在报错 2026-08-13 21:42:53 +08:00
liufumingren
2d1b9e98fa feat: 新增运单退回登记模块(returnWaybill)并同步接口文档
- 复用 wms_return_query_log 表,提供货主+运单号退回登记增删查改(create/update/list/detail/delete)
- create 幂等(同仓库+货主+运单号返回已有);货主合约校验;update 冲突 409
- 权限固定 ID 551-555 + 角色授权迁移
- 同步 methods/system.json 退回拆包/运单退回登记模块与 changes 变更记录
2026-08-13 21:40:57 +08:00
liufumingren
38b29be776 feat: 新增退回拆包模块(returnUnpack)与序列表原子取号
- 新增 wms_return_unpack 主表/明细/视频 与 wms_return_query_log 表(model + 迁移)
- 新增序列表 wms_number_sequence,单号取号改为 INSERT...ON DUPLICATE KEY 原子递增(含历史 seed 对齐)
- 补齐 wms_order_delivery 基表缺失 25 列(修复 Unknown column)
- 权限固定 ID 540-549 + 角色授权迁移
- 修复 returnReceived.create 出参 record 包装;修复 afterSale 发件人查询列名(name→company_name)
- detail 接口按设计走 548 权限校验
2026-08-13 21:40:50 +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
7a74130219 1 2026-08-12 23:09:28 +08:00
liufumingren
1ea2bc48f7 fix: Qimen sync cancel + pendingOrder cancel 补运单 is_intercept 标记
- Qimen cancel(syncStatus=fin): 补 is_intercept='Y'
- pendingOrder.cancelOrder(synced): 补 is_intercept='Y'
2026-08-12 22:54:05 +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
64c24f963d feat: afterSale detail 订单明细增加 total_amount/item_amount 2026-08-12 22:45:56 +08:00
liufumingren
9974cfab89 migrate: 移除 wms_after_sale.order_delivery_id/order_delivery_no
- migration: DROP order_delivery_id, order_delivery_no
- model: 移除两字段定义 + idx_order_delivery_id 索引
- 全部流程已统一使用 order_id
2026-08-12 22:41:32 +08:00
liufumingren
61467756e2 refactor: after_sale 统一使用 order_id — 弃用 order_delivery_id 写入
- systemMethods/afterSale create: order_delivery_id → order_id
- systemMethods/afterSale _resolveRedundantFields: order_delivery_no → order_no
- systems/afterSale _enrichAfterSaleDetail: 仅使用 order_id
2026-08-12 22:39:06 +08:00
liufumingren
6c5e69c7d9 fix: afterSale detail 兼容 order_id 回退 — 拦截工单能看到订单明细
after_sale 表中拦截工单使用 order_id 字段,_enrichAfterSaleDetail 仅判断
order_delivery_id,导致拦截工单的详情接口看不到订单明细。
改为 order_delivery_id || order_id 双字段兼容
2026-08-12 22:26:00 +08:00
liufumingren
2795ae0758 fix: 补全拦截链路操作日志 — Qimen/OpenAPI/inbox AI 写入 ORDER_INTERCEPT_REQUEST
修复: 3处拦截入口缺失操作日志
- Qimen cancel: 拦截路径补 ORDER_INTERCEPT_REQUEST
- OpenAPI cancel: 拦截路径补 ORDER_INTERCEPT_REQUEST
- inbox AI interceptWaybill + 取消拦截: 补 ORDER_INTERCEPT_REQUEST
2026-08-12 22:13:20 +08:00
liufumingren
a024a20356 fix: 散单波次拦截增加称重判断 — weighing_weight>0时不设置拦截
修复: inbox AI 波次感知拦截(interceptWaybill + 取消拦截)
- 散单(wave_type=2)不再无条件拦截,改为查 wms_order_express.weighing_weight
- weighing_weight > 0(已称重) → 跳过拦截
- weighing_weight <= 0(未称重) → 设置拦截
- 团购(wave_type=1)逻辑不变: inspection_status !== 'fin' → 拦截
2026-08-12 21:56:22 +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
4c5807dbbc fix: 修复detail返回结构和transfer参数名
- detail返回{after_sale,steps}包装结构

- transfer入参名target_role_group改为role_group

- 集成测试8/8全部通过
2026-08-09 21:30:52 +08:00
liufumingren
296536c83e feat: 售后模块V2全面落地
数据库:

- 创建 wms_after_sale 主表 (36字段/16索引)

- 创建 wms_after_sale_detail 步骤表 (11字段/3索引)

- 插入售后权限 16条 (ID 508-523)

- 绑定6个角色权限 (客服/仓库/生产主管/拣货组长)

代码:

- Model: after_sale.js + after_sale_detail.js (含常量枚举)

- Service: systemMethods/afterSale.js + systems/afterSale.js (19方法)

文档:

- API定义: methods/system.json (+9 methods)

- 设计文档: database/designs/after-sale-v2-design.md

- 开发/生产环境均已执行迁移,权限ID完全一致
2026-08-09 21:17:34 +08:00
liufumingren
0c2b062658 chore: 移除售后工单模块 (after_sale_work_order)
- 删除 model: after_sale_work_order.js, after_sale_work_order_step.js

- 删除旧迁移: 20260728120000, 20260728130000

- 删除设计文档: after-sale-work-order-design.md, after-sale-api-design.md

- 新增 DROP TABLE 迁移: 20260809120000

- 开发/生产环境均已执行 DROP 迁移,两表已删除
2026-08-09 16:21:04 +08:00
liufumingren
3e7c9a7a10 fix: 修复 docs 页面 JS 失效 + 入库 locked_quantity 流水补全 + stock_store 查询条件补全 is_valid
1. docs.js: 修复模板字面量中 '\n' 被服务端解释为换行符导致客户端 JS SyntaxError,所有交互功能失效(搜索/发送按钮)
2. inbound_direct_log.js: batch_no 修正为 effectiveBatchNo;storage 表更新时补全 before_locked_quantity/after_locked_quantity;新增 stock_id 归属校验
3. stock_store.js: 多处查询/更新补全 is_valid='Y' 过滤条件,避免软删除/失效数据泄露或误操作
4. storage/entry.js: 入库完成时补全 storage 表 before_locked_quantity/after_locked_quantity 流水字段
2026-08-09 00:23:42 +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
35c71e13c4 feat(inbox): 群列表字段优化、where查询支持、快递接口加载及时间格式化
inbox.group.list 优化:
- 移除 warehouse_id 返回字段
- 新增 store_name(StoreWarehouse.store_remask)
- express_interfaces 改为 {id,name} 对象数组
- 新增 system_express_name(wms_express.name)
- created_at/updated_at 使用 app.formatDate 格式化
- 支持 pagination 对象 + where 结构化查询(parseWhereConditions)
- keyword 虚拟字段映射为 group_name LIKE
- groupType 驼峰映射为 group_type
- 增加 specialFieldMap 声明合法字段

新增 index.loadExpressInterfaces:
- 参考 loadStores 模式,拉取仓库下快递接口下拉列表
- 支持 systemExpressCode 入参过滤
- systemMethods/index.js 注册 + methods/system.json 文档

其他:
- delivery_order_code + store_id 联合索引迁移
2026-08-08 01:58:06 +08:00
liufumingren
948f600689 feat(inbox): 回调推送、出站文档、搜索增强、日志与推送状态完善
出站回调:
- 新增 warehouse_notify.json 文档(notify.ping/notify.reply),与 warehouse.json 互跳
- 回调体统一 { method, code, data },method 放 query,body 为业务数据
- MD5 签名: sign=MD5(appSecret+timestamp+bodyJson)
- 回调响应: {code:200} 成功,非200/非code:200 视为失败
- docs 页面支持模拟推送调试

搜索增强(searchStock/searchWarehouseStock):
- 直接查 stock_warehouse,不再依赖 stock_store
- 新增字段: gross_weight/box_spec/packing_requirements/prohibited_type
- 管理标识: is_sn_mgmt/is_shelf_life_mgmt/is_batch_mgmt
- 条码关联: wms_stock_barcodes
- 图片: wms_file_reference(business_type=stock)+wms_file,返回数组
- id 修正为 stock_warehouse.id

推送状态完善:
- handleApiMessage 增加 push_status 更新(2成功/3失败)
- 未配回调地址 → push_status=3 + error 原因
- 回调异常 catch 也更新 push_status=3 + 写日志
- 出站日志写入 wms_warehouse_log 表(WN-前缀)

消息列表:
- keyword 兼容 content/keyword,支持数组
- keyword 搜索 content/group_name/user_name 三列
- 支持 where+operator 结构化查询(parseWhereConditions)
- storeId=-1 查询无货主消息; storeId=0→IS NULL
- 日期范围: startDate/endDate

其他:
- silent 动作: AI 识别无需回复时跳过回执
- ai_enabled 灰度开关(群级)
- bindCode 文档修正
- store_name 改用 StoreWarehouse.store_remask
2026-08-08 00:17:38 +08:00
liufumingren
2cd53c7e0f fix(pick): 修复拣货完成→取消→重入的流程漏洞
1. pick.query 增加跨波次订单级去重:已拣货完成的订单不再创建新任务,直接返回原有任务

2. cancelWavePickTasksInternal 禁止取消 status 2(待复核)/3(已完成) 的任务,防止库存与订单状态不一致
2026-08-07 13:15:15 +08:00