Kostenstellen
Zweck
Kostenstellen (CostCenter) gruppieren Buchungen für die innerbetriebliche Kostenverrechnung — z. B. „10 - Stuttgart", „20 - Berlin", „30 - Aussendienst". Sie werden auf Niederlassungen, Belegen, Aufträgen und Mitarbeiter-Verträgen referenziert.
Voraussetzungen
Berechtigungen (CASL)
| Action | Subject | Keycloak-Rolle |
|---|---|---|
view | FE_CostCenter, CostCenter | — |
create/update/delete | CostCenter | APP_SPEAMCORE_CREATE/UPDATE/DELETE_COST_CENTER |
Schritt-für-Schritt-Anleitung
- Kostenstellen (
/cost-centers) → + Neu. - Name vergeben (z. B. „10 - Stuttgart").
- Optional
financialAccount(Buchhaltungs-Konto) eintragen. - Änderungen werden automatisch gespeichert.
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
| Feldname | Pflicht | Datentyp | Beschreibung | Wirkung beim Ausfuellen | Voraussetzung |
|---|---|---|---|---|---|
name | ja | String | Bezeichnung der Kostenstelle. | Erscheint in Auswahl-Selects auf Niederlassungen, Belegen, Aufträgen. | — |
financialAccount | nein | String | Verknuepfung zur Finanzbuchhaltung (Klartext, kein UUID-FK). | Wird beim Buchungsexport als Verrechnungs-Anker mitgegeben. | — |
Im Live-Walkthrough bestätigt: financialAccount ist im UI als freies Text-Input umgesetzt — kein Dropdown gegen einen TransactionAccount/Account-Select. Der Anwender traegt den DATEV-Schlüssel als Klartext ein (z. B. „KOST1-1200"). Hintergrund: DATEV-Buchungsstapel-Felder werden als String exportiert; eine FK-Bindung an SpeamCore-Konten wuerde Migration-Kosten und mehr Klick-Aufwand bedeuten ohne klaren Mehrwert. Wenn Plausibilitaetspruefung gewünscht ist, kann die Doku-Notiz später ergaenzt werden.
Wiederverwendbare Konzepte
Verknuepfungen zu anderen Modulen
- Niederlassungen (
Branch.costCenterId). - Aufträge (
Workorder.costCenterId, Default aus Mitarbeiter-Vertrag). - Verkaufsbelege (
SalesDocument.costCenterId). - Bestellbelege (
PurchaseDocument.costCenterId). - Mitarbeiter-Verträge (
EmployeeContract.costCenterId).
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|---|---|---|
GET | /api/cost-centers | Liste | view CostCenter |
GET | /api/cost-centers/:id | Detail | view CostCenter |
POST | /api/cost-centers | Anlegen | create CostCenter |
PATCH | /api/cost-centers/:id | Ändern | update CostCenter |
DELETE | /api/cost-centers/:id | Soft-Delete | delete CostCenter |
Versionshinweise
- 2026-04-29: Initiale Veroeffentlichung.