Kunden — Bank-Zuweisungen (Sub-Route)

**Sub-Route DEPRECATED — wird abgeloest.** Die Anzeige zeigt einen `Alert` mit dem Hinweis "Bank assignments have been replaced by the new BankAccount system" (Code-Lookup: `CustomerBankAssignmentListPage.tsx`, Zeile 22-30). Das alte `BankAssignment`-Modell ist im FE entfernt; die UI-Liste ist leer und zeigt nur den Deprecated-Alert. Wenn ein Anwender Bankverbindungen zum Kunden pflegen will, fuehren Sie ihn zum neuen [BankAccount-Konzept](/konzepte/bankkonten-und-zuweisungen) und [/transaction-accounts](/transaction-accounts) — dort werden Bankverbindungen mandantenweit gepflegt und nicht mehr pro Kunde.

Zweck (historisch)

Sub-Route /customers/:id/banks zeigte historisch alle BankAssignment-Einträge des Kunden — d. h. Verknuepfungen zwischen dem Kunden und einem BankAccount. Pro Eintrag wurde festgelegt, ob er für SEPA-Mandate, Zahlungseingang oder Zahlungsausgang verwendet wird. Heute leer (Deprecated).

Voraussetzungen

- Berechtigung `view:Customer`, `view:BankAssignment`, `view:BankAccount`. - Bestehende [Bankverbindung](/konzepte/bankkonten-und-zuweisungen) als Ziel der Zuweisung.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_Customer, Customer	Detail aufrufbar	—
view/create/update/delete	BankAssignment	Zuweisungen pflegen	APP_SPEAMCORE_VIEW/CREATE/UPDATE/DELETE_BANK_ASSIGNMENT
view	BankAccount	Bank-Auswahl	APP_SPEAMCORE_VIEW_BANK_ACCOUNT

Schritt-für-Schritt-Anleitung

1. Kunde (/customers/:id) → Tab Banken.
2. + Neu wählt einen BankAccount (IBAN, BIC) und legt eine BankAssignment mit parentType = Customer, parentId = :id an.
3. Pro Zuweisung optional Flags wie isPrimary, usageType (z. B. direct_debit, incoming, outgoing) setzen.

Wiederverwendbare Konzepte

• Bankkonten und Zuweisungen — vollstaendiges BankAssignment-Konzept.
• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Kunden — Eltern-Modul.
• Lieferanten und Hersteller — eigene /banks-Sub-Routen mit identischem Pattern.
• Ausgaben — SEPA-Mandate referenzieren BankAccount.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/bank-assignments?filter[parentType=Customer&parentId=:id]	Zuweisungen	view BankAssignment
POST	/api/bank-assignments	Anlegen	create BankAssignment
PATCH	/api/bank-assignments/:id	Ändern (z. B. isPrimary)	update BankAssignment
DELETE	/api/bank-assignments/:id	Soft-Delete	delete BankAssignment

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.