📘 Panduan Instalasi & Konfigurasi MonitorPIC di Laptop

Panduan ini untuk Windows dengan XAMPP. Ikuti urut dari Langkah 1. Setiap langkah ada tanda cek ✅ agar Anda tahu sudah benar.

Gambaran alur otomatis (tanpa buka WhatsApp Web / kirim manual):
Jam 08:00 → Windows Task Scheduler menjalankan cron.php → sistem mengelompokkan tiket per PIC → 1 pesan berisi daftar bernomor dikirim lewat WhatsApp gateway (langsung ke nomor PIC) dan/atau Email SMTP → hasilnya tercatat di menu Reminder → Riwayat.

Langkah 1 – Pasang XAMPP & salin aplikasi

Unduh XAMPP (PHP 8.x) dari apachefriends.org, install ke C:\xampp (jangan diubah lokasinya agar skrip jadwal langsung cocok).
Buka XAMPP Control Panel → klik Start pada Apache dan MySQL (keduanya hijau). Disarankan: centang kotak Svc di kiri Apache & MySQL (install sebagai service) agar otomatis hidup saat laptop menyala.
Ekstrak monitorpic-php-xampp-v9.2.zip. Salin folder monitorpic ke C:\xampp\htdocs\ sehingga ada C:\xampp\htdocs\monitorpic\index.html.

Langkah 2 – Buat database

Buka browser: http://localhost/phpmyadmin
Klik tab Import → Choose File → pilih C:\xampp\htdocs\monitorpic\database.sql → klik Import di paling bawah.
✅ Berhasil bila muncul "Import has been successfully finished" dan di kiri ada database monitorpic.

Jika MySQL Anda memakai password, ubah DB_PASS di config.php (buka dengan Notepad).

Langkah 3 – Buka aplikasi & isi data nyata

Buka http://localhost/monitorpic/ → login admin / admin123.
Klik nama akun (kanan atas) → Profil Saya → isi No. WA Anda (format 6281234567890, tanpa +, tanpa 0 di depan) dan Email → Simpan. Ganti password bila perlu.
Menu kiri Administrasi → Pengguna → klik Ubah pada tiap PIC → isi No. WA & Email asli PIC.
Pada Pengguna → Ubah, pastikan tiap PIC memiliki Level pegawai dan Status pegawai (menentukan siapa boleh meng-assign dan menu yang bisa dibuka). Level & status dapat diubah di Parameter → Level Pegawai / Status Pegawai.
Menu kiri Administrasi → Parameter → Sistem & Bantuan → isi Nomor WA Admin (untuk tombol hijau 💬 Bantuan di pojok kanan bawah semua halaman, termasuk halaman login) → Simpan.

Penting: nomor WA pada data contoh (628000000xxxx) bukan nomor asli sehingga aman. Jangan mengisi nomor asli PIC sebelum Anda selesai uji coba dengan mode tes (Langkah 6).

Langkah 4 – Hubungkan WhatsApp (pilih SATU opsi)

Opsi A (disarankan): Fonnte – tinggal scan QR sekali

Buka fonnte.com → daftar akun → login.
Menu Device → Add Device → isi nomor WhatsApp pengirim (disarankan nomor khusus kantor, bukan nomor pribadi).
Di HP: WhatsApp → ⋮ / Pengaturan → Perangkat tertaut → Tautkan perangkat → scan QR yang tampil di Fonnte. Status device harus Connected.
Salin Token device (di halaman Device).

Buka C:\xampp\htdocs\monitorpic\config.php dengan Notepad, isi:

define('WA_PROVIDER', 'fonnte');
define('FONNTE_TOKEN', 'tempel-token-di-sini');

Simpan.

Catatan: kuota/harga paket Fonnte dapat berubah — cek di situs mereka. HP pengirim cukup tetap online sesekali.

Opsi B: Gateway lokal di laptop (gratis, tidak resmi)

Install Node.js LTS dari nodejs.org (Next-Next-Finish).
Klik dua kali jalankan_wa_gateway.bat. Pertama kali akan mengunduh komponen (±150 MB, tunggu).
Jendela hitam menampilkan QR. Scan lewat WhatsApp → Perangkat tertaut → Tautkan perangkat. ✅ Muncul "WhatsApp TERHUBUNG".
Di config.php isi:
```
define('WA_PROVIDER', 'local');
```
Biarkan jendela gateway tetap terbuka (atau taruh pintasan jalankan_wa_gateway.bat di folder Startup: tekan Win+R → ketik shell:startup).

