moneyfyandClaude Opus 5
70d73cf8d3
Datenbankfreie Kernberechnung auf Basis schlanker Protokolle, sodass sowohl ORM-Objekte als auch Testdatenklassen verarbeitet werden. - expand() mit voller RFC-5545-Unterstützung, Fensterbegrenzung und Overlays - expand_by_due_date() für Sichten, die nach dem tatsächlichen Zahltag gruppieren - Werktagsverschiebung über den NRW-Feiertagskalender, nominales Datum als Schlüssel - Preishistorie, Ratenzahlungen, Vertragsfristen und Rücklagenberechnung - validate_rrule() und next_dates() für Eingabeprüfung und Terminvorschau - 81 Unit-Tests, davon alle in Abschnitt 2 geforderten Fälle Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014e7t8UpmoVNMtWivY5LiSH
moneyfy
Selbst gehostete Web-Anwendung zur Planung monatlicher Kosten und Einkünfte. Single-User, deutschsprachige Oberfläche, ausgelegt für den Betrieb im Homelab hinter einem Reverse Proxy.
Status: in Entwicklung. Siehe CHANGELOG.md.
Screenshots
Platzhalter – werden ergänzt, sobald die Oberfläche steht.
| Dashboard | Cashflow-Kalender | Firmen |
|---|---|---|
| folgt | folgt | folgt |
Funktionsumfang
- Wiederkehrende Zahlungen und Einkünfte über vollständige RFC-5545-RRULEs, inklusive Werktagsverschiebung nach NRW-Feiertagen.
- Preishistorie je Vertrag, sodass vergangene Monate betragstreu bleiben.
- Verträge mit Mindestlaufzeit, Kündigungsfrist und automatischer Verlängerung.
- Ratenzahlungen mit Restschuld- und Restratenberechnung.
- Rücklagenbildung für nicht-monatliche Posten.
- Firmenlogos und Markenfarben, lokal zwischengespeichert.
- Auswertungen: Monatsübersicht, Cashflow-Kalender, 12-Monats-Forecast, Kategorien, Abo-Übersicht, Jahresvergleich, Budgets, Sparziele.
- Benachrichtigungen per SMTP und Apprise.
Technischer Stack
| Bereich | Technologie |
|---|---|
| Backend | Python 3.12, FastAPI, SQLAlchemy 2 (async), Alembic, Pydantic v2 |
| Datenbank | PostgreSQL 17 |
| Scheduler | APScheduler (in-process) |
| Frontend | React 18, TypeScript, Vite, TailwindCSS |
| Charts | Recharts |
| Tests | pytest + httpx, vitest + testing-library |
Schnellstart (lokale Entwicklung)
Voraussetzungen: Python 3.12, uv, Node 20+, eine erreichbare PostgreSQL-17-Instanz.
git clone https://git.menzel.center/menzeljonas/moneyfy.git
cd moneyfy
cp .env.example backend/.env # DATABASE_URL und SECRET_KEY anpassen
make install # Backend-Abhängigkeiten in backend/.venv
make migrate # Schema anlegen
make seed # Kategoriebaum und Standardregeln
make dev # http://localhost:8000/api/docs
Nützliche Ziele: make test, make lint, make format, make check.
Konfiguration
Alle Einstellungen kommen aus Umgebungsvariablen; .env.example enthält die
vollständige, kommentierte Liste. Die wichtigsten:
| Variable | Standard | Bedeutung |
|---|---|---|
DATABASE_URL |
– | PostgreSQL-DSN, postgresql:// wird auf asyncpg umgestellt |
SECRET_KEY |
– | Signaturschlüssel für JWTs (openssl rand -hex 32) |
MONEYFY_ADMIN_USER / MONEYFY_ADMIN_PASSWORD |
admin / – |
Beim Erststart angelegter Benutzer |
TIMEZONE |
Europe/Berlin |
Zeitzone der gesamten Anwendung |
HOLIDAY_REGION |
DE-NW |
Feiertagsregion für Werktagsverschiebungen |
LOGO_STORAGE_DIR |
/data/logos |
Verzeichnis des Logo-Caches |
LOGODEV_API_KEY / BRANDFETCH_API_KEY |
leer | Optionale Logo-Provider |
SMTP_* |
leer | Mailversand für Benachrichtigungen |
APPRISE_URLS |
leer | Komma-separierte Apprise-Ziele |
COOKIE_SECURE |
true |
Hinter HTTPS true, für lokales HTTP false |
SCHEDULER_ENABLED |
true |
Täglicher Benachrichtigungslauf um 07:00 |
Projektstruktur
backend/ FastAPI-Anwendung, Modelle, Services, Alembic-Migrationen, Tests
frontend/ React-Oberfläche (Vite)
docs/ Betriebs- und Runner-Dokumentation
.gitea/ Gitea-Actions-Workflows