Saldo Architektur

Zielbild

Saldo ist eine mobile-first Flask-PWA für monatliche Haushaltsplanung. Der Schwerpunkt liegt auf wiederkehrenden Kosten, variablen Einkommen, Restverteilung und externer Beteiligung ohne Benutzerkonto.

Schichten

app/__init__.py Initialisiert App-Factory, Extensions, Logging, Blueprints und CLI-Kommandos.

app/models.py Enthält das relationale Kernmodell für Monate, Kostenstruktur, Einkommen, Verteilungen, Beteiligungsregeln und Benachrichtigungen.

app/services/month_service.py Domänenlogik für automatische Monatsanlage, Seed-Fallback, Kopieren eines Monats und Berechnung zentraler Kennzahlen.

app/services/allocation_service.py Regel-Engine für Vorschlagsverteilungen. Gesperrte Zielkonten bleiben unangetastet, der restliche Betrag wird gewichtet verteilt.

app/services/comparison_service.py Vergleicht Monate und erzeugt Deltas sowie Top-Veränderungen.

app/services/share_service.py Berechnet interne und externe Anteile pro Eintrag und aggregiert externe Forderungen pro Monat.

app/services/notification_service.py Erstellt In-App-Hinweise und triggert optional Web-Push für Monatsende, fehlende Verteilung und starke Einkommensänderungen.

Request Flow

Authentifizierter Request startet.
before_request ruft MonthService.ensure_month() auf.
Falls der aktuelle Kalendermonat fehlt, wird er automatisch aus dem jüngsten Monat erzeugt.
Views lesen die Monatszusammenfassung über compute_summary().
Änderungen an Einkommen oder Planwerten triggern refresh_suggestions().
Benutzer übernehmen Vorschläge komplett oder zielkontenweise.

Datenhaltung

Standard: SQLite
Pfad per DATABASE_URL oder SALDO_DATA_DIR
SQLAlchemy-Modelle sind bewusst nicht SQLite-spezifisch, damit ein Wechsel auf PostgreSQL später möglich bleibt

Deployment

WSGI-Entry: wsgi.py
Produktionsserver: Gunicorn
Healthcheck: /health
Migrationen: Flask-Migrate/Alembic in migrations/
Cloudron-Datenpfad: /app/data

2.0 KiB Raw Blame History