Document OCR review UI and docs
Distinguish soldier OCR from Training materials
 
(4 intermediate revisions by the same user not shown)
Line 2: Line 2:
<div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>
<div class="ocr-inbox-slot"><p>Loading document OCR tools… (requires login and the OCR review service).</p></div>


Site-wide inbox for document OCR. Upload a scan, confirm '''who''' it is and '''which soldier page''' would change, then Apply.
Site-wide inbox to '''enrich soldier profiles from document scans''' — forms, certificates, clippings, letters, and team rosters. Upload a scan, confirm '''who''' it is and '''which soldier page''' would change, review proposed infobox facts and a short biography draft, then Apply.


== How it works ==
== How it works ==
# '''Log in''' (same as photo uploads).
# '''Log in''' (same as photo uploads).
# Upload a document. OCR runs on the server; nothing is written yet.
# Upload a document (photo or PDF). Printed text uses the free local OCR engine. Check '''Handwriting / hard scan''' for cursive or faint pages — the service still runs a free print OCR first and only calls the paid LLM vision model when that preliminary read looks weak.
# '''Confirm''' — a roster becomes a table: person on the scan, matched wiki page, and the one change that would be written on that profile (usually Team). Rank, role, and ASN from the scan are matching cues, not automatic edits. This is the same review for SO 103, 125, 135, and other multi-person scans — not a separate layout per form.
# '''Confirm''' who the document is about. Review proposes '''infobox''' fields and a '''biography draft''' woven from clear facts not a raw OCR dump. Nothing is written until Apply.
# Read '''Soldier pages that will be edited''' at the top. Use '''Preview Apply''' to see planned page changes without writing. Then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin). '''Discard''' drops the job.
# For '''multi-person IPW / team rosters''', you get a table: each person, the matched wiki page, and what would be written (usually Team membership). Names, ranks, and ASNs are matching cues until you approve.
# Expert options (raw OCR text, document type, gallery, overwrite) are under '''Advanced'''.
# Check '''Soldier pages that will be edited''' at the top. Use '''Preview Apply''' to see planned changes without writing. Then '''Apply selected''' (requires <code>ocr-reviewer</code> or admin), or '''Discard''' the job.
# Optional controls (raw OCR text, document type, gallery attach, overwrite, handwriting re-OCR) are under '''Advanced'''.


Profile shortcut: soldier page → Gallery → '''OCR a document''' (pre-selects that soldier).
You can also start from a soldier page → Gallery → '''OCR a document to enrich this profile''' (that soldier is pre-selected).
 
Facebook gallery OCR candidates in the 70–79% band can be seeded into this queue (review only — nothing is auto-applied). See [[Facebook OCR review]] and <code>python scripts/seed_fb_ocr_review_jobs.py</code>.


== Privacy ==
== Privacy ==
Line 22: Line 21:
== For reviewers ==
== For reviewers ==
Administrators can grant the '''ocr-reviewer''' group. Other logged-in uploads stay in the queue until a reviewer applies or discards them.
Administrators can grant the '''ocr-reviewer''' group. Other logged-in uploads stay in the queue until a reviewer applies or discards them.
See also [[Facebook OCR review]] (editors-only queue of Facebook-sourced document OCR candidates; review aid only — prefer this page for new uploads). Camp-wide training manuals belong on [[Training materials]], not here.


[[Category:Ritchie Boys Wiki]]
[[Category:Ritchie Boys Wiki]]