oms/backend/app/lib/productImport.js
liufumingren 7f0651ed37 feat(product): 商品批量导入(12 字段,编码存在则更新)
- 后端新增 app/lib/productImport.js:模板列定义(含表头别名)、xlsx 解析、行校验、金额解析
- 新增 GET /api/products/import-template(下载仅含表头的模板)
- 新增 POST /api/products/import:同主体下商品编码已存在则更新(空单元格不覆盖原值,
  软删除的会恢复),否则新建;文件内重复编码按最后一行处理;未知列在结果中返回
- 导入结果返回 total/created/updated/restored/failed/duplicated/errors/ignored_columns,
  并写入操作日志、对更新的商品触发待审核订单明细重算
- multipart 白名单增加 .xlsx
- 前端商品页新增「批量导入」:下载模板、选择 xlsx、展示导入结果与失败明细
- .eslintrc 为 config 目录放开 no-restricted-modules(config 需要 path 等核心模块)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 03:57:11 +08:00

154 lines
5.5 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const ExcelJS = require('exceljs');
const fs = require('fs');
/**
* 商品批量导入的列定义与解析工具。
*
* 只接受下面 12 个字段,表头按中文名匹配(允许少量别名);
* 未识别的列会在结果里以 ignored_columns 返回,不参与导入。
*/
const IMPORT_COLUMNS = [
{ field: 'item_code', label: '商品编码', required: true, type: 'text', max: 50 },
{ field: 'item_name', label: '商品名称', type: 'text', max: 255 },
{ field: 'goods_code', label: '货物编码', type: 'text', max: 100, aliases: [ '货品编码' ] },
{ field: 'sku_property', label: 'SKU规格', type: 'text', max: 100, aliases: [ '规格', 'SKU 规格' ] },
{ field: 'category_name', label: '分类', type: 'text', max: 100, aliases: [ '商品分类' ] },
{ field: 'brand_name', label: '品牌', type: 'text', max: 100, aliases: [ '商品品牌' ] },
{ field: 'barcode', label: '条码', type: 'text', max: 100 },
{ field: 'stock_unit', label: '单位', type: 'text', max: 20, aliases: [ '库存单位' ] },
{ field: 'retail_price', label: '零售价', type: 'money' },
{ field: 'cost_price', label: '成本价', type: 'money' },
{ field: 'tag_price', label: '标签价', type: 'money', aliases: [ '标价' ] },
{ field: 'remark', label: '备注', type: 'text', max: 255 },
];
/** 允许的表头(含别名)→ 字段定义 */
const HEADER_MAP = new Map();
for (const col of IMPORT_COLUMNS) {
HEADER_MAP.set(col.label, col);
for (const alias of col.aliases || []) HEADER_MAP.set(alias, col);
}
/**
* 单元格取值归一化(兼容富文本 / 公式 / 超链接 / 日期)
* @param {*} value 原始单元格值
* @return {string} 文本
*/
function cellText(value) {
if (value == null) return '';
if (value instanceof Date) return value.toISOString().slice(0, 10);
if (typeof value === 'object') {
if (Array.isArray(value.richText)) return value.richText.map(item => item.text || '').join('').trim();
if (value.text != null) return String(value.text).trim();
if (value.result != null) return String(value.result).trim();
if (value.hyperlink != null) return String(value.hyperlink).trim();
return '';
}
return String(value).trim();
}
/**
* 金额解析(去千分位与货币符号)
* @param {string} text 文本
* @return {{ok: boolean, value?: number, message?: string}} 解析结果
*/
function parseMoney(text) {
const cleaned = String(text || '').replace(/[¥,,\s]/g, '');
if (!cleaned) return { ok: true, value: undefined };
const num = Number(cleaned);
if (!Number.isFinite(num)) return { ok: false, message: `不是有效金额:${text}` };
if (num < 0) return { ok: false, message: '金额不能为负数' };
return { ok: true, value: Number(num.toFixed(2)) };
}
/**
* 读取 Excel 文件并解析为待导入行
* @param {string|Buffer} source 文件路径或文件内容
* @return {Promise<{rows: Array, ignoredColumns: Array<string>, headerError: string|null}>} 解析结果
*/
async function parseImportFile(source) {
const buffer = typeof source === 'string' ? fs.readFileSync(source) : source;
const workbook = new ExcelJS.Workbook();
await workbook.xlsx.load(buffer);
const sheet = workbook.worksheets[0];
if (!sheet) return { rows: [], ignoredColumns: [], headerError: '文件中没有任何工作表' };
const headerRow = sheet.getRow(1);
const columnByIndex = new Map();
const ignoredColumns = [];
headerRow.eachCell({ includeEmpty: false }, (cell, colNumber) => {
const label = cellText(cell.value);
if (!label) return;
const col = HEADER_MAP.get(label);
if (col) {
if (!columnByIndex.has(col.field)) columnByIndex.set(col.field, colNumber);
} else {
ignoredColumns.push(label);
}
});
if (!columnByIndex.has('item_code')) {
return { rows: [], ignoredColumns, headerError: '缺少「商品编码」列(第一行应为表头)' };
}
const rows = [];
const lastRow = sheet.actualRowCount || sheet.rowCount;
for (let rowNumber = 2; rowNumber <= lastRow; rowNumber++) {
const row = sheet.getRow(rowNumber);
const raw = {};
for (const col of IMPORT_COLUMNS) {
const colNumber = columnByIndex.get(col.field);
raw[col.field] = colNumber ? cellText(row.getCell(colNumber).value) : '';
}
// 整行为空则跳过
if (Object.values(raw).every(text => !text)) continue;
rows.push({ rowNumber, raw });
}
return { rows, ignoredColumns, headerError: null };
}
/**
* 校验并把一行原始文本转换为待写入的商品字段
* 只返回「填了值」的字段:空单元格不覆盖已有数据
* @param {Object} raw 原始文本(按字段名)
* @return {{data: Object, errors: Array<string>}} 结果
*/
function normalizeRow(raw) {
const data = {};
const errors = [];
for (const col of IMPORT_COLUMNS) {
const text = String(raw[col.field] == null ? '' : raw[col.field]).trim();
if (col.type === 'money') {
const parsed = parseMoney(text);
if (!parsed.ok) { errors.push(`${col.label}${parsed.message}`); continue; }
if (parsed.value !== undefined) data[col.field] = parsed.value;
continue;
}
if (!text) {
if (col.required) errors.push(`${col.label}不能为空`);
continue;
}
if (col.max && text.length > col.max) {
errors.push(`${col.label}超长(最多 ${col.max} 字符)`);
continue;
}
data[col.field] = text;
}
return { data, errors };
}
module.exports = {
IMPORT_COLUMNS,
parseImportFile,
normalizeRow,
cellText,
parseMoney,
};