feat: 同步管理端、用户端与后端业务,并接通线上 Web 接口
补齐平台订阅、外部登录、CRM 同步与用户端页面;Nginx 转发用户端接口,登录页使用 Google 与 Apple 标志。 Co-authored-by: Cursor <cursoragent@cursor.com>
这个提交包含在:
@@ -48,8 +48,25 @@ type UseScanModule = {
|
||||
) => Promise<NFCRecordFixture>;
|
||||
startScan: (state: ScanState) => boolean;
|
||||
createScanState: () => ScanState;
|
||||
buildNdefUri: (cardId: string | number | null | undefined) => string;
|
||||
writeNdefToTag: (uri: string | null | undefined) => Promise<boolean>;
|
||||
resolveScanText: (key: string) => string;
|
||||
};
|
||||
|
||||
type NdefWriteOption = {
|
||||
uris?: string[];
|
||||
records?: unknown[];
|
||||
success?: () => void;
|
||||
fail?: (err: { errMsg?: string }) => void;
|
||||
};
|
||||
|
||||
const WRITE_SUCCESS_TOAST_RE =
|
||||
/已写入(?!失败)|写入成功|Written to tag|Write successful/i;
|
||||
|
||||
function assertNoWriteSuccessToast(toasts: UniToastOption[]): void {
|
||||
expect(toasts.some(t => WRITE_SUCCESS_TOAST_RE.test(t.title))).toBe(false);
|
||||
}
|
||||
|
||||
type UniToastOption = {
|
||||
title: string;
|
||||
icon?: string;
|
||||
@@ -91,6 +108,8 @@ describe('OmniCard AI 名片主 NFC 贴卡激活业务逻辑测试 (useScan.uts)
|
||||
let toastCalls: UniToastOption[];
|
||||
let lastRequestOptions: UniRequestOption | null;
|
||||
let requestCallCount: number;
|
||||
let writeNdefCalls: NdefWriteOption[];
|
||||
let writeMode: 'success' | 'fail' | 'cancel' | 'noAdapter' | 'noWriteApi';
|
||||
let mockRequestResponse: {
|
||||
statusCode?: number;
|
||||
data?: {
|
||||
@@ -106,6 +125,8 @@ describe('OmniCard AI 名片主 NFC 贴卡激活业务逻辑测试 (useScan.uts)
|
||||
toastCalls = [];
|
||||
lastRequestOptions = null;
|
||||
requestCallCount = 0;
|
||||
writeNdefCalls = [];
|
||||
writeMode = 'success';
|
||||
mockRequestResponse = {
|
||||
statusCode: 200,
|
||||
data: {
|
||||
@@ -125,6 +146,39 @@ describe('OmniCard AI 名片主 NFC 贴卡激活业务逻辑测试 (useScan.uts)
|
||||
},
|
||||
reLaunch: jest.fn(),
|
||||
getLocale: () => 'zh-CN',
|
||||
getNFCAdapter: () => {
|
||||
if (writeMode === 'noAdapter') {
|
||||
return null;
|
||||
}
|
||||
return {
|
||||
startDiscovery: (opts: {
|
||||
success?: () => void;
|
||||
fail?: (err: { errMsg?: string }) => void;
|
||||
}) => {
|
||||
opts.fail?.({ errMsg: 'startDiscovery:fail' });
|
||||
},
|
||||
onDiscovered: () => {},
|
||||
getNdef: () => {
|
||||
if (writeMode === 'noWriteApi') {
|
||||
return null;
|
||||
}
|
||||
return {
|
||||
writeNdefMessage: (opts: NdefWriteOption) => {
|
||||
writeNdefCalls.push(opts);
|
||||
if (writeMode === 'success') {
|
||||
opts.success?.();
|
||||
return;
|
||||
}
|
||||
if (writeMode === 'cancel') {
|
||||
opts.fail?.({ errMsg: 'writeNdefMessage:fail cancel' });
|
||||
return;
|
||||
}
|
||||
opts.fail?.({ errMsg: 'writeNdefMessage:fail' });
|
||||
},
|
||||
};
|
||||
},
|
||||
};
|
||||
},
|
||||
request: (options: UniRequestOption) => {
|
||||
requestCallCount += 1;
|
||||
lastRequestOptions = options;
|
||||
@@ -282,9 +336,10 @@ describe('OmniCard AI 名片主 NFC 贴卡激活业务逻辑测试 (useScan.uts)
|
||||
});
|
||||
|
||||
describe('4. startScan 不伪造成功', () => {
|
||||
it('4.1 调不到原生 NFC 时回退手动输入且不发激活请求', () => {
|
||||
it('4.1 天线 API 不可用时失败回退手动输入,不伪造成功、不发激活请求', () => {
|
||||
const { createScanState, startScan } = loadUseScan();
|
||||
const state = createScanState();
|
||||
const uidBefore = state.uid;
|
||||
|
||||
const ok = startScan(state);
|
||||
|
||||
@@ -292,8 +347,161 @@ describe('OmniCard AI 名片主 NFC 贴卡激活业务逻辑测试 (useScan.uts)
|
||||
expect(state.manualInput).toBe(true);
|
||||
expect(state.scanning).toBe(false);
|
||||
expect(state.record).toBeNull();
|
||||
expect(state.uid).toBe(uidBefore);
|
||||
expect(state.errorMessage.length).toBeGreaterThan(0);
|
||||
expect(requestCallCount).toBe(0);
|
||||
});
|
||||
|
||||
it('4.2 源码契约:APP 块尝试官方 getNFCAdapter 读 UID,成功仅在拿到合法 UID', () => {
|
||||
const logicSource = fs.readFileSync(SCAN_UTS, 'utf8');
|
||||
const startScanBlock = logicSource.slice(
|
||||
logicSource.indexOf('export function startScan'),
|
||||
logicSource.indexOf('export function resolveStatusLine')
|
||||
);
|
||||
|
||||
expect(logicSource.includes('#ifdef APP')).toBe(true);
|
||||
expect(logicSource.includes('getNFCAdapter')).toBe(true);
|
||||
expect(logicSource.includes('startDiscovery') || logicSource.includes('onDiscovered')).toBe(
|
||||
true
|
||||
);
|
||||
expect(startScanBlock.includes('parseUid')).toBe(true);
|
||||
expect(startScanBlock.includes('state.uid')).toBe(true);
|
||||
expect(startScanBlock.includes('return true')).toBe(true);
|
||||
expect(startScanBlock.includes('manualInput = true')).toBe(true);
|
||||
expect(startScanBlock.includes('return false')).toBe(true);
|
||||
// 禁止在 startScan 内硬编码伪造芯片 UID
|
||||
expect(/state\.uid\s*=\s*['"][0-9A-Fa-f:]+['"]/.test(startScanBlock)).toBe(false);
|
||||
expect(startScanBlock.includes('Native NFC antenna is not wired')).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
describe('5. writeNdefToTag 仅系统写入 API 成功才 toast 已写入', () => {
|
||||
it('5.1 buildNdefUri 无合法 cardId 时返回空串', () => {
|
||||
const { buildNdefUri } = loadUseScan();
|
||||
|
||||
expect(buildNdefUri(null)).toBe('');
|
||||
expect(buildNdefUri(undefined)).toBe('');
|
||||
expect(buildNdefUri('')).toBe('');
|
||||
expect(buildNdefUri(0)).toBe('');
|
||||
expect(buildNdefUri(-1)).toBe('');
|
||||
expect(buildNdefUri(12)).toBe('https://omnicard.ai/c/12');
|
||||
expect(buildNdefUri(' 8 ')).toBe('https://omnicard.ai/c/8');
|
||||
});
|
||||
|
||||
it('5.2 写入 API 成功才 toast 已写入', async () => {
|
||||
const { writeNdefToTag, resolveScanText } = loadUseScan();
|
||||
toastCalls = [];
|
||||
writeMode = 'success';
|
||||
|
||||
const ok = await writeNdefToTag('https://omnicard.ai/c/12');
|
||||
|
||||
expect(ok).toBe(true);
|
||||
expect(writeNdefCalls.length).toBe(1);
|
||||
expect(writeNdefCalls[0].uris).toEqual(['https://omnicard.ai/c/12']);
|
||||
expect(
|
||||
toastCalls.some(t => t.title === resolveScanText('writeSuccess'))
|
||||
).toBe(true);
|
||||
expect(WRITE_SUCCESS_TOAST_RE.test(resolveScanText('writeSuccess'))).toBe(
|
||||
true
|
||||
);
|
||||
});
|
||||
|
||||
it('5.3 无可写内容不调写入 API,不 toast 已写入', async () => {
|
||||
const { writeNdefToTag, resolveScanText } = loadUseScan();
|
||||
toastCalls = [];
|
||||
|
||||
const ok = await writeNdefToTag(' ');
|
||||
|
||||
expect(ok).toBe(false);
|
||||
expect(writeNdefCalls.length).toBe(0);
|
||||
assertNoWriteSuccessToast(toastCalls);
|
||||
expect(
|
||||
toastCalls.some(t => t.title === resolveScanText('writeUnavailable'))
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
it('5.4 天线/Adapter 不可用时不 toast 已写入', async () => {
|
||||
const { writeNdefToTag, resolveScanText } = loadUseScan();
|
||||
writeMode = 'noAdapter';
|
||||
toastCalls = [];
|
||||
|
||||
const ok = await writeNdefToTag('https://omnicard.ai/c/12');
|
||||
|
||||
expect(ok).toBe(false);
|
||||
expect(writeNdefCalls.length).toBe(0);
|
||||
assertNoWriteSuccessToast(toastCalls);
|
||||
expect(
|
||||
toastCalls.some(t => t.title === resolveScanText('writeFailed'))
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
it('5.5 无 writeNdefMessage 能力时不 toast 已写入', async () => {
|
||||
const { writeNdefToTag, resolveScanText } = loadUseScan();
|
||||
writeMode = 'noWriteApi';
|
||||
toastCalls = [];
|
||||
|
||||
const ok = await writeNdefToTag('https://omnicard.ai/c/12');
|
||||
|
||||
expect(ok).toBe(false);
|
||||
expect(writeNdefCalls.length).toBe(0);
|
||||
assertNoWriteSuccessToast(toastCalls);
|
||||
expect(
|
||||
toastCalls.some(t => t.title === resolveScanText('writeFailed'))
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
it('5.6 用户取消写入不 toast 已写入', async () => {
|
||||
const { writeNdefToTag, resolveScanText } = loadUseScan();
|
||||
writeMode = 'cancel';
|
||||
toastCalls = [];
|
||||
|
||||
const ok = await writeNdefToTag('https://omnicard.ai/c/12');
|
||||
|
||||
expect(ok).toBe(false);
|
||||
expect(writeNdefCalls.length).toBe(1);
|
||||
assertNoWriteSuccessToast(toastCalls);
|
||||
expect(
|
||||
toastCalls.some(t => t.title === resolveScanText('writeCancelled'))
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
it('5.7 写入失败不 toast 已写入', async () => {
|
||||
const { writeNdefToTag, resolveScanText } = loadUseScan();
|
||||
writeMode = 'fail';
|
||||
toastCalls = [];
|
||||
|
||||
const ok = await writeNdefToTag('https://omnicard.ai/c/12');
|
||||
|
||||
expect(ok).toBe(false);
|
||||
expect(writeNdefCalls.length).toBe(1);
|
||||
assertNoWriteSuccessToast(toastCalls);
|
||||
expect(
|
||||
toastCalls.some(t => t.title === resolveScanText('writeFailed'))
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
it('5.8 源码契约:writeSuccess 仅出现在 writeNdefMessage 的 success 回调内', () => {
|
||||
const logicSource = fs.readFileSync(SCAN_UTS, 'utf8');
|
||||
const writeIdx = logicSource.indexOf('ndef.writeNdefMessage(');
|
||||
expect(writeIdx).toBeGreaterThan(-1);
|
||||
|
||||
const successIdx = logicSource.indexOf('success:', writeIdx);
|
||||
expect(successIdx).toBeGreaterThan(writeIdx);
|
||||
const successBody = logicSource.slice(successIdx, successIdx + 220);
|
||||
expect(successBody.includes('writeSuccess')).toBe(true);
|
||||
|
||||
const failIdx = logicSource.indexOf('fail:', successIdx);
|
||||
expect(failIdx).toBeGreaterThan(successIdx);
|
||||
const failBody = logicSource.slice(failIdx, failIdx + 360);
|
||||
expect(failBody.includes('writeSuccess')).toBe(false);
|
||||
expect(WRITE_SUCCESS_TOAST_RE.test(failBody)).toBe(false);
|
||||
expect(
|
||||
failBody.includes('writeFailed') ||
|
||||
failBody.includes('writeCancelled') ||
|
||||
failBody.includes('toastWriteFailed') ||
|
||||
failBody.includes('toastWriteCancelled')
|
||||
).toBe(true);
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
@@ -338,4 +546,26 @@ describe('OmniCard AI 名片主 NFC 贴卡激活页契约 (scan.uvue)', () => {
|
||||
false
|
||||
);
|
||||
});
|
||||
|
||||
it('主流程走 writeNdefToTag,失败路径无已写入文案,不把云端绑定冒充芯片写入', () => {
|
||||
const pageSource = fs.readFileSync(SCAN_PAGE, 'utf8');
|
||||
const logicSource = fs.readFileSync(SCAN_UTS, 'utf8');
|
||||
|
||||
expect(logicSource.includes('writeNdefToTag')).toBe(true);
|
||||
expect(logicSource.includes('writeNdefMessage')).toBe(true);
|
||||
expect(pageSource.includes('writeNdefToTag')).toBe(true);
|
||||
expect(pageSource.includes('buildNdefUri')).toBe(true);
|
||||
|
||||
expect(pageSource.includes('已写入')).toBe(false);
|
||||
expect(pageSource.includes('烧录至')).toBe(false);
|
||||
expect(WRITE_SUCCESS_TOAST_RE.test(pageSource)).toBe(false);
|
||||
|
||||
const unavailableIdx = logicSource.indexOf("resolveScanText('writeUnavailable')");
|
||||
expect(unavailableIdx).toBeGreaterThan(-1);
|
||||
const unavailableSlice = logicSource.slice(
|
||||
Math.max(0, unavailableIdx - 80),
|
||||
unavailableIdx + 80
|
||||
);
|
||||
expect(WRITE_SUCCESS_TOAST_RE.test(unavailableSlice)).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
在新工单中引用
屏蔽一个用户