xsl-validator/README.md

DocuMentor

Professionelle XSL-Transformations-Verwaltung und PDF-Generierung

DocuMentor ist eine leistungsstarke PySide6-basierte Desktop-Anwendung zur Verwaltung und Validierung von XSL-Transformationen mit automatischer PDF-Generierung. Die Anwendung bietet eine intuitive GUI zur Konfiguration von Transformations-Toolchains (Saxon, Apache FOP, diff-pdf) und zur Verwaltung komplexer PDF-Generierungsprojekte mit PostgreSQL-Datenbankintegration.

Features

🌳 Hierarchische Projektverwaltung

• Organisieren Sie Ihre XSL-Transformationen in einer übersichtlichen Baumstruktur
• Flexible Workflow-Definitionen mit verschachtelten Knoten
• Projektspezifische Konfiguration mit project.yaml

⚡ Asynchrone Batch-Verarbeitung

• Verarbeiten Sie große Mengen von XML-Dateien im Hintergrund
• Fortschrittsanzeige für lange Transformationen
• Parallelisierte XSLT-Transformationen durch eine Worker-Pool-Architektur

🔍 Intelligente Duplikatserkennung

• Automatische Hash-basierte Erkennung von identischen XML-Dateien (Blake2b)
• Verhindert Redundanzen und spart Speicherplatz
• Asynchrone Hash-Berechnung im Hintergrund

📄 PDF-Vergleichsansicht

• Drei-Panel-Ansicht (Referenz, Diff, Neu)
• Alpha-Blending für visuellen Vergleich
• Zoom- und Pan-Funktionalität

🗄️ PostgreSQL-Integration

• Nahtlose Datenbankanbindung mit Polars und ConnectorX
• Performante SQL-Abfragen und Datenverarbeitung
• SSL-Modus-Unterstützung

🛠️ Konfigurierbare Toolchains

• Flexible Verwaltung von Saxon, Apache FOP und diff-pdf
• Versionierung von Tools
• Plattformübergreifende Unterstützung (Linux, Windows, macOS)

🎨 Modernes UI

• Dark/Light-Theme-Unterstützung
• Drag-and-Drop für XML-Dateien
• Responsive und intuitive Benutzeroberfläche

Installation

Voraussetzungen

• Python 3.13 oder höher
• uv Paketmanager

Abhängigkeiten installieren

# Mit uv (empfohlen)
uv sync

# Oder mit pip
pip install -e .

Externe Tools

Für die volle Funktionalität benötigen Sie:

• Saxon-HE: XSLT 3.0 Prozessor (Download)
• Apache FOP: PDF-Generierung aus XSL-FO (Download)
• diff-pdf: PDF-Vergleich (GitHub)
• OpenJDK/JRE: für Saxon und Apache FOP. JDK empfohlen für Worker-Pools (Eclipse Temurin)

Verwendung

Anwendung starten

uv run python src/main.py

Erste Start

Konfigurieren Sie Ihre Tools (Saxon, Apache FOP, diff-pdf) in den Einstellungen

Projekt erstellen

1. Legen Sie ein neues Projekt an
2. Organisieren Sie XSL-Stylesheets und XML-Dateien in der Baumstruktur
3. Führen Sie Transformationen aus

Konfiguration

Die Anwendung speichert Konfigurationsdateien an folgenden Orten:

• Linux: ~/.config/DocuMentor/config.json
• Windows: %APPDATA%\DocuMentor\config.json
• macOS: ~/Library/Application Support/DocuMentor/config.json

Projektdaten werden in project.yaml im jeweiligen Projektverzeichnis gespeichert.

Entwicklung

Code-Qualität

# Code-Style prüfen
uv run ruff check

# Code formatieren
uv run ruff format

Tests

# Hash-Implementierung testen
uv run python test_hash_implementation.py

# Duplikatserkennung testen
uv run python test_xml_hash_duplicate_detection.py

Architektur

• PySide6: Native Qt-basierte GUI
• Pydantic: Typsichere Konfigurationsverwaltung
• Polars: Lightning-fast DataFrame-Verarbeitung
• Blake2b: Kryptographische Hash-Funktion für Integritätsprüfung

Siehe CLAUDE.md für detaillierte Entwicklerdokumentation.

Lizenz

DocuMentor ist unter der MIT License lizenziert.

Third-Party-Lizenzen

Diese Software verwendet folgende Open-Source-Bibliotheken:

• PySide6 - LGPL-3.0 OR GPL-2.0 OR GPL-3.0
• Pydantic - MIT License
• Polars - MIT License
• pyqtdarktheme - MIT License
• Weitere siehe THIRD_PARTY_LICENSES.txt

Externe Tools (separat zu installieren):

• Saxon-HE - Mozilla Public License 2.0
• Apache FOP - Apache License 2.0

Vollständige Lizenzanalyse: LICENSES.md

Danksagungen

Vielen Dank an alle Entwickler der verwendeten Open-Source-Bibliotheken!

---

DocuMentor - Professionelle XSL-Transformations-Verwaltung für anspruchsvolle Projekte