Documents & Signing ADR-033 · ADR-039 (Proposed) Overview
v0.1 · 2026-08-23

Reading forms back into RequiemOS.

Staff already scan and email filled forms today. This is the other half of the fill engine — instead of Mortware-style manual re-entry after a scan lands in an inbox, the scan files itself.

Audience — Ryan (adoption case) · Zareef (build surface) · Matt (review-UI design)

Re-keying is where all the time goes.

Kearney already scans filled forms and emails them to an internal address — someone eyeballs the scan, files it into a SharePoint folder named for the deceased, and re-keys anything Mortware, SRS, or an internal spreadsheet needs later. Staff don't need to learn a new habit. RequiemOS intercepts that same email, replaces the SharePoint folder with the case's own document library, and — where it can — skips the re-keying step entirely.

Not every scan needs the same treatment.

A form can arrive filled in three different ways, and each implies a different amount of work for the platform to do with it.

01

Minimal

RequiemOS generates the form and the signature is digital, start to finish. Nothing to ingest — this is the existing Documents & Signing pipeline, unchanged.

Already built
02

Partial

RequiemOS pre-fills and prints the form; staff add checkboxes, write-ins, or a wet-ink signature by hand before it comes back scanned. We already know most of what's on the page.

This document — primary case
03

Full

A flat, third-party, or uncatalogued form — BC Death Registration, hospital notes — printed and completely hand-filled. We know nothing about the page except that it exists.

Filing works today · mining is future work

Most of this is ordinary code.

"AI reads the scan" is the wrong mental model. Case identification and checkbox reading are both deterministic; a vision model only ever sees free-text handwriting, and only when someone actually wants that data extracted.

Case identification
Code
QR decode and printed-text OCR are both deterministic. No AI makes the case-matching call.
Checkbox reading
Code
Coordinate-threshold reads against known widget positions — validated in an isolated test before it ships.
Free-text transcription
Vision‑LLM
The only step that needs AI judgment — and it's optional, running only when a document is actually mined.
Every proposed write
Human
A director confirms before anything lands in the case record. No exceptions, no auto-write.

Seven steps, three actors.

Every ingested scan runs the first three steps. The rest only run if a document's content is actually wanted, not just its filing.

1
Code · Decode

Read the QR, if there is one

A deterministic library read — no AI involved. If the form was generated by RequiemOS and stamped with its case-identifying code, this step alone resolves the case.

2
Code · Resolve

Find the case another way, if needed

No QR, or it didn't decode? Fall to a printed case number wherever the form carries one (still typed text, still cheap), then to matching the extracted name and date of birth against existing cases. Ordinary matching logic — never a judgment call.

3
Filed

Save it to the case's document library

Every scan that reaches a case gets filed here, visible in the case's right-nav, whether or not anything below this line ever runs. This step alone replaces the SharePoint folder.

4
Vision-LLM · Transcribe

Read the handwritten fields

Optional — runs only when someone wants this document's data mined, not just filed. A vision model transcribes free-text fields: names, dates, addresses.

5
Code · Read

Check the checkboxes

Also optional, and deliberately not a vision-LLM call. A coordinate-threshold check against the form's known widget positions — no AI involved. Whether this holds up on real messy scans is being tested in isolation before it ships.

6
Human · Confirm

A director reviews every proposed value

Nothing above this line writes to the case. Extracted values are proposals, shown for accept, edit, or reject — the same posture the platform already uses for at-need conversion.

✓
Written

Confirmed values land through the normal case services

Same write path as any other case update. Ingestion never gets a shortcut around it.

Filing and mining are two different jobs. Every scan gets filed. Only some get mined — and mining can fail completely without losing the document.
Scanned Form Ingestion — Scope & Validation Plan

One small addition, reworked in.

The fast path (step 1) only exists for forms RequiemOS generated in the first place. That means adding a small stamped QR to the templates we want to round-trip cleanly.

Format requirement

A stamped, case-identifying QR — placed wherever it fits

Reuses the same stamping mechanism already used for the document-identity QR on generated PDFs — same pipeline, a different payload, same per-template placement setting. A footer corner is a common choice when there's room, but the header, a margin, or wherever the layout has space works just as well; placement isn't fixed to one spot on the page. Not every template needs it: family-facing keepsakes and government forms opt out, same as they already do for the existing QR.

No QR, no problem — just a slower path. A form without one still gets identified via the printed-text or name/DOB fallback (step 2) and still gets filed. The QR is a shortcut, not a requirement.

Same habit. Less of the work after it.

Nothing changes about how staff produce a filled form — they scan and email it, exactly like now. What happens after the email lands is where the work moves.

Today

  • Staff scan the form and email it to an internal address.
  • Someone opens the email, eyeballs the scan.
  • Files it into a SharePoint folder named for the deceased (and maybe a date).
  • Anything Mortware, SRS, or an internal spreadsheet needs is re-keyed by hand, later, from memory of the scan.
  • No structured search — finding a document means knowing which folder to open.

With RequiemOS

  • Staff scan the form and email it — same address, same habit.
  • The case resolves automatically (QR, printed text, or name/DOB match) and the scan files itself.
  • It shows up in the case's document library immediately — no folder to remember.
  • No re-keying for filing. Optional mining fills structured fields too, with a director confirming before anything writes.
  • Every version is retained and searchable from the case, not scattered across a shared drive.