# FireTracker

FIRE calculator with an ADHS-friendly flow: enter 3 numbers, see when you could be financially free.

FireTracker is a local-first single-user dashboard for tracking assets, FIRE progress, and simple what-if scenarios. No cloud account, no auth, no external bank connection required.

## Status

MVP shipped.

- 17 unit tests passing for the FIRE math core.
- 3 Playwright E2E flows exist for setup, dashboard, and asset creation.
- `fi_date` edge case fixed.
- Historical asset charts are future scope.

## What works

- Setup wizard — 3 fields, then straight to the dashboard.
- Dashboard — FI%, FI date, savings rate, 30-year projection, assets grouped by type.
- Assets CRUD — create, edit via htmx inline update, delete.
- Scenario API — “what if I save X more?” with `diff_years`.
- CSV import — simple German bank CSV parsing with semicolon delimiter and comma decimal support.
- JSON export — profile, assets, and snapshots as backup.
- Settings — FIRE parameters such as SWR, return, inflation, and target retirement age.
- Demo seed — sample profile with 5 assets.

## Run locally

```bash
cd ~/Projekte/FireTracker
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --port 8050
```

Open:

```text
http://localhost:8050
```

First start redirects automatically to `/setup`.

Optional demo data:

```bash
python seed.py
```

## Tests

```bash
# Unit tests, no server needed
pytest test_fire_math.py -q

# E2E tests, requires running server + Playwright browser install
playwright install chromium
pytest tests/test_e2e.py -v
```

## Stack

- FastAPI
- SQLAlchemy
- SQLite
- Jinja2
- htmx
- Tailwind CSS
- Chart.js
- pytest
- Playwright

## Scope

This is a personal/local MVP, not a hosted SaaS product.

Not included by default:

- multi-user accounts
- authentication
- cloud sync
- automatic bank API integration
- investment advice

## License

MIT License. See `LICENSE`.

## Disclaimer

FireTracker is a planning and visualization tool. It is not financial advice.