Liquiditäts-Dashboard

Zweck

Das Liquiditäts-Dashboard (/liquidity, neu Juni 2026) zeigt auf einen Blick, wie es um die Zahlungsfähigkeit der Firma steht — den aktuellen Stand und eine Vorschau, welche Beträge in den nächsten Tagen voraussichtlich ein- und ausgehen. Es ist ein eigenständiges Dashboard, kein Teil von Geschäfts-Analyse oder Transaktions-Cockpit.

Die Startansicht Übersicht hat zwei Spalten:

• Links — Snapshot („Heute"): der aktuelle Stand aus den internen Bankkonten plus die heutigen Ein-/Ausgänge.
• Rechts — Prognose: erwartete Zahlungen, gruppiert nach Fälligkeit (z. B. überfällig, 7 / 14 / 30 Tage).

Ansichten (Tabs)

Seit Juni 2026 ist das Dashboard in fünf Tabs mit eigenen URLs gegliedert (jede Ansicht ist direkt verlinkbar):

Tab	URL	Inhalt
Übersicht	/liquidity	Snapshot + Prognose nebeneinander (Startansicht).
Prognose	/liquidity/prognose	Erwartete Liquiditäts-Entwicklung über die Zeitachse.
Transaktionskalender	/liquidity/transaktionskalender	Erwartete Ein-/Ausgänge im Kalender.
Forderungen	/liquidity/forderungen	Offene Forderungen nach Fälligkeits-Buckets.
Verbindlichkeiten	/liquidity/verbindlichkeiten	Offene Verbindlichkeiten nach Fälligkeits-Buckets.

Voraussetzungen

- Berechtigung `view:Liquidity` (Frontend zusätzlich `view:FE_Liquidity`). - Gepflegte Bankkonten/Salden, offene Posten und Ausgaben — sonst bleibt die Vorschau leer.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Liquidity, Liquidity	Dashboard aufrufbar	APP_SPEAMCORE_VIEW_LIQUIDITY

Was fließt in die Prognose ein?

Der Endpoint GET /api/liquidity/forecast stellt drei Bausteine zusammen:

Baustein	Quelle	Bedeutung
Bank-Salden	Interne Transaktions-Konten + Konto-Salden	Aktueller Kontostand als Startpunkt. Nur interne Konten (keine externen).
Erwartete Ausgaben	Ausgaben (einmalige + wiederkehrende, Verträge, Kredite), Fahrzeug-Leasing, Mitarbeiter-Gehälter	Künftige Abflüsse. Wiederkehrende/Vertrags-Ausgaben werden über die Zeitachse hochgerechnet.
Offene Forderungen	Offene Posten mit Richtung „Forderung"	Erwartete Zahlungseingänge von Kunden, inklusive Skonto-Information; bereits eingegangene Teilzahlungen werden abgezogen.

Aus Start-Saldo minus erwarteten Ausgaben plus erwarteten Eingängen ergibt sich die voraussichtliche Liquidität pro Zeitfenster.

Schritt-für-Schritt-Anleitung

1. Liquidität (/liquidity) öffnen.
2. Links den aktuellen Stand prüfen (Bank-Salden + heutige Bewegungen). Über den Details-Toggle lassen sich die Einzelposten ein- und ausklappen.
3. Rechts die Prognose-Spalten durchgehen — überfällige Posten zuerst, dann die Fälligkeits-Fenster.
4. Beträge sind vorzeichen-basiert dargestellt: Eingänge positiv, Ausgaben negativ.

Felder und Anzeige (lesend)

Bereich	Inhalt
Snapshot „Heute"	Bank-Salden (interne Konten), heutige Ein-/Ausgänge, Details-Toggle.
Prognose	Fälligkeits-Buckets (überfällig, 7 / 14 / 30 Tage) mit erwarteten Ein-/Ausgängen.
Gehalts-Ausgaben	Bei Gehältern wird die Arbeitgeber-Gesamtkosten-Aufschlüsselung mitgeliefert (Dienstwagen-Leasing wird separat als Leasing-Ausgabe geführt).

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Offene Posten / Kunden-OP — Quelle der erwarteten Eingänge.
• Ausgaben — Quelle der erwarteten Abflüsse.
• Transaktions-Konten — Bank-Salden als Startpunkt.
• Transaktions-Cockpit — operative Zuordnung von Bank-Bewegungen.
• BWA / Geschäfts-Analyse — rückblickende Auswertung (Liquidität ist vorausschauend).

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/liquidity/forecast	Prognose-Daten (Bank-Salden, erwartete Ausgaben, offene Forderungen)	view Liquidity

Versionshinweise

• 2026-06-03: Fünf Tabs mit eigenen URLs dokumentiert (Übersicht /liquidity, Prognose, Transaktionskalender, Forderungen, Verbindlichkeiten) — jede Ansicht direkt verlinkbar. Verifiziert an LiquidityDashboardPage.tsx (TABS).
• 2026-06-02: Initiale Veröffentlichung. Eigenständiges Dashboard mit Snapshot- (links) und Prognose-Spalte (rechts), Details-Toggle, vorzeichen-basierten Beträgen. Quelle: FE LiquidityDashboardPage.tsx, BE liquidity.service.ts / liquidity.controller.ts.