# klar. DMS Cockpit

Lokaler Begleiter für Paperless-ngx mit Vorgängen, Scan-Studio und geprüfter Archivübergabe. Eine sanitisierte Architekturbeschreibung zeigt den Aufbau ohne private Dokumente oder Betriebszugänge.

Herkunft: OWNER_BUILT_PRIVATE

Technologien: Python, JavaScript, SQLite, Paperless-ngx REST, OCR, PowerShell, Windows / Hyper-V

## Mein Beitrag

Eigener lokaler Begleiter für Paperless-ngx: Python-Service, SQLite-Zustände, browserbasierte Bedienung und geprüfte Übergabewege. Die veröffentlichte Darstellung zeigt ausschließlich Architektur und technische Methoden.

## Ausgangsproblem

Ein Archiv speichert Dokumente. Die Arbeit davor und danach braucht aber weitere Zustände: Was ist gescannt, geprüft, erkannt, einem Vorgang zugeordnet oder wirklich archiviert? Das Cockpit verbindet diese Schritte, ohne eine OCR-Ausgabe mit einem erfolgreichen DMS-Import gleichzusetzen. Originale und Seitenherkunft sollen nachvollziehbar bleiben.

## Workflow

1. Autorisierte Aufnahme mit gemeinsamer Scansperre
2. Originalseiten und Herkunft erhalten
3. Reihenfolge und Dokumentgrenzen prüfen
4. OCR-Fassung an eine konkrete Version binden
5. Archivbestätigung des bestehenden DMS abwarten

## Engineering

### Ein Begleiter mit klarer Systemgrenze

Ein eigener Python-Prozess verwaltet Cockpit-Zustände in SQLite. Paperless wird über REST angebunden, nicht durch direkte Änderungen an seiner Datenbank. So bleibt erkennbar, welches System einen Vorgang führt und welcher Schritt an einer externen Grenze bestätigt werden muss.

### Version, Hash und menschliche Sichtprüfung

Scan- und Importwege arbeiten mit Quellnachweisen und einer konkreten Prüffassung. Änderungen an der Seitenfolge oder Dokumenttrennung sind damit keine stillen Korrekturen an einem vermeintlich fertigen Dokument. Teilbestände und Unsicherheiten bleiben ausdrücklich sichtbar.

### Gerätetechnik und Archivbetrieb trennen

Die dokumentierte Bereitstellung trennt Windows-Gerätezugriff, lokale Hilfswerkzeuge und den containerisierten Archivdienst im Linux-Gast. Gemeinsame Sperren schützen den Scanner vor konkurrierenden Aufträgen. Ein Simulator-Test wird nicht als reale Papieraufnahme ausgegeben.

## Entscheidungen

- Vorbereitung, OCR und tatsächliche Archivbestätigung als unterschiedliche Zustände führen.
- Private Dokumente, Datenbanken und Zugangsdaten strikt aus dem Code-Repository und dem öffentlichen Portfolio heraushalten.
- Wiederholte Übergaben und geänderte Prüffassungen explizit behandeln, damit kein stiller Doppelimport entsteht.

## Nachweise und Grenzen

- Sanitisierte Architekturbeschreibung mit Systemgrenzen, Zustandsfluss und den eingesetzten Technologien.
- Eigener Projektcode und automatisierte Prüfungen zu Vorgängen, Sperren, Herkunft und Synchronisationszuständen.

Keine echten Dokumente, Mails, Scans, Vorgänge oder Produktionszugänge sind Bestandteil dieser Referenz. Die Fallstudie ist keine öffentliche Demo des privaten Archivs.

https://docs.mk1.rocks/de/references/klar-dms-cockpit/

Marvin Kamp · 25.10.2026