Opsi B memakai pustaka tidak resmi; WhatsApp berpotensi membatasi nomor yang mengirim pesan massal. Pakai nomor khusus & volume kecil.

Langkah 5 – (Opsional) Email otomatis via Gmail

Akun Google → Keamanan → aktifkan Verifikasi 2 langkah.
Buka myaccount.google.com/apppasswords → buat App Password (nama bebas) → salin 16 karakter.

Isi di config.php:

define('SMTP_HOST', 'smtp.gmail.com');
define('SMTP_PORT', 587);
define('SMTP_USER', 'emailanda@gmail.com');
define('SMTP_PASS', 'abcdefghijklmnop');   // App Password, tanpa spasi
define('SMTP_FROM_NAME', 'Admin Dashboard');

Email berisi daftar item bernomor yang sama dengan pesan WhatsApp. Untuk Office 365 gunakan smtp.office365.com port 587 (SMTP AUTH harus diaktifkan admin IT).

Langkah 6 – Uji coba AMAN (mode tes)

Di config.php isi nomor/email Anda sendiri agar semua pesan dialihkan ke Anda:

define('WA_TEST_NUMBER', '6281234567890');
define('EMAIL_TEST_ADDRESS', 'emailanda@gmail.com');

Di aplikasi: menu kiri Reminder → Jadwal & Template → kartu Koneksi WhatsApp & Email → pastikan status hijau "siap" → klik Tes kirim WA ke saya dan Tes kirim Email ke saya. ✅ Pesan tes masuk di WhatsApp/Email Anda.
Masih di halaman yang sama, kartu Template Pesan Otomatis → klik Pratinjau untuk melihat bentuk pesan. Contoh hasil:
Selamat pagi, Budi. Berikut daftar item yang perlu ditindaklanjuti hari ini: 1. Perbaikan server aplikasi HR - TKT-2026-0001 - 21 Okt 2026 - Tinggi - In Progress 2. Update sertifikat SSL website - TKT-2026-0002 - 29 Okt 2026 - Tinggi - Open Mohon lakukan tindak lanjut dan perbarui status setiap item sesuai progres. Atau melalui website http://localhost/monitorpic Terima kasih. Salam Admin Dashboard
Klik Kirim sekarang (semua tiket aktif) atau klik dua kali tes_reminder_sekarang.bat. ✅ Anda menerima pesan per PIC (berawalan "[MODE TES – seharusnya ke …]"). Cek juga menu Reminder → Riwayat Pengiriman (1 baris per PIC, kanal "WA + Email" tetap 1 baris).

Langkah 7 – Atur jadwal 08:00 & aktifkan scheduler Windows

Menu kiri Reminder → Jadwal & Template → kartu Jadwal Pengiriman Otomatis: pilih Frekuensi (mingguan / setiap hari kerja / setiap hari), Jam kirim 08:00, Kanal, dan Item yang dikirim → Simpan Jadwal. Bagian "Jadwal berikutnya" menampilkan waktu kirim terdekat.
Klik dua kali buat_jadwal_reminder.bat. Jika muncul peringatan, klik kanan → Run as administrator. ✅ Muncul "BERHASIL: jadwal … dibuat".
Cek: tekan Win → ketik Task Scheduler → Task Scheduler Library → ada MonitorPIC Reminder (Last Run Result 0x0 = sukses).

Cara kerjanya: Windows menjalankan cron.php tiap 15 menit. Skrip hanya mengirim bila hari & jam cocok dan hari itu belum terkirim. Jika laptop baru menyala pukul 09:10, pesan tetap terkirim saat itu (hanya sekali per hari). Pengaturan jadwal tidak perlu diubah di Windows — cukup ubah di aplikasi.

Agar tidak terlewat: laptop harus menyala (boleh Sleep; tugas sudah diatur membangunkan laptop) dan MySQL hidup (centang Svc di XAMPP). Apache tidak wajib untuk pengiriman, hanya untuk membuka aplikasi. Nonaktifkan Hibernate/Shutdown terjadwal pada jam tersebut.

