14 Commits

Author SHA1 Message Date
liufumingren
dc9f83a2d7 perf(aftersale): 售后/退货拆包订单查询改为 attributes 白名单,减少全字段加载 2026-09-20 16:14:06 +08:00
liufumingren
c2a761ca26 feat(inbox): 新增开门/到货/进场/离场车牌登记与 extend_props 持久化
- functions 新增 openDoor/registerLicensePlate/enter/departure(规则表+权限分组)
- 到货登记表 wms_inbox_arrival_register(含消费字段,离场闭环,货主收货群优先推送)
- 回执 extend_props 持久化落库与定时补发送下发(重推兜底回读)
- 车牌提取正则兼容异体字(粤/粵)
- 售后类型/关键字/函数/回复 v2 模型与迁移
- INBOX V2 HTTP 测试报告与指南
2026-09-17 02:41:43 +08:00
liufumingren
7c19a5f43c fix(inbox): 回信改为运单号+处理内容,不再向客户发送售后单号
生产核实(近 7 天):含售后单号(AS)的出站消息 647 条 / 46 个群,其中 99.8% 发在货主售后群;
拦截回信 484 条、工单处理备注通知 96 条、拦截幂等 33 条只带 AS 无运单号,客户无法据此跟进。

- 拦截回信:`运单X 拦截信息已登记,已通知快递群`(未配置快递群 / 已登记过同理),
  幂等分支回 `运单X 已有处理中的拦截申请`;AS→运单号用 validList 按 waybill_id 反查
  (existingASList 只带 waybill_id)
- handleStoreFeedback / weishoudao:`运单X <问题>问题已登记`,去掉 `,工单:AS...`
- cancelIntercept:回信补运单号(已追加到处理中的工单 / 已创建处理工单)
- systems/afterSale handleWorkOrder 处理备注通知:`运单X 处理备注:\n<备注>`(无运单号时降级)
- inbox/ai.js systemPrompt 口径同步:拦截回复必须给运单号,严禁回复售后单号;模板描述去掉工单号

售后单号仍照常生成、入库、驱动幂等与状态流转,仅不再出现在回信中。

验证:eslint 通过;test/inbox handle_store_feedback 13 passing,其余站内信用例 100 passing。
(query_return.test.js 的 8 个失败为既有环境问题 can't get mockContext before ready,
已用 git stash 基线对比确认与本次改动无关)
2026-09-15 15:32:51 +08:00
liufumingren
4259628396 perf(afterSale): 售后导出流式写临时文件上传,避免内存 Excel 堆积,进度回调 await 化确保缓存进度不丢 2026-09-03 17:03:52 +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
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
f3cf941721 feat: inbox 新增打包视频查询/查重/分配快递号函数,快递反馈回信优化 2026-08-14 23:06:05 +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
64c24f963d feat: afterSale detail 订单明细增加 total_amount/item_amount 2026-08-12 22:45:56 +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
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