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>
76 lines
3.4 KiB
Markdown
76 lines
3.4 KiB
Markdown
# 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.
|