InnerWeb
Przejdź do treści

FAQ: praca aplikacji bez zasięgu i kolejka offline

Hala, piwnica, lakiernia i plac składowy mają wspólną cechę: zasięg znika dokładnie wtedy, gdy ktoś musi zapisać wynik obchodu albo zgłoszenie. Odpowiadamy, co aplikacja robi z zapisem, gdy sieci nie ma, i kiedy dane naprawdę trafią do systemu.

13 dni
domyślny czas przechowywania rekordów idempotencji
Źródło: karta
4 stany
widoczne dla użytkownika: oczekuje, synchronizuje, błąd, logowanie
Źródło: karta

Co się dzieje z zapisem, gdy nie ma sieci

Aplikacja webowa zapisuje nieudane zapytania modyfikujące dane, czyli POST, PUT i PATCH, w kolejce IndexedDB przeglądarki. Użytkownik nie traci wpisanego formularza, a zapytanie czeka w pamięci urządzenia, aż sieć wróci.

Po powrocie sieci kolejka odtwarza zapytania po kolei. Z punktu widzenia użytkownika zapis został wykonany w chwili kliknięcia, a z punktu widzenia systemu pojawi się on dopiero w momencie synchronizacji. Ta różnica ma znaczenie dla raportów czasu rzeczywistego, więc warto ją opisać w instrukcji dla kierowników zmian.

Czy kolejka obsługuje zdjęcia i załączniki

Tak. Kolejka offline obsługuje także pliki i formularze, więc zgłoszenie ze zdjęciem usterki robionym w hali nie wymaga ponownego dodawania załącznika po wyjściu na zewnątrz.

Duplikaty: czy zapis może powstać dwa razy

To najczęstsza obawa. Gdy sieć gaśnie w trakcie wysyłania, aplikacja nie wie, czy serwer odebrał zapytanie. Ponowna wysyłka mogłaby utworzyć drugi rekord. Dlatego każde zapytanie modyfikujące dostaje klucz idempotencji w nagłówku, a serwer rozpoznaje powtórkę i nie tworzy duplikatu.

Serwer zapamiętuje tylko wyniki zakończone sukcesem 2xx. Po błędzie 4xx lub 5xx klucz zostaje zwolniony, więc poprawiona wersja zapytania może być wysłana ponownie. Rekordy idempotencji są czyszczone po domyślnie 13 dniach, co ogranicza ich wzrost i jednocześnie pokrywa długi okres pracy bez sieci.

  • Klucz idempotencji w nagłówku każdego zapytania modyfikującego.
  • Zapamiętywanie wyniku tylko przy sukcesie 2xx.
  • Zwolnienie klucza po błędzie 4xx lub 5xx.
  • Czyszczenie rekordów idempotencji po domyślnie 13 dniach.

Kolejność opóźnień ponowień wg ciągu Fibonacciego

Kolejność opóźnień ponowień wg ciągu FibonacciegoWykres słupków poziomych: opóźnienia ponowień rosną od 1 do 13 sekund według ciągu Fibonacciego051015sPróba 1Próba 1: 1 s1Próba 2Próba 2: 2 s2Próba 3Próba 3: 3 s3Próba 4Próba 4: 5 s5Próba 5Próba 5: 8 s8Próba 6Próba 6: 13 s13
Źródło: Ilustracja kolejnych wyrazów ciągu Fibonacciego; skala sekund dla przykładu

Co widzi użytkownik i jak działają ponowienia

Stan kolejki jest widoczny dla użytkownika: oczekuje, synchronizuje, błąd albo wymagane logowanie. Dzięki temu pracownik wie, czy jego wpis dotarł, i nie powtarza go z obawy, że zniknął.

Opóźnienia kolejnych ponowień rosną według ciągu Fibonacciego. Na początku aplikacja próbuje często, żeby szybko wysłać dane po krótkiej przerwie, a przy dłuższej awarii zwalnia i nie obciąża sieci ani serwera.

Wymagane logowanie po długiej przerwie

Jeżeli sesja wygasła, zapytanie nie jest tracone: wchodzi w stan wymaganego logowania i czeka na ponowne zalogowanie. Po zalogowaniu kolejka wysyła zaległe zapisy.

Praca bez zasięgu a urządzenia radiowe

Kolejka offline dotyczy aplikacji w przeglądarce. Zegarek z radiem LoRa działa inaczej: nie wymaga Wi-Fi, bo jego ramki przechodzą przez bramkę, a bramka tłumaczy je na zapytania HTTP do systemu. Gdy zegarek nie słyszy żadnego beacona, ramka i tak jest wysyłana, a system podstawia ostatnią znaną lokalizację.

W praktyce zakład ma więc dwie warstwy: aplikację z kolejką dla formularzy i obchodów oraz radio dla SOS i bezruchu. Obie ukrywają przed użytkownikiem lukę w zasięgu, każda w swoim zakresie.

Czego kolejka nie robi

Kolejka nie zastępuje odczytu danych: bez sieci przeglądarka nie pobierze nowych list ani zdjęć z serwera, jeśli nie zostały wcześniej załadowane. Nie rozwiązuje też konfliktów biznesowych, np. dwóch osób edytujących ten sam rekord, więc proces powinien tego unikać organizacyjnie.

Kolejka nie powinna być jedynym dowodem wykonania pracy w procesie wysokiego ryzyka. Dla zezwoleń i potwierdzeń krytycznych przyjmuje się zasadę, że dopiero status po synchronizacji jest dowodem do audytu, a wpis w kolejce jest tylko zabezpieczeniem przed utratą danych.

Materiał wideo

Często zadawane pytania

Czy wpis zrobiony bez sieci na pewno nie zniknie?

Zapytanie trafia do kolejki w IndexedDB przeglądarki i czeka na powrót sieci. Warunek: użytkownik nie czyści danych przeglądarki i nie wylogowuje się na koniec zmiany bez synchronizacji.

Co jeśli serwer odpowie błędem?

Po błędzie 4xx lub 5xx klucz idempotencji zostaje zwolniony, a zapytanie pojawia się w kolejce jako błąd. Można je poprawić i wysłać ponownie.

Kiedy dane trafią do systemu?

Po powrocie sieci, w kolejnych ponowieniach z rosnącym opóźnieniem. Do tego czasu rekord jest widoczny tylko w urządzeniu autora.

Zapisy bez luk w zasięgu

Pokażemy na demonstracji, jak kolejka offline zachowuje się przy utracie sieci i po jej powrocie. Umówmy krótki pokaz.

Porozmawiajmy