Buchungsmuster (BookingPattern)

Mit dem Umbau auf das **Transaktions-Cockpit 2.0** (Juni 2026) wurde die **eigenständige FE-Seite `/booking-patterns` entfernt**. Die **Buchungsmuster-Lernlogik läuft unverändert weiter** (Modell, API und Lern-Service bestehen) und fließt automatisch in die KI-Vorschläge des [Transaktions-Cockpits](/transaction-cockpit) ein. Es gibt nur keine eigene Verwaltungsseite mehr; die API-Endpoints (`/api/booking-patterns`) existieren weiterhin. Diese Doku bleibt als Konzept-Referenz erhalten.

Zweck

Buchungsmuster sind das Gedächtnis des Transaktions-Cockpits: SpeamCore merkt sich pro Gegenpartei (Lieferant/Kunde), auf welches SKR-Konto und mit welchem Steuersatz Sie deren Buchungen zuordnen. Taucht dieselbe Gegenpartei erneut auf, boostet das gelernte Muster den KI-Vorschlag (höhere Confidence) bzw. schlägt Konto und Steuer direkt aus der Historie vor.

Die Verwaltung gelernter Muster als eigene Seite entfällt seit Cockpit 2.0 (siehe Hinweis oben); die Muster wirken weiterhin automatisch im Transaktions-Cockpit.

Ein Muster entsteht **von selbst**, sobald Sie im Cockpit eine Transaktion manuell einem Konto zuordnen und buchen (`recordBookingPattern`). Es gibt daher **kein** „Neu anlegen" — nur Ansehen, Korrigieren und Löschen. Gelernt wird **nur aus echten Konto-Buchungen**, nicht aus Skonto- oder Hilfszeilen.

Voraussetzungen

- Berechtigung `view:FE_BookingPattern` und `view:BookingPattern`. - Zum Korrigieren `update:BookingPattern`, zum Löschen `delete:BookingPattern`. - Es wurden bereits Transaktionen im [Cockpit](/transaction-cockpit) gebucht (sonst ist die Liste leer).

Berechtigungen (CASL)

Action	Subject	Wirkung
view	FE_BookingPattern, BookingPattern	Verwaltungsseite aufrufbar
update	BookingPattern	Konto eines Musters korrigieren (Inline)
delete	BookingPattern	Muster löschen

So funktioniert das Lernen

1. Sie buchen im Cockpit eine Transaktion einer Gegenpartei manuell auf ein Konto.
2. SpeamCore legt dafür ein Buchungsmuster an bzw. erhöht dessen Häufigkeit (frequency) und merkt sich accountId, ggf. taxRateId, sowie Durchschnitts-/Letztbetrag.
3. Ab 2 Bestätigungen (frequency ≥ 2) gilt das Muster als Aktiv und boostet ab dann aktiv die KI-Bewertung künftiger Transaktionen derselben Gegenpartei; darunter steht es auf „Lernt noch".
4. Im Cockpit erscheint der Vorschlag dann mit höherer Confidence bzw. direkt vorbefülltem Konto/Steuersatz.

Felder und Spalten

Die Liste /booking-patterns zeigt pro Muster:

Spalte	Feld	Bedeutung
Gegenpartei	counterpartyDisplayName (Schlüssel: counterpartyKey)	Lieferant/Kunde, für den das Muster gilt.
Konto	accountId	Gelerntes SKR-Konto — inline korrigierbar (update:BookingPattern).
Häufigkeit	frequency	Wie oft die Zuordnung schon bestätigt wurde.
Status	(abgeleitet)	Aktiv ab frequency ≥ 2, sonst Lernt noch.
Ø-Betrag	avgAmount (+ lastAmount)	Durchschnitts- bzw. letzter Betrag.
Letzte Buchung	lastBookingDate	Datum der letzten passenden Buchung.
Aktionen	—	Inline-Konto-Korrektur, Muster löschen.

Weitere Modellfelder: taxRateId (gelernter Steuersatz, optional), direction (Standard payable).

Korrigieren und Löschen

• Konto inline ändern: In der Konto-Spalte direkt ein anderes Konto wählen — wirkt auf alle künftigen Vorschläge dieser Gegenpartei.
• Muster löschen: entfernt das gelernte Verhalten; bei der nächsten Buchung wird neu gelernt.

Verknüpfungen zu anderen Modulen

• Transaktions-Cockpit — hier entstehen und wirken die Muster.
• KI-Allocation-Engine — wie der Boost in den Score einfließt.
• Buchhaltungskonten / Steuersätze — die gelernten Ziele.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/booking-patterns	Liste der gelernten Muster	view BookingPattern
GET	/api/booking-patterns/:id	Einzelnes Muster	view BookingPattern
PATCH	/api/booking-patterns/:id	Konto/Steuer korrigieren	update BookingPattern
DELETE	/api/booking-patterns/:id	Muster löschen	delete BookingPattern

Ein POST existiert bewusst nicht — Muster werden ausschließlich durch das Buchen im Cockpit gelernt.

Versionshinweise

• 2026-06-06: Initiale Veröffentlichung. Lernende Buchungs-Muster pro Gegenpartei (Konto/Steuer/Häufigkeit), Aktiv ab frequency ≥ 2, Boost der KI-Vorschläge, Verwaltungsseite mit Inline-Konto-Korrektur + Löschen. Verifiziert an bookingPattern.model.ts, bookingPattern.service.ts, BookingPatternListPage.tsx.