InnerWeb
Przejdź do treści

Checklista pracy offline aplikacji terenowej

Kierownik wdrożenia nie musi czytać kodu, żeby sprawdzić, czy aplikacja terenowa radzi sobie bez sieci. Wystarczy kilka prób na urządzeniu w hali: wyłączyć sieć, zapisać dane, przywrócić sieć i policzyć rekordy. Poniższa lista prowadzi przez te próby i podaje, jaki wynik uznać za poprawny.

13 dni
domyślny czas czyszczenia rekordów idempotencji
Źródło: karta
4 stany
kolejki widoczne dla użytkownika
Źródło: karta

Zasada działania, którą sprawdzasz

Aplikacja webowa zapisuje nieudane zapytania modyfikujące dane, czyli POST, PUT i PATCH, w kolejce IndexedDB przeglądarki, gdy nie ma sieci, i odtwarza je po jej powrocie. Każde z nich dostaje klucz idempotencji w nagłówku, więc ponowna wysyłka nie tworzy duplikatu po stronie serwera.

Kolejka obsługuje także pliki i formularze, a jej stan jest widoczny dla użytkownika: oczekuje, synchronizuje, błąd albo wymagane logowanie. Odbiór polega na sprawdzeniu każdego z tych zachowań na prawdziwym urządzeniu, w prawdziwym miejscu pracy.

Przygotowanie do prób

Użyj konta testowego, nie konta pracownika, i urządzenia, na którym aplikacja będzie używana. Przygotuj listę trzech prostych zapisów: formularz bez załącznika, formularz ze zdjęciem i zapis, który kończy się błędem walidacji. Zapisz liczbę rekordów w systemie przed próbą, bo to ona będzie punktem odniesienia.

Zaplanuj miejsce, w którym naprawdę nie ma zasięgu, np. hala lub piwnica, a obok miejsce z siecią, żeby przejść między nimi w czasie próby.

Przykładowa próba: rekordy w systemie przed i po powrocie sieci

Przykładowa próba: rekordy w systemie przed i po powrocie sieciWykres przed i po: trzy zapisy czekają w kolejce, po powrocie sieci wszystkie trzy są w systemie i kolejka jest pusta0123rekordówPrzed powrotem sieci (W kolejce): 3 rekordów3Po powrocie sieci (W kolejce): 0 rekordów0W kolejcePrzed powrotem sieci (W systemie): 0 rekordów0Po powrocie sieci (W systemie): 3 rekordów3W systemie
  • Przed powrotem sieci
  • Po powrocie sieci
Źródło: Przykład próby z trzema zapisami opisanej na tej stronie

Próby i kryteria wyniku

Każdy punkt listy ma swój wynik oczekiwany. Brak zgodności zapisz jako błąd odbioru i przekaż dostawcy. Pamiętaj, że po błędzie 4xx lub 5xx klucz idempotencji zostaje zwolniony, a serwer zapamiętuje tylko wyniki zakończone sukcesem 2xx, więc poprawiony zapis może być wysłany ponownie.

Opóźnienia ponowień rosną według ciągu Fibonacciego, więc po dłuższej awarii synchronizacja nie następuje natychmiast po powrocie sieci. Daj aplikacji czas i obserwuj stan kolejki zamiast klikać ponownie.

Dwa błędy, które warto wywołać celowo

Pierwszy to zapis z błędem walidacji: kolejka powinna pokazać stan błędu, a nie ukrywać go. Drugi to wygasła sesja: zapytanie ma wejść w stan wymaganego logowania i po zalogowaniu zostać wysłane, bez utraty danych.

Co zapisać do dokumentacji odbioru

Dokumentacja odbioru to krótki protokół: data, urządzenie, miejsce próby, lista kroków, liczba rekordów przed i po oraz zrzuty ekranu stanów kolejki. Wspiera on dowód do audytu, że aplikacja zachowuje dane przy utracie sieci.

Zapisz też ograniczenia: bez sieci przeglądarka nie pobierze nowych danych z serwera, a rekordy idempotencji są czyszczone po domyślnie 13 dniach, więc zapisy zalegające dłużej niż ten okres wymagają osobnej procedury.

Lista kontrolna

Materiał wideo

Często zadawane pytania

Ile prób wystarczy do odbioru?

Trzy rodzaje zapisów (zwykły, ze zdjęciem, z błędem) oraz próba wygasłej sesji. Każdą wykonaj na urządzeniu docelowym w miejscu bez zasięgu.

Co znaczy poprawny wynik próby?

Dokładnie jeden rekord na każdy zapis po powrocie sieci, bez duplikatów, z widocznym stanem kolejki na każdym etapie.

Kto powinien wykonać próby?

Kierownik wdrożenia z użytkownikiem z hali, na koncie testowym, żeby nie tworzyć fałszywych zapisów na koncie pracownika.

Odbiór pracy offline na Waszym terenie

Przeprowadzimy próby z kierownikiem wdrożenia w miejscu bez zasięgu i przygotujemy protokół odbioru. Umów rozmowę.

Porozmawiajmy