marcus/pdf-umbenenner
1
0
Fork 0
Code Issues 14 Releases 2 Activity

UX: Fehlergrund bei FAILED nicht sichtbar – Benutzer erhaelt kein Feedback #43

New Issue
Closed
opened 2026-04-27 11:06:00 +02:00 by marcus · 3 comments
marcus commented 2026-04-27 11:06:00 +02:00
Owner
Copy Link
Copy Source

Problem

Wenn ein Dokument den Status FAILED oder FAILED_FINAL erhaelt, sieht der Benutzer im Detailbereich nur 'Fuer diesen Eintrag liegt kein KI-Reasoning vor'. Der eigentliche Fehlergrund (z.B. Zeichenlimit-Ueberschreitung, KI-Fehler, Timeout) ist nicht sichtbar.

Konkretes Beispiel aus dem Produkttest

Datei: Scan231220150353.pdf
Log: 'AI naming failed: Title exceeds 50 characters (base title): Collegium Augustinum Gehaltsmitteilung November 2022 (deterministic content error)'
GUI: Leeres Dateiname-Feld, kein Hinweis warum.

Erwartetes Verhalten

Im Detailbereich wird bei FAILED/FAILED_FINAL der Fehlergrund angezeigt, z.B.:

  • 'KI-Vorschlag zu lang: Collegium Augustinum Gehaltsmitteilung November 2022 (52 Zeichen, Limit: 50)'
  • 'KI nicht erreichbar'
  • 'PDF-Text nicht extrahierbar'

Akzeptanzkriterien

  1. Fehlergrund wird aus dem DocumentCompletionEvent oder der DB in den Detailbereich geladen
  2. Meldung ist verstaendlich fuer nicht-technische Benutzer
  3. Bei SKIPPED_FINAL_FAILURE: Fehlergrund des letzten Versuchs wird angezeigt
## Problem Wenn ein Dokument den Status FAILED oder FAILED_FINAL erhaelt, sieht der Benutzer im Detailbereich nur 'Fuer diesen Eintrag liegt kein KI-Reasoning vor'. Der eigentliche Fehlergrund (z.B. Zeichenlimit-Ueberschreitung, KI-Fehler, Timeout) ist nicht sichtbar. ## Konkretes Beispiel aus dem Produkttest Datei: Scan231220150353.pdf Log: 'AI naming failed: Title exceeds 50 characters (base title): Collegium Augustinum Gehaltsmitteilung November 2022 (deterministic content error)' GUI: Leeres Dateiname-Feld, kein Hinweis warum. ## Erwartetes Verhalten Im Detailbereich wird bei FAILED/FAILED_FINAL der Fehlergrund angezeigt, z.B.: - 'KI-Vorschlag zu lang: Collegium Augustinum Gehaltsmitteilung November 2022 (52 Zeichen, Limit: 50)' - 'KI nicht erreichbar' - 'PDF-Text nicht extrahierbar' ## Akzeptanzkriterien 1. Fehlergrund wird aus dem DocumentCompletionEvent oder der DB in den Detailbereich geladen 2. Meldung ist verstaendlich fuer nicht-technische Benutzer 3. Bei SKIPPED_FINAL_FAILURE: Fehlergrund des letzten Versuchs wird angezeigt
marcus commented 2026-04-27 11:08:42 +02:00
Author
Owner
Copy Link
Copy Source

Produkttest-Befund: Fehlermeldung irreführend und nicht benutzerfreundlich

Aktuelle Ausgabe im KI-Begründungsbereich

⚠ Fehler: KI-Aufruf fehlgeschlagen. Details im Anwendungslog.
Für diesen Eintrag liegt kein KI-Reasoning vor.

Zwei Probleme

Problem 1: Falsche Fehlerkategorie
Der KI-Aufruf ist nicht fehlgeschlagen – die KI hat korrekt geantwortet.
Das Programm hat den Vorschlag abgelehnt, weil er das Zeichenlimit überschritt.
Die Meldung "KI-Aufruf fehlgeschlagen" ist sachlich falsch.

