Apa Itu Peringatan

Peringatan (Smart Alerts) adalah sistem notifikasi otomatis yang memantau kondisi keuangan perusahaan dan memberitahu pengguna jika ada anomali atau risiko yang perlu ditindaklanjuti. Sistem mengevaluasi 7 jenis aturan setiap hari dan menghasilkan event peringatan ketika ambang batas terlampaui.

Jenis Peringatan

Tipe	Nama Indonesia	Deskripsi	Satuan Ambang Batas
CASH_LOW	Kas Rendah	Saldo kas + bank di bawah ambang batas	Rp
RECEIVABLE_OVERDUE	Piutang Jatuh Tempo	Ada piutang yang sudah jatuh tempo	— (0 = aktif)
EXPENSE_SPIKE	Lonjakan Biaya	Biaya bulan ini naik melebihi X% dari rata-rata 3 bulan sebelumnya	%
PROJECT_COST_OVERRUN	Proyek Melebihi Anggaran	Ada proyek yang biayanya melebihi anggaran	— (0 = aktif)
PROJECT_MARGIN_DROP	Margin Proyek Turun	Margin proyek turun di bawah X%	%
COLLECTION_SLOWDOWN	Penagihan Melambat	Rata-rata hari penagihan melebihi X hari	hari
CLIENT_CONCENTRATION	Konsentrasi Klien	Satu klien menyumbang lebih dari X% pendapatan	%

Tingkat Keparahan (Severity)

Severity	Indonesia	Warna Badge	Keterangan
INFO	Informasi	Biru	Kondisi yang perlu diketahui, tidak mendesak
WARNING	Peringatan	Kuning	Kondisi yang perlu segera diperhatikan
CRITICAL	Kritis	Merah	Kondisi darurat yang harus ditindaklanjuti segera

Evaluasi Harian

Sistem menjalankan evaluasi seluruh aturan yang aktif setiap hari pukul 08:00 secara otomatis. Mekanisme:

1. Setiap aturan yang enabled = true dievaluasi
2. Jika kondisi ambang batas terpenuhi, event peringatan dibuat
3. Deduplikasi 24 jam: jika sudah ada event yang belum dikonfirmasi untuk aturan yang sama dalam 24 jam terakhir, event baru tidak dibuat (mencegah duplikasi peringatan)

---

Halaman Konfigurasi

Buka menu Laporan > Peringatan, lalu klik tab Konfigurasi atau navigasi langsung ke /alerts/config.

Halaman menampilkan daftar 7 aturan peringatan bawaan. Setiap aturan menampilkan:

• Nama tipe: Nama Indonesia dari jenis peringatan
• Deskripsi: Penjelasan kondisi yang dievaluasi
• Ambang Batas (Threshold): Nilai numerik yang menjadi batas pemicu
• Status Aktif: Checkbox untuk mengaktifkan/menonaktifkan aturan

Mengubah Ambang Batas

1. Isi nilai baru pada field Ambang Batas sesuai jenis aturan:
   • Kas Rendah: nominal dalam Rupiah (contoh: 10000000 = Rp 10 juta)
   • Lonjakan Biaya: persentase (contoh: 30 = 30%)
   • Margin Proyek Turun: persentase (contoh: 10 = 10%)
   • Penagihan Melambat: jumlah hari (contoh: 30 = 30 hari)
   • Konsentrasi Klien: persentase (contoh: 50 = 50%)
   • Piutang Jatuh Tempo / Proyek Melebihi Anggaran: 0 berarti selalu aktif
2. Klik Simpan pada aturan yang diubah

Menonaktifkan Aturan

Hapus centang pada checkbox Aktif, lalu klik Simpan. Aturan yang nonaktif tidak akan dievaluasi pada jadwal harian.

Permission yang diperlukan: ALERT_CONFIG

---

Halaman Peringatan Aktif

Buka menu Laporan > Peringatan atau navigasi ke /alerts.

Halaman menampilkan daftar peringatan yang belum dikonfirmasi (unacknowledged). Setiap peringatan menampilkan:

• Badge severity: Warna menunjukkan tingkat keparahan (biru = INFO, kuning = WARNING, merah = CRITICAL)
• Tipe peringatan: Nama Indonesia dari jenis peringatan
• Pesan: Detail kondisi yang memicu peringatan
• Waktu: Timestamp kapan peringatan dipicu
• Tombol Konfirmasi: Untuk menandai peringatan sudah ditindaklanjuti

Mengonfirmasi Peringatan

Klik tombol Konfirmasi pada peringatan yang sudah ditindaklanjuti. Peringatan yang dikonfirmasi berpindah ke halaman riwayat dan tidak lagi muncul di daftar aktif.

Permission yang diperlukan: ALERT_ACKNOWLEDGE

---

Widget Peringatan

Widget peringatan ditampilkan di halaman Dashboard (/dashboard), dimuat secara dinamis via HTMX.

Widget menampilkan:

• Jumlah peringatan per severity: Berapa peringatan aktif bertipe INFO, WARNING, dan CRITICAL
• 5 peringatan terbaru: Daftar singkat peringatan aktif dengan badge severity dan pesan
• Link ke halaman peringatan: Klik untuk melihat seluruh peringatan aktif

Widget ini membantu memantau kondisi keuangan tanpa harus membuka halaman peringatan secara terpisah.

---

Halaman Riwayat

Buka navigasi ke /alerts/history atau klik tab Riwayat dari halaman peringatan.

Halaman menampilkan seluruh peringatan (aktif dan yang sudah dikonfirmasi) dalam tabel paginated. Informasi yang ditampilkan:

• Tipe: Jenis peringatan
• Severity: Tingkat keparahan
• Pesan: Detail peringatan
• Waktu Trigger: Kapan peringatan dipicu
• Status: Dikonfirmasi (dengan nama dan waktu) atau belum

Permission yang diperlukan: ALERT_VIEW

---