376 Commits

Author SHA1 Message Date
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
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
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
beb9e06a08 fix(returnReceived): 修复登记时间筛选白名单缺失并补充 created_at/updated_at,登记响应新增 is_urgent 加急标记,配套 (warehouse_id, created_at) 索引迁移 2026-09-23 22:22:54 +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
df0c1735c8 fix(workbench): business 打包分支恢复 users 上报打包人,token+key 新链路保持工作台成员回填 2026-09-21 19:25:22 +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
dc9f83a2d7 perf(aftersale): 售后/退货拆包订单查询改为 attributes 白名单,减少全字段加载 2026-09-20 16:14:06 +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
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