Finanzmanager/docs/stammdaten.md

Stammdaten

Konten, Kontengruppen, Kategorien und Klassen – die Grundlage aller Buchungen und Auswertungen. Die Begriffe entsprechen dem Lexware FinanzManager.

Kontengruppen und Konten

Kontengruppen gliedern die Kontenübersicht (etwa „Anlage“). Konten ohne Gruppe erscheinen unter Nicht gruppiert – das ist keine eigene Gruppe, sondern kontengruppe_id IS NULL. Wird eine Gruppe gelöscht, bleiben ihre Konten erhalten und rutschen dorthin (ON DELETE SET NULL).

Gruppen werden wie Konten und Kategorien auf einer eigenen Formularseite gepflegt (Verwaltung → Kontengruppen). Dort hängt auch die Zuordnung: Die Konten der Gruppe werden angekreuzt, Kontengruppe::kontenZuordnen() setzt sie in einem Zug. Ein Konto gehört zu genau einer Gruppe – wird es hier angehakt, verlässt es seine bisherige.

Der QIF-Export enthält keine Kontengruppen (siehe docs/qif-import.md); nach einem Import stehen deshalb alle Konten unter „Nicht gruppiert“ und werden einmalig zugeordnet.

Kontoarten (Konto::ARTEN) und ihre Herkunft aus dem QIF-Export (Konto::QIF_ARTEN):

Kontoart	Bezeichnung	QIF-Typ
bank	Bank	Bank
kreditkarte	Kreditkarte	CCard
bar	Bar	Cash
sparkonto	Tagesgeld/Sparkonto	Oth T
vermoegen	Vermögen	Oth A
verbindlichkeit	Verbindlichkeit	Oth L
rente	Rentenversicherung	Oth P
sonstiges	Sonstiges Vermögen	Oth E, Oth F
depot	Depot	Port, Invst

Die Kontenübersicht (Konto::uebersicht()) bündelt nach Gruppe, bildet je Gruppe eine Summe und darunter die Gesamtsumme. Sie führt schon jetzt die drei Saldospalten des FinanzManagers:

• Online-Saldo – Stand des letzten Bankabrufs, bleibt bis Phase 5 leer
• Aktueller Saldo – gebuchte Umsätze bis heute
• Erwarteter Saldo – einschließlich künftig datierter Buchungen

Solange es keine Buchungen gibt (bis Phase 2), entsprechen alle drei dem Anfangssaldo. Die Werte entstehen zentral in Konto::mitSalden(); dort kommen in Phase 2 die Buchungen dazu, ohne dass die Aufrufer sich ändern.

Anfangssalden stehen nicht im QIF-Export. Sie werden nach dem Import je Konto im Kontoformular nachgetragen.

Kategorien

Hierarchisch, Trenner ist : wie im FinanzManager. name hält den Blattnamen, pfad den vollständigen Namen (400 - Leben:B-Essen alleine). Der Pfad steht redundant in der Tabelle, weil praktisch jede Anzeige, jede Auswahl und der gesamte Import darüber laufen; Umbenennen und Verschieben schreiben die Pfade des ganzen Teilbaums neu (Kategorie::pfadeNeuAufbauen()).

Regeln:

• Die Art (Einnahme/Ausgabe) gilt für den ganzen Ast. Unterkategorien erben sie, und ein Wechsel an der Wurzel zieht alle Nachfahren mit.
• Ein Name darf keinen Doppelpunkt enthalten – der trennt die Ebenen.
• Eine Kategorie kann nicht unter ihren eigenen Teilbaum verschoben werden.
• Zusammenführen hängt die Unterkategorien der Quelle unter das Ziel und löscht die Quelle. Ab Phase 2 wandern dort auch die Buchungen mit.
• Löschen nimmt die Unterkategorien mit (ON DELETE CASCADE). Wer eine Kategorie nur aus den Auswahllisten nehmen will, setzt sie auf inaktiv.

Die Oberfläche hat die vier Register des Originals: Alle, Einnahmen, Ausgaben, Umbuchungskonten. Umbuchungskonten sind keine Datensätze – dort stehen die Konten, weil sie in der Kategorieauswahl einer Buchung an derselben Stelle erscheinen (in eckigen Klammern).

Klassen

Flach, ohne Hierarchie – die zweite Auswertungsdimension neben der Kategorie (Ehemann, Ehefrau, Haus 1, Projekt …). Im QIF hängen sie mit / an der Kategorie: 400 - Leben:B-Essen alleine/Privat. Kategorie::zerlegeQifAngabe() trennt beides.

Mandantenfähigkeit

Alle Stammdatentabellen führen benutzer_id. Die Oberfläche ist einbenutzerig; die Kennung liefert Mandant::id() – aus der Session, im CLI ersatzweise der erste aktive Benutzer. Mandant::setze() gibt sie in Skripten und Tests fest vor.