FireTracker — FIRE Dashboard mit ADHS-Twist

Vision

Modularer FIRE-Tracker: 4 Zahlen eingeben, sofort sehen wann du frei bist. Assets (Depots, Immobilien, Cash) als Module — beliebig viele, easy add/remove.

Tech Stack

Backend: Python 3.12 + FastAPI + SQLite (wie StudyAgent — bekannter Stack)
Frontend: htmx + Jinja2 + Tailwind CSS (kein JS-Framework)
Charts: Chart.js (CDN, lightweight)
Auth: Keine (single-user, self-hosted). Optional später.

Datenmodell

User Profile

monthly_income (netto)
monthly_expenses
birth_year
target_retirement_age (optional, für Coast FIRE)
swr (Safe Withdrawal Rate, default 4%)
expected_return (default 7% nominal)
inflation (default 2%)

Asset (modulare Bausteine)

id, name, type (depot | immobilie | cash | crypto | pension | other)
current_value
monthly_contribution
expected_return_override (optional, pro Asset)
notes
created_at, updated_at

Snapshot (monatlicher Verlauf)

id, asset_id, date, value
Ermoeglicht historische Charts pro Asset und gesamt

Expense Category (optional, V2)

id, name, monthly_amount, is_fire_expense (bool — manche Ausgaben fallen bei FIRE weg)

FIRE Metrics (berechnet, nicht gespeichert)

FI Number: (monthly_expenses * 12) / swr
Total Portfolio: sum of all asset values
FI Percentage: portfolio / fi_number * 100
Savings Rate: (income - expenses) / income * 100
Time to FI: compound growth projection
Coast FIRE Number: fi_number / (1 + real_return)^years_to_retirement
Lean FIRE: FI Number mit 80% der Ausgaben
Fat FIRE: FI Number mit 120% der Ausgaben

Screens (V1)

1. Dashboard (Hauptseite)

Grosser FI-Percentage Fortschrittsbalken (visuell, farbig)
FI-Datum prominent ("Frei ab: März 2041")
Savings Rate Gauge
Net Worth Trend (Chart.js Line Chart)
Asset-Uebersicht als Karten (Depot1: 45k, Immo1: 180k, ...)

2. Assets verwalten

Liste aller Assets mit Type-Icons
"+" Button zum Hinzufuegen
Inline-Edit (htmx) fuer Werte aktualisieren
Monatlichen Snapshot eintragen (oder auto aus letztem Wert)

3. Einstellungen

Profil-Daten (Einkommen, Ausgaben, Alter)
FIRE-Parameter (SWR, Return, Inflation)
Import/Export (JSON)

4. Szenarien (V1.5)

Schieberegler: "Was wenn ich X mehr spare?"
Vergleich: aktueller Plan vs. Szenario

ADHS-UX Prinzipien

4 Inputs → Ergebnis: Sofort FI-Datum nach Ersteinrichtung
Progressive Disclosure: Setup-Wizard (3 Steps), Details später
Micro-Rewards: Fortschrittsbalken-Animation, Meilenstein-Messages
Smart Defaults: 4% SWR, 7% Return, 2% Inflation vorausgefuellt
One Action per View: Klare Hierarchie, kein Dashboard-Overload
Farben statt Zahlen: Gruen = on track, Gelb = langsamer, Rot = Rueckschritt

Projektstruktur

FireTracker/
├── main.py              # FastAPI app + routes
├── models.py            # SQLAlchemy/SQLite models
├── schemas.py           # Pydantic schemas
├── fire_math.py         # FIRE calculations (pure functions)
├── database.py          # DB setup + session
├── templates/
│   ├── base.html        # Layout + Tailwind + htmx
│   ├── dashboard.html   # Hauptseite
│   ├── assets.html      # Asset-Verwaltung
│   ├── setup.html       # Ersteinrichtung (Wizard)
│   └── settings.html    # Einstellungen
├── static/
│   └── style.css        # Custom styles (minimal)
├── seed.py              # Demo-Daten fuer Entwicklung
├── requirements.txt
├── PLAN.md
└── FOR_SMLFLG.md

Implementation Order

fire_math.py — Pure FIRE-Berechnungen, testbar ohne DB
models.py + database.py — Datenmodell
main.py — FastAPI routes + CRUD
templates/setup.html — Ersteinrichtung Wizard
templates/dashboard.html — Hauptseite mit Charts
templates/assets.html — Asset CRUD
seed.py — Demo-Daten (Samuels Szenario)
Polish — Farben, Animationen, Responsive

V2 Ideas (NICHT jetzt)

Bank CSV Import
Automatische Snapshots (Cron)
Expense Categories mit "faellt bei FIRE weg" Flag
Monte Carlo Simulation
Multi-User + Auth
Mobile PWA