ming #1
Loading…
x
Reference in New Issue
Block a user
No description provided.
Delete Branch "ming"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
068d760224tofec1dd9f55出站回调: - 新增 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_remaskinbox.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 联合索引迁移- detail返回{after_sale,steps}包装结构 - transfer入参名target_role_group改为role_group - 集成测试8/8全部通过- 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 变更记录- 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 变更记录- 新增迁移 20260907120000:为全部配送分表 wms_order_delivery_{wh}_dispatch 幂等新增 dispath_time(datetime, nullable),不触基表/当前分表/history/outsourced - 配送表模型 schema dispatch 分支同步新增 dispath_time,drift 同步保持一致 - 订单迁移链路 buildDispatchRow 写入 dispath_time=new Date() 记录进入配送表时间- 新增通用报表注册类型 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 两条计划投递成功或仅文本通知环境依赖失败,文件名均带时分秒、导出列与定义勾选一致)- 奇门 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)共享服务与文档,文件粒度无法拆分,一并纳入本次提交。- 回调 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 等。- 统计列 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 根节点取值/归一化- 模型/迁移: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 补齐返回字段断言- 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 用例,期望值现算)- 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 参数说明现象:生产货主群机器人发「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修改地址已经登记,稍后客服将人工跟进」- 新增 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)- 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 注释同步- 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 等模块方法数变化)deliverByChannel 与 sendNotifyIfConfigured 原自行组装 extData={report_definition_id,biz_date,time_point,file_url},覆盖了群配置 ext_data(含渠道来源 source),桥接因缺少 source 无法投递;现统一改为 extData = groupRow.ext_data || null(与 notice 推送口径一致),仅成员推送(无群)显式传 null。- 新增 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 已正确注册该定时任务新增 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)。- 新增 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 等文件,无法按行安全拆分,故合并为一次提交。仓库设置新增嵌套配置 `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 越界、仓库开关与自定义窗口、复用原记录等场景。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 未被改动。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。背景:接口流水原本逐条写 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。- 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 现已干净。- 原实现:明细一条大 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- 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;生产分表随部署后工厂自动补齐- 所有抓取候选与统计查询统一排除 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- 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;生产迁移待随发布执行- 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- getShopExpressList 按 sys_express_code 匹配 wms_express_product_type,补充 product_types: [{ name, code }] - PDD 平台不补充该字段;产品类型读取异常时降级为空数组,不影响快递列表返回 - 补充单测;该测试文件原有 11 个失败为改动前既有失败(基线同样失败) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>- 新增出站回调 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>- 新增 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>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>大屏「今日复核数」(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>