Pełna praca offline — leki bez internetu

U pacjenta w domu, w szpitalu, w piwnicy po stronie nieosłoniętej nadajnikiem. Właśnie wtedy trzeba podać lek albo dopisać nowe opakowanie — i właśnie wtedy zasięg potrafi zniknąć.

W aplikacji mojApteczka apteczka działa w pełni offline. Od wersji 1.9.0 dodawanie, edycja i usuwanie leków zapisuje się natychmiast na urządzeniu i synchronizuje automatycznie po powrocie zasięgu — z licznikiem „N zmian czeka na synchronizację" na ekranie apteczki. Podawanie dawek działa offline już od wersji 1.7.0. Zmiany przetrwają tryb samolotowy, zamknięcie aplikacji i restart telefonu, a po odzyskaniu połączenia wszystko trafia do chmury bez Twojego udziału.

Dodawanie, edycja i usuwanie leków bez internetu

Pełna praca offline to nie tylko potwierdzanie dawek — to zarządzanie całą apteczką bez sieci:

• dodajesz lek (skanem opakowania lub ręcznie), a wpis pojawia się od razu na liście,
• edytujesz ilość, datę ważności czy notatkę — zmiana jest widoczna natychmiast,
• usuwasz lek, którego już nie masz — bez czekania na serwer.

