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

package/reports/produceCost.js

@@ -0,0 +1,366 @@
+// 生产成本报表：一个工作表全部行，两级分组表头（款式信息/生产单信息/实际成本/预估成本）。
+// 实际成本组内在每类成本后面插入差异列：差异 =（实际 - 预估）/ 预估，
+// 用「正数红色带 +、负数绿色带 -」的数字格式显示；预估缺失或为 0 时无法计算，显示「-」。
+// 第三列嵌款式图，前两行冻结并加自动筛选，金额小数位读企业配置 materialDecimal。
+const fs = require('fs');
+const path = require('path');
+const { call } = require('../cli/api');
+const { timestamp, fetchAll } = require('./util');
+const { createWorkbook, saveWorkbook, embedImage } = require('./excel');
+const { downloadImages } = require('./image');
+
+const SHEET_NAME = '生产成本报表';
+// 生产类型文案（与 is-scm-front-pc 的 prodTypeList 一致）
+const TYPE_NAMES = { 1: '自主生产', 2: '单工序外发', 3: '委外加工（全工序外发）', 4: '成品采购' };
+// 计算规则文案与别名：CLI 或技能可能传中文名或数字
+const CAL_WAY_NAMES = { 1: '按默认逻辑计算', 2: '按成衣入库数计算', 3: '按裁床数计算' };
+const CAL_WAY_ALIASES = {
+  1: 1, 2: 2, 3: 3,
+  '默认': 1, '默认逻辑': 1, '按默认逻辑计算': 1,
+  '成衣入库数': 2, '按成衣入库数计算': 2,
+  '裁床数': 3, '按裁床数计算': 3,
+};
+// 金额小数位上下限：超出范围按默认 2 位处理（与原脚本一致）
+const DEFAULT_DECIMAL = 2;
+const MAX_DECIMAL = 6;
+// 差异百分比保留的小数位（与原脚本一致）
+const PERCENT_DECIMAL = 2;
+
+// 两级表头分组。列顺序与「生产成本报表」页面导出对齐，并在实际成本组内插入差异列。
+// percent 列的 actual/estimated 指向该差异的两个来源字段。
+const GROUPS = [
+  {
+    name: '款式信息',
+    columns: [
+      { header: '商品', field: 'goodsName', kind: 'text' },
+      { header: '款号', field: 'designSn', kind: 'text' },
+      { header: '图片', field: 'imgUrl', kind: 'image' },
+      { header: '大货号', field: 'goodsSn', kind: 'text' },
+      { header: '波段', field: 'rangesName', kind: 'text' },
+      { header: '设计师', field: 'designerName', kind: 'text' },
+      { header: '打版师', field: 'patternMakerName', kind: 'text' },
+    ],
+  },
+  {
+    name: '生产单信息',
+    columns: [
+      { header: '单号', field: 'ordersSnDisplay', kind: 'text' },
+      { header: '订单类型', field: 'orderTypeName', kind: 'text' },
+      { header: '标签', field: 'tags', kind: 'tags' },
+      { header: '生产类型', field: 'type', kind: 'type' },
+      { header: '预计交货日期', field: 'deliveryTime', kind: 'date' },
+      { header: '跟单员', field: 'followerName', kind: 'text' },
+      { header: '下单数', field: 'sumNumber', kind: 'number' },
+      { header: '裁床数', field: 'sumCutBedNumber', kind: 'number' },
+      { header: '已入库数', field: 'sumStoreInNumber', kind: 'number' },
+      { header: '未完成', field: 'sumNoFinishNumber', kind: 'number' },
+      { header: '未出数', field: 'sumNoOutNumber', kind: 'number' },
+      { header: '未入库数', field: 'sumNoStoreInNumber', kind: 'number' },
+      { header: '业务日期', field: 'businessTime', kind: 'date' },
+    ],
+  },
+  {
+    name: '实际成本',
+    columns: [
+      { header: '物料', field: 'actualMaterialCost', kind: 'money' },
+      { header: '物料差异', kind: 'percent', actual: 'actualMaterialCost', estimated: 'estimatedMaterialCost' },
+      { header: '委外加工', field: 'actualProduceOrderProcessCost', kind: 'money' },
+      { header: '委外加工差异', kind: 'percent', actual: 'actualProduceOrderProcessCost', estimated: 'estimatedProduceOrderProcessCost' },
+      { header: '工序外发', field: 'actualOutWardOrderCost', kind: 'money' },
+      { header: '工序外发差异', kind: 'percent', actual: 'actualOutWardOrderCost', estimated: 'estimatedOutWardOrderCost' },
+      { header: '工人计件', field: 'actualWorkManPieceworkCost', kind: 'money' },
+      { header: '工人计件差异', kind: 'percent', actual: 'actualWorkManPieceworkCost', estimated: 'estimatedWorkManPieceworkCost' },
+      { header: '其它费用', field: 'actualOtherCost', kind: 'money' },
+      { header: '其它费用差异', kind: 'percent', actual: 'actualOtherCost', estimated: 'estimatedOtherCost' },
+      { header: '单件成本', field: 'actualSumSingleGoodsCost', kind: 'money' },
+      { header: '单件成本差异', kind: 'percent', actual: 'actualSumSingleGoodsCost', estimated: 'estimatedSumSingleGoodsCost' },
+      { header: '件数', field: 'actualNumber', kind: 'number' },
+      { header: '总成本', field: 'actualSumCost', kind: 'money' },
+    ],
+  },
+  {
+    name: '预估成本',
+    columns: [
+      { header: '物料', field: 'estimatedMaterialCost', kind: 'money' },
+      { header: '委外加工', field: 'estimatedProduceOrderProcessCost', kind: 'money' },
+      { header: '工序外发', field: 'estimatedOutWardOrderCost', kind: 'money' },
+      { header: '工人计件', field: 'estimatedWorkManPieceworkCost', kind: 'money' },
+      { header: '其它费用', field: 'estimatedOtherCost', kind: 'money' },
+      { header: '单件成本', field: 'estimatedSumSingleGoodsCost', kind: 'money' },
+      { header: '件数', field: 'estimatedNumber', kind: 'number' },
+      { header: '总成本', field: 'estimatedSumCost', kind: 'money' },
+    ],
+  },
+];
+const COLUMNS = GROUPS.flatMap((group) => group.columns);
+
+const BORDER = {
+  top: { style: 'thin', color: { argb: 'FFCCCCCC' } },
+  left: { style: 'thin', color: { argb: 'FFCCCCCC' } },
+  bottom: { style: 'thin', color: { argb: 'FFCCCCCC' } },
+  right: { style: 'thin', color: { argb: 'FFCCCCCC' } },
+};
+// 两级表头底色：灰色（与原脚本一致）
+const HEADER_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFC0C0C0' } };
+// 图片单元格底色：浅蓝（与原脚本一致）
+const IMAGE_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE8F1FB' } };
+
+/** 文本归一化：空值返回空字符串 */
+function text(value) {
+  return value == null ? '' : String(value).trim();
+}
+
+/**
+ * 数值列取值：无法转数字时按原文返回；整数去掉小数尾巴。
+ * 与原脚本 number() 的行为一致（金额、件数都以数字写入单元格）。
+ */
+function numeric(value) {
+  if (value === null || value === undefined || value === '') {
+    return '';
+  }
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) {
+    return text(value);
+  }
+  return parsed;
+}
+
+/**
+ * 四舍五入（远离零）保留 places 位小数。原脚本用 Decimal 的 ROUND_HALF_UP，
+ * 这里按正负号分别处理，避免 JavaScript 的 Math.round 对负数向正无穷方向舍入。
+ */
+function roundHalfUp(value, places) {
+  const factor = 10 ** places;
+  const magnitude = Math.abs(value) * factor;
+  const rounded = Math.round(magnitude + Number.EPSILON * magnitude);
+  const result = (value < 0 ? -rounded : rounded) / factor;
+  return Object.is(result, -0) ? 0 : result;
+}
+
+/**
+ * 差异比例 =（实际 - 预估）/ 预估，保留两位小数。
+ * 预估缺失或为 0 时无法计算，返回「-」；舍入到 0 时按 0 处理，避免显示成 -0%。
+ */
+function diffRatio(actual, estimated) {
+  const left = Number(actual);
+  const right = Number(estimated);
+  if (!Number.isFinite(left) || !Number.isFinite(right) || right === 0) {
+    return '-';
+  }
+  return roundHalfUp((left - right) / right, PERCENT_DECIMAL);
+}
+
+/** 日期列容错：接口返回 yyyy-MM-dd 字符串，取前 10 位；异常原文返回 */
+function dateText(value) {
+  const raw = text(value);
+  if (!raw) {
+    return '';
+  }
+  const match = /^(\d{4}-\d{2}-\d{2})/.exec(raw);
+  return match ? match[1] : raw;
+}
+
+/** 金额数字格式：按企业配置的小数位生成，例如 ¥#,##0.00;-¥#,##0.00 */
+function moneyFormat(decimal) {
+  const pattern = decimal > 0 ? `#,##0.${'0'.repeat(decimal)}` : '#,##0';
+  return `¥${pattern};-¥${pattern}`;
+}
+
+/**
+ * 计算一个单元格的显示值（图片列留空，图片单独嵌入）。
+ * percent 列的差异按该列的 actual/estimated 字段现算。
+ */
+function cellValue(row, column) {
+  const value = row[column.field];
+  switch (column.kind) {
+    case 'type':
+      return TYPE_NAMES[value] || text(value);
+    case 'tags':
+      return Array.isArray(value) ? value.map(text).filter(Boolean).join('、') : '';
+    case 'date':
+      return dateText(value);
+    case 'number':
+    case 'money':
+      return numeric(value);
+    case 'percent':
+      return diffRatio(row[column.actual], row[column.estimated]);
+    case 'image':
+      return '';
+    default:
+      return text(value);
+  }
+}
+
+/** 单号显示：开启生产批次号且批次号非空时优先显示批次号（与页面 getProduceOrdersSn 一致） */
+function ordersSnDisplay(row, useBatchSn) {
+  const batch = text(row.produceBatchSn);
+  return useBatchSn && batch ? batch : text(row.ordersSn);
+}
+
+/** 列宽：图片 10、金额 13、数量/差异 12、日期 13、文本按标题长度（与原脚本一致） */
+function columnWidth(column) {
+  if (column.kind === 'image') {
+    return 10;
+  }
+  if (column.kind === 'money') {
+    return 13;
+  }
+  if (column.kind === 'number' || column.kind === 'percent') {
+    return 12;
+  }
+  if (column.kind === 'date') {
+    return 13;
+  }
+  return Math.max(12, Math.min(24, column.header.length * 3 + 4));
+}
+
+/**
+ * 生成生产成本报表 Excel。
+ * argv.from/to：业务日期区间 yyyy-MM-dd（不传则不限日期）；
+ * argv.state：逗号分隔的状态值，默认 4,2,3；argv.calWay：1/2/3 或中文别名，默认按默认逻辑；
+ * argv.searchKey/ordersSn：搜索条件；argv.out：输出目录。
+ */
+async function generate(argv = {}) {
+  const states = String(argv.state || '4,2,3')
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean);
+  const calWay = CAL_WAY_ALIASES[argv.calWay == null ? 1 : argv.calWay];
+  if (!calWay) {
+    throw new Error('计算规则仅支持：默认逻辑、成衣入库数、裁床数（或 1/2/3）');
+  }
+
+  const outDir = argv.out || process.cwd();
+  const filePath = path.resolve(outDir, `生产成本报表${timestamp()}.xlsx`);
+  if (fs.existsSync(filePath)) {
+    throw new Error(`输出文件已存在：${filePath}；如需替换请先删除旧文件或更换输出目录`);
+  }
+
+  // 企业配置：materialDecimal 决定金额小数位，produceBatchSnEnable 决定单号显示；
+  // 读取失败时按默认处理，不中断导出（与原脚本一致）
+  let decimal = DEFAULT_DECIMAL;
+  let useBatchSn = false;
+  try {
+    const config = await call('GET', '/api/agent/v1/company-config');
+    const configured = Number(config && config.materialDecimal);
+    if (Number.isInteger(configured) && configured >= 0 && configured <= MAX_DECIMAL) {
+      decimal = configured;
+    }
+    useBatchSn = config && config.produceBatchSnEnable === true;
+  } catch (e) {
+    // 配置接口失败不影响导出
+  }
+
+  const searchSn = argv.sn || argv.ordersSn;
+  const { list: rawRows } = await fetchAll(
+    (page, limit) => call('GET', '/api/agent/v1/report/produce-cost', {
+      from: argv.from,
+      to: argv.to,
+      state: states.join(','),
+      calWay,
+      searchKey: argv.searchKey,
+      ordersSn: searchSn,
+      page,
+      limit,
+    })
+  );
+  // 接口的单号查询是模糊匹配，这里再按单号/批次号精确过滤一次（与原脚本一致）
+  const rows = searchSn
+    ? rawRows.filter((row) => text(row.ordersSn) === searchSn || text(row.produceBatchSn) === searchSn)
+    : rawRows;
+  if (!rows.length) {
+    throw new Error('没有符合条件的生产成本报表数据');
+  }
+
+  // 批量下载款式图；下载失败的地址不在 Map 里，对应单元格留空
+  const imageUrls = rows.map((row) => text(row.imgUrl));
+  const images = await downloadImages(imageUrls);
+
+  const workbook = createWorkbook();
+  const sheet = workbook.addWorksheet(SHEET_NAME, {
+    views: [{ state: 'frozen', ySplit: 2 }],
+    pageSetup: { orientation: 'landscape', fitToPage: true, fitToWidth: 1, fitToHeight: 0 },
+  });
+
+  // 第 1 行：分组名（写在每组第一列，整组合并）；第 2 行：列标题
+  const topRow = [];
+  for (const group of GROUPS) {
+    group.columns.forEach((column, index) => {
+      topRow.push(index === 0 ? group.name : '');
+    });
+  }
+  const groupRow = sheet.addRow(topRow);
+  groupRow.height = 26;
+  const titleRow = sheet.addRow(COLUMNS.map((column) => column.header));
+  titleRow.height = 30;
+  for (const row of [groupRow, titleRow]) {
+    row.eachCell((cell) => {
+      cell.font = { bold: true };
+      cell.fill = HEADER_FILL;
+      cell.border = BORDER;
+      cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
+    });
+  }
+  // 每组列数大于 1 时合并第 1 行的组名单元格
+  let columnIndex = 1;
+  for (const group of GROUPS) {
+    if (group.columns.length > 1) {
+      sheet.mergeCells(1, columnIndex, 1, columnIndex + group.columns.length - 1);
+    }
+    columnIndex += group.columns.length;
+  }
+
+  // 差异列的数字格式：正数红色带 +，负数绿色带 -，0 不着色也不加符号。
+  // 颜色名必须用英文 [Red]/[Green]，写中文 Excel 会拒绝打开整个文件。
+  const percentFormat = '[Red]+0.0#%;[Green]-0.0#%;0.0#%';
+  const moneyFmt = moneyFormat(decimal);
+  const imageCol = COLUMNS.findIndex((column) => column.kind === 'image') + 1;
+
+  rows.forEach((source, index) => {
+    const row = { ...source, ordersSnDisplay: ordersSnDisplay(source, useBatchSn) };
+    const values = COLUMNS.map((column) => cellValue(row, column));
+    const added = sheet.addRow(values);
+    added.height = 46;
+    added.eachCell((cell, colNumber) => {
+      const kind = COLUMNS[colNumber - 1].kind;
+      cell.border = BORDER;
+      cell.alignment = {
+        vertical: 'middle',
+        horizontal: kind === 'text' || kind === 'tags' || kind === 'type' || kind === 'date' ? 'left' : kind === 'image' ? 'center' : 'right',
+        wrapText: kind !== 'number' && kind !== 'money' && kind !== 'percent',
+      };
+      if (kind === 'money') {
+        cell.numFmt = moneyFmt;
+      }
+      if (kind === 'percent' && cell.value !== '-') {
+        cell.numFmt = percentFormat;
+      }
+      if (kind === 'image') {
+        cell.fill = IMAGE_FILL;
+      }
+    });
+    const url = imageUrls[index];
+    if (url && images.has(url)) {
+      embedImage(workbook, sheet, images.get(url), index + 3, imageCol, { width: 60, height: 60 });
+    }
+  });
+
+  COLUMNS.forEach((column, i) => {
+    sheet.getColumn(i + 1).width = columnWidth(column);
+  });
+  const lastColLetter = sheet.getColumn(COLUMNS.length).letter;
+  const lastRow = rows.length + 2;
+  sheet.autoFilter = `A2:${lastColLetter}${lastRow}`;
+
+  await saveWorkbook(workbook, filePath);
+
+  const skipped = imageUrls.filter((url) => url && !images.has(url)).length;
+  return {
+    filePaths: [filePath],
+    summary: `生产成本报表已生成：${rows.length} 行 × ${COLUMNS.length} 列，计算规则「${CAL_WAY_NAMES[calWay]}」，` +
+      `金额 ${decimal} 位小数，单号显示${useBatchSn ? '生产批次号优先' : '生产单号'}，嵌款式图 ${images.size} 张` +
+      (skipped ? `（${skipped} 张下载失败已跳过）` : ''),
+  };
+}
+
+module.exports = { generate };