Zum Inhalt

Progressive Web App & Offline-Modus

Bifolk funktioniert als Progressive Web App (PWA), was bedeutet, dass Sie es wie eine native App auf Ihrem Gerät installieren und wichtige Funktionen auch ohne Internetverbindung nutzen können.

Zielgruppe: Imker, die im Feld arbeiten

Was ist eine PWA?

Eine Progressive Web App läuft in Ihrem Browser, kann aber wie eine reguläre App auf Ihrem Gerät installiert werden. Vorteile sind:

  • Auf Ihrem Gerät installieren: Bifolk zu Ihrem Startbildschirm oder Desktop hinzufügen
  • Offline-Zugriff: Gecachte Seiten anzeigen und Formulare ohne Internet absenden
  • Automatische Synchronisierung: Offline-Übermittlungen werden gesendet, wenn Sie wieder online sind
  • Schnelles Laden: Gecachte Ressourcen laden sofort

Note

PWA muss von Ihrem Administrator aktiviert werden (siehe Konfiguration). In der Produktion ist HTTPS erforderlich, damit der Service Worker registriert werden kann. Auf localhost ist HTTPS nicht erforderlich.

Bifolk installieren

Auf Android (Chrome)

  1. Öffnen Sie Bifolk in Chrome
  2. Tippen Sie auf das Menü (drei Punkte) oben rechts
  3. Tippen Sie auf App installieren oder Zum Startbildschirm hinzufügen
  4. Bestätigen Sie die Installation
  5. Bifolk erscheint auf Ihrem Startbildschirm als App

Auf iOS (Safari)

  1. Öffnen Sie Bifolk in Safari
  2. Tippen Sie auf die Teilen-Schaltfläche (Quadrat mit Pfeil)
  3. Scrollen Sie nach unten und tippen Sie auf Zum Home-Bildschirm
  4. Tippen Sie auf Hinzufügen
  5. Bifolk erscheint auf Ihrem Startbildschirm

Auf Desktop (Chrome/Edge)

  1. Öffnen Sie Bifolk in Ihrem Browser
  2. Suchen Sie das Installationssymbol in der Adressleiste (oder im Browsermenü)
  3. Klicken Sie auf Installieren
  4. Bifolk öffnet sich in einem eigenen Fenster

Offline-Zugriff

Was offline funktioniert

Wenn Sie die Internetverbindung verlieren, bietet Bifolk:

  • Dashboard: Gecachte Version der Dashboard-Seite
  • Zuvor besuchte Seiten: Jede Seite, die Sie online besucht haben, ist aus dem Cache verfügbar
  • Statische Ressourcen: CSS, JavaScript und Bilder sind gecacht
  • Schnellnotizen und Formularübermittlungen: Sie können Vorgänge offline mit der Schnellerstellungs-Funktion erfassen

Was Internet erfordert

  • Erstmaliges Laden von Seiten (sie müssen zuerst gecacht werden)
  • Anzeigen von Daten, die nicht gecacht wurden
  • Suchfunktionalität
  • Echtzeit-Datenaktualisierungen

Offline-Formularübermittlungen

Wenn Sie im Feld ohne Internet sind, können Sie die Schnellerstellungs-Schaltfläche verwenden, um eine Durchsicht zu erfassen. Durchsichten sind der einzige Vorgangstyp, der offline unterstützt wird, da andere Typen zu viele Pflichtfelder erfordern, um sie zuverlässig ohne Verbindung auszufüllen.

Wenn Sie eine Durchsicht offline absenden:

  1. Die Formulardaten werden lokal in Ihrem Browser gespeichert (IndexedDB)
  2. Eine Bestätigungsnachricht erscheint, die anzeigt, dass die Übermittlung in der Warteschlange ist
  3. Wenn die Internetverbindung wiederhergestellt ist, werden die Daten automatisch an den Server gesendet
  4. Wenn ein Sicherheitstoken abgelaufen ist, wird es automatisch erneuert, bevor ein erneuter Versuch gestartet wird
  5. Fehlgeschlagene Übermittlungen werden bis zu 3 Mal mit zunehmenden Verzögerungen erneut versucht

Note

Fütterung, Behandlung, Wartung und Ernte sind offline nicht verfügbar. Sie erscheinen im Schnellerstellungsmenü wieder, sobald die Verbindung wiederhergestellt ist.

Tip

Besuchen Sie die App, während Sie online sind, bevor Sie zum Bienenstand gehen, damit die Bienenstockdaten gecacht werden. Dies ermöglicht dem Offline-Schnellnotiz-Formular, Ihre Bienenstöcke im Dropdown anzuzeigen.

Ausstehende Vorgänge

Während Sie offline sind, zeigt ein Abzeichen in der Seitenleiste an, wie viele Vorgänge auf Synchronisierung warten. Wenn Sie wieder online kommen, werden sie automatisch verarbeitet. Sie sehen außerdem eine Benachrichtigung, die bestätigt, wie viele Vorgänge erfolgreich synchronisiert wurden.

Caching-Strategie

Bifolk verwendet verschiedene Caching-Strategien je nach Inhaltstyp:

Inhalt Strategie Verhalten
HTML-Seiten Network-First Versuche Netzwerk, falle auf gecachte Version zurück
Statische Ressourcen (CSS, JS, Bilder) Cache-First Aus Cache bereitstellen, im Hintergrund aktualisieren
Admin-Seiten, Authentifizierung Network-Only Aus Sicherheitsgründen nie gecacht

Cache-Aktualisierungen

  • Der Service Worker aktualisiert sich automatisch, wenn eine neue Version bereitgestellt wird
  • Wenn Sie Organisationen wechseln, werden HTML-Caches geleert, um korrekte Daten anzuzeigen
  • Wenn Sie Sprachen wechseln, werden HTML-Caches geleert, um die korrekte Sprache anzuzeigen

Organisations- & Sprachwechsel

Die PWA behandelt Organisations- und Sprachwechsel korrekt:

  • Organisationswechsel: Löscht gecachte HTML-Seiten, damit die Daten der neuen Organisation angezeigt werden
  • Sprachwechsel: Löscht gecachte HTML-Seiten, damit die korrekte Sprache angezeigt wird
  • Statische Ressourcen (CSS, JS) sind von diesen Wechseln nicht betroffen

Fehlerbehebung

App wird nicht installiert

  • Stellen Sie sicher, dass Sie HTTPS verwenden (in Produktion erforderlich, auf localhost nicht benötigt)
  • Überprüfen Sie, ob PWA in der Serverkonfiguration aktiviert ist (PWA_ENABLED=True)
  • Versuchen Sie, Ihren Browser-Cache zu leeren und neu zu laden

Offline-Modus funktioniert nicht

  • Besuchen Sie die Seiten, die Sie offline nutzen möchten, mindestens einmal, während Sie verbunden sind (Seiten müssen zuerst gecacht werden)
  • Überprüfen Sie, ob der Service Worker registriert ist (Browser-Entwicklertools > Anwendung > Service Workers)
  • Versuchen Sie, den Service Worker zu deregistrieren und neu zu laden

Ausstehende Vorgänge werden nicht synchronisiert

  • Überprüfen Sie, ob Ihre Internetverbindung wiederhergestellt ist
  • Überprüfen Sie die Browserkonsole auf Fehlermeldungen
  • Vorgänge werden bis zu 3 Mal mit zunehmenden Verzögerungen erneut versucht
  • Wenn Vorgänge nach allen Versuchen fehlschlagen, bleiben sie zur manuellen Überprüfung in der Warteschlange

Wie geht es weiter