119 lines
3.1 KiB
Markdown
119 lines
3.1 KiB
Markdown
# Powiadomienia Web Push
|
|
|
|
Powiadomienia obejmują:
|
|
|
|
- nowe ostrzeżenia meteorologiczne IMGW,
|
|
- poranny brief dnia,
|
|
- wieczorny brief z prognozą na jutro,
|
|
- testowe powiadomienie wysyłane z `/settings`.
|
|
|
|
Konfiguracja użytkownika znajduje się w widoku `/settings`.
|
|
|
|
## Wymagania
|
|
|
|
Do wysyłki Web Push potrzebne są klucze VAPID:
|
|
|
|
```bash
|
|
WEB_PUSH_VAPID_PUBLIC_KEY=
|
|
WEB_PUSH_VAPID_PRIVATE_KEY=
|
|
WEB_PUSH_VAPID_SUBJECT=mailto:admin@example.com
|
|
```
|
|
|
|
Klucze można wygenerować poleceniem:
|
|
|
|
```bash
|
|
npx web-push generate-vapid-keys
|
|
```
|
|
|
|
Endpointy harmonogramu wymagają też sekretu crona w produkcji:
|
|
|
|
```bash
|
|
NOTIFICATIONS_CRON_SECRET=
|
|
```
|
|
|
|
## Preferencje Subskrypcji
|
|
|
|
Subskrypcja Web Push zapisuje:
|
|
|
|
- endpoint subskrypcji przeglądarki,
|
|
- województwo,
|
|
- język interfejsu,
|
|
- czy ostrzeżenia są aktywne,
|
|
- czy aktywny jest brief poranny,
|
|
- czy aktywny jest brief na jutro,
|
|
- współrzędne i nazwę lokalizacji,
|
|
- opcjonalny powiat TERYT,
|
|
- wybraną jednostkę wiatru dla briefów wysyłanych z serwera.
|
|
|
|
Ostrzeżenia meteo są filtrowane po powiecie TERYT, jeśli lokalizacja go dostarcza. W przeciwnym razie używany jest fallback wojewódzki.
|
|
|
|
## Worker Self-Hosted
|
|
|
|
Worker powiadomień uruchamia się osobno od aplikacji:
|
|
|
|
```bash
|
|
npm run notifications:worker
|
|
```
|
|
|
|
Wymaga równolegle działającej aplikacji Next.js. Domyślnie odpytuje:
|
|
|
|
```bash
|
|
http://127.0.0.1:3000
|
|
```
|
|
|
|
Jeśli aplikacja działa pod innym adresem albo portem, ustaw:
|
|
|
|
```bash
|
|
WTR_APP_URL=http://127.0.0.1:4000
|
|
```
|
|
|
|
Worker wczytuje `.env` i `.env.local`. Zmienne ustawione bezpośrednio w shellu mają pierwszeństwo.
|
|
|
|
## Harmonogram
|
|
|
|
Domyślna konfiguracja:
|
|
|
|
```bash
|
|
NOTIFICATIONS_WARNING_INTERVAL_MINUTES=5
|
|
NOTIFICATIONS_MORNING_BRIEF_TIME=07:00
|
|
NOTIFICATIONS_TOMORROW_BRIEF_TIME=18:00
|
|
```
|
|
|
|
Worker:
|
|
|
|
- sprawdza nowe ostrzeżenia co 5 minut,
|
|
- po 07:00 czasu `Europe/Warsaw` wywołuje `/api/notifications/daily-brief`,
|
|
- po 18:00 czasu `Europe/Warsaw` wywołuje `/api/notifications/tomorrow-brief`,
|
|
- nie blokuje jednego harmonogramu błędem drugiego.
|
|
|
|
Endpointy harmonogramu nie uruchamiają się same bez workera albo zewnętrznego crona.
|
|
|
|
## Zewnętrzny Cron
|
|
|
|
Jeśli nie używasz `npm run notifications:worker`, zewnętrzny cron powinien wywoływać:
|
|
|
|
```text
|
|
GET /api/notifications/check
|
|
GET /api/notifications/daily-brief
|
|
GET /api/notifications/tomorrow-brief
|
|
```
|
|
|
|
W produkcji dodaj jeden z nagłówków:
|
|
|
|
```http
|
|
Authorization: Bearer <NOTIFICATIONS_CRON_SECRET>
|
|
x-cron-secret: <NOTIFICATIONS_CRON_SECRET>
|
|
```
|
|
|
|
## Platformy
|
|
|
|
- iOS/iPadOS wymaga dodania PWA do ekranu początkowego i uruchomienia aplikacji z ikony.
|
|
- Android i desktop nie są blokowane wymogiem `standalone`, jeśli przeglądarka obsługuje Web Push.
|
|
- GPS i powiadomienia wymagają bezpiecznego kontekstu HTTPS poza wyjątkami typu `localhost`.
|
|
|
|
## Ograniczenia
|
|
|
|
Obecny `lib/push-store.ts` przechowuje subskrypcje i historię wysyłek w pamięci procesu. Po restarcie procesu te dane znikają. Produkcja wymaga trwałego magazynu, np. bazy danych albo KV.
|
|
|
|
Powiadomienie testowe jest wysyłane na konkretny endpoint subskrypcji przekazany z `/settings`, a nie broadcastowane do wszystkich urządzeń.
|