411 Commits

Author SHA1 Message Date
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
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
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
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
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
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