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

package/reports/produceDaily.js

@@ -0,0 +1,485 @@
+// 生产日报 HTML 报表：今日生产入库汇总 + 计划出货 + 生产状态 + 风险待料四个区块。
+// 数据来自 agent 接口（produce-store-in 列表/详情、produce 列表），
+// 聚合与 HTML 结构从原 Python 报表脚本移植，区块结构、合并单元格与颜色标记保持一致。
+const fs = require('fs');
+const path = require('path');
+const { call } = require('../cli/api');
+const { readConfig, DEFAULT_SERVER } = require('../cli/config');
+const { timestamp, dateStr, shiftDate, createThrottle, fetchAll } = require('./util');
+
+/** 服务器对同一 AI Key 每分钟限 30 次请求，两次请求间隔至少 2100 毫秒 */
+const REQUEST_INTERVAL_MS = 2100;
+
+/** 生产单链接域名：在 render 前按本机配置的服务器地址确定，各渲染函数共用 */
+let server = DEFAULT_SERVER;
+
+/** HTML 转义，等价于 Python html.escape(quote=True) */
+function escapeHtml(value) {
+  return String(value)
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#x27;');
+}
+
+/** 字符串比较（按 Unicode 码点，与 Python sorted 对字符串的排序一致） */
+function cmpStr(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+
+/** 按多个字段依次比较，等价于 Python 按元组排序 */
+function tupleCmp(keys) {
+  return (a, b) => {
+    for (const key of keys) {
+      const result = cmpStr(String(a[key]), String(b[key]));
+      if (result !== 0) {
+        return result;
+      }
+    }
+    return 0;
+  };
+}
+
+/** 取第一个非空值（null、undefined、空字符串视为空） */
+function first(...values) {
+  const found = values.find((v) => v !== null && v !== undefined && v !== '');
+  return found === undefined ? '' : found;
+}
+
+/** 数值容错：无法转数字或负数返回 0 */
+function nonNegativeNumber(raw) {
+  const number = Number(raw);
+  if (!Number.isFinite(number) || number < 0) {
+    return 0;
+  }
+  return number;
+}
+
+/**
+ * 解析交货日期为 yyyy-MM-dd。
+ * agent 接口正常返回 yyyy-MM-dd 字符串或 null；数字按时间戳容错（秒/毫秒自动判断）。
+ * 无法解析返回 null，与原脚本的 parse_delivery_date 行为一致。
+ */
+function parseDate(raw) {
+  if (raw === null || raw === undefined || raw === '' || raw === 0) {
+    return null;
+  }
+  if (typeof raw === 'number' && Number.isFinite(raw)) {
+    const ms = Math.abs(raw) > 10_000_000_000 ? raw : raw * 1000;
+    const d = new Date(ms);
+    return Number.isNaN(d.getTime()) ? null : dateStr(d);
+  }
+  const matched = /^\d{4}-\d{2}-\d{2}/.exec(String(raw).trim());
+  return matched ? matched[0] : null;
+}
+
+/**
+ * 拉取一天的生产入库单列表。
+ * agent 接口的 from/to 查询参数即业务日期区间；结束时间由服务端自动加一天，传当天即覆盖全天。
+ */
+async function fetchStoreInRows(day, throttle) {
+  const { list } = await fetchAll(
+    (page, limit) => throttle(() => call('GET', '/api/agent/v1/produce-store-in/list', { from: day, to: day, page, limit })),
+    { limit: 100 },
+  );
+  return list;
+}
+
+/**
+ * 补齐入库单的供应商、客户、款号、数量。
+ * 列表接口已经直接给出这四个字段，只有缺失时才逐单调详情接口补齐（按单号缓存，同一单只调一次），
+ * 因此与原脚本「每单必调详情」相比请求量更少，数据完整时结果相同。
+ * 补齐规则与原脚本一致：供应商取生产单供应商或供应商；款号在行上为空且明细恰好一行时用明细款号；
+ * 数量两个汇总字段都为空时按明细数量求和；客户只在行上为空时用详情值。
+ */
+async function enrichRows(rows, throttle) {
+  const detailCache = new Map();
+  const result = [];
+  for (const row of rows) {
+    const ordersSn = String(first(row.ordersSn));
+    let quantity = first(row.sumStoreInNumber, row.sumInNumber);
+    if (quantity === '') {
+      quantity = null;
+    }
+    const needDetail = !first(row.produceSupplierName, row.supplierName)
+      || !row.produceOrderClientName
+      || !row.goodsSn
+      || quantity === null;
+    let detail = null;
+    if (needDetail && ordersSn) {
+      if (!detailCache.has(ordersSn)) {
+        detailCache.set(ordersSn, await throttle(() => call('GET', '/api/agent/v1/produce-store-in/detail', { sn: ordersSn })));
+      }
+      detail = detailCache.get(ordersSn);
+    }
+    const source = detail || row;
+    const goodsList = (detail && detail.orderGoods) || [];
+    const goods = first(row.goodsSn, goodsList.length === 1 ? goodsList[0].goodsSn : '');
+    if (quantity === null) {
+      quantity = goodsList.length
+        ? goodsList.reduce((sum, item) => sum + Number(item.number || 0), 0)
+        : 0;
+    }
+    result.push({
+      supplier: String(first(source.produceSupplierName, source.supplierName) || '未填写供应商'),
+      goods: String(goods || '未填写货号'),
+      client: String(source.produceOrderClientName || '未填写客户'),
+      quantity,
+    });
+  }
+  return result;
+}
+
+/**
+ * 按「供应商 × 款号 × 客户」聚合入库数量。
+ * Map 保持首次出现的顺序，因此表格行的排列顺序与原脚本一致。
+ */
+function aggregateRows(rows) {
+  const aggregated = new Map();
+  for (const row of rows) {
+    const key = `${row.supplier}\u0001${row.goods}\u0001${row.client}`;
+    let item = aggregated.get(key);
+    if (!item) {
+      item = { supplier: row.supplier, goods: row.goods, client: row.client, quantity: 0 };
+      aggregated.set(key, item);
+    }
+    const number = Number(row.quantity);
+    if (Number.isFinite(number)) {
+      item.quantity += number;
+    }
+  }
+  for (const item of aggregated.values()) {
+    // 聚合结果最多保留 4 位小数，整数不带小数点
+    item.quantity = Math.round(item.quantity * 10000) / 10000;
+  }
+  return [...aggregated.values()];
+}
+
+/**
+ * 拉取生产中与待生产的生产单（状态 2、4），用于计划出货、生产状态、风险待料三个区块。
+ * agent 接口的 state 参数只接受单个状态，因此按状态分别取全量后合并；
+ * 两个状态的结果理论上不重叠，合并时仍按生产单号去重，防止服务端重复返回。
+ */
+async function fetchProduceOrders(throttle) {
+  const merged = [];
+  const seen = new Set();
+  for (const state of [2, 4]) {
+    const { list } = await fetchAll(
+      (page, limit) => throttle(() => call('GET', '/api/agent/v1/produce/list', { state, page, limit })),
+      { limit: 100 },
+    );
+    for (const row of list) {
+      const key = String(row.ordersSn || '');
+      // 生产单号为空时不参与去重，避免多张无单号的单被错误合并
+      if (key && seen.has(key)) {
+        continue;
+      }
+      if (key) {
+        seen.add(key);
+      }
+      merged.push(row);
+    }
+  }
+  return merged;
+}
+
+/**
+ * 把接口行标准化为报表内部结构。
+ * 单号显示规则：只要任意一张单带生产批次号，全部单优先显示批次号，否则显示生产单号。
+ */
+function normalizeProduceOrders(rows) {
+  const useBatch = rows.some((row) => first(row.produceBatchSn) !== '');
+  return rows.map((row) => {
+    const ordersSn = String(first(row.ordersSn));
+    const batchSn = String(first(row.produceBatchSn));
+    return {
+      date: parseDate(row.deliveryTime),
+      supplier: String(first(row.supplierName) || '未填写供应商/加工厂'),
+      displaySn: String((useBatch && batchSn) || ordersSn || '未填写单号'),
+      ordersSn,
+      goods: String(first(row.goodsSn) || '未填写货号'),
+      client: String(first(row.clientName) || '未填写客户'),
+      issueNotCompleteNumber: nonNegativeNumber(row.issueNotCompleteNumber),
+      cutBedState: row.cutBedState,
+    };
+  });
+}
+
+/**
+ * 按裁床状态归类生产状态：裁床完成为「已裁剪」，
+ * 待裁床或裁床中为「待裁剪」，其余（不含裁床、未开始裁床）为「生产中」。
+ */
+function classifyProductionStatus(rows) {
+  return rows.map((row) => ({
+    ...row,
+    status: row.cutBedState === 4 ? '已裁剪' : (row.cutBedState === 2 || row.cutBedState === 3) ? '待裁剪' : '生产中',
+  }));
+}
+
+/**
+ * 按「供应商 × 生产状态 × 款号 × 客户」分组，每组渲染为状态表的一行。
+ * Map 保持首次出现的顺序。
+ */
+function aggregateProductionStatus(rows) {
+  const aggregated = new Map();
+  for (const row of rows) {
+    const key = `${row.supplier}\u0001${row.status}\u0001${row.goods}\u0001${row.client}`;
+    if (!aggregated.has(key)) {
+      aggregated.set(key, { supplier: row.supplier, status: row.status, goods: row.goods, client: row.client });
+    }
+  }
+  return [...aggregated.values()];
+}
+
+/** 风险待料：未齐料数大于 0 的生产单，按供应商、单号、款号排序 */
+function materialRiskRows(rows) {
+  return rows
+    .filter((row) => row.issueNotCompleteNumber > 0)
+    .sort(tupleCmp(['supplier', 'displaySn', 'goods', 'ordersSn']));
+}
+
+/**
+ * 生产单链接：单号存在时渲染为指向生产单详情页的超链接，文本为「单号（款号）」。
+ * 链接域名取本机配置的服务器地址，与登录环境保持一致。
+ */
+function orderLink(order) {
+  const text = escapeHtml(`${order.displaySn}（${order.goods}）`);
+  if (!order.ordersSn) {
+    return text;
+  }
+  const target = `${server}/scm-front/#/production/production-order-details?ordersSn=${encodeURIComponent(order.ordersSn)}`;
+  return `<a href="${escapeHtml(target)}" target="_blank" rel="noopener noreferrer">${text}</a>`;
+}
+
+/**
+ * 渲染「今日已发出」主表。
+ * 合并单元格规则：供应商列在该供应商全部明细行数上合并（rowspan=明细行数），
+ * 款号列在同一款号的行数上合并；子分组顺序保持聚合结果的首次出现顺序。
+ */
+function renderDailyTable(rows, day) {
+  const groups = new Map();
+  for (const row of rows) {
+    if (!groups.has(row.supplier)) {
+      groups.set(row.supplier, []);
+    }
+    groups.get(row.supplier).push(row);
+  }
+  const body = [];
+  for (const [supplier, items] of groups) {
+    const goodsGroups = new Map();
+    for (const item of items) {
+      if (!goodsGroups.has(item.goods)) {
+        goodsGroups.set(item.goods, []);
+      }
+      goodsGroups.get(item.goods).push(item);
+    }
+    let supplierIndex = 0;
+    for (const [goods, goodsItems] of goodsGroups) {
+      goodsItems.forEach((item, goodsIndex) => {
+        const supplierCell = supplierIndex === 0 ? `<th rowspan="${items.length}">${escapeHtml(supplier)}</th>` : '';
+        const goodsCell = goodsIndex === 0 ? `<th rowspan="${goodsItems.length}" class="goods">${escapeHtml(goods)}</th>` : '';
+        body.push(`<tr>${supplierCell}${goodsCell}<td>${escapeHtml(item.client)}</td><td class="num">${escapeHtml(item.quantity)}</td></tr>`);
+        supplierIndex += 1;
+      });
+    }
+  }
+  return (
+    `<section><h1>✅ 今日已发出</h1><p>业务日期：${escapeHtml(day)}　共 ${rows.length} 条汇总明细</p>` +
+    `<table><thead><tr><th>供应商/加工厂</th><th>款号（商品货号）</th><th>客户</th><th>生产入库数量</th></tr></thead><tbody>${body.join('')}</tbody></table></section>`
+  );
+}
+
+/**
+ * 渲染「计划出货时间」区块，分三个桶：
+ * 计划出货（今日起 30 个日历日内）、已过期（交货日期早于今日）、未设置日期。
+ * 已过期与未设置两个桶默认折叠（details 元素），计划出货展开。
+ * 排序：先按交货日期（无日期排在最前），再按供应商、单号、款号。
+ * 合并单元格规则：同一交货日期在全部行数上合并（rowspan=该日期行数），
+ * 日期组内同一供应商再按行数合并；行背景色按桶区分（过期红底、未设置黄底、计划浅蓝底）。
+ */
+function renderDeliveryTable(rows, today) {
+  const end = shiftDate(30, new Date(`${today}T00:00:00`));
+  const buckets = [
+    { title: '计划出货', rows: rows.filter((r) => r.date && today <= r.date && r.date <= end), collapsed: false },
+    { title: '已过期', rows: rows.filter((r) => r.date && r.date < today), collapsed: true },
+    { title: '未设置日期', rows: rows.filter((r) => !r.date), collapsed: true },
+  ];
+  const sortByDateAndOrder = (a, b) => cmpStr(a.date || '', b.date || '') || tupleCmp(['supplier', 'displaySn', 'goods'])(a, b);
+  const output = ['<section class="delivery"><h2>📆计划出货时间</h2><p>计划范围：今日至未来 30 个日历日；过期及未设置日期单独列示。</p>'];
+  for (const bucket of buckets) {
+    const open = bucket.collapsed ? '<details class="delivery-group">' : '<div class="delivery-group">';
+    const close = bucket.collapsed ? '</details>' : '</div>';
+    output.push(bucket.collapsed ? `${open}<summary>${bucket.title}（${bucket.rows.length} 条）</summary>` : open);
+    output.push('<table><thead><tr><th>预计交货日期</th><th>供应商/加工厂</th><th>生产单号/生产批次号（商品）</th></tr></thead><tbody>');
+    if (!bucket.rows.length) {
+      output.push('<tr><td colspan="3" class="empty">暂无数据</td></tr>');
+      output.push(`</tbody></table>${close}`);
+      continue;
+    }
+    const sorted = [...bucket.rows].sort(sortByDateAndOrder);
+    const dateGroups = new Map();
+    for (const row of sorted) {
+      const key = row.date || '';
+      if (!dateGroups.has(key)) {
+        dateGroups.set(key, []);
+      }
+      dateGroups.get(key).push(row);
+    }
+    for (const [date, dateItems] of dateGroups) {
+      const supplierGroups = new Map();
+      for (const row of dateItems) {
+        if (!supplierGroups.has(row.supplier)) {
+          supplierGroups.set(row.supplier, []);
+        }
+        supplierGroups.get(row.supplier).push(row);
+      }
+      // 日期标签：已过期桶显示完整日期；计划桶显示「几号」；无日期显示「未设置」
+      const dateLabel = bucket.title === '已过期' ? date : date ? `${Number(date.slice(8, 10))} 号` : '未设置';
+      let dateIndex = 0;
+      for (const [supplier, supplierItems] of supplierGroups) {
+        supplierItems.forEach((row, index) => {
+          const dateCell = dateIndex === 0 ? `<th rowspan="${dateItems.length}">${escapeHtml(dateLabel)}</th>` : '';
+          const supplierCell = index === 0 ? `<th rowspan="${supplierItems.length}">${escapeHtml(supplier)}</th>` : '';
+          const rowClass = bucket.title === '已过期' ? 'overdue' : !date ? 'nodate' : 'planned';
+          output.push(`<tr class="${rowClass}">${dateCell}${supplierCell}<td>${orderLink(row)}</td></tr>`);
+          dateIndex += 1;
+        });
+      }
+    }
+    output.push(`</tbody></table>${close}`);
+  }
+  output.push('</section>');
+  return output.join('');
+}
+
+/**
+ * 渲染「生产状态」区块，同时输出全部、已裁剪、待裁剪三张表，
+ * 页面脚本按筛选按钮切换显示。
+ * 行排序：供应商按字典序；同一供应商内状态按「生产中、已裁剪、待裁剪」；
+ * 同一状态内按款号、客户排序。供应商列按该供应商全部行数合并，状态列按该状态行数合并。
+ */
+function renderProductionStatusTable(rows) {
+  const statusOrder = { 生产中: 0, 已裁剪: 1, 待裁剪: 2 };
+
+  function renderTable(tableId, selectedRows) {
+    const supplierGroups = new Map();
+    for (const row of selectedRows) {
+      if (!supplierGroups.has(row.supplier)) {
+        supplierGroups.set(row.supplier, new Map());
+      }
+      const statusGroups = supplierGroups.get(row.supplier);
+      if (!statusGroups.has(row.status)) {
+        statusGroups.set(row.status, []);
+      }
+      statusGroups.get(row.status).push(row);
+    }
+    const output = [`<table id="${tableId}" class="status-table"><thead><tr><th>供应商/加工厂</th><th>裁床状态</th><th>商品货号</th><th>客户</th></tr></thead><tbody>`];
+    const orderedSuppliers = [...supplierGroups.entries()].sort((a, b) => cmpStr(a[0], b[0]));
+    for (const [supplier, statusGroups] of orderedSuppliers) {
+      const total = [...statusGroups.values()].reduce((sum, items) => sum + items.length, 0);
+      let supplierIndex = 0;
+      const orderedStatus = [...statusGroups.entries()].sort((a, b) => (statusOrder[a[0]] ?? 9) - (statusOrder[b[0]] ?? 9));
+      for (const [status, items] of orderedStatus) {
+        items.sort(tupleCmp(['goods', 'client']));
+        items.forEach((row, index) => {
+          const supplierCell = supplierIndex === 0 ? `<th rowspan="${total}">${escapeHtml(supplier)}</th>` : '';
+          const statusCell = index === 0 ? `<th rowspan="${items.length}">${escapeHtml(status)}</th>` : '';
+          output.push(`<tr>${supplierCell}${statusCell}<td>${escapeHtml(row.goods)}</td><td>${escapeHtml(row.client)}</td></tr>`);
+          supplierIndex += 1;
+        });
+      }
+    }
+    if (!selectedRows.length) {
+      output.push('<tr><td colspan="4" class="empty">暂无数据</td></tr>');
+    }
+    output.push('</tbody></table>');
+    return output.join('');
+  }
+
+  const output = [
+    '<section class="status"><h2>🔁生产状态</h2><div class="status-filters">',
+    '<button type="button" class="active" data-status-filter="全部">生产中</button>',
+    '<button type="button" data-status-filter="已裁剪">已裁剪</button>',
+    '<button type="button" data-status-filter="待裁剪">待裁剪</button>',
+    '</div><p id="status-count"></p>',
+  ];
+  output.push(renderTable('status-table-all', rows));
+  output.push(renderTable('status-table-done', rows.filter((row) => row.status === '已裁剪')));
+  output.push(renderTable('status-table-wait', rows.filter((row) => row.status === '待裁剪')));
+  output.push('</section>');
+  return output.join('');
+}
+
+/**
+ * 渲染「风险&待料」区块：未齐料的生产单按供应商分组。
+ * 输入行已按供应商、单号、款号排好序，分组保持该顺序，供应商列按组内行数合并。
+ */
+function renderMaterialRiskTable(rows) {
+  const supplierGroups = new Map();
+  for (const row of rows) {
+    if (!supplierGroups.has(row.supplier)) {
+      supplierGroups.set(row.supplier, []);
+    }
+    supplierGroups.get(row.supplier).push(row);
+  }
+  const output = ['<section class="material-risk"><h2>🚨风险&待料</h2><table><thead><tr><th>供应商/加工厂</th><th>生产单号/生产批次号（商品）</th><th>未齐料数</th></tr></thead><tbody>'];
+  for (const [supplier, items] of supplierGroups) {
+    items.forEach((row, index) => {
+      const supplierCell = index === 0 ? `<th rowspan="${items.length}">${escapeHtml(supplier)}</th>` : '';
+      output.push(`<tr>${supplierCell}<td>${orderLink(row)}</td><td class="num">${escapeHtml(row.issueNotCompleteNumber)}</td></tr>`);
+    });
+  }
+  if (!rows.length) {
+    output.push('<tr><td colspan="3" class="empty">暂无未齐料生产单</td></tr>');
+  }
+  output.push('</tbody></table></section>');
+  return output.join('');
+}
+
+/** 组装完整 HTML 文档（样式与筛选按钮脚本与原脚本一致） */
+function render(rows, produceRows, statusRows, materialRisks, day) {
+  const daily = renderDailyTable(rows, day);
+  const delivery = renderDeliveryTable(produceRows, day);
+  const status = renderProductionStatusTable(statusRows);
+  const risk = renderMaterialRiskTable(materialRisks);
+  return `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><title>生产日报 - ${escapeHtml(day)}</title><style>
+body{font-family:"Microsoft YaHei",Arial,sans-serif;color:#1f2937;margin:28px;background:#f8fafc}h1,h2{font-size:24px;margin:0 0 8px}h2{font-size:22px}h3{font-size:18px;margin:18px 0 8px}p{color:#64748b;margin:0 0 18px}.report{max-width:1100px}section{background:#fff;border:1px solid #dbe3ee;border-radius:8px;padding:18px}section+section{margin-top:30px}.delivery-group{margin-top:14px}summary{cursor:pointer;background:#dbeafe;color:#1e3a5f;font-weight:600;padding:10px 12px;border:1px solid #cbd5e1}.status-filters{margin:8px 0 14px}.status-filters button{margin-right:8px;padding:6px 14px;border:1px solid #cbd5e1;border-radius:4px;background:#fff;cursor:pointer}.status-filters button.active{background:#2563eb;color:#fff;border-color:#2563eb}.status-filter-head,.status-filter-cell{display:none}.status-merged-head{display:table-cell}table{border-collapse:collapse;width:100%;font-size:14px}th,td{border:1px solid #cbd5e1;padding:10px 12px;text-align:left}thead th{background:#e8f1fb;color:#1e3a5f}tbody th{background:#f0f7ff;font-weight:600;vertical-align:middle}.goods{background:#f8fbff}.num{text-align:right}.planned td{background:#f8fbff}.overdue td{background:#fff1f2}.nodate td{background:#fffbeb}.empty{text-align:center;color:#64748b}a{color:#2563eb;text-decoration:none}tbody tr:hover td{filter:brightness(.98)}</style></head><body><div class="report">${daily}${delivery}${status}${risk}</div><script>
+const buttons=document.querySelectorAll('[data-status-filter]');const tables={全部:document.getElementById('status-table-all'),已裁剪:document.getElementById('status-table-done'),待裁剪:document.getElementById('status-table-wait')};const count=document.getElementById('status-count');function filterStatus(value){Object.entries(tables).forEach(([name,table])=>{if(table)table.style.display=name===value?'table':'none'});if(count)count.textContent='显示 '+(tables[value]?tables[value].querySelectorAll('tbody tr').length:0)+' 条生产状态明细'}buttons.forEach(button=>button.addEventListener('click',()=>{buttons.forEach(item=>item.classList.toggle('active',item===button));filterStatus(button.dataset.statusFilter)}));filterStatus('全部');</script></body></html>`;
+}
+
+/**
+ * 生成生产日报 HTML。
+ * 数据流：当天入库单列表（缺失字段时逐单调详情补齐）→ 供应商×款号×客户聚合；
+ * 生产中/待生产生产单列表 → 计划出货分桶、裁床状态归类、未齐料筛选。
+ * 输出文件已存在时报错，不覆盖。
+ */
+async function generate(argv = {}) {
+  const throttle = createThrottle(REQUEST_INTERVAL_MS);
+  const day = parseDate(argv.date) || dateStr();
+  const config = readConfig() || {};
+  server = config.server || DEFAULT_SERVER;
+
+  const storeInRows = await fetchStoreInRows(day, throttle);
+  const aggregated = aggregateRows(await enrichRows(storeInRows, throttle));
+
+  const produceOrders = await fetchProduceOrders(throttle);
+  const normalized = normalizeProduceOrders(produceOrders);
+  const statusRows = aggregateProductionStatus(classifyProductionStatus(normalized));
+  const risks = materialRiskRows(normalized);
+
+  const document = render(aggregated, normalized, statusRows, risks, day);
+  const outDir = argv.out || process.cwd();
+  const filePath = path.resolve(outDir, `生产日报${timestamp()}.html`);
+  if (fs.existsSync(filePath)) {
+    throw new Error(`输出文件已存在：${filePath}`);
+  }
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, document, 'utf8');
+  return {
+    filePaths: [filePath],
+    summary: `生产日报已生成：入库汇总 ${aggregated.length} 条、生产单 ${normalized.length} 张、风险待料 ${risks.length} 单`,
+  };
+}
+
+module.exports = { generate };