How luodi-nate/financial-management works
Family Ledger is a self-hosted household-finance application centered on monthly or weekly snapshots rather than daily bookkeeping. Members record account balances and cash flows; the application stores period data and turns it into household net-worth, allocation, and investment-return views. Documented branches add holdings valuation and imports, analysis and checkups, goals, expense analysis, and broker sync. The map follows the documented product workflow and sampled core modules; unsampled implementation details are represented only where the README describes the capability.
Main entry points: EntryController.java Monthly Entry · FactViewService.java Fact Views · AccountMapper.java Accounts · PeriodMapper.java Reporting Periods
Components 24
Household Capture
- Family Members
src/main/java/com/family/finance/domain/member/Member.java - Reporting Periods
src/main/java/com/family/finance/repository/PeriodMapper.java - Accounts
src/main/java/com/family/finance/repository/AccountMapper.java - Monthly Entry
src/main/java/com/family/finance/web/entry/EntryController.java - Balance Snapshots
src/main/java/com/family/finance/repository/SnapshotMapper.java
Portfolio Data
- Holdings Import
src/main/java/com/family/finance/service/holdingimport/HoldingImportService.java - Holdings Valuation
src/main/java/com/family/finance/service/stock/AccountValuationService.java - Broker Sync
src/main/java/com/family/finance/service/broker/BrokerSyncService.java - Price Snapshots
src/main/java/com/family/finance/repository/StockHoldingMapper.java
Financial Analysis
- Fact Slice
src/main/java/com/family/finance/factview/FactSlice.java - Fact Views
src/main/java/com/family/finance/factview/FactViewService.java - Dashboard
src/main/java/com/family/finance/web/dashboard/DashboardController.java - Reports
src/main/java/com/family/finance/web/report/ReportsController.java - Asset Lens
src/main/java/com/family/finance/service/lens/LensQueryService.java - Pivot Engine
src/main/java/com/family/finance/calc/lens/PivotEngine.java - Expense Analysis
src/main/java/com/family/finance/service/expense/ExpenseCatQueryService.java
Guidance
- Asset Checkup
src/main/java/com/family/finance/service/checkup/FamilyDiagnose.java - AI Interpretation
src/main/java/com/family/finance/service/checkup/llm/LlmRouter.java - Financial Goals
src/main/java/com/family/finance/service/goal/GoalService.java - Period Review
src/main/java/com/family/finance/service/review/ReviewInsightService.java
Application Core
- MySQL
Other components
- Household Member
- Market Data Services
- LLM Provider
Connections 24
- Household Member → Monthly Entry: records balances
- Monthly Entry → Reporting Periods: files by period
- Monthly Entry → Accounts: enters account data
- Monthly Entry → Balance Snapshots: saves snapshots
- Family Members → Reporting Periods: submits asynchronously
- Holdings Import → Accounts: updates positions
src/main/java/com/family/finance/service/holdingimport/HoldingImportService.java - Broker Sync → Price Snapshots: syncs holdings
src/main/java/com/family/finance/service/broker/BrokerSyncService.java - Market Data Services → Holdings Valuation: provides quotes
- Holdings Valuation → Price Snapshots: reads quotes
src/main/java/com/family/finance/service/stock/AccountValuationService.java - Accounts → MySQL: reads and writes
src/main/java/com/family/finance/repository/AccountMapper.java - Reporting Periods → MySQL: reads and writes
src/main/java/com/family/finance/repository/PeriodMapper.java - Balance Snapshots → MySQL: persists balances
- Monthly Entry → Fact Slice: feeds reporting data
- Fact Slice → Fact Views: supports calculations
src/main/java/com/family/finance/factview/FactViewService.java - Fact Views → Dashboard: supplies KPIs
- Fact Views → Reports: supplies metrics
- Fact Views → Asset Lens: supplies portfolio facts
src/main/java/com/family/finance/service/lens/LensQueryService.java - Asset Lens → Pivot Engine: queries pivots
src/main/java/com/family/finance/service/lens/LensQueryService.java - Expense Analysis → MySQL: queries expenses
src/main/java/com/family/finance/service/expense/ExpenseCatQueryService.java - Asset Checkup → AI Interpretation: requests interpretation
src/main/java/com/family/finance/service/checkup/llm/LlmDiagnoseService.java - AI Interpretation → LLM Provider: sends analysis
- Asset Checkup → Accounts: assesses allocation
- Financial Goals → Fact Views: uses household metrics
- Period Review → AI Interpretation: requests insights
src/main/java/com/family/finance/service/review/ReviewInsightService.java