feat(ocr): two-phase progress indicator distinguishing preprocessing from OCR analysis #256

New Issue

marcel · 2026-04-17T15:20:02+02:00

marcel commented

2026-04-17 15:20:02 +02:00

Background

Deferred during PR #255 review cycle 1 (Markus Keller — architect review).

Concern

Both PREPROCESSING_PAGE and ANALYZING_PAGE progress codes produce the same visual output in the OCR progress bar. Both emit currentPage and totalPages, and the frontend renders them identically. On a multi-page document, the progress bar moves through a preprocessing phase, then appears to stall before the OCR phase starts — with no label change to indicate what the service is doing.

"If a multi-page document takes 2 s to preprocess and 8 s to OCR, the user sees the bar move then stall with no indication of what changed. This isn't broken, but it's a missed opportunity for a two-phase progress indicator." — @Markus

Suggested approach

Add a phase field to the OcrProgressResult returned by translateOcrProgress. The OCR overlay can read it to show a label like "Aufbereitung…" → "Analyse…" above the progress bar.

Why deferred

Would require UI changes to the OCR overlay component, new i18n keys, and possible changes to the translateOcrProgress return type. Out of scope for the preprocessing pipeline PR.

Reference

PR: http://heim-nas:3005/marcel/familienarchiv/pulls/255

## Background Deferred during PR #255 review cycle 1 (Markus Keller — architect review). ## Concern Both `PREPROCESSING_PAGE` and `ANALYZING_PAGE` progress codes produce the same visual output in the OCR progress bar. Both emit `currentPage` and `totalPages`, and the frontend renders them identically. On a multi-page document, the progress bar moves through a preprocessing phase, then appears to stall before the OCR phase starts — with no label change to indicate what the service is doing. > "If a multi-page document takes 2 s to preprocess and 8 s to OCR, the user sees the bar move then stall with no indication of what changed. This isn't broken, but it's a missed opportunity for a two-phase progress indicator." — @Markus ## Suggested approach Add a `phase` field to the `OcrProgressResult` returned by `translateOcrProgress`. The OCR overlay can read it to show a label like "Aufbereitung…" → "Analyse…" above the progress bar. ## Why deferred Would require UI changes to the OCR overlay component, new i18n keys, and possible changes to the `translateOcrProgress` return type. Out of scope for the preprocessing pipeline PR. ## Reference PR: http://heim-nas:3005/marcel/familienarchiv/pulls/255

marcel referenced this issue

2026-04-17 15:21:18 +02:00

feat(ocr): add image preprocessing pipeline to improve transcription quality on aged documents #255

marcel referenced this issue

2026-04-17 15:21:37 +02:00

feat(ocr): add image preprocessing pipeline to improve transcription quality on aged documents #255

marcel added the feature ui labels 2026-04-17 15:33:30 +02:00

marcel commented

2026-04-17 15:51:35 +02:00

We have no progress bar anymore

marcel closed this issue

2026-04-17 15:51:36 +02:00