Kontenrahmen (ChartOfAccountFrameworks)
Zweck
ChartOfAccountFramework (Kontenrahmen) modelliert standardisierte Konten-Klassifikationen wie SKR03, SKR04 oder eigene Hauskontenrahmen. Pro Framework werden über die Sub-Route /chart-of-account-frameworks/:id/classes die zugehörigen ChartOfAccountClass-Einträge gepflegt — das sind die Klassen 0–9 mit Beschreibung („0 Anlagevermoegen", „4 Erloese", ...). Konten (Account) referenzieren über chartOfAccountClassId einzelne Klassen.
Voraussetzungen
Berechtigungen (CASL)
| Action | Subject | Wirkung | Keycloak-Rolle |
|---|---|---|---|
view | FE_ChartOfAccountFramework, ChartOfAccountFramework | Liste/Detail aufrufbar | — |
create/update/delete | ChartOfAccountFramework | Pflegen | APP_SPEAMCORE_CREATE/UPDATE/DELETE_CHART_OF_ACCOUNT_FRAMEWORK |
view/create/update/delete | ChartOfAccountClass | Klassen-Sub-Liste | APP_SPEAMCORE_VIEW/CREATE/UPDATE/DELETE_CHART_OF_ACCOUNT_CLASS |
Schritt-für-Schritt-Anleitung
Framework anlegen
- Kontenrahmen (
/chart-of-account-frameworks) → + Neu. namepflegen (z. B. „SKR03").descriptionergaenzen (z. B. „Standardkontenrahmen für Deutschland, kleine und mittlere Unternehmen").
Klassen pflegen
- Framework-Detail öffnen → Tab Klassen (
/chart-of-account-frameworks/:id/classes). - + Neu →
class(z. B.0) unddescription(z. B. „Anlagevermoegen"). - Wiederholen für alle Klassen (typischerweise 0–9).
Toolbar (Detail-Seite)
Schlanke Toolbar oben rechts:
| Icon | Aktion (aria-label) | CASL | Wirkung |
|---|---|---|---|
| ← | Zurückgehen | — | Zurück zur Liste. |
| 🏠 | Zur Startseite gehen | — | Springt auf das Dashboard / /. |
| ⏮/◀/▶/⏭ | Pagination | — | Navigation durch die gefilterte Liste — Massen-Bearbeitung ohne Liste-Sprung. |
Globale Floating-Drawer (links)
Wie auf jeder Detail-Seite verfuegbar — siehe Floating-Quickbar:
- KAL. (Mini-Kalender)
- ZEIT (Persoenliche Wochen-Arbeitszeit)
- ARBEIT (Eigene bevorstehende Aufträge)
Felder und Eingaben
Framework-Felder
| Feldname | Pflicht | Datentyp | Wirkung beim Ausfuellen | Voraussetzung |
|---|---|---|---|---|
name | nein | String | Anzeigename in Liste und Selectors. | — |
description | nein | TEXT | Ausfuehrliche Erlaeuterung des Frameworks. | — |
Klassen-Felder (ChartOfAccountClass)
| Feldname | Pflicht | Datentyp | Wirkung beim Ausfuellen | Voraussetzung |
|---|---|---|---|---|
class | ja | String | Klassen-Kennung (z. B. 0, 1, ..., 9). | — |
description | nein | TEXT | Beschreibung der Klasse. | — |
chartOfAccountFrameworkId | ja (auto) | UUID | Verknuepfung zum Framework. Wird automatisch aus dem Routing-Kontext gesetzt. | — |
Wiederverwendbare Konzepte
- Buchhaltungskonten — Querschnitts-Konzept.
- Berechtigungen verstehen (CASL)
Verknuepfungen zu anderen Modulen
- Konten (Account) —
Account.chartOfAccountClassIdreferenziert eine Klasse aus diesem Framework. - Setup-Wizard — Schritt 4 „Standards (DE) laden" legt SKR03 als Framework und seine Klassen automatisch an.
Häufige Fehler und Lösungen
| Fehler | Lösung |
|---|---|
| Framework laesst sich nicht löschen | Es referenzieren noch Klassen das Framework — zuerst Klassen entfernen, dann Framework. |
| Klassen erscheinen nicht in Konto-Anlage | chartOfAccountClassId im Account-Form setzt nur Klassen des aktiven Frameworks; Framework-Auswahl prüfen. |
| Doppelte Klassen-Kennung | Innerhalb eines Frameworks ist die class-Kennung typischerweise eindeutig — eindeutige Werte vergeben. |
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|---|---|---|
GET | /api/chart-of-account-frameworks | Framework-Liste | view ChartOfAccountFramework |
POST | /api/chart-of-account-frameworks | Framework anlegen | create ChartOfAccountFramework |
GET | /api/chart-of-account-frameworks/:id | Detail | view ChartOfAccountFramework |
PATCH | /api/chart-of-account-frameworks/:id | Ändern | update ChartOfAccountFramework |
DELETE | /api/chart-of-account-frameworks/:id | Soft-Delete | delete ChartOfAccountFramework |
GET | /api/chart-of-account-classes?filter=chartOfAccountFrameworkId | Klassen-Liste pro Framework | view ChartOfAccountClass |
POST | /api/chart-of-account-classes | Klasse anlegen | create ChartOfAccountClass |
PATCH | /api/chart-of-account-classes/:id | Klasse ändern | update ChartOfAccountClass |
DELETE | /api/chart-of-account-classes/:id | Klasse löschen | delete ChartOfAccountClass |
Versionshinweise
- 2026-04-30: Initiale Veroeffentlichung.