Panduan Bot WhatsApp JRK 1

📋 Daftar Isi

Perintah Dasar
Role-Based Menu — Menu Berbeda per Pengurus
Menu Umum (1-9)
Menu Korlap (10-11)
Menu Keuangan
Menu Data
Kwitansi IPL (Menu 8)
Kwitansi Biasa (Menu 9)
Auto-Notifikasi Korlap
Forward Kwitansi ke Admin
Reply/Quote Menu
Akses & Keamanan
Auto-Heal & Maintenance

💬 Perintah Dasar

Perintah	Fungsi
`/info`	Menampilkan menu sesuai role pengguna (lihat Role-Based Menu)
`/input`	Dinonaktifkan Fitur input data sedang dalam pengembangan
`/debug`	Menampilkan Info Chat ID untuk konfigurasi
`skip`	Melewati upload bukti (hanya untuk input pemasukan/pengeluaran)

👥 Role-Based Menu

Bot mendeteksi nomor WA pengirim dan menampilkan menu yang berbeda sesuai jabatan. Berikut daftar pengurus:

Tim Inti

Jabatan	Nama	Role Badge
Ketua Paguyuban	Pak Harkes	Ketua
Wakil Ketua Paguyuban	Pak Nungky	Ketua
Sie Lingkungan & Keamanan	Pak Dwi	Staff
Sie Data & Teknologi	Pak Adam	Data
Sie Data	Pak Rendy	Data
Bendahara 1	Bu Thia	Keuangan
Bendahara 2	Bu Diaz	Keuangan
Sekretaris	Bu Reffa	Staff

Koordinator Lapangan (Korlap)

Nama	Blok	Role Badge
Pak Boby	I	Korlap
Pak Try Pamungkas	II	Korlap
Pak Luki	III	Korlap
Pak Nanang	IV	Korlap
Pak Febry	V	Korlap
Pak Oky	VI	Korlap
Pak Sofyan	VII	Korlap
Pak Indra	VIII, IX	Korlap
Pak Hamzah	Raya Depan	Korlap
Pak Mulyadi	Raya Belakang	Korlap
Pak Huda	X Depan	Korlap
Pak Saiful	X Belakang	Korlap
Bu Annisa	RUHA	Korlap

🏠 Menu Umum Semua Role

Menu 1-9 sama untuk semua pengguna. Kirim /info untuk menampilkan:

Menu 1-4, 7 — Export Laporan

Laporan langsung di-generate dan dikirim dalam bentuk file PDF/Excel tanpa perlu input tambahan.

Menu 5 — Laporan Pengeluaran

Setelah memilih, pilih periode:

1 Bulan ini → 2 3 bulan terakhir → 3 Tahun ini

Menu 6 — Laporan Pemasukan

Sama seperti menu 5, pilih periode yang diinginkan.

📍 Menu Korlap Khusus Korlap

Saat Korlap kirim /info, bot menampilkan menu dengan tambahan 3 shortcut blok:

No	Fitur	Penjelasan
10	Rekap Pembayaran Blok	Generate PDF laporan IPL khusus untuk blok yang menjadi tanggung jawab Korlap tersebut (bukan semua blok)
11	Cek Warga Menunggak	Menampilkan daftar warga di blok Korlap yang belum membayar IPL, lengkap dengan jumlah tunggakan dan nominal

Multi-blok: Korlap yang memegang lebih dari 1 blok (misal Pak Indra: Blok VIII & IX) akan melihat kedua bloknya di menu.

👤 Menu Ketua Ketua & Wakil

Ketua/Wakil mendapat menu Ringkasan Keuangan:

No	Fitur	Penjelasan
10	Ringkasan Keuangan	Menampilkan teks ringkasan: pemasukan IPL, pemasukan lain, pengeluaran, saldo bulan ini & tahun ini, jumlah unit menunggak, dan top 5 kategori pengeluaran bulan ini

💰 Menu Keuangan Bendahara

Menu keuangan sama seperti menu umum (1-9) — fokus pada laporan & kwitansi.

📡 Menu Data Sie Data

Menu data sama seperti menu umum (1-9) — fokus pada ekspor laporan.

🧾 Generate Kwitansi IPL Menu 8

Alur Lengkap

Pilih Blok → Pilih Unit → Jumlah Bulan → Input Tanggal → Kwitansi PDF Dikirim → Forward ke Admin?

Tarif IPL

Tipe Unit	Harga/Bulan
Unit Biasa (Blok I-X, Raya)	Rp 150.000
Unit RUHA	Rp 200.000

Detail Setiap Langkah

Langkah	Yang Dilakukan
Pilih Blok	Pilih nomor blok (1-14): I, II, III, IV, V, VI, VII, VIII, IX, X Depan, X Belakang, Raya Depan, Raya Belakang, RUHA
Pilih Unit	Pilih nomor unit yang tampil di daftar
Jumlah Bulan	Kirim angka (contoh: `3`). Bot otomatis menghitung bulan mulai dari bulan setelah pembayaran terakhir unit tersebut. Jika belum pernah bayar, mulai dari bulan saat ini.
Input Tanggal	Kirim `DD-MM-YYYY` (contoh: `04-05-2026`) atau `TODAY` untuk pakai tanggal hari ini

