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:

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.
• Für Produktion sollten NEXTAUTH_SECRET, Datenbank-Zugangsdaten und Reverse-Proxy/SSL sauber gesetzt werden.