Architekturatlas – Enterprise PDF Toolbox 4.10.0-LTS
Leitidee
Fachlogik und Anwendungsfälle bleiben unabhängig von Webframework, PDF-Engine, Persistenz und externen Diensten. Ports definieren Verträge; Adapter kapseln technische Integrationen.
Schichten
| Schicht | Verantwortung | Beispiele |
|---|---|---|
| Core | Fachmodelle, Policies und Ports | PDF-Operationen, Workflow-Modelle, Sicherheitsgrenzen |
| Application | Use Cases und Orchestrierung | Conversion, Batch, Workflow, Reports |
| Plugin API | Capability- und Erweiterungsverträge | Manifest, SDK, Berechtigungen |
| Adapter | PDFBox, veraPDF, LibreOffice, Storage | technische Umsetzung externer Systeme |
| Web/CLI | REST, UI, OpenAPI und Befehle | Controller, Swagger UI, CLI-Kommandos |
| Infrastructure | PostgreSQL, Redis, MinIO, Observability | Persistenz, Queue, Objektablage |
Hauptdatenfluss
Eingabe → Security Gateways → Use Case → Port → Adapter → Ergebnis/Report → Audit
Qualitätsprinzipien
- rückwärtskompatible API-Erweiterungen
- explizite Ressourcenlimits
- terminale Workflow-Regeln für Nicht-PDF-Ausgaben
- mandanten- und capabilitybezogene Autorisierung
- chronologische, konsolidierte Dokumentation
- reproduzierbare Prüfsummen und Gesamtpakete
Entwurfsmuster
Die vollständige Zuordnung befindet sich in design-patterns.md. Prägend sind Adapter, Strategy, Command, Pipeline, Policy Object, Facade, Inspector, Security Gateway und Report Assembler.