収支管理
概要
投資額・回収額を記録し、日次・週次・月次で収支を集計する。データはJSONファイルで永続化。
データストア
data/
└── bet-records.json # 収支レコードの配列BalanceManager API
| メソッド | 説明 |
|---|---|
addRecord(record) | レコードを追加 |
addRecords(records) | 複数レコードを一括追加 |
getAllRecords() | 全レコードを取得 |
getRecordsByDate(date) | 日付でフィルタ |
getRecordsByPeriod(start, end) | 期間でフィルタ |
getDailySummary(date) | 日次サマリーを取得 |
getWeeklySummary(date) | 週次サマリーを取得(月〜日) |
getMonthlySummary(year, month) | 月次サマリーを取得 |
hasRecord(...) | 重複レコードを検出 |
サマリー計算
typescript
BalanceSummary {
period: string // 表示用期間
totalInvestment: number // 総投資額
totalPayout: number // 総回収額
profit: number // 損益
returnRate: number // 回収率 (%)
totalBets: number // 総買い目数
wins: number // 的中数
hitRate: number // 的中率 (%)
}