Każda taka zmiana trafia do trwałej kolejki na dysku urządzenia. Na ekranie apteczki widzisz licznik oczekujących zmian („N zmian czeka na synchronizację"), więc zawsze wiesz, co jeszcze nie dotarło do chmury. Gdy wróci zasięg, kolejka wysyła zmiany partiami i licznik znika — bez konfliktów, nawet jeśli w międzyczasie korzystałeś z apteczki na innym urządzeniu.

Jak podać lek bez internetu

Proces jest identyczny jak przy podawaniu online — brak zasięgu nie blokuje żadnego kroku:

1. otwierasz kartę leku w apteczce,
2. klikasz ikonę podawania,
3. wybierasz dawkę (również ułamkową) i odbiorcę,
4. potwierdzasz — ekran odpowiada natychmiast, stan magazynowy aktualizuje się lokalnie,
5. gdy wróci zasięg (lub otworzysz aplikację online), kolejka sama wysyła oczekujące podania do chmury.

Nie musisz niczego klikać, wznawiać ani „pamiętać do później". Kolejka znika z listy oczekujących dopiero wtedy, gdy serwer potwierdzi odebranie operacji.

Co się dzieje z oczekującymi podaniami

Kluczowa różnica między mojApteczka 1.7.0 a typową aplikacją online-first: kolejka oczekujących operacji jest trwała. To nie jest zmienna w pamięci RAM, która znika przy zamknięciu procesu — to zapis na dysku urządzenia, szyfrowany w ramach sandboxa systemu operacyjnego.

W praktyce oznacza to, że:

• Zamknąłeś aplikację w trakcie wizyty u pacjenta? Kolejka leży na dysku, czeka na ponowne uruchomienie.
• Telefon się rozładował w samochodzie? Naładuj, uruchom mojApteczka — kolejka wznowi synchronizację, gdy będzie zasięg.
• Zmieniłeś lokalizację, nadajnik zniknął na 20 minut? W tle, cicho, bez Twojego udziału, kolejka wysyła operacje partiami.
• Pracujesz z apteczką współdzieloną? Twoje offline-podania pojawią się u pozostałych członków rodziny dopiero po Twojej synchronizacji — ale pojawią się bez konfliktów, nawet jeśli inna osoba w tym czasie też coś podawała.

Dlaczego local-first, a nie „wszystko na serwerze"

Klasyczny model online-first wysyła każdą operację do serwera i czeka na potwierdzenie — działa świetnie, dopóki Internet działa. Ale w opiece nad chorym Internet często nie działa: stary dom, piwnica, szpital z cegły, podróż między miastami. Czekanie na serwer w takiej chwili to dwa scenariusze:

• obrotowe kółko ładowania — opiekun nie wie, czy dawka została zarejestrowana,
• gubienie operacji — po upływie timeoutu aplikacja rezygnuje, a dawka znika z historii.

Żaden z nich nie jest akceptowalny przy lekach. Dlatego w mojApteczka potwierdzenie zapisuje się lokalnie w pierwszej kolejności — szybko, pewnie, niezależnie od sieci — a synchronizacja z chmurą jest procesem w tle, który kończy się, gdy może.

Odporność na zamknięcie aplikacji i rozładowanie telefonu

Komunikat z Facebooka mojApteczka z wydania 1.7.0 mówił: „żadnej zgubionej dawki — zamknąłeś aplikację? Rozładował się telefon? Oczekujące podania same wyślą się później". To nie jest obietnica marketingowa, tylko konsekwencja architektury:

• kolejka zapisywana na dysku natychmiast po potwierdzeniu (write-ahead),
• restart systemu operacyjnego / reboot urządzenia nie dotyka danych kolejki,
• po ponownym uruchomieniu aplikacji kolejka jest odczytywana i kontynuowana,
• jeśli masz zasięg w tle, kolejka wznawia synchronizację bez Twojej interwencji.

Innymi słowy: jedynym scenariuszem, w którym oczekująca operacja jest tracona, jest odinstalowanie aplikacji przed synchronizacją. Jeśli widzisz w historii operację ze statusem „w kolejce", wystarczy otworzyć aplikację online na krótką chwilę — i operacja trafi na serwer.

Prywatność — oczekujące operacje nie opuszczają urządzenia

Dopóki operacja leży w kolejce, nie opuszcza Twojego telefonu. To konsekwencja modelu local-first — dane o tym, co podałeś, komu i kiedy, są zapisane w sandboxie systemu operacyjnego, chronione biometrią ekranu blokady (Face ID / Touch ID). Dopiero synchronizacja przenosi operację do chmury mojApteczka w UE (Frankfurt, AWS).

Jeśli zgubisz telefon bez zasięgu, nawet ostatnie minuty podawania (jeszcze niezsynchronizowane) pozostaną zaszyfrowane w sandboxie iOS. Jest to ten sam standard ochrony, który stosujemy dla dokumentacji SPC offline i mapy aptek.

Dostępność

Pełna praca offline jest obecnie dostępna w aplikacji mojApteczka na iOS: podawanie dawek offline od wersji 1.7.0, a dodawanie, edycja i usuwanie leków offline od wersji 1.9.0. Wersja dla Androida jest w planie — ten sam model lokalnej kolejki zostanie tam zaimplementowany w kolejnych wydaniach. Wersja webowa z natury wymaga połączenia z serwerem; jeśli potrzebujesz działania offline, skorzystaj z aplikacji mobilnej.

Połączenie z innymi funkcjami

Podawanie offline jest jednym z trzech filarów „mojApteczka działa bez internetu":

• Podawanie leków — kompleksowy opis funkcji podawania, włącznie z dawkami ułamkowymi, odbiorcą i historią,
• Dokumentacja SPC offline — ChPL dla 8 000+ leków, dostępna bez internetu po pierwszej synchronizacji,
• Mapa aptek offline — lokalizator aptek działający po pierwszym pobraniu bundle'a,
• Raport PDF dla lekarza — uwzględnia zarówno operacje zsynchronizowane, jak i oczekujące, po synchronizacji,
• Przypomnienia o dawkowaniu — działają lokalnie, niezależnie od zasięgu.

Ważne ograniczenie

Kolejka oczekujących podań nie chroni przed odinstalowaniem aplikacji. Jeśli masz niezsynchronizowane operacje i musisz zmienić telefon lub przeinstalować mojApteczka, otwórz aplikację z aktywnym zasięgiem przed odinstalowaniem — wystarczy krótki moment online, by kolejka się wypłukała. Po reinstalacji zaloguj się ponownie i historia podawań (już w chmurze) będzie dostępna na nowym urządzeniu.

Uwaga: funkcja podawania leków jest narzędziem do rejestrowania dawek. Nie zastępuje zaleceń lekarza ani farmaceuty w kwestii dawkowania, częstotliwości czy sposobu podawania — także offline.

Pełna praca offline w mojApteczka zamienia moment „bez zasięgu" z potencjalnej pułapki w coś, o czym się nie myśli. Dodajesz, edytujesz i usuwasz leki, potwierdzasz dawki — ekran reaguje natychmiast, kolejka sama się synchronizuje, żadna zmiana się nie gubi, niezależnie od tego, czy jesteś w domu, w szpitalu, czy w podróży.