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

package/reports/materialPurchaseExport.js

@@ -0,0 +1,393 @@
+// 物料采购导出：以物料采购页面的导出口径生成 Excel。
+// 两级表头：单据级列纵向合并两行，中间 10 列合并为「采购物料明细」组；
+// 同一采购单展开成多个明细行后，单据级列做纵向合并。明细列嵌物料图。
+// 默认导出近三个月业务日期、五种进行中状态的数据（不传状态时接口默认同此口径）。
+const fs = require('fs');
+const path = require('path');
+const { call } = require('../cli/api');
+const { dateStr, timestamp, fetchAll } = require('./util');
+const { createWorkbook, saveWorkbook, embedImage } = require('./excel');
+const { downloadImages } = require('./image');
+
+const SHEET_NAME = '物料采购';
+// 单据状态与发货状态文案（与页面一致）
+const STATE_NAMES = { 1: '草稿', 2: '待入库', 3: '部分入库', 4: '全部入库', 9: '已撤销', 10: '待审核', 12: '审核拒绝' };
+const DELIVERY_NAMES = { 2: '待发货', 3: '部分发货', 4: '已发货' };
+// Excel 单工作表行数上限（留两行表头）
+const MAX_EXCEL_ROWS = 1048574;
+
+// 单据级列（第一段 + 第三段，取值函数 getValue(row)）
+const PARENT_COLUMNS = [
+  { header: '单据状态', field: 'stateText' },
+  { header: '发货状态', field: 'orderDeliveryStateText' },
+  { header: '采购单号', field: 'ordersSn' },
+  { header: '关联生产单', field: 'produceOrdersSns', width: 28 },
+  { header: '床次', field: 'bedNumbersText' },
+  { header: '供应商', field: 'supplierName', width: 20 },
+  { header: '标签', field: 'tagsText', width: 20 },
+  { header: '采购数', field: 'purchaseUnitNumber' },
+];
+// 物料明细列（第二段；detailField 标记取值来自明细行）
+const DETAIL_COLUMNS = [
+  { header: '图片', field: 'materialImgUrl', kind: 'image' },
+  { header: '物料名称', field: 'materialName', width: 18 },
+  { header: '物料货号', field: 'materialSn', width: 18 },
+  { header: '颜色', field: 'colorName' },
+  { header: '规格', field: 'specText', width: 18 },
+  { header: '色号', field: 'materialSkuSupplierColor', width: 14 },
+  { header: '幅宽', field: 'fabricWidth' },
+  { header: '采购数', field: 'purchaseUnitNumber' },
+  { header: '采购单价', field: 'purchasePrice' },
+  { header: '采购金额', field: 'purchaseUnitAmount' },
+];
+const TAIL_COLUMNS = [
+  { header: '预计入库数', field: 'purchaseNumber' },
+  { header: '基础发货', field: 'deliverNumber' },
+  { header: '采购待入库', field: 'purchaseStoreWinNumber' },
+  { header: '采购已入库', field: 'purchaseStoreInNumber' },
+  { header: '采购放弃入库', field: 'purchaseTerminateInNumber', width: 16 },
+  { header: '基础待入库', field: 'storeWinNumber' },
+  { header: '基础已入库', field: 'storeInNumber' },
+  { header: '基础放弃入库', field: 'terminateInNumber', width: 16 },
+  { header: '采购金额', field: 'amountText' },
+  { header: '抹零金额', field: 'totalWipeZeroText' },
+  { header: '合计金额', field: 'trueAmountText' },
+  { header: '已付金额', field: 'paymentText' },
+  { header: '客户', field: 'clientNameText', width: 18 },
+  { header: '供应商单号', field: 'supplierSn', width: 18 },
+  { header: '预计到料', field: 'expectTime' },
+  { header: '实际入库', field: 'purchaseStoreInTimesText', width: 24 },
+  { header: '业务时间', field: 'businessTimeText', width: 18 },
+  { header: '创建人', field: 'handlerName' },
+  { header: '创建时间', field: 'createTime', width: 18 },
+  { header: '更新人', field: 'lastHandlerName' },
+  { header: '更新时间', field: 'updateTime', width: 18 },
+];
+const COLUMNS = [...PARENT_COLUMNS, ...DETAIL_COLUMNS, ...TAIL_COLUMNS];
+const DETAIL_FIELDS = new Set(DETAIL_COLUMNS.map((column) => column.field));
+// 左对齐的长文本列（与原脚本一致）
+const LEFT_FIELDS = new Set(['ordersSn', 'produceOrdersSns', 'supplierName', 'tagsText', 'clientNameText']);
+
+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: 'FFD9EAF7' } };
+
+/** 文本归一化：空值返回空字符串 */
+function text(value) {
+  return value == null ? '' : String(value).trim();
+}
+
+/** 数量取值：无法转数字按原文返回 */
+function numeric(value) {
+  if (value === null || value === undefined || value === '') {
+    return '';
+  }
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : text(value);
+}
+
+/** 金额两位小数四舍五入；缺失返回空 */
+function money(value) {
+  if (value === null || value === undefined || value === '') {
+    return '';
+  }
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) {
+    return '';
+  }
+  const factor = 100;
+  const magnitude = Math.abs(parsed) * factor;
+  const rounded = Math.round(magnitude + Number.EPSILON * magnitude);
+  return (parsed < 0 ? -rounded : rounded) / factor;
+}
+
+/**
+ * 今天往前推 months 个自然月的同号日期；目标月没有该号时取月末
+ * （与原脚本 months_ago 一致）。
+ */
+function monthsAgo(base, months) {
+  const year = base.getFullYear();
+  const month = base.getMonth();
+  const day = base.getDate();
+  let targetYear = year;
+  let targetMonth = month - months;
+  while (targetMonth < 0) {
+    targetMonth += 12;
+    targetYear -= 1;
+  }
+  const lastDay = new Date(targetYear, targetMonth + 1, 0).getDate();
+  return new Date(targetYear, targetMonth, Math.min(day, lastDay));
+}
+
+/** 规格文本：属性值用 - 连接（与页面 specFormatter 一致） */
+function specText(value) {
+  if (!Array.isArray(value) || !value.length) {
+    return '';
+  }
+  return value.map((item) => text(item.propertyValue)).join('-');
+}
+
+/** 关联生产单文本：每项「单号或批次号（商品货号）」用 、连接 */
+function produceOrdersSnsText(relations) {
+  if (!Array.isArray(relations)) {
+    return '';
+  }
+  return relations
+    .map((relation) => {
+      const sn = text(relation.produceOrdersSn) || text(relation.produceBatchSn);
+      const goodsSn = text(relation.goodsSn);
+      return sn && goodsSn ? `${sn}（${goodsSn}）` : sn;
+    })
+    .filter(Boolean)
+    .join('、');
+}
+
+/**
+ * 把一条采购单记录加工成单据级展示字段（金额量化、状态翻译、列表拼接）。
+ */
+function decorate(record) {
+  const relations = Array.isArray(record.produceRelations) ? record.produceRelations : [];
+  return {
+    stateText: STATE_NAMES[record.state] || text(record.state),
+    orderDeliveryStateText: DELIVERY_NAMES[record.orderDeliveryState] || text(record.orderDeliveryState),
+    ordersSn: text(record.ordersSn),
+    produceOrdersSns: produceOrdersSnsText(relations),
+    bedNumbersText: Array.isArray(record.bedNumbers) && record.bedNumbers.length
+      ? record.bedNumbers.map(text).filter(Boolean).join('、') || '-'
+      : '-',
+    supplierName: text(record.supplierName),
+    tagsText: Array.isArray(record.tags) ? record.tags.map(text).filter(Boolean).join('、') : '',
+    purchaseUnitNumber: numeric(record.purchaseUnitNumber),
+    purchaseNumber: numeric(record.purchaseNumber),
+    deliverNumber: numeric(record.deliverNumber),
+    purchaseStoreWinNumber: numeric(record.purchaseStoreWinNumber),
+    purchaseStoreInNumber: numeric(record.purchaseStoreInNumber),
+    purchaseTerminateInNumber: numeric(record.purchaseTerminateInNumber),
+    storeWinNumber: numeric(record.storeWinNumber),
+    storeInNumber: numeric(record.storeInNumber),
+    terminateInNumber: numeric(record.terminateInNumber),
+    amountText: money(record.amount),
+    totalWipeZeroText: money(record.totalWipeZero),
+    // 合计金额 = 采购金额 - 抹零金额，下限 0
+    trueAmountText: (() => {
+      const amount = Number(record.amount);
+      const wipe = Number(record.totalWipeZero);
+      if (!Number.isFinite(amount) && !Number.isFinite(wipe)) {
+        return '';
+      }
+      return money(Math.max((Number.isFinite(amount) ? amount : 0) - (Number.isFinite(wipe) ? wipe : 0), 0));
+    })(),
+    paymentText: money(record.payment),
+    clientNameText: relations.length
+      ? relations.map((relation) => text(relation.produceOrderClientName)).filter(Boolean).join('、') || '-'
+      : '-',
+    supplierSn: text(record.supplierSn),
+    expectTime: text(record.expectTime),
+    purchaseStoreInTimesText: Array.isArray(record.purchaseStoreInTimes) && record.purchaseStoreInTimes.length
+      ? record.purchaseStoreInTimes.map(text).filter(Boolean).join('、') || '-'
+      : '-',
+    businessTimeText: text(record.businessTimeText),
+    handlerName: text(record.handlerName),
+    createTime: text(record.createTime),
+    lastHandlerName: text(record.lastHandlerName),
+    updateTime: text(record.updateTime),
+  };
+}
+
+/**
+ * 把采购单列表展开成报表行：有物料明细时每个明细一行，没有时单据一行。
+ * 明细行的单据级字段与单据行相同。
+ */
+function flatten(records) {
+  const rows = [];
+  for (const record of records) {
+    const parent = decorate(record);
+    const details = Array.isArray(record.details) ? record.details : [];
+    if (!details.length) {
+      rows.push({ parent, detail: null, hasImage: false, ordersSn: parent.ordersSn });
+      continue;
+    }
+    for (const detail of details) {
+      const hasFabricWidth = Boolean(detail) && detail.fabricWidth != null && detail.fabricWidth !== '';
+      const fabricWidth = hasFabricWidth ? numeric(detail.fabricWidth) : '';
+      rows.push({
+        parent,
+        detail,
+        hasImage: Boolean(text(detail && detail.materialImgUrl)),
+        ordersSn: parent.ordersSn,
+        fabricWidth,
+      });
+    }
+  }
+  if (rows.length > MAX_EXCEL_ROWS) {
+    throw new Error(`展开后 ${rows.length} 行超过 Excel 单工作表上限，请缩小筛选范围`);
+  }
+  return rows;
+}
+
+/** 明细列取值：色号只在有幅宽时显示（与原脚本一致） */
+function detailValue(row, column) {
+  const detail = row.detail || {};
+  switch (column.field) {
+    case 'materialImgUrl':
+      return '';
+    case 'specText':
+      return specText(detail.skuPropertyList);
+    case 'materialSkuSupplierColor':
+      return row.fabricWidth === '' ? '' : text(detail.materialSkuSupplierColor);
+    case 'fabricWidth':
+      return row.fabricWidth;
+    case 'purchaseUnitNumber':
+    case 'purchasePrice':
+    case 'purchaseUnitAmount':
+      return column.field === 'purchaseUnitNumber' ? numeric(detail.purchaseUnitNumber) : money(detail[column.field]);
+    default:
+      return text(detail[column.field]);
+  }
+}
+
+/** 一行的单元格值：明细列取明细行，其余取单据级字段 */
+function cellValue(row, column) {
+  return DETAIL_FIELDS.has(column.field) && row.detail
+    ? detailValue(row, column)
+    : row.parent[column.field] != null ? row.parent[column.field] : '';
+}
+
+/**
+ * 生成物料采购导出 Excel。
+ * argv.from/to：业务日期区间，默认结束日今天、起始日往前三个自然月；
+ * argv.state：单据状态值（不传则接口默认查五种进行中状态）；argv.searchKey：关键词；argv.out：输出目录。
+ */
+async function generate(argv = {}) {
+  const today = new Date();
+  const to = argv.to || dateStr(today);
+  const from = argv.from || dateStr(monthsAgo(today, 3));
+  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}；如需替换请先删除旧文件或更换输出目录`);
+  }
+
+  const { list: records } = await fetchAll(
+    (page, limit) => call('GET', '/api/agent/v1/material-purchase/list', {
+      searchKey: argv.searchKey || argv.sn,
+      state: argv.state,
+      from,
+      to,
+      page,
+      limit,
+    })
+  );
+  if (!records.length) {
+    throw new Error('没有符合条件的物料采购数据');
+  }
+
+  const rows = flatten(records);
+
+  // 批量下载物料图；下载失败的地址对应单元格留空
+  const imageUrls = rows.map((row) => (row.detail ? text(row.detail.materialImgUrl) : ''));
+  const images = await downloadImages(imageUrls);
+
+  const workbook = createWorkbook();
+  const sheet = workbook.addWorksheet(SHEET_NAME, {
+    views: [{ state: 'frozen', xSplit: 2, ySplit: 2, topLeftCell: 'C3' }],
+    pageSetup: { orientation: 'landscape', fitToPage: true, fitToWidth: 1, fitToHeight: 0 },
+  });
+
+  // 两级表头：单据级列纵向合并两行；明细区第一行合并显示「采购物料明细」
+  const detailStart = PARENT_COLUMNS.length + 1;
+  const detailEnd = detailStart + DETAIL_COLUMNS.length - 1;
+  const topRow = sheet.getRow(1);
+  const subRow = sheet.getRow(2);
+  COLUMNS.forEach((column, index) => {
+    const col = index + 1;
+    if (col >= detailStart && col <= detailEnd) {
+      topRow.getCell(col).value = col === detailStart ? '采购物料明细' : '';
+      subRow.getCell(col).value = column.header;
+    } else {
+      topRow.getCell(col).value = column.header;
+      subRow.getCell(col).value = '';
+    }
+  });
+  topRow.height = 30;
+  subRow.height = 30;
+  for (const row of [topRow, subRow]) {
+    for (let col = 1; col <= COLUMNS.length; col += 1) {
+      const cell = row.getCell(col);
+      cell.font = { bold: true };
+      cell.fill = HEADER_FILL;
+      cell.border = BORDER;
+      cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
+    }
+  }
+  sheet.mergeCells(1, detailStart, 1, detailEnd);
+  for (let col = 1; col < detailStart; col += 1) {
+    sheet.mergeCells(1, col, 2, col);
+  }
+  for (let col = detailEnd + 1; col <= COLUMNS.length; col += 1) {
+    sheet.mergeCells(1, col, 2, col);
+  }
+
+  // 数据行：有图片的行高 48，其余 24；长文本列左对齐，其余居中
+  const imageCol = DETAIL_COLUMNS.findIndex((column) => column.field === 'materialImgUrl') + PARENT_COLUMNS.length + 1;
+  rows.forEach((row, index) => {
+    const rowNumber = index + 3;
+    const added = sheet.addRow(COLUMNS.map((column) => cellValue(row, column)));
+    added.height = row.hasImage ? 48 : 24;
+    added.eachCell((cell, colNumber) => {
+      const column = COLUMNS[colNumber - 1];
+      cell.border = BORDER;
+      cell.alignment = {
+        vertical: 'middle',
+        horizontal: LEFT_FIELDS.has(column.field) ? 'left' : 'center',
+        wrapText: true,
+      };
+    });
+    const url = imageUrls[index];
+    if (url && images.has(url)) {
+      embedImage(workbook, sheet, images.get(url), rowNumber, imageCol, { width: 60, height: 60 });
+    }
+  });
+
+  // 同一采购单的连续行：非明细列纵向合并
+  let start = 0;
+  while (start < rows.length) {
+    let end = start;
+    while (end + 1 < rows.length && rows[start].ordersSn && rows[start].ordersSn === rows[end + 1].ordersSn) {
+      end += 1;
+    }
+    if (end > start) {
+      COLUMNS.forEach((column, index) => {
+        if (!DETAIL_FIELDS.has(column.field)) {
+          sheet.mergeCells(start + 3, index + 1, end + 3, index + 1);
+        }
+      });
+    }
+    start = end + 1;
+  }
+
+  COLUMNS.forEach((column, index) => {
+    sheet.getColumn(index + 1).width = column.width
+      || (column.kind === 'image' ? 16 : column.field === 'ordersSn' ? 20 : 12);
+  });
+
+  await saveWorkbook(workbook, filePath);
+
+  const skipped = imageUrls.filter((url) => url && !images.has(url)).length;
+  return {
+    filePaths: [filePath],
+    summary: `物料采购导出已生成：业务日期 ${from} ~ ${to}，采购单 ${records.length} 条展开为 ${rows.length} 行 × ${COLUMNS.length} 列，嵌物料图 ${images.size} 张` +
+      (skipped ? `（${skipped} 张下载失败已跳过）` : ''),
+  };
+}
+
+module.exports = { generate };