finanzen/README.md

Finanz-Dashboard

Persönliche Finanz-Verwaltungs-App (Single-User) mit Vite + React + Convex.

Start

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)

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.