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
- Przed powrotem sieci
- Po powrocie sieci
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