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
|
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
|
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
|
6094f4720d
|
fix(order.export): 导出表头 商品种数/商品件数 更名为 订单商品总类数/订单商品总数(同步拦截订单报表与文档)
|
2026-10-07 23:54:42 +08:00 |
|
liufumingren
|
0fa098c188
|
feat(stock.check): workData 新增 only_abnormal 只看未盘与差异并同步接口文档(0.3.250)
|
2026-10-07 23:26:05 +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
|
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
|
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
|
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
|
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
|
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
|
fa112891a9
|
docs(api): 同步微信模块 system.json 接口文档与变更记录(wechat.* 系列方法)
|
2026-09-23 02:46:39 +08:00 |
|
liufumingren
|
bf4920475d
|
docs(api): 同步 business 打包分支 users 恢复说明与变更记录
|
2026-09-21 19:25:26 +08:00 |
|
liufumingren
|
17944bcf01
|
docs(api): 同步 workbench 打包接口文档、变更记录与方法路由
|
2026-09-21 02:28:07 +08:00 |
|
liufumingren
|
1771b5c6c9
|
docs(api): 同步 system 接口文档、变更记录与方法路由(确认打印相关)
|
2026-09-20 16:14:03 +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
|
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
|
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
|
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 |
|