Entwicklung

Offline-first ist eine Warteschlange, kein Slogan

12. November 2026 · Software by Design

Eine Pflegekraft dokumentiert einen Besuch im Souterrain ohne Empfang. Ein Kiosk-Terminal stempelt weiter, während das Gelände-WLAN ausfällt. „Funktioniert offline“ steht schnell auf einer Feature-Liste, entscheidend ist, was genau mit diesen Datensätzen passiert und was niemals passieren darf.

Die Outbox, spezifiziert

Wenn das Netz wegbricht, halten unsere Begleit-Apps Stempel nicht „im Speicher“ und hoffen. Jeder ausstehende Stempel landet in einer verschlüsselten Warteschlange auf dem Gerät, AES-GCM-Chiffrat im lokalen Speicher, der Schlüssel im Secure Store der Plattform, begrenzt auf 32 Einträge, damit eine tote Verbindung keinen unbegrenzten Rückstau anwachsen lässt. Die Warteschlange arbeitet FIFO und leert sich bei zurückkehrender Verbindung von selbst.

Die Verschlüsselung im Ruhezustand ist der unscheinbare Teil, der zählt: Ein Stempel ist ein personenbezogenes Datum. „Lag ja nur eine Stunde auf dem Telefon“ ist keine Antwort auf ein gestohlenes Gerät.

Warum der Server entscheidet, nicht das Telefon

Beim Nachsenden liegen Offline-Features meist falsch. Ein Retry kann doppelt ankommen. Zwei Warteschlangen-Aktionen können in falscher Reihenfolge eintreffen. Deshalb trägt jeder Stempel eine Client-Request-ID und den echten Zeitstempel, wann es passiert ist, nicht wann es ankam. Der Server reserviert die Request-ID vor jeder Mutation. Ein doppelter Retry wird damit zum No-Op statt zum Doppelstempel. Gleiche ID, anderer Inhalt? Das ist ein 409-Konflikt, kein stilles Überschreiben. Und die Compliance-Prüfung läuft gegen den Moment des Stempels, ein nachgereichter Kommen-Stempel von 07:02 zählt als 07:02, innerhalb des Skew-Fensters, das die Organisation konfiguriert (Standard 24 Stunden, harte Obergrenze 72).

Die Kiosk-Variante löst die härtere Version desselben Problems: kein persönlicher Login am Gerät. Badges werden über einen begrenzten, verschlüsselten NFC-Identitäts-Cache aufgelöst, maximal 500 Einträge, sieben Tage TTL, damit ein Terminal-Ausfall nicht zur Schlange am Tor wird.

Die Grenze, die wir uns selbst setzen

Offline-Toleranz ist ein Fenster, keine Lebensform. Stempel älter als das konfigurierte Skew laufen nicht mehr nach, sondern tauchen zur Klärung durch einen Menschen auf, weil eine Woche altes „Kommen“ aus dem Nichts genau der Mechanismus ist, mit dem Zeitnachweise ihre Glaubwürdigkeit verlieren. Und wer sich abmeldet, während Stempel ausstehen, bekommt das gesagt, warten oder verwerfen, Ihre Entscheidung, klar formuliert.

Das heißt „offline-first“ in unseren Apps: nicht dass die Oberfläche ohne Empfang aufgeht, sondern dass der Audit-Trail einen Ausfall übersteht. ArbeitszeitCheck Mobile und Terminal sowie CareCheck liefern das heute.