Aplikacja i powiadomienia

Instalacja aplikacji#

1. 01
   Otwórz publiczny adres ZoraForms przez HTTPS w aktualnej przeglądarce telefonu. Adres localhost na komputerze nie jest adresem telefonu.
2. 02
   W panelu otwórz Ustawienia → Aplikacja i powiadomienia. Android/Chrome: Zainstaluj aplikację lub menu → Dodaj do ekranu głównego. iPhone/Safari: Udostępnij → Dodaj do ekranu głównego.
3. 03
   Uruchom ZoraForms z ikony i zaloguj się. iPhone/iPad wymaga iOS16.4 lub nowszego; sama otwarta karta Safari nie wystarcza do push.

Włączenie i cofnięcie#

1. 01
   Nadaj nazwę urządzeniu, wybierz Włącz powiadomienia i zaakceptuj zgodę systemową. Instalacja aplikacji sama nie włącza powiadomień.
2. 02
   Użyj Wyślij test. Kolejka potwierdza zlecenie wysyłki, nie dotarcie do telefonu. Focus, bateria i ustawienia systemowe mogą ją opóźnić lub wyciszyć.
3. 03
   Włącz osobno inne urządzenia (do10 na konto). Możesz je odłączyć w panelu. Wylogowanie, wygaśnięcie sesji lub zmiana2FA wymagają ponownego świadomego włączenia po logowaniu.

Powiadomienie zawiera ogólny komunikat o nowym zaakceptowanym zgłoszeniu i link do panelu, bez e-maila, nazwiska, pól, UTM ani nazw formularzy na ekranie blokady. Otwarcie szczegółów wymaga autoryzacji. Wcześniej przekazana wiadomość może dotrzeć po wyłączeniu; nowe nie są wysyłane.

Aplikacja nie zapisuje prywatnej skrzynki offline. Bez internetu pokaże bezpieczny ekran braku połączenia. Nie obiecuje dostawy lub odczytu każdego powiadomienia.

Wymagania operatora#

Na serwerze uruchom migracje i pnpm push:setup, które zapisuje jednorazowo klucze VAPID w .env bez ujawniania klucza prywatnego. Zrestartuj API i worker. Ustaw publiczny APP_URL HTTPS oraz kontakt PUSH_VAPID_SUBJECT. Nie regeneruj kluczy przy każdym wdrożeniu; zmiana wymaga ponownego włączenia urządzeń.

Serwer potrzebuje wychodzącego HTTPS do dostawców Web Push. Subskrypcje są szyfrowane i przypisane sesji; PostgreSQL utrwala zdarzenia i próby. Redis służy tylko do transportu oraz rate limitingu. Dostawca zależy od przeglądarki (Google/Apple/Mozilla/Microsoft) i może działać poza EOG — sprawdź umowy, role i transfery przed udostępnieniem.