DriftLedger/tests/maintenance.test.ts
fengmengqi 76a5853ab6 feat: 重构渠道模型与管道架构,全面升级 UI 主题和报表功能
核心重构 — 去除 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 设计系统文档
- 测试全面更新覆盖以上所有变更
2026-07-18 18:02:45 +08:00

131 lines
4.9 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import { describe, expect, it } from 'vitest';
import { MockMaintenanceFs, MockMaintenanceDb, scanOrphanFiles, cleanOrphanFiles, runMaintenance } from '../src/services/maintenance';
import { AiVisionProcessor, MockAiVisionProcessor } from '../src/ocr/AiVisionProcessor';
import { setupDeepLinking, parseDeepLink } from '../src/services/deepLink';
import { generateRemark } from '../src/domain/remarkTemplate';
import type { ImportedEvent } from '../src/domain/types';
const evt = (over: Partial<ImportedEvent> = {}): ImportedEvent => ({
id: 'e1', occurredAt: '2026-07-13T14:30:00', amount: '100', currency: 'CNY', direction: 'expense',
counterparty: '星巴克', memo: '拿铁', raw: { fee: '0.5', tags: 'coffee' },
...over,
});
// ============ maintenance ============
describe('maintenance', () => {
it('scanOrphanFiles 扫描孤立附件', async () => {
const fs = new MockMaintenanceFs();
fs.setFile('/attachments/receipt1.jpg', 1024); // 被引用
fs.setFile('/attachments/orphan.png', 512); // 孤立
fs.setFile('/thumbnails/thumb1.png', 256); // 缩略图
const orphans = await scanOrphanFiles(
fs,
new Set(['/attachments/receipt1.jpg']),
{ attachments: '/attachments', thumbnails: '/thumbnails', cache: '/cache' },
);
expect(orphans).toHaveLength(2); // orphan.png + thumb1.png
expect(orphans.some(o => o.path === '/attachments/orphan.png')).toBe(true);
});
it('cleanOrphanFiles 删除孤立文件', async () => {
const fs = new MockMaintenanceFs();
fs.setFile('/attachments/orphan.png', 512);
const orphans = [{ type: 'attachment' as const, path: '/attachments/orphan.png', size: 512 }];
const cleaned = await cleanOrphanFiles(fs, orphans);
expect(cleaned).toBe(1);
expect(fs.deleted).toContain('/attachments/orphan.png');
});
it('runMaintenance 完整维护', async () => {
const fs = new MockMaintenanceFs();
fs.setFile('/cache/tmp.txt', 100);
const db = new MockMaintenanceDb();
db.issues = ['测试问题'];
const report = await runMaintenance(
fs, db, new Set(),
{ attachments: '/attachments', thumbnails: '/thumbnails', cache: '/cache' },
);
expect(report.cleanedCount).toBe(1); // 清理了 cache/tmp.txt
expect(db.vacuumed).toBe(true);
expect(report.dbIssues).toEqual(['测试问题']);
});
});
// ============ AiVisionProcessor ============
describe('AiVisionProcessor', () => {
it('未启用时返回 null', async () => {
const processor = new AiVisionProcessor({ enabled: false, apiUrl: '', apiKey: '', model: '' });
expect(await processor.recognizeBill('img')).toBeNull();
});
it('Mock 返回预设结果', async () => {
const mock = new MockAiVisionProcessor({
id: 'ai1', occurredAt: '2026-07-13', amount: '50', currency: 'CNY', direction: 'expense',
counterparty: '测试', memo: '', raw: {},
});
const result = await mock.recognizeBill('img');
expect(result?.amount).toBe('50');
});
it('Mock setResponse 切换结果', async () => {
const mock = new MockAiVisionProcessor(null);
expect(await mock.recognizeBill('img')).toBeNull();
mock.setResponse({ id: 'ai2', occurredAt: 'now', amount: '30', currency: 'CNY', direction: 'income', counterparty: '', memo: '', raw: {} });
expect((await mock.recognizeBill('img'))?.direction).toBe('income');
});
});
// ============ deepLink setupDeepLinking ============
describe('deepLink setupDeepLinking', () => {
it('返回清理函数(测试环境降级)', () => {
const cleanup = setupDeepLinking();
expect(typeof cleanup).toBe('function');
cleanup(); // 不抛错
});
it('注入 handler 被调用', () => {
const actions: string[] = [];
const cleanup = setupDeepLinking((action) => actions.push(action.type));
// 测试环境无 Linkinghandler 不会被调用,但 setup 不报错
cleanup();
expect(actions).toHaveLength(0);
});
it('parseDeepLink 仍可用', () => {
expect(parseDeepLink('beanmobile://tab/home')?.type).toBe('open-tab');
});
});
// ============ remarkTemplate 16 占位符 ============
describe('remarkTemplate 完整占位符', () => {
it('商品名称占位符', () => {
const remark = generateRemark('【商品名称】', evt({ memo: '拿铁咖啡' }));
expect(remark).toBe('拿铁咖啡');
});
it('货币类型占位符', () => {
expect(generateRemark('【货币类型】', evt())).toBe('CNY');
});
it('手续费占位符', () => {
expect(generateRemark('手续费【手续费】', evt())).toBe('手续费0.5');
});
it('标签占位符', () => {
expect(generateRemark('标签:【标签】', evt())).toContain('coffee');
});
it('交易类型占位符', () => {
expect(generateRemark('【交易类型】', evt())).toBe('expense');
});
it('多占位符组合', () => {
const remark = generateRemark('【商户名称】【金额】【货币类型】', evt());
expect(remark).toBe('星巴克100CNY');
});
});