FINANZSTRUKTUR KAPITALVERWALTUNG
Version 2026.17.0 · Stand: 19. Juni 2026
www.privatbilanz.de/werkstatt/


WAS IST DAS HIER?
=================

FINANZSTRUKTUR Kapitalverwaltung ist ein Single-File-HTML-Programm
zur Verwaltung der Kapitalseite einer Unternehmensgruppe. Es bildet
folgende Geschäftsvorfälle einheitlich ab:

  - Darlehen (aufgenommen und gegeben, einschliesslich gruppen-
    interner Vergaben),
  - Geldanlagen (Giro, Tagesgeld, Festgeld, Wertpapierdepots),
  - Sicherheiten und Avale,
  - Kontensalden mit historischer Saldenentwicklung,
  - Snapshots fuer Stichtagsbilanzen und Was-Waere-Wenn-Szenarien.

Die Anwendung laeuft vollstaendig lokal im Browser. Es findet keine
Erhebung und keine Uebertragung von Eingabe- oder Berechnungsdaten
an Server des Entwicklers oder Dritter statt. Alle Daten verbleiben
auf dem Geraet des Nutzers, bis dieser sie selbst speichert,
exportiert oder weitergibt. Eine Internetverbindung ist nicht
erforderlich (Schriften und Logo sind Base64-eingebettet).


CHARAKTER DIESER ANWENDUNG (WICHTIG)
====================================

Diese Software ist Teil der WERKSTATT auf privatbilanz.de -- einem
bewusst vom Hauptprojekt "Finanzstruktur-Programmfamilie" getrennten
Bereich. Sie ist eine MACHBARKEITSSTUDIE FUER DIE EIGENVERWENDUNG
des Lizenzgebers. Sie ist nicht fuer den ungeprueften Einsatz in
externer Beratung, Buchhaltungsverpflichtungen oder berufsstaendischen
Stellungnahmen vorgesehen.

Die Berechnungen beruhen auf vereinfachenden Modellannahmen
(z. B. 30/360- oder taggenaue Tageszaehlung, konstante Annuitaet
nach Zinsanpassung, bei Anlagen standardmaessig einfache Zinsen
(optional thesaurierend/zinseszinslich je Anlage), lineare
Interpolation der Restschuld zwischen Periodengrenzen).
Wer die Software im beruflichen Kontext einsetzt, ist allein
verantwortlich fuer die Validierung der Rechenwege, der Annahmen
und der Ergebnisse anhand der einschlaegigen Standards (HGB,
Steuerrecht, vertragliche Konditionen). Eine eigene fachliche
Plausibilisierung ist in jedem Fall erforderlich.

Die vollstaendigen Lizenzbedingungen finden Sie in der begleitenden
Datei "Lizenzbedingungen_Werkstatt.txt" und unter
www.privatbilanz.de/werkstatt/lizenz.html.


