1e3227ce83
Konten, Kontengruppen, Kategorien und Klassen samt Übernahme aus dem
QIF-Export des Lexware FinanzManagers.
Kontenübersicht nach Kontengruppen gebündelt, mit Gruppensummen und
Gesamtsumme; die drei Saldospalten (Online-Saldo, aktueller und erwarteter
Saldo) sind angelegt und werden bis Phase 2 aus dem Anfangssaldo gespeist.
Kategorien sind hierarchisch mit ":" als Trenner. Der vollständige Pfad
steht redundant in der Tabelle, weil jede Anzeige und der gesamte Import
darüber laufen; Umbenennen und Verschieben schreiben den Teilbaum neu. Die
Art (Einnahme/Ausgabe) gilt für den ganzen Ast. Register wie im Original:
Alle, Einnahmen, Ausgaben, Umbuchungskonten.
QifParser liest zustandsbehaftet und sequenziell, wandelt ISO-8859-1 nach
UTF-8 und versteht US-Beträge sowie das Datumsformat aus der Kopfzeile.
QifStammdatenImport ist idempotent und bietet Trockenlauf und Protokoll -
im Dialog unter Verwaltung sowie über scripts/qif-import.php. Am echten
Export geprüft: 17 Klassen, 105 Kategorien, 37 Konten.
Enthält außerdem die Korrektur der englischen Monatsnamen im
Einstellungsdialog: date('F') ist sprachlich nicht umschaltbar, deshalb
liegen die Namen jetzt zentral als View::MONATE vor. Die Änderung ließ
sich nicht als eigener Commit trennen, weil sie dieselben Dateien berührt
wie Phase 1.
Tests: 227 PHP-Prüfungen und 14 Playwright-Tests, alle grün.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
3.4 KiB
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).
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.