Files

T

marcus 234b3461b7 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>

2026-04-24 16:56:13 +02:00

5.0 KiB

Raw Blame History

Fachliche Anforderungen – PDF-Umbenenner

1. Zielbild

Das System verarbeitet PDF-Dateien aus einem definierten Quellordner und erzeugt daraus eindeutig benannte, verständliche Zieldateien.

Ziel ist eine automatisierte, nachvollziehbare, robuste und wiederholbare Benennung von Dokumenten für den produktiven Einsatz.

2. Geltungsbereich

Dieses Dokument beschreibt ausschließlich die fachlichen Anforderungen.

Nicht enthalten:

technische Architektur
Framework-Entscheidungen
Implementierungsdetails

3. Hauptprozess

Eine PDF-Datei im Quellordner wird als Verarbeitungskandidat erkannt.
Die Datei wird verarbeitet.
Falls erfolgreich:
- Ein neuer Dateiname wird erzeugt.
- Die Datei wird im Zielordner abgelegt.
Falls fehlgeschlagen:
- Der Fehler wird dokumentiert.
- Ein Retry erfolgt abhängig von der Fehlerart.

4. Benennungsregeln

4.1 Format

Der Dateiname folgt strikt diesem Muster:

YYYY-MM-DD - Titel.pdf

4.2 Datum

Priorität:

Rechnungsdatum
Dokumentdatum
anderes sinnvolles Dokumentdatum
aktuelles Datum (Fallback)

Definition „anderes sinnvolles Dokumentdatum“

Reihenfolge:

Ausstellungsdatum
Bescheiddatum
Schreibdatum
Ende eines Leistungszeitraums

Fallback auf aktuelles Datum ist erlaubt, wenn kein belastbares Datum eindeutig ableitbar ist.

4.3 Titel

maximal konfigurierbare Anzahl Zeichen (Basistitel, Default 60, gültiger Bereich 10..120)
verständlich und eindeutig
keine Sonderzeichen außer Leerzeichen, Bindestrichen, Punkten, Kommas und Ampersands

4.4 Sprache

Titel werden auf Deutsch erzeugt
Eigennamen bleiben unverändert

4.5 Dublettenregel

Bei Namenskonflikten:

(1), (2), … wird angehängt

Regel:

die konfigurierte maximale Titellänge gilt nur für den Basistitel
Suffix wird zusätzlich ergänzt

5. Verarbeitungsfähigkeit

Jede PDF im Quellordner ist zunächst ein Verarbeitungskandidat
Die fachliche Bewertung erfolgt während der Verarbeitung

6. Fehlerbehandlung

6.1 Fehlerarten

Deterministische Inhaltsfehler

kein extrahierbarer Text
Seitenlimit überschritten
nicht eindeutig interpretierbar

Transiente Fehler

KI nicht erreichbar
Timeout
technische Fehler

6.2 Retry-Logik

Inhaltsfehler: genau 1 Retry
danach finaler Fehler
Transiente Fehler: Retry bis Maximalwert

7. KI-Nutzung

KI wird zur Ermittlung von Datum und Titel verwendet

Begründung

Bei KI-Aufruf: KI-Begründung erforderlich
Ohne KI-Aufruf: fachliche/systemische Begründung erforderlich

8. Mehrdeutigkeit

Wenn ein Dokument nicht eindeutig interpretierbar ist:

Verarbeitung wird als Fehler bewertet
kein unsicheres Ergebnis wird erzeugt

9. Idempotenz

Erfolgreiche Dateien werden nicht erneut verarbeitet
Retryable fehlgeschlagene Dateien können in späteren Läufen erneut verarbeitet werden
Final fehlgeschlagene Dateien werden in späteren Läufen übersprungen

10. Umgang mit Quelldateien

Quelldateien bleiben unverändert
keine Überschreibung

11. Identifikation

nicht über Dateinamen