#Paperless

Ein Duplikat erkennt man sicher an der Prüfsumme des Inhalts, nicht am Dateinamen. Beim Aufräumen doppelt eingespielter Belege in Paperless fiel mein Skript, als der genaue Abgleich ins Leere lief, auf den Titel zurück und löschte vier echte Rechnungen über einen Fahrzeugverkauf. Zurückgeholt habe ich sie aus dem Papierkorb, der 613 Einträge lang war. Seitdem vergleicht es nur noch über die Prüfsumme, und fehlt die, hält es an, statt zu raten. Zwei Namen ähneln sich leicht, zwei Inhalte nie.

Einen Fehler, der keinen Schaden anrichtet, behebt man trotzdem, sobald er regelmäßig im Protokoll steht. Unser Dokumentenarchiv Paperless startet jeden Morgen um sechs kurz neu, und unser Import-Programm klopfte im Fünf-Minuten-Takt genau in diese Lücke: jeden Tag rote Fehlermeldungen, nie ein echter Schaden. Jetzt fragt das Programm vorher kurz an, ob das Archiv erreichbar ist, und zieht sich sonst still bis zum nächsten Takt zurück. Ein Protokoll voller harmloser Fehler erzieht zum Überlesen, und irgendwann überliest man den einen, der zählt.

Sechstausend alte Dokumente holt man ins Archiv, indem man der Automatik Zeit gibt statt Tempo. Bei uns wandern gerade 6.215 Bilddateien alter Fahrzeug- und Kundenakten aus Loco-Soft in die Dokumentenablage, und die Texterkennung braucht gut vierzig Sekunden pro Stück. Der Import läuft deshalb nur nachts und belegt bewusst nur einen von zwei Arbeitsprozessen, damit tagsüber niemand am Tresen wartet und die nächtliche Datensicherung Luft behält. Nach rund sechs Nächten ist der Bestand drin. Eine gute Migration merkt niemand, und genau das ist ihr Erfolg.

Die Duplikat-Warnung eines Programms reicht als Schutz nicht, denn eine Meldung ist keine Sperre. Unser Dokumentenarchiv Paperless meldete bei jedem erneuten Upload brav, dass ein Dokument mit gleichem Inhalt schon existiert, und importierte die Datei trotzdem. So sammelten sich 527 Kopien desselben Fotos an, bis ich die Prüfung selbst eingebaut habe: ein Inhalts-Vergleich vor jedem Upload. Was ein System nur meldet, muss man selbst verhindern.

Eine Automatik darf einen Vorgang nicht wiederholen, nur weil die Antwort ausbleibt, denn keine Antwort heißt nicht gescheitert. Bei uns ließ ein einziges 138-Megapixel-Foto die Texterkennung in Paperless länger laufen als die zwei Minuten, die mein Skript wartete. Es wertete das Schweigen als Fehlschlag und lud dieselbe Datei immer wieder neu hoch, am Ende standen 526 Duplikate im Archiv. Seitdem unterscheidet das Skript drei Ausgänge: gelungen, gescheitert und noch offen. Wer Schweigen als Scheitern deutet, wiederholt Dinge, die längst gelungen sind.

Ins Dokumentenarchiv gehört ein Foto nicht in voller Auflösung, sondern in der Auflösung, die das Archiv wirklich braucht. Ein einzelnes 138-Megapixel-Bild aus unseren alten Fahrzeugakten trieb die Texterkennung von Paperless über jede Zeitgrenze, und die Automatik erzeugte daraus über fünfhundert Duplikate. Seit wir solche Riesenbilder vor dem Hochladen auf 300 DPI verkleinern, also volle A4-Druckqualität, ist die Erkennung in siebenundzwanzig Sekunden fertig, und das Original bleibt unangetastet auf dem Quell-Laufwerk liegen. Mehr Auflösung ist nicht mehr Wert, sie ist nur mehr Last.

Ein eingespielter Handgriff kann einen Fehler in der Automatik tagelang verstecken. In unserem Dokumentensystem Paperless kamen neue Scans mit falschen Sichtbarkeitsrechten an, 208 Dokumente konnte nur ein einziger Nutzer sehen. Drei Tage fiel das niemandem auf, weil ich als Postverteiler ohnehin jeden Beleg von Hand zuordne und die Rechte dabei unbewusst mit reparierte. Erst als der Empfang einen fehlenden Scan meldete, flog der Fehler auf. Wo ein Mensch täglich stillschweigend nachbessert, sieht der Prozess gesund aus, obwohl die Maschine krank ist.

Mit dem Admin-Zugang zu testen reicht nicht, denn der Admin sieht Dinge, die sonst niemand sieht. In unserer Dokumentenablage (Paperless) waren drei Tage lang 208 eingescannte Belege für die Kollegen unsichtbar, weil die Automatik sie stillschweigend dem technischen Benutzer zuordnete. Unsere Tests liefen mit genau diesem Benutzer, also sah alles korrekt aus, bis der Empfang meldete, dass Scans nicht ankommen. Seitdem prüfen wir jede Änderung zusätzlich mit einem einfachen Mitarbeiter-Konto. Man muss ein System mit den Augen dessen testen, der damit arbeiten soll, nicht mit den eigenen.

