Enterprise PDF Toolbox⌂

Projekt-Guide – Enterprise PDF Toolbox 5.12.1 Release Certified

Status: eingefrorener Release-Certified-Stand. Diese Guide ergänzt ausschließlich die Dokumentation und verändert keine Fachfunktion.

1. Was ist die Enterprise PDF Toolbox?

Die Enterprise PDF Toolbox ist eine modulare Plattform für Dokumentverarbeitung. Sie verbindet PDF-Bearbeitung, Konvertierung, OCR, PDF/A, Signatur, Datenschutz, Workflows, Batch-Verarbeitung, IAM, Betrieb, CLI, OpenAPI und ein Plugin-SDK.

Der typische Ablauf ist:

text
Eingabe erfassen
→ Capability auswählen
→ Optionen und Limits prüfen
→ Verarbeitung starten
→ Status und Warnungen kontrollieren
→ Ergebnis oder Bericht herunterladen

2. Schnellstart

2.1 Dokumentation öffnen

  1. ZIP vollständig entpacken.
  2. index.html öffnen.
  3. Danach diese Guide oder lernweg.html verwenden.

Die HTML-Dokumentation funktioniert lokal und ohne CDN-Verbindungen.

2.2 Anwendung mit Maven starten

Voraussetzungen:

bash
./mvnw spring-boot:run -pl pdf-tool-web -am

Danach:

text
Weboberfläche: http://localhost:8080
Swagger UI:    http://localhost:8080/swagger-ui.html
OpenAPI:       http://localhost:8080/v3/api-docs
Health:        http://localhost:8080/actuator/health

2.3 Mit Docker Compose starten

bash
docker compose up --build

Für produktionsnahe Profile müssen Secrets, Storage, Datenbank, Redis, MinIO, Keycloak und externe Signaturdienste passend konfiguriert werden.

3. Oberfläche verstehen

Die Benutzeroberfläche ist fachlich gegliedert:

BereichZweck
Start und DashboardSystemzustand, letzte Jobs, häufige Aktionen
KonvertierenMarkdown, HTML, Text, Bilder und Office mit PDF verbinden
Seiten und LayoutReihenfolge, Zuschnitt, Ränder, Format und Ausrichtung
Analyse und OCRTextebene, OCR, Metadaten, Vergleich und Empfehlungen
Sicherheit und DatenschutzPasswortschutz, Bereinigung und sichere Schwärzung
Signieren und VertrauenPKCS#12, PKCS#11, Remote Signing, OCSP und CRL
WorkflowsRegeln, Vorlagen, Versionen, Simulation, Batch und Freigaben
AdministrationBenutzer, Rollen, Mandanten, OIDC, LDAP und API-Keys
BetriebJobs, Ressourcen, Telemetrie, Plugins und Qualitätsberichte
EntwicklerOpenAPI, Swagger UI, Clients, CLI und Plugin-SDK

Einheitliches Bedienmuster

  1. Datei oder Eingabetext auswählen.
  2. Standardprofil verwenden oder Optionen öffnen.
  3. Eingaben und Grenzen prüfen.
  4. Verarbeitung ausführen.
  5. Warnungen, Auditstatus und Ergebnis kontrollieren.
  6. Ergebnis speichern oder als Workflow wiederverwenden.

4. Wichtige Funktionsgruppen

4.1 Conversion Center

Unterstützt unter anderem:

Lokale Assets werden kontrolliert eingebettet. Externe Netzwerkressourcen werden bei sicheren Offline-Pfaden blockiert.

4.2 PDF-Bearbeitung

Ein Crop blendet Inhalte außerhalb der CropBox aus, löscht sie aber nicht sicher. Vertrauliche Inhalte müssen mit der sicheren Schwärzung entfernt werden.

4.3 OCR und Analyse

OCR ist für Deutsch, Englisch und Türkisch vorgesehen. Dokumentanalyse, Metadatenprüfung, Formularerkennung, Pixelvergleich und strukturierte Empfehlungen ergänzen die reine Texterkennung.

