@besile/scm-cli 2026.3.29

package/src/shortcuts/material-orders/list.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * Material Orders +list shortcut
+ */
+import { scmClient, ordersLogger } from '../../internal/index.js';
+
+export const MaterialOrdersList = {
+    service: 'material-orders',
+    command: '+list',
+    description: '查询物料订单列表',
+    risk: 'read',
+    scopes: [],
+    hasFormat: true,
+    flags: [
+        { name: 'open-id', type: 'string', required: true, description: '飞书用户 openId' },
+        { name: 'page-no', type: 'number', default: 1, description: '页码' },
+        { name: 'page-size', type: 'number', default: 20, description: '每页条数' },
+        // 订单信息
+        { name: 'order-no', type: 'string', description: '物料订单号' },
+        { name: 'status', type: 'string', description: '物料订单状态: 0-待采购|1-采购中|2-部分到货|3-已到货|4-已取消' },
+        { name: 'cooperation-mode', type: 'string', description: '合作模式: 0-CMT|1-FOB' },
+        // 商品信息
+        { name: 'goods-full-code', type: 'string', description: '大货款号' },
+        { name: 'goods-batch', type: 'string', description: '大货批次' },
+        { name: 'goods-type', type: 'string', description: '大货类型: 0-首单|1-加单|2-翻单' },
+        // 供应商
+        { name: 'supplier-name', type: 'string', description: '供应商名称' },
+        // 人员
+        { name: 'purchaser-id-list', type: 'string', description: '采购员 ID 列表 (逗号分隔)' },
+        { name: 'pd-user-id-list', type: 'string', description: 'PD ID 列表 (逗号分隔)' },
+        { name: 'designer-name', type: 'string', description: '设计师名称' },
+        // 时间
+        { name: 'type', type: 'string', description: '时间查询类型: 0-上市|1-下单|2-交期|3-调整|4-关单|5-生产下单|6-工厂接单|7-计划到货|8-实际到货|9-需求到货' },
+        { name: 'start-time', type: 'string', description: '开始时间 (ISO 8601)' },
+        { name: 'end-time', type: 'string', description: '结束时间 (ISO 8601)' },
+    ],
+
+    async execute(internal, runtime) {
+        const f = runtime.flags;
+        const openId = f['open-id'];
+        const token = await scmClient.getToken(openId, null, null);
+
+        const filter = {
+            pageNo: parseInt(f['page-no']) || 1,
+            pageSize: Math.min(parseInt(f['page-size']) || 20, 100),
+        };
+
+        // 订单信息
+        if (f['order-no']) filter.orderNo = f['order-no'];
+        if (f['status'] !== undefined) filter.status = parseInt(f['status']);
+        if (f['cooperation-mode'] !== undefined) filter.cooperationMode = parseInt(f['cooperation-mode']);
+        // 商品信息
+        if (f['goods-full-code']) filter.goodsFullCode = f['goods-full-code'];
+        if (f['goods-batch']) filter.goodsBatch = f['goods-batch'];
+        if (f['goods-type'] !== undefined) filter.goodsType = parseInt(f['goods-type']);
+        // 供应商
+        if (f['supplier-name']) filter.supplierName = f['supplier-name'];
+        // 人员
+        if (f['purchaser-id-list']) filter.purchaserIdList = f['purchaser-id-list'].split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+        if (f['pd-user-id-list']) filter.pdUserIdList = f['pd-user-id-list'].split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+        if (f['designer-name']) filter.designerName = f['designer-name'];
+        // 时间
+        if (f['type'] !== undefined) filter.type = parseInt(f['type']);
+        if (f['start-time']) filter.startTime = f['start-time'];
+        if (f['end-time']) filter.endTime = f['end-time'];
+
+        const body = { domain: 'goods_material', action: 'query', filter };
+        const endpoint = '/admin-api/api/ai-scm/execute';
+        const result = await scmClient.invoke(endpoint, { method: 'POST', body }, { token });
+
+        ordersLogger.info('查询物料订单', { openId, total: result?.total });
+        return result || {};
+    },
+};

package/src/shortcuts/production-orders/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * Production Orders shortcuts
+ */
+import { ProductionOrdersList } from './list.js';
+import { ProductionOrdersQuery } from './query.js';
+
+export function Shortcuts() {
+    return [ProductionOrdersList, ProductionOrdersQuery];
+}

