BPOS-TMP-REPO/apps/api/src/app/__tests__/seed-mvp-data.test.ts

/**
 * 主数据四域 —— 客户 / 项目 / 供应商 / 市场。
 *
 * 这份测试从前断言的是「四域十九对象」,那个四域是 project / customer / intel / supplier,
 * 装的是**退役占位槽**的声明,里面混着一单一份的流转单据(受理记录、比价表、报价草案)。
 * 2026-07-31 重分:单据归各活动自己的域,这个文件只留**主数据**,按常规 CRM / ERP 分四域。
 *
 * 守的是三条,每条都能机检:
 *   · 八个域,多一个就说明有人把单据塞进主数据了;
 *   · 每张表都是 `master` 且**不带单标识** —— 带了就是单据归错类(安装静态审也会拦);
 *   · 主键是**业务实体**,不是单。
 */
import { describe, expect, it } from 'vitest';
import { MASTER_DOMAINS, MASTER_OBJECTS, MASTER_SAMPLE_ROWS } from '../seed-mvp-data.ts';

describe('主数据四域', () => {
  it('八个域:客户 / 项目 / 供应商 / 市场 + 料件 / 需求 / 替代 / 验证(SS02 差异评估 2026-08-26 加后四域)', () => {
    expect([...MASTER_DOMAINS]).toEqual(['customer', 'project', 'supplier', 'market', 'parts', 'demand', 'substitution', 'validation']);
    expect([...new Set(MASTER_OBJECTS.map((o) => o.domain))].sort()).toEqual([...MASTER_DOMAINS].sort());
  });

  it('SS02 差异评估要读写的七张主数据表都在基线里,主键照《统一方案》', () => {
    const pk = (domain: string, object: string) =>
      MASTER_OBJECTS.find((o) => o.domain === domain && o.object === object)?.fields.filter((f) => f.primaryKey).map((f) => f.name);
    expect(pk('parts', 'profile')).toEqual(['internal_pn']);
    expect(pk('parts', 'parameter')).toEqual(['internal_pn', 'param_name']);
    expect(pk('parts', 'document')).toEqual(['internal_pn', 'doc_seq']);
    expect(pk('demand', 'request')).toEqual(['request_id']);
    expect(pk('substitution', 'relation')).toEqual(['substitution_relation_id']);
    expect(pk('substitution', 'difference_item')).toEqual(['substitution_relation_id', 'difference_item_id']);
    expect(pk('validation', 'record')).toEqual(['validation_id']);
  });

  it('样例料号:原 PN 与同族可调版在库,候选 XL2596S-5.0 刻意不播(数据工单那条路要试得出来)', () => {
    const parts = MASTER_SAMPLE_ROWS.filter((r) => r.address.domain === 'parts' && r.address.object === 'profile').map((r) => r.key['internal_pn']);
    expect(parts).toEqual(['LM2596S-5.0', 'LM2596S-ADJ']);
    expect(parts).not.toContain('XL2596S-5.0');
  });

  it('样例料号的标准化参数集是独立子表 parts.parameter:两颗料各 7 行,主键是 (internal_pn, param_name)', () => {
    const params = MASTER_SAMPLE_ROWS.filter((r) => r.address.domain === 'parts' && r.address.object === 'parameter');
    const byPn = (pn: string) => params.filter((r) => r.key['internal_pn'] === pn);
    expect(byPn('LM2596S-5.0')).toHaveLength(7);
    expect(byPn('LM2596S-ADJ')).toHaveLength(7);
    for (const row of params) {
      expect(Object.keys(row.key).sort()).toEqual(['internal_pn', 'param_name']);
      expect(row.values['param_value'], JSON.stringify(row.key)).toBeTruthy();
      expect(row.values['constraint_type']).toMatch(/^(hard|soft)$/);
    }
    // parts.profile 不再声明这一列的值 —— 两行样例主记录里它应为空(物理列留在基线,不再写)
    const profiles = MASTER_SAMPLE_ROWS.filter((r) => r.address.domain === 'parts' && r.address.object === 'profile');
    for (const row of profiles) expect(row.values['normalized_parameter_set']).toBeUndefined();
  });

  it('四个域各自都有表 —— 空占位也得立得住', () => {
    for (const d of MASTER_DOMAINS) {
      expect(MASTER_OBJECTS.filter((o) => o.domain === d).length, `${d} 域一张表都没有`).toBeGreaterThan(0);
    }
  });

  /*
   * 这一条是分类的要害:主数据按**业务实体**分行,不按单。
   * 带上单标识就说明它其实是一单一份的单据 —— 归错类,治理方式全跟着错。
   */
  it('每张表都是 master 且不带单标识', () => {
    for (const o of MASTER_OBJECTS) {
      expect(o.kind, `${o.domain}.${o.object}`).toBe('master');
      expect(o.caseKey, `${o.domain}.${o.object} 不该有单标识`).toBeUndefined();
    }
  });

  it('每张表都有主键 —— 没主键的台账合并与去重无从谈起', () => {
    for (const o of MASTER_OBJECTS) {
      const pk = o.fields.filter((f) => f.primaryKey).map((f) => f.name);
      expect(pk.length, `${o.domain}.${o.object} 没有主键`).toBeGreaterThan(0);
    }
  });

  /* 主键得是业务实体键 —— 单标识那几个名字出现在主键里,就是归错了类 */
  it('主键里不出现单标识那几个名字', () => {
    for (const o of MASTER_OBJECTS) {
      const pk = o.fields.filter((f) => f.primaryKey).map((f) => f.name);
      for (const caseish of ['rfq_ref', 'quote_no', 'task_id']) {
        expect(pk, `${o.domain}.${o.object} 的主键里有单标识 ${caseish}`).not.toContain(caseish);
      }
    }
  });

  /* 个人信息必须标脱敏 —— 主数据里存联系人,治理面照 `masked` 裁剪 */
  it('联系人的邮箱与电话标了脱敏', () => {
    const contacts = MASTER_OBJECTS.filter((x) => x.object === 'contact');
    expect(contacts.length).toBeGreaterThan(0);
    for (const o of contacts) {
      for (const name of ['email', 'phone']) {
        const field = o.fields.find((x) => x.name === name);
        expect(field?.masked, `${o.domain}.${o.object}.${name} 未标脱敏`).toBe(true);
      }
    }
  });
});