# 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
1. **fire_math.py** — Pure FIRE-Berechnungen, testbar ohne DB
2. **models.py + database.py** — Datenmodell
3. **main.py** — FastAPI routes + CRUD
4. **templates/setup.html** — Ersteinrichtung Wizard
5. **templates/dashboard.html** — Hauptseite mit Charts
6. **templates/assets.html** — Asset CRUD
7. **seed.py** — Demo-Daten (Samuels Szenario)
8. **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