feat(round-11): 弱网离线队列/跨国会议一键预约/团队多语言名片批量向导/NFC硬件出厂封印 (83套件984测试全绿)

2026-09-21 02:03:13 +08:00
--- a/backend/test/comm/calendar-invite.test.ts
+++ b/backend/test/comm/calendar-invite.test.ts
@@ -0,0 +1,77 @@
+import {
+  CardCalendarService,
+  generateGoogleCalendarUrl,
+  generateOutlookCalendarUrl,
+  generateOffice365CalendarUrl,
+  MeetingEventOptions,
+} from '../../src/modules/card/service/calendar';
+
+describe('Point 42: 出海潜客跨国会议 Google Calendar / Outlook 一键预约同步', () => {
+  let calendarService: CardCalendarService;
+
+  const mockMeeting: MeetingEventOptions = {
+    summary: 'OmniCard Global Expansion Demo (Dubai GITEX)',
+    description: 'Discussing AI Business Cards & Regional CRM Deployment for Middle East.\nMeeting Link: https://meet.google.com/xyz-abc-def',
+    location: 'Dubai World Trade Centre, Hall 4 & Google Meet',
+    startTime: new Date(Date.UTC(2026, 9, 15, 10, 0, 0)),
+    endTime: new Date(Date.UTC(2026, 9, 15, 11, 0, 0)),
+  };
+
+  beforeEach(() => {
+    calendarService = new CardCalendarService();
+  });
+
+  describe('1. Google Calendar Web 预约链接生成 (generateGoogleCalendarUrl)', () => {
+    it('应生成符合 Google Calendar 规范的模板 URL', () => {
+      const url = generateGoogleCalendarUrl(mockMeeting);
+      expect(url).toContain('calendar.google.com/calendar/render?action=TEMPLATE');
+      expect(decodeURIComponent(url.replace(/\+/g, ' '))).toContain('text=OmniCard Global Expansion Demo (Dubai GITEX)');
+      expect(url).toContain('dates=20261015T100000Z%2F20261015T110000Z');
+      expect(decodeURIComponent(url.replace(/\+/g, ' '))).toContain('location=Dubai World Trade Centre');
+      expect(url).toContain('details=');
+    });
+
+    it('支持包含组织者与参会人 email 添加至 details 备注中', () => {
+      const meetingWithEmails: MeetingEventOptions = {
+        ...mockMeeting,
+        organizer: { name: 'Sarah Lynn', email: 'sarah@omnicard.ai' },
+        attendees: [{ name: 'Ahmed', email: 'ahmed@emirates.ae' }],
+      };
+      const url = generateGoogleCalendarUrl(meetingWithEmails);
+      expect(decodeURIComponent(url)).toContain('sarah@omnicard.ai');
+      expect(decodeURIComponent(url)).toContain('ahmed@emirates.ae');
+    });
+  });
+
+  describe('2. Outlook / Office 365 预约链接生成', () => {
+    it('应生成 Outlook Live 深度一键日程链接', () => {
+      const url = generateOutlookCalendarUrl(mockMeeting);
+      expect(url).toContain('outlook.live.com/calendar/0/deeplink/compose');
+      expect(url).toContain('rru=addevent');
+      expect(decodeURIComponent(url.replace(/\+/g, ' '))).toContain('subject=OmniCard Global Expansion Demo (Dubai GITEX)');
+      expect(url).toContain('startdt=2026-10-15T10%3A00%3A00.000Z');
+      expect(url).toContain('enddt=2026-10-15T11%3A00%3A00.000Z');
+    });
+
+    it('应生成 Office 365 商业版企业日历链接', () => {
+      const url = generateOffice365CalendarUrl(mockMeeting);
+      expect(url).toContain('outlook.office.com/calendar/0/deeplink/compose');
+      expect(url).toContain('rru=addevent');
+      expect(url).toContain('subject=');
+    });
+  });
+
+  describe('3. CardCalendarService 综合生成日历集合包 (generateCalendarInviteLinks)', () => {
+    it('应统一返回 Google、Outlook、Office365 链接与标准 RFC 5545 ICS 字符串', () => {
+      const invite = calendarService.generateCalendarInviteLinks(mockMeeting);
+
+      expect(invite.googleUrl).toBeDefined();
+      expect(invite.outlookUrl).toBeDefined();
+      expect(invite.office365Url).toBeDefined();
+      expect(invite.icsContent).toContain('BEGIN:VCALENDAR');
+      expect(invite.icsContent).toContain('BEGIN:VEVENT');
+      expect(invite.icsContent).toContain('SUMMARY:OmniCard Global Expansion Demo');
+      expect(invite.icsContent).toContain('END:VCALENDAR');
+    });
+  });
+});
--- a/backend/test/modules/card/batch-locale.test.ts
+++ b/backend/test/modules/card/batch-locale.test.ts
@@ -0,0 +1,191 @@
+import {
+  CardBatchLocaleService,
+  BatchLocaleMemberCard,
+  validateLocaleFields,
+} from '../../../src/modules/card/service/batch-locale';
+import { CardLocaleEntity } from '../../../src/modules/card/entity/locale';
+
+describe('Point 43: 出海团队多语言名片批量生成向导与多语种字段镜像校验', () => {
+  let service: CardBatchLocaleService;
+  let mockRepository: any;
+  let savedRecords: CardLocaleEntity[];
+
+  beforeEach(() => {
+    savedRecords = [];
+    mockRepository = {
+      findOneBy: jest.fn(async ({ cardId, locale }: any) => {
+        return savedRecords.find(r => r.cardId === cardId && r.locale === locale) || null;
+      }),
+      find: jest.fn(async ({ where }: any) => {
+        if (where && where.cardId) {
+          return savedRecords.filter(r => r.cardId === where.cardId);
+        }
+        return savedRecords;
+      }),
+      save: jest.fn(async (entity: any) => {
+        const existingIdx = savedRecords.findIndex(
+          r => r.cardId === entity.cardId && r.locale === entity.locale
+        );
+        if (existingIdx >= 0) {
+          savedRecords[existingIdx] = { ...savedRecords[existingIdx], ...entity };
+          return savedRecords[existingIdx];
+        }
+        const created = { id: savedRecords.length + 1, ...entity };
+        savedRecords.push(created);
+        return created;
+      }),
+    };
+
+    service = new CardBatchLocaleService();
+    service.cardLocaleEntity = mockRepository;
+  });
+
+  describe('1. validateLocaleFields (多语言字段规范与合法性校验)', () => {
+    it('正常字段应校验通过', () => {
+      const res = validateLocaleFields({
+        name: 'Sarah Chen',
+        title: 'VP of Global BD',
+        company: 'OmniCard AI',
+        slogan: 'Connect the world with intelligent cards',
+      });
+      expect(res.valid).toBe(true);
+      expect(res.errors).toHaveLength(0);
+    });
+
+    it('姓名为空或超长应精准拦截', () => {
+      const emptyRes = validateLocaleFields({ name: '   ' });
+      expect(emptyRes.valid).toBe(false);
+      expect(emptyRes.errors).toContain('姓名不能为空');
+
+      const longRes = validateLocaleFields({ name: 'A'.repeat(65) });
+      expect(longRes.valid).toBe(false);
+      expect(longRes.errors).toContain('姓名长度不能超过64字符');
+    });
+
+    it('职位、公司与标语超长时应拦截', () => {
+      const res = validateLocaleFields({
+        name: 'Test',
+        title: 'T'.repeat(129),
+        company: 'C'.repeat(129),
+        slogan: 'S'.repeat(256),
+      });
+      expect(res.valid).toBe(false);
+      expect(res.errors.length).toBeGreaterThanOrEqual(3);
+    });
+  });
+
+  describe('2. batchGenerateMemberLocales (团队成员多语言名片批量生成向导)', () => {
+    const mockMembers: BatchLocaleMemberCard[] = [
+      {
+        cardId: 101,
+        baseFields: {
+          name: '张三',
+          title: '出海销售总监',
+          company: '深圳数字智能出海科技',
+          slogan: '智能连接全球',
+        },
+      },
+      {
+        cardId: 102,
+        baseFields: {
+          name: '李四',
+          title: '中东区域代表',
+          company: '深圳数字智能出海科技',
+          slogan: '专注海湾六国',
+        },
+      },
+    ];
+
+    it('应成功为团队成员批量生成指定目标语言分支 (en, ar)', async () => {
+      const result = await service.batchGenerateMemberLocales({
+        members: mockMembers,
+        targetLocales: ['en', 'ar'],
+      });
+
+      expect(result.totalTasks).toBe(4); // 2 members * 2 locales
+      expect(result.successTasks).toBe(4);
+      expect(result.failedTasks).toBe(0);
+      expect(result.completionRate).toBe(1.0);
+      expect(savedRecords.length).toBe(4);
+
+      // 验证保存的记录属性
+      const en101 = savedRecords.find(r => r.cardId === 101 && r.locale === 'en');
+      expect(en101).toBeDefined();
+      expect(en101?.name).toBe('张三');
+
+      const ar102 = savedRecords.find(r => r.cardId === 102 && r.locale === 'ar');
+      expect(ar102).toBeDefined();
+      expect(ar102?.name).toBe('李四');
+    });
+
+    it('支持传入语言自定义词典或转换映射处理器 (localeTransformer)', async () => {
+      const result = await service.batchGenerateMemberLocales({
+        members: [mockMembers[0]],
+        targetLocales: ['en'],
+        localeTransformer: (locale, base) => {
+          if (locale === 'en') {
+            return {
+              name: 'Alex Zhang',
+              title: 'Global Sales Director',
+              company: 'OmniCard Tech Co., Ltd.',
+              slogan: 'Connecting globally with AI cards',
+            };
+          }
+          return base;
+        },
+      });
+
+      expect(result.successTasks).toBe(1);
+      const enCard = savedRecords.find(r => r.cardId === 101 && r.locale === 'en');
+      expect(enCard?.name).toBe('Alex Zhang');
+      expect(enCard?.title).toBe('Global Sales Director');
+    });
+
+    it('遇到非法非法参数时应记录错误且不阻断其它任务', async () => {
+      const invalidMembers: BatchLocaleMemberCard[] = [
+        {
+          cardId: 999,
+          baseFields: { name: '' }, // 姓名为空导致失败
+        },
+        mockMembers[0],
+      ];
+
+      const result = await service.batchGenerateMemberLocales({
+        members: invalidMembers,
+        targetLocales: ['en'],
+      });
+
+      expect(result.totalTasks).toBe(2);
+      expect(result.successTasks).toBe(1);
+      expect(result.failedTasks).toBe(1);
+      expect(result.errors.length).toBe(1);
+      expect(result.errors[0].cardId).toBe(999);
+      expect(result.completionRate).toBe(0.5);
+    });
+  });
+
+  describe('3. inspectTeamLocaleCoverage (出海团队语言覆盖率与就绪度诊断)', () => {
+    it('应精准统计团队名片各语言的覆盖率与缺失名单', async () => {
+      savedRecords.push(
+        { id: 1, cardId: 101, locale: 'en', name: 'Alex' } as CardLocaleEntity,
+        { id: 2, cardId: 101, locale: 'ar', name: 'Alex' } as CardLocaleEntity,
+        { id: 3, cardId: 102, locale: 'en', name: 'John' } as CardLocaleEntity
+      );
+
+      const coverage = await service.inspectTeamLocaleCoverage(
+        [101, 102],
+        ['en', 'ar', 'es']
+      );
+
+      expect(coverage.teamMemberCount).toBe(2);
+      expect(coverage.locales['en'].coverageRate).toBe(1.0); // 101, 102 都有 en
+      expect(coverage.locales['en'].missingCardIds).toHaveLength(0);
+
+      expect(coverage.locales['ar'].coverageRate).toBe(0.5); // 仅 101 有
+      expect(coverage.locales['ar'].missingCardIds).toEqual([102]);
+
+      expect(coverage.locales['es'].coverageRate).toBe(0.0); // 都没有
+      expect(coverage.locales['es'].missingCardIds).toEqual([101, 102]);
+    });
+  });
+});
--- a/backend/test/modules/nfc/anti-tamper-replay.test.ts
+++ b/backend/test/modules/nfc/anti-tamper-replay.test.ts
@@ -0,0 +1,106 @@
+import {
+  NfcAntiTamperService,
+  generateCardOfflineSeal,
+  verifyCardOfflineSeal,
+  OfflineCardPayload,
+  verifyOfflineCardPayload,
+} from '../../../src/modules/nfc/service/anti-tamper';
+
+describe('Point 44: NFC 实体卡离线数字防伪防篡改签章与硬件出厂封印', () => {
+  let service: NfcAntiTamperService;
+  const mockUid = '04A1B2C3D4E5F6';
+  const mockCardId = 2002;
+  const mockSecret = 'nfc-secret-key-gitex-2026-dubai-omnicard';
+  const mockFactoryKey = 'factory-master-key-secure-hardware-seal';
+  const mockBatchNo = 'BATCH-202609-UAE-001';
+
+  beforeEach(() => {
+    service = new NfcAntiTamperService();
+  });
+
+  describe('1. 硬件物理出厂封印 (generateCardOfflineSeal & verifyCardOfflineSeal)', () => {
+    it('应基于 UID、批次号与工厂母密钥生成不可逆 SHA-256 硬件封印哈希', () => {
+      const seal = generateCardOfflineSeal(mockUid, mockBatchNo, mockFactoryKey);
+      expect(typeof seal).toBe('string');
+      expect(seal).toHaveLength(64);
+      expect(/^[0-9a-f]{64}$/i.test(seal)).toBe(true);
+
+      // 验证封印通过
+      const isSealValid = verifyCardOfflineSeal(mockUid, mockBatchNo, seal, mockFactoryKey);
+      expect(isSealValid).toBe(true);
+    });
+
+    it('篡改 UID、批次号或封印哈希时应严密拒绝', () => {
+      const seal = generateCardOfflineSeal(mockUid, mockBatchNo, mockFactoryKey);
+
+      // 篡改 UID
+      expect(verifyCardOfflineSeal('04FFFFFFFFFFFF', mockBatchNo, seal, mockFactoryKey)).toBe(false);
+      // 篡改批次号
+      expect(verifyCardOfflineSeal(mockUid, 'BATCH-FAKED', seal, mockFactoryKey)).toBe(false);
+      // 篡改签名封印
+      expect(verifyCardOfflineSeal(mockUid, mockBatchNo, seal.replace('a', 'b'), mockFactoryKey)).toBe(false);
+    });
+
+    it('参数缺失时抛出明确保护异常', () => {
+      expect(() => generateCardOfflineSeal('', mockBatchNo, mockFactoryKey)).toThrow();
+      expect(() => generateCardOfflineSeal(mockUid, '', mockFactoryKey)).toThrow();
+      expect(() => generateCardOfflineSeal(mockUid, mockBatchNo, '')).toThrow();
+    });
+  });
+
+  describe('2. 离线碰一碰数据包快速验签 (verifyOfflineCardPayload)', () => {
+    it('合法离线数据包在无网络状态下应成功通过验签', () => {
+      const ts = Date.now();
+      const token = service.generateDeviceToken(mockUid, mockCardId, mockSecret, ts);
+      const seal = generateCardOfflineSeal(mockUid, mockBatchNo, mockFactoryKey);
+
+      const payload: OfflineCardPayload = {
+        uid: mockUid,
+        cardId: mockCardId,
+        batchNo: mockBatchNo,
+        seal,
+        token,
+      };
+
+      const result = verifyOfflineCardPayload(payload, mockSecret, mockFactoryKey);
+      expect(result.valid).toBe(true);
+      expect(result.isAuthenticNfc).toBe(true);
+      expect(result.reason).toBeUndefined();
+    });
+
+    it('离线防伪 Token 伪造时应准确识破', () => {
+      const seal = generateCardOfflineSeal(mockUid, mockBatchNo, mockFactoryKey);
+      const fakePayload: OfflineCardPayload = {
+        uid: mockUid,
+        cardId: mockCardId,
+        batchNo: mockBatchNo,
+        seal,
+        token: `${Date.now()}.0000000000000000000000000000000000000000000000000000000000000000`,
+      };
+
+      const result = verifyOfflineCardPayload(fakePayload, mockSecret, mockFactoryKey);
+      expect(result.valid).toBe(false);
+      expect(result.reason).toMatch(/签名|篡改|invalid/i);
+    });
+  });
+
+  describe('3. 时钟漂移与时序攻击防护 (Clock Drift Tolerance)', () => {
+    it('在合理漂移容差内 (30秒) 允许通过', () => {
+      const futureTs = Date.now() + 15 * 1000; // 稍超前 15 秒 (网络或卡内时钟微偏)
+      const token = service.generateDeviceToken(mockUid, mockCardId, mockSecret, futureTs);
+
+      // 设置 30 秒容差
+      const res = service.verifyDeviceToken(mockUid, mockCardId, token, mockSecret, 300000, 30000);
+      expect(res.valid).toBe(true);
+    });
+
+    it('严重超前于未来时间戳的令牌应被坚决拦截', () => {
+      const futureTs = Date.now() + 120 * 1000; // 超前 2 分钟
+      const token = service.generateDeviceToken(mockUid, mockCardId, mockSecret, futureTs);
+
+      const res = service.verifyDeviceToken(mockUid, mockCardId, token, mockSecret, 300000, 30000);
+      expect(res.valid).toBe(false);
+      expect(res.reason).toMatch(/未来|clock drift/i);
+    });
+  });
+});
--- a/backend/test/mpuniapp/offline-queue.test.ts
+++ b/backend/test/mpuniapp/offline-queue.test.ts
@@ -0,0 +1,193 @@
+/**
+ * OmniCard AI (CRMmp) - 用户端离线缓存与断网重放队列单元测试
+ * 严格遵循 TDD 测试驱动规范与瑞士国际主义极简原则
+ */
+
+describe('Point 41: 移动端弱网离线视觉指示器与断网重放队列 (Offline Queue)', () => {
+  let storageMap: Record<string, string>;
+  let mod: any;
+
+  beforeEach(() => {
+    storageMap = {};
+
+    // 模拟全局 uni-app storage 与网络 API
+    (global as any).uni = {
+      getStorageSync: jest.fn((key: string) => storageMap[key] || ''),
+      setStorageSync: jest.fn((key: string, val: string) => {
+        storageMap[key] = String(val);
+      }),
+      removeStorageSync: jest.fn((key: string) => {
+        delete storageMap[key];
+      }),
+      onNetworkStatusChange: jest.fn(),
+    };
+
+    // @ts-ignore
+    mod = require('../../../mpuniapp/common/offline-queue.uts');
+    mod.clearOfflineQueue();
+    mod.setNetworkStatus(true, 'wifi');
+  });
+
+  afterEach(() => {
+    delete (global as any).uni;
+  });
+
+  describe('1. 网络在线/断网状态检测与切换', () => {
+    it('默认初始状态应为在线 (isOnline = true)', () => {
+      expect(mod.isOnline()).toBe(true);
+      const status = mod.getOfflineQueueStatus();
+      expect(status.isOnline).toBe(true);
+      expect(status.networkType).toBe('wifi');
+    });
+
+    it('断网时状态切换为离线并输出正确的国际化横幅文案', () => {
+      mod.setNetworkStatus(false, 'none');
+      expect(mod.isOnline()).toBe(false);
+
+      const status = mod.getOfflineQueueStatus();
+      expect(status.isOnline).toBe(false);
+      expect(status.networkType).toBe('none');
+
+      // 中文与英文横幅文案
+      const zhBanner = mod.formatOfflineBannerText('zh', 2);
+      expect(zhBanner).toContain('网络已断开');
+      expect(zhBanner).toContain('2 条暂存待同步');
+
+      const enBanner = mod.formatOfflineBannerText('en', 3);
+      expect(enBanner).toContain('Offline');
+      expect(enBanner).toContain('3 pending');
+
+      const arBanner = mod.formatOfflineBannerText('ar', 1);
+      expect(arBanner).toContain('غير متصل');
+    });
+  });
+
+  describe('2. 离线动作暂存入队 (enqueueOfflineAction)', () => {
+    it('应能正确保存离线留资或轨迹提交动作至本地队列', () => {
+      const action = {
+        id: 'action-001',
+        type: 'LEAD_SUBMIT',
+        url: '/card/lead/submit',
+        method: 'POST',
+        data: { name: 'Faisal Al-Otaibi', email: 'faisal@sauditech.sa' },
+        timestamp: Date.now(),
+      };
+
+      const count = mod.enqueueOfflineAction(action);
+      expect(count).toBe(1);
+
+      const queue = mod.getOfflineQueue();
+      expect(queue.length).toBe(1);
+      expect(queue[0].id).toBe('action-001');
+      expect(queue[0].type).toBe('LEAD_SUBMIT');
+      expect(queue[0].retryCount).toBe(0);
+    });
+
+    it('支持多次入队并保持先进先出 (FIFO) 顺序', () => {
+      mod.enqueueOfflineAction({
+        id: 'act-1',
+        type: 'RADAR_TRACK',
+        url: '/crm/radar/track',
+        timestamp: 1000,
+      });
+      mod.enqueueOfflineAction({
+        id: 'act-2',
+        type: 'LEAD_SUBMIT',
+        url: '/crm/lead/create',
+        timestamp: 2000,
+      });
+
+      const queue = mod.getOfflineQueue();
+      expect(queue.length).toBe(2);
+      expect(queue[0].id).toBe('act-1');
+      expect(queue[1].id).toBe('act-2');
+    });
+
+    it('自动生成缺失的 action.id 与 timestamp', () => {
+      mod.enqueueOfflineAction({
+        type: 'RADAR_TRACK',
+        url: '/crm/radar/ping',
+      });
+
+      const queue = mod.getOfflineQueue();
+      expect(queue.length).toBe(1);
+      expect(queue[0].id).toBeDefined();
+      expect(queue[0].id.length).toBeGreaterThan(0);
+      expect(queue[0].timestamp).toBeGreaterThan(0);
+    });
+  });
+
+  describe('3. 网络恢复自动重放队列 (replayOfflineQueue)', () => {
+    it('成功执行所有队列动作后应自动清空队列', async () => {
+      mod.enqueueOfflineAction({
+        id: 'act-success-1',
+        type: 'LEAD_SUBMIT',
+        url: '/card/lead/submit',
+        data: { test: 1 },
+      });
+      mod.enqueueOfflineAction({
+        id: 'act-success-2',
+        type: 'RADAR_TRACK',
+        url: '/crm/radar/track',
+        data: { test: 2 },
+      });
+
+      expect(mod.getOfflineQueue().length).toBe(2);
+
+      const executedIds: string[] = [];
+      const result = await mod.replayOfflineQueue(async (item: any) => {
+        executedIds.push(item.id);
+        return true;
+      });
+
+      expect(result.total).toBe(2);
+      expect(result.success).toBe(2);
+      expect(result.failed).toBe(0);
+      expect(executedIds).toEqual(['act-success-1', 'act-success-2']);
+      expect(mod.getOfflineQueue().length).toBe(0);
+    });
+
+    it('重放部分失败时应增加重试次数并保留失败项在队列中', async () => {
+      mod.enqueueOfflineAction({
+        id: 'act-ok',
+        type: 'LEAD_SUBMIT',
+        url: '/api/ok',
+      });
+      mod.enqueueOfflineAction({
+        id: 'act-fail',
+        type: 'LEAD_SUBMIT',
+        url: '/api/fail',
+      });
+
+      const result = await mod.replayOfflineQueue(async (item: any) => {
+        if (item.id === 'act-fail') {
+          return false;
+        }
+        return true;
+      });
+
+      expect(result.total).toBe(2);
+      expect(result.success).toBe(1);
+      expect(result.failed).toBe(1);
+
+      const remaining = mod.getOfflineQueue();
+      expect(remaining.length).toBe(1);
+      expect(remaining[0].id).toBe('act-fail');
+      expect(remaining[0].retryCount).toBe(1);
+    });
+
+    it('超过最大重试次数 (默认 3 次) 时应安全移除死信项，避免永久阻塞', async () => {
+      mod.enqueueOfflineAction({
+        id: 'act-dead',
+        type: 'DEAD_LETTER',
+        url: '/api/dead',
+        retryCount: 3, // 已达上限
+      });
+
+      const result = await mod.replayOfflineQueue(async () => false, 3);
+      expect(result.total).toBe(1);
+      expect(result.failed).toBe(1);
+      expect(mod.getOfflineQueue().length).toBe(0); // 超限后被淘汰
+    });
+  });
+});