65 Commits

Author SHA1 Message Date
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
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
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
576eb1b2e8 feat(order): 订单新增包裹总重量 packages_weight(称重回写与各端展示) 2026-09-30 03:08:49 +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
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
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
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
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
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
a5a6ea4a93 chore(frp): 新增 frpc 隧道安装/启动脚本与配置,忽略本地 frpc.exe 二进制 2026-09-23 02:46:44 +08:00
liufumingren
c6224b471e chore(script): 临时脚本移入 temp 目录(gitignore 范围,退出版本控制) 2026-09-20 16:14:10 +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
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
c3f1c67592 chore(script): 沉淀波次池/报表/库存/订单本地排查脚本
新增一批一次性排查脚本(script/tmp-*.cjs),与仓库既有 script/tmp- 约定保持一致,
覆盖波次池边界与优先级核对、库位/出库报表核对、订单状态与更新范围核验等场景
2026-09-13 15:31:27 +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
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
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
6a71957686 feat(pick): 大团购任务 pick_mode 修正为 5,波次/订单/拣货任务表新增领料人与抓取人字段,领料人非本人拦截重领并覆盖 2026-09-04 21:43:05 +08:00
liufumingren
fb8840ecdb chore(ops): 生产日志目录巡检与清理脚本,超过 4GiB 触发清理至 2GiB 以下,活跃日志与近期轮转保留,附本地 dry-run 自测桩 2026-09-03 17:03:59 +08:00
liufumingren
373bb84294 chore(db): 数据库脚本连接目标保护(WMS_DB_TARGET 显式解析防误连生产库) 2026-08-30 07:28:36 +08:00
liufumingren
f2fe5311aa chore(script): 调试脚本移入 temp/ 不再纳入版本控制 2026-08-27 23:38:46 +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
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
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
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
37104079e5 feat(order): 订单/明细 id 防回退——序列表唯一发号 + 分表免重建 + 水位自愈 + 迁移任务执行历史 2026-08-15 20:12:23 +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
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
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
5759c1fb19 feat(deploy): 部署脚本增加端口强制清理 + 健康检查超时延长至 20s
- 新增步骤 5.5:启动前通过 ss + fuser -k 强制释放目标端口残留进程
- 健康检查重试次数从 5 次增加到 10 次,最长等待从 10s 延长至 20s
- 健康检查失败日志增加启动日志路径提示
2026-08-01 15:31:00 +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
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
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
34273c166b 1 2026-07-02 22:08:47 +08:00
liufumingren
77435aeb79 1 2026-06-23 18:48:33 +08:00
liufumingren
21949b9a14 fix(deploy): add printer_data_template/** to deploy include paths 2026-06-08 13:44:19 +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
dc4894cb6d 1 2026-05-25 17:08:56 +08:00