From cfbdc476fac0dc2ef40f09201e30be15d180ae12 Mon Sep 17 00:00:00 2001 From: Vitali Graf Date: Tue, 6 Jan 2026 20:12:07 +0100 Subject: [PATCH] Docs: Nutzungsszenario und Workflow in CLAUDE.md dokumentiert MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Neuer Abschnitt "Anvisiertes Nutzungsszenario" erklärt: - Einsatz in Flexnow für PDF-Dokumente (Urkunden, Zeugnisse, Bescheide) - Struktur der ~100 verknüpften XSL-Dateien - Typischer Entwicklungs-Workflow mit PDF-Diff-Prüfung - Wichtigkeit von RAM-sparsamem Design 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 --- CLAUDE.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 7468198..cb3b505 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -6,6 +6,21 @@ Spreche mit mir auf Deutsch! (Communicate with me in German!) DocuMentor (ehemals xsl-validator) ist eine PySide6-basierte Desktop-Anwendung zur Verwaltung und Validierung von XSL-Transformationen mit XML-Dateien. Sie bietet eine GUI zur Konfiguration von Transformations-Toolchains (Saxon, Apache FOP, diff-pdf) und zur Verwaltung von PDF-Generierungsprojekten mit PostgreSQL-Datenbankintegration. +## Anvisiertes Nutzungsszenario +Der primäre Einsatz ist die kontinuierliche Weiterentwicklung von PDF-Dokumenten in Flexnow (Software zur Prüfungsverwaltung). Dabei handelt es sich beispielsweise um amtliche Urkunden, Zeugnisse und Bescheide. + +Die Basis bilden etwa 100 XSL-Dateien. Die meisten sind mittels `` bzw. `` miteinander verknüpft (ähnlich der Klassen-Vererbung). Daher können sich Änderungen in einer XSL-Datei auf (unerwartet) viele andere auswirken. Um diese Auswirkungen im Auge zu behalten, wird DocuMentor entwickelt. + +**Typischer Workflow:** +1. Entwickler führt benötigte Änderungen an den XSL-Dateien durch +2. Entwickler startet die Transformation im DocuMentor und begutachtet die generierte PDF-Diff +3. Prüfung: Wurden die richtigen PDF-Dateien geändert? +4. Prüfung: Hat die Änderung der XSL-Dateien die erhoffte Änderung in den PDF-Dateien ergeben? + +Diese Schritte können sich mehrfach wiederholen. + +Da der DocuMentor permanent im Hintergrund läuft, ist ein sparsamer Umgang mit RAM wichtig. + ## PySide6-GUI - Beim Erstellen neuer Dialoge und Fenster sollte immer eine entsprechende UI-Datei erstellt werden - Der Entwickler sollte später in der Lage sein, den neuen Dialog bzw. Fenster über diese UI-Datei zu gestalten