Finance

Track income, expenses, and investment portfolios with categories, live market data, and analysis charts.

Features

Einnahmen / Ausgaben

• Entries — Add income and expense records with totals summary
• Categories — Organize by custom categories (add, edit, delete custom categories in Settings)
• Category Management — Create custom categories with name, icon (emoji), and color picker
• Date filtering — View by month, year, or custom range
• Summary — Total income, expenses, and balance per filtered view
• Budget Management — Set monthly/weekly/yearly budgets per category or overall
• Budget Dashboard — Budget status card shows used percentage with progress bar
• Recurring Entries — Mark entries as recurring (weekly/monthly/yearly)
• Export — CSV export for income and expenses
• Aurora integration — Aurora can list entries and create new ones

Portfolio (NEW in v3.7)

• Multi-Asset Support — Stocks, ETFs, Crypto, Precious Metals, Cash/Tagesgeld
• Live Market Data — Real-time prices via Yahoo Finance API (15-min cache)
• Performance Tracking — Daily snapshots, historical performance charts
• Dividend Management — Track dividends and interest payments
• Analysis Charts — Allocation donuts, performance lines, dividend bars (Chart.js)
• Watchlist — Monitor symbols without buying
• Cash Positions — Track Tagesgeld/Girokonto with deposits, withdrawals, interest
• CSV Export — Export positions and transactions as CSV
• Aurora Tools — get_portfolio_overview, list_portfolio_positions, add_portfolio_transaction

Portfolio Interface

The portfolio section has 4 tabs:

Uebersicht (Dashboard)

• Stats cards: Total value, Invested, P/L (absolute + %), Dividends
• Allocation donut chart by asset type
• Performance line chart (1M/3M/6M/1Y/Max)
• Top/Flop performers
• Watchlist widget with live prices

Positionen

• Holdings table: Symbol, Name, Type, Shares, Buy Price, Current Price, Value, P/L
• Sortable columns, color-coded P/L
• Click to view position detail (chart + transaction history)
• Add position with live symbol search

Transaktionen

• Full transaction log: Date, Symbol, Type, Quantity, Price, Fees, Amount
• Filter by type (buy/sell/dividend) and asset
• Edit and delete transactions
• CSV export

Analyse

• Allocation by type + by individual position
• Dividend bar chart (last 12 months)
• Key metrics: Dividend yield, realized/unrealized P/L, total fees

v3.12 Fixes v3.12

Kontrast-Verbesserung

Die Lesbarkeit von Texten und Zahlen wurde bei verschiedenen Hintergruenden verbessert:

• Besserer Farbkontrast bei hellen und dunklen Themes
• Einheitlichere Darstellung von positiven (gruen) und negativen (rot) Werten

Yahoo Finance API

Der Yahoo Finance API-Zugriff wurde auf curl mit korrekten Headers umgestellt:

• User-Agent und Accept Headers verhindern 403-Fehler
• Zuvor konnte file_get_contents von Yahoo blockiert werden
• Cache bleibt bei 15 Minuten TTL

Portfolio API Endpoints

Endpoint	Method	Description
portfolio_search	GET	Yahoo symbol search
portfolio_quote	GET	Get current price
portfolio_list_assets	GET	List all assets
portfolio_add_asset	POST	Add new asset
portfolio_delete_asset	POST	Delete asset + transactions
portfolio_list_transactions	GET	List transactions
portfolio_add_transaction	POST	Add transaction
portfolio_update_transaction	POST	Update transaction
portfolio_delete_transaction	POST	Delete transaction
portfolio_overview	GET	Dashboard data
portfolio_performance	GET	Performance chart data
portfolio_history	GET	Price history for symbol
portfolio_dividends	GET	Dividend overview
portfolio_snapshot	POST	Create daily snapshot
portfolio_watchlist	GET	Watchlist with prices
portfolio_watchlist_add	POST	Add to watchlist
portfolio_watchlist_remove	POST	Remove from watchlist

Category & Budget API Endpoints

Endpoint	Method	Description
get_categories	GET	List categories (filter by type)
add_category	POST	Add custom category (name, type, icon, color)
update_category	POST	Update category (name, icon, color)
delete_category	POST	Delete custom category (not defaults)
list_budgets	GET	List budgets with current spending
add_budget	POST	Create budget (category, amount, period)
update_budget	POST	Update budget amount/period
delete_budget	POST	Delete budget

Data Sync

The app-sync.php library automatically exports finance data to the filesystem:

• ~/Dokumente/Finanzen/Uebersicht.md — Monthly income/expense summary
• ~/Dokumente/Finanzen/Einnahmen-YYYY-MM.csv — Income CSV
• ~/Dokumente/Finanzen/Ausgaben-YYYY-MM.csv — Expense CSV
• ~/Dokumente/Finanzen/Portfolio-Uebersicht.md — Portfolio summary with positions
• ~/Dokumente/Finanzen/Portfolio-Positionen.csv — Current holdings CSV
• ~/Dokumente/Finanzen/Portfolio-Transaktionen.csv — Transaction history CSV

Cronjob

Portfolio snapshots are taken daily at 6:00 AM via cron for performance tracking over time.