# Pengingat attendance melalui Web Push

Pengingat dikirim menggunakan protokol Web Push/VAPID melalui `minishlink/web-push`. Tidak perlu membuat proyek Firebase atau akun penyedia push. Browser memakai layanan push vendor masing-masing.

## Aktivasi server

1. Pasang dependency dan migrasi baru:

    ```sh
    composer install --no-dev --optimize-autoloader
    php artisan migrate --force
    ```

2. Jalankan `php artisan webpush:generate-keys` sekali pada lingkungan yang akan diaktifkan. Simpan hasilnya di `.env` atau secret manager:

    ```dotenv
    WEBPUSH_VAPID_SUBJECT=mailto:admin@perusahaan.example
    WEBPUSH_VAPID_PUBLIC_KEY=...
    WEBPUSH_VAPID_PRIVATE_KEY=...
    ```

    Ganti alamat kontak dengan alamat administrator yang valid. Private key harus dirahasiakan. Gunakan pasangan key yang sama pada semua instance untuk satu lingkungan. Jangan mengganti key setiap deployment; pergantian key memerlukan perangkat berlangganan ulang.

3. Build frontend dan perbarui konfigurasi:

    ```sh
    npm ci
    npm run build
    php artisan config:cache
    ```

4. Aktifkan satu scheduler melalui cron setiap menit. Ganti path dan binary PHP sesuai server:

    ```cron
    * * * * * cd /path/to/hris && php artisan schedule:run >> /path/to/hris/storage/logs/scheduler.log 2>&1
    ```

    Pengiriman berjalan langsung di command, sehingga tidak membutuhkan queue worker. Jalankan `php artisan attendance:send-reminders` untuk pemeriksaan manual. Tanpa konfigurasi VAPID, command berhenti tanpa mengirim. Jangan menjalankan pemeriksaan manual di jam pengingat bila belum bermaksud mengirim notifikasi nyata.

5. Situs harus diakses melalui HTTPS. `localhost` dapat digunakan untuk pengembangan. Pastikan `/sw.js`, `/manifest.webmanifest`, dan `/logo/gp-icon.png` dapat diakses tanpa login. Jangan simpan `/sw.js` di cache CDN untuk jangka panjang. Server memerlukan koneksi HTTPS keluar ke layanan push browser.

## Aktivasi perangkat

- Login sebagai karyawan, buka halaman Profile, lalu klik **Aktifkan notifikasi** pada kartu **Pengingat shift**.
- Setelah memperbarui `/sw.js`, buka halaman Profile sekali agar browser memeriksa dan mengaktifkan service worker terbaru. Notifikasi yang sudah tersimpan di Notification Center tetap memakai ikon lamanya.
- Ikon tab browser mengikuti favicon perusahaan/platform bila diatur pada Settings. Ikon PWA mengikuti `manifest.webmanifest`; keduanya berbeda dari ikon push di `/sw.js`.
- Izinkan notifikasi pada browser. Setiap perangkat/browser perlu aktivasi sendiri.
- Untuk iPhone/iPad, tambahkan situs ke Home Screen, buka melalui ikon tersebut, lalu aktifkan notifikasi. Memerlukan iOS/iPadOS 16.4 atau lebih baru.
- Menonaktifkan pengingat menghapus langganan perangkat itu. Logout tidak mencabut langganan, sehingga pengingat tetap dapat diterima perangkat sampai karyawan memilih **Nonaktifkan notifikasi**. Login akun lain pada browser yang sama akan menghubungkan perangkat ke akun yang sedang aktif.
- Klik pengingat membuka pilihan attendance. Pengiriman tetap bergantung pada koneksi, browser, dan pengaturan notifikasi perangkat.

## Aturan pengiriman

- Pengingat dikirim setiap 10 menit mulai 1 jam sebelum jam mulai dan jam selesai shift: T−60, T−50, T−40, T−30, T−20, dan T−10 menit, menurut zona waktu perusahaan. Contoh shift mulai 09.00 menerima pengingat pada 08.00 sampai 08.50.
- Semua langganan push milik akun akan menerima tiap pengingat. Aktifkan notifikasi secara terpisah pada setiap browser/perangkat dari halaman Profile; izin di browser desktop tidak otomatis mengaktifkan HP.
- Resolver yang sama dengan attendance memilih jadwal per tanggal sebelum jadwal rutin. Hari libur perusahaan/cabang dan day off tidak dikirimi pengingat.
- Shift malam diperiksa menggunakan tanggal awal shift. Shift yang dimulai pukul 00.00 menerima enam pengingat dari 23.00 sampai 23.50 hari sebelumnya.
- Karyawan resigned/terminated, akun/perusahaan/shift tidak aktif, periode sebelum tanggal bergabung atau setelah tanggal berakhir, cuti disetujui, dan permission tidak bekerja yang disetujui dilewati.
- Clock in dilewati bila attendance tanggal tersebut sudah ada. Clock out hanya dikirim untuk attendance yang memiliki clock in, belum clock out, dan belum final.
- WFH/business trip yang sudah membuat attendance tanpa clock in tidak mendapat pengingat clock out.
- Waktu kirim terakhir dicatat per perangkat. Satu slot yang sudah berhasil tidak dikirim ulang; slot berikutnya berjalan 10 menit kemudian. Kegagalan sementara dicoba lagi setiap menit sampai slot berikutnya atau jam shift. TTL payload dibatasi sampai jam shift agar pengingat lama tidak ditahan provider.
- Subscription yang dijawab kedaluwarsa oleh provider dihapus. Notifikasi in-app disimpan satu kali per karyawan/tanggal/jenis pengingat.
- Endpoint dibatasi pada domain provider yang diizinkan di `config/webpush.php`, dan pengiriman tidak mengikuti redirect. Endpoint dan key perangkat tersimpan terenkripsi.

## Verifikasi

```sh
php artisan test --compact tests/Feature/AttendanceReminderTest.php tests/Feature/PushSubscriptionTest.php tests/Feature/WebPushServiceTest.php
npm run types:check
npm run test:push
php artisan schedule:list
```

Tes provider memakai transport HTTP palsu, sehingga tidak mengirim push nyata. Pengujian penerimaan pada perangkat nyata tetap memerlukan konfigurasi VAPID, HTTPS, dan izin notifikasi browser.