Langkah 8 – Go-live

Pastikan semua PIC sudah memiliki No. WA & Email asli (menu Pengguna).
Di config.php kosongkan WA_TEST_NUMBER dan EMAIL_TEST_ADDRESS → kembalikan menjadi ''. Status "MODE TES" di menu Reminder akan hilang.
Ganti Alamat website pada template menjadi alamat yang dipakai PIC (mis. http://192.168.1.10/monitorpic bila diakses dari jaringan kantor — gunakan IP laptop, dan izinkan Apache di Windows Firewall).
Ganti password akun contoh (admin123 dst.) dan set password MySQL root.

Fitur baru v8 (ringkas)

Notifikasi komitmen: popup saat login + angka merah di nama akun. Muncul mulai H-7 (dapat diubah) dan setiap hari setelah lewat komitmen, sampai komitmen diperbarui, tiket selesai, atau dialihkan.
Jam layanan Bantuan: atur di Parameter → Sistem & Bantuan (jam mulai, selesai, hari). Di luar jam, tombol kirim di popup nonaktif.
Menu & Akses: Parameter → Menu & Akses untuk mengubah / menambah / menonaktifkan menu & submenu dan membatasi akses per Unit, Level, Status pegawai.
Idle: Parameter → Sistem → Batas idle aplikasi (detik) — peringatan 30 detik sebelum logout otomatis.
Aturan assign: hanya boleh ke level di bawah level pengirim (Admin bebas).

Fitur baru v9 (ringkas)

Bantuan Admin: menu Administrasi → Parameter → Bantuan Admin — isi nomor WA admin, jam & hari layanan, dan kelola topik bantuan (tiap topik bisa punya jam khusus).
Kriteria password: Parameter → Sistem → Keamanan (panjang minimal, huruf besar & kecil, angka, simbol). Pengguna melihat daftar kriteria + contoh saat mengisi password.
Tiket selesai hanya dapat dibuka kembali oleh Admin atau level Departement Head (dapat diubah di Parameter → Sistem → Tiket).
Pesan petunjuk berwarna lembut dapat ditutup dan muncul lagi setelah login ulang. Menu disembunyikan dengan tombol ☰.

Pemecahan masalah

Gejala	Penyebab & solusi
Status "MODE SIMULASI"	Token/SMTP di `config.php` masih kosong atau file belum disimpan. Isi lalu muat ulang halaman.
WA: "Fonnte: …reason"	Token salah / device belum Connected / kuota habis / nomor tujuan bukan nomor WhatsApp. Cek di dashboard Fonnte.
WA: "Gateway lokal tidak aktif"	`jalankan_wa_gateway.bat` belum dijalankan atau QR belum discan.
Email: "SMTP: 535 …"	Pakai App Password (bukan password biasa) dan verifikasi 2 langkah aktif.
Email: "Tidak bisa terhubung ke SMTP"	Firewall/antivirus memblokir port 587; coba port 465 atau jaringan lain.
Tidak terkirim jam 08:00	Cek `logs\cron.log`; pastikan MySQL hidup, tugas "MonitorPIC Reminder" ada di Task Scheduler, hari/frekuensi & jam benar, dan belum terkirim hari itu (`last_run`). Uji dengan `tes_reminder_sekarang.bat`.
"0 PIC dikirimi"	Tidak ada tiket yang memenuhi: reminder tiket nonaktif, status Done, atau item "Hanya 🔴/🟡" dipilih sementara tidak ada tiket merah/kuning. Ubah ke "Semua tiket belum selesai".
Bantuan selalu Offline / Parameter › Bantuan Admin error	Database belum lengkap (tabel/kolom bantuan). Buka CMD di folder aplikasi: `C:\xampp\php\php.exe migrate.php` (aman, tidak menghapus data), lalu muat ulang. Buka Parameter → Bantuan Admin untuk melihat waktu server & status; bila perlu klik Paksa Online sementara.
Halaman putih / error database	MySQL belum Start, atau `DB_USER/DB_PASS` di `config.php` salah.

Cetak panduan ini ke PDF: tekan Ctrl+P → Save as PDF.