Skip to content

Reports & Dashboards

Finance Report provides financial reports and dashboards to help you understand your financial position.

Coming Soon

Full reporting features are being developed in EPIC-005. Current functionality is limited.

Available Reports

Balance Sheet

Shows your financial position at a point in time:

Assets - Liabilities = Equity
Section Description
Assets What you own (cash, investments, property)
Liabilities What you owe (credit cards, loans)
Equity Net worth (assets minus liabilities)

Income Statement (Profit & Loss)

Shows your income and expenses over a period:

Income - Expenses = Net Income
Section Description
Income Money earned (salary, interest, dividends)
Expenses Money spent (rent, food, utilities)
Net Income Profit or loss for the period

Cash Flow Statement

Shows how cash moves in and out:

Category Description
Operating Day-to-day activities
Investing Buying/selling investments
Financing Loans, credit cards

Status

Cash flow statement is planned for Phase 2.

Dashboard Widgets

Account Balances

View current balances for all accounts:

┌─────────────────────────────────────┐
│ Account Balances                    │
├─────────────────────────────────────┤
│ Chase Checking     │  $5,234.50    │
│ Savings Account    │ $12,500.00    │
│ Credit Card        │  -$1,234.00   │
│ ─────────────────────────────────── │
│ Net Worth          │ $16,500.50    │
└─────────────────────────────────────┘

Track income vs expenses over time:

xychart-beta
    title "Income vs Expenses (2025)"
    x-axis [Jan, Feb, Mar, Apr, May, Jun]
    y-axis "Amount ($)" 0 --> 8000
    bar [5000, 5200, 5100, 5300, 5500, 5400]
    line [3500, 3800, 3200, 4100, 3600, 3900]

Expense Breakdown

See where your money goes:

pie title "Monthly Expenses"
    "Housing" : 35
    "Transportation" : 15
    "Food" : 20
    "Utilities" : 10
    "Entertainment" : 10
    "Other" : 10

Reconciliation Status

Monitor your reconciliation health:

Metric Value
Reconciliation Rate 94.7%
Pending Reviews 5
Unmatched 3
Avg Match Score 88.5

API Endpoints

Get Account Balances

curl https://report.zitian.party/api/accounts/balances

Get Balance Sheet

curl https://report.zitian.party/api/reports/balance-sheet?date=2026-01-10

Get Income Statement

curl https://report.zitian.party/api/reports/income-statement \
  -d 'start_date=2026-01-01&end_date=2026-01-31'

Get Reconciliation Stats

curl https://report.zitian.party/api/reconciliation/stats

Export Options

Format Description Status
PDF Formatted report 🚧 Coming
CSV Raw data export 🚧 Coming
JSON API response ✅ Available

Customization

Date Ranges

All reports support custom date ranges:

  • Today
  • This Week
  • This Month
  • This Quarter
  • This Year
  • Custom Range

Filters

Filter reports by:

  • Account type
  • Specific accounts
  • Categories/Tags
  • Amount ranges

Best Practices

Monthly Review

Review your income statement monthly to track spending trends.

Regular Reconciliation

High reconciliation rates make reports more accurate.

Year-End Review

Generate annual reports for tax preparation.

Next Steps