initial commit

README.md

@@ -0,0 +1,37 @@
+# Finanz-Dashboard
+
+Persönliche Finanz-Verwaltungs-App (Single-User) mit **Vite + React + Convex**.
+
+## Start
+
+```bash
+npm install
+npx convex dev          # Backend + .env.local (VITE_CONVEX_URL)
+npm run dev             # Frontend (separates Terminal)
+# oder kombiniert:
+npm run dev:all
+```
+
+Erstlogin: Registrieren auf `/login` → `ensureSeeded` legt Standard-Kategorien und Einstellungen an.
+
+## Convex Secrets (comdirect)
+
+```bash
+npx convex env set COMDIRECT_CLIENT_ID "…"
+npx convex env set COMDIRECT_CLIENT_SECRET "…"
+```
+
+Zugangsnummer und PIN werden **nur** pro Sync-Session eingegeben und nie gespeichert.
+
+## Funktionen
+
+- Dashboard mit KPIs, Charts, Monats-Basis (effective/booking)
+- Transaktionen (paginiert, Filter, Bulk-Kategorisierung, Monatszuordnung)
+- Kategorien-CRUD mit Seed-Kategorien (§5 Spezifikation)
+- Kredite inkl. Tilgungsplan (keine Auto-Buchung als Transaktionen)
+- CSV-Import (comdirect, ISO-8859-1) und comdirect-API-Sync via Convex Actions
+- Einstellungen: Konten, ownNames, Gehalts-Folgemonat-Regel
+
+## Tech-Stack
+
+Vite, React 18+, TypeScript, Convex, `@convex-dev/auth` (Password), Tailwind, shadcn/ui, recharts, react-router-dom, papaparse, date-fns.