Integration Points
Ringkasan awam
Sistem Adi Jaya tidak berdiri sendiri. Ada koneksi ke notifikasi, email OTP, PDF, Excel, dan queue supaya proses operasional lancar.
Peta Integrasi
Sequence Notifikasi SPB/PO
1) Firebase Cloud Messaging (FCM)
- Model:
FcmToken. - Endpoint membership simpan token berdasarkan
token_id. - Dipakai pada flow SPB/PO untuk push notifikasi.
2) Email / OTP
- Event:
OtpEvent - Listener:
OtpListener - Mailer:
OtpMail - Trigger dari
Membership\\OtpController@store.
3) PDF Generation
- Trait
SavePdfTraitdipakai SPB/PO (dan beberapa dokumen lain). - Di transisi status tertentu, dokumen di-regenerate (
createOrUpdatePdf()).
4) Excel Export
- Package
maatwebsite/excel. - Export class ada di
app/Exports/Admin/*+ job terkait.
5) Queue / Async
- Job ekspor SPB/PO/payment.
- Job push notification dan proses file gambar.
- Konfigurasi queue di
config/queue.php.
6) Basic Auth API Docs
- Middleware/package
tmd-bsa. - Endpoint docs:
/api/v1/doc.
7) Maps API Key
- Konfigurasi di
config/maps-api-key.php(MAPS_API_KEY).
Tabel Kontrak Integrasi
| Integrasi | Input utama | Output | Owner domain |
|---|---|---|---|
| FCM | token device + payload | push notif | Membership + Core Flow |
| Mail OTP | email + OTP | email verifikasi | Membership |
| objek domain (SPB/PO/SPK) | file PDF storage | Procurement/Project | |
| Excel | query/list data | file xlsx | Admin/Reporting |
| Queue | job payload | proses async | Platform |
Perlu verifikasi
- Detail credential Firebase (
storage/app/firebase.json) harus dipastikan aman di production (encrypted/secret manager). - Jalur SMTP aktif per env belum didokumentasikan lengkap di repo.