feat(api): add origin good name parser

2026-08-28 12:23:35 +08:00
parent 37b45a4679
commit 60946b5f64
2 changed files with 165 additions and 0 deletions
@@ -0,0 +1,96 @@
+import { parseOriginName, originGroupKey } from './origin-name.parser';
+
+describe('parseOriginName', () => {
+  it('解析完整四段名（含仓库）', () => {
+    expect(
+      parseOriginName('美国（不包邮）240g涤纶休闲短裤-DG206-单面印花-美西洛杉矶一仓'),
+    ).toEqual({
+      country: '美国',
+      logisticsLabel: '不包邮',
+      productName: '240g涤纶休闲短裤',
+      skuCode: 'DG206',
+      craftLabel: '单面印花',
+      warehouseLabel: '美西洛杉矶一仓',
+    });
+  });
+
+  it('解析三段名（无仓库）', () => {
+    expect(
+      parseOriginName('墨西哥（不包邮）180g纯棉女装修身T恤-METP001-单面印花'),
+    ).toEqual({
+      country: '墨西哥',
+      logisticsLabel: '不包邮',
+      productName: '180g纯棉女装修身T恤',
+      skuCode: 'METP001',
+      craftLabel: '单面印花',
+      warehouseLabel: null,
+    });
+  });
+
+  it('物流备注含星号等符号原样保留', () => {
+    const r = parseOriginName(
+      '波兰（包邮*运费订单结算时支付）250g男女同款抓毛圆领卫衣-PLHM002-双面印花',
+    );
+    expect(r.logisticsLabel).toBe('包邮*运费订单结算时支付');
+    expect(r.skuCode).toBe('PLHM002');
+  });
+
+  it('半角括号也能解析', () => {
+    const r = parseOriginName('美国(包邮)T恤-DG001-单面印花');
+    expect(r.country).toBe('美国');
+    expect(r.logisticsLabel).toBe('包邮');
+    expect(r.productName).toBe('T恤');
+  });
+
+  it('段1无括号时 country=整段、物流为空', () => {
+    const r = parseOriginName('美国T恤-DG001-单面印花');
+    expect(r.country).toBe('美国T恤');
+    expect(r.logisticsLabel).toBeNull();
+    expect(r.productName).toBeNull();
+  });
+
+  it('两段名：只解析国家/物流/品名/SKU', () => {
+    const r = parseOriginName('美国（包邮）T恤-DG001');
+    expect(r.skuCode).toBe('DG001');
+    expect(r.craftLabel).toBeNull();
+    expect(r.warehouseLabel).toBeNull();
+  });
+
+  it('一段名/空值/null 安全', () => {
+    expect(parseOriginName('随便一个名字').skuCode).toBeNull();
+    expect(parseOriginName('随便一个名字').country).toBe('随便一个名字');
+    expect(parseOriginName(null).country).toBeNull();
+    expect(parseOriginName('').country).toBeNull();
+  });
+
+  it('段前后空格被 trim', () => {
+    const r = parseOriginName('美国（包邮） T恤 - DG001 - 单面印花');
+    expect(r.skuCode).toBe('DG001');
+    expect(r.craftLabel).toBe('单面印花');
+    expect(r.productName).toBe('T恤');
+  });
+
+  it('仓库段含连字符时整体保留', () => {
+    const r = parseOriginName('美国（包邮）T恤-DG001-单面印花-某仓-二期');
+    expect(r.warehouseLabel).toBe('某仓-二期');
+  });
+});
+
+describe('originGroupKey', () => {
+  it('与 admin truncateToProcess 语义一致：前3段', () => {
+    expect(originGroupKey('美国（包邮）T恤-DG001-单面印花-美西一仓')).toBe(
+      '美国（包邮）T恤-DG001-单面印花',
+    );
+  });
+
+  it('物流差异导致不同组', () => {
+    expect(originGroupKey('美国（不包邮）T恤-DG001-单面印花')).not.toBe(
+      originGroupKey('美国（包邮）T恤-DG001-单面印花'),
+    );
+  });
+
+  it('空名返回空串', () => {
+    expect(originGroupKey(null)).toBe('');
+    expect(originGroupKey('')).toBe('');
+  });
+});
@@ -0,0 +1,69 @@
+/**
+ * 原产品链接名结构化解析。
+ *
+ * 名称格式（与 admin 端 utils/origin-name.ts 的调查结论一致）：
+ * `国家（物流备注）品名-SKU-工艺位置[-仓库名]`
+ *
+ * 仓库段为可选；段与段之间以 `-` 分隔，段 1 内国家与物流备注以全角（或半角）括号分隔。
+ * 解析失败的字段置 null，不抛异常 —— 上游名称是自由文本，解析器必须容错。
+ */
+export interface ParsedOriginName {
+  country: string | null;
+  logisticsLabel: string | null;
+  productName: string | null;
+  skuCode: string | null;
+  craftLabel: string | null;
+  warehouseLabel: string | null;
+}
+
+const EMPTY: ParsedOriginName = {
+  country: null,
+  logisticsLabel: null,
+  productName: null,
+  skuCode: null,
+  craftLabel: null,
+  warehouseLabel: null,
+};
+
+function splitSegment1(seg: string): Pick<ParsedOriginName, 'country' | 'logisticsLabel' | 'productName'> {
+  const pairs: Array<[string, string]> = [
+    ['（', '）'],
+    ['(', ')'],
+  ];
+  for (const [open, close] of pairs) {
+    const openAt = seg.indexOf(open);
+    if (openAt >= 0) {
+      const closeAt = seg.indexOf(close, openAt);
+      if (closeAt > openAt) {
+        return {
+          country: seg.slice(0, openAt).trim() || null,
+          logisticsLabel: seg.slice(openAt + 1, closeAt).trim() || null,
+          productName: seg.slice(closeAt + 1).trim() || null,
+        };
+      }
+    }
+  }
+  return { country: seg.trim() || null, logisticsLabel: null, productName: null };
+}
+
+export function parseOriginName(name: string | null | undefined): ParsedOriginName {
+  if (!name) return EMPTY;
+  const segs = name.split('-').map((s) => s.trim());
+  if (segs.length === 0 || segs[0] === '') return EMPTY;
+  return {
+    ...splitSegment1(segs[0]),
+    skuCode: segs[1] || null,
+    craftLabel: segs[2] || null,
+    // 仓库名本身可能含连字符，第 4 段起整体保留
+    warehouseLabel: segs.length > 3 ? segs.slice(3).join('-') : null,
+  };
+}
+
+/**
+ * 分组键：与 admin 端 truncateToProcess（KEEP_SEGMENTS = 3）语义一致，
+ * 保留按 `-` 分段的前 3 段，丢弃可选的仓库名段。
+ */
+export function originGroupKey(name: string | null | undefined): string {
+  if (!name) return '';
+  return name.split('-').slice(0, 3).join('-');
+}