Doku #34: Dokumentation auf V2.9-Stand aktualisieren
- CLAUDE.md: Aktiver Implementierungsstand auf V2.9 aktualisiert; neue Klassen (PdfPreviewPane, FileNameEditorPane, ManualFileRenameUseCase, FilesystemTargetFileRenameAdapter, GuiManualFileRenamePort) und neuer Port (TargetFileRenamePort) dokumentiert; PDFBox-Direktrendering, Vollbild-Start und automatisches Laden der letzten Konfiguration beschrieben - README.md: Versionshinweis auf V2.9 aktualisiert; neue Features genannt - docs/betrieb.md: Startverhalten (Vollbild, letzte Konfiguration automatisch laden) ergaenzt; GUI-Tab-Beschreibung um PDF-Vorschau und Dateiname-Editor erweitert - docs/gui-bedienanleitung.md: Abschnitt 2.1 fuer automatisches Laden aktualisiert; neuer Abschnitt 13b fuer PDF-Vorschau und editierbaren Dateiname-Bereich - docs/befundliste.md: V2.9-Fixes (#27, #28, #29, #33) dokumentiert - docs/specs/technik-und-architektur.md: TargetFileRenamePort in Port-Liste ergaenzt; PDFBox-Direktrendering im Adapter-Out-Abschnitt erwaehnt - docs/specs/fachliche-anforderungen.md: Nicht-Ziele praezisiert; neuer Abschnitt 14a fuer manuelle Dateiname-Korrektur nach Verarbeitungslauf Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -27,12 +27,17 @@ PDF-Dateien automatisiert zu verarbeiten.
|
||||
|
||||
### 2.1 GUI-Standardstart
|
||||
|
||||
Wird die Anwendung ohne CLI-Argumente gestartet, öffnet sich die JavaFX-Desktop-GUI.
|
||||
Es wird keine Konfigurationsdatei automatisch geladen.
|
||||
Wird die Anwendung ohne CLI-Argumente gestartet, öffnet sich die JavaFX-Desktop-GUI
|
||||
**maximiert** (Vollbild).
|
||||
|
||||
Stattdessen zeigt die GUI einen deutschen Willkommenstext mit dem Hinweis, über
|
||||
„Neu" eine Standardvorlage zu erzeugen oder über „Öffnen" eine bestehende
|
||||
`.properties`-Datei zu laden.
|
||||
Wurde bei einem früheren Start eine Konfigurationsdatei geladen, wird diese automatisch
|
||||
erneut geladen. Der zuletzt verwendete Pfad wird systemseitig gespeichert
|
||||
(`java.util.prefs.Preferences`). Existiert die Datei nicht mehr, startet die GUI ohne
|
||||
Fehlermeldung mit dem Willkommenstext — es erscheint kein Dialog und kein Fehler.
|
||||
|
||||
Beim allerersten Start (oder wenn noch keine Datei geladen wurde) zeigt die GUI einen
|
||||
deutschen Willkommenstext mit dem Hinweis, über „Neu" eine Standardvorlage zu erzeugen
|
||||
oder über „Öffnen" eine bestehende `.properties`-Datei zu laden.
|
||||
|
||||
### 2.2 Start mit `--config <pfad>` (gültige Datei)
|
||||
|
||||
@@ -578,6 +583,52 @@ Behebung eines externen Fehlers oder planmäßig im nächsten regulären Lauf.
|
||||
|
||||
---
|
||||
|
||||
## 13b. PDF-Vorschau und editierbarer Dateiname im Verarbeitungslauf-Tab
|
||||
|
||||
Nach Abschluss eines Verarbeitungslaufs (oder während laufender Verarbeitung) zeigt
|
||||
ein Klick auf eine Zeile in der Ergebnisliste ein Detail-Panel auf der rechten Seite.
|
||||
Das Panel enthält drei Bereiche:
|
||||
|
||||
### PDF-Vorschau
|
||||
|
||||
- Zeigt die **Quelldatei** der gewählten Zeile als Vorschau an.
|
||||
- **Lazy Rendering:** Seite 1 wird sofort geladen; weitere Seiten werden erst bei
|
||||
Bedarf gerendert.
|
||||
- **In-Memory-Cache:** Bereits gerenderte Seiten werden pro Zeilenselektion
|
||||
zwischengespeichert. Bei einem Zeilenwechsel wird der Cache der vorherigen Auswahl
|
||||
verworfen.
|
||||
- **Seitennavigation:** Über die Schaltflächen **„◀"** und **„▶"** (oder das Mausrad)
|
||||
kann seitenweise geblättert werden. Die aktuelle Seitenzahl und Gesamtseitenzahl
|
||||
werden angezeigt.
|
||||
- **Fit-to-view:** Die Seite wird automatisch an die verfügbare Fläche angepasst
|
||||
(preserveRatio=true). Keine Scrollbalken, keine manuelle Zoom-Einstellung.
|
||||
- Das Rendering erfolgt direkt über Apache PDFBox bei 120 DPI.
|
||||
|
||||
### KI-Begründung
|
||||
|
||||
Der mittlere Bereich zeigt das KI-Reasoning des ausgewählten Eintrags. Liegt kein
|
||||
Reasoning vor (z. B. bei Übersprungen-Einträgen), erscheint der Hinweis
|
||||
„Für diesen Eintrag liegt kein KI-Reasoning vor.".
|
||||
|
||||
### Editierbarer Dateiname
|
||||
|
||||
- Unterhalb des Reasoning-Bereichs befindet sich ein **editierbares Textfeld** mit
|
||||
dem aktuellen Dateinamen des Eintrags.
|
||||
- Das Feld kann direkt bearbeitet werden. Die Eingabe wird **live validiert**
|
||||
(Formatprüfung `YYYY-MM-DD - Titel.pdf`, Titelzeichen, Länge).
|
||||
- Fehlerhafte Eingaben werden direkt unter dem Feld als rote Meldung angezeigt.
|
||||
- **Speichern:** Der Button **„Übernehmen"** führt die Umbenennung durch – atomare
|
||||
Dateisystem- und DB-Transaktion inkl. automatischer Rollback bei Fehler.
|
||||
Namenskonflikte im Zielordner werden über ein Dubletten-Suffix aufgelöst.
|
||||
- **Zurücksetzen:** Der Button **„Zurücksetzen"** verwirft die Änderungen und stellt
|
||||
den zuletzt persistierten Dateinamen wieder her.
|
||||
- Wird die Zeile gewechselt oder der Tab verlassen, während ungespeicherte Änderungen
|
||||
vorliegen, erscheint ein Schutzdialog mit den Optionen **„Speichern"**, **„Verwerfen"**
|
||||
und **„Abbrechen"**.
|
||||
- Während eines laufenden Verarbeitungslaufs ist das Dateiname-Feld **gesperrt**.
|
||||
|
||||
---
|
||||
|
||||
## 14. Bekannte Einschränkungen V2.x
|
||||
|
||||
| Einschränkung | Erläuterung |
|
||||
|
||||
Reference in New Issue
Block a user