8.7 KiB
8.7 KiB
V2.8 – Selektive Wiederverarbeitung und Status-Reset in der Ergebnisliste
Status: Freigegeben
Erstellt: 2026-04-23
Überarbeitet: 2026-04-23 (nach zwei Reviews, finale Version)
Autor: Marcus (mit Claude als Mentor)
Ziel
V2.8 erweitert den Tab „Verarbeitungslauf" um die Möglichkeit, einzelne oder mehrere Dateien aus der Ergebnisliste gezielt erneut verarbeiten zu lassen oder deren DB-Status zurückzusetzen – ohne die gesamte Datenbank löschen zu müssen.
Hintergrund
Bisheriger Zustand
- Nach einem abgeschlossenen Lauf sind alle Ergebnisse in der Ergebnisliste sichtbar
- Dateien mit Status
FAILED_FINALoderDONEkönnen nur durch manuelles Löschen der SQLite-Datenbank erneut verarbeitet werden - Es gibt keine Möglichkeit, einzelne Dateien selektiv zurückzusetzen oder neu zu starten
Motivation
- Nach Anpassung des Prompts oder Wechsel des KI-Modells sollen bereits verarbeitete Dateien erneut verarbeitet werden können – ohne Datenverlust für andere Dokumente
- Permanent fehlgeschlagene Dateien sollen nach Behebung der Ursache gezielt neu gestartet werden können
- Zwei klar getrennte Aktionen decken unterschiedliche Anwendungsfälle ab: sofortige Wiederverarbeitung vs. Reset für den nächsten regulären Lauf
Zielbild
Nach Abschluss von V2.8 kann der Benutzer:
- Eine oder mehrere Dateien in der Ergebnisliste selektieren
- Per „Erneut verarbeiten" einen sofortigen Mini-Lauf nur für die selektierten Dateien starten
- Per „Status zurücksetzen" den DB-Status zurücksetzen ohne sofortige Verarbeitung – die Dateien werden beim nächsten regulären Lauf automatisch mitgenommen
Fachliche Anforderungen
Selektion in der Ergebnisliste
- Es gibt genau eine fachliche Selektion je Ergebniszeile
- Checkbox, Zeilenklick, Shift/Strg und „Alle auswählen" wirken immer auf dieselbe Selektionsmenge
- Jede Zeile erhält eine Checkbox am linken Rand
- Shift/Strg-Mehrfachselektion wie im Windows Explorer ist möglich
- Eine Checkbox „Alle auswählen" oberhalb der Liste selektiert/deselektiert alle Einträge
- Alle Status sind selektierbar: ✔ erfolgreich, ⚠ retryable, ✘ permanent, ► übersprungen
- Die Selektion bleibt erhalten bis ein neuer Lauf gestartet wird
- Während eines laufenden Mini-Laufs ist die Selektion gesperrt – Änderungen der Selektion nach Laufstart haben keinen Einfluss auf den laufenden Batch
Button „Erneut verarbeiten"
- Aktion: DB-Status der selektierten Dateien zurücksetzen + sofortiger Mini-Lauf nur für diese Dateien
- Aktiv wenn: Kein Lauf aktiv UND mindestens 1 Eintrag selektiert
- Inaktiv wenn: Lauf läuft ODER keine Selektion
- Verhalten:
- Der Mini-Lauf arbeitet auf einem Snapshot der beim Klick selektierten Einträge
- DB-Status aller selektierten Einträge wird zurückgesetzt
- Sofort danach startet ein Mini-Lauf ausschließlich für diese Dateien
- Die Ergebnisliste wird für die selektierten Einträge live aktualisiert
- Nicht selektierte Einträge bleiben unverändert in der Liste
- Der Mini-Lauf verhält sich fachlich wie ein regulärer Lauf – gleiche Anwendungslogik, gleicher Use Case, nur eingeschränkte Dateimenge
Button „Status zurücksetzen"
- Aktion: Nur DB-Status der selektierten Dateien zurücksetzen, keine sofortige Verarbeitung
- Aktiv wenn: Kein Lauf aktiv UND mindestens 1 Eintrag selektiert
- Inaktiv wenn: Lauf läuft ODER keine Selektion
- Verhalten:
- DB-Status aller selektierten Einträge wird zurückgesetzt
- Kein sofortiger Lauf
- Betroffene Zeilen bleiben in der Ergebnisliste sichtbar und erhalten die Kennzeichnung „Zurückgesetzt – wartet auf nächsten Lauf"
- Beim nächsten regulären Lauf werden die zurückgesetzten Dateien automatisch mitgenommen
- Fehlerbehandlung: Reset läuft nach Best-effort-Prinzip –
erfolgreich zurückgesetzte Einträge werden zurückgesetzt, fehlgeschlagene bleiben
im alten Status; der Meldungs- und Zusammenfassungsbereich zeigt:
- Anzahl ausgewählter Einträge
- Anzahl erfolgreich zurückgesetzt
- Anzahl fehlgeschlagen
- Bei Fehlern: betroffene Dateinamen im Meldungsbereich
Welche Status können zurückgesetzt werden
Alle Status sind zurücksetzbar:
| UI-Status | DB-Status | Zurücksetzbar | Verhalten im nächsten regulären Lauf |
|---|---|---|---|
| ✔ Erfolgreich | DONE |
Ja | Wird erneut verarbeitet |
| ⚠ Fehlgeschlagen retryable | FAILED_RETRYABLE |
Ja | Wird erneut verarbeitet |
| ✘ Fehlgeschlagen permanent | FAILED_FINAL |
Ja | Wird erneut verarbeitet |
| ► Übersprungen | DONE |
Ja | DB-Eintrag DONE wird zurückgesetzt, wird erneut verarbeitet |
Verhalten bei vorhandener Zieldatei (Re-Run von DONE)
Wird eine bereits erfolgreich verarbeitete Datei erneut verarbeitet:
- KI schlägt identischen Zieldateinamen vor und Zieldatei ist bereits vorhanden: Datei gilt als ✔ erfolgreich – kein neuer Eintrag im Zielordner, kein Fehler
- KI schlägt anderen Namen vor: Normale Verarbeitung –
Dubletten-Suffix
(1),(2)wie im regulären Betrieb wenn nötig
Verhalten bei fehlender oder verschobener Quelldatei
Ist die Quelldatei zum Zeitpunkt des Mini-Laufs nicht mehr vorhanden:
- Eintrag erhält Status ✘ permanent fehlgeschlagen
- Meldung: „Quelldatei nicht gefunden: {Dateiname}"
- Kein weiterer Retry
Verhalten während eines Mini-Laufs
- Der Abbrechen-Button (Soft-Stop aus V2.7) gilt auch für den Mini-Lauf
- Bei Soft-Stop:
- Bereits erfolgreich verarbeitete Einträge behalten ihren neuen Endstatus
- Noch nicht gestartete, aber bereits zurückgesetzte Einträge behalten den Status „Zurückgesetzt – wartet auf nächsten Lauf" und werden beim nächsten regulären Lauf mitgenommen
- Der Mini-Lauf endet im UI-Zustand „abgebrochen" mit Zusammenfassung
- Tab 1 „Konfiguration" wird während des Mini-Laufs gesperrt
- Fortschrittsbalken zeigt den Fortschritt des Mini-Laufs – Nenner entspricht der Anzahl der selektierten Dateien
- Während eines Mini-Laufs sind „Erneut verarbeiten" und „Status zurücksetzen" deaktiviert
- Kein zweiter paralleler Lauf ist startbar
Scope dieser Funktion
Die Funktion gilt ausschließlich für Einträge der sichtbaren Ergebnisliste der aktuellen Sitzung. Beim Programmstart erfolgt keine Rekonstruktion der Ergebnisliste aus der DB.
Nicht in V2.8 enthalten
- Historien-Tab / SQLite-Ansicht (V3.0)
- Bearbeitung des KI-Titels in der GUI
- Manuelles Überschreiben eines Ergebnisses
- Massenoperationen außerhalb der Ergebnisliste
- Automatischer Re-Run nach Konfigurationsänderung
- Rekonstruktion der Ergebnisliste beim Programmstart
Abnahmekriterien
- Jede Zeile der Ergebnisliste hat eine Checkbox
- Checkbox und Zeilenklick repräsentieren dieselbe Selektionsmenge
- Shift/Strg-Mehrfachselektion funktioniert wie im Windows Explorer
- „Alle auswählen"-Checkbox selektiert/deselektiert alle Einträge
- Alle vier Status sind selektierbar
- Während eines laufenden Mini-Laufs kann die Selektion nicht verändert werden
- Button „Erneut verarbeiten" ist nur aktiv wenn kein Lauf läuft und mindestens 1 Eintrag selektiert ist
- Button „Status zurücksetzen" ist nur aktiv wenn kein Lauf läuft und mindestens 1 Eintrag selektiert ist
- „Erneut verarbeiten" setzt DB-Status zurück und startet sofortigen Mini-Lauf nur für selektierte Dateien
- Der Mini-Lauf verarbeitet genau die beim Start selektierten Einträge – spätere Selektionsänderungen haben keinen Einfluss
- „Status zurücksetzen" setzt nur den DB-Status zurück, betroffene Zeilen erhalten Kennzeichnung „Zurückgesetzt – wartet auf nächsten Lauf"
- Reset-Ergebnis zeigt Anzahl ausgewählter, erfolgreich zurückgesetzter und fehlgeschlagener Einträge
- Bei identischem Zieldateinamen gilt der Eintrag nach Re-Run als ✔ erfolgreich
- Fehlende Quelldatei führt zu ✘ permanent fehlgeschlagen mit Meldung
- Mini-Lauf zeigt korrekten Fortschrittsbalken für die selektierte Dateimenge
- Abbrechen-Button (Soft-Stop) funktioniert auch während eines Mini-Laufs
- Nach Soft-Stop: bereits verarbeitete Einträge behalten neuen Status, nicht gestartete bleiben „Zurückgesetzt"
- Tab 1 ist während des Mini-Laufs gesperrt
- Nicht selektierte Einträge bleiben nach „Erneut verarbeiten" unverändert in der Liste
- Beim nächsten regulären Lauf nach „Status zurücksetzen" werden zurückgesetzte Dateien mitgenommen
- Während eines Mini-Laufs sind beide Buttons deaktiviert
- headless-Betrieb ist unverändert funktionsfähig
mvn clean verifyist grün