📘

Dateiimporte

imports core_platform 🛡️ RLS Protected

Dateiimporte — aus Code abgeleitete Prozess- und API-Dokumentation.

Fachliche Bestimmung: Plattform- und Basisinfrastruktur: Dateiimporte — aus Code abgeleitete Prozess- und API-Dokumentation. Erfasst alle zugehörigen Geschäftsdaten, Zustandsmodelle, Automationskaskaden und Schnittstellen zur nahtlosen Einbindung in die unternehmensweiten Wertschöpfungsprozesse.

Fachprozess-Erzählung & KI-Architektur Workflows & Lifecycles (1) Fachprozesse & Capabilities (2) Data Models & Fields (0) Entry Points (UI & APIs) (7) Regulatory & Compliance

⚡ Workflows & Lifecycles

Benutzerbefehl: import agent `plan:command_import_agent`

Geprüfter Durable-Plan (durable_plan), Start: manual_command.

1. import_agent

import_agent

{"key": "execute_command", "label": "Befehl prüfen, ausführen oder zur Freigabe vorlegen", "adapter": "agent.execute", "agent": "import_agent", "condition_fact": null}

Aktionen: import_agent

⚙️ Fachprozesse & Capabilities (System-Fachlogik)

Registrierte Fachoperationen und System-Capabilities dieses Moduls zur Steuerung von Workflows, Kaskaden und KI-Agenten.

Gesamt: 2 engine: 1 durable_plan: 1

Capability & Schlüssel	Fachliche Bezeichnung	Ausführung / Coverage	Risikostufe & Freigabe	Effekte & Kaskaden
Import-Zuordnung trocken prüfen `capability:imports.prepare_dry_run` Op: `imports.prepare_dry_run`	Intent: `prepare_import` Quelle: `code:capability_registry`	⚙️ Engine	✓ Auto Risiko: `metadata`	`import.dry_run_completed`
Benutzerbefehl: import agent `plan:command_import_agent`	Benutzerbefehl: import agent Quelle: `code:reviewed_execution_plan`	durable_plan	✓ Auto	Keine Seiteneffekte deklariert

🧠 Fachprozess-Erzählung & Dual Knowledge Architektur

Synthese aus der ideologischen Blaupause (Meta-Fachlogik / Soll), der faktischen System-Implementierung (System-Fachlogik / Ist) und No-Code Customizing für KI-Consultants.

Dual Knowledge Layer

📖

Der durchgängige Businessprozess im Detail (End-to-End Fließtext-Erzählung)

Der funktionale Ablauf von Dateiimporte in der Plattform-Architektur

Das Modul imports erbringt zentrale Infrastruktur- und Steuerungsdienste im Monolithen. Jeder Aufruf durchläuft die zweistufige Sicherheitsarchitektur: Zunächst verifiziert der Session-Guard die Identität des Benutzers, woraufhin die PostgreSQL Row-Level-Security (RLS) aktiviert wird. Dadurch ist garantiert, dass Datenzugriffe mathematisch und physisch ausschließlich auf den authentifizierten tenant_id-Kontext beschränkt bleiben.

Mutationen und administrative Aktionen werden über transaktionale Services ausgeführt. Bei zustandsverändernden Operationen schreibt das System simultan in die betriebliche Zieltabelle und in die transaktionale Outbox. Asynchrone Worker greifen diese Signale ab und kaskadieren Ereignisse an nachgelagerte Module, ohne den synchronen HTTP-Pfad zu blockieren. Jeder Zugriff wird unveränderbar im Audit-Trail protokolliert.

🏛️

Meta-Fachlogik: Ideologische Blaupause, Soll-Weltbild & Normen

Meta-Fachlogik: Sicherheits- und Plattform-Architektur

Basiert auf den Standards ISO/IEC 27001:2022 (Informationssicherheits-Managementsysteme), den BSI IT-Grundschutz-Bausteinen (APP.3.1 Webanwendungen, SYS.1.1 Allgemeiner Server) und Art. 32 DSGVO.

Mandantentrennung als Primärinvariante: Keine Mandantendaten dürfen jemals ohne tenant_id-Filter geladen oder mutiert werden. Das Soll-Modell verlangt die Durchsetzung auf Datenbankebene via PostgreSQL RLS.
Unveränderbarkeit von Sicherheitsereignissen: Protokolldateien, Logins, Berechtigungsänderungen und Konfigurationsmutationen müssen revisionssicher und schreibgeschützt festgeschrieben werden.

Normbezug für `imports`

Prüfkatalog Standards-Registry v2026.10.1. Dieser Abschnitt ordnet Prüfreferenzen zu und stellt nicht fest, dass das Modul eine Norm einhält; keine Kataloganforderung ist als PASS bewertet.

Geführte Prüfreferenzen:

eu-gdpr-2016-679, Regulation (EU) 2016/679 (General Data Protection Regulation, GDPR/DSGVO), Ausgabe Regulation (EU) 2016/679, anwendbar ab 2018-05-25. Art: regulatory. Öffentlicher Text. Die Nennung ist keine Klauselprüfung. Keine modulspezifische Kataloganforderung. Die Zuordnung bleibt eine Prüfreferenz.