Scan-PDFs ohne Textebene müssen vor textbasierten Exporten oder Suchen zuerst durch OCR verarbeitet werden.

4.4 PDF/A und Archivierung

Die Plattform trennt bewusst:

Eine XMP-Deklaration allein beweist keine PDF/A-Konformität.

4.5 Sicherheit, Datenschutz und Signatur

5. Workflows und Batch-Verarbeitung

Workflows verbinden Capabilities zu wiederverwendbaren Abläufen.

text
Wenn keine Textebene vorhanden
→ OCR

Wenn Datei größer als 10 MB
→ Komprimieren

Wenn Metadaten vorhanden
→ Datenschutzbereinigung

Wenn signiert
→ keine verändernde Operation automatisch ausführen

Terminale Schritte

Ausgaben wie Markdown, HTML, DOCX, Bilder, ZIP oder Prüfberichte sind terminal. Danach darf kein PDF-verändernder Schritt folgen.

Team- und Betriebsfunktionen

6. Architektur

text
Web / REST / CLI
        ↓
Application Services
        ↓
Core-Modelle und Ports
        ↓
Adapter: PDFBox, OCR, LibreOffice, veraPDF, Storage, IAM

Wichtige Prinzipien:

Für Details: ARCHITECTURE_ATLAS.html und design-patterns.md.

7. REST, OpenAPI und CLI

REST und Swagger

Geschützte Endpunkte behalten JWT-, API-Key- und Rollenprüfungen.

CLI

Beispiele:

bash
pdf-tool markdown-to-pdf input.md -o output.pdf
pdf-tool pdf-to-markdown input.pdf -o export.zip
pdf-tool compress input.pdf --profile balanced
pdf-tool workflow run workflow.json '*.pdf'

Shell-Autovervollständigung und Paketierungsunterlagen befinden sich im CLI-Bereich.

8. Betrieb und Diagnose

Wichtige Betriebsflächen:

Bei Fehlern zuerst prüfen:

  1. PRUEFBERICHT.html
  2. Fehlercodekatalog
  3. Job- und Auditprotokoll
  4. Health-Endpunkte
  5. Abhängige Dienste und Secrets
  6. Dateigröße, Seitenzahl und Sicherheitslimits

9. Entwicklungs- und Wartungseinstieg

Empfohlene Reihenfolge:

  1. index.html
  2. lernweg.html
  3. docs/PROJECT_GUIDE.html
  4. docs/ARCHITECTURE_ATLAS.html
  5. docs/FEATURE_MATRIX.html
  6. docs/USER_GUIDE.html
  7. docs/PLUGIN_DEVELOPER_GUIDE.html
  8. WAS_WURDE_GEMACHT.html
  9. PRUEFBERICHT.html
  10. FORTSETZUNGSPROMPT.html

Da der Stand eingefroren ist, erfolgen Änderungen nur über einen neuen Wartungs- oder Major-Zweig.

10. Häufige Fehlerbilder

ProblemWahrscheinliche UrsacheErste Maßnahme
PDF enthält keinen TextScan ohne TextebeneOCR vorschalten
Office-Konvertierung schlägt fehlLibreOffice fehlt oder Pfad falschPDF_TOOL_LIBREOFFICE prüfen
PDF/A-Validierung nicht verfügbarveraPDF-CLI fehltValidator installieren und Pfad konfigurieren
Remote Signing/OCSP blockiertSSRF-Policy oder AllowlistZielhost und Netzwerkregeln prüfen
Workflow wird abgelehntterminaler Schritt nicht am EndeReihenfolge korrigieren
Datei wird wegen Limit abgewiesenSeiten-, Speicher- oder Bomb-SchutzEingabe prüfen, Limit bewusst anpassen
Zugriff verweigertRolle, Mandant oder Capability-Recht fehltIAM- und Tenant-Konfiguration prüfen

11. Empfohlene Produktionsprüfung

Vor produktiver Freigabe:

12. Abschlussstatus

⌂ Cockpit