bin/finance/app/templates/hilfe.html

{% 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.
    Varianten wie „Best Case“ pflegst du in der Tabelle „Einträge“ des
    Szenarios: Art „Ende“ lässt einen wiederkehrenden Posten (z. B. eine
    auslaufende Miete) zu einem Datum enden, ohne den Posten selbst zu
    ändern; „Prozent“/„Absolut“ kürzen Beträge; „Entfällt“ blendet sie ganz
    aus; „Einmalzahlung“ ergänzt einen einmaligen Zu- oder Abfluss, der nur
    in diesem Szenario zählt. Jeder Eintrag ist über „Bearbeiten“ direkt
    änderbar. Ein Szenario lässt sich über „Löschen“ mit allen Einträgen
    wieder entfernen. Bereits durchgerechnete Szenarien werden automatisch
    mit dem Standard-Horizont neu gerechnet, sobald ihre Projektion nicht
    mehr bei heute beginnt (z. B. nach ein paar Tagen Inaktivität) – das
    passiert beim nächsten Aufruf der Übersicht oder der Szenarien-Seite.
  </li>
  <li>
    <strong>Grafana:</strong> Kontostand-Verläufe, Monatsausgaben nach
    Kategorie, der Szenario-Vergleich als Kurven (darin die Ist-Kurve
    „System-Ist“ bis heute, ab heute je Szenario weiter) und das Panel
    „Planung nach Kategorie“ (Monatssummen aus der reinen Planung inkl.
    „System-Kreditraten“, ohne Szenario-Modifikatoren) – einmal mit demselben
    Passwort wie hier anmelden, dann erscheint das Dashboard auch in der
    Übersicht.
  </li>
  <li>
    <strong>Aufteilung:</strong> zeigt für einen Monat, welche monatlichen
    Kosten je Kategorie anfallen und wie viel der Einkünfte frei verfügbar
    bleibt. Grundlage ist immer die Planung (Fixposten, Einmalposten,
    Kredite), nie die tatsächlichen Buchungen: „System-Plan" rechnet mit
    allen Posten und Krediten ohne Szenario-Änderungen und ist für jeden
    Monat wählbar; ein Szenario (mit seinen Änderungen und Krediten) erst ab
    dem laufenden Monat. Fixposten werden auf den Monat umgerechnet
    (vierteljährlich ÷ 3, jährlich ÷ 12), Einmalposten und Kreditraten zählen
    voll im Monat ihrer Fälligkeit, eine Kredit-Auszahlung zählt nicht als
    Einkunft. Die Häkchen „Fixposten", „Einmalposten", „Kredite" gelten für
    Einnahmen und Ausgaben. Das Tortendiagramm zeigt die Einkünfte (Kosten je
    Kategorie plus „Frei verfügbar"); übersteigen die Kosten die Einkünfte,
    zeigt es die Gesamtkosten. Kleine Kategorien (unter 3 %, bzw. ab der
    neunten) sind zu „Übrige" zusammengefasst – höchstens 8 benannte
    Kategorien plus „Übrige" und „Frei verfügbar". Ein Klick auf ein Segment oder
    einen Legendeneintrag zeigt darunter die Posten dieser Kategorie.
  </li>
</ul>

<p>
  <strong>Reservierte Namen:</strong> Kategorien und Szenarien dürfen nicht
  mit „System-“ beginnen – dieses Präfix ist für vom Tool erzeugte Einträge
  reserviert (z. B. die Ist-Serie „System-Ist“ und die Kreditraten-Serie
  „System-Kreditraten“ in Grafana). Ein Versuch, einen eigenen Namen mit
  diesem Präfix anzulegen, wird abgelehnt.
</p>

<p>
  <strong>Doppelzählungs-Warnung:</strong> beim Anlegen oder Ändern eines
  wiederkehrenden Postens oder eines Kredits prüft das Tool, ob ein
  monatlicher Ausgabe-Posten ungefähr einer regulären Kreditrate entspricht
  (Betrag innerhalb ±3 %, mindestens 1 €, mit überlappendem Zeitraum). Trifft
  das zu, erscheint ein Warnfenster – erst ein Klick auf „Trotzdem
  speichern“ übernimmt den Eintrag. Solange der Konflikt bestehen bleibt,
  zeigt die Planungs-Seite dauerhaft einen ⚠-Hinweis bei den betroffenen
  Posten und Krediten an. Am saubersten lässt sich das vermeiden, wenn
  Kreditraten ausschließlich über „Kredite“ gepflegt werden statt zusätzlich
  als wiederkehrender Posten.
</p>

<p>
  <strong>Tabellen sortieren:</strong> ein Klick auf einen Spaltenkopf
  sortiert die Tabelle danach (⇅ unsortiert, ▲ aufsteigend, ▼ absteigend);
  bei der Buchungsliste wirkt das über alle Seiten, nicht nur auf die
  aktuell angezeigte.
</p>

<p>
  Planungs-Diagramm und automatisches Neurechnen werden beim Öffnen von
  Übersicht, Planung oder Szenarien aktualisiert – Änderungen über die API
  erscheinen also erst nach dem nächsten Seitenaufruf.
</p>

<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 %}