282 行
8.8 KiB
TypeScript
282 行
8.8 KiB
TypeScript
/**
|
|
* OmniCard AI (CRMmp) - 名片主移动潜客列表测试套件 (TDD Red -> Green)
|
|
*
|
|
* 严格按照 AGENTS.md 3.3、4.3、5.1 规范与 pages/owner/leads 设计编写
|
|
*/
|
|
|
|
import * as fs from 'fs';
|
|
import * as path from 'path';
|
|
|
|
const LEADS_PAGE = path.resolve(
|
|
__dirname,
|
|
'../../../mpuniapp/pages/owner/leads.uvue'
|
|
);
|
|
const LEADS_UTS = path.resolve(
|
|
__dirname,
|
|
'../../../mpuniapp/pages/owner/useLeads.uts'
|
|
);
|
|
|
|
type LeadStatus = 'new' | 'contacted' | 'hot' | 'won' | 'archived';
|
|
|
|
type LeadEntity = {
|
|
id: string | number;
|
|
cardId: string | number;
|
|
name: string;
|
|
company?: string;
|
|
status: LeadStatus;
|
|
intentScore: number;
|
|
source: 'nfc' | 'qr' | 'link' | 'ai_chat';
|
|
};
|
|
|
|
type OwnerPageQuery = {
|
|
page: number;
|
|
size: number;
|
|
keyWord?: string;
|
|
status?: LeadStatus;
|
|
};
|
|
|
|
type OwnerPageData<T> = {
|
|
list: T[];
|
|
pagination: {
|
|
page: number;
|
|
size: number;
|
|
total: number;
|
|
};
|
|
};
|
|
|
|
type LoadLeadsQuery = {
|
|
page: number;
|
|
size: number;
|
|
status?: string;
|
|
keyWord?: string;
|
|
};
|
|
|
|
type LoadLeadsApi = {
|
|
fetchOwnerLeadPage: (
|
|
query: OwnerPageQuery
|
|
) => Promise<OwnerPageData<LeadEntity>>;
|
|
};
|
|
|
|
type LoadLeadsResult = {
|
|
list: LeadEntity[];
|
|
pagination: {
|
|
page: number;
|
|
size: number;
|
|
total: number;
|
|
};
|
|
empty: boolean;
|
|
errorMessage: string;
|
|
};
|
|
|
|
type UseLeadsModule = {
|
|
parseLeadStatus: (raw: string | null | undefined) => LeadStatus | null;
|
|
formatHotUnread: (unread: number) => string;
|
|
loadLeads: (
|
|
query: LoadLeadsQuery,
|
|
api?: LoadLeadsApi
|
|
) => Promise<LoadLeadsResult>;
|
|
};
|
|
|
|
const EMOJI_RE = /[\u2600-\u27BF\uFE0F]|[\uD83C-\uDBFF][\uDC00-\uDFFF]/;
|
|
|
|
function buildLead(overrides?: Partial<LeadEntity>): LeadEntity {
|
|
return {
|
|
id: 21,
|
|
cardId: 8,
|
|
name: 'Alex Vance',
|
|
company: 'Nexus Tech',
|
|
status: 'new',
|
|
intentScore: 72,
|
|
source: 'nfc',
|
|
...overrides,
|
|
};
|
|
}
|
|
|
|
function emptyPage(page: number, size: number): OwnerPageData<LeadEntity> {
|
|
return {
|
|
list: [],
|
|
pagination: { page, size, total: 0 },
|
|
};
|
|
}
|
|
|
|
function loadUseLeads(): UseLeadsModule {
|
|
// eslint-disable-next-line @typescript-eslint/no-require-imports
|
|
return require(LEADS_UTS) as UseLeadsModule;
|
|
}
|
|
|
|
describe('OmniCard AI 名片主移动潜客列表 (useLeads.uts)', () => {
|
|
beforeEach(() => {
|
|
jest.resetModules();
|
|
(global as { uni?: Record<string, unknown> }).uni = {
|
|
getLocale: () => 'zh-CN',
|
|
showToast: jest.fn(),
|
|
navigateTo: jest.fn(),
|
|
};
|
|
});
|
|
|
|
afterEach(() => {
|
|
delete (global as { uni?: Record<string, unknown> }).uni;
|
|
});
|
|
|
|
describe('1. loadLeads 调用 page API', () => {
|
|
it('1.1 将 page / size / status / keyWord 交给 fetchOwnerLeadPage', async () => {
|
|
const { loadLeads } = loadUseLeads();
|
|
const lead = buildLead({ status: 'hot', intentScore: 91 });
|
|
const fetchOwnerLeadPage = jest.fn(
|
|
async (query: OwnerPageQuery): Promise<OwnerPageData<LeadEntity>> => {
|
|
expect(query.page).toBe(2);
|
|
expect(query.size).toBe(20);
|
|
expect(query.status).toBe('hot');
|
|
expect(query.keyWord).toBe('Vance');
|
|
return {
|
|
list: [lead],
|
|
pagination: { page: 2, size: 20, total: 1 },
|
|
};
|
|
}
|
|
);
|
|
|
|
const result = await loadLeads(
|
|
{ page: 2, size: 20, status: 'hot', keyWord: 'Vance' },
|
|
{ fetchOwnerLeadPage }
|
|
);
|
|
|
|
expect(fetchOwnerLeadPage).toHaveBeenCalledTimes(1);
|
|
expect(result.list).toHaveLength(1);
|
|
expect(result.list[0].name).toBe('Alex Vance');
|
|
expect(result.list[0].intentScore).toBe(91);
|
|
expect(result.empty).toBe(false);
|
|
expect(result.errorMessage).toBe('');
|
|
expect(result.pagination.total).toBe(1);
|
|
});
|
|
|
|
it('1.2 空列表标记空态，不写错误', async () => {
|
|
const { loadLeads } = loadUseLeads();
|
|
const fetchOwnerLeadPage = jest.fn(
|
|
async (): Promise<OwnerPageData<LeadEntity>> => emptyPage(1, 10)
|
|
);
|
|
|
|
const result = await loadLeads(
|
|
{ page: 1, size: 10 },
|
|
{ fetchOwnerLeadPage }
|
|
);
|
|
|
|
expect(fetchOwnerLeadPage).toHaveBeenCalledTimes(1);
|
|
expect(result.list).toEqual([]);
|
|
expect(result.empty).toBe(true);
|
|
expect(result.errorMessage).toBe('');
|
|
});
|
|
|
|
it('1.3 接口失败写入错误，不伪装空态成功', async () => {
|
|
const { loadLeads } = loadUseLeads();
|
|
const fetchOwnerLeadPage = jest.fn(async (): Promise<OwnerPageData<LeadEntity>> => {
|
|
throw new Error('lead page unavailable');
|
|
});
|
|
|
|
const result = await loadLeads(
|
|
{ page: 1, size: 10, status: 'new' },
|
|
{ fetchOwnerLeadPage }
|
|
);
|
|
|
|
expect(fetchOwnerLeadPage).toHaveBeenCalledTimes(1);
|
|
expect(result.list).toEqual([]);
|
|
expect(result.empty).toBe(false);
|
|
expect(result.errorMessage).toBe('lead page unavailable');
|
|
});
|
|
});
|
|
|
|
describe('2. 非法 status 丢弃', () => {
|
|
it('2.1 parseLeadStatus 只放行契约枚举', () => {
|
|
const { parseLeadStatus } = loadUseLeads();
|
|
|
|
expect(parseLeadStatus('new')).toBe('new');
|
|
expect(parseLeadStatus('contacted')).toBe('contacted');
|
|
expect(parseLeadStatus('hot')).toBe('hot');
|
|
expect(parseLeadStatus('won')).toBe('won');
|
|
expect(parseLeadStatus('archived')).toBe('archived');
|
|
expect(parseLeadStatus('pending')).toBeNull();
|
|
expect(parseLeadStatus('NEW')).toBeNull();
|
|
expect(parseLeadStatus('')).toBeNull();
|
|
expect(parseLeadStatus(null)).toBeNull();
|
|
expect(parseLeadStatus(undefined)).toBeNull();
|
|
});
|
|
|
|
it('2.2 loadLeads 不把非法 status 传给 page API', async () => {
|
|
const { loadLeads } = loadUseLeads();
|
|
const fetchOwnerLeadPage = jest.fn(
|
|
async (query: OwnerPageQuery): Promise<OwnerPageData<LeadEntity>> => {
|
|
expect(query.status).toBeUndefined();
|
|
return emptyPage(query.page, query.size);
|
|
}
|
|
);
|
|
|
|
await loadLeads(
|
|
{ page: 1, size: 10, status: 'pending', keyWord: ' ' },
|
|
{ fetchOwnerLeadPage }
|
|
);
|
|
|
|
expect(fetchOwnerLeadPage).toHaveBeenCalledTimes(1);
|
|
const sent = fetchOwnerLeadPage.mock.calls[0][0] as OwnerPageQuery;
|
|
expect(sent.page).toBe(1);
|
|
expect(sent.size).toBe(10);
|
|
expect(sent.status).toBeUndefined();
|
|
expect(sent.keyWord).toBeUndefined();
|
|
});
|
|
});
|
|
|
|
it('formatHotUnread 有未读才显示红点文案', () => {
|
|
const { formatHotUnread } = loadUseLeads();
|
|
expect(formatHotUnread(0)).toBe('');
|
|
expect(formatHotUnread(2)).toContain('2');
|
|
});
|
|
});
|
|
|
|
describe('OmniCard AI 名片主潜客列表页契约 (leads.uvue)', () => {
|
|
it('页面含 list-view，并引用 fetchOwnerLeadPage 或 loadLeads', () => {
|
|
expect(fs.existsSync(LEADS_PAGE)).toBe(true);
|
|
expect(fs.existsSync(LEADS_UTS)).toBe(true);
|
|
|
|
const pageSource = fs.readFileSync(LEADS_PAGE, 'utf8');
|
|
const logicSource = fs.readFileSync(LEADS_UTS, 'utf8');
|
|
const combined = `${pageSource}\n${logicSource}`;
|
|
|
|
expect(pageSource.includes('<list-view')).toBe(true);
|
|
expect(pageSource.includes('<list-item')).toBe(true);
|
|
expect(pageSource.includes('v-for')).toBe(true);
|
|
expect(
|
|
combined.includes('fetchOwnerLeadPage') || combined.includes('loadLeads')
|
|
).toBe(true);
|
|
expect(pageSource.includes('script setup lang="uts"')).toBe(true);
|
|
expect(pageSource.includes('getOmniText')).toBe(true);
|
|
expect(combined.includes('crm.leads')).toBe(true);
|
|
expect(combined.includes('crm.follow_up')).toBe(true);
|
|
expect(pageSource.includes('leads-detail')).toBe(true);
|
|
expect(pageSource.includes('navigateTo') || logicSource.includes('navigateTo')).toBe(
|
|
true
|
|
);
|
|
expect(pageSource.includes('#0B5CFF')).toBe(true);
|
|
expect(pageSource.includes('#F7F8FA')).toBe(true);
|
|
expect(pageSource.includes('#101828')).toBe(true);
|
|
expect(pageSource.includes('#667085')).toBe(true);
|
|
expect(pageSource.includes('#E3E7ED')).toBe(true);
|
|
expect(pageSource.includes('primary-cta-btn')).toBe(true);
|
|
expect(pageSource.includes('status-chip')).toBe(true);
|
|
expect(combined.includes('hotUnread') || combined.includes('hotInbox')).toBe(true);
|
|
});
|
|
|
|
it('无 emoji、无 any，模板无硬编码中文主文案，长列表不用 view v-for', () => {
|
|
const pageSource = fs.readFileSync(LEADS_PAGE, 'utf8');
|
|
const logicSource = fs.readFileSync(LEADS_UTS, 'utf8');
|
|
const testSource = fs.readFileSync(__filename, 'utf8');
|
|
const template = pageSource.split('<script')[0];
|
|
|
|
expect(EMOJI_RE.test(pageSource)).toBe(false);
|
|
expect(EMOJI_RE.test(logicSource)).toBe(false);
|
|
expect(EMOJI_RE.test(testSource)).toBe(false);
|
|
expect(pageSource.includes(': any') || pageSource.includes(' as any')).toBe(false);
|
|
expect(logicSource.includes(': any') || logicSource.includes(' as any')).toBe(false);
|
|
expect(/[\u4e00-\u9fff]/.test(template)).toBe(false);
|
|
expect(/<view[^>]*v-for/.test(template)).toBe(false);
|
|
expect(template.includes('<list-item')).toBe(true);
|
|
});
|
|
});
|