@chaobinchen/mes-cli 1.0.0

package/src/commands/material.js

@@ -0,0 +1,483 @@
+/**
+ * 物料相关命令（场景 18–23）
+ *
+ * 18. stock-records   (sr)   — 物料批次出入库记录
+ * 19. stock-inventory (si)   — 物料库存查询
+ * 20. trace-forward   (tf)   — 半成品编码+批次追溯原料
+ * 21. trace-backward  (tb)   — 原料编码+批次反向跟踪半成品
+ * 22. material-usage  (mu)   — 近几天原料使用明细
+ * 23. stock-coverage  (sc)   — 原料库存与使用量对比
+ */
+
+'use strict';
+
+const { queryWithParams, close, sql } = require('../db');
+const { resolveConfig } = require('../config');
+const { printTable } = require('../display');
+const chalk = require('chalk');
+
+// ─── 场景 18：物料批次出入库记录 ───────────────────────────────────────────────
+const STOCK_RECORDS_SQL = `
+SELECT
+    material_code,
+    material_name,
+    operate_batch,
+    operate_quantity,
+    CASE
+        WHEN operate_type = 1 THEN N'下架'
+        WHEN operate_type = 2 THEN N'上架'
+        ELSE N'未知类型'
+    END AS operate_type_text,
+    CASE
+        WHEN task_type = 1 THEN N'入库'
+        WHEN task_type = 2 THEN N'出库'
+        WHEN task_type = 4 THEN N'移库'
+        WHEN task_type = 8 THEN N'盘点'
+        ELSE N'未知任务'
+    END AS task_type_text,
+    CASE
+        WHEN operate_property = 1 THEN N'正常执行'
+        WHEN operate_property = 2 THEN N'虚补'
+        WHEN operate_property = 4 THEN N'虚退'
+        ELSE N'未知性质'
+    END AS operate_property_text,
+    CASE
+        WHEN quality_inspection_status = 1 THEN N'未启用'
+        WHEN quality_inspection_status = 2 THEN N'待检验'
+        WHEN quality_inspection_status = 4 THEN N'检验中'
+        WHEN quality_inspection_status = 8 THEN N'合格'
+        WHEN quality_inspection_status = 16 THEN N'不合格'
+        WHEN quality_inspection_status = 32 THEN N'过期'
+        ELSE N'未知状态'
+    END AS quality_status,
+    CASE
+        WHEN consumed_state = 1 THEN N'未过账'
+        WHEN consumed_state = 2 THEN N'已过账'
+        WHEN consumed_state = 4 THEN N'过账撤销'
+        ELSE N'未知状态'
+    END AS consumed_status,
+    CASE
+        WHEN terminal = 1 THEN N'PDA端'
+        WHEN terminal = 2 THEN N'网页端'
+        ELSE N'未知终端'
+    END AS terminal_text,
+    CASE
+        WHEN audit_status = 0 THEN N'未审核'
+        WHEN audit_status = 1 THEN N'已审核'
+        WHEN audit_status = 2 THEN N'无需审核'
+        ELSE N'未知状态'
+    END AS audit_status_text,
+    user_name,
+    store_name,
+    area_name,
+    location_name,
+    CONVERT(NVARCHAR(19), create_time, 120) AS record_time
+FROM wms_tasks_execute
+WHERE material_code = @material_code
+  AND ISNULL(is_delete, 0) = 0
+  AND (@batch IS NULL OR operate_batch = @batch)
+ORDER BY create_time DESC, id DESC;
+`;
+
+async function stockRecordsCommand(materialCode, options, command) {
+  let dbConfig;
+  try { dbConfig = resolveConfig(command.parent.opts()); }
+  catch (err) { console.error(chalk.red('✖  连接配置错误:'), err.message); process.exitCode = 1; return; }
+
+  try {
+    console.log(chalk.dim(`⏳  正在查询物料出入库记录: ${materialCode} …`));
+    const rows = await queryWithParams(STOCK_RECORDS_SQL, [
+      { name: 'material_code', type: sql.NVarChar(100), value: materialCode },
+      { name: 'batch',         type: sql.NVarChar(100), value: options.batch || null },
+    ], dbConfig);
+    printTable(rows, `物料出入库记录 — ${materialCode}${options.batch ? ' / ' + options.batch : ''}`);
+  } catch (err) {
+    console.error(chalk.red('✖  查询失败:'), err.message);
+    process.exitCode = 1;
+  } finally { await close(); }
+}
+
+// ─── 场景 19：物料库存查询 ─────────────────────────────────────────────────────
+const STOCK_INVENTORY_SQL = `
+SELECT
+    material_code,
+    material_name,
+    batch,
+    CAST(quantity AS FLOAT) AS quantity,
+    CAST(frozen_quantity AS FLOAT) AS frozen_quantity,
+    CAST(quantity_to_checkin AS FLOAT) AS quantity_to_checkin,
+    CAST(quantity_to_checkout AS FLOAT) AS quantity_to_checkout,
+    unit,
+    store_name,
+    area_name,
+    location_name,
+    CASE
+        WHEN quality_inspection_status = 0 THEN N'未启用'
+        WHEN quality_inspection_status = 1 THEN N'未检验'
+        WHEN quality_inspection_status = 2 THEN N'检验中'
+        WHEN quality_inspection_status = 4 THEN N'合格'
+        WHEN quality_inspection_status = 8 THEN N'不合格'
+        WHEN quality_inspection_status = 16 THEN N'过期'
+        ELSE N'未知状态'
+    END AS quality_status,
+    CASE WHEN is_expired = 1 THEN N'已过期' ELSE N'未过期' END AS expired_status,
+    CONVERT(NVARCHAR(10), expiration_date, 120) AS expiration_date
+FROM wms_inventory_record
+WHERE material_code = @material_code
+  AND ISNULL(is_delete, 0) = 0
+  AND (@batch IS NULL OR batch = @batch)
+ORDER BY expiration_date, quantity DESC;
+`;
+
+async function stockInventoryCommand(materialCode, options, command) {
+  let dbConfig;
+  try { dbConfig = resolveConfig(command.parent.opts()); }
+  catch (err) { console.error(chalk.red('✖  连接配置错误:'), err.message); process.exitCode = 1; return; }
+
+  try {
+    console.log(chalk.dim(`⏳  正在查询物料库存: ${materialCode} …`));
+    const rows = await queryWithParams(STOCK_INVENTORY_SQL, [
+      { name: 'material_code', type: sql.NVarChar(100), value: materialCode },
+      { name: 'batch',         type: sql.NVarChar(100), value: options.batch || null },
+    ], dbConfig);
+    printTable(rows, `物料库存 — ${materialCode}${options.batch ? ' / ' + options.batch : ''}`);
+  } catch (err) {
+    console.error(chalk.red('✖  查询失败:'), err.message);
+    process.exitCode = 1;
+  } finally { await close(); }
+}
+
+// ─── 场景 20：半成品编码+批次追溯原料 ─────────────────────────────────────────
+const TRACE_FORWARD_SQL = `
+SET NOCOUNT ON;
+
+IF OBJECT_ID('tempdb..#bulk_work_orders_trace') IS NOT NULL DROP TABLE #bulk_work_orders_trace;
+CREATE TABLE #bulk_work_orders_trace (id BIGINT NOT NULL);
+INSERT INTO #bulk_work_orders_trace (id)
+SELECT id FROM psm_work_order
+WHERE product_code = @semi_product_code
+  AND batch_num = @semi_batch_num
+  AND tr_type = 2
+  AND ISNULL(is_deleted, 0) = 0;
+
+IF NOT EXISTS (SELECT 1 FROM #bulk_work_orders_trace)
+BEGIN
+    SELECT CAST(0 AS BIT) AS success,
+           N'未找到半成品编码' + @semi_product_code + N'、半成品批次' + @semi_batch_num + N'对应的半成品工单' AS message,
+           CAST(NULL AS NVARCHAR(100)) AS material_code, CAST(NULL AS NVARCHAR(200)) AS material_name,
+           CAST(NULL AS NVARCHAR(100)) AS material_batch, CAST(NULL AS DECIMAL(38,10)) AS actual_quantity;
+    RETURN;
+END;
+
+CREATE UNIQUE CLUSTERED INDEX IX_bulk_work_orders_trace_id ON #bulk_work_orders_trace(id);
+
+;WITH premix_material AS (
+    SELECT b.code AS material_code, b.name AS material_name,
+           ISNULL(NULLIF(LTRIM(RTRIM(e.batch_number)), N''), N'未记录批次') AS material_batch,
+           ISNULL(e.quantity, 0) AS actual_quantity
+    FROM psm_bulk_trcp_logic_premix_barcode b
+    INNER JOIN #bulk_work_orders_trace wo ON wo.id = b.work_order_id
+    INNER JOIN psm_bulk_trcp_logic_premix_barcode_execute e
+        ON e.put_id = b.id AND e.work_order_id = b.work_order_id
+    WHERE b.put_material_type = 0 AND ISNULL(b.is_delete, 0) = 0
+),
+manual_material AS (
+    SELECT b.code AS material_code, b.name AS material_name,
+           ISNULL(NULLIF(LTRIM(RTRIM(r.barcode_material_batch)), N''), N'未记录批次') AS material_batch,
+           ISNULL(r.barcode_material_quantity, 0) AS actual_quantity
+    FROM psm_bulk_trcp_logic_step_barcode b
+    INNER JOIN #bulk_work_orders_trace wo ON wo.id = b.work_order_id
+    INNER JOIN psm_bulk_trcplc_report_put_material_item r
+        ON r.tr_set_barcode_id = b.id AND r.work_order_id = b.work_order_id
+    WHERE b.put_material_type = 0 AND ISNULL(b.is_delete, 0) = 0
+),
+auto_phase_base AS (
+    SELECT p.work_order_id, p.spar00 AS material_code, p.spar02 AS material_name,
+           REPLACE(REPLACE(REPLACE(ISNULL(p.execute_text, N''), N'<br/>', N'<br>'), N'：', N':'), CHAR(13)+CHAR(10), N'') AS exec_text
+    FROM psm_bulk_trcp_logic_step_phase p
+    INNER JOIN #bulk_work_orders_trace wo ON wo.id = p.work_order_id
+    WHERE p.ep_type = 2 AND ISNULL(p.is_delete, 0) = 0
+),
+auto_material AS (
+    SELECT ap.material_code, ap.material_name,
+           ISNULL(NULLIF(LTRIM(RTRIM(parsed.batch_txt)), N''), N'未记录批次') AS material_batch,
+           ISNULL(TRY_CONVERT(DECIMAL(38,10), REPLACE(REPLACE(REPLACE(LTRIM(RTRIM(parsed.weight_txt)), N'Kg', N''), N'KG', N''), N'kg', N'')), 0) AS actual_quantity
+    FROM auto_phase_base ap
+    CROSS APPLY (SELECT CHARINDEX(N'投加批次:', ap.exec_text) AS batch_tag_pos, CHARINDEX(N'投加重量:', ap.exec_text) AS weight_tag_pos) p1
+    CROSS APPLY (SELECT CASE WHEN p1.batch_tag_pos > 0 THEN p1.batch_tag_pos + LEN(N'投加批次:') ELSE 0 END AS batch_start_pos,
+                        CASE WHEN p1.weight_tag_pos > 0 THEN p1.weight_tag_pos + LEN(N'投加重量:') ELSE 0 END AS weight_start_pos) p2
+    CROSS APPLY (SELECT CASE WHEN p2.batch_start_pos > 0 THEN CHARINDEX(N'<br>', ap.exec_text + N'<br>', p2.batch_start_pos) ELSE 0 END AS batch_end_pos,
+                        CASE WHEN p2.weight_start_pos > 0 THEN CHARINDEX(N'<br>', ap.exec_text + N'<br>', p2.weight_start_pos) ELSE 0 END AS weight_end_pos) p3
+    CROSS APPLY (SELECT CASE WHEN p2.batch_start_pos > 0 AND p3.batch_end_pos > p2.batch_start_pos THEN SUBSTRING(ap.exec_text, p2.batch_start_pos, p3.batch_end_pos - p2.batch_start_pos) ELSE NULL END AS batch_txt,
+                        CASE WHEN p2.weight_start_pos > 0 AND p3.weight_end_pos > p2.weight_start_pos THEN SUBSTRING(ap.exec_text, p2.weight_start_pos, p3.weight_end_pos - p2.weight_start_pos) ELSE NULL END AS weight_txt) parsed
+    WHERE NULLIF(LTRIM(RTRIM(ap.material_code)), N'') IS NOT NULL
+),
+all_material AS (
+    SELECT material_code, material_name, material_batch, actual_quantity FROM premix_material
+    UNION ALL
+    SELECT material_code, material_name, material_batch, actual_quantity FROM manual_material
+    UNION ALL
+    SELECT material_code, material_name, material_batch, actual_quantity FROM auto_material
+)
+SELECT CAST(1 AS BIT) AS success, CAST(NULL AS NVARCHAR(200)) AS message,
+       material_code, MAX(material_name) AS material_name, material_batch, SUM(actual_quantity) AS actual_quantity
+FROM all_material
+GROUP BY material_code, material_batch
+ORDER BY material_code, material_batch
+OPTION (RECOMPILE);
+`;
+
+async function traceForwardCommand(options, command) {
+  let dbConfig;
+  try { dbConfig = resolveConfig(command.parent.opts()); }
+  catch (err) { console.error(chalk.red('✖  连接配置错误:'), err.message); process.exitCode = 1; return; }
+
+  if (!options.code || !options.batch) {
+    console.error(chalk.red('✖  请通过 --code <半成品编码> --batch <半成品批次> 指定查询条件'));
+    process.exitCode = 1;
+    return;
+  }
+
+  try {
+    console.log(chalk.dim(`⏳  正在追溯原料: 半成品 ${options.code} / ${options.batch} …`));
+    const rows = await queryWithParams(TRACE_FORWARD_SQL, [
+      { name: 'semi_product_code', type: sql.NVarChar(100), value: options.code },
+      { name: 'semi_batch_num',    type: sql.NVarChar(100), value: options.batch },
+    ], dbConfig);
+
+    if (!rows || rows.length === 0) {
+      console.log(chalk.yellow('⚠  查询无返回结果'));
+      return;
+    }
+    if (!rows[0].success) {
+      console.error(chalk.red(`✖  ${rows[0].message}`));
+      process.exitCode = 1;
+      return;
+    }
+    // 去掉 success/message 元数据列
+    const display = rows.map(r => ({
+      material_code: r.material_code,
+      material_name: r.material_name,
+      material_batch: r.material_batch,
+      actual_quantity: r.actual_quantity,
+    }));
+    printTable(display, `原料追溯 — ${options.code} / ${options.batch}`);
+  } catch (err) {
+    console.error(chalk.red('✖  查询失败:'), err.message);
+    process.exitCode = 1;
+  } finally { await close(); }
+}
+
+// ─── 场景 21：原料编码+批次反向跟踪半成品 ─────────────────────────────────────
+const TRACE_BACKWARD_SQL = `
+SET NOCOUNT ON;
+
+IF OBJECT_ID('tempdb..#matched_bulk_order_ids_reverse') IS NOT NULL DROP TABLE #matched_bulk_order_ids_reverse;
+CREATE TABLE #matched_bulk_order_ids_reverse (work_order_id BIGINT NOT NULL PRIMARY KEY);
+
+;WITH premix_match AS (
+    SELECT DISTINCT b.work_order_id
+    FROM psm_bulk_trcp_logic_premix_barcode b
+    INNER JOIN psm_bulk_trcp_logic_premix_barcode_execute e ON e.put_id = b.id AND e.work_order_id = b.work_order_id
+    WHERE b.code = @material_code
+      AND ISNULL(NULLIF(LTRIM(RTRIM(e.batch_number)), N''), N'未记录批次') = @material_batch
+      AND b.put_material_type = 0 AND ISNULL(b.is_delete, 0) = 0
+),
+manual_match AS (
+    SELECT DISTINCT b.work_order_id
+    FROM psm_bulk_trcp_logic_step_barcode b
+    INNER JOIN psm_bulk_trcplc_report_put_material_item r ON r.tr_set_barcode_id = b.id AND r.work_order_id = b.work_order_id
+    WHERE b.code = @material_code
+      AND ISNULL(NULLIF(LTRIM(RTRIM(r.barcode_material_batch)), N''), N'未记录批次') = @material_batch
+      AND b.put_material_type = 0 AND ISNULL(b.is_delete, 0) = 0
+),
+auto_phase_base AS (
+    SELECT p.work_order_id,
+           REPLACE(REPLACE(REPLACE(ISNULL(p.execute_text, N''), N'<br/>', N'<br>'), N'：', N':'), CHAR(13)+CHAR(10), N'') AS exec_text
+    FROM psm_bulk_trcp_logic_step_phase p
+    WHERE p.ep_type = 2 AND p.spar00 = @material_code AND ISNULL(p.is_delete, 0) = 0
+),
+auto_match AS (
+    SELECT DISTINCT ap.work_order_id
+    FROM auto_phase_base ap
+    CROSS APPLY (SELECT CHARINDEX(N'投加批次:', ap.exec_text) AS batch_tag_pos) p1
+    CROSS APPLY (SELECT CASE WHEN p1.batch_tag_pos > 0 THEN p1.batch_tag_pos + LEN(N'投加批次:') ELSE 0 END AS batch_start_pos) p2
+    CROSS APPLY (SELECT CASE WHEN p2.batch_start_pos > 0 THEN CHARINDEX(N'<br>', ap.exec_text + N'<br>', p2.batch_start_pos) ELSE 0 END AS batch_end_pos) p3
+    CROSS APPLY (SELECT CASE WHEN p2.batch_start_pos > 0 AND p3.batch_end_pos > p2.batch_start_pos
+                              THEN SUBSTRING(ap.exec_text, p2.batch_start_pos, p3.batch_end_pos - p2.batch_start_pos)
+                              ELSE NULL END AS batch_txt) parsed
+    WHERE ISNULL(NULLIF(LTRIM(RTRIM(parsed.batch_txt)), N''), N'未记录批次') = @material_batch
+)
+INSERT INTO #matched_bulk_order_ids_reverse (work_order_id)
+SELECT DISTINCT x.work_order_id FROM (
+    SELECT work_order_id FROM premix_match
+    UNION ALL SELECT work_order_id FROM manual_match
+    UNION ALL SELECT work_order_id FROM auto_match
+) x;
+
+IF NOT EXISTS (SELECT 1 FROM #matched_bulk_order_ids_reverse)
+BEGIN
+    SELECT CAST(0 AS BIT) AS success,
+           N'未找到原料编码' + @material_code + N'、原料批次' + @material_batch + N'对应的半成品工单' AS message,
+           CAST(NULL AS NVARCHAR(100)) AS semi_product_code, CAST(NULL AS NVARCHAR(200)) AS semi_product_name,
+           CAST(NULL AS NVARCHAR(100)) AS semi_batch_num,    CAST(NULL AS NVARCHAR(100)) AS order_num,
+           CAST(NULL AS DECIMAL(38,10)) AS planned_quantity;
+    RETURN;
+END;
+
+SELECT CAST(1 AS BIT) AS success, CAST(NULL AS NVARCHAR(200)) AS message,
+       w.product_code AS semi_product_code, w.product_name AS semi_product_name,
+       w.batch_num AS semi_batch_num, w.order_num, w.quantity AS planned_quantity
+FROM psm_work_order w
+INNER JOIN #matched_bulk_order_ids_reverse m ON m.work_order_id = w.id
+WHERE w.tr_type = 2 AND ISNULL(w.is_deleted, 0) = 0
+ORDER BY w.product_code, w.batch_num, w.order_num
+OPTION (RECOMPILE);
+`;
+
+async function traceBackwardCommand(options, command) {
+  let dbConfig;
+  try { dbConfig = resolveConfig(command.parent.opts()); }
+  catch (err) { console.error(chalk.red('✖  连接配置错误:'), err.message); process.exitCode = 1; return; }
+
+  if (!options.code || !options.batch) {
+    console.error(chalk.red('✖  请通过 --code <原料编码> --batch <原料批次> 指定查询条件'));
+    process.exitCode = 1;
+    return;
+  }
+
+  try {
+    console.log(chalk.dim(`⏳  正在反向追溯半成品: 原料 ${options.code} / ${options.batch} …`));
+    const rows = await queryWithParams(TRACE_BACKWARD_SQL, [
+      { name: 'material_code',  type: sql.NVarChar(100), value: options.code },
+      { name: 'material_batch', type: sql.NVarChar(100), value: options.batch },
+    ], dbConfig);
+
+    if (!rows || rows.length === 0) {
+      console.log(chalk.yellow('⚠  查询无返回结果'));
+      return;
+    }
+    if (!rows[0].success) {
+      console.error(chalk.red(`✖  ${rows[0].message}`));
+      process.exitCode = 1;
+      return;
+    }
+    const display = rows.map(r => ({
+      semi_product_code: r.semi_product_code,
+      semi_product_name: r.semi_product_name,
+      semi_batch_num:    r.semi_batch_num,
+      order_num:         r.order_num,
+      planned_quantity:  r.planned_quantity,
+    }));
+    printTable(display, `半成品反向追溯 — 原料 ${options.code} / ${options.batch}`);
+  } catch (err) {
+    console.error(chalk.red('✖  查询失败:'), err.message);
+    process.exitCode = 1;
+  } finally { await close(); }
+}
+
+// ─── 场景 22：近几天原料使用明细 ──────────────────────────────────────────────
+const MATERIAL_USAGE_SQL = `
+SELECT
+    CAST(e.operation_end_time AS DATE) AS use_date,
+    bw.order_num AS semi_order_num,
+    bw.batch_num AS semi_batch_num,
+    bw.product_name AS semi_product_name,
+    e.material_code,
+    e.material_batch,
+    e.actual_quantity,
+    e.operator,
+    e.operation_end_time
+FROM psm_weighing_execute e
+INNER JOIN psm_work_order ww ON e.work_order_id = ww.id AND ww.tr_type = 1 AND ISNULL(ww.is_deleted, 0) = 0
+LEFT JOIN psm_work_order bw ON bw.order_num = ww.order_num AND bw.tr_type = 2 AND ISNULL(bw.is_deleted, 0) = 0
+WHERE e.material_code = @material_code
+  AND (@material_batch IS NULL OR e.material_batch = @material_batch)
+  AND e.operation_end_time >= DATEADD(DAY, -@days, CAST(GETDATE() AS DATE))
+ORDER BY e.operation_end_time DESC, bw.order_num;
+`;
+
+async function materialUsageCommand(materialCode, options, command) {
+  let dbConfig;
+  try { dbConfig = resolveConfig(command.parent.opts()); }
+  catch (err) { console.error(chalk.red('✖  连接配置错误:'), err.message); process.exitCode = 1; return; }
+
+  const days = parseInt(options.days || '180', 10);
+
+  try {
+    console.log(chalk.dim(`⏳  正在查询原料使用明细: ${materialCode} (近 ${days} 天) …`));
+    const rows = await queryWithParams(MATERIAL_USAGE_SQL, [
+      { name: 'material_code',  type: sql.NVarChar(100), value: materialCode },
+      { name: 'material_batch', type: sql.NVarChar(100), value: options.batch || null },
+      { name: 'days',           type: sql.Int,           value: days },
+    ], dbConfig);
+    printTable(rows, `原料使用明细 — ${materialCode} (近 ${days} 天)`);
+  } catch (err) {
+    console.error(chalk.red('✖  查询失败:'), err.message);
+    process.exitCode = 1;
+  } finally { await close(); }
+}
+
+// ─── 场景 23：原料库存与使用量对比 ────────────────────────────────────────────
+const STOCK_COVERAGE_SQL = `
+;WITH current_stock AS (
+    SELECT ISNULL(SUM(quantity), 0) AS current_total_qty, ISNULL(SUM(frozen_quantity), 0) AS current_frozen_qty
+    FROM wms_inventory_record
+    WHERE material_code = @material_code AND ISNULL(is_delete, 0) = 0 AND (@material_batch IS NULL OR batch = @material_batch)
+),
+recent_usage AS (
+    SELECT ISNULL(SUM(actual_quantity), 0) AS recent_used_qty
+    FROM psm_weighing_execute
+    WHERE material_code = @material_code
+      AND (@material_batch IS NULL OR material_batch = @material_batch)
+      AND operation_end_time >= DATEADD(DAY, -@days, CAST(GETDATE() AS DATE))
+)
+SELECT
+    @material_code AS material_code,
+    @material_batch AS material_batch,
+    CAST(cs.current_total_qty AS FLOAT) AS current_total_qty,
+    CAST(cs.current_frozen_qty AS FLOAT) AS current_frozen_qty,
+    CAST(cs.current_total_qty - cs.current_frozen_qty AS FLOAT) AS current_available_qty,
+    CAST(ru.recent_used_qty AS FLOAT) AS recent_used_qty,
+    CAST(ru.recent_used_qty * 1.0 / NULLIF(@days, 0) AS FLOAT) AS avg_daily_used_qty,
+    CAST(ROUND((cs.current_total_qty - cs.current_frozen_qty) * 1.0
+        / NULLIF(ru.recent_used_qty * 1.0 / NULLIF(@days, 0), 0), 0) AS INT) AS coverage_days
+FROM current_stock cs
+CROSS JOIN recent_usage ru;
+`;
+
+async function stockCoverageCommand(materialCode, options, command) {
+  let dbConfig;
+  try { dbConfig = resolveConfig(command.parent.opts()); }
+  catch (err) { console.error(chalk.red('✖  连接配置错误:'), err.message); process.exitCode = 1; return; }
+
+  const days = parseInt(options.days || '180', 10);
+
+  try {
+    console.log(chalk.dim(`⏳  正在分析原料库存覆盖天数: ${materialCode} (近 ${days} 天) …`));
+    const rows = await queryWithParams(STOCK_COVERAGE_SQL, [
+      { name: 'material_code',  type: sql.NVarChar(100), value: materialCode },
+      { name: 'material_batch', type: sql.NVarChar(100), value: options.batch || null },
+      { name: 'days',           type: sql.Int,           value: days },
+    ], dbConfig);
+    if (!rows || rows.length === 0) {
+      console.log(chalk.yellow('⚠  查询无返回结果'));
+      return;
+    }
+    const r = rows[0];
+    const { printDetail } = require('../display');
+    printDetail(r, `库存与用量对比 — ${materialCode} (近 ${days} 天)`);
+  } catch (err) {
+    console.error(chalk.red('✖  查询失败:'), err.message);
+    process.exitCode = 1;
+  } finally { await close(); }
+}
+
+module.exports = {
+  stockRecordsCommand,
+  stockInventoryCommand,
+  traceForwardCommand,
+  traceBackwardCommand,
+  materialUsageCommand,
+  stockCoverageCommand,
+};

