Datentransfer (DataTransfer)

Zweck

/data-transfer ist eine Universal-Page mit vier Tabs für alle Daten-Bewegungen, die nicht an einzelnen Modul-Routen sitzen:

Tab	Zweck
Export	Daten-Exporte starten — z. B. DATEV-Buchungssatz, Excel-Listen, JSON-Dumps.
Import	Daten-Importe konfigurieren und starten. Über /import (separate Route) ablaufen Detail-Jobs.
Historie	Vergangene Export- und Import-Laufe mit Status, Datei-Verweis, User.
Zugriffsanfragen	Datenschutz-Anfragen (DSGVO Art. 15 ff.) — externe Personen fordern Auskunft, Loeschung, Korrektur an.

Voraussetzungen

- Berechtigung `view:DataTransfer`. - Für Export: `export:DataTransfer`. - Für Import: `import:DataTransfer`. - Für Zugriffsanfragen: `view:DataAccessRequest`.

Berechtigungen (CASL)

Action	Subject	Wirkung	Keycloak-Rolle
view	FE_DataTransfer, DataTransfer	Page aufrufbar	—
export	DataTransfer	Export-Tab	APP_SPEAMCORE_EXPORT_DATA_TRANSFER
import	DataTransfer	Import-Tab	APP_SPEAMCORE_IMPORT_DATA_TRANSFER
view	DataAccessRequest	Anfragen-Tab	APP_SPEAMCORE_VIEW_DATA_ACCESS_REQUEST

Schritt-für-Schritt-Anleitung

Export ausloesen

1. Tab Export wählen.
2. Export-Typ aus dem Dropdown wählen (z. B. „Buchungssaetze DATEV", „Kunden Excel", „Mitarbeiter JSON").
3. Filter und Zeitraum festlegen.
4. Export starten — Datei wird im Hintergrund erzeugt; Status laeuft im Tab Historie.

Import konfigurieren

1. Tab Import wählen.
2. Datei hochladen (CSV/Excel/JSON).
3. Felder mappen — Backend bietet Auto-Match-Vorschläge.
4. Import starten — verzweigt typischerweise auf /import zur Detail-Sicht des Imports.

Historie prüfen

Tab Historie — Liste mit Status (pending, running, completed, failed), Datei-Link und Fehler-Details.

Zugriffsanfragen bearbeiten

Tab Zugriffsanfragen — DSGVO-Anfragen mit Anfrager-Daten, Anliegen, Faelligkeit. Pflege des Status (z. B. received, inProgress, responded).

Wiederverwendbare Konzepte

• Berechtigungen verstehen (CASL)

Verknuepfungen zu anderen Modulen

• Import — vertiefte Sicht laufender Import-Jobs.
• Document-Center — Quelle/Ziel von Export-Dateien.
• Modul-Listen wie Kunden, Verkaufsbelege, Buchungs-Konten — Datenquellen für Exporte.

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/data-export	Export-Lauf-Historie	view DataTransfer
POST	/api/data-export	Export ausloesen	export DataTransfer
GET	/api/data-import-jobs	Import-Job-Liste	view DataTransfer
POST	/api/data-import-jobs	Import starten	import DataTransfer
GET	/api/data-access-requests	DSGVO-Anfragen	view DataAccessRequest
GET	/api/data-history	Historie aller Bewegungen	view DataTransfer

Versionshinweise

• 2026-04-30: Initiale Veroeffentlichung.