Ob eine neue Software im Betrieb ein Erfolg wird, entscheiden nicht die Techniker, sondern die Mitarbeiter, die täglich damit arbeiten. Unser neues Dokumenten-System Paperless lief seit über einer Woche technisch sauber, jeder Abgleich per Schnittstelle war grün, aber am Tresen fühlten sich die Kollegen wie Beta-Tester, weil frisch eingescannte Belege für sie unsichtbar blieben. Seitdem melde ich mich nach jeder Änderung als normaler Mitarbeiter an und prüfe, ob ein Tresen-Scan wirklich ankommt, statt nur der Technik zu glauben. Ein Update ist erst fertig, wenn es niemandem auffällt.

Einen Fehler, der immer wiederkommt, behebt man nicht nur, man baut ihm einen Wächter. In unserer Dokumentenablage schlich sich derselbe Sichtbarkeits-Fehler seit Projektbeginn in jeden neuen Upload-Weg ein, zuletzt bei 132 Bildern, die nachts eingespielt wurden. Jetzt prüft eine kleine Routine alle fünf Minuten den Bestand und stellt falsche Zuordnungen von selbst richtig. Die Ursache beheben wir trotzdem jedes Mal, aber der Wächter fängt das nächste Vergessen ab. Gegen einen wiederkehrenden Fehler hilft keine Erinnerung, nur ein Mechanismus.

Ein neuer Fehler tauchte genau dann auf, als die Verarbeitung schneller wurde, weil Tempo einen Engpass freilegt, den die Langsamkeit vorher zugedeckt hat. Ich hatte das Einlesen der Belege umgebaut, damit niemand mehr wartet: die Blockade pro Beleg sank von rund fünfzig auf zwei bis vier Sekunden. Prompt kollidierten zwei gleichzeitig ankommende Dokumente am selben Volltext-Index von Paperless, eines brach ab. Der Fix war ein zweiter Anlauf mit kurzer Pause. Wer einen Engpass löst, bekommt den nächsten zu sehen.

Erst die Warteschlange zu bauen und dann die Eingaenge anzuschliessen, spart am Ende die meiste Arbeit. Seit unser Anreicherungsdienst jedes Dokument mit dem einen Tag Warteschlange durch denselben Ablauf schickt, egal ob es vom Scanner, per E-Mail oder ueber den Upload-Knopf in Paperless kommt, ist ein neuer Eingang fast geschenkt: er muss nur diesen einen Tag setzen. Vorher haette jeder Weg seinen eigenen Anbau gebraucht. Wer die Naht an der richtigen Stelle legt, macht jede spaetere Erweiterung billig.

Einen Tag, den niemand vergeben hat, hängt nicht der Code an, sondern das System selbst. In unserem Dokumentenarchiv Paperless bekam jeder eingelesene Beleg die Markierung ZU BEARBEITEN, obwohl mein Import-Skript sie nie setzte. Der Grund war eine einzige Voreinstellung: der Tag galt als Eingangskorb und wird damit automatisch an alles gehängt, was hereinkommt. Dieselbe Mechanik hatte schon einmal 581 Belege stumm markiert. Wenn etwas auftaucht, das du nicht gesetzt hast, such nicht im eigenen Code, sondern in den Voreinstellungen.

Der Wechsel des Dokumenten-Systems lohnt sich nicht, sobald das alte schon trägt. Wir haben geprüft, ob wir unser Paperless-ngx gegen etwas Neues tauschen, und dann gezählt, was schon drinsteckt: über zwölfhundert Belege mit eigenen Feldern, hundertacht Ablagepfade, einundzwanzig Dokumentarten und eine zehn Jahre lange, unveränderbare Aufbewahrung für das Finanzamt. Das wirft man nicht für ein schöneres Menü weg. Ein System wechselt man wegen einer Grenze, nicht wegen einer Verlockung.

Eine Fehlermeldung sagt nicht immer, wo der Fehler wirklich liegt. Eine iOS-App verweigerte die Verbindung zu meinem Paperless und meldete, das Backend unterstütze die nötige API-Version drei nicht. Tatsächlich spricht meine Version die API-Stufen eins bis sieben, die drei war also längst dabei und der Haken saß ganz woanders. Eine Meldung zeigt, was ein Programm gerade vermutet, nicht zwingend, was kaputt ist.

Ein Firmendokument gehoert nicht der Person, die es einscannt, sondern niemandem persoenlich. Bei uns hingen siebenhundertneunundachtzig Dokumente am Konto eines einzelnen Mitarbeiters, und ich fragte mich, was passiert, wenn der einmal kuendigt. Heute entscheidet das Scan-Profil am Geraet: Firmenpost bekommt keinen Eigentuemer und laeuft ueber den Posteingang, nur Privates bleibt an einer Person. Was allen gehoert, sollte an keinem Einzelnen haengen.