{% extends "base.html" %}
{% block title %}Hilfe – Finanzberatung{% endblock %}
{% block content %}
<h1>Gebrauchsanleitung</h1>

<h2>Was dieses Tool ist</h2>
<p>
  Liquiditätsplanung auf Basis echter Kontoauszüge: Ist-Stand aus importierten
  Auszügen, Zukunft aus gepflegten Planposten und durchgerechneten Szenarien.
</p>

<h2>Konzepte</h2>
<ul>
  <li>
    <strong>Konten:</strong> entstehen automatisch beim ersten Import (per IBAN).
    Über die Übersicht umbenennbar (z. B. "DKB Giro").
  </li>
  <li>
    <strong>Kontoauszug-Import:</strong> primärer Weg ist der
    Kontoumsatz-CSV-Export der Bank (DKB, VR-Bank, HypoVereinsbank) – in die
    Drop-Zone auf der Import-Seite ziehen (oder in die Inbox
    <code>~/.local/share/finance_pod/data/inbox/</code> legen und "Inbox
    scannen"). PDF-Kontoauszüge funktionieren weiterhin als Fallback, falls
    kein CSV-Export vorliegt. Jeder Import landet als Entwurf: erst nach
    Kontrolle der Vorschau "Übernehmen" klicken. Der Saldo-Status in der
    Vorschau ist dreiwertig – "Saldo plausibel" (Anfangssaldo + Buchungen =
    Endsaldo bzw. lückenlose Saldo-Kette), eine rote Saldo-Differenz, oder
    "Saldo-Prüfung nicht verfügbar", wenn das Format (z. B. HVB-CSV) keine
    Saldodaten liefert – dort lohnt ein Blick in die Zeilenzahl und
    Stichproben vor dem Übernehmen. CSV-Importe mit Datei-Kontostand (DKB)
    oder lückenloser Saldo-Kette (VR) aktualisieren beim Import automatisch
    den Konto-Saldo-Anker, sofern er dadurch nicht älter würde als ein bereits
    vorhandener. Duplikate werden erkannt und nicht doppelt übernommen.
    Bestätigte Importe lassen sich als Ganzes zurückrollen (Auszug + alle
    seine Buchungen), z. B. um einen Auszug mit einem verbesserten Parser neu
    zu importieren; einzelne Buchungen bleiben unlöschbar.
  </li>
  <li>
    <strong>Salden-Seite:</strong> zeigt den Saldo je Konto zu einem
    wählbaren Stichtag (Default: heute) sowie eine Monatsanfangs-Übersicht
    vom frühesten Buchungsmonat bis heute, absteigend. Die
    Monatsanfangs-Werte gelten "Stand: Ende des Vortags" (letzter Tag des
    Vormonats), damit Buchungen am 1. eines Monats den Ausweis des
    Monatsanfangs nicht verfälschen. Konten ohne Anker sind mit "ohne Anker —
    relative Werte" gekennzeichnet.
  </li>
  <li>
    <strong>Kategorien &amp; Regeln:</strong> Buchungen lassen sich kategorisieren;
    eine Regel ("Muster im Text → Kategorie") kategorisiert künftige Importe
    automatisch. Regel direkt aus einer Buchung erzeugen: Button in der
    Buchungsliste.
  </li>
  <li>
    <strong>Wiederkehrende Posten:</strong> Miete, Gehalt, Abos – mit Rhythmus
    (monatlich/quartalsweise/jährlich) und Fälligkeitstag. Der
    Vorschlags-Knopf erkennt Kandidaten aus mind. 3 Monaten gleichartiger
    Buchungen.
  </li>
  <li>
    <strong>Einmalposten:</strong> einzelne künftige Zahlungen (z. B.
    Steuernachzahlung).
  </li>
  <li>
    <strong>Kredite:</strong> Annuität oder endfällig; Tilgungsplan
    aufklappbar. Ein Kredit wirkt erst, wenn er einem Szenario zugeordnet ist.
  </li>
  <li>
    <strong>Szenarien:</strong> eine "Was-wäre-wenn"-Rechnung. Basis = alle
    wiederkehrenden Posten + Einmalposten. Varianten entstehen durch Zuordnen
    von Krediten und Modifikatoren (Kategorie oder Posten prozentual/absolut
    kürzen oder ganz streichen). "Durchrechnen" liefert: tiefster Kontostand
    mit Datum, erstes Datum unter 0 und unter der Warnschwelle.
  </li>
  <li>
    <strong>Grafana:</strong> Kontostand-Verläufe, Monatsausgaben nach
    Kategorie und der Szenario-Vergleich als Kurven (einmal mit demselben
    Passwort wie hier anmelden, dann erscheint das Dashboard auch in der
    Übersicht).
  </li>
</ul>

<h2>Empfohlener Arbeitsablauf</h2>
<ol>
  <li>Monatlich: neue Auszüge importieren, Vorschau prüfen, übernehmen.</li>
  <li>
    Unkategorisierte Buchungen durchsehen; für Wiederkehrendes Regeln
    anlegen.
  </li>
  <li>Planung pflegen: Vorschläge prüfen, Einmalposten eintragen.</li>
  <li>
    Fragestellung ("Können wir uns X leisten?") als Szenario-Varianten
    abbilden und durchrechnen; Entscheidung anhand Tiefpunkt und
    Unterschreitungsdaten treffen, Kurven in Grafana vergleichen.
  </li>
</ol>

<h2>Grundregeln</h2>
<ul>
  <li>Bestätigte Buchungen sind die Wahrheit – nie ändern, nur kategorisieren.</li>
  <li>Zukunft ausschließlich über Szenarien planen.</li>
  <li>Empfehlungen immer mit durchgerechneten Zahlen begründen.</li>
</ul>
{% endblock %}