Freigabedokument V3.0 – PDF-Umbenenner

Geprüfter Stand

Git-Branch: main
Versionsnummer: 3.0.238
MSI-Datei: PDF-KI-Renamer-3.0.238.msi
Freigabedatum: 2026-05-05
Status: freigegeben

Zielsetzung von V3.0

V3.0 ist kein Wechsel der Kernfunktion, sondern ein gezielter Qualitätssprung in drei Dimensionen: Infrastruktur (konsistente Versionierung, Flyway-DB-Migration, Jenkins-Stabilisierung, MSI-Vorbereitung), Transparenz (Historien-Tab, differenzierte Fehlerstatus-Darstellung, Lauf-Summary-Banner) und Bedienkomfort (Tooltips, Statuszeile, Prompt-Editor). Die fachliche Kernverarbeitung des PDF-Umbenenners – PDF lesen, KI benennen, Zieldatei kopieren – bleibt vollständig unverändert. Es wird kein neues Maven-Modul eingeführt; die hexagonale Architektur bleibt unangetastet.

Umgesetzte Issues

#	Commit	Kategorie	Beschreibung
#67	`c6379c0`	Infrastruktur	Konsistente Versionierung via Maven CI-friendly `${revision}`, MANIFEST.MF mit `Implementation-Version`, Fallback `dev`
#68	`500a8c5`	Infrastruktur	Jenkins-Build mit `-Drevision`-Übergabe, robuste Shade-JAR-Archivierung mit Bash und `mapfile`
#49	`732d00c`	Infrastruktur	Flyway-Integration mit V1-Basisskript, 3-Fall-Strategie (leer / Bestand baselined / regulärer Folgestart), `PRAGMA foreign_keys` per `SQLiteConfig`, Lock-Mechanismus, vollständige Schema-Prüfcheckliste, manuelle Schema-Evolution entfernt
#51	`563d9f5`	Fachlich/UX	Einheitliche Status-Darstellung mit Icon, Farbe, Tooltip; `FAILED_RETRYABLE` vs. `FAILED_FINAL` eindeutig differenziert
#66	`0fe5359`	UX	Tooltips auf Konfigurationstab, Verarbeitungslauf-Tab und Toolbar; zentrale `GuiTooltipTexts`-Konstantenklasse
#73	`dc17824`	GUI	Summary-Banner unterhalb Fortschrittsbalken nach Laufabschluss
#50	`4f5ce4c`	GUI	Statuszeile mit Version, Provider/Modell und Konfigurationsdateipfad
#71	`5d5dee0`	GUI	Prompt-Editor-Tab mit atomarem Speichern (`ATOMIC_MOVE`), Dirty-State, Default-Reset
#7	`46fc1d4`	GUI	Historien-Tab mit Liste, Detail, Filter, Status-Reset (feldgenau, Versuche bleiben) und destruktivem Löschen (Attempts vor Record in Transaktion)
#65	`51d6168`	Infrastruktur	MSI-Vorbereitung: jdeps-Modulliste, BAT-Dateien, `winUpgradeUuid`, Pfad-Hinweise in `betrieb.md`

Weitere Commits

Commit	Beschreibung
`6e03093`	Architektur-Übersichten ergänzt (`domain-overview.md`, `gui-overview.md`, `adapter-overview.md`)
`4b89743`	Bedienanleitung auf neuen Stand gebracht

Architektur-Bilanz

Neu	Anzahl	Bemerkung
Outbound-Ports	1	`HistoryQueryPort`
Application-Use-Cases	5	`DefaultPromptEditorUseCase`, `DefaultHistoryOverviewUseCase`, `DefaultHistoryDetailsUseCase`, `DefaultHistoryResetDocumentStatusUseCase`, `DefaultDeleteDocumentHistoryUseCase`
Outbound-Adapter	2	`SqliteHistoryQueryAdapter`, `FilesystemPromptPortAdapter.savePrompt`
GUI-Bridge-Interfaces	5	`GuiPromptEditorPort`, `GuiHistoryOverviewPort`, `GuiHistoryDetailsPort`, `GuiHistoryResetDocumentStatusPort`, `GuiDeleteDocumentHistoryPort`
GUI-Tabs	2	„Verlauf", „Prompt"
GUI-Komponenten	5	`GuiStatusBar`, `BatchRunSummaryBanner`, `GuiHistoryTab`, `GuiPromptEditorTab`, `ProcessingStatusPresentation`
Bootstrap	1 + Erweiterung	`ApplicationVersionProvider` und Erweiterung des `GuiStartupContext` (`applicationVersion`, 5 neue Port-Felder)
Datenbank-Migration	–	Flyway-V1-Basisskript, 3-Fall-Strategie, FK-Pragma per `SQLiteConfig`, Lock-Mechanismus