SYSTEMVORAUSSETZUNGEN
=====================

  - Moderner Webbrowser (Chrome, Firefox, Edge) ab ca. 2022.
    Hinweis Safari: Beim Oeffnen per Doppelklick (file://) stellt Safari
    die fuer die Passwort-Anmeldung benoetigte Verschluesselungs-
    Schnittstelle nicht bereit -- die Anmeldung schlaegt dort fehl.
    Unter Safari die Datei daher ueber einen lokalen Webserver
    (http://localhost) oeffnen; Chrome, Firefox und Edge funktionieren
    per Doppelklick problemlos.
  - Betriebssystem: Windows, macOS, Linux (alle aktuellen Versionen)
  - Kein Internet-Zugang erforderlich (Schriften und Logo sind
    vollstaendig in die Datei eingebettet)
  - Keine Installation -- einmal die HTML-Datei oeffnen genuegt
  - Drucker oder PDF-Export fuer die Berichtsausgabe (DIN A4 quer
    und hoch)


ERSTE SCHRITTE
==============

  1. Datei "Finanzstruktur_Kapitalverwaltung_2026_17_0.html" mit
     einem Doppelklick oeffnen (oder: Rechtsklick -> "Oeffnen mit
     Browser").

  2. Beim Erststart richtet der Admin sein Passwort selbst ein
     (Mindestlaenge 8 Zeichen). Es wird ausschliesslich als
     SHA-256-Hash in der HTML-Datei abgelegt; der Klartext verlaesst
     den Browser nicht.

  3. Nach dem Setup unbedingt die HTML-Datei einmal speichern
     (Schaltflaeche "Speichern" oben rechts oder Strg+S). Sonst
     geht der Admin-Hash beim naechsten Oeffnen verloren.

  4. Stammdaten anlegen in dieser Reihenfolge:
     Unternehmen -> Geschaeftspartner -> Sicherheiten -> Darlehen /
     Anlagen / Avale.

  5. Sub-Bereiche im Menue:

         Start             Tagesaktuelle Kacheln (Stammdaten-Status,
                           Konzentration, Zinsbindung, etc.)
         Schnellaufruf     Chef-Tagesuebersicht (Banksalden, Darlehen,
                           Anlagen, Sicherheiten) zum gewaehlten Stichtag
         Stammdaten        Unternehmen, Geschaeftspartner, Musterver-
                           traege
         Darlehen          Liste und Detail mit Tilgungsplan, Sonder-
                           tilgungen, Zinsanpassungen, Tilgsatzwechseln,
                           Tilgungs-Aussetzungen, Umschuldungen, Gebuehren
         Anlagen           Liste und Detail mit Salden-Historie
         Sicherheiten      Sicherheiten und Avale
         Auswertungen      Bestand, Zinsvorschau, Faelligkeitsstaffel,
                           Cashflow, gruppeninterne Forderungen,
                           Gruppenbericht, Zinsrisiko, Mehrjahres-Verlauf,
                           Effektivzins-Vergleich, Quartalsstichtage,
                           Bank-Konzentration, Konditionsvergleich
         Administration    Benutzer, Snapshots, Persistenz (JSON/HTML
                           Speichern und Laden)

  6. Bei jedem Listeneintrag fuehrt der Detail-Button zur Detail-
     Karte. Innerhalb der Detail-Karte gibt es weitere Sub-Tabs
     (z. B. Tilgungsplan, Sondertilgungen, Vertragsentwurf).

  7. Speichern ueber die Schaltflaeche "Speichern" oben rechts oder
     mit Strg+S. Die erzeugte HTML-Datei enthaelt das komplette Tool
     samt eingegebenen Daten in einer einzigen Datei -- keine Daten
     werden extern gespeichert. Zum Wiederoeffnen genuegt ein
     Doppelklick auf die gespeicherte Datei.

  8. Fuer die Uebergabe von Datenbestaenden an Dritte oder fuer
     Archive steht in der Administration zusaetzlich ein JSON-Export
     und -Import zur Verfuegung. JSON laesst die Tool-Version
     unberuehrt; HTML-Speichern persistiert auch die aktuelle
     Programmlogik.

  9. Volltext-Suche im Header: Mit Strg+K oder Cmd+K direkt ins
     Suchfeld springen. Die Suche durchsucht Unternehmen, Geschaefts-
     partner, Darlehen, Anlagen, Sicherheiten, Bewertungsobjekte, Avale
     und Mustervertraege (einschliesslich der Gebuehrentexte der
     Darlehen). Mehrere Worte werden als UND verknuepft, Treffer werden
     nach Relevanz sortiert.


BENUTZERVERWALTUNG
==================

Das Tool kennt zwei Rollen:

  - Admin: voller Zugriff auf alle Bereiche, kann Benutzer anlegen,
    bearbeiten, deaktivieren, loeschen und Passwoerter zuruecksetzen.

  - Normaler Nutzer: granular eingeschraenkte Rechte je Bereich,
    Stammdaten-Modul, Auswertungs-Sub-Tab und Aktion; optional auf
    eine Auswahl von Unternehmen ("Firmenfreigabe") eingeschraenkt.

Beim Anlegen eines neuen Nutzers kann der Admin entweder ein
Initial-Passwort vergeben (Mindestlaenge 8 Zeichen) oder das Feld
leer lassen. In letzterem Fall richtet der Nutzer beim ersten Login
sein Passwort selbst ein -- das Klartext-Passwort wird nirgendwo
gespeichert oder mitgeteilt.

In der Benutzerliste kann der Admin jederzeit ueber die Schaltflaeche
"Passwort zuruecksetzen" das Passwort eines Nutzers aufheben. Beim
naechsten Login muss der Nutzer dann erneut ein eigenes Passwort
vergeben. Das ist der empfohlene Weg, wenn ein Nutzer sein Passwort
vergessen hat: Der Admin setzt zurueck, der Nutzer richtet beim
naechsten Login eigenstaendig wieder ein.

Hinweis: Nach jeder Aenderung am Benutzerbestand (Anlegen, Aendern,
Passwort-Reset, Loeschen, eigene Passwort-Einrichtung) muss die
HTML-Datei einmal gespeichert werden, damit die Aenderung erhalten
bleibt.


PASSWORT-RICHTLINIEN
====================

  - Admin-Passwort: mindestens 8 Zeichen.
  - Benutzer-Passwort: mindestens 8 Zeichen, darf nicht dem
    Anmeldenamen entsprechen.
  - Alle Passwoerter werden ausschliesslich als SHA-256-Hash in
    der HTML-Datei gespeichert. Es gibt keinen Salt-Mechanismus und
    keinen Schutz vor Brute-Force-Angriffen, sofern ein Angreifer
    die HTML-Datei lokal vorliegen hat. Die Datei sollte daher nur
    in einer geschuetzten Umgebung gespeichert werden.


PERSISTENZ-MODELL
=================

Das Tool kennt zwei Speicher-Varianten:

  - HTML-Speichern: Schreibt die aktuellen Daten zurueck in die
    HTML-Datei. Empfohlen fuer den laufenden Arbeitsstand. Die
    Funktion oeffnet einen Datei-Speichern-Dialog des Browsers
    (sofern die File System Access API verfuegbar ist; sonst
    Standard-Download).

  - JSON-Export: Schreibt nur die Daten als JSON-Datei. Bewusst
    ohne Programmcode -- geeignet fuer Archive, Versionskontrolle
    oder die Uebergabe an einen anderen Tool-Stand. Beim spaeteren
    Import in einer anderen Tool-Version greift die Schema-Migration
    additiv (neue Felder werden mit Defaults vorbelegt, fehlende
    Felder unveraendert uebernommen).

Zusaetzlich koennen Snapshots erstellt werden (Administration ->
Snapshots). Ein Snapshot ist ein eingefrorener Datenstand mit
Zeitstempel und Bezeichnung. Snapshots koennen separat als JSON
exportiert und spaeter wieder importiert werden.


FACHLICHER LEISTUNGSUMFANG (AUSWAHL)
====================================

  - Tilgungsplanberechnung fuer Annuitaeten-, Tilgungs- und
    endfaellige Darlehen sowie Kontokorrentkredite (saldobasiert);
    Tilgungsaussetzungen, Sondertilgungen, Tilgsatzwechsel, Zins-
    anpassungen und Umschuldungen werden im Plan eingebaut.
  - Darlehensanpassungen je Darlehen: Aufstockung (Nachtrag zum
    Vertrag, Summe wird zu einem Datum um Betrag X erhoeht; reale
    Auszahlung im Effektivzins; Rate wahlweise konstant oder Annuitaet
    neu bis Vertragsende) und einmalige Korrektur (technischer Zu-/
    Abgang zum Stichtagsabgleich an die Bankvaluta, ohne Cashflow).
    Beide erscheinen als eigene Zeile im Tilgungsplan.
  - Tageszaehlmethoden: 30/360 (europaeisch), act/360, act/365,
    act/act.
  - Effektivzins nach Preisangabenverordnung (Newton-Raphson auf
    den Cashflow-Vektor inkl. Gebuehren).
  - Disagio (Damnum) je Darlehen wahlweise anteilig je Auszahlungs-
    tranche oder vollstaendig bei der ersten Auszahlung verbucht;
    wirkt entsprechend auf die Cashflow-Verteilung und damit auf den
    Effektivzins.
  - Gebuehren: einmalige und jaehrliche Gebuehren mit anteiliger
    Verteilung im Erstjahr und im letzten Jahr.
  - Zinsbindungs-Markierung im Tilgungsverlauf und ein eigenes
    Zinsbindungs-Auslauf-Bar-Diagramm.
  - Konzentrationsanalyse Bank x Unternehmen (Donut-Diagramme,
    Heatmap).
  - Cashflow-Wasserfall fuer die Zinsvorschau.
  - Stacked-Bar Bestand je Unternehmen.
  - Konditionsvergleich (Modellrechner) fuer Soll-/Ist-Konditionen
    bei Verhandlungen mit Banken.
  - Saldenverlauf-Modal mit 30 / 90 / 180 / 360-Tage-Ansicht.
  - Restschuldverlauf-Modal mit 1 / 5 / 10 / 20-Jahres-Ansicht.
  - Vertragsentwurf je Darlehen aus Mustervertrag-Klauseln.
  - Druckansicht (Strg+P) mit DIN-A4-Layout fuer alle Auswertungen.
  - Selbsttest der Rechen-Engine und Plausibilitaetspruefung des
    Datenbestands im Administrationsbereich (laufen in-browser, ohne
    externe Hilfsmittel).


KONTAKT UND FEEDBACK
====================

  Das Tool ist Freeware und wird privat entwickelt. Rueckmeldungen,
  Fehlerhinweise und Anregungen sind willkommen -- per E-Mail an
  info@privatbilanz.de oder ueber die Projektseite
  www.privatbilanz.de.

  Der Entwickler erteilt keine individuellen Auskuenfte zu Ihrer
  konkreten steuerlichen, rechtlichen oder bilanziellen Situation
  und kann sich dazu auch nicht aeussern. Bitte richten Sie solche
  Fragen an eine dafuer zugelassene Berufsperson (Steuerberater,
  Wirtschaftspruefer, Rechtsanwalt).

  Wer die Weiterentwicklung unterstuetzen moechte, kann dies auf
  zwei Wegen tun. Der Hinweis befindet sich auf der Webseite
  www.privatbilanz.de an einer von Download und Produktinformation
  raeumlich getrennten Stelle:

    - Zuwendung ueber PayPal (als Spende gekennzeichnet). Die
      Zahlungsabwicklung erfolgt durch PayPal (Europe) S.a r.l. et
      Cie, S.C.A., Luxemburg.

    - Zuwendung per Bankueberweisung (SEPA). Die Kontodaten werden
      auf kurze E-Mail-Anfrage an info@privatbilanz.de mitgeteilt.

  Die Zuwendung ist ausdruecklich freiwillig, in keiner Weise
  Voraussetzung fuer die Nutzung der Software und rechtlich eine
  Schenkung im Sinne des Paragraph 516 BGB.


NUTZUNGSBEDINGUNGEN (KURZFASSUNG)
=================================

  Massgeblich sind allein die vollstaendigen Lizenzbedingungen in der
  begleitenden Datei "Lizenzbedingungen_Werkstatt.txt" (Stand 14. Juni
  2026) bzw. unter
  www.privatbilanz.de/werkstatt/lizenz.html. Die folgende Kurzfassung
  dient nur der schnellen Orientierung und hat im Zweifel keinen
  Vorrang vor jener
  Datei. Mit dem Herunterladen, dem Aufruf im Browser oder der
  sonstigen Inbetriebnahme erklaert sich der Nutzer mit den Lizenz-
  bedingungen einverstanden; wer ihnen nicht zustimmt, darf die
  Software nicht nutzen.

  Erlaubt ist insbesondere:

    - Oeffnen und Verwenden der Software auf eigenen Endgeraeten zur
      eigenen fachlichen Auseinandersetzung mit der Kapital- und
      Finanzstruktur der eigenen bzw. der betreuten Unternehmensgruppe.
    - Anfertigen von Sicherungskopien (Paragraph 69d UrhG).
    - Betrachten des Programmcodes im Rahmen der gesetzlichen Schranken.
    - Nutzung im beruflichen Kontext -- jedoch nur unter eigener
      fachlicher Validierung der Rechenwege und Ergebnisse (siehe
      Abschnitte "CHARAKTER DIESER ANWENDUNG" und "RECHTLICHE HINWEISE").

  Ohne vorherige schriftliche Zustimmung des Lizenzgebers nicht
  gestattet ist insbesondere:

    - Weitergabe, Verbreitung oder oeffentliches Zugaenglichmachen der
      Datei an Dritte; stattdessen ist auf die Bezugsquelle zu
      verweisen, damit stets die aktuelle Fassung genutzt wird.
    - Bearbeitung, Dekompilierung oder Reverse Engineering ueber die
      gesetzlich zwingenden Schranken (Paragraph 69d, 69e UrhG) hinaus.
    - Einbau der Software oder ihrer Ergebnisse in eigene entgeltliche
      Beratungs-, Bewertungs- oder Buchhaltungsleistungen.
    - Verwendung der Ergebnisse als alleinige Grundlage berufs-
      staendischer Stellungnahmen, Gutachten, Steuererklaerungen,
      Jahresabschluesse oder Auskuenfte gegenueber Banken und Behoerden.
    - Entfernen oder Veraendern von Urheberrechtsvermerken, Versions-
      angaben, Lizenz- und Haftungshinweisen.

  Die Software ist Freeware und wird "wie besehen" (as is) ueber-
  lassen; ein Anspruch auf Pflege, Aktualisierung, Fehlerkorrektur
  oder Support besteht nicht.


RECHTLICHE HINWEISE
===================

  Keine Steuerberatung -- Keine Rechtsberatung -- Keine Anlage-
  beratung -- Keine bilanzielle oder pruefungsnahe Bestaetigung.

  Der Entwickler ist weder Steuerberater noch Wirtschaftspruefer,
  Rechtsanwalt oder Sachverstaendiger und verfuegt ueber keine
  entsprechende berufsrechtliche Zulassung. Er ist insbesondere
  nicht zur geschaeftsmaessigen Hilfeleistung in Steuersachen im
  Sinne des Paragraph 3 Steuerberatungsgesetz (StBerG) befugt und
  erbringt keine Rechtsdienstleistungen im Sinne des Rechtsdienst-
  leistungsgesetzes (RDG).

  Die Software ist ein neutrales, modellhaftes Rechen-, Dokumen-
  tations- und Darstellungswerkzeug fuer die Kapitalseite einer
  Unternehmensgruppe. Sie strukturiert den Prozess der Darlehens-
  und Anlagenverwaltung, dokumentiert die vom Anwender getroffenen
  Annahmen und fuehrt die definierten Rechenwege transparent aus.
  Sie ersetzt jedoch in keinem Punkt die fachliche Verantwortung
  des Anwenders fuer die methodischen Entscheidungen -- insbesondere
  fuer die Eingabe der Vertragskonditionen, die Auswahl der
  Tageszaehlmethode, die Behandlung von Sondertilgungen und Gebuehren
  sowie die Plausibilisierung der Ergebnisse gegen Bankauskuenfte
  oder Buchhaltungssalden.

  Hinweis zur Eingabe-Konvention: Numerische Eingaben werden im
  deutschen Zahlenformat (Komma als Dezimaltrenner, Punkt als
  Tausendertrenner) erwartet. Die Anwendung erkennt auch das
  englische Format heuristisch am letzten Trennzeichen, eine
  visuelle Pruefung der Eingaben bleibt aber erforderlich.

  Keine Gewaehr fuer Richtigkeit, Vollstaendigkeit und Aktualitaet.
  Kein Support, keine Pflege, keine Aktualisierung zugesichert.
  Die Nutzung erfolgt ausschliesslich auf eigene Verantwortung und
  eigenes Risiko. Jede Haftung fuer unmittelbare oder mittelbare
  Schaeden, entgangene Gewinne oder Folgeschaeden aus der Nutzung
  oder Nichtnutzung ist ausgeschlossen; davon unberuehrt bleibt die
  Haftung fuer Vorsatz und grobe Fahrlaessigkeit sowie fuer Schaeden
  aus der Verletzung des Lebens, des Koerpers oder der Gesundheit.
  Da die Software unentgeltlich als Freeware bereitgestellt wird,
  gelten ergaenzend die Haftungserleichterungen aus Paragraph 521
  BGB (Schenkung).

  (c) 2026 Andreas Ebert -- Urheberrechtlich geschuetzt
  (Paragraph 69a UrhG)


DRITT-KOMPONENTEN UND LIZENZEN
==============================

  Die HTML-Datei ist eine vollstaendig in sich geschlossene Anwendung
  (Single-File-HTML). Sie enthaelt ausschliesslich eigene Programm-
  logik, das Logo als Eigenmarke sowie zwei freie Schriftarten unter
  SIL Open Font License (OFL 1.1):

    - DM Sans
      (c) Google Fonts (Indian Type Foundry, Google).
      Lizenz: SIL Open Font License, Version 1.1.

    - JetBrains Mono
      (c) JetBrains s.r.o.
      Lizenz: SIL Open Font License, Version 1.1.

  Beide Schriften sind als Base64-WOFF2 in den <style>-Block der
  HTML-Datei einkompiliert und werden ohne Netzwerk-Zugriff aus-
  geliefert. Der vollstaendige Lizenztext der OFL 1.1 ist abrufbar
  unter:

    https://scripts.sil.org/OFL

  Die OFL erlaubt insbesondere die Weitergabe der Schriften als Teil
  eines anderen Werks (hier: als Base64-Einbettung in einer HTML-
  Anwendung), sofern die Schriften nicht unter ihrem urspruenglichen
  Namen verkauft werden. Davon unberuehrt bleibt, dass die Weitergabe
  der Gesamt-Anwendung den Beschraenkungen der Werkstatt-Lizenz
  unterliegt (siehe "Lizenzbedingungen_Werkstatt.txt", Ziffer 3); die
  OFL-Erlaubnis betrifft allein die beiden Schriften, nicht das Werk
  als Ganzes.

  Ueber die beiden OFL-Schriften hinaus enthaelt die Anwendung KEINE
  Dritt-Komponenten -- keine Bibliotheken, kein jQuery, kein Charting-
  Framework, keine externen Web-Fonts, keinen Telemetrie- oder
  Analytics-Code. Saemtliche Diagramme (Donut, Heatmap, Cashflow-
  Wasserfall, Sparklines, Zinsbindungs-Bar u. a.) sind handgezeichnetes
  SVG. Alle Rechen-, Render-, Wizard- und Persistenz-Routinen sind
  Eigenentwicklung im Sinne von Paragraph 69a UrhG und unterliegen den
  Bedingungen in "Lizenzbedingungen_Werkstatt.txt".
