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

package/reports/storeInGoods.js

@@ -0,0 +1,276 @@
+// 成品入库报表：列与「报表分析-成品入库报表」页面导出一致，单品图列嵌商品主图。
+// 关联生产单按企业配置决定显示生产批次号还是生产单号。
+const fs = require('fs');
+const path = require('path');
+const { call } = require('../cli/api');
+const { dateStr, shiftDate, timestamp, fetchAll } = require('./util');
+const { createWorkbook, saveWorkbook, embedImage } = require('./excel');
+const { downloadImages } = require('./image');
+
+// 业务类型文案（与页面的 businessItemMap 一致）
+const BUSINESS_ITEM_NAMES = { 1: '生产入库', 2: '调拨入库', 3: '次品返厂入库', 76: '出库退货' };
+// 生产类型文案（与页面的 prodTypeList 一致）
+const PRODUCE_TYPE_NAMES = { 1: '自主生产', 2: '单工序外发', 3: '委外加工（全工序外发）', 4: '成品采购' };
+// 结算方式文案（与页面的 settlementMethodOptions 一致）
+const SETTLEMENT_NAMES = { 1: '现结', 2: '日结', 3: '周结', 4: '半月结', 5: '月结', 6: '季结', 7: '年结', 8: '单结', 9: '其他' };
+// 金额格式：人民币两位小数
+const MONEY_FORMAT = '¥#,##0.00;-¥#,##0.00';
+
+// 列定义：标题、取值字段、类型。列顺序与页面「导出」按钮的可见列顺序一致
+const COLUMNS = [
+  { header: '业务类型', field: 'businessItem', kind: 'businessItem' },
+  { header: '单号', field: 'ordersSn', kind: 'text' },
+  { header: '关联业务单号', field: 'businessSn', kind: 'text' },
+  { header: '生产单', field: 'produceOrders', kind: 'produceSn' },
+  { header: '床次', field: 'bedNumbers', kind: 'beds' },
+  { header: '生产类型', field: 'produceOrders', kind: 'produceType' },
+  { header: '订单类型', field: 'produceOrders', kind: 'produceJoin', joinField: 'orderTypeName' },
+  { header: '客户', field: 'produceOrders', kind: 'produceJoin', joinField: 'clientName' },
+  { header: '单品图', field: 'imgUrl', kind: 'image' },
+  { header: '商品名称', field: 'goodsName', kind: 'text' },
+  { header: '商品货号', field: 'goodsSn', kind: 'text' },
+  { header: '一级分类', field: 'firstGoodsCategoryName', kind: 'text' },
+  { header: '颜色', field: 'skuColorName', kind: 'text' },
+  { header: '尺码', field: 'skuSizeName', kind: 'text' },
+  { header: '入库数', field: 'number', kind: 'number' },
+  { header: '入库仓库', field: 'storehouseName', kind: 'text' },
+  { header: '结算方式', field: 'settlementMethod', kind: 'settlement' },
+  { header: '备注', field: 'remark', kind: 'text' },
+  { header: '委外加工费/采购单价', field: 'producePrice', kind: 'money' },
+  { header: '加工厂/供应商', field: 'supplierName', kind: 'supplier' },
+  { header: '生产组', field: 'productionGroupName', kind: 'text' },
+  { header: '金额', field: 'amount', kind: 'money' },
+  { header: '结算账户', field: 'accountName', kind: 'text' },
+  { header: '入库业务日期', field: 'businessTime', kind: 'date' },
+  { header: '创建日期', field: 'createTime', kind: 'date' },
+  { header: '创建人', field: 'handlerName', kind: 'text' },
+];
+
+const BORDER = {
+  top: { style: 'thin', color: { argb: 'FF000000' } },
+  left: { style: 'thin', color: { argb: 'FF000000' } },
+  bottom: { style: 'thin', color: { argb: 'FF000000' } },
+  right: { style: 'thin', color: { argb: 'FF000000' } },
+};
+// 表头底色：浅灰，与原脚本一致
+const HEADER_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFC0C0C0' } };
+// 单品图单元格底色：浅蓝，与原脚本一致
+const IMAGE_FILL = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE8F1FB' } };
+
+/** 数值列的空值兜底为 0（与原脚本的 number() 一致） */
+function number(value) {
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+
+/** 文本归一化：空值返回空字符串 */
+function text(value) {
+  return value == null ? '' : String(value).trim();
+}
+
+/** 从关联生产单列表取同名字段，用「、」连接；列表为空返回空字符串 */
+function joinProduceField(orders, field) {
+  if (!Array.isArray(orders)) {
+    return '';
+  }
+  return orders
+    .map((order) => text(order[field]))
+    .filter(Boolean)
+    .join('、');
+}
+
+/**
+ * 生产单列：开启生产批次号时优先显示批次号，否则显示生产单号（与页面一致）。
+ */
+function produceSnText(orders, useBatchSn) {
+  if (!Array.isArray(orders)) {
+    return '';
+  }
+  const parts = [];
+  for (const order of orders) {
+    const batch = text(order.produceBatchSn);
+    const sn = useBatchSn && batch ? batch : text(order.ordersSn);
+    if (sn) {
+      parts.push(sn);
+    }
+  }
+  return parts.join('、');
+}
+
+/** 计算一行的单元格显示值（单品图列留空，图片单独嵌入） */
+function cellValue(row, column, useBatchSn) {
+  const value = row[column.field];
+  switch (column.kind) {
+    case 'businessItem':
+      return BUSINESS_ITEM_NAMES[value] || text(value);
+    case 'settlement':
+      // 结算方式未知时显示空，与页面下拉的取值范围一致
+      return SETTLEMENT_NAMES[value] || '';
+    case 'date':
+      return text(value);
+    case 'number':
+    case 'money':
+      return number(value);
+    case 'image':
+      return '';
+    case 'produceSn':
+      return produceSnText(value, useBatchSn);
+    case 'beds': {
+      // 床次为空时显示「-」，与页面导出的格式化一致
+      const parts = Array.isArray(value) ? value.map(text).filter(Boolean) : [];
+      return parts.join('、') || '-';
+    }
+    case 'produceType':
+      // 生产类型是枚举值，逐项翻译成文案
+      if (!Array.isArray(value)) {
+        return '';
+      }
+      return value
+        .map((order) => PRODUCE_TYPE_NAMES[order.type] || text(order.type))
+        .filter(Boolean)
+        .join('、');
+    case 'produceJoin':
+      return joinProduceField(value, column.joinField);
+    case 'supplier':
+      // 有生产单时取生产单上的供应商，否则取单据自带的供应商
+      return joinProduceField(value, 'supplierName') || text(row.supplierName);
+    default:
+      return text(value);
+  }
+}
+
+/** 按列类型计算列宽（与原脚本的宽度规则一致） */
+function columnWidth(column) {
+  if (column.kind === 'image') {
+    return 10;
+  }
+  if (column.kind === 'money') {
+    return 15;
+  }
+  if (column.kind === 'number') {
+    return 10;
+  }
+  if (column.kind === 'date') {
+    return 13;
+  }
+  return Math.max(12, Math.min(24, column.header.length * 3 + 4));
+}
+
+/**
+ * 生成成品入库报表 Excel。
+ * argv.from/to：业务日期区间，默认结束日今天、起始日往前 30 个日历日；
+ * argv.sn：单号关键词（对应页面搜索单号/商品名称/商品货号）；argv.out：输出目录。
+ */
+async function generate(argv = {}) {
+  const to = argv.to || dateStr();
+  const from = argv.from || shiftDate(-29, new Date(`${to}T00:00:00`));
+  if (from > to) {
+    throw new Error('起始日期不能晚于结束日期');
+  }
+
+  const outDir = argv.out || process.cwd();
+  const filePath = path.resolve(outDir, `成品入库报表${timestamp()}.xlsx`);
+  if (fs.existsSync(filePath)) {
+    throw new Error(`输出文件已存在：${filePath}；如需替换请先删除旧文件或更换输出目录`);
+  }
+
+  // 企业配置：produceBatchSnEnable 决定生产单列显示批次号还是生产单号；读取失败按未开启处理
+  let useBatchSn = false;
+  try {
+    const config = await call('GET', '/api/agent/v1/company-config');
+    useBatchSn = config && config.produceBatchSnEnable === true;
+  } catch (e) {
+    // 配置接口失败不中断导出，与原脚本一致
+  }
+
+  const { list: rows } = await fetchAll(
+    (page, limit) => call('GET', '/api/agent/v1/statistics/store-in-goods', {
+      from,
+      to,
+      searchKey: argv.sn,
+      storehouseId: argv.storehouse,
+      page,
+      limit,
+    })
+  );
+  if (!rows.length) {
+    throw new Error('没有符合条件的成品入库报表数据');
+  }
+
+  // 批量下载单品图；下载失败的地址不在 Map 里，对应单元格留空
+  const imageUrlByRow = rows.map((row) => text(row.imgUrl));
+  const images = await downloadImages(imageUrlByRow);
+
+  const workbook = createWorkbook();
+  const sheet = workbook.addWorksheet('成品入库报表', {
+    views: [{ state: 'frozen', ySplit: 2 }],
+    pageSetup: { orientation: 'landscape', fitToPage: true, fitToWidth: 1, fitToHeight: 0 },
+  });
+
+  // 第 1 行：表标题，整行合并
+  const titleRow = sheet.addRow(['成品入库报表']);
+  titleRow.height = 26;
+  titleRow.getCell(1).font = { bold: true };
+  titleRow.getCell(1).fill = HEADER_FILL;
+  titleRow.getCell(1).alignment = { vertical: 'middle', horizontal: 'center' };
+
+  // 第 2 行：表头
+  const headerRow = sheet.addRow(COLUMNS.map((column) => column.header));
+  headerRow.height = 30;
+  headerRow.eachCell((cell) => {
+    cell.font = { bold: true };
+    cell.fill = HEADER_FILL;
+    cell.border = BORDER;
+    cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
+  });
+
+  // 数据行：单品图行高 46，图片以 60x60 嵌入图片列
+  const imageCol = COLUMNS.findIndex((column) => column.kind === 'image') + 1;
+  // 左对齐的列类型：文本类、日期类与两个枚举翻译列（与原脚本文本样式一致）；
+  // 数值与金额右对齐，图片列居中
+  const LEFT_KINDS = new Set(['text', 'date', 'businessItem', 'settlement', 'produceSn', 'beds', 'produceType', 'produceJoin', 'supplier']);
+  rows.forEach((row, index) => {
+    const values = COLUMNS.map((column) => cellValue(row, column, useBatchSn));
+    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: LEFT_KINDS.has(kind) ? 'left' : kind === 'image' ? 'center' : 'right',
+        wrapText: kind !== 'number' && kind !== 'money',
+      };
+      if (kind === 'money') {
+        cell.numFmt = MONEY_FORMAT;
+      }
+      if (kind === 'image') {
+        cell.fill = IMAGE_FILL;
+      }
+    });
+    const url = imageUrlByRow[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;
+  sheet.mergeCells(1, 1, 1, COLUMNS.length);
+  // 表头行加筛选，与页面导出一致
+  sheet.autoFilter = `A2:${lastColLetter}${rows.length + 2}`;
+
+  await saveWorkbook(workbook, filePath);
+
+  const skipped = imageUrlByRow.filter((url) => url && !images.has(url)).length;
+  return {
+    filePaths: [filePath],
+    summary: `成品入库报表已生成：业务日期 ${from} ~ ${to} 共 ${rows.length} 行、${COLUMNS.length} 列，` +
+      `生产单显示${useBatchSn ? '生产批次号优先' : '生产单号'}，嵌单品图 ${images.size} 张` +
+      (skipped ? `（${skipped} 张下载失败已跳过）` : ''),
+  };
+}
+
+module.exports = { generate };