Local-first software · document workflows
OWNER-BUILT · SANITIZED INSIGHTLocal companion for Paperless-ngx with case workflows, a scan studio and verified archive handoff. A sanitized architecture description explains the design without private documents or access details.
Python, JavaScript, SQLite, Paperless-ngx REST, OCR, PowerShell, Windows / Hyper-V
01 / MY CONTRIBUTION
Owner-built local companion for Paperless-ngx: Python service, SQLite state, browser interface and verified handoff paths. The published material presents architecture and engineering methods only.
THE STARTING QUESTION
An archive stores documents, but the work around it needs additional state: what has been scanned, reviewed, recognized, assigned or actually archived? The cockpit connects those steps without equating OCR output with successful DMS import. Originals and page provenance need to remain traceable.
Authorized capture with a shared scanner lock
Preserve source pages and provenance
Review order and document boundaries
Bind OCR output to a concrete version
Wait for confirmation from the existing archive
This diagram explains the domain relationship. It does not reconstruct a private production network.
Authorized capture with a shared scanner lock
Preserve source pages and provenance
Review order and document boundaries
Bind OCR output to a concrete version
Wait for confirmation from the existing archive
A separate Python process manages cockpit state in SQLite. Paperless is accessed through REST rather than direct database writes. This makes it clear which system owns a state and which step requires confirmation across an external boundary.
Scan and import paths use source provenance and a concrete review version. Changes to page order or document boundaries are therefore not silent modifications to an allegedly finished document. Partial records and uncertainty remain explicit.
The documented deployment separates Windows device access, local tools and the containerized archive service in a Linux guest. Shared locks protect the scanner from competing jobs. A simulator test is not presented as proof of real paper capture.
No real documents, mail, scans, cases or production access form part of this reference. This case study is not a public demo of the private archive.
Published-claims register ↗Let’s discuss the process, system boundaries and a useful first step.
marvinkamp1988@gmail.com ↗My profile for hiring teams ↗