Problem 2: "Details im Anwendungslog" ist keine Benutzer-Meldung
Endbenutzer lesen keine Logs. Diese Formulierung ist ausschließlich für Entwickler verständlich und gehört nicht in die GUI.

Erwartete Meldung (Beispiel)

⚠ KI-Vorschlag abgelehnt: 'Collegium Augustinum Gehaltsmitteilung November 2022' ist zu lang (52 Zeichen, Limit: 50). Bitte Dateinamen manuell kürzen.

Konsequenz für die Implementierung

  • Fehlertyp "deterministic content error / Zeichenlimit" muss als eigene Kategorie in der GUI behandelt werden
  • KI-Reasoning (der abgelehnte Vorschlag) soll trotzdem angezeigt werden
  • Formulierung muss für nicht-technische Benutzer verständlich sein
## Produkttest-Befund: Fehlermeldung irreführend und nicht benutzerfreundlich ### Aktuelle Ausgabe im KI-Begründungsbereich ``` ⚠ Fehler: KI-Aufruf fehlgeschlagen. Details im Anwendungslog. Für diesen Eintrag liegt kein KI-Reasoning vor. ``` ### Zwei Probleme **Problem 1: Falsche Fehlerkategorie** Der KI-Aufruf ist nicht fehlgeschlagen – die KI hat korrekt geantwortet. Das Programm hat den Vorschlag abgelehnt, weil er das Zeichenlimit überschritt. Die Meldung "KI-Aufruf fehlgeschlagen" ist sachlich falsch. **Problem 2: "Details im Anwendungslog" ist keine Benutzer-Meldung** Endbenutzer lesen keine Logs. Diese Formulierung ist ausschließlich für Entwickler verständlich und gehört nicht in die GUI. ### Erwartete Meldung (Beispiel) `⚠ KI-Vorschlag abgelehnt: 'Collegium Augustinum Gehaltsmitteilung November 2022' ist zu lang (52 Zeichen, Limit: 50). Bitte Dateinamen manuell kürzen.` ### Konsequenz für die Implementierung - Fehlertyp "deterministic content error / Zeichenlimit" muss als eigene Kategorie in der GUI behandelt werden - KI-Reasoning (der abgelehnte Vorschlag) soll trotzdem angezeigt werden - Formulierung muss für nicht-technische Benutzer verständlich sein
marcus commented 2026-04-27 11:12:30 +02:00
Author
Owner
Copy Link
Copy Source

Weiterer Produkttest-Befund: Kein lesbarer Text in PDF

Aktuell angezeigte Meldung

⚠ Fehler: KI-Aufruf fehlgeschlagen. Details im Anwendungslog.
Für diesen Eintrag liegt kein KI-Reasoning vor.

Tatsächlicher Grund (aus Log)

Pre-checks failed: No usable text in extracted PDF content

Die PDF ist gültig und renderbar, enthält aber keinen extrahierbaren Text – vermutlich ein Scan ohne OCR.

Erwartete Meldung

⚠ PDF enthält keinen lesbaren Text. Möglicherweise handelt es sich um einen Scan ohne Texterkennung (OCR). Eine automatische Benennung ist nicht möglich.

Konsequenz für die Implementierung

Jeder Pre-Check-Fehlertyp braucht eine eigene, verständliche Fehlermeldung in der GUI:

Fehlertyp (intern) Benutzerfreundliche Meldung
No usable text PDF enthält keinen lesbaren Text (kein OCR)
Title exceeds N characters KI-Vorschlag zu lang (X Zeichen, Limit: N) – bitte manuell kürzen
KI nicht erreichbar KI-Dienst nicht erreichbar – bitte Verbindung prüfen

Die Meldung "Details im Anwendungslog" darf in der GUI nicht erscheinen.

