Offline-first-PWA

Was ist das?

Die digitale Prüfung ist eine Offline-first-PWA (Progressive Web App). Das bedeutet:

• Sie öffnet sich wie eine normale Webseite (keine App aus dem Store).
• Einmal geöffnet, funktioniert sie auch, wenn die Verbindung abbricht.
• Sobald die Verbindung zurück ist, synchronisiert sie die Daten automatisch mit dem Server.

Warum das wichtig ist

Die Produktionsküche eines Chocolatiers hat nicht immer eine gute Verbindung: Kühlräume mit dicken Wänden, Keller, Großküchen mit schwachem WLAN. Ein Werkzeug, das bei jedem Funkloch ausfällt, ist in der Praxis nicht zu gebrauchen.

So funktioniert es

Erstes Öffnen (mit Netz)

1. Die Prüfperson öffnet ihren eigenen Link. Die PWA wird heruntergeladen und im Browser zwischengespeichert.
2. Die Grunddaten der Verkostung (Proben, Protokoll, Merkmale) werden ebenfalls heruntergeladen.
3. Ab diesem Moment kann die Prüfperson auch dann weiterarbeiten, wenn die Verbindung abbricht. Wenn die Verkostung schon auf dem Handy gespeichert ist, zeigt die Begrüßung den Hinweis Du kannst jetzt offline verkosten.

Während der Bewertung (mit oder ohne Netz)

• Jede Probe wird gespeichert, wenn die Prüfperson auf Speichern und zur Auswahl tippt. Gibt es Netz, geht sie sofort an den Server.
• Gibt es kein Netz, bleibt die Probe auf dem Gerät gespeichert (IndexedDB) und wird automatisch gesendet, sobald die Verbindung zurück ist; solange noch etwas aussteht, versucht es die App alle 30 Sekunden erneut.
• Öffnet die Prüfperson den Prüfbogen ohne Verbindung und hat das Handy eine Kopie der Verkostung, sieht sie den Hinweis „Keine Verbindung: Du verkostest mit der auf diesem Handy gespeicherten Kopie. Deine Bewertungen werden automatisch gesendet, sobald du wieder Empfang hast.“

Nach dem Senden

• Die Prüfperson sendet die Prüfung mit Bestätigen und senden: Bei der deskriptiven Verkostung und bei Prüfungen, die Probe für Probe bewertet werden, steht diese Schaltfläche auf der Prüfansicht (die man über Prüfen und senden erreicht); bei Dreiecksprüfung, Paarvergleich, Duo-Trio-Prüfung und Rangordnung steht sie direkt im Prüfbogen, und das Senden wird anschließend mit Endgültig senden bestätigt. Gibt es in diesem Moment kein Netz, zeigt die Abschlussseite Noch nicht gesendet: Die Prüfung ist auf dem Handy gespeichert.
• Sobald das Gerät wieder Netz hat, wird die Prüfung auf den Server hochgeladen und erscheint in den Details der Verkostung der Panelleitung als abgeschlossen.

Statusanzeige

Unter dem Kopfbereich sieht die Prüfperson eine kleine Pille, die den Stand von Speichern und Synchronisierung anzeigt. Wenn alles aktuell ist und eine Verbindung besteht, wird die Pille ausgeblendet. Diese Zustände kann sie zeigen:

• Wird gespeichert …: Die Änderung wird auf dem Gerät gespeichert.
• Wird synchronisiert … / N ausstehende Einträge werden synchronisiert …: Die Änderungen werden an den Server gesendet.
• Offline: kein Netz und nichts, das noch gesendet werden muss.
• Offline · N lokal gespeichert: kein Netz, mit auf dem Gerät gespeicherten Änderungen, die auf das Hochladen warten.
• Synchronisierungsfehler: Beim Hochladen ist etwas schiefgegangen; versuch es noch einmal, wenn du stabiles Netz hast.

Einen Zustand mit der Bezeichnung „Gespeichert“ gibt es nicht: Wenn eine Verbindung besteht und nichts aussteht, verschwindet die Pille einfach.

Was passiert, wenn ich den Browser schließe?

• Die Daten sind lokal gespeichert. Wenn du den Link auf demselben Gerät im selben Browser wieder öffnest, bekommst du die laufende Prüfung zurück.
• Wenn du vor dem Synchronisieren das Gerät wechselst, bleiben die Daten auf dem ersten Gerät, bis du es dort wieder öffnest. Wenn du den Link ohne Verbindung auf einem Gerät öffnest, das keine Kopie hat, siehst du „Keine Verbindung, und auf diesem Handy gibt es keine Kopie dieser Verkostung …“. So vermeidest du Datenverlust: Schließ die Prüfung auf dem Gerät ab, auf dem du sie begonnen hast, und sorg am Ende für Netz, damit synchronisiert wird.

Ehrliche Grenzen

• Das erste Öffnen braucht eine Verbindung, um die PWA und die Daten der Verkostung herunterzuladen.
• Die Synchronisierung mit dem Server braucht eine Verbindung (Telepathie beherrscht die App nicht).
• Wenn du den Browser schließt, verlierst du Sitzung und Cookie, aber die Daten bleiben in IndexedDB erhalten, bis du denselben Link wieder öffnest.