DriftLedger/tests/stores.test.ts
fengmengqi 7fa345b558 feat: 品牌重命名为浮记(DriftLedger),全面升级精度安全与架构
品牌与配置
- 重命名 Bean Mobile → 浮记(DriftLedger),slug 改为 drift-ledger
- 所有 Config Plugin 从 app.json 动态读取 appId,替换硬编码 com.beancount.mobile
- 预构建时自动从 constants.ts 同步支付包名列表到 Kotlin 端
- size-optimization 插件新增 NDK 版本强制统一(27.1.12297006)
- 添加 app icon(direction_a_feather.png)
Decimal 精度改造
- 全面消除 parseFloat 用于金额计算的场景,改用 string decimal 运算
- 新增 divideDecimals(除法)、toDateString(Date→YYYY-MM-DD)
- negateDecimal 零值特殊处理,避免产生 "-0"
- 年报/月报/预算/信用卡/汇率/图表统计等模块全部迁移
- 去重指纹用 parseDecimal 归一化金额格式
- 转账识别增加 normalizeAmount,支持不同精度格式配对(100 vs 100.00)
架构变更
- mobile.bean → main.bean:移除启动时合并迁移逻辑,直接读写 main.bean
- TransactionDraft.sourceEventId → sourceEventIds(数组,支持转账双方)
- 新增 buildPostings() 纯函数,从 transactionBuilder 提取复式分录构建逻辑
- 新增 csvUtils.ts(引号感知 CSV 行拆分),statements/adapters 共用
- 新增 accessibilityParser.ts:从 automationPipeline 提取微信/支付宝文本解析
- 新增 floatingBillManager.ts:悬浮窗草稿管理(LRU+超时)与排序数据构建
- 新增 txKeyStore.ts:交易级去重键持久化(原子写入+500条LRU)
- ledger.ts 新增 resolveIncludes 选项,支持 include 指令递归解析
- metadataStore CRUD 用 createCrudActions 工厂消除7组实体重复代码
安全与持久化
- PIN 哈希改用带盐 SHA-256,兼容旧版无 salt 数据迁移
- storePersistence 从 persistTo 回调改为 subscribe 自动触发
- 持久化增加深比较跳过无变化写入 + 滞后重试
- 新增 flushPersistence(),App 切后台时立即刷盘
- CrashReporter 新增文件持久化(CrashFs 抽象)
- settingsStore hydrate 期间跳过自动持久化(skipPersist 标志)
去重与管道
- batchDedup 改用日期索引 Map,候选查找从 O(n) 降至 O(1)
- dedupAgainstHistory 按日期分组,仅扫描时间窗口内候选
- OcrProcessor 从布尔标志改为 Promise 队列,不再丢弃并发请求
- 去重缓存改用 Map<hash,timestamp> LRU,阈值超20%时批量淘汰
- 悬浮球全局开关(floatingBallEnabled) + 原生 bridge API
其他改进
- recurring 计算修复月/年溢出(1月31日+1月→2月28日,闰年2月29日)
- 预算进度按 posting 分录金额求和(不再仅过滤负数金额)
- recurring.ts 用 Date.parse 本地时间替代 toISOString 的 UTC 偏移
- 信用卡账单日/还款日限制不超过28,防止月份溢出
- 类别模糊匹配增加最小长度2,避免单字符误匹配
- 还款检测排除 refund 方向,避免退款被误判为还款
- WebDAV 同步增加 HTTP 日期格式解析
- Git 合并策略改为以 remote 为基础追加 local 独有行
性能优化
- commonStyles 全局 useMemo 缓存
- Button/Card 的 pressIn/pressOut 改用 useCallback
- TransactionCard/AccountTreeNode 包裹 React.memo
- PostingEditor 用 refs + 函数式更新避免重建
- CreditCard 页预计算账户余额 Map,避免渲染循环重复遍历
- OCR 处理器单例复用,配置变更时才重建
- getLocalAuth/getAccessibilityBridge 结果缓存
测试
- 新增 decimal/constants/channelConfig/transactionBuilder 单测
- 修复金额格式断言(-24.5→-24.50),匹配字符串精度行为
- billPipeline 新增不同格式金额配对、指纹唯一性测试
2026-07-21 15:16:44 +08:00