## Weiterer Produkttest-Befund: Kein lesbarer Text in PDF ### Aktuell angezeigte Meldung ``` ⚠ Fehler: KI-Aufruf fehlgeschlagen. Details im Anwendungslog. Für diesen Eintrag liegt kein KI-Reasoning vor. ``` ### Tatsächlicher Grund (aus Log) `Pre-checks failed: No usable text in extracted PDF content` Die PDF ist gültig und renderbar, enthält aber keinen extrahierbaren Text – vermutlich ein Scan ohne OCR. ### Erwartete Meldung `⚠ PDF enthält keinen lesbaren Text. Möglicherweise handelt es sich um einen Scan ohne Texterkennung (OCR). Eine automatische Benennung ist nicht möglich.` ### Konsequenz für die Implementierung Jeder Pre-Check-Fehlertyp braucht eine eigene, verständliche Fehlermeldung in der GUI: | Fehlertyp (intern) | Benutzerfreundliche Meldung | |---|---| | No usable text | PDF enthält keinen lesbaren Text (kein OCR) | | Title exceeds N characters | KI-Vorschlag zu lang (X Zeichen, Limit: N) – bitte manuell kürzen | | KI nicht erreichbar | KI-Dienst nicht erreichbar – bitte Verbindung prüfen | Die Meldung "Details im Anwendungslog" darf in der GUI nicht erscheinen.
marcus commented 2026-04-27 11:14:54 +02:00
Author
Owner
Copy Link
Copy Source

Weiterer Produkttest-Befund: Ungültige/leere PDF

Aktuell angezeigte Meldung

Für diesen Eintrag liegt kein KI-Reasoning vor.

Tatsächlicher Grund (aus Log)

IOException: Error: End-of-File, expected line at offset 0/5

PDFBox kann die Datei nicht parsen – sie ist leer oder strukturell defekt.

Erwartete Meldung

⚠ Die PDF-Datei ist ungültig oder beschädigt und kann nicht verarbeitet werden.

Ergänzung zur Fehlertyp-Tabelle aus vorherigem Kommentar

Fehlertyp (intern) Benutzerfreundliche Meldung
No usable text PDF enthält keinen lesbaren Text (kein OCR)
Title exceeds N characters KI-Vorschlag zu lang (X Zeichen, Limit: N) – bitte manuell kürzen
IOException / End-of-File PDF-Datei ist ungültig oder beschädigt
KI nicht erreichbar KI-Dienst nicht erreichbar – bitte Verbindung prüfen

Die Meldung "Details im Anwendungslog" und "KI-Aufruf fehlgeschlagen" dürfen in keinem dieser Fälle erscheinen.

## Weiterer Produkttest-Befund: Ungültige/leere PDF ### Aktuell angezeigte Meldung ``` Für diesen Eintrag liegt kein KI-Reasoning vor. ``` ### Tatsächlicher Grund (aus Log) `IOException: Error: End-of-File, expected line at offset 0/5` PDFBox kann die Datei nicht parsen – sie ist leer oder strukturell defekt. ### Erwartete Meldung `⚠ Die PDF-Datei ist ungültig oder beschädigt und kann nicht verarbeitet werden.` ### Ergänzung zur Fehlertyp-Tabelle aus vorherigem Kommentar | Fehlertyp (intern) | Benutzerfreundliche Meldung | |---|---| | No usable text | PDF enthält keinen lesbaren Text (kein OCR) | | Title exceeds N characters | KI-Vorschlag zu lang (X Zeichen, Limit: N) – bitte manuell kürzen | | IOException / End-of-File | PDF-Datei ist ungültig oder beschädigt | | KI nicht erreichbar | KI-Dienst nicht erreichbar – bitte Verbindung prüfen | Die Meldung "Details im Anwendungslog" und "KI-Aufruf fehlgeschlagen" dürfen in keinem dieser Fälle erscheinen.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Assignees
Clear assignees
marcus
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: marcus/pdf-umbenenner#43
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?