ming #1

Merged
liufumingren merged 558 commits from ming into main 2026-11-18 16:13:25 +08:00

558 Commits

Author SHA1 Message Date
liufumingren
b7feed7e76 perf(order): 补复核时间统计索引,消除大屏复核数全表扫描
大屏「今日复核数」(warehouse_panel.queryFulfillment)固定按 recheck_time 区间 + status 过滤 + dispatch_lane IN ('m4','m5') 做 count,而 dispatch 分表上 recheck_time 无任何索引:EXPLAIN 为 type=ALL / rows=1,400,782,生产 7 天出现 138 次、平均 35.8s(同形状的 delivery_time 版本命中 idx_dispatch_1000028_panel_fulfillment 走 range,可直接对比)。

索引形态:current/outsourced 为 (recheck_time,status);dispatch 为 (recheck_time,status,dispatch_lane),比 current 版本多带 dispatch_lane 以便 count(*) 完全走索引不回表,并由 isPanelRecheckIndexName 保证 dispatch 不继承 current 版本。历史表不参与大屏统计,不建该索引。

依据:抽样 20 万行 recheck_time 非空 97.9%、status<>cancel 98.8%,时间窗口是唯一有效过滤条件。索引仍由模型定义在分表首次访问时懒创建。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-17 01:47:26 +08:00
liufumingren
4f8f453c36 perf(order): 订单分表补报表时间窗与归档时间索引
1. 发货单分表(current/dispatch/outsourced)补 (create_at,status,delete_at) 索引:工作台热销商品排行等报表固定按 create_at 区间 + status/delete_at 过滤订单再关联明细汇总,缺索引时优化器只能全扫明细表并逐行回表核对窗口,生产 wms_order_delivery_1000028_dispatch(140 万行/4.4GB)实测单次 38.9s。历史表按 archive_time 检索,沿用已有 idx_{warehouseId}_history_archive_time,不补建该索引。

2. 订单明细历史分表补 archive_time 索引:history 分表独有归档时间列,原先只有 created_at 索引,按归档时间检索会全表扫描。

3. 同步更新分表工厂索引用例:改为按集合断言(前 3 位继承 / create_at 同名继承 / 不继承 current 版列表索引 / history 仅 archive_time),修正此前因 logistics_code 与 is_b2b 列表索引新增而过期的期望值。

索引由模型定义在分表首次访问时懒创建(不改动存量表结构),按低峰发布。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-17 01:45:11 +08:00
liufumingren
0a6e82e00a feat(order): B2B 订单作业链路(列表/转换/取消/波次排除/作业明细表重构)
- 新增 order.pendingOrder2b.list / order.deliveryOrder2b.list:复用待处理与配送列表条件,
  强制 is_b2b='Y'(fixedWhere 以 AND 追加,请求 where 无法覆盖),并带出 wms_order_b2b
  作业明细字段(total_box_count/pickup_plate_number/prep_remark/prep_duration_seconds/
  prep_at/is_picked_up/picked_up_at/created_at),无明细行时输出空值占位
- B2B 列表 where 支持按作业明细字段筛选:先按 warehouse_id + order_id 查副表取 order_id,
  再以 id IN (...) 回填;该筛选仅这两个接口开放,不影响普通订单列表
- 其余订单列表(order/reviewOrder/pendingOrder/outboundOrder/expectionOrder/entrustOrder/
  deliveryOrder/deliveryExpectionOrder/archiveOrder 及 waveStrategyFallbackOrderList)
  统一追加 (is_b2b IS NULL OR is_b2b = 'N'),B2B 订单不再混入普通列表
- order.convertToB2b 收紧准入:status!=cancel、step in [1,2,3]、未拣货、未复核、未锁定、
  未拦截、未 B2B(打印状态不限制);已在波次中的订单转换后在同一事务内从波次摘除
  (含库内抓取订单),波次存在进行中拣货任务则跳过
- order.cancelB2b 放开打印限制,作业明细由软删除改为物理删除
- 波次抓取全链路排除 B2B:补上自动加团 appendOrderToWave / countCandidateGroupOrders
  两处遗漏;抽出 detachOrdersFromWavesInTransaction 供 batchRemoveOrders 与转 B2B 复用
- wms_order_delivery 分表新增 is_b2b 列表索引(current/dispatch,等值列前置 + 排序列),
  由订单工厂结构漂移同步自动补建
- 迁移 20261115180000-refactor-wms-order-b2b:新增 prep_at;移除 is_print/updated_at/
  deleted_at/delivery_order_code/store_id;唯一键改 uk_warehouse_order(warehouse_id, order_id);
  迁移前清理历史软删除行与重复行(开发库与生产库均已执行)
- operation_log 兜底用 changeSummary 写入 message,修复转/取消 B2B 日志操作说明为空
- 同步 methods/system.json 与变更记录 0.3.351~0.3.360

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-17 01:30:08 +08:00
liufumingren
4813a00ad4 fix(order): allow weighing during packing
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-17 01:01:01 +08:00
liufumingren
70e823480d fix(autoOutbound): 已称重规则改用 EXISTS 半连接,避免全表扫描订单快递表
原实现先捞全量称重订单ID(wms_order_express 全表扫描,生产 167 万行/165s)再拼 id IN 约束,既慢又会产生巨型 IN 列表。改为关联 EXISTS 子查询:订单表驱动,快递表按 order_id 唯一索引逐行点查,命中语义不变(同一订单任一快递记录 weighing_weight > 0 即算已称重)。生产实测该查询由 165s 降至 0.03~0.07s。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-17 01:00:18 +08:00
liufumingren
9af7dcf8fb feat(storeWarehouse): 签约关系接口配置按货主开放接口落库且回调地址统一取配置
- storeWarehouse.store.saveApiConfig:新增 resolveContractApiInterfaceType,
  interface_type_id=3(OPEN_API_WAREHOUSE 仓库开放接口)自动映射为 2(OPEN_API 货主开放接口)落库,
  不再要求当前主体为仓库(货主可维护自身签约关系下的接口配置)
- callback_url 不再取入参(含 callbackUrl 别名),统一写入 config.openapi.defaultCallbackUrl(新增配置项,默认空)
- storeWarehouse.store.listApiConfig:interface_type_id 过滤同步映射(传 3 按 2 查询)
- 文档:methods/system.json 升级 0.3.350、methods/changes/system.json 变更记录、docs/openapi-callback-events.md 回调地址来源说明
- 测试:saveApiConfig 新增 4 条用例(3→2 落库、忽略入参回调地址、默认值未配置、货主主体可保存、缺失类型 404),listApiConfig 新增 1 条过滤映射用例

同时提交工作区其余在制品改动:
- waybill:移除 wms_order_express_trace 模型并新增 drop 迁移,轨迹查询/取号/打印链路调整
- order:订单 SN 编码(order_item_sn / order_item_sn_log / sn_code_rule、has_sn_item 回填迁移),pendingOrder/recheckOrder/wave/base 调整
- express_platform、order_async、order_export、order_storage_allocation、storage.report、stock_store 配套修复
- lib:新增 jd_client,调整 qimen_client、callback_functions 及配套测试

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-14 17:14:04 +08:00
liufumingren
e99f8fad48 fix(waybill): 适配轨迹接口返回调整(空轨迹与小数重量)
- trace 为空数组(暂无轨迹)不再计为失败:只计入 result.empty,不落库,
  任务状态仍为 success;提示语补充「无轨迹 Z 单」
- weight 支持字符串小数(如 "0.99"):新增 parseTraceWeight 统一转数字保留 3 位小数
- wms_order_express_trace.weight 由 INT(11) 改为 DECIMAL(10,3)(迁移 20261111203500,
  已在开发库与生产库执行;MySQL 不支持 INT→DECIMAL 的 INPLACE,走 COPY 重建)
- 文档:methods/system.json(0.3.327)、变更记录、设计文档与出站回调说明同步

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-11 20:37:18 +08:00
liufumingren
1964021d50 feat(waybill): 新增 waybill.warehouse.getTrace 运单轨迹查询
- 按运单号一次返回该运单全部物流轨迹(不分页),按 op_time DESC, id DESC 排序
- 只读本地 wms_order_express_trace,不调外部接口、不落库
- 查询固定带 warehouse_id = ctx.user.store_id,跨仓不可见
- 无数据返回 success + total=0 + list=[];运单号必填(兼容 waybill_code 别名)
- op_time 统一格式化为 YYYY-MM-DD HH:mm:ss
- 文档:methods/system.json(0.3.326)、变更记录、设计文档接口清单与 3.9 节

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-11 20:05:22 +08:00
liufumingren
89e4cd22c0 feat(waybill): 运单物流轨迹表与 waybill.getTrace 批量更新
- 新增 wms_order_express_trace(1 运单 : N 轨迹):express_id 关联主表,
  冗余 waybill_code / order_id,warehouse_id 隔离,raw_data 存原始报文;
  uk_express_op_scan(express_id, op_time, scan_type) 幂等;字符集与主表一致
- 新增出站回调 waybill.getTrace(注册到 callback_functions,管理端可勾选):
  入参与 waybill.getreceive 一致({ request: { waybill_codes: [...] } },单批 10 单,
  signMode=simple);响应 [{ waybillNo, trace: {...} }],兼容 trace 数组与 {code,data} 包装
- 新增 waybill.warehouse.updateTrace / updateTraceTaskProgress:
  复用导出任务的异步任务ID与进度模式(前缀 waybill_trace_),
  支持 waybillCodes 或与 waybill.warehouse.list 一致的 where 条件圈选(上限 5000);
  轨迹按 (express_id, op_time, scan_type) upsert,未匹配运单计入 not_found
- 文档:methods/system.json(0.3.325)、变更记录、设计文档 2.2.1/3.9、出站回调说明 3.7

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-11 19:53:29 +08:00
liufumingren
e3eff20aaa feat(waybill): 批量更新运单揽收状态(waybill.getreceive)与 Y/N 标记列治理
- 新增出站回调 waybill.getreceive(注册到 callback_functions,管理端可勾选):
  请求 { request: { waybill_codes: [...] } },响应裸数组/包装体均兼容,
  1/0 与 Y/N 归一后回写 wms_order_express.is_galaxy_receive(按 warehouse_id 隔离)
- 回调签名新增 signMode=simple(MD5(appSecret+timestamp+bodyJson)),
  waybill.getreceive 使用该口径,与仓库通知协议一致;其它事件默认口径不变
- 新增 waybill.warehouse.updateReceive / updateReceiveTaskProgress:
  复用导出的异步任务ID与进度模式(前缀 waybill_receive_),单批 10 单自动切批;
  支持 waybillCodes 或与 waybill.warehouse.list 一致的 where 条件圈选(上限 5000);
  仓库未配置外部接口时直接失败,不创建任务
- 抽出 buildListQueryWhere / resolveWaybillCodesByWhere,列表与批量更新共用筛选口径
- order_express:is_back / is_intercept / is_galaxy_receive 补默认值 N
- 迁移:存量 NULL 回填为 N(Y 不动);三列分别建立单列索引(INPLACE + LOCK=NONE)
- 文档:methods/system.json(0.3.324)、变更记录、设计文档与出站回调说明同步

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-11 04:22:30 +08:00
liufumingren
25dac21b4b feat(waybill): OMS 取号与抖音打印 params 按店铺隔离
- express/express_platform: 新增 OMS 回源取号(need_oms_waybill=1)与统一失败收尾,
  失败时标记订单异常、写失败日志并清理未完成占位行;队列消费与手工分配共用同一口径
- order_print: 抖音打印按运单落库的 logistics_interface_id 精确命中取号接口配置,
  临时 key 缓存键带店铺与 token 指纹,避免多店铺串用 token;打印前按 OMS 记录换新 params
- order_express: 新增 print_history_id、cai_niao_auth_info_id 字段
- consume_waybill_allocate_queue / pendingOrder / delivery_order / order_async /
  printer_data_builder / order_delivery_table_schema: 配套调整
- migrations: 运单 wave_no 索引、OMS 打印字段

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 02:53:15 +08:00
liufumingren
3c0c7634c5 fix(inbox): notify.reply 按群/消息来源应用路由回执
同一仓库存在多个仓库级 API 应用且都勾选 notify.reply 时,回执按 id 升序逐个尝试,
可能被首个返回 200 的其它适配器接走,导致错投且被记为已送达。

- receiver: 群已存在时补写空白的 source_type/source_extra,来源不一致仅告警不覆盖
- processor: 回执来源优先级改为 群(wms_inbox_group) → 入站消息 → ext_id 解析,
  来源应用承接时只发给它;来源缺失或未承接时保持原候选顺序并告警
- warehouseNotify: push 支持 preferredAppKey,系统通知按群来源应用发送

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 02:42:25 +08:00
liufumingren
083f2846e0 feat(db): 为 wms_order_express 补 idx_warehouse_store 索引迁移
生产库已手工创建 idx_warehouse_store (store_id, warehouse_id),
本次将其固化为幂等迁移(ALGORITHM=INPLACE, LOCK=NONE),
并在模型索引声明与运单模块设计文档中同步记录。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-09 23:47:35 +08:00
liufumingren
eacf54091d feat(order.pendingOrder): 批量锁定跳过已取消订单
取消订单(status=cancel)为终态,被锁定后会残留锁定标记导致无法正常出库。
runBatchLockTask 查询时带出 status,取消订单不参与锁定更新、不写 ORDER_LOCK 日志;
混合批次只锁定未取消订单,并通过 skipped_cancelled_order_count /
skipped_cancelled_order_ids 透出跳过明细。

并发保护:更新语句 where 增加 status != 'cancel',并按实际影响行数回查确认
后才写日志与计数。

同步更新 methods/system.json 与 methods/changes/system.json(0.3.322)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 04:46:47 +08:00
liufumingren
fc7c7ff42e fix(express): 面单商品描述默认值由「物品」改为「化妆品」
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 04:46:42 +08:00
liufumingren
765bb2c0f7 feat(order): from_key 改为承载上游应用 appKey 字符串
背景:from_key 是「回原通道」的应用标识,出库单回传与取号业务分支都依赖它。
历史只存过奇门/ERP 的纯数字 appKey(聚水潭 23060081、吉客云 24869601),
OpenAPI 创建来源的 appKey 是字符串(wms_api_app.self_app_key,如
WMSD08A3696BBA9551F261C88BBF7F462BD),INTEGER 列无法承载,
normalizeOrderFromKey 会把字符串归一化成 null,导致 API 渠道订单 from_key 全为空。

改动:
- from_key 列 INTEGER(11) -> VARCHAR(100),迁移覆盖基表与全部分表
  (current/history/dispatch/outsourced),整数改字符串需重建表,
  迁移在改列后校验并恢复 AUTO_INCREMENT 水位,避免分表 id 区间重叠
- normalizeOrderFromKey 不再按整数归一化,改为去空白 + 截断 100 落库
- DY 平台聚水潭判断改为字符串比较,兼容改造后的存量数据

落库口径:QM 取 wms_qimen_apps.app_key,API 取 wms_api_app.self_app_key,
MANUAL/STOCKOUT 为空。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 04:46:38 +08:00
liufumingren
28c862b7c9 Add intercept status to order export
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 18:29:42 +08:00
liufumingren
96ec7c0d63 抖音模板已经改出文件 2026-10-29 15:02:29 +08:00
liufumingren
2a23beebbc agents规则移出项目跟踪 2026-10-28 23:55:11 +08:00
liufumingren
1a02c23db3 Merge branch 'ming' of ssh://192.168.9.101:22/liufumingren/WMS_MAIN into ming 2026-10-28 23:08:47 +08:00
liufumingren
9d86c3f149 chore(scripts): 新增库存差异核对报表脚本并忽略导出文件
scripts/stock_diff_report.js 只读查询生产库,输出 库存差异核对_YYYYMMDD-HHmm.xlsx;.gitignore 按 库存差异核对_*.xlsx 忽略带时间戳的导出文件。
2026-10-28 23:08:07 +08:00
liufumingren
cc9af9a4bf fix(print): 自定义区模板地址切换到自有域名 qimen.wms.gztbyc.com
快手/拼多多自定义区模板与视频号 spa.html 由第三方(www.ye4s.com、ye4s.wms.gztbyc.com)改为自有域名 https://qimen.wms.gztbyc.com/mb/,避免第三方站点不可用导致打印端取模板失败。
2026-10-28 23:08:06 +08:00
liufumingren
87bb9c87eb fix(express): 寄件人国家默认值由空值改为 CN
菠萝派下单寄件人 country 传空会被平台判为无效地址,统一默认 CN。
2026-10-28 23:08:05 +08:00
liufumingren
9edc0e3e47 fix(stock.check): 账面口径改取可用数量并新增静态盘点拣货完成校验
账面口径统一为 wms_storage SUM(available_quantity)(不再加 locked_quantity),避免静态盘点在仍有在途拣货时开盘产生假盘亏(PD20261027000001 商品 160240 -115)。

静态盘点(is_static=1)新增拣货完成判定 _fetchStockLockedQuantityMap:workData/workDataDetail 输出 picking_completed 与明盘 locked_quantity,report 对仍有锁定量(未完成拣货)的商品返回 400 拒绝上报。

同步更新 methods/system.json(0.3.319~0.3.321)与 changes 变更记录。ESLint 0 错误。
2026-10-28 23:08:00 +08:00
liufumingren
dfcc9b3e72 chore(scripts): 新增库存差异核对报表脚本并忽略导出文件
scripts/stock_diff_report.js 只读查询生产库,输出 库存差异核对_YYYYMMDD-HHmm.xlsx;
.gitignore 按 库存差异核对_*.xlsx 忽略带时间戳的导出文件。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 23:06:56 +08:00
liufumingren
3291699a63 fix(print): 自定义区模板地址切换到自有域名 qimen.wms.gztbyc.com
快手/拼多多自定义区模板与视频号 spa.html 由第三方(www.ye4s.com、ye4s.wms.gztbyc.com)
改为自有域名 https://qimen.wms.gztbyc.com/mb/,避免第三方站点不可用导致打印端取模板失败。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 23:06:52 +08:00
liufumingren
359b51eb37 fix(express): 寄件人国家默认值由空值改为 CN
菠萝派下单寄件人 country 传空会被平台判为无效地址,统一默认 CN。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 23:06:48 +08:00
liufumingren
226a2659d7 fix(stock.check): 账面口径改取可用数量并新增静态盘点拣货完成校验
账面口径统一为 wms_storage SUM(available_quantity)(不再加 locked_quantity),
避免静态盘点在仍有在途拣货时开盘产生假盘亏(PD20261027000001 商品 160240 -115)。

静态盘点(is_static=1)新增拣货完成判定 _fetchStockLockedQuantityMap:
workData/workDataDetail 输出 picking_completed 与明盘 locked_quantity,
report 对仍有锁定量(未完成拣货)的商品返回 400 拒绝上报。

同步更新 methods/system.json(0.3.319~0.3.321)与 changes 变更记录。
ESLint 0 错误。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 23:06:43 +08:00
liufumingren
562f63f18e feat(stock.check): 商品视图按商品汇总、账面按静态标记取值、静态盘点锁定缓存与库存操作拦截
盘点作业数据(workData / workDataDetail)
- workData goods 视图按 stock_id 汇总为一行(同商品多库位明细合并):行级账面=各库位之和,
  作业记录跨明细按库位合并,locations 每项补 detail_id/snapshot_quantity,行级不再返回 detail_id。
- workDataDetail 商品分支改为 id + stock_id 钻取,返回 summary(汇总)+ rows(按库位分行:
  明细ID/库位ID/账面快照/当前账面/实盘/差异);兼容传商品范围 detail_id。
- 账面取值按任务 is_static 区分:静态盘点取明细快照(冻结基准),普通盘点取当前 wms_storage;
  新增 storage_quantity / is_static / book_source 字段,差异统一为「实盘 - system_quantity」。
- report 的 detail_id 改为可选:商品行可只传 id + stock_id + space_id,服务端按库位明细反查。

静态盘点(is_static)
- wms_stock_check 新增 is_static(TINYINT(1) DEFAULT 0,迁移 20261028010000);create 支持 is_static
  (仅商品盘点有效,库位盘点恒 0);静态定式 pattern=static 创建的任务自动置 1。
- 新增公共查询 stock.check.staticLockList:返回 is_static=1 且 approved/checking 任务的商品集合,
  按仓库缓存(TTL 300s、状态流转先递增代次再重建、回源前后代次校验防脏读、空集合也缓存、
  进程内 singleflight 防击穿),并提供 isStockStaticLocked / getStaticLockConflict 供内部判断。
- 审核通过时刷新商品明细账面快照(快照基准=开始盘点时点),finish 立即释放锁定并返回 released_stock_ids。
- 库存操作拦截:分配储位命中锁定商品时按「库存不足」同流程将该订单标记失败(storage_status=error +
  order_flag),同批次其它订单继续;移库(transferLocation / transferByProduct)命中锁定直接 400。

其他
- 新增开发环境实测脚本 script/stock-check-goods-summary-verify.cjs。
- 测试:stock_check.test.js 覆盖汇总/钻取/静态标记/锁定缓存/账面口径;新增 static_lock_guard.test.js
  覆盖分配与移库拦截;methods/system.json 与 changes 更新至 0.3.318。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 07:22:44 +08:00
liufumingren
8f2e141fe0 fix(express): 菠萝派平台返回空 results 时判定为系统级失败
- polyapi 取号结果 results 为空数组且请求含订单时(如 code=40000 / GSE.REQUEST_FAILURE.SYSTEMERROR),
  旧逻辑会当成 0 条结果继续走成功分支,订单既不回写运单号也不标记异常;
  现直接按失败抛出,失败原因拼接 submessage/message,并附带 polyapirequestid 便于平台侧定位。
- 顺带修正 providercode 判断处的代码风格(if 后空格)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 07:22:33 +08:00
liufumingren
15c739c645 Merge branch 'ming' of ssh://192.168.9.101:22/liufumingren/WMS_MAIN into ming 2026-10-27 19:01:43 +08:00
liufumingren
8adede7ec7 fix(express): 视频号取号补 extend_props 空值保护并修正京东/小红书入参
- 视频号(platid 672)取号前判空 extend_props,避免 null 直接抛 TypeError 掩盖真实业务错误
- JD 取号补充 pickUpDate / pickUpEndDate / shipperno
- XHS 透传 site_code / shipperno,sender.country 置空以适配菠萝派要求

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 19:01:30 +08:00
liufumingren
589c2fe024 fix(express): ?????? extend_props ?????????/?????
- ???(platid 672)????? extend_props??? null ??? TypeError ????????
- JD ???? pickUpDate / pickUpEndDate / shipperno
- XHS ?? site_code / shipperno?sender.country ??????????

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 19:01:21 +08:00
liufumingren
c02f2f0d56 feat(stock.check): 移除 all 盘点范围并迁移为 location/goods
- 模型 type 默认值 all -> location,注释同步为 location/store/goods

- 迁移 20261027010000:有商品明细的 all 任务归 goods(保留原 mode),其余归 location 且 mode=blind;列默认值与注释同步更新

- 补充盘点集成测试与分区编码唯一性集成测试(默认跳过,需 DISPATCH_FACTORY_TEST_MYSQL=1 才连接本地开发库)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 03:09:16 +08:00
liufumingren
7414a8f2a1 feat(express): 店铺快递列表补充快递产品类型
- getShopExpressList 按 sys_express_code 匹配 wms_express_product_type,补充 product_types: [{ name, code }]

- PDD 平台不补充该字段;产品类型读取异常时降级为空数组,不影响快递列表返回

- 补充单测;该测试文件原有 11 个失败为改动前既有失败(基线同样失败)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 03:08:58 +08:00
liufumingren
640ce501cb feat(user): 新增账号用户名/密码修改与自定义密码标记
- wms_account 新增 is_custom_password(TINYINT(1) NOT NULL DEFAULT 0),同步模型与迁移 20261025135000;开发库、生产库均已执行

- user.getAccountInfo 返回 is_custom_password,仍不返回 password_hash/salt/last_login_ip

- 新增 user.updateUsername:仅改当前账号,服务端重名校验并排除自己,重名返回 409,更新后清理用户缓存

- 新增 user.changePassword:is_custom_password=0 时旧密码可不传,修改后置 1;再次修改必须校验旧密码;已排除操作日志避免明文密码落库

