RFP Finanzübersicht

Material-3-orientierter MVP fuer die Budgetsteuerung von Vereins-AGs mit rollenbasierter Freigabelogik, PWA-Grundlage und Docker-Setup.

Stack

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

Enthalten im MVP

• Horizontale Budget-Dashboard-Ansicht pro AG
• Budget-Fuellstand mit blasser/gefaerbter Visualisierung
• Automatische Freigabe fuer Ausgaben unter 50 EUR
• Drei digitale Freigaben fuer Ausgaben ab 50 EUR
• Rollen Admin, Finanz-AG, AG-Mitglied
• Admin-Formulare fuer Budgets und Nutzeranlage
• Statusaktionen Freigegeben, Bezahlt, Dokumentiert
• Demo-Accounts und Seed-Daten
• PWA-Manifest und Service-Worker-Basis fuer Offline-Shell

Lokaler Start

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

docker-compose up --build

3. App oeffnen unter http://localhost:3000

Demo-Accounts

• admin.a@raveforpeace.org / demo123!
• admin.b@raveforpeace.org / demo123!
• finance@raveforpeace.org / demo123!
• deko@raveforpeace.org / demo123!
• technik@raveforpeace.org / demo123!

Abnahmekriterien durchspielen

1. Als admin.a@raveforpeace.org anmelden und bei AG Deko ein Budget setzen, zum Beispiel 1200.
2. Als deko@raveforpeace.org anmelden und eine Ausgabe ueber 60 EUR erfassen.
3. Als admin.a@raveforpeace.org wieder anmelden und Freigeben als Vorstand A klicken.
4. Als admin.b@raveforpeace.org anmelden und Freigeben als Vorstand B klicken.
5. Als finance@raveforpeace.org anmelden und die Finanzfreigabe setzen.
6. Nach der dritten Freigabe wird der Posten kraeftig dargestellt.
7. Danach Bezahlt setzen klicken, um den blauen Haken zu erhalten.

Datenmodell

• users: Nutzer mit Rolle, Login und optionaler AG-Zuordnung
• working_groups: AG-Name, Budget, Farbe
• expenses: Betrag, Status, Bezahlt-/Dokumentiert-Zeitstempel, optionaler Beleg-Link
• approvals: Wer hat welche Signatur fuer welchen Posten gesetzt

Hinweise

• Die Dokumentation eines Belegs ist im MVP als Beleg-URL umgesetzt.
• Web-Push ist architektonisch vorbereitet ueber PWA-Grundlage, aber die eigentliche Push-Auslieferung ist noch nicht implementiert.
• Fuer Produktion sollten NEXTAUTH_SECRET, Datenbank-Zugangsdaten und Reverse-Proxy/SSL sauber gesetzt werden.