@qinsilk/scm-agent-tools 0.0.0-stage → 0.1.0

package/cli/commands/report.js

@@ -0,0 +1,213 @@
+// 官方报表命令族：16 个报表子命令，每个子命令对应 reports/ 下一个生成模块
+// 与一个官方技能（skills/ 下同名中文技能）。命令负责解析参数与输出结果，
+// 数据获取与文件生成全部在 reports/ 模块内完成。
+// 生成逻辑从原 Python 报表脚本逐列移植，列序、列名、标色、文件名保持一致。
+const path = require('path');
+
+/** 报表定义清单：命令名、模块名、参数说明。新增报表时在此登记。 */
+const REPORTS = [
+  {
+    command: 'produce-daily',
+    module: 'produceDaily',
+    describe: '生成生产日报 HTML（今日入库、计划出货、生产状态、未齐料风险）',
+    options: [
+      ['date', '日报日期 yyyy-MM-dd，默认今天', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'produce-board',
+    module: 'produceBoard',
+    describe: '生成生产节点看板 HTML（近 N 天生产单按工序节点排布）',
+    options: [
+      ['days', '统计天数，默认 7', 'number'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'store-in-goods',
+    module: 'storeInGoods',
+    describe: '生成成品入库报表 Excel（列与页面导出一致，嵌单品图）',
+    options: [
+      ['from', '业务日期起 yyyy-MM-dd', 'string'],
+      ['to', '业务日期止 yyyy-MM-dd', 'string'],
+      ['sn', '单号关键词', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'factory-evaluation',
+    module: 'factoryEvaluation',
+    describe: '生成工厂评估报表 Excel（按加工厂汇总单数、裁床数、完成件数、按时交货率）',
+    options: [
+      ['from', '日期起 yyyy-MM-dd，默认一个月前', 'string'],
+      ['to', '日期止 yyyy-MM-dd，默认今天', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'produce-cost',
+    module: 'produceCost',
+    describe: '生成生产成本报表 Excel（42 列 + 六类成本差异 + 款式图）',
+    options: [
+      ['from', '日期起 yyyy-MM-dd', 'string'],
+      ['to', '日期止 yyyy-MM-dd', 'string'],
+      ['state', '状态筛选，逗号分隔，默认 4,2,3', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'produce-cost-detail',
+    module: 'produceCostDetail',
+    describe: '生成生产成本报表明细（每个生产单一个 Excel，含五类成本明细）',
+    options: [
+      ['from', '日期起 yyyy-MM-dd', 'string'],
+      ['to', '日期止 yyyy-MM-dd', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'material-transit',
+    module: 'materialTransit',
+    describe: '生成物料在途状态报表 Excel（采购在途/已入库未发料/物料缺口三 sheet）',
+    options: [
+      ['days', '统计天数，默认 90', 'number'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'material-purchase-export',
+    module: 'materialPurchaseExport',
+    describe: '生成物料采购导出 Excel（近三个月物料采购子单，39 个业务列）',
+    options: [
+      ['from', '业务日期起 yyyy-MM-dd，默认三个月前', 'string'],
+      ['to', '业务日期止 yyyy-MM-dd，默认今天', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'supplier-balance',
+    module: 'supplierBalance',
+    describe: '生成供应商对账 Excel（11 表对账单，每供应商一个文件）',
+    options: [
+      ['supplier', '供应商名称（不传则全部供应商）', 'string'],
+      ['from', '对账日期起 yyyy-MM-dd', 'string'],
+      ['to', '对账日期止 yyyy-MM-dd', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'leak-check',
+    module: 'leakCheck',
+    describe: '生成漏料检测日报（每生产单一个「物料数据」Excel，默认隐藏 0 用量行）',
+    options: [
+      ['limit', '最多处理的生产单数，默认 100', 'number'],
+      ['include-zero', '包含 0 用量行（默认隐藏）', 'boolean'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'process-followup',
+    module: 'processFollowup',
+    describe: '生成生产单工序跟进表 Excel（需跟进的工序标红）',
+    options: [
+      ['from', '业务日期起 yyyy-MM-dd', 'string'],
+      ['to', '业务日期止 yyyy-MM-dd', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'goods-inventory',
+    module: 'goodsInventory',
+    describe: '生成服装成品盘存表 Excel（商品单品库存，动态尺码列）',
+    options: [
+      ['storehouse', '仓库 id（不传则全部仓库）', 'number'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'ticket-statistics',
+    module: 'ticketStatistics',
+    describe: '生成生产状况统计表 Excel（按部门与货号汇总领货、交货、裁床开始日期）',
+    options: [
+      ['from', '编菲日期起 yyyy-MM-dd（不传则不限）', 'string'],
+      ['to', '编菲日期止 yyyy-MM-dd（不传则不限）', 'string'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'goods-bom',
+    module: 'goodsBom',
+    describe: '生成 BOM 商品信息 Excel（每商品一个文件：商品信息 + BOM + 物料单品）',
+    options: [
+      ['sn', '只导指定款号', 'string'],
+      ['limit', '最多导出的商品数，默认 100', 'number'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'goods-size',
+    module: 'goodsSize',
+    describe: '生成商品尺寸信息 Excel（每商品一个文件，默认部位纵向尺码横向）',
+    options: [
+      ['sn', '只导指定款号', 'string'],
+      ['limit', '最多导出的商品数，默认 100', 'number'],
+      ['transpose', '转置为「尺寸纵向」', 'boolean'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+  {
+    command: 'goods-first-order',
+    module: 'goodsFirstOrder',
+    describe: '生成商品首单面料工序单价 Excel（商品信息 + 首单 BOM 面料 + 工序单价）',
+    options: [
+      ['sn', '只导指定款号', 'string'],
+      ['limit', '最多导出的商品数，默认 100', 'number'],
+      ['out', '输出目录，默认当前目录', 'string'],
+    ],
+  },
+];
+
+/**
+ * 执行一个报表：调用 reports/<module> 的 generate(argv)，输出汇总与文件路径。
+ * 报表内部可能分页多次请求（内置节流），因此耗时可能较长。
+ */
+async function runReport(argv, moduleFile) {
+  try {
+    const mod = require(path.join(__dirname, '..', '..', 'reports', moduleFile));
+    const { filePaths, summary } = await mod.generate(argv);
+    if (summary) {
+      console.log(summary);
+    }
+    for (const filePath of filePaths || []) {
+      console.log(`文件：${filePath}`);
+    }
+  } catch (e) {
+    console.error(`错误：${e.message}`);
+    process.exitCode = 1;
+  }
+}
+
+const report = {
+  command: 'report',
+  describe: '生成官方报表（Excel/HTML 文件，对应官方技能库）',
+  builder(yargs) {
+    let chain = yargs;
+    for (const def of REPORTS) {
+      chain = chain.command({
+        command: def.command,
+        describe: def.describe,
+        builder: (y) => {
+          for (const [name, describe, type] of def.options) {
+            y = y.option(name, { describe, type });
+          }
+          return y;
+        },
+        handler: (argv) => runReport(argv, def.module),
+      });
+    }
+    return chain.demandCommand(1, '请指定报表名。查看全部报表：scm-agent report --help');
+  },
+};
+
+module.exports = { report, REPORTS };