- 单测覆盖 getAccountInfo/updateUsername/changePassword,20 通过;同步 AI_METHOD_ROUTING

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 03:08:51 +08:00
liufumingren
de2f66a2d1 fix(stock.check): 上报强制 space_id 并按库位ID落库,修复作业挂到已删除分区的库位
- stock.check.report:space_id 必传(兼容 spaceId/location_id/locationId),校验仓库归属、分区有效、与 location 编码一致,缺失/非法/跨仓库/无头库位均返回 400;服务端不再按库位编码猜库位
- report:实盘数量上限 2147483647(原超限落库 Out of range 变 500);写库库位以 space_id 为准
- workData / workDataSpaceDetails / workDataDetail:space 视图行与 goods 视图 locations[] 补 space_id、location_id;space 视图记录库位归一(同编码不再出现幽灵行),明细按「库位+商品」索引、记录按「库位+商品」聚合
- 操作日志 STOCK_CHECK_REPORT:message 补库位编码/库位ID,before_changes 落库位与明细库位快照
- location.zone:createZone/updateZone 增加同仓库 zone_code 唯一校验(归档分区不占用编码,沿用规则编码),避免重复货架生成同编码库位
- 新增运维脚本(默认只读,--prod 指定生产):盘点库位一致性体检/订正(只改坏记录,两分支互斥)、作业记录指向已删除库位体检与 CSV 导出;无头库位引用统计改为分批 IN 查询,避免大表相关子查询导致生产连接重置

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 03:04:07 +08:00
liufumingren
0e7545bd9a feat(user): 新增 user.getAccountInfo 账号级信息查询
- 新增 user.getAccountInfo:仅查询当前登录账号的 wms_account 信息

- 白名单返回 id/username/real_name/phone/email/status/last_login_at/created_at/updated_at,排除 password_hash、salt、last_login_ip

- 未登录返回 401,账号不存在返回 404;不接收账号ID,避免越权查询

- 同步 methods/system.json(0.3.304 → 0.3.305)、变更记录、AI_METHOD_ROUTING 与方法文档库表

- 新增单测 test/app/service/systemMethods/user.getAccountInfo.test.js(5 通过)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-25 13:43:26 +08:00
liufumingren
5675e24225 fix(pick): 领料跳过拦截单按打印状态区分,已打印拦截单照常领料并补写 claim_time(0.3.304)
- waveClaimScan:仅未打印(print_status != fin)的拦截订单跳过领料;已打印的拦截订单面单实物已流出,照常置为已领料并写 ORDER_WAVE_CLAIM 日志,响应新增 intercept_skipped_order_count / claimed_intercepted_order_count
- waveClaimScan:already_claimed 幂等分支在波次 claim_time 为空时补写领料时间,修复 order.wave.confirmPrintUnclaimedWaveCount 长期把已领料波次计为「已打印未领料」
- getWaveClaimGateStats:已打印的拦截订单仍需领料登记,未领料时阻隔创建拣货任务
- 新增 script/backfill-wave-claim-status.cjs 存量订正脚本(默认 dry-run,自动定位待处理/配送/历史/委托外仓分表,幂等)
- 同步 methods/system.json、methods/changes/system.json、AI_METHOD_ROUTING.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 22:35:08 +08:00
liufumingren
dc53058598 Merge branch 'ming' of ssh://192.168.9.101:22/liufumingren/WMS_MAIN into ming 2026-10-21 17:19:25 +08:00
liufumingren
861c384917 feat(order): 新增配送订单每日汇总 order.deliveryOrder.summary
- 新增 order.deliveryOrder.summary:以自然日为维度汇总订单量、迁入配送表订单量、
  发货量(订单数/商品件数/金额)、拦截数量、库内确定拦截数量与取消数量
- 数据源为订单常用表 + 配送表分表(history/outsourced 不参与),日期分组按
  CONVERT_TZ 换算到服务器本地时区,避免 UTC 存储导致自然日偏移
- 缺省最近 7 个自然日、单次最多 90 天,区间内无数据日期补 0;可选 store_id 过滤
- 同步 methods/system.json(0.3.302 → 0.3.303)、变更记录与 AI_METHOD_ROUTING.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 17:13:40 +08:00
liufumingren
615e3694b5 feat(order): ?????????? order.deliveryOrder.summary
- ?? order.deliveryOrder.summary???????????????????????
  ???????/????/??????????????????????
- ????????? + ??????history/outsourced ??????????
  CONVERT_TZ ????????????? UTC ?????????
- ???? 7 ????????? 90 ??????????? 0??? store_id ??
- ?? methods/system.json?0.3.302 ? 0.3.303??????? AI_METHOD_ROUTING.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 17:13:20 +08:00
liufumingren
1afe068e73 feat(return-unpack): 新增配送订单批量转退件拆包单 transferByOrders
- 包装层新增 transferByOrders(鉴权 + 操作日志,ids 去重后上限 200)
- 业务层实现:仅库内拦截订单可转,1 单新建 1 张拆包单,明细 1:1 复制,单条失败不阻断主流程
- 迁移 20261017100000:新增权限 643 并授予仓库组员工/主管
- 同步 methods/system.json 与变更记录
- package.json 修正 depeeloy 脚本名拼写为 deploy
2026-10-21 15:46:18 +08:00
liufumingren
e9e39eafa7 chore: 提交工作区其余未提交改动(微信协议版本 / 扫描报文接口 / container 模型 / 退件 like 数组)
- 微信开放平台:首次授权时写入系统默认用户须知作为首个协议版本
  (ctx.service.systems.wechat.ensureDefaultAgreementVersion),含 seed / backfill 两个迁移
- 新增扫描报文接收接口 POST /scan:把「时间 + 条码」追加写入项目根目录 scan_records.xlsx
  (串行队列 + 原子写,避免并发写坏文件)
- 新增 wms_container(容器/笼筐)模型与建表迁移
- 退件收货单 / 退件运单列表:like 查询条件支持字符串数组(多关键词 OR)
- 新增 wms_return_unpack.created_at 索引迁移
- package.json:deploy 脚本改名为 depeeloy

注:scan_records.xlsx 是 /scan 接口写入的运行时数据文件,未纳入本次提交。
2026-10-16 05:29:13 +08:00
liufumingren
fdec622f2d feat(auto-outbound): 自动出库改为「开关 + 规则数组」,支持多条规则与跨天放行
- subject_config 新增 auto_outbound_enabled(默认 false);auto_outbound_rules 由对象改为数组,
  每项仅含 require_pack / require_weigh / require_sync / exclude_same_day_outbound /
  same_day_outbound_deadline_time / same_day_outbound_release_time
- 固定基线:已复核(recheck_status=fin)+ 已分配储位(storage_status=fin);已打印、已拣货不再校验
- 规则内 AND、规则间 OR(任一命中即出库);空数组不出库且不告警
- 旧对象结构不再兼容:读路径按默认(关闭)处理,写路径返回 400 提示重新配置
- 放行时间支持跨天 00:00~47:59(27:00 = 次日 03:00);按订单复核时间所在北京日计算未放行窗口
- 定时任务与手动触发统一走新规则;自动出库写入操作日志 ORDER_AUTO_OUTBOUND
- 同步 methods/system.json、methods/changes/system.json 与 AI_METHOD_ROUTING.md

涉及接口:setting.warehouse.getSettings / getFieldMeta / saveSettings、outbound.autoOutbound
2026-10-16 05:27:30 +08:00
liufumingren
e602d205b2 fix(workbench): 打包与查订单改按订单主键定位,不再按发货单号反查(防跨货主串单)
背景:wms_order_delivery 唯一索引是 (delivery_order_code, store_id, warehouse_id),
跨货主可重复,按「发货单号 + 仓库」反查订单在撞号时会把打包记到别的货主的订单上。
生产案例:发货单号 1345551 同仓命中团购单 306715 与散单 1096062,
打包记录因此落到 306715(团购波次 B2026082911192),而波次号字符串却取了扫码单的 E2026101300061。

- workbench._packOrder 新增 order_id 入参:优先按订单主键查单(current → dispatch 分表遍历),
  主键未命中才按 delivery_order_code 兜底;
- key 模式透传后端扫码上下文的主键:business(packOrder) 与 packOrderByToken 均带上 cachedCtx.order_id;
- 旧参数模式从设备上报 body 中剥离 order_id(只信任后端缓存注入,防篡改);
- 主键与发货单号不一致时打 warn 留痕,落库字段与响应结构不变;
- inbox 查订单:运单号命中后的订单定位与关联运单查询改为按订单主键(id / order_id)。

未改动(已核查,属创建查重 / 用户按单号搜索入口 / 外部接口契约 / 只读展示)。
2026-10-13 23:54:54 +08:00
liufumingren
16134e88c6 feat(workbench): 打包开始下发 OSD 前跳转摄像头预设点1,失败仅告警不阻塞 2026-10-13 20:43:02 +08:00
liufumingren
938e46e04c fix(panel): 拣货看板 top 分组 SQL 第一分支补今日任务窗口,消除 pto 全历史关联扫描(慢日志 1.75M 行/9.4s 超时) 2026-10-13 02:46:06 +08:00
liufumingren
3171ce4fab fix(pick): 拣货跳过拦截单区分打印状态,已打印面单不再自动移出波次(0.3.294) 2026-10-13 00:53:06 +08:00
liufumingren
b1ac685b84 feat(model): dispatch 表增加大屏面板计数索引 idx_dispatch_{wh}_panel_fulfillment(delivery_time+outbound_status) 2026-10-13 00:25:16 +08:00
liufumingren
eb4ce994ba fix(panel): scatterPacking 移除 wave 波次数(散单无波次语义,0.3.293) 2026-10-12 23:43:29 +08:00
liufumingren
ef933bc353 feat(panel): 新增 touchLastChangeAt 公共方法,拣货/复核/打包完成时通知大屏刷新(0.3.292) 2026-10-12 23:38:53 +08:00
liufumingren
75333b2eb6 fix(panel): 环节卡 doing/abnormal 统一订单表状态口径(拣货中/打包中/各环节异常双表,0.3.291) 2026-10-12 23:29:12 +08:00
liufumingren
b62d3247ac fix(panel): 打包卡 doing 改订单表 pack_status=padding 订单数口径(0.3.290) 2026-10-12 23:26:30 +08:00
liufumingren
8d86eb361b fix(panel): 打包汇总(pack 卡/团购/散单块)排除打包中,仅统计已完成 status=2(0.3.289) 2026-10-12 23:16:51 +08:00
liufumingren
9928acacb2 fix(wechat): QUERY_AUTH_CODE 响应体改回空串(不被动回复),客服消息保持后台异步双发 2026-10-12 20:11:07 +08:00
liufumingren
d02690cc4d fix(wechat): QUERY_AUTH_CODE 改为被动回复+客服消息双通道,覆盖检测脚本按粉丝收信判定的口径 2026-10-12 20:06:41 +08:00
liufumingren
2f842c1a4b fix(wechat): 检测客服回复双发(含 queryauthcode@@@ 前缀与去前缀两个版本),兼容检测脚本对回复内容的两种核对口径 2026-10-12 19:54:22 +08:00
liufumingren
2c0ae6e089 fix(wechat): QUERY_AUTH_CODE 客服回复优先使用存储的 refresh_token(Redis→DB),仅无存储时才用文本授权码换取,与 PHP 参考实现一致 2026-10-12 19:42:48 +08:00
liufumingren
a67e9c3955 fix(wechat): 检测步骤3/4 命中 QUERY_AUTH_CODE 时响应体改回空串(官方要求),客服消息仍后台异步发送 2026-10-12 19:26:38 +08:00
liufumingren
4ae9ae852f fix(wechat): 客服消息改 runInBackground 异步确保 5 秒响应,日志按官方检测步骤2/3/4与公众号/小程序测试号打标 2026-10-12 19:14:23 +08:00
liufumingren
c3896bc68a fix(wechat): 文本消息与客服消息关键路径增加 WARN 级日志,便于定位全网发布检测失败原因 2026-10-12 19:11:37 +08:00
liufumingren
06a2126e2e fix(wechat): authorized 事件换取令牌失败不再抛错重试,避免与 QUERY_AUTH_CODE 文本竞争消费授权码导致「授权成功」检测失败 2026-10-12 18:47:25 +08:00
liufumingren
5f2daf4e35 fix(wechat): QUERY_AUTH_CODE 检测文本用携带的授权码直接换令牌发客服消息,消除 authorized 事件与文本消息 1 秒竞态导致的检测失败 2026-10-12 18:29:03 +08:00
liufumingren
a49a878b5f fix(wechat): events URL 验证不再因 appid 无授权记录而拒绝(首次配置/全网发布检测场景兼容,仍按组件 Token 验签回显) 2026-10-12 18:15:43 +08:00
liufumingren
7238621025 feat(wechat): 新增小程序/公众号消息与事件推收入口 /events/appid/:appid(URL验证/事件分发/关键词自动回复/加密被动回复,参考 PHP Index::events) 2026-10-12 17:57:24 +08:00
liufumingren
2c9f656ac9 fix(panel): 打包卡 today 改真实打包订单数(团购按波次真实订单数替代 pack_quantity 快照,0.3.288) 2026-10-12 00:24:46 +08:00
liufumingren
d3e8421bdc fix(panel): fulfillment 已打包改 pack_status 存量口径,修复已打包大于已复核(0.3.287) 2026-10-12 00:18:55 +08:00
liufumingren
a22e788706 fix(panel): trend 下单量窗口修正为业务日窗口(凌晨从昨日自然日开始时间起算,0.3.286) 2026-10-12 00:01:49 +08:00
liufumingren
2452cef4f1 feat(panel): trend 移除 pack_count 打包数,仅保留总单量累计(0.3.285) 2026-10-11 23:54:20 +08:00
liufumingren
606928194f feat(panel): trend 补充 total 总单量字段(与 fulfillment.total 同口径,0.3.284) 2026-10-11 23:48:55 +08:00
liufumingren
bf1f2b3fad feat(panel): trend 双值改按小时累计(订单数/打包数累加,最后一点=全天总数,0.3.283) 2026-10-11 23:38:20 +08:00
liufumingren
c3f97279da feat(panel): trend 改业务日 24 点双值(创建/打包订单数落桶,label 从自然日开始时间起,0.3.282) 2026-10-11 23:34:57 +08:00
liufumingren
4ca6af82b0 feat(panel): 面板业务日窗口(day_start_time),打包卡 today 改订单数口径(与已打包一致),fulfillment 追加今日退件/拆包,退件表补创建时间索引(0.3.281) 2026-10-11 21:54:08 +08:00
liufumingren
4b8e17c139 fix(stock.check): 盘点范围排除无头库位(zone 不存在/已删除不入明细与作业视图,0.3.280) 2026-10-11 21:05:44 +08:00
liufumingren
731bc8e9fb feat(system): 新增 getWarehousePanelData 仓库面板数据接口(增量缓存返回),平台白名单补 tv 2026-10-10 04:45:14 +08:00
liufumingren
879bfaccbe fix(stock.check): result 无作业记录时返回明细范围行(盘点前/待提交后台查看明细,0.3.262) 2026-10-10 04:36:03 +08:00
liufumingren
d4daa6d671 fix(stock.check): exportDetail 汇总和差异 sheet 增加条码列(0.3.261) 2026-10-10 04:23:05 +08:00
liufumingren
d8ffc01429 fix(stock.check): exportDetail 无库位上报记录库位列按商品任务库位兜底显示(0.3.261) 2026-10-10 04:14:18 +08:00
liufumingren
0785e7df38 fix(stock.check): exportDetail 库位明细按作业记录导出,库位编码显示覆盖(自定义名称→自定义编码→库位编码,0.3.261) 2026-10-10 04:11:21 +08:00
liufumingren
fab2d9c0d1 fix(stock.check): exportDetail 商品盘点固定两 sheet(汇总和差异 + 库位/数量/条码/商品名称),移除 mode 入参(0.3.261) 2026-10-10 03:58:54 +08:00
liufumingren
78b46a740b feat(stock.check): 新增 exportDetail 盘点明细导出(商品盘点库位明细/汇总+差异两模式,库位盘点简化,0.3.261) 2026-10-10 03:34:28 +08:00
liufumingren
1402aa3841 refactor(stock.check): submit 仅刷新明细行账面快照,不写主表 scope_snapshot(明细表已完整记录,0.3.260) 2026-10-10 03:22:40 +08:00
liufumingren
3401645419 feat(stock.check): submit 提交审核时固化商品范围账面快照(明细行库位级 + 主表 scope_snapshot 总数/锁定,0.3.260) 2026-10-10 03:10:13 +08:00
liufumingren
ae107e5cbe fix(stock.check): result 商品范围按商品聚合输出,库位账面快照随行输出(0.3.259) 2026-10-10 02:33:43 +08:00
liufumingren
e4472e2c74 fix(stock.check): space 视图排序仅按 pick_sequence,priority 与 id 不参与(0.3.258) 2026-10-09 22:18:39 +08:00
liufumingren
9d3c6b31fd fix(stock.check): workData space 视图库位排序对齐拣货模块(pick_priority 降序改升序,0.3.257) 2026-10-09 22:08:56 +08:00
liufumingren
05bef9210a fix(wave): 波次自动终结加固,防建波中间态误关(B2026100900660 事故)
- 年龄门槛 5->30 分钟,覆盖建波后订单绑定延迟的分钟级空窗
- 判空新增波次索引表交叉校验:订单表与索引表双空判为未绑定中间态不终结;索引有行时抽样核对识别读偏
- 候选条件与终结 UPDATE 改用 UTC_TIMESTAMP,与 create_time UTC 存储口径显式一致
- 调度执行日志补 unbound/misread/probeFailed 统计
- 测试 9->15 用例(双空/读偏/正常离表/查询失败/抽样失败/时区口径)
2026-10-09 20:05:36 +08:00
liufumingren
29b39a7add fix(order): 二次转 B2B 恢复软删除明细行并重置作业字段
- 场景:转 B2B → 取消(明细软删除)→ 再转 B2B。原 findOrCreate 命中
  软删除行后直接返回,明细行保持 deleted_at 非空(B2B 明细查询不到),
  二次转后订单是 B2B 但无有效作业明细
- 修复:convertOrdersToB2b 明细写入改为 findOne(paranoid:false) + 显式分支——
  存在历史行(含软删)时恢复同一行并重置作业字段(deleted_at=null、
  total_box_count=0、pickup_plate_number=null、prep_remark=null、
  prep_duration_seconds=0、is_picked_up=N、picked_up_at=null、is_print=N、
  更新仓库/货主/发货单号快照,update 带 paranoid:false);不存在才 create
- 验证:临时集成测试转→取消→再转 1/1 PASS(二次转成功、恢复同一行、
  deleted_at 清空、作业字段重置、订单 is_b2b=Y,测后还原);ESLint 0 error
2026-10-09 00:39:03 +08:00
liufumingren
b10f8f7583 feat(order): 新增 order.cancelB2b 接口,取消 B2B 出库流转回正常订单
- systems/order_b2b.js cancelOrdersB2b:
  1) 仅限待处理表(current 分表)中 is_b2b=Y 的订单,事务内 SELECT ... FOR UPDATE
     后逐行校验:待处理(step!=0)/是 B2B(is_b2b=Y)/未打印(print_status!=fin)/
     未锁定(lock_status=none)/未拦截(intercept_status=none)/B2B 面单未打印
     (wms_order_b2b.is_print!=Y),不符合条件跳过(skipped_reasons 返回原因),
     不存在订单计入 not_found_order_ids
  2) 事务内:订单 is_b2b 置回 N + B2B 作业明细软删除(deleted_at);提交后写
     操作日志 ORDER_B2B_CANCEL(失败不影响主流程)
  3) 单次上限 200,仓库隔离
- systemMethods/order/index.js cancelB2b:ids/order_ids/orderIds 数组与
  id/order_id/orderId 单值兼容,空/超限 400;白名单三处加 cancelB2b
- 验证:临时集成测试 3/3 PASS(转 B2B→取消链路:is_b2b 置回 N+明细软删除
  +日志、已打印 B2B 面单跳过分流、400 边界,测后数据还原);ESLint 0 error
2026-10-09 00:26:36 +08:00
liufumingren
183e542d74 feat(order): 新增 order.convertToB2b 接口,订单转 B2B
- systems/order_b2b.js convertOrdersToB2b:
  1) 仅限待处理表(current 分表)订单,事务内 SELECT ... FOR UPDATE 后逐行校验:
     待处理(step!=0)/未打印(print_status!=fin)/未锁定(lock_status=none)/
     未拦截(intercept_status=none)/未转 B2B(is_b2b!=Y),不符合条件跳过
     (skipped_reasons 返回原因),不存在的订单计入 not_found_order_ids
  2) 事务内:订单 is_b2b 置 Y + wms_order_b2b 写入(findOrCreate by uk_order_id,
     已存在不覆盖);提交后写操作日志 ORDER_B2B_CONVERT(失败不影响主流程)
  3) 单次上限 200,仓库隔离(warehouse_id 过滤)
- systemMethods/order/index.js convertToB2b:ids/order_ids/orderIds 数组
  与 id/order_id/orderId 单值兼容,空/超限 400;白名单三处加 convertToB2b
- wms_order_b2b 新增 is_print 字段(ENUM('Y','N') 默认 N 未打印)+ idx_is_print
  (迁移 20261009100000 已执行开发库并核验 15 列)
- 验证:临时集成测试 3/3 PASS(转换落库+日志+还原、跳过分流、400 边界);
  ESLint 0 error;生产迁移待随发布执行
2026-10-09 00:22:25 +08:00
liufumingren
4223b6882a feat(wave): 波次抓取不抓取 B2B 订单(is_b2b=Y 排除)
- 所有抓取候选与统计查询统一排除 B2B 订单(口径:is_b2b IS NULL OR is_b2b='N',
  NULL 视为非 B2B,兼容存量行):
  1) buildFetchWhere(团购/散单结构抓取共用 where)
  2) groupOrderFetchList / singleOrderFetchList / fetchableOrderCount 候选列表与统计
  3) buildWaveStrategyQuickScanOrderWhere + 扫描遗漏检查(策略扫描池,B2B 不进策略匹配)
  4) 散单同结构计数候选
  5) 策略候选/统计 SQL 5 块(调试候选、matched_count_filtered、count_total、
     next_fetch 预演、同结构取出)o 侧与 src 侧同步加条件
  6) singleFetchByIds 显式抓单:B2B 订单计入新增返回字段 excluded_b2b_order_ids
  7) createWaveBatchByOrderIdsInTransaction 建波落库 lockRows 尾部兜底再排除
- 验证:临时集成测试 3/3 PASS(buildFetchWhere/buildWaveStrategyQuickScanOrderWhere
  含 is_b2b 条件;fetchableOrderCount 真实库执行成功);ESLint 0 error
2026-10-09 00:06:54 +08:00
liufumingren
0ced089599 feat(order): 订单表新增 is_b2b 字段(是否B2B,默认N)
- app/model/order_delivery.js 加 is_b2b ENUM('Y','N') 默认 'N'(与 is_urgency 同款)
- 分表(wms_order_delivery_%)由 OrderDeliveryFactory 惰性同步自动补齐
  (describeTable 比对 + 单条 ALTER + 自增水位保护),无需手工迁移
- 基表 wms_order_delivery 由迁移 20261008195000 补列(已执行开发库并核验)
- 验证:DISPATCH_FACTORY_TEST_MYSQL=1 临时集成测试 1/1 PASS
  (getCurrentModel(1000028) 后分表 is_b2b 列自动就位,默认 N);
  ESLint 0 error;生产分表随部署后工厂自动补齐
2026-10-08 22:03:27 +08:00
liufumingren
ee7f08b192 feat(order): wms_order_b2b 表模型与迁移内容(order_delivery 附属表)
- app/model/order_b2b.js:ctx.model.OrderB2b,order_id 关联 wms_order_delivery
  分表 id,uk_order_id 唯一,warehouse_id/store_id 维度隔离,软删除