Im Auditauftrag zusätzlich genannt und nicht im Prüfkatalog v2026.10.1: ISO 8000, RFC 4180. Dafür gibt es hier keine Klausel und keine Aussage, dass eine Vorgabe eingehalten wird.

Plattformweite Katalogwerke mit Geltungsbereich all (unter anderem WCAG 2.2, EN 301 549 V4.1.1, ISO 9241-110:2020, ISO 9241-210:2019, ISO/IEC 25010:2023, ISO 9001:2026, ISO/IEC 27001:2022, APQC PCF 8.0, DSGVO, EU AI Act) umfassen dieses Modul mit. Wo der Volltext fehlt, bleibt der Zugang ohne Quelle, lizenzpflichtig oder nur als öffentliche Zusammenfassung gekennzeichnet. Auch diese Nennung weist keine eingehaltene Vorgabe nach.

⚙️

Systemische Fachlogik: Faktische Umsetzung in Centurio ERP & Capabilities

Systemische Fachlogik: Die faktische Umsetzung von Dateiimporte

In Centurio ERP wird imports als modularer Monolith-Baustein unter app.modules.imports geführt. Die Autorisierung erfolgt über die zentrale RBAC-Engine mit Berechtigungs-Prüfung gegen Rollen und Berechtigungen. Datenänderungen lösen Outbox-Events aus, die über den PostgreSQL events-Bus verteilt werden. Idempotente Requests verhindern Replay-Angriffe und versehentliche Mehrfachausführungen.

🤖

KI-Consultant Leitfaden: Customizing- & No-Code-Konzept (Soll-Ist-Synthese)

AI Solution Architect Blueprint

KI-Consultant Blueprint: Customizing & No-Code Leitfaden für Dateiimporte

No-Code Datenmodell-Erweiterung: Bei Bedarf können kundenspezifische Zusatzfelder im No-Code Customizing Studio angelegt werden.
Workflow-Integration: Administrative Ereignisse können als Trigger in der Canvas No-Code DAG Engine genutzt werden.
Sicherheitsregeln: Vor kritischen Systemänderungen sind Human-in-the-Loop Freigabegates einzurichten.

📚 Operative Prozessbegriffe & Transaktionsschnittstellen

Zentrale Fachbegriffe im Prozesszusammenhang (Operatives Modell)

Mandantenisolation (RLS)

PostgreSQL Row-Level-Security zur physischen und logischen Trennung aller Kundendaten auf Datenbankebene.

Zweistufige Authentifizierung

Strikte Trennung zwischen globalem Benutzerkonto und mandantenbezogener Rollenzuweisung (RBAC).

Transaktionale Outbox

Entkoppeltes Event-Publishing zur Vermeidung von Distributed-Transaction-Inkonsistenzen.

Revisionssicherer Audit-Trail

Lückenlose Aufzeichnung aller datenverändernden Zugriffe für Compliance und Rechnungsprüfung.

📥 Eingänge & Trigger (Inputs)

Systemaufrufe über REST-API oder Web-Portal
Hintergrund-Worker und Cron-Jobs
Ereignisse über den Outbox-Eventbus

📤 Ausgänge & Arbeitsergebnisse (Outputs)

Ausführungs- und Protokolldaten
Audit-Events im Revisionsjournal
Veränderte Systemzustände

⚡ Kaskaden & Folgeprozesse (Cascades)

security_event -> admin_alert: Alarmierung bei verdächtigen Zugriffen
config_changed -> cache_invalidation: Sofortige Aktualisierung

🛡️ Nebenprozesse & Resilienz

Manuelle Ausnahmebehandlung durch berechtigte Sachbearbeiter
Revisionssichere Protokollierung im Audit-Trail

💡 No-Code Checkliste & Praxistipps

Rollen- und Berechtigungsstufen exakt an Mitarbeiteraufgaben anpassen
Sicherheitsrichtlinien für Passwörter und Sessions aktivieren

🗄️ Data Models & Fields

Keine dedizierten Tabellen für dieses Modul registriert.

🔌 Entry Points (UI & APIs)

Art	Method	Endpoint / Path	Titel & Zweck	Required Role
⚡ REST API	GET	`/api/v1/imports/jobs/{job_id}`	get_job_status Semantic binding: inventory_only; mutation=False	`imports`
⚡ REST API	GET	`/api/v1/imports/targets`	list_targets Semantic binding: inventory_only; mutation=False	`imports`
⚡ REST API	GET	`/imports`	imports_page Semantic binding: inventory_only; mutation=False	`imports`
⚡ REST API	POST	`/api/v1/imports/jobs/{job_id}/apply`	apply_import Semantic binding: operator_surface; mutation=True	`imports`
⚡ REST API	POST	`/api/v1/imports/jobs/{job_id}/dry-run`	execute_dry_run Semantic binding: operator_surface; mutation=True	`imports`
⚡ REST API	POST	`/api/v1/imports/jobs/{job_id}/rollback`	rollback_import Semantic binding: operator_surface; mutation=True	`imports`
⚡ REST API	POST	`/api/v1/imports/upload`	upload_import_file Semantic binding: operator_surface; mutation=True	`imports`

🛡️ Regulatory & Compliance

Dieses Modul unterliegt folgenden gesetzlichen, regulatorischen und Revisionsstandards:

GoBD Nachvollziehbarkeit
Mandanten-Isolation (PostgreSQL RLS)