package/src/shortcuts/production-orders/list.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * Production Orders +list shortcut
+ */
+import { scmClient, ordersLogger } from '../../internal/index.js';
+
+/**
+ * +list shortcut — list production orders with pagination
+ */
+export const ProductionOrdersList = {
+    service: 'production-orders',
+    command: '+list',
+    description: '查询大货生产订单列表（支持分页）',
+    risk: 'read',
+    scopes: [],
+    hasFormat: true,
+    flags: [
+        { name: 'open-id', type: 'string', required: true, description: '飞书用户 openId' },
+        { name: 'page-no', type: 'number', default: 1, description: '页码，从 1 开始' },
+        { name: 'page-size', type: 'number', default: 20, description: '每页条数，最大 100' },
+    ],
+
+    async execute(internal, runtime) {
+        const { 'open-id': openId, 'page-no': pageNo, 'page-size': pageSize } = runtime.flags;
+        const token = await scmClient.getToken(openId, null, null);
+
+        const body = {
+            domain: 'production_order',
+            action: 'query',
+            filter: {
+                pageNo: parseInt(pageNo) || 1,
+                pageSize: Math.min(parseInt(pageSize) || 20, 100),
+            },
+        };
+
+        const endpoint = '/admin-api/api/ai-scm/execute';
+        const result = await scmClient.invoke(endpoint, {
+            method: 'POST',
+            body,
+        }, { token });
+
+        ordersLogger.info('查询生产订单', { openId, total: result?.total });
+        return result || {};
+    },
+};

package/src/shortcuts/production-orders/query.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * Production Orders +query shortcut
+ */
+import { scmClient, ordersLogger } from '../../internal/index.js';
+
+/**
+ * +query shortcut — full production orders query with all filters
+ */
+export const ProductionOrdersQuery = {
+    service: 'production-orders',
+    command: '+query',
+    description: '查询大货生产订单（支持全部筛选条件）',
+    risk: 'read',
+    scopes: [],
+    hasFormat: true,
+    flags: [
+        { name: 'open-id', type: 'string', required: true, description: '飞书用户 openId' },
+        { name: 'page-no', type: 'number', default: 1, description: '页码' },
+        { name: 'page-size', type: 'number', default: 20, description: '每页条数' },
+        // 订单状态
+        { name: 'prod-status', type: 'string', description: '生产订单状态: -1-全部|0-待确定|1-待同步|2-在途中|3-已完成|100-已取消' },
+        { name: 'confirm-supplier', type: 'string', description: '确认供应商: 0-未确认|1-已确认' },
+        { name: 'supplier-order-status', type: 'string', description: '供应商订单状态' },
+        { name: 'quotation-status', type: 'string', description: '报价单状态' },
+        { name: 'wash-status', type: 'string', description: '洗唛订单状态' },
+        // 商品信息
+        { name: 'goods-full-code', type: 'string', description: '大货款号' },
+        { name: 'goods-batch', type: 'string', description: '大货批次' },
+        { name: 'goods-type', type: 'string', description: '大货类型: 0-首单|1-加单|2-翻单' },
+        // 供应商
+        { name: 'supplier-name', type: 'string', description: '供应商名称' },
+        { name: 'cooperation-mode', type: 'string', description: '合作模式: 0-CMT|1-FOB' },
+        // 人员
+        { name: 'designer-name', type: 'string', description: '设计师名称' },
+        // 时间
+        { name: 'type', type: 'string', description: '时间类型: 0-上市|1-下单|2-交期...' },
+        { name: 'start-time', type: 'string', description: '开始时间 (ISO 8601)' },
+        { name: 'end-time', type: 'string', description: '结束时间 (ISO 8601)' },
+        // 状态标识
+        { name: 'qc-inspection', type: 'string', description: 'QC 质检结果' },
+        // 分类
+        { name: 'sale-area', type: 'string', description: '销售地区 ID 列表（逗号分隔）' },
+    ],
+
+    async execute(internal, runtime) {
+        const f = runtime.flags;
+        const openId = f['open-id'];
+
+        const token = await scmClient.getToken(openId, null, null);
+
+        const filter = {
+            pageNo: parseInt(f['page-no']) || 1,
+            pageSize: Math.min(parseInt(f['page-size']) || 20, 100),
+        };
+
+        // Optional filters
+        if (f['prod-status'] !== undefined) filter.prodStatus = parseInt(f['prod-status']);
+        if (f['confirm-supplier'] !== undefined) filter.confirmSupplier = parseInt(f['confirm-supplier']);
+        if (f['supplier-order-status'] !== undefined) filter.supplierOrderStatus = parseInt(f['supplier-order-status']);
+        if (f['quotation-status'] !== undefined) filter.quotationStatus = parseInt(f['quotation-status']);
+        if (f['wash-status'] !== undefined) filter.washStatus = parseInt(f['wash-status']);
+        if (f['goods-full-code']) filter.goodsFullCode = f['goods-full-code'];
+        if (f['goods-batch']) filter.goodsBatch = f['goods-batch'];
+        if (f['goods-type'] !== undefined) filter.goodsType = parseInt(f['goods-type']);
+        if (f['supplier-name']) filter.supplierName = f['supplier-name'];
+        if (f['cooperation-mode'] !== undefined) filter.cooperationMode = parseInt(f['cooperation-mode']);
+        if (f['designer-name']) filter.designerName = f['designer-name'];
+        if (f['type'] !== undefined) filter.type = parseInt(f['type']);
+        if (f['start-time']) filter.startTime = f['start-time'];
+        if (f['end-time']) filter.endTime = f['end-time'];
+        if (f['qc-inspection'] !== undefined) filter.qcInspection = parseInt(f['qc-inspection']);
+        if (f['sale-area']) filter.saleArea = f['sale-area'].split(',').map(Number);
+
+        const body = { domain: 'production_order', action: 'query', filter };
+
+        const endpoint = '/admin-api/api/ai-scm/execute';
+        const result = await scmClient.invoke(endpoint, { method: 'POST', body }, { token });
+
+        ordersLogger.info('查询生产订单', { openId, total: result?.total });
+        return result || {};
+    },
+};

