riadag/gembok-bill repository overview

⁠Gembok Bill - Sistem Manajemen ISP Terintegrasi

⁠📋 Deskripsi Aplikasi

Gembok Bill adalah sistem manajemen RTRWNet terintegrasi yang menggabungkan WhatsApp Gateway dengan portal admin web untuk mengelola layanan internet secara komprehensif. Aplikasi ini dirancang khusus untuk RTRWNet yang membutuhkan solusi all-in-one untuk manajemen pelanggan, billing, monitoring, dan notifikasi.

⁠🎯 Fitur Utama

• 🔧 WhatsApp Bot Gateway - Interface perintah via WhatsApp dengan role-based access control
• 🌐 Web Portal Admin - Dashboard admin yang lengkap dengan versioning system
• 💳 Sistem Billing Terintegrasi - Manajemen tagihan dan pembayaran
• 💳 Payment Gateway - Integrasi Midtrans, Xendit, Tripay
• 📊 GenieACS Management - Monitoring dan manajemen perangkat ONU/ONT
• 🛠️ Mikrotik Management - Manajemen PPPoE dan Hotspot
• 📱 Portal Pelanggan - Self-service untuk pelanggan
• 📈 Monitoring Real-time - PPPoE, RX Power, dan sistem dengan grafik terpisah
• 🔔 Notifikasi Otomatis - WhatsApp notifications
• 📋 Trouble Ticket System - Manajemen gangguan via WhatsApp dan web
• 👥 Role-Based Access Control - Super Admin, Admin, Technician, Customer
• 📱 WhatsApp Commands - Trouble report, PPPoE management, version info
• 🎨 Enhanced UI - Traffic graphs separation, high bandwidth support, admin settings cleanup

⁠📱 WhatsApp Commands

⁠👑 Admin Commands (Super Admin & Admin)

• admin - Menu bantuan khusus admin
• cekstatus [nomor] - Cek status pelanggan berdasarkan nomor
• gantissid [nomor] [ssid_baru] - Ganti SSID WiFi pelanggan
• reboot [nomor] - Reboot perangkat pelanggan
• status - Cek status sistem dan koneksi
• restart - Restart layanan WhatsApp
• version - Tampilkan informasi versi aplikasi
• info - Tampilkan informasi sistem lengkap

⁠🔧 Technician Commands (Admin & Technician)

• teknisi - Menu bantuan khusus teknisi
• trouble - Lihat daftar laporan gangguan
• status [id] - Cek status laporan gangguan tertentu
• update [id] [status] [catatan] - Update status laporan
• selesai [id] [catatan] - Tandai laporan selesai
• addpppoe [user] [pass] [profile] [ip] [info] - Tambah user PPPoE
• editpppoe [user] [field] [value] - Edit field user PPPoE
• delpppoe [user] [alasan] - Hapus user PPPoE
• pppoe [filter] - List semua user PPPoE
• checkpppoe [user] - Cek status user PPPoE
• restartpppoe [user] - Restart koneksi user PPPoE

⁠👤 Customer Commands (Semua User)

• menu - Menu umum untuk semua user
• billing - Menu bantuan untuk fitur billing
• cekstatus [nomor] - Cek status pelanggan (terbatas)
• version - Tampilkan informasi versi aplikasi

⁠📚 Help Commands

• help trouble - Bantuan untuk fitur trouble report
• help pppoe - Bantuan untuk fitur PPPoE management

⁠🚀 Instalasi

⁠Persyaratan Sistem

• Node.js v18+ (direkomendasikan v20+)
• npm atau yarn
• GenieACS API access
• Mikrotik API access
• WhatsApp number untuk bot
• Database SQLite (built-in)

⁠Portal Pelanggan: http://ipserver:3003⁠

⁠Admin Dashboard: http://ipserver:3003/admin/login⁠

⁠Login

• admin_username": admin
• admin_password": admin

⁠Docker Compose

services:
  gembokbill:
    image: riadag/gembok-bill:latest
    container_name: gembokbill
    ports:
      - 3003:3003
    restart: unless-stopped