- 新增通用报表注册类型 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 两条计划投递成功或仅文本通知环境依赖失败,文件名均带时分秒、导出列与定义勾选一致)
71 lines
3.0 KiB
JavaScript
71 lines
3.0 KiB
JavaScript
'use strict';
|
||
|
||
const sevenDayStockFlow = require('./sevenDayStockFlow');
|
||
const interceptOrder = require('./interceptOrder');
|
||
|
||
/**
|
||
* 报表内置查询器注册表。
|
||
* key 对应 wms_report_definition.type;
|
||
* 新增查询器时在此登记,签名统一为
|
||
* async ({ ctx, storeId, warehouseId, params }) => ({ windows, rows, meta })。
|
||
* 每个查询器需在模块上挂载静态字段清单 `fields`(如 module.exports.fields)
|
||
* 与缺省窗口参数 `defaultWindow`,供报表引擎 report.definition.typeList 读取。
|
||
* 注意:该对象会作为 service 模块导出,egg 加载器需要在其上挂载
|
||
* `Symbol(EGG_LOADER_ITEM_FULLPATH)` 等内部符号,因此禁止对导出对象使用
|
||
* Object.freeze / Object.seal / Object.preventExtensions。
|
||
* @type {Object<string, Function>}
|
||
*/
|
||
const QUERIES = {
|
||
stockFlow: sevenDayStockFlow,
|
||
interceptOrder,
|
||
};
|
||
|
||
/**
|
||
* 注册表描述元数据:key/title/description/window/fields。
|
||
* @type {Array<{key: string, title: string, description: string, window: Object, fields: Array<Object>}>}
|
||
*/
|
||
const DESCRIPTIONS = [
|
||
{
|
||
key: 'stockFlow',
|
||
title: '库存变化以及补货报表',
|
||
description: '按日窗口聚合出入库流水与正品库存,输出每 SKU 每日出/入库、外部编码、'
|
||
+ '待处理订单占用数、可用库存、7日总出库数量、推荐采购量与是否触发预警',
|
||
window: {
|
||
...(sevenDayStockFlow.defaultWindow || { dayCount: 7, cutoverHour: 7 }),
|
||
},
|
||
fields: (Array.isArray(sevenDayStockFlow.fields) ? sevenDayStockFlow.fields : []).map(field => ({ ...field })),
|
||
},
|
||
{
|
||
key: 'interceptOrder',
|
||
title: '库内确定拦截订单明细',
|
||
description: '按配送表 dispath_time(订单迁移进配送表的时间)统计昨日库内确定拦截订单'
|
||
+ '(intercept_status=intercepted_at_warehouse),按商品明细展开(一个商品一行),'
|
||
+ '列与订单导出含明细模式(export_mode=item)一致,仅不含「商品图片」列',
|
||
window: {
|
||
...(interceptOrder.defaultWindow || { dayCount: 1, cutoverHour: 0 }),
|
||
},
|
||
fields: (Array.isArray(interceptOrder.fields) ? interceptOrder.fields : []).map(field => ({ ...field })),
|
||
},
|
||
];
|
||
|
||
/**
|
||
* 输出注册表可读描述(含全量字段清单),供 report.definition.typeList 复用。
|
||
* 返回副本,避免调用方误改注册表元数据。
|
||
* @return {Array<{key: string, title: string, description: string, window: Object, fields: Array<Object>}>} 注册描述列表
|
||
*/
|
||
function describe() {
|
||
return DESCRIPTIONS.map(entry => ({
|
||
...entry,
|
||
window: { ...(entry.window || {}) },
|
||
fields: (Array.isArray(entry.fields) ? entry.fields : []).map(field => ({
|
||
...field,
|
||
children: Array.isArray(field.children) ? field.children.map(child => ({ ...child })) : undefined,
|
||
})),
|
||
}));
|
||
}
|
||
|
||
// egg 加载器要求导出对象可扩展,describe 作为方法属性挂在 QUERIES 上
|
||
QUERIES.describe = describe;
|
||
|
||
module.exports = QUERIES;
|