package/src/shortcuts/qc-orders/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * QC Orders shortcuts
+ */
+import { QcOrdersList } from './list.js';
+
+export function Shortcuts() {
+    return [QcOrdersList];
+}

package/src/shortcuts/qc-orders/list.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * QC Orders +list shortcut
+ */
+import { scmClient, ordersLogger } from '../../internal/index.js';
+
+export const QcOrdersList = {
+    service: 'qc-orders',
+    command: '+list',
+    description: '查询 QC 质检订单列表',
+    risk: 'read',
+    scopes: [],
+    hasFormat: true,
+    flags: [
+        { name: 'open-id', type: 'string', required: true, description: '飞书用户 openId' },
+        { name: 'page-no', type: 'number', default: 1, description: '页码' },
+        { name: 'page-size', type: 'number', default: 10, description: '每页条数' },
+        // 订单状态
+        { name: 'qc-order-status', type: 'string', description: 'QC 订单状态: -1-全部|0-待分配|1-已分配|2-已完成|3-已取消' },
+        // 商品信息
+        { name: 'goods-full-code', type: 'string', description: '大货款号' },
+        { name: 'goods-type', type: 'string', description: '大货类型: 1-大货|2-翻单|3-补料' },
+        { name: 'goods-grade-list', type: 'string', description: '商品分级列表 (逗号分隔)' },
+        // 供应商
+        { name: 'supplier-name', type: 'string', description: '供应商名称' },
+        // 人员
+        { name: 'mid-manager', type: 'string', description: '中查管理人员' },
+        { name: 'check-goods', type: 'string', description: '查货人员' },
+        { name: 'tail-manager', type: 'string', description: '尾查管理人员' },
+        { name: 'qc-user-id-list', type: 'string', description: 'QC 用户 ID 列表 (逗号分隔)' },
+        { name: 'prod-manager-id-list', type: 'string', description: '生产经理 ID 列表 (逗号分隔)' },
+        { name: 'purchaser-id-list', type: 'string', description: '采购员 ID 列表 (逗号分隔)' },
+        // 时间
+        { name: 'time-type', type: 'string', description: '时间类型: 0-预约验货|1-下单|2-接单|3-分配|4-完成|5-交期' },
+        { name: 'start-time', type: 'string', description: '开始时间 (ISO 8601)' },
+        { name: 'end-time', type: 'string', description: '结束时间 (ISO 8601)' },
+    ],
+
+    async execute(internal, runtime) {
+        const f = runtime.flags;
+        const openId = f['open-id'];
+        const token = await scmClient.getToken(openId, null, null);
+
+        const filter = {
+            pageNo: parseInt(f['page-no']) || 1,
+            pageSize: Math.min(parseInt(f['page-size']) || 10, 100),
+        };
+
+        // 订单状态
+        if (f['qc-order-status'] !== undefined) filter.qcOrderStatus = parseInt(f['qc-order-status']);
+        // 商品信息
+        if (f['goods-full-code']) filter.goodsFullCode = f['goods-full-code'];
+        if (f['goods-type'] !== undefined) filter.goodsType = parseInt(f['goods-type']);
+        if (f['goods-grade-list']) filter.goodsGradeList = f['goods-grade-list'].split(',').map(s => s.trim());
+        // 供应商
+        if (f['supplier-name']) filter.supplierName = f['supplier-name'];
+        // 人员
+        if (f['mid-manager']) filter.midManager = f['mid-manager'];
+        if (f['check-goods']) filter.checkGoods = f['check-goods'];
+        if (f['tail-manager']) filter.tailManager = f['tail-manager'];
+        if (f['qc-user-id-list']) filter.qcUserIdList = f['qc-user-id-list'].split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+        if (f['prod-manager-id-list']) filter.prodManagerIdList = f['prod-manager-id-list'].split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+        if (f['purchaser-id-list']) filter.purchaserIdList = f['purchaser-id-list'].split(',').map(s => parseInt(s.trim())).filter(n => !isNaN(n));
+        // 时间
+        if (f['time-type'] !== undefined) filter.timeType = parseInt(f['time-type']);
+        if (f['start-time']) filter.startTime = f['start-time'];
+        if (f['end-time']) filter.endTime = f['end-time'];
+
+        const body = { domain: 'qc_order', action: 'query', filter };
+        const endpoint = '/admin-api/api/ai-scm/execute';
+        const result = await scmClient.invoke(endpoint, { method: 'POST', body }, { token });
+
+        ordersLogger.info('查询 QC 订单', { openId, total: result?.total });
+        return result || {};
+    },
+};

