---
name: finanzberatung
description: Fünf-Schritte-Workflow für Finanzberatung mit dem Finanzberatungs-Tool — Lage erfassen, Basis-Szenario, Varianten (Kredit/Kürzungen) durchrechnen, vergleichen, Empfehlung mit Zahlen begründen. Use when der Nutzer eine Finanzeinschätzung, Kreditberatung, Sparempfehlung oder Liquiditätsplanung ("reicht das Geld", "brauche ich einen Kredit", "wo kann ich kürzen") anfragt.
---

# Finanzberatung

Beratung erfolgt datengetrieben über das Finanzberatungs-Tool (Skill
`finanz-api` für die API-Details). Kein Rat ohne durchgerechnetes Szenario.

## 1. Lage erfassen

- Konten und aktuelle Salden abrufen (`GET /api/accounts`).
- Unkategorisierte bzw. auffällige Buchungen prüfen (`GET /api/transactions`
  ohne `category_id`-Filter bzw. mit `q`), damit Auswertungen nach Kategorie
  belastbar sind.
- Prüfen, ob wiederkehrende Posten gepflegt sind (`GET /api/recurring`); falls
  lückenhaft, `GET /api/recurring/suggestions` durchgehen und mit dem Nutzer
  bestätigen/verwerfen, bevor weitergerechnet wird.

## 2. Basis-Szenario anlegen/durchrechnen

- Falls noch nicht vorhanden: Basis-Szenario anlegen (`POST /api/scenarios`,
  ohne Modifikatoren, mit vorhandenen wiederkehrenden/geplanten Posten).
- Durchrechnen (`POST /api/scenarios/{id}/project`) und Ergebnis als
  Referenzlinie festhalten (Tiefpunkt, Unterschreitungsdatum falls vorhanden).

## 3. Fragestellung in Varianten übersetzen

- Kreditbedarf: Kredit anlegen (`POST /api/loans` mit Betrag, Zinssatz,
  Laufzeit, Auszahlungsdatum, Tilgungsart) und dem Szenario zuordnen
  (`POST /api/scenarios/{id}/loans/{loan_id}`).
- Kürzungspotenzial: Modifikatoren je Kategorie oder wiederkehrendem Posten
  anlegen (`POST /api/scenarios/{id}/modifiers`, `target_type`
  `category`|`recurring`, `kind` `percent`|`absolute`|`remove`).
- Für jede Fragestellung ein eigenes Szenario (Kopie der Idee, nicht das
  Basis-Szenario verändern), damit Varianten unabhängig vergleichbar bleiben.

## 4. Varianten durchrechnen

- Jede Variante mit `POST /api/scenarios/{id}/project` (gleicher Horizont wie
  das Basis-Szenario, damit die Vergleichswerte konsistent sind) durchrechnen.
- Bei Kredit-Varianten zusätzlich den Tilgungsplan ziehen
  (`GET /api/loans/{id}/schedule`) für Gesamtzinskosten und Ratenhöhe.

## 5. Vergleichen und Empfehlung formulieren

- Vergleichstabelle je Variante: Tiefpunkt (Datum + Betrag),
  Unterschreitungsdatum (Null bzw. Warnschwelle), bei Krediten
  Gesamtzinskosten und monatliche Rate aus dem Tilgungsplan.
- Empfehlung immer mit diesen Zahlen begründen, nicht nur qualitativ.
- Hinweis an den Nutzer: Das Grafana-Dashboard „Szenario-Vergleich“
  (http://127.0.0.1:8097) zeigt die Verlaufskurven der Varianten übereinander
  mit Nulllinie und Warnschwelle — für die visuelle Gegenprobe verlinken bzw.
  empfehlen, dort nachzusehen.

## Grundregeln (siehe auch CLAUDE.md)

- Echte, bestätigte Buchungen nie ändern — Korrekturen nur als
  Kategorie-Anpassung.
- Zukunftsplanung ausschließlich über Szenarien, nie am Basis-Datenbestand.