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

package/cli/commands/query.js

@@ -0,0 +1,285 @@
+// 四组业务命令：商品、物料、生产单、物料采购单。design 命令族查询设计款与 IE 核价，
+// design-order 命令族查询版单（旗舰版功能）。
+// 每个命令默认输出人类可读表格；全局 --json 时输出原始 JSON（供 AI 解析）。
+const { call } = require('../api');
+const { printTable } = require('../table');
+
+const goods = {
+  command: 'goods',
+  describe: '查询商品',
+  builder(yargs) {
+    return yargs
+      .command({
+        command: 'search',
+        describe: '按款号/名称/条码搜商品',
+        builder: (y) => y.option('name', { describe: '搜索关键词（款号、名称或条码）', demandOption: true, type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/goods/search', { searchKey: argv.name, page: argv.page, limit: argv.limit });
+          return { list: data.list, total: data.total, columns: [
+            { field: 'goodsSn', label: '款号' },
+            { field: 'name', label: '名称' },
+            { field: 'isOnSale', label: '上架(1是0否)' },
+            { field: 'tagPrice', label: '吊牌价' },
+            { field: 'storedNumber', label: '库存' },
+            { field: 'produceNumber', label: '生产中' },
+            { field: 'produceOrderNumber', label: '生产单数' },
+          ] };
+        }),
+      })
+      .command({
+        command: 'detail',
+        describe: '商品详情（颜色尺码与工序）',
+        builder: (y) => y.option('id', { describe: '商品id（先用 search 查到）', demandOption: true, type: 'number' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/goods/detail', { goodsId: argv.id });
+          return { data, columns: null };
+        }),
+      })
+      .demandCommand(1, '请指定子命令：search 或 detail');
+  },
+};
+
+const material = {
+  command: 'material',
+  describe: '查询物料',
+  builder(yargs) {
+    return yargs
+      .command({
+        command: 'search',
+        describe: '按名称/货号/条码搜物料',
+        builder: (y) => y.option('name', { describe: '搜索关键词（物料名称、货号或条码）', demandOption: true, type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/material/search', { searchKey: argv.name, page: argv.page, limit: argv.limit });
+          return { list: data.list, total: data.total, columns: [
+            { field: 'sn', label: '货号' },
+            { field: 'name', label: '名称' },
+            { field: 'type', label: '类型(1面料0辅料)' },
+            { field: 'state', label: '状态(1启用)' },
+            { field: 'price', label: '价格' },
+            { field: 'stockNumber', label: '库存' },
+            { field: 'defaultSupplierName', label: '默认供应商' },
+          ] };
+        }),
+      })
+      .command({
+        command: 'detail',
+        describe: '物料详情（单品颜色规格）',
+        builder: (y) => y.option('id', { describe: '物料id（先用 search 查到）', demandOption: true, type: 'number' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/material/detail', { id: argv.id });
+          return { data, columns: null };
+        }),
+      })
+      .demandCommand(1, '请指定子命令：search 或 detail');
+  },
+};
+
+const produce = {
+  command: 'produce',
+  describe: '查询生产单',
+  builder(yargs) {
+    return yargs
+      .command({
+        command: 'list',
+        describe: '生产单列表（至少给一项条件）',
+        builder: (y) => y
+          .option('sn', { describe: '关键词：单号/款号/商品名', type: 'string' })
+          .option('state', { describe: '状态：1草稿 2生产中 3生产完成 4待生产 9已撤销', type: 'number' })
+          .option('from', { describe: '业务日期起（yyyy-MM-dd）', type: 'string' })
+          .option('to', { describe: '业务日期止（yyyy-MM-dd）', type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/produce/list', { searchKey: argv.sn, state: argv.state, from: argv.from, to: argv.to, page: argv.page, limit: argv.limit });
+          return { list: data.list, total: data.total, columns: [
+            { field: 'ordersSn', label: '生产单号' },
+            { field: 'goodsSn', label: '款号' },
+            { field: 'goodsName', label: '商品' },
+            { field: 'stateName', label: '状态' },
+            { field: 'sumNumber', label: '下单数' },
+            { field: 'sumInNumber', label: '入库数' },
+            { field: 'deliveryTime', label: '交期' },
+            { field: 'cutBedState', label: '裁床状态' },
+          ] };
+        }),
+      })
+      .command({
+        command: 'detail',
+        describe: '生产单详情（明细与工序进度，裁床工序 core=2）',
+        builder: (y) => y.option('sn', { describe: '生产单号', demandOption: true, type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/produce/detail', { sn: argv.sn });
+          return { data, columns: null };
+        }),
+      })
+      .demandCommand(1, '请指定子命令：list 或 detail');
+  },
+};
+
+const materialPurchase = {
+  command: 'material-purchase',
+  describe: '查询物料采购单',
+  builder(yargs) {
+    return yargs
+      .command({
+        command: 'list',
+        describe: '物料采购单列表（至少给一项条件）',
+        builder: (y) => y
+          .option('sn', { describe: '关键词：单号/供应商/生产单号/物料', type: 'string' })
+          .option('state', { describe: '状态：1草稿 2待入库 3部分入库 4全部入库 9撤销', type: 'number' })
+          .option('from', { describe: '业务日期起（yyyy-MM-dd）', type: 'string' })
+          .option('to', { describe: '业务日期止（yyyy-MM-dd）', type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/material-purchase/list', { searchKey: argv.sn, state: argv.state, from: argv.from, to: argv.to, page: argv.page, limit: argv.limit });
+          return { list: data.list, total: data.total, columns: [
+            { field: 'ordersSn', label: '采购单号' },
+            { field: 'supplierName', label: '供应商' },
+            { field: 'state', label: '状态' },
+            { field: 'sumPurchaseNumber', label: '采购数' },
+            { field: 'amount', label: '金额' },
+            { field: 'expectTime', label: '预计到料' },
+          ] };
+        }),
+      })
+      .command({
+        command: 'detail',
+        describe: '物料采购单详情（物料明细）',
+        builder: (y) => y.option('sn', { describe: '采购单号', demandOption: true, type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/material-purchase/detail', { sn: argv.sn });
+          return { data, columns: null };
+        }),
+      })
+      .demandCommand(1, '请指定子命令：list 或 detail');
+  },
+};
+
+const design = {
+  command: 'design',
+  describe: '查询设计款与IE核价',
+  builder(yargs) {
+    return yargs
+      .command({
+        command: 'list',
+        describe: '设计款列表（至少给一项条件）',
+        builder: (y) => y
+          .option('sn', { describe: '关键词：款号/名称/条码/货号', type: 'string' })
+          .option('state', { describe: '状态：2设计中 3待确定 4修改中 5审核通过 6取消 15开发池 16版型资产库', type: 'number' })
+          .option('dateType', { describe: '日期字段：update更新 create创建 dev开发（默认 update）', type: 'string', default: 'update' })
+          .option('from', { describe: '日期起（yyyy-MM-dd）', type: 'string' })
+          .option('to', { describe: '日期止（yyyy-MM-dd）', type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/design/list', { searchKey: argv.sn, designState: argv.state, dateType: argv.dateType, from: argv.from, to: argv.to, page: argv.page, limit: argv.limit });
+          return { list: data.list, total: data.total, columns: [
+            { field: 'designSn', label: '款号' },
+            { field: 'name', label: '名称' },
+            { field: 'designState', label: '状态(2设计中3待确定4修改中5审核通过6取消15开发池16版型资产库)' },
+            { field: 'designBrandName', label: '品牌' },
+            { field: 'designCategoryName', label: '分类' },
+            { field: 'designDesignerName', label: '设计师' },
+            { field: 'followerName', label: '跟单员' },
+            { field: 'costPrice', label: '成本价' },
+            { field: 'designStoredNumber', label: '库存' },
+            { field: 'designOrderCount', label: '板单数' },
+          ] };
+        }),
+      })
+      .command({
+        command: 'ie-list',
+        describe: 'IE核价报表（设计款×颜色的物料/工序/费用明细）',
+        builder: (y) => y
+          .option('sn', { describe: '关键词：名称/货号/款号/条码', type: 'string' })
+          .option('dateType', { describe: '日期字段：dev开发 create创建（默认 dev）', type: 'string', default: 'dev' })
+          .option('from', { describe: '日期起（yyyy-MM-dd）', type: 'string' })
+          .option('to', { describe: '日期止（yyyy-MM-dd）', type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/design/ie-list', { searchKey: argv.sn, dateType: argv.dateType, from: argv.from, to: argv.to, page: argv.page, limit: argv.limit });
+          return { list: data.list, total: data.total, columns: [
+            { field: 'designSn', label: '款号' },
+            { field: 'name', label: '名称' },
+            { field: 'colorName', label: '颜色' },
+            { field: 'costPrice', label: '成本价' },
+            { field: 'designerName', label: '设计师' },
+          ] };
+        }),
+      })
+      .demandCommand(1, '请指定子命令：list 或 ie-list');
+  },
+};
+
+const designOrder = {
+  command: 'design-order',
+  describe: '查询版单（旗舰版功能）',
+  builder(yargs) {
+    return yargs
+      .command({
+        command: 'list',
+        describe: '版单列表（至少给一项条件）',
+        builder: (y) => y
+          .option('sn', { describe: '关键词：款号/名称/版单号/备注/货号', type: 'string' })
+          .option('states', { describe: '版单状态（逗号分隔）：1未开始 2进行中 3已结束 4废版 9撤销 10审批中 12审批拒绝', type: 'string' })
+          .option('review-state', { describe: '审版状态：2未设置审版 3待审 4已审', type: 'number' })
+          .option('node', { describe: '当前节点名称，如：纸样、车板', type: 'string' })
+          .option('overdue', { describe: '逾期筛选：pattern纸样逾期 sweep车版逾期', type: 'string' })
+          .option('dateType', { describe: '日期字段：business下版（默认） create创建 update更新 finish预计完成 delivery交付', type: 'string', default: 'business' })
+          .option('from', { describe: '日期起（yyyy-MM-dd）', type: 'string' })
+          .option('to', { describe: '日期止（yyyy-MM-dd）', type: 'string' }),
+        handler: (argv) => run(argv, async () => {
+          const data = await call('GET', '/api/agent/v1/design-order/list', {
+            searchKey: argv.sn, states: argv.states, reviewState: argv.reviewState,
+            node: argv.node, overdue: argv.overdue, dateType: argv.dateType,
+            from: argv.from, to: argv.to, page: argv.page, limit: argv.limit,
+          });
+          return { list: data.list, total: data.total, columns: [
+            { field: 'designOrderSn', label: '版单号' },
+            { field: 'designSn', label: '款号' },
+            { field: 'designName', label: '名称' },
+            { field: 'stateText', label: '状态' },
+            { field: 'currentProgressState', label: '当前节点' },
+            { field: 'designOrderSerialName', label: '版次' },
+            { field: 'businessTime', label: '下版日期' },
+            { field: 'finishTime', label: '预计完成' },
+            { field: 'totalNumber', label: '打版数' },
+            { field: 'supplierName', label: '供应商' },
+          ] };
+        }),
+      })
+      .command({
+        command: 'detail',
+        describe: '版单详情（打版数量、节点进度、BOM、工艺要求、同款全部版单）',
+        builder: (y) => y
+          .option('sn', { describe: '版单号', type: 'string' })
+          .option('id', { describe: '版单id（先用 list 查到）', type: 'number' }),
+        handler: (argv) => run(argv, async () => {
+          if (!argv.sn && !argv.id) {
+            throw new Error('请提供版单号 --sn 或版单 id --id（二选一）');
+          }
+          const data = await call('GET', '/api/agent/v1/design-order/detail', { sn: argv.sn, id: argv.id });
+          return { data, columns: null };
+        }),
+      })
+      .demandCommand(1, '请指定子命令：list 或 detail');
+  },
+};
+
+/** 统一执行：异常输出可读文案并以非 0 退出；--json 输出原始数据 */
+async function run(argv, task) {
+  try {
+    const { list, total, columns, data } = await task();
+    if (argv.json) {
+      console.log(JSON.stringify({ total, list, data }, null, 2));
+      return;
+    }
+    if (columns) {
+      if (total !== undefined) {
+        console.log(`共 ${total} 条，当前显示 ${list.length} 条`);
+      }
+      printTable(list, columns);
+    } else {
+      console.log(JSON.stringify(data, null, 2));
+    }
+  } catch (e) {
+    console.error(`错误：${e.message}`);
+    process.exitCode = 1;
+  }
+}
+
+module.exports = { goods, material, produce, materialPurchase, design, designOrder };

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 };