- order_stockout.js 回滚 hasOne(OrderStockoutB2b) 关联
- 迁移内容改为 wms_order_b2b + delivery_order_code 快照
- 开发库已执行核验 14 列;生产库待随发布执行
2026-10-08 21:58:02 +08:00
liufumingren
2e42d47302 fix(order): B2B 作业明细副表改为关联 order_delivery(发货单)而非出库单
上一版误将 B2B 作业明细副表挂在出库单主表 wms_order_stockout 下,
实际业务为订单(发货单)侧作业:改为 wms_order_b2b,order_id 关联
wms_order_delivery 分表 id(类似 wms_order_express 运单号表),
delivery_order_code 为发货单号快照。

- 迁移 20261008193000-create-wms-order-b2b.js(表 wms_order_b2b)
- 模型 app/model/order_b2b.js(ctx.model.OrderB2b),删除 order_stockout_b2b
- 回滚 order_stockout.js 的 hasOne 关联
- 开发库已撤销旧表并重建新表核验 14 列;生产库待随发布执行
- 字段:total_box_count/pickup_plate_number/prep_remark/
  prep_duration_seconds/is_picked_up/picked_up_at/delivery_order_code
2026-10-08 21:57:53 +08:00
liufumingren
55a6a484dc feat(stockout): 新增 B2B 出库作业明细副表 wms_order_stockout_b2b
- 与出库单主表 wms_order_stockout 一对一(order_id 关联主表 id,uk_order_id 唯一),
  不分表(类似 wms_order_express 运单号表),warehouse_id/store_id 维度隔离
- 字段:总箱数 total_box_count、提货车牌 pickup_plate_number、备货备注 prep_remark、
  备货用时 prep_duration_seconds(秒)、是否提货 is_picked_up(Y/N)、提货时间 picked_up_at、
  出库单号快照 stockout_order_code + created_at/updated_at/deleted_at
- 索引:uk_order_id、idx_warehouse_id、idx_store_id、idx_stockout_order_code、
  idx_pickup_plate_number、idx_is_picked_up、idx_deleted_at
- 关联:OrderStockout.hasOne(OrderStockoutB2b, as='b2bWork')
- 迁移 20261008193000 已在开发库(127.0.0.1:3307)执行并核验 14 列+8 索引;
  生产库待随发布执行
2026-10-08 21:54:56 +08:00
liufumingren
8112430c37 perf(stock.report): 库存报表导出改游标分批+ExcelJS 流式,参考订单导出架构
- 原实现:明细一条大 SQL 全量拉回(货主 1000305 单次 16.9 万行),
  SheetJS aoa_to_sheet 全内存构建 490 万单元格后一次性 XLSX.write 序列化,
  生产实测总耗时 81.7s(其中 Excel 生成约 30~50s、内存峰值约 2GB),
  且进度只有 10/100 两档,中间 80s 零反馈被误判卡死
- 改造(对齐 order_export 流式架构):
  1) 明细按主键 id 游标分批拉取(batchSize=5000,走 PRIMARY 索引,
     生产实测每批约 95ms、末批不满即止无空探测),行序由 created_at,id
     变更为 id 升序(自增序≈插入序)
  2) ExcelJS.stream.xlsx.WorkbookWriter 流式落盘(useStyles/useSharedStrings
     关闭),逐批行级 commit,内存占用从约 2GB 降到批级
  3) 富化映射(商品/货主/条码/入库单/订单/运单)改为按批加载
  4) onProgress 每批上报 current_count/total_count,进度 5→95→100 平滑
- excel.js 新增 uploadExistingFile:流式生成场景复用上传链路
  (归一化文件名/buildUploadKey/uploadFile/uploadSuccessNotify),
  供 WorkbookWriter 落盘后 createReadStream 上传
- systemMethods 层 export/exportStore 接 onProgress 并持久化
  current_count/total_count 字段(向前端兼容订单导出进度组件)
- 验证:storage_report_export.test.js 2/2 PASS(12000 行游标 3 批、
  进度序列 5/95/100、回读 Excel 校验 sheet/表头/行数/单元格值、
  空数据仅表头);生产只读探测 EXPLAIN 走 PRIMARY range、
  首尾页约 95ms;ESLint 4 文件 0 error
2026-10-08 19:33:21 +08:00
liufumingren
a123009159 fix(stockout): 出库单明细 item_id 统一落 StockStore 主键 id,修复非数字 itemId 导致建单失败
- 奇门 stockout.create 调用方把「编码+名称」拼接串同时放入 itemId/itemCode/itemName,
  itemCode 降级精确匹配成功并解析出 stock_id 后,item_id 仍落报文原值(非数字),
  写入 BIGINT 列触发 MySQL 严格模式 1366 Incorrect integer value 建单失败
- 对齐 entry_order 建单口径:item_id 统一写实际匹配到的 StockStore 主键 id(纯数字)
- 验证:test/temp_test_stockout_itemid_normalize.js 5/5 PASS(非数字 itemId 降级匹配
  建单成功 + 数字主键回归);生产日志核实:2026-10-08 10:09 奇门请求
  app_key=23204092,stock_id 解析正确仅 item_id 落库报错
- 文档同步:methods/qimen.json 0.3.10 -> 0.3.11,stockout.create 补充 item_id
  归一化 notes + changes 变更记录
2026-10-08 16:07:59 +08:00
liufumingren
d07e48c4af feat(order): 订单工作台列表与订单导出增加复核时间 recheck_time
- 列表字段 ORDER_LIST_BASE_ATTRIBUTES 增加 recheck_time,工作台列表返回复核时间
- 订单导出 waybill/item 两种模式列配置增加「复核时间」列(recheck_status 后)
- 导出行映射 commonFields 增加 recheck_time 格式化输出(空值输出空白)
2026-10-08 00:59:56 +08:00
liufumingren
6094f4720d fix(order.export): 导出表头 商品种数/商品件数 更名为 订单商品总类数/订单商品总数(同步拦截订单报表与文档) 2026-10-07 23:54:42 +08:00
liufumingren
b6a9bc8f33 Revert "fix(returnUnpack): 退回拆包导出表头更名 商品总数/商品类数 → 订单商品总数/订单商品总类数"
This reverts commit 7ba10a1e4a7850a07049b48c52d7da5961a61649.
2026-10-07 23:53:08 +08:00
liufumingren
0fa098c188 feat(stock.check): workData 新增 only_abnormal 只看未盘与差异并同步接口文档(0.3.250) 2026-10-07 23:26:05 +08:00
liufumingren
49fb70fcbf fix(wave): 波次快递号分配后台任务等待分配真正完成并显式传仓库ID 2026-10-07 23:26:02 +08:00
liufumingren
7ba10a1e4a fix(returnUnpack): 退回拆包导出表头更名 商品总数/商品类数 → 订单商品总数/订单商品总类数 2026-10-07 23:25:58 +08:00
liufumingren
9743416187 feat: 盘点作业数据接口改造与账面口径全量统一(可用+锁定)
- workData 三视图:goods 视图 locations=商品所在全部库位列表(明盘每库位 system_quantity 账面/quantity 盘点、盲盘只显示库位);space 视图同口径;新增 workDataSpaceDetails 分页版
- workDataDetail 增加 goods 分支(单行结构,复用视图构建器);detail 补 profit_total/loss_total 差异汇总
- 库位账面全量统一为 SUM(available_quantity+locked_quantity)(可用+锁定)并标记 locked_quantity:result/report/finish/detail/addDetail 拆行快照与作业视图一致
- 未盘行不误显盘亏:diff/is_diff 仅存在作业记录时计算
- 文档 methods/system.json 0.3.249 + changes 变更记录,开发/生产库已回填
2026-10-06 03:24:41 +08:00
liufumingren
6ac3441109 feat: 收件任务体系(return_received_task)与退回权限调整
- 新增收件任务表 wms_return_received_task(自增 id 从 10000 起、批次号服务端自动生成 RT+日期+序号)
- 系统预设 id=1 历史收件;收件登记 wms_return_received 增加 return_received_task_id(缓存校验,未命中穿透建缓存)
- 任务接口:create/list/batchDelete/delete(有登记不可删、跨仓保护、has_register 筛选、register_count 统计)
- 移除 returnwaybill/returnReceived/returnUnpack 页面权限及角色组引用;权限标题「运单退回登记」改「未退登记」
2026-10-06 03:24:36 +08:00
liufumingren
5cd1479a92 fix(print): 面单发件人信息接入仓库主体 subject_config 兜底(签约策略未配置时) 2026-10-04 23:35:23 +08:00
liufumingren
0717640eff feat(waybill): waybill.warehouse.list/export 支持 mainWaybillCode 数组(0.3.243)
- systems/waybill.js 新增 resolveMainWaybillOrderIds:主单号单值/数组统一解析为 order_id 集合
  - 数组按 Op.in 精确匹配多个主单号,返回这些订单下的全部运单(主+子)
  - 单值仍写标量 order_id(向后兼容);主单号均不存在时直接返回空结果;空数组/全空值数组不加该筛选条件
- 新增回归测试 test/app/service/systems/waybill.warehouse.mainWaybillCode.in.test.js(13 用例,含 list/export 与仓库隔离)
- 接口文档:where.mainWaybillCode 类型改为 string|string[],并修正原「与 waybillCode 互斥、mainWaybillCode 优先」的错误描述(实际为 AND 叠加);根版本 0.3.242 → 0.3.243
- 设计文档 database/designs/waybill-module-design.md 同步(请求示例、参数表、查询逻辑、筛选条件清单)

注:methods/system.json 与 methods/changes/system.json 中同时包含上一批盘点(stock.check)的未提交文档改动(JSON 无法按 hunk 拆分)。
2026-10-04 18:50:03 +08:00
liufumingren
190d3cf9e5 feat(stock.check): 盘点模块功能扩展并同步接口文档(0.3.227)
- 盘点明细/记录支持未知商品(stock_id 可空)与库位范围,模式/状态口径修正
- 新增静态盘点任务、公告相关模型与迁移,stock_warehouse 增加预警数量
- methods/system.json 同步盘点接口文档;headers platform 微信端取值 wx 修正为 miniprogram
2026-10-02 15:43:49 +08:00
liufumingren
6c8a96de3b docs(methods): 同步盘点/回调注册表/手工运单号/收货绑定接口文档(0.3.205) 2026-09-30 03:08:59 +08:00
liufumingren
08f194c7d2 fix(receiving): 绑定关系软删除恢复与唯一索引冲突幂等修复(findOrCreate 撞 uk 索引) 2026-09-30 03:08:55 +08:00
liufumingren
8c50bcd6b7 feat(order): 手工录入运单号支持指定快递编码(express_code 同步订单快递信息) 2026-09-30 03:08:52 +08:00
liufumingren
576eb1b2e8 feat(order): 订单新增包裹总重量 packages_weight(称重回写与各端展示) 2026-09-30 03:08:49 +08:00
liufumingren
0bfc1ab5b2 feat(stock): 商品新增拣货/复核要求与要求合并开关(pick/recheck/merge_requirements) 2026-09-30 03:08:42 +08:00
liufumingren
cbd8d5bb78 feat(apiApp): 出站回调按 method 路由(callback_functions 注册表 + 多候选逐个尝试推送) 2026-09-30 03:08:27 +08:00
liufumingren
8c27cd08ed feat(stock): 盘点作业记录拆分,明细仅存商品快照、库位/数量入 wms_stock_check_record 2026-09-30 03:08:23 +08:00
liufumingren
30f2177f69 feat(stock): 新增库存盘点主表与盘点明细表 2026-09-29 03:50:36 +08:00
liufumingren
6756ba1474 feat(org): 新增组织架构表与模型 2026-09-29 03:50:34 +08:00
liufumingren
67f57f820d fix(order): 拦截请求按取消处理(未同步/手工单)与拦截确认无拣货行补建拦截锁
- batchIntercept/cancelOrderForInterceptRequest: 未同步订单与手工单拦截请求分流为取消处理,释放两层锁;已同步手工单按明细 inbound 回补 stock quantity(stockId 快速路径),取消后两层可用数守恒
- order_storage_allocation 拦截模式: 无拣货行订单补建拦截锁定(quantity/intercept 同增、available=0),写 INTERCEPT_LOCK 流水
- OperationLog 模型字段修正为下划线命名
2026-09-29 03:30:01 +08:00
liufumingren
e17461fe51 feat(scripts): 新增货主组/仓库组角色授权脚本
- scripts/auth/grant-store-up.js:货主侧全部角色批量授权(内置货主管理员角色
  store_admin_default + 各货主自建角色),permissions='*' 通配角色自动跳过
- scripts/auth/grant-wh-up.js:仓库链路角色批量授权(仓库组员工 27 -> 仓库组主管 26
  -> 经理 8),已拥有通配符权限的仓库管理员/超级管理员自动跳过
- 数据库配置按 env 从 config.default.js / config.local.js 加载,无内嵌凭据
- 用法:node scripts/auth/grant-wh-up.js <权限ID> / node scripts/auth/grant-store-up.js <权限ID>
2026-09-28 16:34:10 +08:00
liufumingren
7838e1cf03 fix(order,workbench): 散单称重拦截提示区分打包中状态
- pack_status=padding(打包中)时提示「订单打包中」,其余未完成状态仍提示「订单未打包」
- order_express.buildWeighPackBlockedMessage(packStatus) 恢复入参按状态区分;
  工作台 _assertSingleWeighPackedForWeigh 复用同一文案口径
- 判定规则不变:配置 single_weigh_require_pack 开启、wave_scope 非 1/3、
  pack_status 非 fin 时拒绝称重;团购波次批量称重不校验
- 测试:test/single_weigh_require_pack.test.cjs(27 用例全部通过)
- 文档:methods/system.json 0.3.195 -> 0.3.196,changes 新增 2026.09.28-weigh-pack-padding-message
2026-09-28 16:34:10 +08:00
liufumingren
f8081b876f feat(order.wave): 新增 order.wave.fetchableOrderCount 团购可抓取订单数统计接口
- 与 order.wave.groupOrderFetchList 同口径:同一候选条件(step in [1,2,3]、status!=cancel、
  outbound_status!=padding、intercept_status='none'、lock_status='none'、wave_id=0,叠加
  store_id/shop_name/stock_query 过滤)+ items_hash 粗分组 + 团购阈值过滤;
  仅取 id/items_hash/items/sys_logistics_code 四列做内存计数,不分页、不查订单明细
- 返回 data:group_count / order_count / same_order_quantity / raw_order_count /
  warehouse_id / distinguish_express;仓库上下文缺失返回 flag=failure/code=400
- 口径提示:order_count 为命中分组的订单数合计(与 groupOrderFetchList 的 pagination.total=分组数语义不同);
  include_sku 为 groupOrderFetchList 页内过滤参数,本方法不参与统计
- 权限与日志:已加入 wave.js systemInit 的 _noNeedRight / _noNeedLog / _noNeedAuth 名单
  (与 groupOrderFetchList 一致),仅需登录;不产生 wms_permission 记录,无需权限同步与迁移
- 文档:methods/system.json 新增 order.wave.fetchableOrderCount(根版本 0.3.194 -> 0.3.195、
  updatedAt 2026-09-28),methods/changes/system.json 新增变更记录;AI_METHOD_ROUTING.md 由脚本重新生成 service method 清单
- 测试:test/app/service/systemMethods/order/wave.fetchableOrderCount.test.js(8 用例);
  该路径命中仓库 .gitignore 的 test/* 规则,按既有约定未纳入版本管理
2026-09-28 01:32:03 +08:00
liufumingren
1fbc24c904 chore(deploy): 运维命令收敛为 install/uninstall,移除失效的 deploy:gateway-probe
- watchdog 部署工具只保留 install / uninstall:uninstall 先备份到
  /tmp/qimen-watchdog-uninstall-<时间戳>/(cp -a 保留权限/时间),再**注销调度**
  —— 删除 /etc/cron.d/qimen-watchdog 并清理 root crontab 中残留的 qimen-watchdog 行
  (历史手工安装可能留过,双跑会并发 kill/start 同一实例),随后删除服务器副本
  <部署根>/script/qimen-watchdog.sh 及其 .prev-* / .legacy-* 与历史根目录副本;
  不碰日志、锁文件与接口服务进程;支持 --dry-run 只打印计划。
  原 precheck 的只读环境快照改为 install 开头自动打印;status / dry-run / run
  三个命令删除(需要时直接 ssh 执行 <部署根>/script/qimen-watchdog.sh --dry-run)。
- 移除失效的 deploy:gateway-probe:npm 脚本未传必需的 method 位置参数,而
  gatewayProbe() 在缺参时直接抛错,命令必然 exit 1(CLI 契约与 npm 接线不匹配,
  该命令从未能成功)。删除 npm 命令与 script/deploy-ops.cjs 中的 gatewayProbe 实现;
  需要网关真实探活时直连活跃端口(current.md:v1→6061 / v2→6062)。
- 两份发布 agent 文档中的 "npm run deploy:gateway-probe -- releaseProbe.ping {}"
  已删除 —— 其中的 releaseProbe.ping 这个 method 在应用内并不存在(双重失效),
  改为「直连活跃端口」的说明;README 同步运维命令清单与 watchdog 卸载说明。
- 顺手修掉 script/deploy-ops.cjs 两处历史 lint 问题(模板字符串改单引号、
  文件末尾补换行),该文件 lint 现已干净。
2026-09-28 01:21:55 +08:00
liufumingren
0918f2d572 feat(deploy): 证书同步改为单片段 include + ver 命名 + 声明式自愈与差集下线
- 站点内容外置为单一片段(upstreamInclude,运维维护):生成的 server 块 = 证书骨架 +
  一行 include <片段>,撤掉此前的 customDir 多片段方案;并强制 include 必须是绝对路径
  且文件已存在(nginx 解析相对 include 的基准是 nginx prefix,不是脚本 cwd,写相对路径
  会让 nginx -t 失败并回滚整轮变更),不满足直接 exit 1(dry-run 下仅告警)
- conf 命名加版本位 <domain>-<ver>.conf:轮转只改配置的 ver,旧命名自动清理并 reload
- 声明式对账自愈:证书 / 私钥 / server 块缺失或被改坏,按库内内容原子重建后统一
  nginx -t + reload(内容一致时零写入、零 reload);失败态(sync_status=2)同样参与
  收敛并在校验通过后回到 1;nginx -t / reload 属全局失败,只落 last_sync_error 下轮
  重试,不再把行写成 2 卡死
- 域名下线改为配置差集驱动:以「已配置 + 已验证 + 证书就绪」的期望集合为准(同一仓库
  只取 id 最小的一条),目录中属于本系统命名规则但配置里已无该域名的 conf / 证书直接
  删除并 reload;不再消费 retired_domain(该列仅作应用侧审计留痕)
- 证书未配置的行不写 conf 也不作为文件保留依据(遗留产物由差集回收,避免 conf 引用
  不存在的证书导致 nginx -t 全局失败),行状态回写 sync_status=0 待同步;证书非空但
  非法、域名形态非法才记行级失败(2)
- cert-sync 部署命令瘦身为 install / uninstall;新增 watchdog 部署命令(precheck /
  install / status / dry-run / run),安装路径统一到 script/;deploy-lib 保护生产运行时
  配置不被发布覆盖;README 补「发布与运维」章节(目录硬约定 / 定时任务 / 命令清单)
2026-09-28 01:02:23 +08:00
liufumingren
cb8a4244e5 feat(setting,order,workbench): 新增仓库配置「散单称重是否需要打包」并在散单称重前校验打包状态
- 新增仓库配置 subject_config.single_weigh_require_pack(flag,默认 false=关闭);
  元信息加入 WAREHOUSE_SETTING_FIELDS,默认值与 flag 校验加入 Store.normalizeSubjectConfig
- 称重前置校验:配置开启且订单 wave_scope 非 1(大团购)/3(小团购)、pack_status 非 fin 时拒绝称重,
  统一返回「订单未打包」;订单未命中/仓库上下文缺失/配置读取异常时降级放行,不阻断称重主流程
- 覆盖 order.updateExpressWeighingWeight(订单模式与运单号模式的散单路径,统一挂 _updateSingleOrderWeight)
  与 workbench.sendWeight(复用已查 orderRow,不二次查表);团购波次批量称重不校验
- 新增回归脚本 test/single_weigh_require_pack.test.cjs(26 用例全部通过)
- 同步接口文档 methods/system.json(version 0.3.194)与变更记录 methods/changes/system.json
2026-09-27 16:23:58 +08:00
liufumingren
360e47415b feat(ops): 新增 qimen 接口服务看门狗脚本(5 分钟探活 + 按 deploy 方式自愈)
生产每 5 分钟探活一次当前版本;连续 4 次探活失败则按 script/deploy-remote.cjs 完全相同的
方式恢复:释放目标端口残留进程(kill → sleep 30 → 仍占用则 kill -9 + fuser -k)→
cd <目标版本目录> && nohup bash -lc 'npm start' > /tmp/wms-<ver>-start.log 2>&1 & →
curl -fsS --connect-timeout 2 --max-time 3 健康检查 10 次 × 2s(与 deploy 的 20s 等待窗口一致)。

保活范围取 current.md 与 nginx-upstream.conf 两个来源的并集(去重):发布过程中二者会短暂
不一致,取并集可避免「nginx 实际转发的那个实例挂了却没人管」;两者不一致时打印 WARN。

两个关键设计:
- 探活失败要重试 3 次(共 6 秒)才动作:deploy 先写 current.md、再启动新实例,中间约 3 秒
  空窗,6 秒重试确认正好覆盖,避免看门狗与 deploy 同时启动同一实例;
- 启动前按目录清理孤儿 node 进程:master 被 kill -9 后 worker 会被 init 收养继续运行
  (端口已释放但进程还在),不清就再次启动会出现两份实例 → egg schedule 重复执行
  (重复推送 / 重复回信)。

其它:flock 串行化防重叠;支持 --dry-run 只检活不启动(用于验证);一次运行输出一行、
约 16 KB/天,无需轮转。

系统级定时任务放在 /etc/cron.d/qimen-watchdog 而不是 root crontab —— 宝塔面板会整体重写
root crontab,放那里会被冲掉:
  */5 * * * * root /www/wwwroot/qimen/qimen-watchdog.sh >> /www/wwwlogs/wms/qimen-watchdog.log 2>&1

