feat: 同步管理端、用户端与后端业务,并接通线上 Web 接口

补齐平台订阅、外部登录、CRM 同步与用户端页面;Nginx 转发用户端接口,登录页使用 Google 与 Apple 标志。

Co-authored-by: Cursor <cursoragent@cursor.com>
这个提交包含在:
wikiboss
2026-09-23 18:01:47 +08:00
父节点 8ea9c25386
当前提交 62e0ae4435
共有 227 个文件被更改,包括 21855 次插入 和 5264 次删除

查看文件

@@ -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);
});
});