Contoh Skenario

Misal: Unit JRK 1 Blok I No. 5 terakhir bayar bulan Maret 2026.
User memilih 3 bulan → Bot hitung: April 2026, Mei 2026, Juni 2026.
Total: 3 × Rp 150.000 = Rp 450.000.
PDF Kwitansi mencantumkan periode "April 2026, Mei 2026, Juni 2026".

Isi PDF Kwitansi

Nomor Kwitansi, Tanggal Pembayaran, Tanggal Cetak
Detail: Unit, Blok, Nama Pemilik, Jenis (IPL), Periode (daftar bulan)
Jumlah Pembayaran (Rp)
Cap "LUNAS"
Stempel & tanda tangan bendahara

🧾 Generate Kwitansi Biasa Menu 9

Untuk pengeluaran kasbon / dana pribadi (bukan IPL).

Alur

Nama Pengaju → Keperluan → Nominal → Tanggal → Kwitansi PDF Dikirim → Forward ke Admin?

Langkah	Contoh Input
Nama Pengaju	`Agus` atau `Tim Keamanan`
Keperluan	`Pembelian BBM` atau `Biaya ATK`
Nominal	`250000` (angka saja)
Tanggal	`04-05-2026` atau `TODAY`

📋 Auto-Notifikasi Korlap

Setiap tanggal 10 pukul 08:00 WIB, bot otomatis mengirim pesan pribadi ke setiap Korlap yang memiliki warga menunggak di bloknya.

Fitur ini otomatis: Korlap tidak perlu melakukan apapun. Notifikasi dikirim langsung ke nomor WA pribadi masing-masing Korlap.

📤 Forward Kwitansi ke Admin

Setelah kwitansi berhasil di-generate, bot otomatis menawarkan:

Pilih 1 → Kwitansi dikirim ulang ke nomor admin yang terdaftar di konfigurasi
Pilih 2 → Selesai, kwitansi tidak diteruskan

Nomor forward admin: 6285210100793 (dapat diubah di file allowed-groups-config.json)

↩️ Reply/Quote Menu

Bot mendukung fitur reply (quote) ke pesan menu. Ini berguna ketika:

Menu sudah ter-scroll dan ingin memilih tanpa scroll balik
User sedang di tengah alur (misal input kwitansi) tapi ingin pindah ke menu lain

Reply ke Menu	Contoh Reply	Hasil
Menu Role (Korlap/Ketua/dll)	`1` sampai `11`	Langsung ke fitur sesuai nomor
Laporan Pengeluaran	`3`	Export tahun ini
Laporan Pemasukan	`1`	Export bulan ini

Cara: Tekan lama pesan bot → pilih "Balas" / "Reply" → ketik nomor pilihan → kirim.

🔐 Akses & Keamanan

Grup yang Diizinkan

120363408189501358@g.us — Grup utama JRK 1
120363316047070840@g.us — Grup kedua

Fitur Kwitansi (Menu 8 & 9)

Hanya bisa diakses oleh:

Grup Anggota dari 2 grup yang terdaftar di atas
DM Nomor admin yang terdaftar (via chat pribadi)
DM Nomor yang terdaftar di allowedNumbers konfigurasi

Cek Akses Anda

Kirim /debug ke bot untuk melihat Chat ID Anda. Jika tidak bisa menghubungi bot, hubungi admin untuk didaftarkan.

🔄 Auto-Heal & Maintenance

Bot memiliki sistem pemulihan otomatis untuk menjaga koneksi tetap stabil:

Fitur	Detail
Keep-Alive	Mengirim presence update setiap 3 menit untuk mencegah idle disconnect
Health Check	Memeriksa koneksi WebSocket setiap 5 menit. Jika terputus, otomatis reconnect
Systemd Restart	Service `baileys-bot.service` dengan `Restart=always`, restart dalam 5 detik jika crash
Unhandled Error	Error koneksi ditangkap dan memicu reconnect dalam 3 detik
Duplicate Message	Pesan duplikat otomatis diabaikan (cache 5000 pesan terakhir)
Conflict Resolution	Jika ada konflik koneksi, bot akan restart maksimal 3 kali

Memantau Bot

📁 File Konfigurasi

File	Keterangan
`baileys-bot/allowed-groups-config.json`	Konfigurasi grup, nomor, reminder, dan forward admin
`baileys-bot/roles-config.json`	Mapping nomor WA ke role pengurus (fallback lokal)
`baileys-bot/bot.js`	File utama bot (logika pesan, state machine)
`baileys-bot/lib/helpers.js`	Helper functions (akses data, validasi, cache, role lookup)
`baileys-bot/lib/actions.js`	Fungsi generate laporan, kwitansi PDF, input data, notifikasi
`baileys-bot/lib/menus.js`	Builder menu per role (dipisahkan dari bot.js)
`/etc/systemd/system/baileys-bot.service`	Systemd service unit