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
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