192 Commits

Author SHA1 Message Date
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
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
liufumingren
e61efbb66a feat(inbox): 站内信模块完整实现 - AI智能助手、群管理、消息列表增强、灰度开关
新增功能:
- AI智能助手: DeepSeek多轮推理、函数调用(searchStock/createOrder等)
- silent动作: AI识别无需回复的消息(好的/谢谢/再见)自动跳过回执
- ai_enabled灰度开关: 群级别控制AI启停,支持逐群放量
- 消息列表增强: storeId/groupId/groupName/userName/content/sourceType多条件筛选,时间格式化

代码优化:
- processWithAI: 多轮推理循环(MAX_ROUNDS=5)、对话历史不含[#N]前缀防AI污染
- 回执记录补齐group_id/user_id/group_name/user_name上下文
- 移除未使用的target_channel字段及迁移
- bindCode文档修正: store_warehouse → store

接口文档:
- system.json v0.3.18→0.3.19: 新增aiEnabled参数、消息列表响应扩充
- changes/system.json: 新增bindCode变更记录

杂项:
- store_warehouse.js JSDoc补全
- wave.js waveBatchSource修复
2026-08-06 17:40:36 +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
11167434ac feat: 仓库设置新增 string_array 类型及自动分配快递排除备注配置
新增字段 auto_allocate_express_exclude_remarks,类型 string_array,默认 [],用于控制订单备注命中关键字时跳过自动分配快递。

修改文件: WAREHOUSE_SETTING_FIELDS 新增元数据定义; Store model DEFAULT_SUBJECT_CONFIG 补默认值 + normalizeSubjectConfig 补校验。
2026-08-05 22:54:25 +08:00
liufumingren
4f41e735a9 feat(pick): wavePickTaskDetail 响应 task 对象新增 wave_no 字段
从 wms_wave_pick_task_wave JOIN wms_wave_batch 查询波次号,查询失败时降级为空字符串。同步更新 methods/system.json 文档与 changes 记录。
2026-08-05 22:52:53 +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
b00e320262 fix(db): expand item_snapshot_key to VARCHAR(1024) to prevent Data too long error
- wave_batch.item_snapshot_key: 255 -> 1024, full index -> prefix index(191)

- inbox-menu-permissions: INSERT -> INSERT IGNORE for idempotent production rerun
2026-08-05 22:46:22 +08:00
liufumingren
f00b4be1fb 小红书快递取号渠道补充mobile字段入参 2026-08-05 14:55:29 +08:00
liufumingren
807fddccc5 fix(express_platform): package_info 增加 id 作为唯一业务键支持拆单 -- story=sym:package_info 2026-08-04 21:28:26 +08:00
liufumingren
61b82512f2 feat(auth): 新增客服组权限授权/取消脚本,更新 dev-agent 配置
- scripts/auth/grant-cs-up.js: 客服组及以上角色批量授权(dev+prod)

- scripts/auth/revoke-cs-up.js: 客服组及以上角色批量取消授权(dev+prod)

- .github/agents/开发.agent.md: 新增关键定位地图第5项-客服组权限授权脚本

- .cursor/agents/wms-dev-agent.md: 同步 dev-agent 配置
2026-08-04 18:08:46 +08:00
liufumingren
095679c38e fix:修正分配快递号入参 2026-08-04 16:11:39 +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