# RFP Finanzübersicht

Material-3-orientierte Finanzübersicht für Vereins-AGs mit rollenbasierter Freigabelogik, PWA-Grundlage und Docker-Setup.

## Stack

- Next.js 14 mit App Router und TypeScript
- MUI 6 für Material Design 3
- Prisma + PostgreSQL
- NextAuth Credentials Login
- Docker Compose für lokalen Start

## Enthalten

- Horizontale Budget-Übersicht pro AG
- Mehrstufige Freigaben mit Rollenlogik
- Web-Push-Benachrichtigungen für Freigabeanforderungen
- Budgets, Zeiträume, Nutzerverwaltung und Audit-Log
- Statusaktionen für Freigeben, Bezahlt und Dokumentiert
- Beleg-Upload für Bilder und PDFs in Google Drive
- CSV-Backup mit Import und Restore-Grundlage
- PWA-Manifest und Service-Worker-Basis

## Lokaler Start

1. Optional `.env.example` nach `.env` kopieren und Werte anpassen.
2. Projekt starten:

```bash
docker-compose up --build
```

3. App öffnen unter `http://localhost:3000`

## Seed 

Der Seed legt die Grundeinstellungen, den aktiven Zeitraum, AGs, Budgets und Basisnutzer für die Erstkonfiguration an. Optional kann `SEED_INITIAL_PASSWORD` gesetzt werden.

## Hinweise

- Für Web Push müssen `NEXT_PUBLIC_VAPID_PUBLIC_KEY`, `VAPID_PRIVATE_KEY` und `VAPID_SUBJECT` gesetzt sein.
- Für Beleg-Uploads müssen `GOOGLE_DRIVE_FOLDER_ID`, `GOOGLE_SERVICE_ACCOUNT_EMAIL` und `GOOGLE_SERVICE_ACCOUNT_PRIVATE_KEY` gesetzt sein. Der Drive-Ordner muss für die Service-Account-Mail freigegeben sein. AG Orga kann die Verbindung in den Einstellungen mit „Drive-Verbindung testen“ prüfen; die App zeigt dabei konkrete Fehler zu Key-Format, Authentifizierung, Ordnerzugriff und Schreibrechten.
- Für Produktion sollten `NEXTAUTH_SECRET`, Datenbank-Zugangsdaten und Reverse-Proxy/SSL sauber gesetzt werden.