DriftLedger/tests/domain-finance.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

176 lines
8.1 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 { calculateBudgetProgress, getPeriodRange, type Budget } from '../src/domain/budgets';
import { calculateNextDueDate, getDueRecurring, instantiateRecurring, type RecurringTransaction } from '../src/domain/recurring';
import { buildTransactionCurrency, convertCurrency, getEffectiveRate, validateRateCoverage, type ExchangeRate } from '../src/domain/currency';
import { calculateBillingPeriod, calculateStatementAmount, calculateAvailableCredit, type CreditCard } from '../src/domain/creditCards';
import type { Transaction } from '../src/domain/types';
const tx = (over: Partial<Transaction>): Transaction => ({
id: 't1', date: '2026-07-10', flag: '*', postings: [], tags: [], links: [], source: 'mobile.bean', raw: '',
...over,
});
describe('budgets', () => {
const budget: Budget = { id: 'b1', name: '餐饮', amount: '1000', period: 'monthly', categoryAccount: 'Expenses:Food', startDate: '2026-01-01' };
const transactions = [
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:Alipay', amount: '-200', currency: 'CNY' }, { account: 'Expenses:Food', amount: '200', currency: 'CNY' }] }),
tx({ id: 't3', date: '2026-07-15', postings: [{ account: 'Assets:Alipay', amount: '-50', currency: 'CNY' }, { account: 'Expenses:Transport', amount: '50', currency: 'CNY' }] }),
];
it('计算预算进度', () => {
const progress = calculateBudgetProgress(budget, transactions, '2026-07-15');
expect(progress.spent).toBe('300'); // 100+200Food
expect(progress.percentage).toBe(30); // 300/1000
expect(progress.overBudget).toBe(false);
});
it('多入账与退款与总预算测试', () => {
const testTxs = [
// 1. 多分录交易:买了食物 100交通 50支付宝付了 150
tx({ id: 't_multi', date: '2026-07-06', postings: [
{ account: 'Assets:Alipay', amount: '-150', currency: 'CNY' },
{ account: 'Expenses:Food', amount: '100', currency: 'CNY' },
{ account: 'Expenses:Transport', amount: '50', currency: 'CNY' }
] }),
// 2. 退款交易:食物退了 10
tx({ id: 't_refund', date: '2026-07-07', postings: [
{ account: 'Assets:Alipay', amount: '10', currency: 'CNY' },
{ account: 'Expenses:Food', amount: '-10', currency: 'CNY' }
] }),
// 3. 转账交易:微信转支付宝 50不应计入预算
tx({ id: 't_transfer', date: '2026-07-08', postings: [
{ account: 'Assets:WeChat', amount: '-50', currency: 'CNY' },
{ account: 'Assets:Alipay', amount: '50', currency: 'CNY' }
] }),
// 4. 工资收入5000不应计入预算
tx({ id: 't_salary', date: '2026-07-09', postings: [
{ account: 'Assets:Alipay', amount: '5000', currency: 'CNY' },
{ account: 'Income:Salary', amount: '-5000', currency: 'CNY' }
] })
];
// 食物预算进度应该只计算食物分录100 - 10 = 90
const foodProgress = calculateBudgetProgress(budget, testTxs, '2026-07-15');
expect(foodProgress.spent).toBe('90');
// 总预算进度应该计算所有 Expenses:* 分录:(100 + 50) - 10 = 140
const totalBudget: Budget = { id: 'b_total', name: '总预算', amount: '1000', period: 'monthly', startDate: '2026-01-01' };
const totalProgress = calculateBudgetProgress(totalBudget, testTxs, '2026-07-15');
expect(totalProgress.spent).toBe('140');
});
it('超支检测', () => {
const smallBudget = { ...budget, amount: '200' };
const progress = calculateBudgetProgress(smallBudget, transactions, '2026-07-15');
expect(progress.overBudget).toBe(true);
});
it('getPeriodRange monthly', () => {
const range = getPeriodRange('monthly', '2026-07-15');
expect(range.start).toBe('2026-07-01');
expect(range.end).toBe('2026-07-31');
});
it('getPeriodRange yearly', () => {
const range = getPeriodRange('yearly', '2026-07-15');
expect(range.start).toBe('2026-01-01');
expect(range.end).toBe('2026-12-31');
});
});
describe('recurring', () => {
const r: RecurringTransaction = {
id: 'r1', name: '房租', frequency: 'monthly', interval: 1, nextDueDate: '2026-07-01', enabled: true,
draft: { date: '2026-07-01', narration: '房租', postings: [{ account: 'Assets:Bank', amount: '-3000', currency: 'CNY' }, { account: 'Expenses:Rent', amount: '3000', currency: 'CNY' }] },
};
it('getDueRecurring 检测到期', () => {
expect(getDueRecurring([r], '2026-07-01')).toHaveLength(1);
expect(getDueRecurring([r], '2026-06-30')).toHaveLength(0);
});
it('calculateNextDueDate monthly', () => {
expect(calculateNextDueDate('monthly', 1, '2026-07-01')).toBe('2026-08-01');
expect(calculateNextDueDate('monthly', 1, '2026-07-15')).toBe('2026-08-15');
expect(calculateNextDueDate('monthly', 1, '2026-01-31')).toBe('2026-02-28');
expect(calculateNextDueDate('monthly', 2, '2026-01-31')).toBe('2026-03-31');
});
it('calculateNextDueDate weekly', () => {
expect(calculateNextDueDate('weekly', 2, '2026-07-01')).toBe('2026-07-15');
});
it('calculateNextDueDate yearly', () => {
expect(calculateNextDueDate('yearly', 1, '2026-07-15')).toBe('2027-07-15');
expect(calculateNextDueDate('yearly', 1, '2024-02-29')).toBe('2025-02-28');
expect(calculateNextDueDate('yearly', 4, '2024-02-29')).toBe('2028-02-29');
});
it('instantiateRecurring', () => {
const draft = instantiateRecurring(r);
expect(draft.date).toBe('2026-07-01');
});
});
describe('currency', () => {
const rates: ExchangeRate[] = [{ from: 'USD', to: 'CNY', rate: '7.2', date: '2026-07-13' }];
it('convertCurrency', () => {
expect(convertCurrency('100', 'USD', 'CNY', rates)).toBe('720.00');
});
it('同币种不转换', () => {
expect(convertCurrency('100', 'CNY', 'CNY', rates)).toBe('100');
});
it('getEffectiveRate 手动覆盖优先', () => {
const overrides = [{ from: 'USD', to: 'CNY', rate: '7.0', enabled: true }];
const rate = getEffectiveRate('USD', 'CNY', rates, overrides);
expect(rate?.rate).toBe('7.0');
});
it('buildTransactionCurrency 同币种', () => {
const tc = buildTransactionCurrency('100', 'CNY', 'CNY', rates);
expect(tc.exchangeRate).toBe('1');
});
it('buildTransactionCurrency 跨币种', () => {
const tc = buildTransactionCurrency('100', 'USD', 'CNY', rates);
expect(tc.exchangeRate).toBe('7.2');
});
it('validateRateCoverage', () => {
const missing = validateRateCoverage('CNY', ['CNY', 'USD', 'EUR'], rates);
expect(missing).toEqual(['EUR']);
});
});
describe('creditCards', () => {
const card: CreditCard = { id: 'c1', name: '招行信用卡', lastFour: '1234', bankName: 'CMB', billingDay: 5, paymentDay: 25, creditLimit: '10000', currency: 'CNY', linkedAccount: 'Liabilities:CreditCard:CMB' };
const transactions = [
tx({ id: 't1', date: '2026-07-10', postings: [{ account: 'Liabilities:CreditCard:CMB', amount: '-100', currency: 'CNY' }, { account: 'Expenses:Food', amount: '100', currency: 'CNY' }] }),
tx({ id: 't2', date: '2026-07-15', postings: [{ account: 'Liabilities:CreditCard:CMB', amount: '-200', currency: 'CNY' }, { account: 'Expenses:Food', amount: '200', currency: 'CNY' }] }),
];
it('calculateBillingPeriod', () => {
const period = calculateBillingPeriod(card, new Date('2026-07-20'));
expect(period.periodStart).toBe('2026-06-05');
expect(period.periodEnd).toBe('2026-07-05');
expect(period.dueDate).toBe('2026-07-25');
});
it('calculateStatementAmount', () => {
// 7月10日、15日 不在 6/5~7/5 周期内 → 0
const period = calculateBillingPeriod(card, new Date('2026-07-20'));
expect(calculateStatementAmount(transactions, card, period)).toBe('0');
// 用 8/20 周期7/5~8/5→ 包含 7/10、7/15
const period2 = calculateBillingPeriod(card, new Date('2026-08-20'));
expect(calculateStatementAmount(transactions, card, period2)).toBe('300');
});
it('calculateAvailableCredit', () => {
expect(calculateAvailableCredit(card, '-500')).toBe('9500');
});
});