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
- 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).
- Aplikacja na telefonie dyżurnym jako usługa pierwszoplanowa, odporna na usypianie przez system oszczędzania baterii i uruchamiana po restarcie telefonu.
- 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.
- 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.
- 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%).
- 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.
