核心重构 — 去除 channel 字段,引入 sourceAccount 模型: - 从 ImportedEvent、Rule、EnhancedRule、OcrRule 等接口中彻底移除 channel 字段 - rules.ts 中 resolveChannelAccount → resolveSourceAccount,规则匹配与账户解析不再依赖渠道概念 - dedup.ts 重写去重逻辑:从基于渠道匹配改为基于交易对手(counterparty)匹配,支持相同金额/交易对手/时间窗口的多级置信度判断 - transferRecognizer.ts 增加资产负债表账户校验,确保转账双方均为 Assets/Liabilities 类账户 - 全局替换影响:types、rules、ocr、adapters、adapters-migrations、所有服务层和测试 新增基础设施: - domain/constants.ts — 统一常量定义(支付包名、截图关键词、去重参数、方向检测函数 detectDirection()),消除 OCR/SMS/截图等模块的重复定义 - domain/channelConfig.ts — 渠道配置系统(支付宝/微信/银行),支持按包名和名称查找 - domain/pipelineSingleton.ts — 共享 BillPipeline 单例,解决 importStore/automationStore 的互斥锁共享问题 - domain/transactionBuilder.ts — 统一交易构建入口 buildAndSaveTransaction(),同时服务手动录入和无障碍监听 OCR 增强: - 新增账单详情页解析(parseDetailPageBill),支持支付宝/微信详情页结构化提取 - checkIsDetailPage() 识别详情页特征词,防止误提取(如"消费1次"被误读为金额) - 金额正则支持千分位逗号分隔,商户名正则改用 lookahead 边界匹配 - 时间解析支持中文格式(年月日)和跨年推断 - OcrProcessor 新增详情页路由,跳过 Layer 1 规则匹配 UI 全面升级: - 主题重设计:accent 色从绿色改为靛蓝(#4F46E5),深色模式适配 OLED 纯黑,引入 Quicksand/Caveat 字体 - 新增 commonStyles.ts 统一 chip/input/modal 等通用样式 - 首页 Bento 网格布局:净资产英雄卡片 + 定期账单/月度统计并排展示 - 报表新增周报标签页,月报整合日历视图(支持点击查看当日交易明细) - TrendLine 图表从 View 条形图重写为 SVG 贝塞尔曲线 - CategoryPicker 从水平滚动改为 4 列网格 + emoji 图标 - Button/Card 增加 press 缩放动画 管道与自动化改进: - automationPipeline.ts 新增 handleIncomingBillEvent() 实时账单处理(悬浮账单卡片 + 前台 Alert 确认) - 新增无障碍文本直解析 parseAndProcessAccessibilityTexts(),微信/支付宝详情页绕过 OCR - rules.ts 新增智能还款检测(花呗/信用卡还款自动路由)和退款视为收入处理 - metadataStore 默认规则精简为 6 条通用规则,移除约 20 条个人化硬编码规则 存储与同步: - storePersistence.ts 原子写入 + 崩溃恢复 + 重试机制 - 备份升级到 v2 格式,包含 settings 和 metadata - 同步路径统一从 mobile.bean 改为 main.bean - _layout.tsx 启动时自动迁移旧 mobile.bean 到 main.bean 其他: - 删除独立日历页面,功能合并到报表月报标签 - i18n 清理:移除渠道相关翻译,新增 50+ 翻译键 - docs/android-build-guide.md 重写为 APK 体积优化指南 - 新增 design-system/beancount-mobile/MASTER.md 设计系统文档 - 测试全面更新覆盖以上所有变更
104 lines
3.6 KiB
TypeScript
104 lines
3.6 KiB
TypeScript
import { describe, expect, it, vi, beforeEach } from 'vitest';
|
||
|
||
/**
|
||
* FileSystemBackend 逻辑测试。
|
||
*
|
||
* 由于 expo-file-system 在测试环境不可用,我们 mock 它的接口,
|
||
* 验证 FileSystemBackend 的 read/writeAtomic/recoverIfNeeded 编排逻辑正确。
|
||
*/
|
||
|
||
// Mock expo-file-system/legacy(fileSystemBackend.ts 用 import * as,所以直接导出属性)
|
||
const mockFs = {
|
||
documentDirectory: '/mock/',
|
||
getInfoAsync: vi.fn(),
|
||
readAsStringAsync: vi.fn(),
|
||
writeAsStringAsync: vi.fn(),
|
||
deleteAsync: vi.fn(),
|
||
moveAsync: vi.fn(),
|
||
};
|
||
|
||
vi.mock('expo-file-system/legacy', () => mockFs);
|
||
|
||
// Mock logger
|
||
vi.mock('../src/utils/logger', () => ({
|
||
logger: { info: vi.fn(), error: vi.fn(), warn: vi.fn() },
|
||
}));
|
||
|
||
// 延迟导入(vi.mock 需要在模块加载前执行)
|
||
const { FileSystemBackend } = await import('../src/services/fileSystemBackend');
|
||
|
||
function resetMock() {
|
||
mockFs.getInfoAsync.mockReset();
|
||
mockFs.readAsStringAsync.mockReset();
|
||
mockFs.writeAsStringAsync.mockReset();
|
||
mockFs.deleteAsync.mockReset();
|
||
mockFs.moveAsync.mockReset();
|
||
}
|
||
|
||
describe('FileSystemBackend', () => {
|
||
beforeEach(resetMock);
|
||
|
||
it('read() 返回文件内容', async () => {
|
||
mockFs.getInfoAsync.mockResolvedValue({ exists: true });
|
||
mockFs.readAsStringAsync.mockResolvedValue('2026-01-01 *\n Assets:Bank');
|
||
|
||
const backend = new FileSystemBackend();
|
||
const content = await backend.read();
|
||
expect(content).toBe('2026-01-01 *\n Assets:Bank');
|
||
});
|
||
|
||
it('read() 文件不存在时返回空串', async () => {
|
||
mockFs.getInfoAsync.mockResolvedValue({ exists: false });
|
||
|
||
const backend = new FileSystemBackend();
|
||
const content = await backend.read();
|
||
expect(content).toBe('');
|
||
});
|
||
|
||
it('writeAtomic() 先写 tmp 再删旧文件再 rename', async () => {
|
||
mockFs.getInfoAsync.mockResolvedValue({ exists: true });
|
||
mockFs.writeAsStringAsync.mockResolvedValue(undefined);
|
||
mockFs.deleteAsync.mockResolvedValue(undefined);
|
||
mockFs.moveAsync.mockResolvedValue(undefined);
|
||
|
||
const backend = new FileSystemBackend();
|
||
await backend.writeAtomic('new content');
|
||
|
||
// 验证写入 tmp
|
||
expect(mockFs.writeAsStringAsync).toHaveBeenCalledWith('/mock/mobile.bean.tmp', 'new content');
|
||
// 验证 rename tmp → 正式文件(覆盖旧文件,无需删除)
|
||
expect(mockFs.moveAsync).toHaveBeenCalledWith({ from: '/mock/mobile.bean.tmp', to: '/mock/mobile.bean' });
|
||
});
|
||
|
||
it('writeAtomic() 旧文件不存在时不删除', async () => {
|
||
mockFs.getInfoAsync.mockResolvedValue({ exists: false });
|
||
mockFs.writeAsStringAsync.mockResolvedValue(undefined);
|
||
mockFs.moveAsync.mockResolvedValue(undefined);
|
||
|
||
const backend = new FileSystemBackend();
|
||
await backend.writeAtomic('content');
|
||
|
||
expect(mockFs.deleteAsync).not.toHaveBeenCalled();
|
||
expect(mockFs.moveAsync).toHaveBeenCalled();
|
||
});
|
||
|
||
it('recoverIfNeeded() 检测到 tmp 残留时清理并返回 true', async () => {
|
||
// 第一次 getInfoAsync(检测 tmp)返回存在
|
||
mockFs.getInfoAsync.mockResolvedValue({ exists: true });
|
||
mockFs.deleteAsync.mockResolvedValue(undefined);
|
||
|
||
const backend = new FileSystemBackend();
|
||
const result = await backend.recoverIfNeeded();
|
||
expect(result).toBe(true);
|
||
expect(mockFs.deleteAsync).toHaveBeenCalledWith('/mock/mobile.bean.tmp', { idempotent: true });
|
||
});
|
||
|
||
it('recoverIfNeeded() 无 tmp 残留时返回 false', async () => {
|
||
mockFs.getInfoAsync.mockResolvedValue({ exists: false });
|
||
|
||
const backend = new FileSystemBackend();
|
||
const result = await backend.recoverIfNeeded();
|
||
expect(result).toBe(false);
|
||
});
|
||
});
|