Edit import excel

apps/api/src/common/excel.ts

@@ -188,9 +188,121 @@ export async function workbookFromUpload(file: Express.Multer.File | undefined)
   return sheet;
 }
 
+export type ExcelFieldOption = {
+  key: string;
+  label: string;
+  required?: boolean;
+};
+
+export type ExcelColumnPreview = {
+  header: string;
+  index: number;
+  samples: string[];
+};
+
+export type ExcelPreviewResult = {
+  columns: ExcelColumnPreview[];
+  fields: ExcelFieldOption[];
+  suggested: Record<string, string>;
+  needsMapping: boolean;
+};
+
+export function excelFieldsFromColumns(
+  columns: Array<{ header: string; key: string }>,
+  requiredKeys: string[] = [],
+): ExcelFieldOption[] {
+  const seen = new Set<string>();
+  const fields: ExcelFieldOption[] = [];
+  for (const col of columns) {
+    if (!col.key || col.key === '_type' || seen.has(col.key)) continue;
+    seen.add(col.key);
+    fields.push({
+      key: col.key,
+      label: col.header,
+      required: requiredKeys.includes(col.key),
+    });
+  }
+  return fields;
+}
+
+export function parseExcelMapping(raw?: string): Record<string, string> | undefined {
+  if (raw == null || !String(raw).trim()) return undefined;
+  try {
+    const parsed = JSON.parse(String(raw)) as unknown;
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+      throw new Error('invalid');
+    }
+    const mapping: Record<string, string> = {};
+    for (const [header, field] of Object.entries(parsed as Record<string, unknown>)) {
+      if (typeof field === 'string' && field.trim()) mapping[header] = field.trim();
+    }
+    return mapping;
+  } catch {
+    throw new BadRequestException('نگاشت ستون‌ها نامعتبر است');
+  }
+}
+
+function resolveFieldKey(
+  raw: string,
+  aliases: Record<string, string>,
+  mapping?: Record<string, string>,
+) {
+  if (mapping) {
+    return mapping[raw] || mapping[normalizeHeader(raw)] || '';
+  }
+  const compact = normalizeHeader(raw);
+  return aliases[compact] ?? aliases[raw.trim()] ?? aliases[normalizeHeader(raw)] ?? '';
+}
+
+export async function previewExcel(
+  file: Express.Multer.File,
+  aliases: Record<string, string>,
+  fields: ExcelFieldOption[],
+): Promise<ExcelPreviewResult> {
+  const sheet = await workbookFromUpload(file);
+  const headerRow = sheet.getRow(1);
+  const columns: ExcelColumnPreview[] = [];
+  const suggested: Record<string, string> = {};
+  const used = new Set<string>();
+
+  headerRow.eachCell((cell, col) => {
+    const header = cellStr(cell.value);
+    if (!header) return;
+    const samples: string[] = [];
+    const last = Math.min(sheet.rowCount, 6);
+    for (let r = 2; r <= last; r += 1) {
+      const value = cellStr(sheet.getRow(r).getCell(col).value);
+      if (value) samples.push(value);
+      if (samples.length >= 3) break;
+    }
+    columns.push({ header, index: col, samples });
+    const key = resolveFieldKey(header, aliases);
+    if (key && !used.has(key)) {
+      suggested[header] = key;
+      used.add(key);
+    }
+  });
+
+  if (!columns.length) {
+    throw new BadRequestException('ستون عنوان در ردیف اول فایل پیدا نشد');
+  }
+
+  const required = fields.filter((f) => f.required).map((f) => f.key);
+  const mapped = new Set(Object.values(suggested));
+  const missingRequired = required.some((key) => !mapped.has(key));
+  const unrecognized = columns.some((col) => !suggested[col.header]);
+  return {
+    columns,
+    fields,
+    suggested,
+    needsMapping: unrecognized || missingRequired || !mapped.size,
+  };
+}
+
 export async function readMappedRows(
   file: Express.Multer.File,
   aliases: Record<string, string>,
+  mapping?: Record<string, string>,
 ): Promise<Record<string, string>[]> {
   const sheet = await workbookFromUpload(file);
   const headerRow = sheet.getRow(1);
@@ -198,13 +310,12 @@ export async function readMappedRows(
   headerRow.eachCell((cell, col) => {
     const raw = cellStr(cell.value);
     if (!raw) return;
-    const compact = normalizeHeader(raw);
-    const key = aliases[compact] ?? aliases[raw.trim()] ?? aliases[normalizeHeader(raw)];
+    const key = resolveFieldKey(raw, aliases, mapping);
     if (key) map.set(col, key);
   });
   if (!map.size) {
     throw new BadRequestException(
-      'ستون‌های فایل شناسایی نشد. از قالب خروجی همین سیستم یا خروجی دیدار استفاده کنید.',
+      'ستون‌های فایل شناسایی نشد. ستون‌های فایل را با فیلدهای سیستم تطبیق دهید.',
     );
   }