package/src/shortcuts/register.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Copyright (c) 2026 WFS
+ * SPDX-License-Identifier: MIT
+ *
+ * Shortcuts registration — registers all shortcuts to the command tree
+ *
+ * Inspired by lark-cli's shortcuts/register.go
+ */
+
+import { shortcutAction } from './common/runner.js';
+
+/**
+ * Register all shortcuts for a domain
+ *
+ * @param {Object} program - Commander program
+ * @param {string} domain - Domain name (e.g., 'production-orders')
+ * @param {Array} shortcuts - Array of Shortcut definitions
+ * @param {Object} internalCtx - Internal context
+ */
+function registerDomainShortcuts(program, domain, shortcuts, internalCtx) {
+    // Find or create domain subcommand
+    let domainCmd = program.commands.find(c => c.name() === domain);
+
+    if (!domainCmd) {
+        domainCmd = program
+            .command(domain)
+            .description(`${domain} commands`);
+    }
+
+    for (const shortcut of shortcuts) {
+        // Build command name without + prefix
+        const cmdName = shortcut.command.replace(/^\+/, '');
+
+        // Create command with description
+        const cmd = domainCmd
+            .command(cmdName)
+            .description(shortcut.description);
+
+        // Add flags
+        for (const flag of (shortcut.flags || [])) {
+            let flagSpec = `--${flag.name}`;
+            if (flag.type === 'boolean') {
+                flagSpec = `--${flag.name}`;
+            } else {
+                flagSpec += ` <${flag.name}>`;
+            }
+
+            const description = flag.description || '';
+            const defaultVal = flag.default !== undefined ? String(flag.default) : undefined;
+
+            if (flag.type === 'boolean') {
+                cmd.option(`--${flag.name}`, description, defaultVal);
+            } else if (flag.required) {
+                cmd.requiredOption(`${flagSpec} [required]`, description);
+            } else {
+                cmd.option(`${flagSpec}`, description, defaultVal);
+            }
+        }
+
+        // Add --format flag if hasFormat
+        if (shortcut.hasFormat !== false) {
+            cmd.option('--format <format>', 'Output format: table|json|pretty', 'table');
+        }
+
+        // Register action
+        cmd.action(shortcutAction(shortcut, internalCtx));
+    }
+}
+
+/**
+ * Register all shortcuts to the commander program
+ *
+ * @param {Object} program - Root commander program
+ * @param {Object} shortcutsMap - Map of domain -> Shortcut[] (from domain/index.js)
+ * @param {Object} internalCtx - Internal context
+ */
+export function registerShortcuts(program, shortcutsMap, internalCtx) {
+    for (const [domain, shortcuts] of Object.entries(shortcutsMap)) {
+        registerDomainShortcuts(program, domain, shortcuts, internalCtx);
+    }
+}