核心重构 — 去除 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 设计系统文档 - 测试全面更新覆盖以上所有变更
213 lines
8.7 KiB
TypeScript
213 lines
8.7 KiB
TypeScript
import { describe, expect, it } from 'vitest';
|
|
import { syncWithICloud, MockICloudFileSystem } from '../src/services/sync/icloudSync';
|
|
import { setupDailyReminder, setupCreditCardReminder, cancelAllReminders, MockNotificationScheduler } from '../src/services/reminder';
|
|
import { exportRules, importRules, parseRuleBundle, mergeRules, validateRule, ruleBundleChecksum, MockRuleFileSync, type RuleBundle } from '../src/services/ruleSync';
|
|
import { isTransactionIntent, processChatMessage, createConversation, appendMessage } from '../src/ai/chatAssistant';
|
|
import type { AiProvider, ChatMessage } from '../src/domain/ai';
|
|
import { calculateMonthlyStats, generatePlainTextSummary } from '../src/ai/monthlySummary';
|
|
import { groupByMonth, groupByCategory, dailyExpenseMap } from '../src/domain/chartStats';
|
|
import type { Transaction, Rule } from '../src/domain/types';
|
|
import type { CreditCard } from '../src/domain/creditCards';
|
|
|
|
const tx = (over: Partial<Transaction>): Transaction => ({
|
|
id: 't1', date: '2026-07-10', flag: '*', postings: [], tags: [], links: [], source: 'mobile.bean', raw: '',
|
|
...over,
|
|
});
|
|
|
|
const sampleTx: Transaction[] = [
|
|
tx({ id: 't1', date: '2026-07-05', postings: [{ account: 'Assets:Alipay', amount: '-100', currency: 'CNY' }, { account: 'Expenses:Food', amount: '100', currency: 'CNY' }] }),
|
|
tx({ id: 't2', date: '2026-07-10', postings: [{ account: 'Assets:Bank', amount: '5000', currency: 'CNY' }, { account: 'Income:Salary', amount: '-5000', currency: 'CNY' }] }),
|
|
];
|
|
|
|
class MockProvider implements AiProvider {
|
|
constructor(public readonly config: { id: string; name: string; apiKey: string; baseUrl: string; model: string }, public responses: string[] = []) {}
|
|
async chat(_messages: ChatMessage[] | Parameters<AiProvider['chat']>[0]): Promise<string> {
|
|
return this.responses.shift() ?? 'AI 回复';
|
|
}
|
|
}
|
|
|
|
// ============ icloudSync ============
|
|
|
|
describe('icloudSync', () => {
|
|
it('iCloud 不可用 → unavailable', async () => {
|
|
const fs = new MockICloudFileSystem();
|
|
fs.available = false;
|
|
const result = await syncWithICloud(fs, 'local', '2026-01-01');
|
|
expect(result.action).toBe('unavailable');
|
|
});
|
|
|
|
it('首次(远程无文件)→ pushed', async () => {
|
|
const fs = new MockICloudFileSystem();
|
|
const result = await syncWithICloud(fs, 'local-content', '2026-01-01');
|
|
expect(result.action).toBe('pushed');
|
|
});
|
|
|
|
it('内容相同 → noop', async () => {
|
|
const fs = new MockICloudFileSystem();
|
|
fs.setRemoteFile('mobile.bean', 'same', '2026-01-01');
|
|
const result = await syncWithICloud(fs, 'same', '2026-01-01');
|
|
expect(result.action).toBe('noop');
|
|
});
|
|
|
|
it('远程有更新 → pulled', async () => {
|
|
const fs = new MockICloudFileSystem();
|
|
fs.setRemoteFile('mobile.bean', 'remote-new', '2026-07-14');
|
|
const result = await syncWithICloud(fs, 'local', '2026-01-01');
|
|
expect(result.action).toBe('pulled');
|
|
});
|
|
|
|
it('本地有更新 → pushed', async () => {
|
|
const fs = new MockICloudFileSystem();
|
|
fs.setRemoteFile('mobile.bean', 'old', '2020-01-01');
|
|
const result = await syncWithICloud(fs, 'new-local', '2026-07-14');
|
|
expect(result.action).toBe('pushed');
|
|
});
|
|
});
|
|
|
|
// ============ reminder ============
|
|
|
|
describe('reminder', () => {
|
|
it('setupDailyReminder 调度每日提醒', async () => {
|
|
const scheduler = new MockNotificationScheduler();
|
|
const id = await setupDailyReminder(scheduler, 20, 0);
|
|
expect(id).toBeTruthy();
|
|
expect(scheduler.scheduled).toHaveLength(1);
|
|
expect(scheduler.scheduled[0].hour).toBe(20);
|
|
});
|
|
|
|
it('setupCreditCardReminder 调度账单日+还款日提醒', async () => {
|
|
const scheduler = new MockNotificationScheduler();
|
|
const card: CreditCard = { id: 'c1', name: '招行', lastFour: '1234', bankName: 'CMB', billingDay: 5, paymentDay: 25, creditLimit: '10000', currency: 'CNY', linkedAccount: 'Liabilities:CreditCard:CMB' };
|
|
const ids = await setupCreditCardReminder(scheduler, card);
|
|
expect(ids).toHaveLength(2); // 账单日 + 还款日
|
|
expect(scheduler.scheduled).toHaveLength(2);
|
|
});
|
|
|
|
it('cancelAllReminders 清空', async () => {
|
|
const scheduler = new MockNotificationScheduler();
|
|
await setupDailyReminder(scheduler);
|
|
await cancelAllReminders(scheduler);
|
|
expect(scheduler.scheduled).toHaveLength(0);
|
|
});
|
|
});
|
|
|
|
// ============ ruleSync ============
|
|
|
|
describe('ruleSync', () => {
|
|
const rules: Rule[] = [
|
|
{ id: 'r1', priority: 10, sourceAccount: 'Assets:Alipay', categoryAccount: 'Expenses:Food', hits: 0 },
|
|
{ id: 'r2', priority: 5, sourceAccount: 'Assets:Bank', categoryAccount: 'Expenses:Transport', hits: 0 },
|
|
];
|
|
|
|
it('exportRules 写入 JSON', async () => {
|
|
const fs = new MockRuleFileSync();
|
|
await exportRules(rules, undefined, fs, '/tmp/rules.json');
|
|
expect(fs.files.has('/tmp/rules.json')).toBe(true);
|
|
const content = fs.files.get('/tmp/rules.json')!;
|
|
expect(content).toContain('r1');
|
|
});
|
|
|
|
it('importRules 往返', async () => {
|
|
const fs = new MockRuleFileSync();
|
|
await exportRules(rules, undefined, fs, '/tmp/rules.json');
|
|
const bundle = await importRules(fs, '/tmp/rules.json');
|
|
expect(bundle.rules).toHaveLength(2);
|
|
expect(bundle.version).toBe(1);
|
|
});
|
|
|
|
it('parseRuleBundle 拒绝错误版本', () => {
|
|
expect(() => parseRuleBundle('{"version":99,"rules":[]}')).toThrow('不支持的规则包版本');
|
|
});
|
|
|
|
it('validateRule 校验', () => {
|
|
expect(validateRule({ id: 'x', priority: 1, sourceAccount: 'a', categoryAccount: 'b', hits: 0 })).toBe(true);
|
|
expect(validateRule({ id: 'x' })).toBe(false);
|
|
});
|
|
|
|
it('mergeRules 按 id 去重(导入覆盖)', () => {
|
|
const existing: Rule[] = [{ id: 'r1', priority: 1, sourceAccount: 'A', categoryAccount: 'C', hits: 0 }];
|
|
const imported: Rule[] = [{ id: 'r1', priority: 10, sourceAccount: 'A2', categoryAccount: 'C2', hits: 0 }];
|
|
const merged = mergeRules(existing, imported);
|
|
expect(merged).toHaveLength(1);
|
|
expect(merged[0].priority).toBe(10); // 被覆盖
|
|
});
|
|
|
|
it('ruleBundleChecksum 一致性', () => {
|
|
const bundle: RuleBundle = { version: 1, exportedAt: 'now', rules: [] };
|
|
expect(ruleBundleChecksum(bundle)).toBe(ruleBundleChecksum(bundle));
|
|
});
|
|
});
|
|
|
|
// ============ chatAssistant ============
|
|
|
|
describe('chatAssistant', () => {
|
|
it('isTransactionIntent 识别记账意图', () => {
|
|
expect(isTransactionIntent('买了杯咖啡35元')).toBe(true);
|
|
expect(isTransactionIntent('今天天气不错')).toBe(false);
|
|
expect(isTransactionIntent('消费100')).toBe(true);
|
|
});
|
|
|
|
it('processChatMessage 记账意图返回 bill_card', async () => {
|
|
const provider = new MockProvider({} as never, [JSON.stringify({ type: 'expense', amount: '35', currency: 'CNY', counterparty: '星巴克', narration: '咖啡', time: '2026-07-13' })]);
|
|
const result = await processChatMessage('星巴克花了35', provider);
|
|
expect(result.type).toBe('bill_card');
|
|
expect(result.billCards).toHaveLength(1);
|
|
});
|
|
|
|
it('processChatMessage 非记账意图返回 text', async () => {
|
|
const provider = new MockProvider({} as never, ['这是AI回复']);
|
|
const result = await processChatMessage('你好', provider);
|
|
expect(result.type).toBe('text');
|
|
});
|
|
|
|
it('createConversation + appendMessage', () => {
|
|
const conv = createConversation();
|
|
const conv2 = appendMessage(conv, { role: 'user', content: 'hello' });
|
|
expect(conv2.messages).toHaveLength(1);
|
|
});
|
|
});
|
|
|
|
// ============ monthlySummary ============
|
|
|
|
describe('monthlySummary', () => {
|
|
it('calculateMonthlyStats', () => {
|
|
const stats = calculateMonthlyStats(sampleTx, 2026, 7);
|
|
expect(stats.totalExpense).toBe('100');
|
|
expect(stats.totalIncome).toBe('5000');
|
|
expect(stats.transactionCount).toBe(2);
|
|
});
|
|
|
|
it('generatePlainTextSummary 含统计数据', () => {
|
|
const stats = calculateMonthlyStats(sampleTx, 2026, 7);
|
|
const text = generatePlainTextSummary(stats);
|
|
expect(text).toContain('2026年7月');
|
|
expect(text).toContain('100');
|
|
expect(text).toContain('5000');
|
|
});
|
|
});
|
|
|
|
// ============ charts 纯函数 ============
|
|
|
|
describe('charts 纯函数', () => {
|
|
it('groupByMonth', () => {
|
|
const data = groupByMonth(sampleTx);
|
|
expect(data).toHaveLength(1);
|
|
expect(data[0].month).toBe('2026-07');
|
|
expect(data[0].expense).toBe(100);
|
|
expect(data[0].income).toBe(5000);
|
|
});
|
|
|
|
it('groupByCategory', () => {
|
|
const data = groupByCategory(sampleTx);
|
|
expect(data.length).toBeGreaterThan(0);
|
|
expect(data[0].category).toContain('Food');
|
|
expect(data[0].percentage).toBe(100); // 只有一个支出分类
|
|
});
|
|
|
|
it('dailyExpenseMap', () => {
|
|
const map = dailyExpenseMap(sampleTx);
|
|
expect(map.get('2026-07-05')).toBe(100);
|
|
expect(map.has('2026-07-10')).toBe(false); // 工资不是 Expenses
|
|
});
|
|
});
|