服务器上的稳定副本位于 deploy 根目录 /www/wwwroot/qimen/qimen-watchdog.sh(不受版本切换与
发布清理影响,发布只清理 v1/v2 目录),本文件是它的源;更新后需重新安装到该路径。
2026-09-27 03:25:20 +08:00
liufumingren
3c252a65d3 feat(deploy): 证书同步脚本支持站点个性化配置外置(customDir 契约)
生成的 server 块不再内联 location /,改为只含证书骨架(listen / server_name /
ssl_certificate*),尾部以 include <customDir>/<domain>/*.conf 收口;站点级
location / root / 伪静态等个性化配置由运维放进该目录,脚本绝不内联、绝不覆盖。
默认目录 <confDir>/custom(生产 /www/wwwroot/nginx_config/custom、开发
D:/wms/nginx_config/custom),位于部署根上一级之外,发布回退不会触碰。

配置入口:新增 `--custom-dir` 参数、`CERT_SYNC_CUSTOM_DIR` 环境变量与配置键 customDir,
缺省即 <confDir>/custom;--help、参数解析默认值与启动日志同步补充。

目录维护(ensureCustomConf,幂等且绝不覆盖用户文件):
- 递归创建 <customDir>/<domain>/(0755),保证 server 块 include 的通配符始终合法
  (目录不存在 / 目录为空 / 目录有文件 三种情况 nginx -t 均通过,已在生产 nginx 1.28.0 实测);
- 目录内已有其它 *.conf → 视为用户自定义配置:不写默认文件,并删除脚本自产的
  00-default.conf(避免两个 location / 触发 nginx duplicate location);
- 目录内无其它 *.conf → 首次原子写默认文件 00-default.conf(0644,首行带脚本标记),
  已存在(无论是否被运维改过)一律不覆盖;
- 只有带脚本标记的文件才可能被删除,无标记文件一律不动;dry-run 只打印计划、不落盘。

其它:
- server 块内容校验放宽为「upstreamInclude 或 customGlobPath 命中即可」(upstream
  include 现在位于外置文件内,不再直接出现在 server 块里);
- 旧域名下线仍只删 confDir 根层的 server 块,custom/<domain>/ 目录保留不删
  (旧块删除后其 include 已失效,残留目录无副作用,可被运维移作他用)。
2026-09-27 03:13:21 +08:00
liufumingren
01454bb916 chore(git): 数据库备份产物不再入库,database/backups 整体忽略
- `git rm --cached database/backups/wms_workbench_prod_backup_20260906132437.sql`:
  仅取消版本跟踪,文件仍留在磁盘;历史提交中的内容不受影响。
- `.gitignore` 新增 `database/backups/`,覆盖 prod-pre-migration-* 迁移前快照目录
  (SequelizeMeta-before.json / tables-before.json 等),避免它们长期以未跟踪状态
  出现在 git status 里、被误 add。

说明:这些是诊断/留档产物,不属于源码。`temp/`、`tmp/`、`logs/`、`run/`、`runtime/`、
`typings/`、`test_reports/` 等已在忽略之列,本次只补齐 `database/backups/`。
2026-09-27 03:10:52 +08:00
liufumingren
d129103d0b refactor(log): 接口流水改用 Egg 日志落盘,整表下线 wms_system_log
背景:接口流水原本逐条写 wms_system_log 单表(生产 687,030 行、.ibd 28.8 GB、DATA_FREE 仅 5 MB),
删行无法把空间还给操作系统;且每个 needLog 请求都要多一次 INSERT。改为经 Egg 自定义 logger 平铺落盘,
整表 DROP 回收磁盘(生产实测释放 28.8 GB,/www 可用 20G→49G);日志目录同时由 /root/logs/wms
迁到 /www/wwwlogs/wms,不再占用系统盘。

新增 app/lib/api_log_sink.js:
- 一行一条 `HH:mm:ss {JSON}`:前缀是本地时区时分秒,只给人眼定位(tail/grep 的时间锚点),与行内
  created_at(UTC ISO 8601)是同一时刻;机器解析请用 created_at。
- 时间前缀刻意放在代码里而不是 config 的 formatter —— 生产 config 不参与 deploy、由人工维护,
  放代码才能随发布自动生效(此前已因「代码上线、配套配置没上」出现过接口日志静默丢失)。
- 对象/数组一律 JSON.stringify,避免调用方漏 stringify 时落盘成 "[object Object]"。
- customLogger.apiLog 缺失时每个 worker 显式告警一次:egg 的 getLogger(name) 对未声明的 name 返回
  null 而不抛错,不处理就会「既不落盘、也无任何报错」。

新增迁移 database/migrations/20260927090000-offline-wms-system-log.js:
- up 用 information_schema 探测后 DROP TABLE(幂等);该表对 wms_store 是出边外键,无需关外键检查。
- down 用原生 DDL 重建:queryInterface.createTable 在 MySQL 下默认字符集是 utf8mb3,且不会生成原始
  DDL 里的 created_at ON UPDATE CURRENT_TIMESTAMP,只有原生 DDL 才能忠实还原。
- 已在开发库跑通 up → down → up:重建后 14 列、主键、store_id 索引、外键、utf8mb4 均与下线前一致。

下线代码:删除 app/model/system_log.js、app/service/systems/system_log.js(60 天保留期清理服务)、
app/schedule/system_log_cleanup.js(每日 03:00 清理任务);移除 config.systemLog(writeToDb 回滚开关)
与 config.systemLogCleanup;api_log_sink 不再保留任何入库分支。

文档与脚本:AI_METHOD_ROUTING.md 第 6 节清单移除已下线的 systems/system_log.js(文件数 220→219);
script/method-output-regression.cjs 的回放样本来源由 `SELECT ... FROM wms_system_log` 改为读
wms-api.log(含按天轮转文件),并改为先整体 parse、失败再截到第一个 `{` 重试,兼容带/不带时间前缀
两种行(在真实 EggLogger 上验证:FileBufferTransport 每 1000ms flush,需等过 1s 才能读到)。

注:按日切割与 31 天清理由 egg 内置 egg-logrotator 自动完成(walkLoggerFile 覆盖 customLogger),
无需额外配 cron。
2026-09-27 03:05:15 +08:00
liufumingren
aca6867d57 feat(order,return): 打包任务列表新增打包员筛选、拆包单列表新增拆包人筛选
order.packing.list / order.packing.export 新增 where.operator_text(打包员,目标列 wms_pack_task.operator_text,多人姓名逗号拼接快照):
支持 {operator,value,type} 标准结构,value 支持字符串或数组(多值取并集);contains/like 与缺省为 LIKE '%值%'(通配符已转义)、
eq/in 精确、ne 不等、notlike 逐个排除;值为 ''/null/空数组时忽略该条件。

returnUnpack.list / returnUnpack.export 新增 where.unpacker_name(拆包人,目标列 wms_return_unpack.unpacker_name 工号名称快照):
{operator:'like',value} 或直接值为 LIKE '%值%',value 为数组时多值 LIKE 取并集(_resolveConditionValue 的 like 分支增强,标量行为不变);
文本字段循环跳过空值条件,避免生成 unpacker_name IS NULL 的恒空条件。两个 export 与 list 复用同一 _buildListWhere,语义自动对齐。

顺带修复:where.operator_text=null 经 prepareWhereContext 归一为 {operator:'eq',value:null} 后,
原「?.value ?? 原条件对象」写法会 String() 出 '[object Object]' 条件把列表清空,改为「条件对象只取 .value」。

文档:methods/system.json 更新 order.packing.list/export 与 returnUnpack.list/export 共 4 处参数说明(版本 0.3.190→0.3.191),
methods/changes/system.json 追加变更记录 2026.09.26-order-packing-returnUnpack-where-person-filter。
测试:新增 order_packing.list.operatorText(13 例)与 return_unpack.list.unpackerName(6 例),
test/support/where_matcher.js 补充字段级 Op.or/Op.and/Op.not 支持;相关 4 个测试文件 37 passing。
2026-09-26 19:03:48 +08:00
liufumingren
81127b61aa fix(auth): 角色切换按平台维度清理缓存,修复小程序端切换身份不生效
changeRole 写库用的是请求头 platform 原值(如 miniProgram),但清缓存调用的却是
clearUserCache(userId)(不带平台),其内部只清 web/pda/mini/app/workerstation/workstation
这几个硬编码平台;miniProgram/wx 等取值不在清单内,且 Redis key 大小写敏感,
user:info:{accountId}:{platform} 会残留切换前的旧身份,紧随其后的 findById 命中 5 分钟旧缓存,
导致签发的 token current_role_id 与返回的 data.user 都是切换前的角色
(实测出现 current_role_id=34 + current_store_id=1000000 这种自相矛盾的 token)。

修复:clearUserCache(user.id, platformCode),并同步清理
platform_active:{accountId}:{platformCode}(30 分钟 TTL)。

验证(开发环境 temp/verify-change-role-fix.cjs):注入旧身份缓存后 user.info 返回注入值
→ changeRole 返回 employees_id=33,token 的 current_role_id/current_store_id 自洽
→ 回读缓存已刷新,DB 行保持 33 未被改动。
2026-09-26 18:00:20 +08:00
liufumingren
0a31b3aab1 feat(deploy): 证书同步脚本新增 retired_domain 旧域名下线清理与孤儿兜底清理
- warehouse-cert-sync.cjs 消费 wms_warehouse_front_config.retired_domain:
  新增 --cleanup-only / --dry-run 能力,删除旧域名 nginx server 块与证书/私钥文件后
  把 retired_domain 置 NULL;另含 certDir/confDir 目录内孤儿兜底清理
  (路径前缀校验 + 命名白名单双闸门,删除失败只告警不中断;未执行迁移时降级跳过)
- deploy-cert-sync.cjs 新增 cleanup-dry-run / cleanup 远端命令,用与 crontab
  相同的 flock 锁文件串行化执行(缺 flock 时告警降级不加锁,不阻断运维)
- package.json 补充 deploy:cert-sync:cleanup-dry-run / deploy:cert-sync:cleanup 脚本
- 顺带为 precheck/install/status/config-check 4 个函数补齐中文 @param JSDoc

注:为 frontConfig 两阶段切域(3f5eb49)的配套下线闭环,生产库迁移 20260924180000
已先行执行(属 orphan meta 补齐入库)。
2026-09-25 23:42:01 +08:00
liufumingren
3f5eb49081 feat(frontConfig): 前端独立部署域名两阶段切换(pending 登记 + TXT 校验通过后提升)
- 迁移 20260924180000-add-pending-domain-to-wms-warehouse-front-config
  新增 pending_* 6 列、retired_domain/retired_at 与 idx_pending_domain/idx_retired_domain
  两个索引(生产库已执行)
- setDomain 只登记待验证域名并下发 TXT 校验码,不再「设置即生效」;
  TXT 校验通过后由 promotePendingDomain 提升(旧域名写入 retired_domain 下线队列、
  清空证书 5 列并重置同步状态),消除「改域名瞬间旧域名公共接口 404」中间态
- DoH 解析改为多端点顺序尝试(dohUrls:alidns → 223.5.5.5 → doh.pub),
  单端点 NODATA/NXDOMAIN 不再直接判定,必要时降级系统 DNS 并显式限时;
  config.frontConfig.domainVerify 同步 batchSize 50→20、timeoutMs 5000→3000
- getDomain/setDomain/checkDomain 响应追加待验证域名组 7 字段(旧 9 字段口径不变)
- 同步 methods 文档(frontConfig 6 方法)与 changes 4 条变更记录、
  AI_METHOD_ROUTING.md 函数清单(42→50)

注:本提交补齐此前已在生产库执行但从未入库的迁移与代码
(生产 SequelizeMeta 已含 20260924180000,属 orphan meta 补齐入库)。
2026-09-25 23:40:56 +08:00
liufumingren
1cccc6b4a4 feat(return): 退回查询日志新增登记来源字段,拆包完成通知按原查询来源定向回信
- wms_return_query_log 新增 group_id/group_name/user_id/user_name 登记来源字段
  (迁移 20260924160000-add-source-ids-to-wms-return-query-log,生产库已执行)
- 站内信「查退回」触发登记时写入来源群/用户(inbox/functions.js queryReturn 透传
  ctx.inboxContext);拆包完成通知不再泛推货主售后群,改为按登记来源 group_id+user_id
  定向回信(有用户信息走 writeOutboundReply,否则退化为来源群系统通知,
  登记无来源群的不通知),仅推送成功的登记标记 is_notified=1
- 同步 methods 文档:returnUnpack.submit / returnWaybill.create|list|detail
  响应补充来源字段说明,changes 追加 2 条变更记录

注:本提交补齐此前已在生产库执行但从未入库的迁移与代码
(生产 SequelizeMeta 已含 20260924160000,属 orphan meta 补齐入库)。
2026-09-25 23:39:29 +08:00
liufumingren
943c096c5a feat(index): 新增客户端错误日志上报接口 uploadClientErrorLog(建表 wms_client_error_log)
新增免登录/免权限/免鉴权的设备端运行时错误批量上报接口,保留系统日志:

- 建表迁移 database/migrations/20260925100000-create-wms-client-error-log.js(wms_client_error_log,uk_report_uuid 唯一索引幂等去重)
- 新增模型 app/model/client_error_log.js 与服务 app/service/systems/client_error_log.js(三种入参形态、字段归一化与长度截断、report_uuid 幂等;bulkCreate 用 validate:false 修复时间戳注入引发的 notNull 写入失败)
- systemMethods/index.js 新增 uploadClientErrorLog 出口并登记 _noNeedLogin/_noNeedRight/_noNeedAuth;_noNeedLog 由 '*' 改为显式清单 INDEX_NO_NEED_LOG_METHODS
- 文档同步:methods/system.json 版本升至 0.3.190、methods/changes/system.json 新增变更记录、AI_METHOD_ROUTING.md 补充 5.9 能力速查并同步第 6 节方法清单
- 测试:32 个服务层用例与 18 个 HTTP 回归用例通过(test/ 与 test_reports/ 按 .gitignore 约定不入库)
2026-09-25 03:14:15 +08:00
liufumingren
3d2291907e feat(workbench): 大团购打包时长按工作台打包人数分摊
- 等待秒数公式改为「大团购打包系数 x 当前波次打包数 / 当前工作台打包人数」:_packOrder 倒计时字段 pack_wait_seconds 与 _queryOrder 闸门均按人数分摊

- 新增 _countCurrentPackMembers:统计 wms_workbench_member 当前成员数,查询失败/为 0 时按 1 兜底(人数为 0 时任务已被成员全登出流程自动结束,不会出现 0 人任务)

- 闸门拉取当前打包任务仅统计进行中任务(status<2,任务已结束则不计)

- 测试:workbench.bigGroupTimeGate.regression.test.js 新增人数分摊用例(打包 2 人 1x3/2=1.5 秒、闸门 3 人 10x3/3=10 秒未到拦截/超过放行),共 13 用例全绿;ESLint 0 错误;workbench.js 语法通过

- 文档:methods/system.json 升至 0.3.183(pack_wait_seconds 描述改为人数分摊口径、big_group_pack_coefficient 描述统一),changes 新增 2 条记录,已同步库表(import+export)
2026-09-24 17:38:10 +08:00
liufumingren
c727cd1c5c fix(order): 已同步订单转拦截时补充售后工单创建与快递群通知
cancelOrder 中「订单已同步,不可取消,转为拦截处理」链路此前只写拦截状态、运单拦截标记与操作日志,
未创建售后工单、未按运单通知快递售后群,与 batchIntercept / 奇门取消 / OpenAPI 取消口径不一致。
现补充调用 afterSale.createInterceptWorkOrdersAndNotify(事务提交后执行,失败仅告警不影响主流程)。
2026-09-24 17:04:48 +08:00
liufumingren
f1fb6a7e19 fix(inbound): 直拨绑定模式 received_quantity 统一按实际入库记录量写入,多绑定明细取最后一条用于批次展示 2026-09-24 03:26:26 +08:00
liufumingren
3026465218 feat(inbox): 查退回函数兼容 v2 规则引擎 keyword 归并取号,补充售后类型 return/query_return 与 query_pack_video 配置链迁移 2026-09-24 03:26:24 +08:00
liufumingren
35d10f148b feat(dashboard): 工作台新增复检完成/打包完成订单统计,热销商品排行重写支持货主端跨仓聚合与商品名称脱敏 2026-09-24 03:26:21 +08:00
liufumingren
305d27bc5f fix(receiving): 收货未入库提醒可靠性增强(Redis 抢锁判定修正 + app 级兜底锁、逐货主群异常隔离、失败回退客服群、pushSystemMessage 幂等去重) 2026-09-24 03:26:18 +08:00
liufumingren
52181c44bd feat(frontConfig): 前端独立部署域名验证(DNS TXT 校验 + 验证闸门),frontConfig 接口从 setting.warehouse 迁移至独立 service(getInfo/getCert/saveInfo/saveCert/setDomain/getDomain/checkDomain) 2026-09-24 03:26:15 +08:00
liufumingren
05b2d08014 feat(wechat): 用户协议版本管理(getUserAgreement/setUserAgreement/getAgreementVersion 与清理定时任务)、工牌绑微信 bindByEmployee,wxaauth/uploadauthmaterial 接口路径迁移,wms_user_oauth 关联协议版本 2026-09-24 03:26:08 +08:00
liufumingren
24ffb5896e feat(method-doc): API 文档库表化维护脚本(create/update/get/list/delete/import/export)与 wms_api_method_doc 建表迁移 2026-09-24 03:20:23 +08:00
liufumingren
dd2f47c59c docs(agent): wms-doc-agent 规则升级为 system.json 库表化维护(method-doc 脚本工作流 + 函数清单同步) 2026-09-24 03:20:19 +08:00
liufumingren
4bf3268596 feat(workbench): 大团购打包系数与打包时长闸门,packOrder/queryOrder 响应新增 wave_scope 与倒计时字段
- 仓库设置新增 big_group_pack_coefficient(数字,默认 3,单位秒/单):store.js 默认值与归一化校验、setting.warehouse 字段元信息(type=number、min=0.1)

- workbench.queryOrder:响应 order 新增 wave_scope;当前工作台 wave_scope=1 打包任务未到「打包数x系数」秒时扫描其他波次订单返回「打包时长不足」,本波次放行,已到时不受限;闸门按 wms_pack_task.wave_scope=1 快捷判定

- workbench.packOrder:wms_pack_task 落库 wave_scope(服务端复查,非法/缺省兜底订单行值);响应新增 pack_wait_seconds(当前波次打包数x系数)与 pack_start_time(毫秒时间戳),仅 wave_scope=1 下发,其他为 0

- 迁移 20260924150000-add-wave-scope-to-pack-task.js:wms_pack_task 新增 wave_scope 列(幂等;开发与生产均已执行,生产因存在更早 pending 迁移改为等价 DDL+SequelizeMeta 记录)

- 测试:新增 workbench.bigGroupTimeGate.regression.test.js(11 用例全绿);workbench.queryOrder.performance.test.js 与基线一致(8 pass / 6 既有失败,非本次引入);ESLint 通过(workbench.js 历史类字段 parse error 为既有问题,与基线一致)

- 文档:methods/system.json 升至 0.3.181、changes 新增 2 条记录;已全量导入库表(wms_api_method_doc/wms_method_doc_meta)后重新导出,恢复 3 条库表已有但文件缺失的 setting.warehouse 前端配置方法
2026-09-24 03:16:35 +08:00
liufumingren
361e97236a docs(api): 同步 system.json 接口文档与变更记录(returnReceived 登记时间筛选与 is_urgent、dashboard.hot_order_rank 文档恢复),版本升至 0.3.176 2026-09-23 22:23:02 +08:00
liufumingren
beb9e06a08 fix(returnReceived): 修复登记时间筛选白名单缺失并补充 created_at/updated_at,登记响应新增 is_urgent 加急标记,配套 (warehouse_id, created_at) 索引迁移 2026-09-23 22:22:54 +08:00
liufumingren
a5a6ea4a93 chore(frp): 新增 frpc 隧道安装/启动脚本与配置,忽略本地 frpc.exe 二进制 2026-09-23 02:46:44 +08:00
liufumingren
fa112891a9 docs(api): 同步微信模块 system.json 接口文档与变更记录(wechat.* 系列方法) 2026-09-23 02:46:39 +08:00
liufumingren
68a7e1b17d feat(wechat): 新增 wms_user_oauth / wms_wechat_app 表迁移及登录码、模板、审核、授权信息等字段 2026-09-23 02:46:34 +08:00
liufumingren
258232f98d feat(wechat): 微信开放平台第三方平台接入:授权事件回调、加解密、OpenAPI 客户端、oauth 登录态中间层与工牌扫码 2026-09-23 02:46:28 +08:00
liufumingren
b6baece8ad feat(workbench): 打包扫描单响应补充拣货人 picker_id/picker_name(波次关联拣货任务) 2026-09-23 02:46:22 +08:00
liufumingren
a078d74122 feat(order): parseAddress 改为内置省市字典本地解析,新增 parseAddressLocal,移除 DeepSeek AI 解析依赖 2026-09-23 02:46:16 +08:00
liufumingren
01acf106ae refactor(order): 自动出库当天订单开关改排除语义,allow_same_day_outbound 更名为 exclude_same_day_outbound(默认排除) 2026-09-23 02:46:11 +08:00
liufumingren
ec632cf3e5 feat(after-sale): 新增取消拦截子类型,补齐拦截/揽收/错发/多发运单号取号规则与关键词迁移 2026-09-23 02:46:06 +08:00
liufumingren
dde026d7dd feat(inbox): help 清单按群类型白名单过滤并按 sort_order 排序,回复占位符 back_text 回退 message 2026-09-23 02:46:00 +08:00
liufumingren
e8526e2bef feat: 自动出库规则支持当天订单限制配置
- 新增 allow_same_day_outbound(出库当天订单,默认否)
- 新增 same_day_outbound_deadline_time(允许当天出库最后时间,默认 06:00;复核时间早于该时间的订单不受关闭影响)
- 新增 same_day_outbound_release_time(当天放开时间,默认 22:00;当天到达该时间后放开当天复核订单)
- 保存校验:允许当天出库最后时间不能大于当天放开时间
- 出库扫描按 recheck_time 过滤:到达放开时间前,当天最后时间之后复核的订单不自动出库(北京时间边界,UTC 存储换算)
2026-09-23 02:22:23 +08:00
liufumingren
bf4920475d docs(api): 同步 business 打包分支 users 恢复说明与变更记录 2026-09-21 19:25:26 +08:00
liufumingren
df0c1735c8 fix(workbench): business 打包分支恢复 users 上报打包人,token+key 新链路保持工作台成员回填 2026-09-21 19:25:22 +08:00
liufumingren
17944bcf01 docs(api): 同步 workbench 打包接口文档、变更记录与方法路由 2026-09-21 02:28:07 +08:00
liufumingren
f06dc3d765 feat(workbench): 打包链路重构:运单维度流水、成员自动回填与登出自动结束、token+key 消费模式、getWorkbenchInfo 字段补齐 2026-09-21 02:28:04 +08:00
liufumingren
e76a6e3fa4 fix(order): 奇门/openapi 查单与取消接口跨分表查单
新增 app/lib/order_lookup.js 共享辅助函数(preloadOrderModels/findOrderAcrossTables/
findOrderByCodeAcrossTables),按 current→dispatch→history→outsourced 顺序命中即停;
模型预取置于事务外(工厂首次获取可能执行 DDL 隐式提交),事务内查询支持透传行锁。

改造 4 处接口:
- qimen deliveryorder.query / openapi deliveryorder.query:跨表查单,
  订单流转到配送/历史表后不再误报"未找到订单"(避免货主误判重推);
- qimen order.cancel / openapi order.cancel:跨表查找,命中非 current 表
  且 status=cancel 时幂等返回取消成功,其余情况返回"未找到对应的订单"。

回归验证(真实网关,脚本在 test/ 不入库):
- openapi:query 命中 dispatch、cancel 幂等成功、不存在单号报错
- qimen:同 4 场景全部符合预期
2026-09-20 22:12:35 +08:00
liufumingren
ce3e0185e1 fix(order): 推单跨分表单号查重
delivery_order_code 查重由仅查 current 分表扩展为 current/dispatch/history
三表并发查重,命中任一表即拒绝重复建单;dispatch/history 模型获取可能执行
DDL(隐式提交),已移至事务外完成。
2026-09-20 18:39:20 +08:00
liufumingren
ce04778021 perf(order): quickSearch 改为逐级短路搜索
命中顺序:运单号(waybill_code) -> 发货单号(delivery_order_code) -> 平台订单号(source_order_codes),
每一级只要命中即停止后续查询,直接进入订单详情。

- 运单号:等值 + 剥离一单多件分段后缀主体等值 + 主体前缀 LIKE,走 waybill_code 索引
- 发货单号:等值走 idx_delivery_code_store;未命中再 %kw% 模糊兜底
- 平台订单号:%kw% 模糊仅作最后兜底

避免原单条 OR 查询混合等值与 %kw% 模糊导致优化器放弃索引、
退化为按 warehouse_id 全仓库扫描(生产单仓库 66w+ 行)。
dbg 调试日志改为持久写流异步写入,消除 appendFileSync 同步磁盘 IO。
2026-09-20 18:39:16 +08:00
liufumingren
c6224b471e chore(script): 临时脚本移入 temp 目录(gitignore 范围,退出版本控制) 2026-09-20 16:14:10 +08:00
liufumingren
dc9f83a2d7 perf(aftersale): 售后/退货拆包订单查询改为 attributes 白名单,减少全字段加载 2026-09-20 16:14:06 +08:00
liufumingren
1771b5c6c9 docs(api): 同步 system 接口文档、变更记录与方法路由(确认打印相关) 2026-09-20 16:14:03 +08:00
liufumingren
17f7e3d87b feat(print): 新增确认打印功能(confirm_print_status + confirmWavePrint/confirmPrintScan 接口) 2026-09-20 16:13:59 +08:00
liufumingren
a3ec20098f fix(stock): getStoreStocks 修复 store_id 过滤失效导致跨货主/跨仓库数据泄漏
- store_id/warehouse_id/软删条件原先放在 LEFT JOIN(required:false) 的 include.where 上,只进 ON 子句无法过滤主表 wms_stock_store,传 store_id 仍返回跨货主商品
- 过滤条件改为直接落在主表 where,count/findAll 同条件,total 恢复准确
- 返回的 store_id 字段补取 warehouse_stock.store_id,并加空列表访问保护
- 订单创建报错"库存记录不存在"补上商品编码 item_code,并区分场景改为"仓库已解绑,请联系仓库关联绑定"
2026-09-20 16:01:01 +08:00
liufumingren
e8f9ccad95 feat(workbench): getWorkbenchCount 班次打包统计 + packOrder 服务端复查落库
- 新增 workbench.getWorkbenchCount:以工作台 token 鉴权,统计本地 08:00→次日 08:00 班次窗口;
  个人工作台统计涉及本人数据(团购波次数量/团购订单数量/散单数量/团散/均件数),
  团体工作台统计涉及工作台数据(团购波次数量/团购订单数量/散单数量)
- packOrder 打包数量/商品总件数/商品种类数改为服务端复查:散单取订单分表、团购取波次实时统计
  (totalOrders + 波次 SKU 聚合 15s 缓存),设备上报仅交叉校验日志;修复散单 sku_count 兜底误读 item_count 列名
- wms_pack_task 新增 (workbench_id, create_time) 复合索引迁移,避免统计查询长跨度扫描慢 SQL
- 同步 methods/system.json(0.3.142)/methods/changes/system.json,刷新 AI_METHOD_ROUTING.md
- 一并提交上一轮未提交的 order.wave.batchList sync_assignment_status 输出与筛选
2026-09-20 00:31:06 +08:00
liufumingren
388809fc9f feat(workbench): getWorkbenchInfo 补全当前打包任务商品信息(散单明细/团购波次SKU聚合/免验字段)
- 抽取 _fetchOrderItemsDetail 公共方法(queryOrder 复用),散单任务 items 返回单笔商品明细(含条码/图片/包装要求/need_recheck 免验字段)

- 新增 _fetchWaveItemsSummary(15s 短缓存),团购任务 items 返回波次商品 SKU 聚合汇总(is_wave_summary=true),500 单波次本地实测聚合 1000 件与 items_total 一致

- current_orders 补 item_quantity/sku_count/waybill_code/order_type/store_id/items_count/items_total

- 文档同步 system.json 0.3.137 与 changes 三条变更记录
2026-09-19 15:09:31 +08:00
liufumingren
806e739267 feat(inbox): v2 规则引擎完善(help 指令/建单开关/系统回复)并修复拦截日志误写仓库 ID
- functions.js: 拦截/取消拦截波次感知写订单日志 businessId 误用仓库 ID,改为订单 ID
  (生产订单 JY2026091813795 已发起拦截但订单详情查不到拦截日志的根因)
- rules/v2/processor/config/functionSync: 新增 help 指令、create_work_order=0 时跳过
  工单登记、系统级回复与无单号提示、白名单范围修正
- after_sale_reply 模型 + 6 个迁移: create_work_order 字段与相关配置种子
- return_unpack: 列表 count 统计修复、分页排序追加主键防重漏行、视频附加 camera_name
- methods/system.json + changes + sync 脚本: 接口文档与权限同步
2026-09-18 22:38:57 +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
a667f1401e feat(inbox): 推送失败自动重发改为仓库级开关与重发时间范围(默认关闭)
仓库设置新增嵌套配置 `subject_config.inbox_push_retry = { enabled, window_minutes }`,
结构与「收货未入库提醒」(receiving_pending_inbound_notice)保持一致:

- `enabled`:默认 false —— 未配置、配置缺失或无法读取时一律**关闭**,需在仓库设置中显式开启
- `window_minutes`:重发时间范围,单位**分钟**,1-1440,默认 30(仅开关开启时生效)

改动:

- app/model/store.js:新增 DEFAULT_INBOX_PUSH_RETRY 与 normalizeInboxPushRetry(非法结构/非法 JSON
  回退默认;enabled 非布尔值、window_minutes 越界抛「subject_config.inbox_push_retry.window_minutes
  必须是 1-1440 的整数(分钟)」),由 normalizeSubjectConfig 统一调用
- app/service/systems/setting/warehouse.js:WAREHOUSE_SETTING_FIELDS 新增 key=inbox_push_retry
  (type=object + item_keys=[enabled, window_minutes]),供仓库设置页经 getFieldMeta 动态渲染
- app/service/inbox/message.js:retryFailedByWarehouse 逐仓读仓库设置(缺省关闭、按仓库配置的窗口
  调用 retryFailed);retryFailed 新增 warehouseId 过滤;readPushRetryConfig 读嵌套结构并兜底
  enabled=false / 30 分钟
- app/schedule/retry_inbox_push.js:注释同步为「仅处理显式开启的仓库、缺省 30 分钟」
- config/config.default.js:兜底失败时间窗 2 小时 → 30 分钟;pushRetryEnabled 保留为全局应急总闸
  (默认 true,关闭后所有仓库都不重发)

单测:test/inbox/retry_inbox_push.test.js + test/app/model/store.test.js 共 40 passing,覆盖默认关闭、
非法结构回退、flag 真值归一化、窗口 1-1440 越界、仓库开关与自定义窗口、复用原记录等场景。
2026-09-16 15:04:25 +08:00
liufumingren
1571de341c feat(storage): 新增收货未入库提醒定时任务(货主/客服群通知,短语可配置)
- 新增 app/service/systems/receiving_pending_notice.js:扫描「创建时间超过 min_hours 且不足 max_hours 仍未完成入库」的收货单(wms_receiving 未作废、is_deleted=0,且 status=receiving 或 storage_status<>all),
  按货主聚合成一条消息;未绑定货主的单独一批
- 新增 app/schedule/notice_receiving_pending_inbound.js:每 5 分钟单 worker 检查,按各仓库配置的提醒时间(默认 08:30,宽限 10 分钟覆盖调度抖动)执行,
  进程内防重入 + Redis 当日锁 receiving_pending_notice🔒{warehouseId}:{YYYYMMDD}(NX/EX 24h,执行异常释放锁允许窗口内重试),保证每仓库每天只提醒一次
- 仓库设置新增字段 wms_store.subject_config.receiving_pending_inbound_notice:
  enabled(是否通知收货未入库,flag,默认 0 关闭)/ notice_time(提醒时间 HH:mm,默认 08:30)/ min_hours(超时下限,默认 24)/ max_hours(超时上限,默认 48,须大于 min_hours)
  / notice_template(仓库客服群通知短语)/ store_notice_template(货主群通知短语)
- 通知短语可配置并支持变量替换:{warehouse} {warehouse_id} {store} {store_id} {count} {min_hours} {max_hours} {date} {numbers};
  未识别占位符原样保留,留空回退默认短语,最长 500 字符(超长 400)
- 消息结构统一为「短语 + 换行 + 明细(一行一条,最多 20 行,超出提示剩余单数)+ 快速查看/详情查看链接」,不再在结尾追加句号
- 新增通知事件 receiving_pending_inbound(notification_webhook 事件注册 + notice DEFAULT_REGISTERED_EVENT_CODES)与固定群订阅:
  store:receiving,fallbackTargets=warehouse:customer_service —— 有货主推货主收货群,无货主或货主未配收货群时推仓库客服群(出站仍走 notify.reply,落 wms_inbox_message)
- 文档:methods/system.json 的 setting.warehouse.getSettings/saveSettings 补充该配置字段(版本 0.3.129 -> 0.3.131),
  变更记录新增 2026.09.15-warehouse-pending-receiving-notice / -notice-template(system)、2026-09-15-warehouse-01 / -02(warehouse,事件注册与文案结构);
  AI_METHOD_ROUTING.md 同步刷新(新服务 14 个方法)
- 单测 test/app/service/systems/receiving_pending_notice.test.js(11 用例:开关关闭/未命中提醒时间不执行、超时窗口查询条件、货主群通知、无货主回退客服群、
  当日只提醒一次、推送失败不重复、扫描异常释放锁重试、行数截断、非法配置回退默认、短语变量替换与明细逐行、未识别占位符保留)全部通过;npx eslint 无告警

同时提交上一轮未提交的 camera/PTZ 改动(app/lib/ptz_client.js 新增、systems/camera.js 与 systemMethods/camera.js:PTZ 下发给打印服务时请求体统一携带 cameraId),
其文档与路由清单改动与本提交共用 methods/system.json 等文件,无法按行安全拆分,故合并为一次提交。
2026-09-15 23:49:34 +08:00
liufumingren
e666abc0a2 feat(inbox): 新增出站推送失败自动重推定时任务
新增 app/schedule/retry_inbox_push.js:每 3 分钟扫描「push_status=3 且失败时间在 2 小时内」的
出站消息并重推(config.inbox.pushRetryWindowMs / pushRetryLimit,单轮默认 20 条、硬上限 200),
成功即停、失败下一轮继续、超出窗口不再补推;worker 单进程执行 + app._inboxPushRetryRunning
重入锁,scanned>0 才写日志。

- inbox.message 新增 retryFailed():按 created_at ASC 逐条串行重推(先补更接近窗口边界的),
  缺 warehouse_id/group_id/group_name/content 的记录跳过并告警,retry_count 递增仅作观测
- inbox.message 新增 _repush():复用原记录重推(reuse_message_id),ext_id 剥离 sys:ack: 前缀,
  有用户信息走 ai_reply、系统通知走 system;重推期间不改记录状态,进程中断时下一轮仍能扫到
- processor.writeOutboundReply 支持 reuse_message_id:重推时跳过按 sys:ack:{ext_id} 查建记录,
  推送结果回写到原记录本身,修复系统通知(sys:notice:*)重推会另建记录、原记录状态永远停留在
  失败/待推送的问题;状态回写由 ext_id 改为按记录 id(对既有调用路径等价)
- 手动重推 retry() 改走 _repush,入参与响应文案不变,methods/system.json 无需变更

失败主因是桥接离线(回调 HTTP 200 但 body code=503:wx offline / qiwe offline),属可自愈的
临时故障;此前仅支持人工单条重推,生产已积压 2441 条未送达的客户回信与系统通知。

单测 test/inbox/retry_inbox_push.test.js 18 例(纯 mock,覆盖调度配置/重入/异常兜底/扫描条件/
窗口与上限/复用原记录/跳过与容错);AI_METHOD_ROUTING.md 方法清单已刷新(inbox/message.js 7 → 9)。
2026-09-15 22:38:38 +08:00
liufumingren
74e53d4d87 feat(order): 新增配送表超期订单归档到历史表定时任务
- 新增 systems/orderDeliveryArchive(app/service/systems/order_delivery_archive.js):
  把 wms_order_delivery_{仓库}_dispatch 中 dispath_time 距今超过 3 个月、或 create_at
  距今超过 4 个月的订单(不限状态)归档到 _history 分表;dispath_time 为 NULL 的存量
  订单不特殊处理,SQL 三值逻辑下自动由 create_at 条件兜底
- 单批默认 1000 条、一个事务内完成:写历史表(剔除历史表不存在的
  dispatch_lane/dispath_time、写 archive_time=归档时刻、id 原样复制)→ 同步复制
  wms_order_items_*_dispatch 商品明细(补 archive_time)→ 更新订单索引表
  wms_order_id_location_* 的 location 为 history → 删除源行(先子表后主表),任一步
  失败整体回滚,不产生「历史表有数据但配送表没删」的中间态
- 可续跑 / 防中断:批量提交且提交即删除源行,重跑天然幂等;实际条件列
  (create_at/dispath_time)无索引,故按主键 id 游标取候选、禁用 OFFSET;单批遇
  死锁/锁等待重试 3 次后跳过该批并推进游标(上报 failedBatches/failedCount),
  不中断整轮;单轮时长预算 maxRunMs 用尽即停止本轮,剩余订单下一轮继续
- 历史表已存在同 id 记录(历史残留/人工补数)时不重复写入但仍清理源行,保证重复
  执行结果一致
- 新增 app/schedule/archive_dispatch_orders_to_history.js:默认每日 06:00 单 worker
  执行(cron 可配),Redis SET NX EX 跨进程互斥(进程被杀靠 TTL 释放)+ 批级进度
  缓存 + 执行日志缓存,上一轮 status=running 时按断点续跑
- 新增 config.orderDeliveryArchive 配置:开关/cron/归档门槛月数/单批条数/单仓批次
  上限/单轮时长预算/查询超时/重试次数/锁 TTL
- 本地开发库实测 44 项断言全部通过:字段保真(订单与明细逐列一致、archive_time
  正确、无 dispatch_lane/dispath_time、id 原样复制)、索引表位置更新、源行删除、
  幂等复跑、注入失败整批回滚、单批失败后继续、限额用尽后重跑续传、预算用尽停止、
  无同 id 双写与孤立明细残留;Egg 已正确注册该定时任务
2026-09-15 18:19:57 +08:00
liufumingren
4bf34410a3 fix(report): 报表投递/通知 ext_data 改为透传群配置,避免渠道来源 source 丢失
deliverByChannel 与 sendNotifyIfConfigured 原自行组装 extData={report_definition_id,biz_date,time_point,file_url},覆盖了群配置 ext_data(含渠道来源 source),桥接因缺少 source 无法投递;现统一改为 extData = groupRow.ext_data || null(与 notice 推送口径一致),仅成员推送(无群)显式传 null。
2026-09-15 18:14:43 +08:00
liufumingren
aff7a4fe22 docs(api): 同步 system 接口文档、变更记录与方法路由
- methods/changes/system.json 补 6 条变更记录:
  - returnUnpack.transferByWaybills 新增及入参 waybill_codes → ids(运单表主键)
  - order 各列表补充 create_channel 查询条件说明;修正 pendingOrder/outboundOrder
    默认筛选描述
  - storage.inventory.updateExpiry 新接口
  - workbench.packOrder / finishPack 打包结束复位 OSD
  - order.pendingOrder.syncOrderIds 同步顺序(先回传、成功再扣减)
- methods/system.json 同步上述接口描述
- AI_METHOD_ROUTING.md 重新生成方法清单(order_async / receiving_entry_match /
  return_unpack / storage.inventory / stockout_order / storage.entry /
  wave_batch_closure / workbench 等模块方法数变化)
2026-09-15 16:19:22 +08:00
liufumingren
4d8297aecb fix(openapi): 入库单 ownerCode 补齐到 qimen_owner_code
- OpenAPI 合约上下文的 customerId 恒为 null,导致 API 来源入库单 qimen_owner_code
  为空、出站回传 entryorder.confirm 的 ownerCode 为空
- entryorder.create 改为用报文 entryOrder.ownerCode(trim 后)补齐 customerId,
  落库口径与奇门侧一致(奇门侧取请求上下文 customerId)
- 补充字段生效口径注释:warehouseCode 一律以 app_key 合约解析结果为准,
  operateTime / operatorName 当前未被底层消费,保留仅为兼容调用方
- 同步 methods/openapi.json 与 methods/changes/openapi.json(标准请求/响应 JSON
  示例 + 字段生效口径说明)
2026-09-15 16:19:10 +08:00
liufumingren
4edfd951c5 fix(print): 视频号面单自定义区最多保留 8 行
- 新增 SPH_CUSTOM_INFO_MAX_LINES / SPH_CUSTOM_INFO_LINE_BREAK 常量与
  truncateSphCustomInfoLines helper:视频号面单自定义区仅可容纳 8 行文本,
  第 9 行起整体舍弃(含首行头部与子单号行,空行同样计入行数)
- applySphExpressFieldMapping 在合并子单号行、头部行、商品明细行与额外自定义行
  后统一截断,避免客户端溢出错版
2026-09-15 16:19:04 +08:00
liufumingren
df641257cc fix(wave): 波次闭环判空二次确认,避免瞬时空表误终结波次
- wave_batch_closure.js 新增判空二次确认:同一波次需连续两轮(间隔不小于
  confirmMinIntervalMs,默认 30s)都被判定为空才允许终结,确认状态写 Redis
  (TTL 1h);状态缓存不可用或读取异常时本轮不终结任何波次(宁可漏关、不可误关)
- 规避批量解波/订单迁移进行中造成的瞬时空表误判(2026-09-12 生产事故)
- closed_count 改为 UPDATE 实际影响行数,新增 empty_count / confirmed_count /
  pending_confirm_count 等统计与日志(波次列表超长截断)
- sync_finished_wave_batch.js 调度日志同步输出 empty_count / pending_confirm_count
- systemMethods/order/wave.js 解波 UPDATE 增加 wave_status < 3 守卫,避免覆盖
  自动终结(5)及已进入拣货及后续环节的波次状态
2026-09-15 16:18:58 +08:00
liufumingren
933a1ae341 fix(workbench): 打包任务结束统一复位摄像头 OSD 为「无任务」
- workbench.js 新增 OSD_IDLE_TEXT / OSD_CACHE_KEY_PREFIX / OSD_CACHE_TTL_SECONDS
  常量与 _resetPackOsd:回写 Redis osd_{workbenchId} 为「无任务」并逐台摄像头
  下发,内部捕获全部异常、永不 reject,失败仅告警不影响打包主流程
- 覆盖三条结束路径:_finishPack 手动结束、_packOrder 关闭上一个未结束任务、
  packTaskAutoFinish 定时自动结束;_packOrder 场景下先等 OSD 复位完成再串行
  下发新任务文字,避免复位覆盖新任务
- _packOrder 的 OSD 缓存写入与逐台下发整理为单个异步任务,保持不阻塞主流程
- pack_task_auto_finish.js 扫描补 workbench_id 并调用 _resetPackOsd,
  schedule/auto_finish_pack_task.js 注释同步
2026-09-15 16:18:51 +08:00
liufumingren
990fcf1314 feat(storage): 新增维护库存效期接口 storage.inventory.updateExpiry
- systems/storage/inventory.js 新增 updateExpiry:校验 storage_id 为正整数、两个
  日期至少传一个、当前仓库上下文(ctx.user.store_id);单事务 + 行锁
  (SELECT ... FOR UPDATE)按 id + warehouse_id + is_enabled=1 + delete_at IS NULL
  定位库存记录,跨仓库按 404 处理
- 新增模块级 helper parseStorageDateInput:undefined 视为未传、null/空串清空,
  YYYY-MM-DD / YYYY/MM/DD / YYYY-MM-DD HH:mm:ss / ISO / Date 统一规范化为
  YYYY-MM-DD 并校验日期真实存在,其它判非法
- 合并后(未传字段取库内现值)生产日期不能晚于到期日期;两值均与库内一致返回
  changed=false,不写库、不记日志
- 成功路径写业务操作日志(operation_code=STORAGE_UPDATE_EXPIRY,记维护前后两个
  日期与 storage/space/stock/batch 快照)
- systemMethods/storage/inventory.js 新增方法层包装(透传 code/message/data);
  businessDict 新增 STORAGE_UPDATE_EXPIRY 操作码
2026-09-15 16:18:39 +08:00
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
4f4128f337 fix(returnUnpack): 批量转入退件登记入参改为运单表主键 ids
- 入参由 waybill_codes(运单号)改为 ids(wms_order_express.id,单个数值或数组):Number 归一化 + 过滤非正整数 + 去重,上限 200
- 反查改为一次批量查询 id IN (ids) + warehouse_id,未命中(不存在或非本仓库)计入 failed;单条失败不阻断主流程
- _transferOneWaybill 改为接收批量反查后的运单行;运单号为空时报「运单号为空,无法转入退件登记」(拆包单 waybill_code 必填)
- 出参:success 项新增 waybill_id;failed 项为 waybill_id / waybill_code(运单命中时,否则 null)/ reason
- 回归:test/return_unpack_transfer_regression.test.js 76/76 通过(含 ids 边界、他仓隔离、运单号为空等新口径)
2026-09-15 16:14:46 +08:00
liufumingren
a59793daf2 perf(order): 订单分表补列表排序索引,修复配送列表 2 秒慢查询
原因:生产 wms_order_delivery_1000028_dispatch(59.4 万行 / data 1.13GB)没有任何
索引覆盖列表接口的固定形态

  WHERE warehouse_id = ? [AND dispatch_lane = ?] ORDER BY updated_at DESC, id DESC LIMIT 20

导致主查询全表扫 + filesort(实测 1.9s);与之并行执行的同条件 COUNT(*) 因
dispatch_lane 不在索引中需逐行回表(实测 1.5s),单请求合计约 2 秒。

新增 order_delivery_table_schema.buildListSortIndexes():

- current / history / outsourced:(warehouse_id, updated_at, id) 与 (warehouse_id, delivery_time, id)
  (updated_at 为前端实际排序字段,delivery_time 为 deliveryOrder 模块默认排序字段)
- dispatch:把恒定条件列 dispatch_lane 放进前缀
  (warehouse_id, dispatch_lane, updated_at, id) 与 (warehouse_id, dispatch_lane, delivery_time, id);
  缺少该列时 COUNT(*) 仍会退回回表(实测 1.2s),且 dispatch 分支会剔除从 current
  继承来的同名后缀索引,避免同一张表维护两份功能重叠的索引
- 索引统一追加在索引数组末尾,保持既有索引下标顺序不变

验证(开发库,同一张 59.4 万行同规模表 + 应用日志中的真实 SQL):

- 主查询 1511ms(Using filesort)→ 1.0ms(Backward index scan)
- COUNT(*)  1217ms(Using where 回表)→ 197ms(Using index)

生产建议低峰期先手工建同名索引,避免部署后首个请求在建索引期间阻塞。
2026-09-15 16:03:29 +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
8757dc6c2e feat(returnUnpack): 新增运单批量转入退件登记接口
- 新增 returnUnpack.transferByWaybills(批量入参 waybill_codes,trim+去重+过滤空值,上限 200,仓库隔离由 ctx.user.store_id 注入)
- 规则:命中运单统一置 wms_order_express.is_back='Y',不做其他前置条件限制;business_key>1 子单跳过
- 明细:按订单原本明细 1:1 复制(订单 items JSON 优先,为空回退 wms_order_items 分表;经订单索引表 wms_order_id_location_{warehouseId} 定位车道,复用 afterSale._resolveOrderDetail)
- 幂等:同仓库+同运单号 status != 'cancelled' 的拆包单直接复用(reused=true),已有明细不重复写入,复用单明细为空时按订单明细补写
- 重构:create 的取号+插主表抽为公共私有方法 _insertMainWithRetry(uk_unpack_no 冲突退避重试),create 与 transferByWaybills 共用
- 权限:新增迁移 20260915100000-add-return-unpack-transfer-waybills-permission(权限 ID 568,授权仓库组-员工 27 → 主管 26)
2026-09-15 15:38:50 +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
7a91988b41 fix(inbox): 出站回执/通知按群ID校正渠道来源,修复群 ext_data 渠道错配
问题:wms_inbox_group.ext_data.source 与群ID格式(@chatroom=wx / 纯数字=qiwe)不符时,
出站回执/通知会把错误渠道原样透传给桥接,投递到错误渠道(qiwe offline 503)而丢失。
生产实测错配出站记录 4018 条(2026-08-15 20:48 ~ 09-14 15:23),涉及 11 个群。

- 新增 app/lib/inbox_channel.js:resolveChannelSource / normalizeExtDataSource
- processor.writeOutboundReply:回执落库与回调体统一使用校正后的 ext_data,不一致时打 warn
- processor._loadGroupInfo:ext_data 写回群配置前先按群ID校正
- systems/warehouseNotify.pushSystemMessage:sys:notice 链路同样校正
- 新增 script/fix-inbox-group-channel.cjs:存量修复脚本(默认 dry-run,--apply 写入,
  --messages 连消息表一起修,写入前自动备份到 temp/,幂等)
2026-09-15 15:31:43 +08:00
liufumingren
38562c3103 fix(inbox): 修正运单号提取把 14 位运单号当日期戳剔除导致只回引导语
现象:生产货主群机器人发「79140215263762 改地址 广东省广州市番禺区…收件人:王小姐19875119016」,
群里只回了「如需修改地址,发送:改地址+运单号」引导语;ai_thoughts 为 params={} +
reason=参数不足-引导提示 → 改地址诉求没建工单、也没转发快递群。

根因:extractWaybills 的日期时间戳过滤正则
/^\d{4}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{4,}$/ 年份不限,
把 79140215263762 读成 7914-02-15 而剔除(该运单实际存在:中通快递 ZTO、
store 1000180、order 577016)。生产 wms_order_express 中有 7627 条运单会被该正则误杀
(中通 769…/791…/736…/790…、韵达 321…/319… 等 14 位号)。

修复:日期戳判定限定年份为 19xx/20xx(/^(19|20)\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])\d{4,}$/),
真实日期戳(如 20260914201201)仍被过滤,手机号/座机/售后单号等过滤保持不变;
改动只放宽过滤,不存在回归面。

验证:
- script/tmp-check-inbox-intercept-guard.cjs:15/15 通过(新增 14 位中通单号应被提取、
  11 位手机号仍过滤、日期戳仍过滤 3 例)
- script/tmp-push-inbox-robot-intercept.cjs:新增 INBOX_CONTENT 自定义正文模式;
  本地走真实签名入站链路复现生产原文 → 工单 AS20260915000001(change_address/pending,
  描述含原文)+ 回信「运单79140215263762修改地址已经登记,稍后客服将人工跟进」
2026-09-15 13:47:01 +08:00
liufumingren
1fe79844ba fix(inbox): 拦截规则守卫误伤「物流单号」标签导致机器人拦截请求静默不回信
现象:生产货主群机器人发「<店铺名>LSFJY…\n物流单号:SF… 拦截」无任何回信
(ai_thoughts=null、无 outbound 子记录),2026-08-28 起该群 0 回信。

根因:INTERCEPT_GUARD 用裸词「物流」判定物流查询意图,命中了单号标签
「物流单号:」→ 拦截规则被 continue 跳过 → 无规则命中且 aiFallback=false
→ 静默(不写 thoughts、不建工单)。store 群该格式消息共 275 条,其中 178 条未回信。

修复:判定查询意图前先剔除运单号标签(物流单号 / 物流单 号 / 物 流单号 / 快递单号 /
运单号),标签之外的「物流轨迹 / 查快递 / 到哪」等查询词仍照旧拦截,
客服对话类消息继续静默,不会误建拦截工单。

验证:
- script/tmp-check-inbox-intercept-guard.cjs:12/12 通过(含生产群分组可用性断言)
- script/tmp-push-inbox-robot-intercept.cjs:本地走真实签名入站链路(/warehouse inbox.push),
  用库内真实顺丰运单覆盖纯数字 / SF / YT 三种单号形态 3/3,均建拦截工单 + 通知快递群
  + 回信 + 置订单 intercept_status/intercept_time
2026-09-14 22:55:23 +08:00
liufumingren
251d703c87 chore(script): 更新波次闭环排查脚本抓取目标
tmp-trace-wave-closure-cause.cjs 改为在远端源码中定位 batchCancel 相关实现并打印上下文,
不再抓取历史日志片段
2026-09-13 15:32:04 +08:00
liufumingren
45e909fca0 chore(db): 记录 wms_workbench 生产迁移前备份快照
database/backups/wms_workbench_prod_backup_20260906132437.sql
(生产 112.124.21.102 迁移前导出的建表语句与 20 行存量数据,用于核对迁移结果)
2026-09-13 15:31:27 +08:00
liufumingren
c3f1c67592 chore(script): 沉淀波次池/报表/库存/订单本地排查脚本
新增一批一次性排查脚本(script/tmp-*.cjs),与仓库既有 script/tmp- 约定保持一致,
覆盖波次池边界与优先级核对、库位/出库报表核对、订单状态与更新范围核验等场景
2026-09-13 15:31:27 +08:00
liufumingren
f3c9be75ce chore(git): 忽略本地 nginx 接线产物
.ssl/、nginx_config/、nginx-upstream-local.conf 为本地生成的证书与服务端配置,不入库
2026-09-13 15:31:06 +08:00
liufumingren
4b1e3aae7f refactor(stockout): 出库单 create/query 收敛到共享领域服务
- app/service/qimenMethods/stockout.js 瘦身为奇门适配层:
  create 委托 systems.stockoutOrder.create(sourceType=QM),query 直接 delegate
- 新增 app/service/openapiMethods/stockout.js:
  入参为 openapi 扁平结构 body.deliveryOrder / body.orderLines / body.deliveryOrderCode
  (query 兼容 deliveryOrder.deliveryOrderCode),create 传 sourceType=API,
  由共享层决定回传走 qimen confirm 还是 openapi 回调 stockout_completed
2026-09-13 15:31:05 +08:00
liufumingren
74b3f04b79 feat(storage): 新增按库位查询有量库存商品列表
- systems/storage/inventory.js 新增 getStorageListBySpaceId(spaceId):
  校验库位归属当前仓库(区分「库位不存在」与「库位属于其他仓库」),
  返回该库位 quantity>0 的库存并按 stock_id 汇总,
  商品信息复用 stock_warehouse 通用链路(getStockDetails)补全属性
- systemMethods/storage/inventory.js 开放 listBySpaceId,
  免权限/免鉴权/免日志名单同步补充
2026-09-13 15:31:05 +08:00
liufumingren
018bbd379d feat(warehouse): 前置仓前端配置与按域名公开拉取接口
- 新增模型 wms_warehouse_front_config 与迁移:建表、
  追加 favicon_url、追加 cert_pem(可回滚)
- systems/setting/warehouse.js 实现 getFrontConfig / saveFrontConfig / saveFrontCert、
  域名唯一性校验、按域名缓存读取(含未登记域名的短 TTL 空缓存防穿透)与缓存清理
- systemMethods/setting/warehouse.js 开放对应 system method
- 新增公共免登录接口 frontConfig.getByDomain:按域名返回公开字段
  (domain/title/logo_url/login_bg_url/favicon_url/theme),
  不返回 cert_path/key_path/sync_status 等内部字段;未登记域名返回 404
2026-09-13 15:31:02 +08:00
liufumingren
724f4a13c6 feat(packing): 复核列表 waybill_code/wave_no 支持操作符与多值数组
- systems/order_packing.js:waybill_code 支持 {operator,value} 且 value 可为字符串数组;
  operator=contains/like 按 LIKE '%值%' 模糊匹配(可命中 '主体-1-1-' 分片单号),
  缺省/eq 保持「完整单号 + 剥离分片后缀主体 + 主体前缀」精确匹配,
  不落入 %短串% 模糊分支(保留「不完整短串不得命中订单」的业务约束)
- wave_no 支持 eq/in 精确、ne 不等、contains/like 与缺省模糊匹配
- systemMethods/order/packing.js 同步 jsdoc 参数说明
2026-09-13 15:31:02 +08:00
liufumingren
83bda9be10 feat(wave): 波次管理列表 where 支持标准操作符与多值数组
- buildBatchListWhereClause 走通用操作符构建:仅 {operator,value,type} 标准结构读 operator,
  裸值回落字段默认操作符(文本字段 LIKE 模糊、其余 eq),裸数组按 in
- 支持 eq/ne/gt/lt/ge/le/in/notin/between/notbetween/like/contains/notlike/
  startswith/endswith/isnull/isnotnull,按字段分组限定允许的操作符集合
- store_id 支持 ne/notin(子查询排除 NULL wave_id);distinguish_express 归一化为 0/1;
  新增 total_orders / processed_orders 输出
- 同文件一并透传 batchAllocateExpress 的 skipped_need_oms_waybill_order_ids(见相邻提交)
- 验证脚本:run/check-wave-batch-where-operator.cjs(33 用例,期望值现算)
2026-09-13 15:30:55 +08:00
liufumingren
da7df4139d feat(order): 新增 need_oms_waybill 回 OMS 取号标记与本地取号分流
- 模型/迁移:wms_order_delivery 新增 need_oms_waybill TINYINT(4) NOT NULL DEFAULT 0,
  迁移覆盖基表与全部分表(含 _history/_dispatch/_outsourced),幂等且 down 可回滚
- 写入链路:openapi 请求根节点 need_oms_waybill(兼容 camelCase needOmsWaybill)→
  openapiMethods/deliveryorder.js 透传;delivery_order.js 仅 API 来源可能为 1,
  QM/MANUAL/STOCKOUT 一律强制 0(见相邻提交)
- 取号分流:need_oms_waybill=1 的订单不参与本地自动分配快递
  1. asyncProcessOrderCreated 不入本地取号队列,写 ORDER_NEED_OMS_WAYBILL_WAIT 操作日志
  2. express.createWaybillCodePipeline 按订单级标记过滤(同订单全部 business_key 一并跳过),
     返回值新增 skipped_need_oms_waybill_order_ids
  3. schedule/consume_waybill_allocate_queue 将对应队列行置终态 waiting_oms
     (不再走 pending 重试 → failed)
- waybill_allocate_queue.status 注释补充 waiting_oms 语义(STRING(20),无需迁移)
- test: delivery_order.asyncProcessOrderCreated.test.js 新增分流/保持本地取号用例,
  express.createWaybillCodePipeline.skipCancelled.test.js 补齐返回字段断言
2026-09-13 15:30:55 +08:00
liufumingren
dfaaa7f060 fix(order): 建单统计列随 INSERT 写入与锁冲突退避重试
- 统计列 items/items_hash/items_crc 均为 wms_order_delivery_* 二级索引列:
  先插占位值再 UPDATE 回写会让并发建单在同一索引区间反复「删标记旧条目 + 插入新条目」,
  批量推单高并发下必然死锁(生产 2026-09-10 单批 354 个事务因此失败)
  → 新增 buildOrderStats,统计列与主表 INSERT 同一条语句写入;
    快递策略命中时只 UPDATE 非索引的快递字段
- 建单顺序调整为先写明细、后写主表(库存预占失败直接回滚,不留悬挂主表行)
- 重试策略:最多 3 次;主键冲突修复水位后重试,新增 isRetryableLockError
  (1213/1205/deadlock/lock wait timeout)带抖动退避重试,
  失败文案统一为「重试后仍未成功,请稍后重试」
- 同文件一并包含 need_oms_waybill 写入与取号分流(新增 normalizeNeedOmsWaybill、
  prepareOrderData 第 7 参、appendNeedOmsWaybillWaitLog 与 asyncProcessOrderCreated 分流),
  该字段的模型/迁移/入口见相邻提交
- test: delivery_order.addOrder.test.js 补 allocateOrderId 桩、按新写入顺序断言,
  并覆盖 need_oms_waybill 根节点取值/归一化
2026-09-13 15:30:54 +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
cf3b9092c6 fix(qimen): 出站请求日志使用独立 log_id 并幂等消费日志队列
- qimen_client.sendRequest 出站日志改为 generateLogId() 生成 QL-<时间戳>-<随机>,
  不再复用入站 ctx.qimenLogId,避免与入站文件队列落库撞 wms_qimen_log.log_id 唯一索引
- qimen.saveQimenLog 去掉 ctx.qimenLogId 兜底;saveQimenLogResult / saveQimenLogBody
  改为按 log_id 定位更新(原先按 id 字段更新与调用语义不符)
- schedule/consume_qimen_logs 插入遇 ER_DUP_ENTRY 视为幂等命中跳过并推进消费进度,
  避免重复日志卡死文件队列
- test: qimen_query.test.js 断言改为校验新 log_id 格式
2026-09-13 15:29:43 +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
839d4e2d7f feat(video): 视频补录请求状态收敛与结果通知拆分
1) 新增 wms_video_record_request 模型与迁移(群/人员信息列、状态+通知扫描索引);索引调整为 (status,is_notified,last_request_at) 并移除单列 idx_status。

2) systems/video_record_request.js:settleStatuses 只收敛状态(可用/全部失败/超时/参数缺失),notifyResults 只做结果通知;成功结果按原查询链路(queryPackVideo/queryReturn)取回并回原群,失败/超时回原群并转人工通知(仓库群客服群,未命中不外发)。

3) schedule/notify_video_record_result.js:每 1 分钟串行执行「状态收敛 → 结果通知」,带重入锁,仅在有变化时打日志。

4) inbox/functions.js:查询打包/拆包视频时同步补录请求状态(有视频置 completed),无可用视频时登记补录请求并推送录制服务。

5) config.inbox 新增 videoRecordNotifyLimit / videoRecordNotifyTimeoutMs。
2026-09-11 02:49:27 +08:00
liufumingren
0782b65546 fix(cainiao): tid 优先取订单表 oaid_order_source_code,为空时兜底原逻辑 2026-09-10 23:54:04 +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
67a70d0394 feat: 系统日志定时清理任务(每日 03:00,硬删除超保留期日志)
- 新增 app/schedule/system_log_cleanup.js 定时任务:cron 从 config.systemLogCleanup.cron 读取(缺省回退 '0 0 3 * * *'),受 enable 开关与防重入保护

- 新增 app/service/systems/system_log.js:按 id 边界定位 + 分批硬删除超期日志,保留天数默认 60(normalizeRetainDays 校验非法值回退),批间随机休眠降低数据库压力

- config.default.js 新增 config.systemLogCleanup 配置块:enable、cron、retainDays 60、batchSize 2000、sleepMinMs/sleepMaxMs

- 新增 service 与 schedule 单测(39 个用例),覆盖边界定位、保留天数校验、配置开关与防重入等场景
2026-09-08 17:00:05 +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
b1000fd0e8 chore(deploy): 证书同步双环境配置发布约定落地
- 发布/回退链路新增固定文件排除与保护:warehouse-cert-sync 两份环境配置不进发布包、清理时暂存/放回,服务器副本不被覆盖/删除(deploy-lib 独立常量 + 共用守卫函数)

- deploy-cert-sync 新增 config-check 只读核对;install 对 prod 配置首次放置一次、之后永不覆盖;dev 配置永不上传生产

- 薄包装简化:nginx 二进制/upstream/reload 全部收敛到 prod 配置,包装仅保留 cwd+依赖+DB 运行时引导

- 新增 warehouse-cert-sync.cjs 与 dev/prod 双环境配置;package.json 增加 deploy:cert-sync:config-check
2026-09-08 04:26:39 +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
efadcba56e feat(store): 移除 wms_store 已废弃的 logo_url、domain 字段
- app/model/store.js、app/service/systems/store.js、app/service/systems/store_warehouse.js:移除 logo_url/domain 字段定义与创建写入,app/ 下无残留引用

- database/migrations/20260907140000-drop-logo-url-and-domain-from-wms-store.js:删除 wms_store 的 logo_url、domain 两列(开发库已执行完成)
2026-09-07 17:49:43 +08:00
liufumingren
c5150bc35b feat: 配送表新增 dispath_time 迁移时间字段
- 新增迁移 20260907120000:为全部配送分表 wms_order_delivery_{wh}_dispatch 幂等新增 dispath_time(datetime, nullable),不触基表/当前分表/history/outsourced

- 配送表模型 schema dispatch 分支同步新增 dispath_time,drift 同步保持一致

- 订单迁移链路 buildDispatchRow 写入 dispath_time=new Date() 记录进入配送表时间
2026-09-07 16:43:35 +08:00
liufumingren
6939d9600a feat: 拦截链路完善与车绑定修复
- 订单表新增 intercept_time 拦截时间字段(迁移覆盖基表与全部分表),全拦截链路写入拦截时间、解除拦截清空

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

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

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

- 同步 methods 文档与变更记录;含 wave_scope 回填、workbench token 过期等前序迁移
2026-09-07 03:48:43 +08:00
liufumingren
1d65d26500 feat(wave): PDA按策略抓取增加订单池按今日0点分割,今日前订单优先出库
- getWaveStrategyFetchCandidateOrders 增加可选 createdBefore 上限过滤(不传时行为不变)

- autoPopulateWaveStrategyFetchSelections 先抓今日前订单池,清空后回落第二池;日志补充池阶段信息

- 新增 normalizeWaveStrategyFetchCreatedBefore / buildWaveStrategyFetchTodayStart

- 附带:resolveWaveScopeByWaveMeta 单品单件 wave_scope=4 映射与 pickMode 传递

- 新增边拣边分联调脚本与订单池完整验证脚本
2026-09-06 02:31:07 +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
b6ae8313a1 fix(order): 自动分配快递排除备注生效并补写跳过日志,储位分配默认禁止存储储位
订单备注命中仓库「自动分配快递排除备注」时跳过自动分配快递,并补写 ORDER_AUTO_EXPRESS_SKIP 操作日志说明原因与命中关键字

储位分配默认排除存储储位(库位类型过滤下沉到 JS 层按货主存拣分离策略逐 SKU 生效),仅当货主关闭存拣分离或前端传入 allow_storage_location=true 时放行;自动分配不再强制 allow_storage_location=true

按当前实现基准修正 order_storage_allocation 过期单测,补充排除备注与存拣分离放行用例(26/26 通过,ESLint 0 错误)
2026-09-05 22:42:39 +08:00
liufumingren
6a71957686 feat(pick): 大团购任务 pick_mode 修正为 5,波次/订单/拣货任务表新增领料人与抓取人字段,领料人非本人拦截重领并覆盖 2026-09-04 21:43:05 +08:00
liufumingren
68c279b896 fix(workbench): 团购波次打包拦截订单静默跳过且日志仅写非拦截订单
- _packOrder 团购波次拦截订单不再拒绝,返回完成结构静默跳过,不创建打包任务
- _getWaveOrderIds 默认排除拦截订单,团购打包操作日志仅写给非拦截订单
- 散单拦截订单仍拒绝打包,保持原行为
2026-09-04 21:12:17 +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
2135f05b49 docs(methods): 同步接口文档与路由表,含拦截锁定、自动分配时间、打包/退回导出、报表群路由、收货货主名称等变更记录 2026-09-03 17:04:03 +08:00
liufumingren
fb8840ecdb chore(ops): 生产日志目录巡检与清理脚本,超过 4GiB 触发清理至 2GiB 以下,活跃日志与近期轮转保留,附本地 dry-run 自测桩 2026-09-03 17:03:59 +08:00
liufumingren
6354a6d8dc fix(stockTransaction): keyword 无匹配商品时条件置空防全表查询流水,货主模式列表补充 mode=store 入参 2026-09-03 17:03:56 +08:00
liufumingren
4259628396 perf(afterSale): 售后导出流式写临时文件上传,避免内存 Excel 堆积,进度回调 await 化确保缓存进度不丢 2026-09-03 17:03:52 +08:00
liufumingren
b91c3f4124 fix(report): 报表文件消息只投递计划配置通知群,未配置回退货主默认站内信群,配置群不可达进入失败退避重试 2026-09-03 17:03:48 +08:00
liufumingren
b64ba0b00b fix(storage.receiving): 收货单货主名称实时解析,store_remask 优先、company_name 兜底,修复约 26% 历史数据快照为空问题 2026-09-03 17:03:44 +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
cb2a78f4f1 fix(packTask): 自动完结与关闭旧任务时同步订单打包状态,修正设备端未传 status 时订单误写已完成 2026-09-03 17:03:13 +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
0610f2528d feat(order): 小团购拣货篮号打印,批量查询订单级与波次级 box_no 映射并透传到各平台面单模板,PDA 扫码与计划创建两种写入场景兼容 2026-09-03 17:00:57 +08:00
liufumingren
007babb6c6 fix(order): 订单详情兜底查询,配送表查空回退待处理表,待处理详情固定先查 dispatch 再兜底 current,避免表位流转后详情落空 2026-09-03 17:00:53 +08:00
liufumingren
66ea0c4c36 feat(storeWarehouse): 新增开始自动分配时间 allocate_start_time,支持跨天自动分配窗口,截单时间下限放开到 00:00,开始时间等于截单时间时保存拒绝 2026-09-03 17:00:46 +08:00
liufumingren
25442ba215 feat(storage): 拦截锁定库存改造,拦截确认库存移入 intercept_locked_quantity 不归还可用,可用数量统一口径 quantity-locked-intercept,负库存入库平账冲销 GAP 挂账 2026-09-03 17:00:37 +08:00
liufumingren
ff84a99306 fix(storage.receiving): 收货完成同步商品图片增加存量上限保护,已有图片超2张跳过复制,批量预统计去重并清理调试输出 2026-09-01 00:50:14 +08:00
liufumingren
277e80e8ca feat(inbound): 入库单完成入库通知货主文案升级,明细行含商品信息,查询失败降级不影响主流程 2026-09-01 00:47:06 +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
2e29f302de feat(workbench): 波次订单实时计数短TTL缓存与拦截/打包标志 2026-08-30 07:29:32 +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
a75612c22d docs(routing): AI_METHOD_ROUTING 路由表同步 2026-08-30 07:28:39 +08:00
liufumingren
373bb84294 chore(db): 数据库脚本连接目标保护(WMS_DB_TARGET 显式解析防误连生产库) 2026-08-30 07:28:36 +08:00
liufumingren
58cc5bb7b6 feat(storage): 快捷直入回写虚拟入库标记 2026-08-30 07:28:29 +08:00
liufumingren
ebaf5d0051 feat(order): 订单导出新增"来源"列 2026-08-30 07:28:25 +08:00
liufumingren
7b0004a7e3 perf(order): current 分表 wave_id 前导索引与模型预期定义同步 2026-08-30 07:28:21 +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
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
403a73b250 docs(routing): 更新 inbox 服务函数清单,新增 tools.js
- functions.js 移除 _getRecordingComputerId/_buildVideoUrl(5→3)
- 新增 tools.js:getRecordingComputerId、buildVideoUrl
2026-08-27 23:43:44 +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
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
33a92bdc8d fix(pack): 打包人未知账号写NULL并去重,避免多人打包触发唯一索引冲突中断打包流程 2026-08-27 23:41:50 +08:00
liufumingren
59eb736740 feat(storage): 补货需求支持货主筛选并补充货主名称与SKU条码,快捷直入按绑定收货单截断并回写入库状态 2026-08-27 23:41:47 +08:00
liufumingren
fd565fda7b feat(inbox): 规则引擎成为主回复路径,退回收件登记按仓库+货主聚合通知货主群 2026-08-27 23:41:43 +08:00
liufumingren
f2fe5311aa chore(script): 调试脚本移入 temp/ 不再纳入版本控制 2026-08-27 23:38:46 +08:00
liufumingren
80c73bb34b feat(order): 订单创建自动分配快递改为队列+定时批量消费,消除取号死锁
- 新增 wms_waybill_allocate_queue 队列表(migration + model),订单创建异步流程仅入队(截单/未审核不入队)

- 新增 consume_waybill_allocate_queue 定时任务:15s/worker/重入保护,按仓库+货主串行批量消费,同关系下同一时刻仅一个取号事务

- express_platform 三处结算事务统一先 FOR UPDATE wms_store_warehouse 再更新 wms_order_express(lockAndDeductWaybillSettlement),消除 AB-BA 死锁
2026-08-27 20:11:52 +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
a6d67a17fe feat(order): 快递策略漏斗支持外部编码开启时仅匹配纯货主维度策略 2026-08-26 17:24:03 +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
73d12cdf1a feat(order): 订单新增 oaid_order_source_code 字段落库,取号链路 plattradeno 优先取该字段 2026-08-26 15:33:11 +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
c0331cd68f fix(storeWarehouse): 策略变更后写入并失效签约策略缓存,避免奇门推单读取旧超卖快照 2026-08-25 13:09:54 +08:00
liufumingren
51f6b27d6a fix(qimen): itemId 非主键时降级按 item_code 查找商品,修复奇门推单误报未同步推送到仓库 2026-08-25 13:09:53 +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
63713bf490 fix(inbox): queryPackVideo 打包视频地址拼接 CDN 域名 2026-08-24 18:47:38 +08:00
liufumingren
3352fbaff6 test(storage): directPutaway 与 quickPutaway 链路对比测试脚本
- tmp-test-putaway-full-compare.cjs:全链路真实接口对比(A 两步 quickPutaway→addItem→commit / B 一步 directPutaway),支持 A|B 参数单独跑
- tmp-test-putaway-batch-compare.cjs:批次维度对比(不同批次建行 / 同批次累加)
- tmp-verify-all-tables.cjs:15 张表逐表核对输出
- tmp-check-*:条码、请求日志、通知失败表、权限、库存行/流水等定点核对
- tmp-clear-user-cache.cjs:清 Redis 用户缓存(权限变更后刷新)
- 测试数据保留不清理(收货单 1521-1535、入库单 381-392 等)
2026-08-24 03:23:23 +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
37b9a3d30d fix(express): polyapi 取号订单ID改 Hex16 提交并回传解码,修复 ESLint
- object_Id/orderno 中 order.id 改为 16 进制编码,缩短订单唯一标识字符串

- 失败项/各平台成功回写分支按 parseInt(x,16) 解码回十进制,保持落库与映射兼容

- 修复本文件 31 处 ESLint(空格/引号/注释等),纯格式不涉及业务逻辑
2026-08-22 17:22:27 +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
f6ee444d36 feat(storage): 入库单列表行级新增 total_quantity/received_quantity 数量汇总
- storage.entry.list/listStore 按当前页入库单批量聚合 wms_entry_items(SUM(count)/SUM(received_quantity))注入每行
- 无明细行补 0,不影响筛选/分页/排序逻辑
2026-08-21 23:34:06 +08:00
liufumingren
4b4b645257 fix(express):修复分配快递号聚水潭合单外部订单号在pay_no不合单不在的问题 2026-08-21 23:25:53 +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
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
9894e15ccd fix(express-policy): 违禁品策略无法命中——订单创建时聚合商品违禁品类型参与匹配
- addOrderLines 批量查询 StockWarehouse 增加 prohibited_id 字段并聚合去重
- itemsInfo 返回 prohibited_type_ids,matchPolicy 由写死 null 改为传入真实值
- 修复限定违禁品类型的快递策略此前永远被跳过、订单降级默认快递的问题
2026-08-21 22:56:01 +08:00
liufumingren
bb676f941e fix(pendingOrder): 修改订单平台补充逐单订单日志
- updateOrderPlatform 更新前查询候选订单并筛出平台实际变化的订单
- 为每个受影响订单写入 business_id=订单ID 的 ORDER_UPDATE_PLATFORM 订单日志
- 保留原仓库级操作日志,逐单日志写入失败仅告警不影响业务
2026-08-21 22:55:01 +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
fe97adfda2 feat(space): 批量库位搜索 searchSpaces
- space.js 抽取 _searchByKeyword, searchSpace 与 searchSpaces 共用同一查询口径
- searchSpaces 按 keywords 并行查询并保持传入顺序, 无记录项返回空数组
- index.searchSpaces 加入免权限/免鉴权白名单
2026-08-21 02:20:43 +08:00
liufumingren
7f562bf1e7 feat(storage): 取消分配储位已拣货记录返还库存
- 按拣货记录状态分流: pending 仅解除锁定, fin 返还实物数量
- 已拣货返还写 INBOUND 流水(order_type=PICK_RETURN)并返回 storage_return_summary
2026-08-21 02:20:40 +08:00
liufumingren
59019e07a6 feat(deliveryOrder): 快递解析快照与策略漏斗调整、手动单库存归属校验
- resolveExpressSnapshot 全路径补日志与回退快递名称, 未匹配也写快递回退操作日志
- enable_external_express_code 开启时跳过快递策略漏斗, 保留外部匹配/兜底结果
- 手动单直接传 stock_id 时校验库存归属货主, 跨货主库存拒绝下单
2026-08-21 02:20:36 +08:00
liufumingren
e0b2cf3030 feat(expressPlatform): 面单下单参数补全
- 菠萝派平台启用 ismultiplepieces/logisticno 并放开体积重量等参数
- 修复 PDD/QT/OTHER 面单回写 orderno 十六进制仓库ID转十进制
- 补全 businesstype/platcode/length/width/height/weight 与 ordertime
- SF 场景 customercode 置空, oaid 含横杠视为超长回退 caid
2026-08-21 02:20:31 +08:00
liufumingren
eca309d41f fix(print): 打印自定义区同库位不同商品不再合并
- 聚合键由库位改为 库位+stock_id 复合键, 仅同库位同商品合并数量
- stock_id 缺失时依次回退 order_item_id、商品名称+条码, 无法识别商品身份时不再跨行合并
2026-08-21 02:20:26 +08:00
liufumingren
4f2ef5ecb3 feat(pick): 拣货完成拦截单跳过并移出波次回写统计
- 拦截单不再报错中止, 直接跳过(不完成拣货、不扣减库存)
- source!=0 任务中被跳过的拦截单从波次移除: wave_id 清零、删除波次索引、
  回写 wms_wave_batch.total_orders/processed_orders, 空波次置 wave_status=-1
- 同步清理任务订单关联与箱子明细, 全部跳过时按任务进度完结
2026-08-21 02:20:22 +08:00
liufumingren
90d5701a53 feat(wave): item_detail_machine 改 TEXT 并新增波次自动终结
- wms_wave_batch.item_detail_machine VARCHAR(1024) -> TEXT, 兼容多商品长结构标识
- 新增 wave_batch_closure 服务: 扫描活动波次(0/1)中订单已全部离开待处理表的波次并收敛 wave_status=5
- 新增 sync_finished_wave_batch 定时任务与执行日志缓存
2026-08-21 02:20:17 +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
9327611552 fix(expressPlatform): 面单下单参数调整
- 菠萝派/淘宝面单 payload 字段调整:tid/transtype/mainsubpaymode 等按平台传参,
  移除暂不使用的字段
- 菜鸟取号:oaid 超 128 位时转 caid 传递、tid 改用 pay_no;
  调试输出改缓存(Cainiaoquery/Cainiaoresult)
2026-08-19 00:00:45 +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
d18da89925 fix(inbound): PENDING 状态上架不再强制绑定收货单与明细 ID
- 允许导入:items 可传 receiving_detail_id 走绑定模式(预占收货明细),
  也可不传走非绑定模式(数量受计划数量限制)
- 绑定模式下 space_id/明细可用数量校验统一由 _addSingleItem 处理
2026-08-19 00:00:36 +08:00
liufumingren
864351977b fix(order): wms_order_items.ext_code 改为 TEXT 支持超长外部编码 2026-08-19 00:00:32 +08:00
liufumingren
ac4222c49a fix(receiving): 收货绑定货主通知按已填车牌/快递单号展示已登记信息
- sendStoreBoundNotice 根据 receiving.license_plate / tracking_number 动态生成
  第三行文案:已填车牌显示已登记信息,均未填写才提示及时补充
- create/bindStore/updateReceivingStats 三个触发点的快照均补充两字段
2026-08-19 00:00:28 +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
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
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
liufumingren
9b1a6034af 文档 2026-08-04 08:22:54 +08:00
liufumingren
0b781a7e70 feat: 店铺快递绑定策略模块 + 订单创建链路集成 + 运单号分配优化
【新增模块】
- app/model/store_express_binding_policy.js: 策略数据模型(17字段,JSON数组)
- app/service/systems/store_express_binding_policy.js: CRUD+列表(含名称批量解析)
- app/service/systems/express_policy.js: 缓存优先策略查询 + 6维漏斗匹配引擎
- app/service/systemMethods/store_express_binding_policy.js: method路由层
- database/designs/store-express-binding-policy-design.md: 设计文档

【策略漏斗匹配逻辑】
- 按priority DESC逐条匹配: store_ids→shop_name→prohibited→regions→exclude→weight
- NULL/空数组=不限, 未命中自动continue到下一条
- 地区/店铺匹配使用子串包含(省/市/区/详细地址均生效)
- 违禁品匹配使用数组交集
- 输出快递编码+重量类型, 未命中返回null

【订单创建链路集成】
- addOrder→addOrderLines后触发matchPolicy(weight可用)
- 命中: 写入logistics/sys_logistics 4字段+weight_type+操作日志
- 未命中: 降级到resolveExpressSnapshot默认值+兜底DEFAULT_STORE_SUBJECT_CONFIG(STO)
- 系统快递4字段一致, 自定义映射(express_setting)分流写入

【运单号分配优化】
- pickWaybillExpressInterface两步兜底:
  Step1: logistics_code仅匹配express_code(自定义编码精确)
  Step2: sys_logistics_code匹配全候选码(系统编码兜底)
- 新增weight_type过滤器(接口NULL=通配, 设限须精确匹配)
- groupedOrder.options新增sys_logistics_code/weight_type传递

【操作码翻译】
- ORDER_EXPRESS_POLICY_MATCH: '策略命中'
- ORDER_EXPRESS_FALLBACK: '快递降级'
- 无策略命中时写入快递降级日志

【API文档】
- methods/system.json: 策略模块4接口+响应字段(express_name/数组类型等)

【数据库迁移】
- 13个migration: 建表→字段迭代→TEXT改JSON→prohibited改数组(dev+prod均执行)
2026-08-04 08:18:43 +08:00
liufumingren
a9a015117f feat(print): 新增打印完成后异步解绑拣货车逻辑
- tryUnbindCartAfterPrintComplete: 接收 waveId,按团购/散单检测任务下所有订单 print_status

- 团购仅小团购(pick_mode=1)触发,统一用订单 print_status != 'none' 判断

- send() express 成功分支异步 fire-and-forget 调用,不阻塞返回

- 解绑时写入 unbind_user_id,从 ctx 上下文提取操作人

- 含 extractUniqueWaveIds 去重 + 18 项单元测试全部通过
2026-08-03 21:03:21 +08:00
liufumingren
7e39159f0b feat(setting.expressInterface.list): 新增 quantity/recycled_quantity/cancel_quantity/allocated_quantity 扁平字段
- Promise.all 并行调用 index.getShopExpressList 获取店铺快递签约数据
- 三层匹配: sys_express_code → site_code/branch_code → shipperno/customer_code_list
- 无店铺或无数据时四字段均为 0
- 补全 response 全部 42 个子字段文档
2026-08-03 21:02:31 +08:00
liufumingren
11e8bedfaf fix: wms_wave_pick_task_order.box_no 改为与 wms_order_wave_index.wave_index 一致
- wave.js buildTaskOrderRows: box_no 优先取 wave_index,无记录时退化为 index+1
- wave.js 任务创建流程: 调用前查询 wms_order_wave_index 获取 wave_index
- pick.js createWavePickTask: INSERT 补齐 box_no 列,值取自 wave_index
- 所有路径均含 try-catch 降级,查询失败不阻塞任务创建
2026-08-03 21:01:42 +08:00
liufumingren
7a1f15ac6a fix(inbox): 移除 warehouseMethods 中 targetUrl/refCode 残留 2026-08-03 03:59:56 +08:00
liufumingren
3d33861afd fix(inbox): store_id 增加签约表校验(StoreWarehouse auth_status=2 + warehouse_use_status=1) 2026-08-03 03:26:39 +08:00
liufumingren
440ace1a5d refactor(inbox): 移除 target_url(改用ApiApp回调地址)和 ref_code(合并到ext_data) 2026-08-03 03:17:59 +08:00
liufumingren
8b978f50ec fix(inbox): 修复边界缺口 — 枚举校验、parent_id存在性、软删除过滤、thread防环 2026-08-03 02:01:02 +08:00
liufumingren
4374ad01e3 feat(inbox): 站内信模块完整实现 — 统一消息收件箱 2026-08-03 01:36:16 +08:00
liufumingren
b5b631f20d fix(docs): warehouse 文档作为外部 API 隔离,不暴露内部文档导航;修正签名算法描述为 MD5 2026-08-03 01:08:36 +08:00
liufumingren
da4208707d fix: 修复自动分配快递时 warehouse_id 上下文丢失导致 FK 约束失败及平台解析异常
- express.js: createWaybillCode 优先使用传入的 warehouse_id,修复 setImmediate 后 ctx.user 丢失导致 wms_order_express.warehouse_id 外键约束失败
- delivery_order.js: asyncProcessOrderCreated 中平台/快递解析逻辑修正
- recheckOrder.js: 复核单快递分配状态判断优化
- express_platform.js: 快递平台自动同步回传链路修正
- order_async.js: 奇门异步下单上下文增强
- polo_api_client.js: PolyAPI 客户端微调
2026-08-02 22:40:58 +08:00
liufumingren
0b77a1c63e fix(pick): wavePickTaskBindCart 防重检查不再按任务状态放过——仅以 is_active=1 为准,阻止一车多绑 2026-08-02 22:40:03 +08:00
liufumingren
de9eb2b657 fix: wms_order_wave_index 写入时按平台+快递排序 wave_index
replaceOrderWaveIndexByWaveIds 中 wave_index 原按 id 顺序分配,
导致同一波次内不同平台订单交叉排列。
修复为按 sys_platform_code → sys_logistics_code → id 三级排序,
确保同平台同快递订单获得连续的 wave_index。
2026-08-02 22:37:48 +08:00
liufumingren
59bd112893 refactor: 移除 order.print.getWavePrintData 接口(已被 getWavePlatformPrintData 替代) 2026-08-02 17:15:12 +08:00
liufumingren
02596feb3d fix(wave): 修复并发取消订单时事务死锁导致 rollback 错误
replaceOrderWaveIndexByWaveIds 内部 DELETE WHERE wave_id IN(...) 在并发取消同一波次时可能死锁,MySQL 自动回滚事务后,内层 try-catch 吞掉错误继续使用已死事务导致报错。去掉内层 try-catch,让错误传播到外层统一处理 rollback。
2026-08-02 00:52:11 +08:00
liufumingren
02b3a5e813 fix(order): 订单同步/运单/库位分配防御性修复
- express: 运单查询补充 pay_no/from_key 字段;step 更新增加 status!=cancel 过滤
- order_async: 同步分发前过滤 sync_status=fin 的已完成订单;修复 Op.ne 引用缺失;强制 SELECT FOR UPDATE 重读;多处更新增加 status!=cancel 守卫
- order_storage_allocation: SN/快递分配失败回写增加 status!=cancel 守卫
- methods: allocateExpressCode 文档更新为异步接口说明
2026-08-02 00:38:34 +08:00
liufumingren
d6e4de6edc fix(wave): 波次订单移出/取消后 wms_order_wave_index 未重新排序
- batchRemoveOrders: 用 replaceOrderWaveIndexByWaveIds 替换手动 COUNT,移出后自动重排 wave_index
- cancelWavePickTasksInternal: PDA拣货任务取消释放波次时清理 wms_order_wave_index
- batchFinishAutoGrouping: 关闭自动加团前重建波次索引,确保 wave_index 连续
- cancelOrder(pendingOrder): 取消待处理订单后重建受影响波次索引
- cloneOrder: 克隆取消原订单时清理波次关联并重建索引
- Qimen取消: 奇门取消订单后重建波次索引
- OpenAPI取消: 新增完整波次清理逻辑(清除wave_id+删索引+重建+更新WaveBatch)
- 新增 resortWaveIndex 内部方法用于强制重排历史数据
2026-08-02 00:35:56 +08:00
liufumingren
05b71b2f31 feat: 抖音面单自定义区模板出口域名改为可配置路由
- config.default.js: 新增 customAreaBaseUrl 出口域名配置
- router.js: 新增 GET /mb/douyin1.xml 路由
- controller/template.js: 新增 douyinCustomArea() 方法输出静态 XML
- printer_data_builder.js: applyDouyinExpressFieldMapping 支持 customAreaBaseUrl 参数
- order_print.js: 将 app.config.customAreaBaseUrl 传入 buildPlatformRequestSkeleton
- douyin.json: 移除硬编码 templateURL,由运行时代码动态拼装
2026-08-02 00:35:08 +08:00
liufumingren
8ee12374b3 fix(storage.entry.get): 移除 items[].stock 中多余的 quantity/locked_quantity 字段 2026-08-02 00:34:32 +08:00
liufumingren
f747e73aea fix(deliveryOrder): 货主默认配置统一读取合约 policy_config,移除对 wms_store.subject_config 的错误依赖
- prepareOrderData 不再调用 getStoreSubjectConfig(storeId) 读取死数据
- resolveExpressSnapshot: 默认快递编码统一从合约 policy_config 读取
- resolvePlatformSnapshot: 兜底平台编码只走合约 policy_config
- resolveEnableExternalExpressCode: 移除 storeSubjectConfig 死数据兜底
- 仓库级 getStoreSubjectConfig(warehouseId) 保留(有 warehouse setting 更新入口)
2026-08-01 15:59:22 +08:00
liufumingren
5759c1fb19 feat(deploy): 部署脚本增加端口强制清理 + 健康检查超时延长至 20s
- 新增步骤 5.5:启动前通过 ss + fuser -k 强制释放目标端口残留进程
- 健康检查重试次数从 5 次增加到 10 次,最长等待从 10s 延长至 20s
- 健康检查失败日志增加启动日志路径提示
2026-08-01 15:31:00 +08:00
liufumingren
fbb12cf205 fix(deliveryOrder): resolveExpressSnapshot 兜底读取 policy_config.default_express_code
- 修复前只读 store.subject_config.default_express_code,导致 subject_config 为 NULL 时始终命中默认 STO
- 修复后货主 subject_config 优先,未配置时兜底读仓库 policy_config.default_express_code
- 解决广州趣电贸易等 subject_config 为空的货主无法使用仓库级 ZTO 配置的问题
- 新增 resolveExpressSnapshot 单测 14 个用例全覆盖两大分支
2026-08-01 13:56:21 +08:00
liufumingren
da56253d4a feat(shops): 店铺视频号授权支持 + 部署优化
- shops.js: 视频号授权需传 appId/toUserName,新增授权请求/响应调试缓存
- index.js: SPH 运单查询添加调试缓存
- deploy-remote.cjs: 健康检查优化(30次→5次/10s),失败自动回滚 current.md
- config.default.js: 数据库连接池 20→225
2026-08-01 03:45:26 +08:00
liufumingren
315e366c4c feat(inventory): 新增库存异步导出功能
- systemMethods 层:export 提交异步任务 + exportTaskProgress 查询进度
- systems 层:exportInventoryList 导出实现(支持按 stock_id 聚合/按 storage_id 明细)
- 导出任务通过 Redis 缓存管理进度状态(TTL 30min)
2026-08-01 03:45:16 +08:00
liufumingren
bd6013d7b8 fix(order): 拣货/波次/复核/打包/自动出库修复与增强
- pick.js: 修复拣货车绑定逻辑,禁止已绑定任务直接换车
- wave.js: 修复波次拣货车查询(移除 current_task_id)
- recheckOrder.js: 新增 batchQuickRecheckByWave 按波次批量快速复核
- order_packing.js: 时间字段统一格式化输出
- order_auto_outbound.js: 修复仓库去重逻辑
2026-08-01 03:45:06 +08:00
liufumingren
5378fcd137 refactor(print): 打印模块重构
- 新增 systems/order_print.js 订单打印业务层(getPrintDataByWaybillCodes 等)
- print.js 删除 retry 补偿相关代码(normalizeRetrySendPayload/getRetryEligibility)
- order/print.js 新增 getPrintDataByWaybillCodes 方法
- printer_data_builder.js 新增 appendExtraCustomLines + extraCustomLines 参数支持
- polo_api_client.js 添加调试缓存
- 删除 print_retry_compensation 定时任务测试
2026-08-01 03:44:53 +08:00
liufumingren
3736d306bd feat(express): 快递运单创建链路改造
- order_express model 新增 logistics_code/name/delivery_order_code/source_order_codes/store_id 字段
- express.js 业务层改造:创建运单号时写入快照字段
- express_platform.js 适配新字段
- pendingOrder.js 运单分配+拆子单号改造:支持 dispatch 表查询、已取消订单校验、主单号前置检查、step 4 配送中拆单
2026-08-01 03:44:14 +08:00
liufumingren
45b59ea35c feat(camera): 新增摄像头 OSD 叠加功能
- 新增 camera model username/password 字段
- 新增 osd_client.js OSD 客户端库
- 工作台打包时自动叠加 OSD 信息到摄像头(带 Redis 缓存去重)
- 新增迁移脚本:摄像头用户名密码字段
2026-08-01 03:44:02 +08:00
liufumingren
edc164298d feat(waybill): 新增面单/运单管理模块
- 新增 systems/waybill.js 业务层:运单列表查询/详情/导出
- 新增 systemMethods/waybill/warehouse.js 入口层
- 新增 6 个迁移脚本:面单列表索引、store_id 列、物流编码/名称回填、发货单号列、货主ID回填、发货字段回填
- 更新 waybill-module-design.md 设计文档
2026-08-01 03:43:47 +08:00
liufumingren
76e25db7da feat(apiApp): 新增仓库 API 应用管理模块
- 新增 systems/apiApp.js 业务层:CRUD + AppKey/Secret 自动生成 + 仓库隔离
- 新增 systemMethods/apiApp.js 入口层:list/detail/create/update/delete/regenerateSecret
- 注册 methods/system.json API 文档 + changes 变更记录
- 新增迁移脚本:wms_permission 固定 ID 464-470 + 客服组主管及以上角色授权
2026-08-01 03:39:41 +08:00
liufumingren
635e86f984 chore: 提交当前所有变更,准备开始 allocateSubOrderNumber step=4 改造 2026-07-29 13:57:04 +08:00
liufumingren
fb2c00027e refactor(storage.receiving): 导出功能 storeId 改为从 ctx.user.store_id 获取 warehouseId;新增导出相关接口文档 2026-07-27 17:46:56 +08:00
liufumingren
000597fecc fix(order.recheckOrder): waybill_code 加入散单复核列表响应字段 2026-07-27 17:46:42 +08:00
liufumingren
d11ed3b2a2 feat(order.pendingOrder): 新增 allocateSubOrderNumber 子单号异步分配接口与进度查询 2026-07-27 17:46:26 +08:00
liufumingren
f9fbf96ce5 feat(order.packing): 新增 has_video/video_enable 录像筛选与响应字段;运单号改为 express 表解析;setEndTime 增加开始时间校验;forceRecord 优化错误处理 2026-07-27 17:46:03 +08:00
liufumingren
81350c0d6b fix: 定时任务同步日志 + 基础设施修复 + 权限迁移(收尾)
【定时任务】sync_outbound_orders_to_delivery: 执行日志写缓存 + 错误详情提取(parent/validation)

【基础设施】system.js: snake_case→camelCase 服务路由转换(兼容 express_interface 等)

【看板】dashboard: queryWarehouseStats 支持 storeId 货主维度过滤

【订单基类】order/base: getOrderModel 兼容无上下文时传入 warehouseId(货主侧场景)

【库存】inventory: 全量移库软删除→硬删除(force destroy)释放唯一键 + 唯一约束/校验错误友好提示

【快递平台】express_platform: KS(快手)平台 receiver.phone 不传(平台要求)

【迁移】delivery 自增起点 + supervisor CS 权限修复
2026-07-27 03:49:27 +08:00
liufumingren
b2ae5683e1 feat(order): 波次/拣货/复核透传货主信息 + 取消订单过滤
- wave: 透传 store_id/owner_code/store_remark

- recheckOrder: 波次视图新增 store_id/store_remark,批量查询货主备注

- pick: 分组聚合透传 store_id/owner_code/store_remark/stock

- order_storage_allocation: 储位分配注入 stock_id + 回传排除取消订单

- order_async: 标记异常排除取消状态订单
2026-07-27 03:48:45 +08:00
liufumingren
888d026145 feat(shop/store): 店铺管理增强 + 门店仓库加载
- shops: 支持修改 shop_name + 删除店铺查询改用 Op.notLike 前缀过滤

- store: loadStores 增加 Store 关联查 company_name 作为 label fallback

- store: 新增 loadWarehouses(货主侧加载可用仓库)

- index: 注册 loadWarehouses 权限
2026-07-27 03:48:26 +08:00
liufumingren
510b87632a feat(stock): 库存/仓库模块货主侧查询与报表增强
- stock/warehouse: 新增 externalList/externalExport(外仓/货主维度查询)

- storeWarehouse/store: 新增货主侧接口(list/get 等)

- stock_store: getWarehouseStock 支持 externalWarehouseId/externalStoreId

- store_warehouse: 合同关系改为单向维度查询(不再 OR 两边)

- storage/report: 库存报表支持 store 维度 + stockIds/keyword 精确筛选

- stock/transaction: storeList/exportStore store_id 从 ctx 获取防越权

- stock_warehouse: getStockDetails 支持显式传 null 跳过仓库过滤

- storage/management: 储位分配待处理排除待审核(step=1)订单
2026-07-27 03:48:06 +08:00
liufumingren
3c53b3c8fa feat(storage): 入库/收货模块货主侧功能 (listStore, export)
- entry: 新增 listStore(货主维度列表)、export/exportTaskProgress(异步导出)

- entry: 新增 storeExport/storeExportTaskProgress(货主侧导出)

- receiving: 新增 getStoreReceivingList(货主维度收货单查询)

- receiving: 新增 export 异步导出 + fix 时间字段 created_at→updated_at

- 迁移: receiving_detail creator_id 去 zerofill + 货主收货权限
2026-07-27 03:47:49 +08:00
liufumingren
972c912e53 feat(express): 快递接口支持启用/停用,过滤取消状态订单
- express_interface 新增 is_enabled 字段(1=启用, 0=停用)

- expressInterface service 支持 is_enabled 筛选与编辑

- express 运单分配跳过停用接口 + 取消状态订单过滤

- 迁移: 20260724100000-add-is-enabled-to-wms-express-interface
2026-07-27 03:47:27 +08:00
liufumingren
f40370baca feat(print): 打印电脑管理增强(录制、软删除、独立接口)
- print_computer: 新增录制字段(is_recording/recording_size/remote_play_url/recording_directory/deleted_at)

- print_stations: 新增 deleted_at 软删除

- 新增 printComputer service (systemMethods + systems)

- order_print 重构: 商品信息从 picking 表直读,不再依赖 order_items

- 8 条迁移: 录制→软删除→权限→目录
2026-07-27 03:47:09 +08:00
liufumingren
b485f8e9f1 feat(camera): 新增摄像头/录制模块 (camera/camera_server/pack_task_video)
- 新增 model: camera, camera_server

- 新增 services: camera, cameraServer (systemMethods + systems)

- 新增 pack_task_video 表及录制状态管理

- 7 条迁移: 建表→设备字段→端口拆分→状态枚举
2026-07-27 03:46:51 +08:00
liufumingren
5b3180ff34 feat(workbench): 新增工作台/打包台模块 (workbench/pack_task)
- 新增 model: workbench, pack_task, pack_task_packer

- 新增 systemMethods: workbench (finishPack/sendWeight/操作日志)

- systems/workbench 扩展: 波次订单ID获取、打包操作日志白名单

- 10 条迁移: 建表→扩展→权限→重构
2026-07-27 03:46:37 +08:00
liufumingren
19c3fe09a7 refactor(weight): 重量字段统一为 INTEGER(g),取代 DECIMAL(kg)
- 8 个 model 重量字段类型 DECIMAL→INTEGER,注释 kg→g

- order_express 称重校验改为正整数(g)

- delivery_order 手动单查 StockStore + warehouse 称重毛重

- openapi.json 毛重/净重描述 kg→g

- 迁移: 20260725120000-unify-weight-fields-to-int-g

- 脚本: update-stock-warehouse-weight.cjs
2026-07-27 03:46:07 +08:00
liufumingren
7ff7285222 feat(stock.transaction): 新增 UNLOCK 类型,取消锁定时写入 UNLOCK 而非 OUTBOUND
- stock_transaction 枚举新增 UNLOCK(取消锁定)

- stock_store 取消锁定时写 UNLOCK 流水

- 迁移: 20260711160000-add-unlock-to-wms-stock-transaction
2026-07-27 03:45:54 +08:00
liufumingren
aedd815e17 feat(order.packing): 新增打包任务模块 list/get/setEndTime/forceRecord 方法及视频 CDN URL 拼接
- 新增 order.packing.list: 打包任务列表查询,支持分页/筛选/排序,关联工作台/视频/运单

- 新增 order.packing.get: 打包任务详情查询

- 新增 order.packing.setEndTime: 设置结束时间,未完成任务自动标记为已完成

- 新增 order.packing.forceRecord: 强制重新录制,推送打印服务

- pack_task_video Model status 从 TINYINT 改为 STRING(20) 匹配 DB ENUM

- 视频 URL 拼接 CDN 前缀: http://w{warehouseId}-c{computerId}.o.gztbyc.com{videoPath}

- 录制电脑从 wms_print_computer(is_recording=true) + Redis 在线校验获取

- 更新 methods/system.json 与 methods/changes/system.json 文档
2026-07-27 03:41:24 +08:00
liufumingren
a69fd3f393 fix(storage.entry): 入库超量静默裁剪 + containerList 按可用量过滤
1. inbound_direct_log._addSingleItem: 入库数量超过计划时不再拒绝,改为静默裁剪为 maxAllowed(仅无可入数量时拒绝)
2. storage/entry.containerList: NOT EXISTS 一刀切排除改为计算 actual_quantity - SUM(已占用),只返回可用量>0的收货明细
2026-07-23 17:42:28 +08:00
liufumingren
52aa76af60 fix: OrderExpress 查询添加仓库隔离 + workbench 业务增强
- _queryOrder: OrderExpress 查询增加 warehouse_id 过滤,避免跨仓库数据泄露
- _queryOrder: 新增订单商品明细查询,关联 stock 详情(带缓存)
- _packOrder: 同一工作台新任务进入时自动关闭上一个未结束任务
- order_packing.js: quickWhere 运单号查询增加 warehouse_id 过滤
- recheckOrder.js: getWaveOrdersBasic 运单查询增加 warehouse_id 过滤
- order_print.js: queryOrderExpressByOrderIds 增加 warehouseId 参数
- waybill.js: toOrder 运单查询在用户已登录时增加 warehouse_id 过滤
2026-07-21 20:53:53 +08:00
liufumingren
1537c1ac10 refactor: stock.transaction 导出列调整为库存变动/锁定变动分离
- 库存变动量(INBOUND/OUTBOUND 有值,LOCK/UNLOCK 为 0)
- 库存变更前/后
- 锁定变动量(计算 after_locked - before_locked,库存流水中为 0)
- 锁定变更前/后
2026-07-17 02:37:54 +08:00
liufumingren
04305fffd6 feat: stock.transaction 新增 where.ids 精确筛选,支持导出选中记录
之前 where.ids 传入完全被忽略,导致导出内容与用户选中的记录不符。
queryList/exportList 现已支持 ids 数组精确筛选 wms_stock_transaction.id。
2026-07-17 02:26:10 +08:00
liufumingren
07f35c43bf fix: 修复 queryList 中 stockIds 筛选 if 块缺失导致语法错误 2026-07-17 01:56:54 +08:00
liufumingren
df8173cecd feat: 新增 stock.transaction 商品流水导出 + keyword 商品搜索
- systems/stock_transaction.js: 新增 exportList() 异步导出 Excel(上限50000条)
  - 新增 _resolveKeywordToStockIds() 关键词→stock_id 解析
  - queryList/exportList 支持 keyword 模糊搜索(按 item_code/item_name/goods_code/barcode/SKU ID)
- systemMethods/stock/transaction.js:
  - 新增 export/exportStore/exportTaskProgress 异步导出方法
  - list/storeList/export/exportStore 全部透传 keyword
  - storeList 新增 warehouse_id/stock_id 单数兼容
- methods/system.json + changes/system.json: 新增3个method文档
2026-07-17 01:48:12 +08:00
liufumingren
3e813c4975 fix: 将 storage.report 模块迁移至 stock.report,修正语义错误
库存报表属于 stock(商品库存)域而非 storage(库位存储)域。

变更:
- systemMethods/storage/report.js → systemMethods/stock/report.js
- 类名 StorageReportMethodService → StockReportMethodService
- 缓存键 storage_report_export_ → stock_report_export_
- 日志前缀 [storage.report] → [stock.report]
- methods/system.json: module + 5 method 名同步更新
- methods/changes/system.json: 追加迁移记录
- systems/storage/entry.js: 注释引用修正

旧文件直接删除,不保留兼容(旧 method 名为语义错误)。
2026-07-17 00:30:54 +08:00
liufumingren
391ab87112 fix(order_express): 包材批量绑定适配 current+dispatch 双表查询
修复波次团购包材批量绑定只查 current 表导致 dispatch 表订单遗漏的问题:
- bindExpressPackageMaterialByWaybill: 波次检测改为 current→dispatch 双表遍历
- _bindWavePackageMaterialByBusinessKey: 波次订单查询改为双表合并去重
- _getStoreName / _getWaveSysLogisticsName: 货主/物流名查询改为双表遍历
- _upsertPackageMaterialItemRelation: items_hash 查询改为双表遍历
- _updateSingleOrderWeight: items_weight 读取改为双表遍历
2026-07-16 20:19:03 +08:00
liufumingren
16d5f18fa1 feat(openapi): interface_type_id=2 强制合约注入 + 全链路 store_id 防护
核心改动:
- openapi.js: 新增 resolveOpenapiContract 强制合约解析(required:true JOIN),
  dispatchOpenapiMethod 统一注入上下文(setInfo)
- 5个 openapiMethods: 移除重复 resolveAppInfo, 统一使用 this.getInfo()
- deliveryorder/entryorder/stockout: findByPk(itemId) 后增加 store_id 一致性校验

安全修复:
- 修复 itemId 路径跨货主越权漏洞(FindByPk 无 store_id 过滤)
- deliveryorder/inventory/singleitem 查询补全 store_id 过滤
- 合约缺失返回 403 而非穿透业务层

测试覆盖: 9方法×3层防护(合约/注入/过滤)全部通过集成测试
2026-07-15 00:10:40 +08:00
liufumingren
fddd142427 fix: custom_barcode 唯一约束改为仓库级别,修复 batchUpdateSpaceInfo 等条码检查跨仓库问题 2026-07-10 18:10:11 +08:00
liufumingren
a1f5c5d532 fix(storeWarehouse): list 查询使用 OR 两边匹配,兼容新旧签约数据
- serializeRelation: 根据 currentSubject.id 匹配 store_id/warehouse_id 判定对方主体

- listForStore/listForWarehouse: 使用 store_id/warehouse_id OR 查询替代 buildListWhereByStoreId

- remask/use_status: 基于实际所在侧判定而非 isWarehouse 角色

- 修复仓库用户看不到签约货主方信息的问题
2026-07-09 11:54:53 +08:00
liufumingren
6d58d7ff1f docs: 仓储报表微调 + methods 接口文档同步更新
- storage/report: 报表逻辑微调

- methods/system.json: storeWarehouse 系列接口文档更新

- methods/changes/system.json: 新增 2026.07.08/07.09 变更记录
2026-07-09 03:36:19 +08:00
liufumingren
ca5c8a269e feat: 推单二级校验 + 快递分配异步化 + 打印 stock_id 直读
- delivery_order: 新增 auth_status=2 + warehouse_use_status=1 二级签约校验

- express: createWaybillCodePipeline 支持 awaitTasks/onBatchComplete 选项

- pendingOrder: allocateExpressCode 异步进度缓存 + cancelAllocateStorage 拣货完成前置校验

- order_print: 新增 wms_picking.stock_id→wms_stock_warehouse 直读路径,消除 order_items 强依赖
2026-07-09 03:36:15 +08:00
liufumingren
b9ead1fba2 refactor(storeWarehouse): 签约体系重构 — 统一主体维度、移除角色校验、list 拆分
- sign: 统一当前主体→store_id(货主方/消费方),对方→warehouse_id(仓库方/提供方)

- getCounterparty: 移除 expectedRole 角色校验,仓库可签仓库、货主可签货主

- list: 拆分为 listForStore/listForWarehouse,warehouse 侧支持查询外部合作仓库

- 新增 buildListWhereByStoreId 统一按 store_id 维度构建查询条件

- 响应新增 counterparty_role / needs_my_confirm / has_qimen_config 字段
2026-07-09 03:36:09 +08:00
liufumingren
14a5f13ad5 feat(db): wms_store_warehouse 新增 initiator_subject_id,wms_picking 新增 stock_id 及联合索引
- wms_store_warehouse: 新增 initiator_subject_id 记录发起方主体ID

- wms_picking: 新增 stock_id 字段 + idx_wms_picking_warehouse_stock 联合索引 + 历史数据回填

- Model 层同步更新关联定义
2026-07-09 03:36:03 +08:00
liufumingren
19f0449992 fix: 手工运单号防误删三层防护 + 操作日志businessId修正
1. hardDeleteWaybillAsyncOrderExpressRows 加 status:0 过滤,保护手工录入 status=1 记录
2. createWaybillCodePipeline 入口跳过 business_key=1 且已分配运单的订单
3. manualWaybill 操作日志 businessId 从仓库ID 修正为订单ID String(orderId)
4. 新增 14 个单元测试,全部通过
2026-07-07 17:06:43 +08:00
liufumingren
88df30c862 refactor: 签约列表精简输出,仅保留 id/store_id/warehouse_id/counterparty_name/remask/use_status/auth_status/auth_end/print_quantity/policy_config/has_qimen_config 2026-07-06 22:41:52 +08:00
liufumingren
91d3a4f5b3 fix: counterparty_name 改为取 store 表 company_name 主体名称,不取 remask 备注名 2026-07-06 22:38:21 +08:00
liufumingren
72d759964d fix: use_status=0 被 || 跳过导致筛选和状态更新失效,改用 !== undefined 显式判断 2026-07-06 22:33:05 +08:00
liufumingren
2ff17a54dc fix: buildListWhere 货主侧查询按 store_use_status 过滤,仓库侧按 warehouse_use_status 2026-07-06 22:26:38 +08:00
liufumingren
c954a4bb26 fix: serializeRelation 补回 use_status 兼容字段,按当前主体身份取对应仓库/货主侧状态 2026-07-06 22:24:20 +08:00
liufumingren
d1818ae0bf fix: 修复 receiving.js 编码损坏导致语法错误(use_status → warehouse_use_status 重做) 2026-07-06 22:19:34 +08:00
liufumingren
76c52fa268 use_status 重命名为 warehouse_use_status,新增 store_use_status;仓库/货主侧独立控制签约使用状态,unbind 按身份分派字段 2026-07-06 22:12:23 +08:00
liufumingren
41ef9b40de 新增 storeWarehouse.warehouse.list API:仓库侧查询签约货主列表 2026-07-06 22:07:10 +08:00
liufumingren
4e20831386 dashboard 货主端自适应分支:storeStats/express_ratio/platform_distribution 按 store_type 区分仓库/货主查询,货主端跨仓汇总 2026-07-06 22:07:06 +08:00
liufumingren
9c6d984ebc 新增 stock.transaction.list API:商品出入库流水查询(仓库/货主侧自适应),含 system.json 文档注册 2026-07-06 22:07:02 +08:00
liufumingren
df1bd38601 商品流水增加锁定类目语义类型 2026-07-06 19:28:45 +08:00
liufumingren
223e42fcf6 文档变更 2026-07-06 17:19:26 +08:00
liufumingren
897328a4f4 拣货拉取明细字段补充调整 2026-07-06 17:19:06 +08:00
liufumingren
7d92522c2f 库存报表导出增加新字段 2026-07-06 17:18:35 +08:00
liufumingren
525e222351 订单导出excel增加备注、买、卖家留言 2026-07-06 17:17:50 +08:00
liufumingren
70ad3153a1 创建订单原货主策略读取字段错误调整 2026-07-06 17:16:42 +08:00
liufumingren
276d76f65d 新增拣货状态字段输出 2026-07-06 17:15:29 +08:00
liufumingren
2817d17fc7 1 2026-07-06 00:33:12 +08:00
liufumingren
7854057244 chore: ESLint auto-fix formatting (JSDoc, spacing, quotes, line endings) 2026-07-04 23:30:32 +08:00
liufumingren
7f05b26db2 1 2026-07-04 21:40:31 +08:00
liufumingren
5d7964132e 1 2026-07-03 16:56:39 +08:00
liufumingren
962e06787f 1 2026-07-03 16:11:39 +08:00
liufumingren
478ad2ab0d 1 2026-07-03 16:10:46 +08:00
liufumingren
34273c166b 1 2026-07-02 22:08:47 +08:00
liufumingren
300c84c990 1 2026-07-02 22:08:38 +08:00
liufumingren
e73d6f0fb2 1 2026-07-01 14:02:35 +08:00
liufumingren
5ef99e3bed 1 2026-07-01 14:00:59 +08:00
liufumingren
e7fcd2549e 20260625 2026-06-25 02:01:59 +08:00
liufumingren
569a25390f 1 2026-06-24 07:36:43 +08:00
liufumingren
77435aeb79 1 2026-06-23 18:48:33 +08:00
liufumingren
d743e67b9d 1 2026-06-17 01:18:55 +08:00
liufumingren
025184904a 1 2026-06-14 19:03:58 +08:00
liufumingren
0b207a1c9c 1 2026-06-10 09:14:05 +08:00
liufumingren
43c60dd934 1 2026-06-09 14:12:02 +08:00
liufumingren
21949b9a14 fix(deploy): add printer_data_template/** to deploy include paths 2026-06-08 13:44:19 +08:00
liufumingren
0e50ff6671 1 2026-06-08 08:58:13 +08:00
liufumingren
c2b5ffc319 1 2026-06-07 20:42:24 +08:00
liufumingren
eb100b056d 1 2026-06-07 01:52:06 +08:00
liufumingren
e6e65d9d65 1 2026-06-06 16:06:31 +08:00
liufumingren
99367e5043 1 2026-06-06 05:15:46 +08:00
liufumingren
4beefcd22c feat(print,docs,migrations): add notifyLock, order export, express fields and related docs
notifyLock method + logs

print.send logs

order export methods + docs

express model fields SPH/XHS/DW/JD + migration

platform_shop_id migration

notifyLock docs

order export docs
2026-05-30 17:30:17 +08:00
liufumingren
abf2c4d94a 1 2026-05-29 16:47:38 +08:00
liufumingren
dc4894cb6d 1 2026-05-25 17:08:56 +08:00
liufumingren
150e2977d4 修改快递接口配置,拼多多取号,未完成 2026-05-22 08:39:07 +08:00
liufumingren
8cf2c5befa 1 2026-05-20 16:31:29 +08:00
liufumingren
b629b59d4b fix(print): callback sync order print_status by order_ids 2026-05-20 04:55:16 +08:00
liufumingren
9fca81e7b5 1 2026-05-19 16:33:58 +08:00
liufumingren
608d7741c1 1 2026-05-17 23:36:18 +08:00
liufumingren
1d70c01631 1 2026-05-17 22:59:57 +08:00
liufumingren
cd01be6fbd 收货部分更改 2026-05-17 21:51:46 +08:00
liufumingren
e23bf4f15e 1 2026-05-17 03:23:57 +08:00
liufumingren
adb1a16599 1 2026-05-16 23:00:49 +08:00
liufumingren
9845a239e2 1 2026-05-16 02:44:53 +08:00
liufumingren
736ad34351 打印台管理变更 2026-05-14 15:57:51 +08:00
liufumingren
e980512db7 回退wavePickTaskList方法 2026-05-14 12:02:02 +08:00
liufumingren
61c530c0cc 1 2026-05-14 04:00:07 +08:00
liufumingren
81785081a2 团购打印面单 2026-05-13 17:23:24 +08:00
liufumingren
0c3518e65d 1 2026-05-13 03:18:39 +08:00
liufumingren
9c2b254206 1
Co-authored-by: Copilot <copilot@github.com>
2026-05-11 08:44:27 +08:00
liufumingren
f0b5758ada 移除测试报告 2026-05-06 19:44:13 +08:00
liufumingren
a46334afd8 移出测试报告 2026-05-06 17:59:20 +08:00
liufumingren
ba7afcd2ba 1 2026-05-06 17:57:44 +08:00
liufumingren
b0b279a5b9 1 2026-05-06 17:56:55 +08:00
liufumingren
2bc5049cab 1 2026-05-06 17:54:24 +08:00
liufumingren
e9469b58e2 1 2026-05-06 17:54:09 +08:00
liufumingren
d711ba9c21 0506更新
Co-authored-by: Copilot <copilot@github.com>
2026-05-06 17:53:54 +08:00
liufumingren
6b2b9b8467 11 2026-05-06 01:39:09 +08:00
liufumingren
743b82672c 1 2026-05-06 01:38:49 +08:00
liufumingren
77fe27008c Merge branch 'ming' of ssh://192.168.9.101:22/liufumingren/WMS_MAIN into ming 2026-05-06 01:33:52 +08:00
liufumingren
9b2cc5fc73 fix(receiving): 修复获取收货单时重复定义属性的问题 2026-05-06 01:32:55 +08:00
liufumingren
0c3aae0322 fix(receiving): 修复获取收货单时重复定义属性的问题 2026-04-30 19:23:26 +08:00
liufumingren
5ce689d771 1
Co-authored-by: Copilot <copilot@github.com>
2026-04-30 19:20:31 +08:00
liufumingren
b7f980188f 1
Co-authored-by: Copilot <copilot@github.com>
2026-04-29 17:43:54 +08:00
liufumingren
ea8c6ebe82 fix(warehouse): 修复批量修改库位条码误报冲突,并发批量更新,加货架ID限制,更新接口文档 2026-04-29 17:37:27 +08:00
liufumingren
0ffe290a21 chore: commit all current workspace changes 2026-04-27 16:09:26 +08:00
liufumingren
37a8e152a6 同步文档与系统接口变更 2026-04-27 16:09:26 +08:00
liufumingren
fec1dd9f55 chore: update consume progress 2026-04-17 19:23:49 +08:00
liufumingren
622869787a feat: sync workspace changes 2026-04-17 19:21:57 +08:00
liufumingren
d442b91ca1 chore: apply minor updates and enhancements 2026-04-11 17:34:53 +08:00
liufumingren
b0700c6629 chore: minor updates and improvements 2026-04-11 17:30:15 +08:00
liufumingren
aba81d497a ok 2026-04-11 17:30:06 +08:00
liufumingren
18580144c6 ok 2026-04-11 17:09:59 +08:00
liufumingren
e73a311076 ok 2026-04-11 17:09:06 +08:00
liufumingren
460ce119c5 ok 2026-04-11 17:08:55 +08:00
liufumingren
54189de2db ok 2026-04-11 17:08:47 +08:00
liufumingren
ceb81b28fd ok 2026-04-11 17:07:47 +08:00
liufumingren
b0ffa69868 ok 2026-04-11 17:07:36 +08:00
liufumingren
9d4271244e ok 2026-04-11 17:07:28 +08:00
liufumingren
16803e8cc2 1 2026-04-11 17:07:16 +08:00
liufumingren
69e992bf9d chore: update change log 2026-04-09 15:45:48 +08:00
liufumingren
57f1f44bae feat: sync wms updates 2026-04-09 15:45:14 +08:00
liufumingren
ee7d2a1f8f chore: sync remaining changes 2026-04-09 01:38:59 +08:00
liufumingren
3d824a3a1d chore: sync lint and service fixes 2026-04-09 01:36:49 +08:00
liufumingren
e590808062 feat: update receiving notification and report flow 2026-04-05 21:45:18 +08:00
liufumingren
de9c5c0ab6 Merge branch 'ming' of ssh://192.168.9.101:22/liufumingren/WMS_MAIN into ming 2026-04-05 09:08:09 +08:00
liufumingren
920d201c0e feat: refine setting role/account/permission auth and tests 2026-04-05 09:03:50 +08:00
liufumingren
26af1a7039 feat: refine setting role/account/permission auth and tests 2026-03-31 00:35:53 +08:00
liufumingren
2f838186de chore: sync updates and daylog 2026-03-26 2026-03-25 23:26:10 +08:00
liufumingren
b9e94f1035 chore: 提交当前工作区改动 2026-03-25 18:12:04 +08:00
liufumingren
67c6856d75 chore: commit current workspace changes 2026-03-25 13:17:51 +08:00
liufumingren
ab26e1e8e7 chore: 全量提交,包含脚本、文档与配置等最新更改 2026-03-24 23:59:59 +08:00
liufumingren
2a1c8b4fa8 fix(deploy): 健康检查支持本地兜底与超时,切服后可自动回退本地端口 2026-03-24 23:57:20 +08:00
liufumingren
bbc5891d16 chore: sync workspace changes 2026-03-23 17:10:07 +08:00
liufumingren
9ab060d223 docs: 更新日报并初始化 qimen 接口文档 2026-03-22 17:12:47 +08:00
liufumingren
86dfc92551 docs: 更新 README 与 day.log 2026-03-22 16:53:11 +08:00
liufumingren
279b292bae chore: 更新接口文档路由与methods工作流 2026-03-22 16:21:09 +08:00
liufumingren
4faff36ccb docs: 更新2026-03-22日报,补充规范格式与内容 2026-03-22 01:38:45 +08:00
liufumingren
39a882f2c9 docs: 重写README,完善项目说明 2026-03-22 01:19:55 +08:00