Nicht geändert: pdf-umbenenner-domain, pdf-umbenenner-adapter-in-cli, headless-Betrieb. Bootstrap ausschließlich um MANIFEST.MF-Einträge und neue Bridge-Verdrahtung erweitert.

Verbindlich verifizierte Spec-Punkte

${revision} wird durch flatten-maven-plugin (resolveCiFriendliesOnly) aufgelöst; installierte POMs enthalten kein unaufgelöstes ${revision}
MANIFEST.MF im Fat-JAR trägt Implementation-Version; Laufzeit-Fallback ist dev
evolveTableColumns() vollständig aus dem Code entfernt; Flyway ist die einzige Schema-Evolutionsquelle
Status-Reset setzt feldgenau overall_status='READY_FOR_AI', content_error_count=0, transient_error_count=0, last_failure_instant=NULL; Versuche (processing_attempt) bleiben vollständig unangetastet
Tab-Reihenfolge: Konfiguration | Verarbeitungslauf | Verlauf | Prompt
PromptPort.savePrompt bleibt pfadfrei in der Port-Signatur (Hexagonal-konform; Pfadauflösung liegt im Adapter)
Farbe ist niemals das einzige Unterscheidungsmerkmal; alle Status tragen Icon und Text

Headless-Kompatibilität

Der bestehende Batch-Betrieb über --headless bleibt vollständig erhalten. Die .properties-Datei bleibt die einzige Konfigurationswahrheit. GUI-Code initialisiert den headless Pfad nicht. Keine stillen Änderungen an Retry-Semantik, Status-Persistenz oder fachlicher Verarbeitungslogik.

Datenbank-Migration

Bestehende Datenbestände aus dem Vorgängerstand werden beim ersten Start der 3-Fall-Strategie unterworfen:

Neue DB (keine Tabellen vorhanden): Flyway führt V1__initial_schema.sql vollständig aus.
Bestand ohne Flyway-History (typische Vorgänger-DB): vollständige Schema-Prüfcheckliste gegen das V1-Zielschema; bei konformem Schema wird eine datierte Backup-Kopie der .sqlite-Datei erstellt, danach Baseline auf V1 gesetzt. Bei nicht konformem Schema bricht der Start mit klarer Fehlermeldung ab – kein stilles Weiterlaufen.
Bestand mit Flyway-History (regulärer Folgestart): migrate() läuft idempotent.

baselineOnMigrate=true wird ausschließlich in Fall 2 gesetzt.

Offene Punkte (vor finalem Release)

Thema	Beschreibung
MSI-Testmatrix	Manueller MSI-Build und vollständige Abarbeitung der Testmatrix auf Windows-Maschine erforderlich; insbesondere Anwendungsstart ohne JDK zur Verifikation der `addModules`-Liste
`winUpgradeUuid`	Der GUID `EA8D0149-1401-4D3D-A98D-A2B98DAE5495` wurde im Rahmen von #65 neu generiert. Vor dem ersten produktiven MSI-Release ist sicherzustellen, dass kein bisheriges produktives MSI mit einem abweichenden GUID ausgeliefert wurde – andernfalls bricht der MSI-Upgrade-Mechanismus. Nach Bestätigung „nie produktiv ausgeliefert" ist der GUID damit gesetzt und darf nie wieder geändert werden.
Manueller GUI-Produkttest	Erfolgreicher Build und grüne Tests ersetzen keinen End-to-End-Lauf gegen einen echten KI-Provider mit echten PDFs.
Finale Freigabe	`freigabe-v3_0.md` wird nach abgeschlossenem manuellen Produkttest und MSI-Verifikation in den Status „freigegeben" überführt.

Nicht in V3.0

Automatischer Scheduler / Quellordner-Überwachung
Token- und Kosten-Tracking
Excel-Export
Automatische Update-Prüfung
Dark Mode
Log-Viewer
PDF-Viewer Render-DPI-Konfiguration
Zoom per Mausrad
Hilfe-Datei F1
Änderungen an der fachlichen Kernverarbeitung des PDF-Umbenenners
Neue Maven-Module, neue KI-Provider, Architekturbrüche

Freigabeaussage

V3.0 ist nach Prüfung fehlerfrei buildbar. Alle Kernanforderungen der hexagonalen Architektur sind eingehalten. Die fachliche Kernverarbeitung des PDF-Umbenenners bleibt unverändert gegenüber dem Vorgängerstand. Keine Release-Blocker für die Implementierungs-Freigabe.

Die finale Release-Freigabe steht aus bis zur vollständigen Abarbeitung der MSI-Testmatrix (insbesondere Verifikation des Anwendungsstarts ohne JDK), Klärung des winUpgradeUuid-Erstauslieferungsstatus und abgeschlossenem manuellem GUI-Produkttest gegen einen echten KI-Provider.

7.6 KiB Raw Permalink Blame History Unescape Escape