package/src/commands/progress.js

@@ -0,0 +1,172 @@
+/**
+ * 命令：progress <orderNum> — 查询半成品工单的总体进度
+ *
+ * 输入：半成品工单号（如 MO6303A035）
+ * 输出：工单号、计划生产日期、生产车间、计划生产量、称量状态、生产状态
+ */
+
+'use strict';
+
+const { queryWithParams, close, sql } = require('../db');
+const { resolveConfig } = require('../config');
+const { printDetail }   = require('../display');
+const chalk = require('chalk');
+
+// ─── SQL ─────────────────────────────────────────────────────────────────────
+const PROGRESS_SQL = `
+DECLARE
+    @bulk_work_order_id  BIGINT,
+    @weight_work_order_id BIGINT,
+    @plan_start_time     DATETIME2,
+    @workshop_name       NVARCHAR(200),
+    @quantity            DECIMAL(38, 10),
+    @bulk_count          INT,
+    @weight_count        INT;
+
+SELECT
+    @bulk_work_order_id   = MAX(CASE WHEN tr_type = 2 THEN id   END),
+    @weight_work_order_id = MAX(CASE WHEN tr_type = 1 THEN id   END),
+    @plan_start_time      = MAX(CASE WHEN tr_type = 2 THEN plan_start_time END),
+    @workshop_name        = MAX(CASE WHEN tr_type = 2 THEN workshop_name   END),
+    @quantity             = MAX(CASE WHEN tr_type = 2 THEN quantity        END),
+    @bulk_count           = SUM(CASE WHEN tr_type = 2 THEN 1 ELSE 0 END),
+    @weight_count         = SUM(CASE WHEN tr_type = 1 THEN 1 ELSE 0 END)
+FROM psm_work_order
+WHERE order_num = @order_num
+  AND ISNULL(is_deleted, 0) = 0
+  AND tr_type IN (1, 2);
+
+IF ISNULL(@bulk_count, 0) = 0 AND ISNULL(@weight_count, 0) = 0
+BEGIN
+    SELECT
+        CAST(0 AS BIT)                                                   AS success,
+        N'未找到工单号' + @order_num + N'，请重新输入其他工单号'          AS message,
+        CAST(NULL AS NVARCHAR(100))  AS order_num,
+        CAST(NULL AS DATETIME2)      AS plan_start_time,
+        CAST(NULL AS NVARCHAR(200))  AS workshop_name,
+        CAST(NULL AS DECIMAL(38,10)) AS quantity,
+        CAST(NULL AS NVARCHAR(50))   AS weighing_status,
+        CAST(NULL AS NVARCHAR(50))   AS production_status;
+    RETURN;
+END;
+
+IF ISNULL(@bulk_count, 0) <> 1 OR ISNULL(@weight_count, 0) <> 1
+BEGIN
+    SELECT
+        CAST(0 AS BIT)                                                                      AS success,
+        N'工单号' + @order_num + N'对应的半成品工单或称量工单数据不完整，请联系管理员'       AS message,
+        CAST(NULL AS NVARCHAR(100))  AS order_num,
+        CAST(NULL AS DATETIME2)      AS plan_start_time,
+        CAST(NULL AS NVARCHAR(200))  AS workshop_name,
+        CAST(NULL AS DECIMAL(38,10)) AS quantity,
+        CAST(NULL AS NVARCHAR(50))   AS weighing_status,
+        CAST(NULL AS NVARCHAR(50))   AS production_status;
+    RETURN;
+END;
+
+SELECT
+    CAST(1 AS BIT)           AS success,
+    CAST(NULL AS NVARCHAR(200)) AS message,
+    @order_num               AS order_num,
+    @plan_start_time         AS plan_start_time,
+    @workshop_name           AS workshop_name,
+    @quantity                AS quantity,
+    CASE
+        WHEN w.execute_state IS NULL THEN N'未生成称量执行记录'
+        WHEN w.execute_state = 1     THEN N'未称量'
+        WHEN w.execute_state = 2     THEN N'称量中'
+        WHEN w.execute_state = 8     THEN N'称量完成'
+        ELSE N'未知状态(' + CAST(w.execute_state AS NVARCHAR) + N')'
+    END AS weighing_status,
+    CASE
+        WHEN b.execute_state IS NULL THEN N'未生成生产执行记录'
+        WHEN b.execute_state = 0     THEN N'未生产'
+        WHEN b.execute_state = 1     THEN N'生产中'
+        WHEN b.execute_state = 2     THEN N'已暂停'
+        WHEN b.execute_state = 4     THEN N'投料完成'
+        WHEN b.execute_state = 8     THEN N'出锅中'
+        WHEN b.execute_state = 16    THEN N'已出锅'
+        ELSE N'未知状态(' + CAST(b.execute_state AS NVARCHAR) + N')'
+    END AS production_status
+FROM (SELECT 1 AS dummy) s
+OUTER APPLY (
+    SELECT TOP (1) execute_state
+    FROM psm_weighing_work_order_execute
+    WHERE parent_id = @weight_work_order_id
+      AND ISNULL(is_deleted, 0) = 0
+    ORDER BY update_time DESC, id DESC
+) w
+OUTER APPLY (
+    SELECT TOP (1) execute_state
+    FROM psm_bulk_execute_work_order
+    WHERE work_order_id = @bulk_work_order_id
+      AND ISNULL(is_deleted, 0) = 0
+    ORDER BY update_time DESC, id DESC
+) b;
+`;
+
+// ─── 命令入口 ─────────────────────────────────────────────────────────────────
+
+/**
+ * progress 子命令入口
+ * @param {string} orderNum  工单号（位置参数）
+ * @param {Object} options   子命令自身选项（当前无额外选项）
+ * @param {import('commander').Command} command  Commander 子命令实例
+ */
+async function progressCommand(orderNum, options, command) {
+  let dbConfig;
+  try {
+    dbConfig = resolveConfig(command.parent.opts());
+  } catch (err) {
+    console.error(chalk.red('✖  连接配置错误:'), err.message);
+    process.exitCode = 1;
+    return;
+  }
+
+  try {
+    console.log(chalk.dim(`⏳  正在查询工单进度: ${orderNum} …`));
+
+    const rows = await queryWithParams(
+      PROGRESS_SQL,
+      [{ name: 'order_num', type: sql.NVarChar(100), value: orderNum }],
+      dbConfig
+    );
+
+    if (!rows || rows.length === 0) {
+      console.log(chalk.yellow('⚠  查询无返回结果，请检查工单号是否正确'));
+      return;
+    }
+
+    const row = rows[0];
+
+    // success = false 时打印错误信息
+    if (!row.success) {
+      console.error(chalk.red(`✖  ${row.message}`));
+      process.exitCode = 1;
+      return;
+    }
+
+    // 格式化输出（隐藏 success / message 两个元数据列）
+    const display = {
+      order_num:         row.order_num,
+      plan_start_time:   row.plan_start_time instanceof Date
+        ? row.plan_start_time.toISOString().replace('T', ' ').slice(0, 19)
+        : row.plan_start_time,
+      workshop_name:     row.workshop_name,
+      quantity:          row.quantity !== null && row.quantity !== undefined
+        ? Number(row.quantity).toString()
+        : null,
+      weighing_status:   row.weighing_status,
+      production_status: row.production_status,
+    };
+
+    printDetail(display, `工单进度 — ${orderNum}`);
+  } catch (err) {
+    console.error(chalk.red('✖  查询失败:'), err.message);
+    process.exitCode = 1;
+  } finally {
+    await close();
+  }
+}
+
+module.exports = { progressCommand };