核心重构 — 去除 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 设计系统文档 - 测试全面更新覆盖以上所有变更
134 lines
5.5 KiB
TypeScript
134 lines
5.5 KiB
TypeScript
import { describe, expect, it } from 'vitest';
|
||
import { clearFlag, flagsToMetadata, hasFlag, setFlag, shouldCountInBudget, shouldCountInStats, toggleFlag, TransactionFlag } from '../src/domain/transactionFlags';
|
||
import { DEFAULT_FILTER, mergeFilter, passesKeywordFilter } from '../src/domain/keywordFilter';
|
||
import { generateRemark, normalizeAdjacentDuplicates } from '../src/domain/remarkTemplate';
|
||
import { FunctionSandboxExecutor, RuleEngine, type EnhancedRule } from '../src/domain/ruleEngine';
|
||
import type { ImportedEvent } from '../src/domain/types';
|
||
|
||
const evt = (over: Partial<ImportedEvent> = {}): ImportedEvent => ({
|
||
id: 'e1', occurredAt: '2026-02-01T10:00:00', amount: '100', currency: 'CNY', direction: 'expense',
|
||
counterparty: '', memo: '', raw: {},
|
||
...over,
|
||
});
|
||
|
||
describe('transactionFlags', () => {
|
||
it('setFlag / hasFlag', () => {
|
||
let f = TransactionFlag.NONE;
|
||
f = setFlag(f, TransactionFlag.EXCLUDE_FROM_STATS);
|
||
expect(hasFlag(f, TransactionFlag.EXCLUDE_FROM_STATS)).toBe(true);
|
||
expect(hasFlag(f, TransactionFlag.EXCLUDE_FROM_BUDGET)).toBe(false);
|
||
});
|
||
|
||
it('clearFlag', () => {
|
||
let f = setFlag(TransactionFlag.NONE, TransactionFlag.TRANSFER);
|
||
f = clearFlag(f, TransactionFlag.TRANSFER);
|
||
expect(hasFlag(f, TransactionFlag.TRANSFER)).toBe(false);
|
||
});
|
||
|
||
it('toggleFlag', () => {
|
||
let f = TransactionFlag.NONE;
|
||
f = toggleFlag(f, TransactionFlag.RECURRING);
|
||
expect(hasFlag(f, TransactionFlag.RECURRING)).toBe(true);
|
||
f = toggleFlag(f, TransactionFlag.RECURRING);
|
||
expect(hasFlag(f, TransactionFlag.RECURRING)).toBe(false);
|
||
});
|
||
|
||
it('shouldCountInStats / shouldCountInBudget', () => {
|
||
const f = setFlag(TransactionFlag.NONE, TransactionFlag.EXCLUDE_FROM_STATS);
|
||
expect(shouldCountInStats(f)).toBe(false);
|
||
expect(shouldCountInBudget(f)).toBe(true); // 未设置 budget 标志
|
||
});
|
||
|
||
it('flagsToMetadata', () => {
|
||
const f = setFlag(setFlag(TransactionFlag.NONE, TransactionFlag.EXCLUDE_FROM_STATS), TransactionFlag.TRANSFER);
|
||
const meta = flagsToMetadata(f);
|
||
expect(meta['bm-exclude-stats']).toBe('true');
|
||
expect(meta['bm-transfer']).toBe('true');
|
||
expect(meta['bm-recurring']).toBeUndefined();
|
||
});
|
||
});
|
||
|
||
describe('keywordFilter', () => {
|
||
it('账单内容通过', () => {
|
||
expect(passesKeywordFilter('微信支付 24.50元 消费')).toBe(true);
|
||
});
|
||
|
||
it('广告被拒', () => {
|
||
expect(passesKeywordFilter('限时优惠广告')).toBe(false);
|
||
});
|
||
|
||
it('空文本被拒', () => {
|
||
expect(passesKeywordFilter('')).toBe(false);
|
||
});
|
||
|
||
it('mergeFilter 用户优先', () => {
|
||
const merged = mergeFilter({ whitelist: ['自定义'] });
|
||
expect(merged.whitelist).toEqual(['自定义']);
|
||
expect(merged.blacklist).toEqual(DEFAULT_FILTER.blacklist);
|
||
});
|
||
});
|
||
|
||
describe('remarkTemplate', () => {
|
||
it('占位符替换', () => {
|
||
const event = evt({ counterparty: '咖啡店', amount: '24.50' });
|
||
const remark = generateRemark('【商户名称】-【金额】', event);
|
||
expect(remark).toBe('咖啡店-24.50');
|
||
});
|
||
|
||
it('相邻重复归一化', () => {
|
||
expect(normalizeAdjacentDuplicates('买菜买菜')).toBe('买菜');
|
||
expect(normalizeAdjacentDuplicates('京东自营京东自营旗舰店')).toBe('京东自营旗舰店');
|
||
});
|
||
|
||
it('日期/时间占位符', () => {
|
||
const event = evt({ occurredAt: '2026-07-13T14:30:00' });
|
||
expect(generateRemark('【日期】 【时间】', event)).toBe('2026-07-13 14:30');
|
||
});
|
||
});
|
||
|
||
describe('ruleEngine', () => {
|
||
it('静态条件匹配(无 JS)', () => {
|
||
const engine = new RuleEngine();
|
||
const rules: EnhancedRule[] = [{
|
||
id: 'r1', name: '咖啡', priority: 10, enabled: true, isSystem: false,
|
||
counterpartyContains: '咖啡', sourceAccount: 'Assets:Alipay', categoryAccount: 'Expenses:Food', hits: 0,
|
||
}];
|
||
const result = engine.matchEvent(evt({ counterparty: '星巴克咖啡' }), rules);
|
||
expect(result?.rule.id).toBe('r1');
|
||
expect(result?.rule.hits).toBe(1);
|
||
});
|
||
|
||
it('JS 规则执行(命中)', () => {
|
||
const engine = new RuleEngine(new FunctionSandboxExecutor());
|
||
const rules: EnhancedRule[] = [{
|
||
id: 'r1', name: 'JS规则', priority: 10, enabled: true, isSystem: false,
|
||
jsCode: 'print(JSON.stringify({money: data.money, shopName: data.shopName}))',
|
||
sourceAccount: 'Assets:Alipay', categoryAccount: 'Expenses:Food', hits: 0,
|
||
}];
|
||
const result = engine.matchEvent(evt({ amount: '50', counterparty: '测试' }), rules);
|
||
expect(result?.result.matched).toBe(true);
|
||
expect(result?.result.extracted?.shopName).toBe('测试');
|
||
});
|
||
|
||
it('JS 规则不命中(金额 0)', () => {
|
||
const engine = new RuleEngine(new FunctionSandboxExecutor());
|
||
const rules: EnhancedRule[] = [{
|
||
id: 'r1', name: 'JS规则', priority: 10, enabled: true, isSystem: false,
|
||
jsCode: 'print(JSON.stringify({money: 0}))',
|
||
sourceAccount: 'Assets:Alipay', categoryAccount: 'Expenses:Food', hits: 0,
|
||
}];
|
||
const result = engine.matchEvent(evt({ amount: '50' }), rules);
|
||
expect(result).toBeNull();
|
||
});
|
||
|
||
it('用户规则优先于系统规则', () => {
|
||
const engine = new RuleEngine();
|
||
const rules: EnhancedRule[] = [
|
||
{ id: 'sys', name: '系统', priority: 100, enabled: true, isSystem: true, sourceAccount: 'A1', categoryAccount: 'C1', hits: 0 },
|
||
{ id: 'usr', name: '用户', priority: 1, enabled: true, isSystem: false, sourceAccount: 'A2', categoryAccount: 'C2', hits: 0 },
|
||
];
|
||
const result = engine.matchEvent(evt(), rules);
|
||
expect(result?.rule.id).toBe('usr'); // 用户优先,即使 priority 低
|
||
});
|
||
});
|