Automatyzacja · panel WWW i Android

Dyżur

Grafik dyżurów, który sam przestawia przekierowanie telefonu.

Rok

2026

Platforma

Panel WWW · Android

Moja rola

Projekt, panel, aplikacja na telefon i wdrożenie, wszystko solo.

Dyżur

W skrócie

  • Panel: Next.js
  • Telefon: Android
  • Synchronizacja: co 30 s

Wyzwanie

Przekierowanie połączeń to kod wybierany na telefonie, a nie funkcja, którą da się wywołać z serwera. Telefon musiał więc sam pilnować grafiku przez całą dobę, także wtedy, gdy nikt go nie dotyka, a system oszczędzania baterii robi wszystko, żeby aplikację uśpić. Do tego dyżury nocne, które zaczynają się jednego dnia, a kończą następnego, i pytanie, skąd wiadomo, że przekierowanie jest takie, jakie ma być, skoro samo wybranie kodu niczego nie dowodzi.

Rozwiązanie

Serwer z panelem jest jedynym źródłem grafiku. Aplikacja na Androida działa jako usługa pierwszoplanowa: co 30 sekund pobiera grafik, a gdy zmienia się osoba, wybiera kod przekierowania u operatora. Potem czyta z sieci wskaźnik przekierowania (włączone albo wyłączone) i, gdy nie zgadza się z planem, ponawia kod do trzech razy, zanim zgłosi błąd. Dopiero zgodny stan trafia do panelu jako potwierdzony. W panelu widać, kto odbiera, kiedy telefon ostatnio się odezwał i co ustawił, a także jego baterię, zasięg i internet. Ręczna zmiana obowiązuje do końca bieżącego dyżuru. Na zapisanym grafiku aplikacja działa także bez internetu.

Proces

  1. Grafik w panelu: dyżury w siatce tygodnia, także nocne przez północ, z ostrzeżeniem o godzinach bez dyżuru (wtedy połączenia trafiają na sam telefon dyżurny).
  2. Aplikacja na telefonie dyżurnym jako usługa pierwszoplanowa, odporna na usypianie przez system oszczędzania baterii i uruchamiana po restarcie telefonu.
  3. Przekierowanie kodem u operatora, a potem odczyt z sieci, czy wskaźnik zgadza się z planem, do trzech prób. Zmiana wchodzi w ciągu 30 sekund, bo aplikacja odpytuje serwer.
  4. Raport do panelu: kto odbiera, kiedy telefon ostatnio się odezwał i skąd przyszła zmiana (grafik, ręcznie, panel). Zdarzenia zapisują się z autorem i są przechowywane 90 dni.
  5. Alerty: alarm w panelu, gdy telefon milczy dłużej niż 2 minuty, a e-mail po 10 minutach i przy niskiej baterii (poniżej 30%, potem poniżej 15%).
  6. Wdrożenie w Dockerze: testy backendu uruchamiają się przy budowie obrazu, więc czerwone testy blokują wydanie, a baza ma codzienne kopie.

Jak to wygląda

Pierwsze dwa obrazy to zrzuty z wersji demonstracyjnej, pozostałe to makiety z przykładowymi danymi (wymyślone imiona i numery).

Co potrafi

  • Grafik tygodnia. Dyżury dzienne i nocne w jednej siatce, maksymalnie 72 godziny, bez nakładania się. Puste godziny widać od razu, zanim ktoś zadzwoni w próżnię.
  • Potwierdzenie z sieci. Samo wybranie kodu to za mało. Telefon czyta z sieci, czy przekierowanie jest włączone lub wyłączone zgodnie z planem, a przy rozbieżności ponawia kod do trzech razy. Numeru docelowego sieć nie zdradza, więc go nie sprawdza.
  • Zmiana z panelu. Ktoś choruje? Jedno kliknięcie w panelu i telefon przestawia się w ciągu pół minuty, do końca bieżącego dyżuru. Jest też „Wróć do grafiku” i „Ustaw ponownie”.
  • Alarm, gdy telefon milczy. Panel pokazuje, kiedy telefon ostatnio się odezwał, ostrzega po ponad 2 minutach ciszy, a po 10 minutach wysyła e-mail (i drugi, gdy telefon wróci).
  • Bateria i zasięg. Panel widzi, ile baterii ma telefon dyżurny i czy stoi na ładowarce, jaki ma zasięg, sieć i operatora oraz skąd bierze internet. E-mail przychodzi poniżej 30% baterii, pilny poniżej 15%. Bez zasięgu panel mówi wprost, że przekierowania nie da się teraz zmienić.
  • Samonaprawa. Gdy sieć pokazuje inny stan niż plan, aplikacja po minucie sama ponawia kod.
  • Praca bez internetu. Telefon trzyma zapisany grafik i przestawia przekierowanie także wtedy, gdy chwilowo nie ma sieci danych.
  • Konta i dziennik zdarzeń. Logowanie z limitem prób, wylogowanie ze wszystkich urządzeń, a każda zmiana zapisana w dzienniku z autorem i filtrami.
  • Statystyki i eksport. Godziny dyżurów w miesiącu na osobę (dyżury przechodzące przez granicę miesiąca liczone proporcjonalnie) i eksport do CSV, bez przepisywania z kartki.
  • Kopie zapasowe. Codzienna kopia bazy (zostaje ostatnich 14) i kopia do pobrania jednym kliknięciem z ustawień panelu.

Dane techniczne

  • Panel: Next.js 16, React 19, Prisma, SQLite
  • Aplikacja: Android 8+ (Kotlin, Jetpack Compose), usługa pierwszoplanowa
  • Synchronizacja: co 30 s, częściej tuż przed zmianą dyżuru
  • Powiadomienia: alarm w panelu i e-mail (SMTP)
  • Testy: 51 w backendzie i 13 w aplikacji, uruchamiane przy budowie obrazu backendu
  • Wdrożenie: Docker, GitHub Actions
  • Ograniczenia: jeden telefon dyżurny z jedną kartą SIM; lista osób na stałe w kodzie; brak iOS

Prywatność

Numery osób dyżurnych są tylko na serwerze i w telefonie dyżurnym. Zrzuty i telefon na tej stronie pochodzą z wersji demonstracyjnej i makiet: imiona i numery są wymyślone. Telefon dyżurny wysyła do panelu stan techniczny (bateria, zasięg, sieć, wersja aplikacji) i potwierdzenie przekierowania, a hasła są przechowywane jako skróty.

Następna realizacja

Aplikacja mobilna · Wellness

Zaczynamy?

Zacznijmy od rozmowy

Opisz, co chcesz zbudować. W odpowiedzi dostaniesz zakres, cenę i termin. Zapytanie nic nie kosztuje i do niczego nie zobowiązuje.