251 lines
11 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, beforeEach } from 'vitest';
import { useLedgerStore } from '../src/store/ledgerStore';
import { useImportStore } from '../src/store/importStore';
import { useSettingsStore } from '../src/store/settingsStore';
import { MemoryBackend } from '../src/domain/mobileStore';
import type { LedgerFile } from '../src/domain/types';
const sampleLedger: LedgerFile = {
path: 'main.bean',
content: `option "operating_currency" "CNY"
2026-01-01 open Assets:Alipay CNY
2026-01-01 open Expenses:Food CNY
2026-01-01 open Expenses:Uncategorized CNY
2026-01-01 open Income:Uncategorized CNY
include "mobile.bean"
`,
};
const sampleStatement = '交易时间,金额(元),收/支,交易对方,商品说明,交易订单号\n2026-07-01,24.50,支出,咖啡店,冰美式,ORDER-1\n2026-07-02,5000,收入,公司,工资,ORDER-2';
// 每个测试前重置 storezustand 单例需手动重置)
beforeEach(() => {
useLedgerStore.getState().reset();
useImportStore.getState().clear();
useSettingsStore.getState().hydrate({});
});
describe('ledgerStore', () => {
it('loadLedger 解析账本并初始化 mobile.bean 存储', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
const state = useLedgerStore.getState();
expect(state.ledger).not.toBeNull();
expect(state.ledger!.accounts.size).toBe(4);
expect(state.mobileBean).toContain('include "mobile.bean"');
expect(state.error).toBeNull();
});
it('addTransaction 写入 mobile.bean并发安全', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
const commit = await useLedgerStore.getState().addTransaction({
date: '2026-07-10', narration: '午餐',
postings: [{ account: 'Assets:Alipay', amount: '-20', currency: 'CNY' }, { account: 'Expenses:Food', amount: '20', currency: 'CNY' }],
});
expect(commit.content).toContain('午餐');
expect(useLedgerStore.getState().mobileBean).toContain('午餐');
});
// 回归:用户反馈"添加交易后最近交易还是 0"。
// 根因addTransaction 只更新了 mobileBean 字符串,未重新解析 ledger.transactions。
// parseLedger 不解析 include 指令,需把 mobile.bean 作为额外文件传入。
it('addTransaction 后 ledger.transactions 包含新交易', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
expect(useLedgerStore.getState().ledger!.transactions).toHaveLength(0);
await useLedgerStore.getState().addTransaction({
date: '2026-07-10', narration: '午餐',
postings: [{ account: 'Assets:Alipay', amount: '-20', currency: 'CNY' }, { account: 'Expenses:Food', amount: '20', currency: 'CNY' }],
});
const txns = useLedgerStore.getState().ledger!.transactions;
expect(txns).toHaveLength(1);
expect(txns[0].narration).toBe('午餐');
expect(txns[0].postings).toHaveLength(2);
});
it('addTransaction 多笔后 ledger.transactions 全部可见', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
for (const n of [1, 2, 3]) {
await useLedgerStore.getState().addTransaction({
date: '2026-07-10', narration: `t${n}`,
postings: [{ account: 'Assets:Alipay', amount: `-${n}`, currency: 'CNY' }, { account: 'Expenses:Food', amount: `${n}`, currency: 'CNY' }],
});
}
const txns = useLedgerStore.getState().ledger!.transactions;
expect(txns).toHaveLength(3);
expect(txns.map(t => t.narration).sort()).toEqual(['t1', 't2', 't3']);
});
it('replaceMobileBean 后 ledger.transactions 同步更新', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
await useLedgerStore.getState().replaceMobileBean(
'2026-07-10 * "导入交易"\n Assets:Alipay -50 CNY\n Expenses:Food\n',
);
const txns = useLedgerStore.getState().ledger!.transactions;
expect(txns).toHaveLength(1);
expect(txns[0].narration).toBe('导入交易');
});
it('addTransaction 多笔并发不丢失', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
await Promise.all([1, 2, 3].map(n =>
useLedgerStore.getState().addTransaction({
date: '2026-07-10', narration: `t${n}`,
postings: [{ account: 'Assets:Alipay', amount: `-${n}`, currency: 'CNY' }, { account: 'Expenses:Food', amount: `${n}`, currency: 'CNY' }],
}),
));
const content = useLedgerStore.getState().mobileBean;
expect(content).toContain('t1');
expect(content).toContain('t2');
expect(content).toContain('t3');
});
it('未加载账本时 addTransaction 抛错', async () => {
await expect(useLedgerStore.getState().addTransaction({
date: '2026-07-10', narration: 'x',
postings: [{ account: 'A', amount: '-1', currency: 'CNY' }, { account: 'B', amount: '1', currency: 'CNY' }],
})).rejects.toThrow('账本未加载');
});
it('不平衡交易 addTransaction 抛错并设置 error', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
await expect(useLedgerStore.getState().addTransaction({
date: '2026-07-10', narration: '错误',
postings: [{ account: 'Assets:Alipay', amount: '-1', currency: 'CNY' }, { account: 'Expenses:Food', amount: '0.9', currency: 'CNY' }],
})).rejects.toThrow();
});
it('replaceMobileBean 直接替换内容', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
await useLedgerStore.getState().replaceMobileBean('REPLACED');
expect(useLedgerStore.getState().mobileBean).toBe('REPLACED');
});
it('refresh 重新解析账本', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
// refresh 不改变账户数(文件未变)
await useLedgerStore.getState().refresh();
expect(useLedgerStore.getState().ledger!.accounts.size).toBe(4);
});
it('reset 回到初始状态', async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
useLedgerStore.getState().reset();
const state = useLedgerStore.getState();
expect(state.ledger).toBeNull();
expect(state.mobileStore).toBeNull();
expect(state.mobileBean).toBe('');
});
});
describe('importStore', () => {
beforeEach(async () => {
await useLedgerStore.getState().loadLedger([sampleLedger], new MemoryBackend());
});
it('setContext 设置规则/分类', () => {
useImportStore.getState().setContext({
rules: [{ id: 'r1', priority: 10, counterpartyContains: '咖啡', sourceAccount: 'Assets:Alipay', categoryAccount: 'Expenses:Food', hits: 0 }],
});
expect(useImportStore.getState().rules).toHaveLength(1);
});
it('importCsv 生成事件', () => {
const events = useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
expect(events).toHaveLength(2);
expect(useImportStore.getState().events).toHaveLength(2);
});
it('process 走 BillPipeline 生成草稿', async () => {
useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
const ledger = useLedgerStore.getState().ledger!;
const result = await useImportStore.getState().process(ledger, []);
expect(result.drafts.length).toBeGreaterThan(0);
expect(useImportStore.getState().pendingDrafts.length).toBeGreaterThan(0);
});
it('confirmDraft 移除已确认草稿并返回它', async () => {
useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
const ledger = useLedgerStore.getState().ledger!;
await useImportStore.getState().process(ledger, []);
const before = useImportStore.getState().pendingDrafts.length;
const confirmed = useImportStore.getState().confirmDraft(0);
expect(confirmed).not.toBeNull();
expect(useImportStore.getState().pendingDrafts.length).toBe(before - 1);
});
it('rejectDraft 移除草稿', async () => {
useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
const ledger = useLedgerStore.getState().ledger!;
await useImportStore.getState().process(ledger, []);
const before = useImportStore.getState().pendingDrafts.length;
useImportStore.getState().rejectDraft(0);
expect(useImportStore.getState().pendingDrafts.length).toBe(before - 1);
});
it('clear 清空本次导入', async () => {
useImportStore.getState().importCsv(sampleStatement, 'alipay-csv-v1');
const ledger = useLedgerStore.getState().ledger!;
await useImportStore.getState().process(ledger, []);
useImportStore.getState().clear();
expect(useImportStore.getState().events).toHaveLength(0);
expect(useImportStore.getState().pendingDrafts).toHaveLength(0);
});
});
describe('settingsStore', () => {
it('默认值正确', () => {
const s = useSettingsStore.getState();
expect(s.dedupEnabled).toBe(true);
expect(s.transferRecognitionEnabled).toBe(true);
expect(s.themeMode).toBe('system');
expect(s.locale).toBe('zh');
expect(s.appLockEnabled).toBe(false);
});
it('updateDedupConfig 局部更新', () => {
useSettingsStore.getState().updateDedupConfig({ timeWindowMinutes: 10 });
expect(useSettingsStore.getState().dedupConfig.timeWindowMinutes).toBe(10);
expect(useSettingsStore.getState().dedupConfig.checkAccountLink).toBe(true); // 其他字段保留
});
it('updateTransferConfig 局部更新', () => {
useSettingsStore.getState().updateTransferConfig({ timeWindowHours: 48 });
expect(useSettingsStore.getState().transferConfig.timeWindowHours).toBe(48);
});
it('setThemeMode / setLocale / setAppLockEnabled', () => {
useSettingsStore.getState().setThemeMode('dark');
useSettingsStore.getState().setLocale('en');
useSettingsStore.getState().setAppLockEnabled(true);
const s = useSettingsStore.getState();
expect(s.themeMode).toBe('dark');
expect(s.locale).toBe('en');
expect(s.appLockEnabled).toBe(true);
});
it('persistTo 钩子在状态变更后被调用', () => {
// 使用 store 的 subscribe 来验证状态变更通知
const changes: string[] = [];
const unsub = useSettingsStore.subscribe((state, prevState) => {
if (state !== prevState) {
changes.push(state.themeMode);
}
});
useSettingsStore.getState().setThemeMode('dark');
expect(changes).toHaveLength(1);
expect(changes[0]).toBe('dark');
unsub();
});
it('hydrate 从持久化源恢复', () => {
useSettingsStore.getState().hydrate({ themeMode: 'dark', locale: 'en', appLockEnabled: true });
const s = useSettingsStore.getState();
expect(s.themeMode).toBe('dark');
expect(s.locale).toBe('en');
expect(s.appLockEnabled).toBe(true);
// 未提供的字段用默认值
expect(s.dedupEnabled).toBe(true);
});
});