38 lines
1.2 KiB
Markdown
38 lines
1.2 KiB
Markdown
# 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.
|