Gembok Bill

Panduan Instalasi

Lihat Dokumen Lengkap

Prasyarat Sistem

Node.js

Versi minimal 14.0.0 atau yang lebih baru. Diperlukan untuk menjalankan aplikasi backend.

Wajib
npm

Versi minimal 6.0.0 atau yang lebih baru. Digunakan untuk manajemen paket dan dependensi.

Wajib
Database

SQLite untuk development atau MySQL untuk production environment.

Opsional
WhatsApp Business

Nomor WhatsApp Business untuk fitur gateway dan notifikasi otomatis.

Opsional

Langkah Instalasi

1
Clone Repository

Unduh kode sumber dari repository GitHub resmi.

git clone https://github.com/alijayanet/gembok-bill.git
cd gembok-bill
2
Instal Dependensi

Instal semua paket dan dependensi yang diperlukan.

npm install
3
Konfigurasi Environment

Buat file konfigurasi environment dari template yang tersedia.

cp .env.example .env
nano .env  # atau editor favorit Anda

Edit file .env dengan konfigurasi yang sesuai:

  • Database Configuration: Sesuaikan dengan database Anda
  • WhatsApp Settings: Nomor admin dan path sesi
  • Mikrotik Credentials: Akses ke router Mikrotik
  • GenieACS Settings: URL dan kredensial GenieACS
4
Inisialisasi Database

Jalankan script setup untuk membuat struktur database dan data awal.

npm run setup
Penting: Langkah ini wajib dilakukan sebelum menjalankan aplikasi untuk pertama kali.
5
Jalankan Aplikasi

Untuk production:

npm start

Untuk development (dengan auto-reload):

npm run dev

Pasca Instalasi

Verifikasi Instalasi

Pastikan aplikasi berjalan dengan benar dengan mengakses:

  • Admin Dashboard: http://localhost:3000
  • WhatsApp Gateway: Periksa koneksi di terminal
  • Database: Verifikasi struktur tabel
Pemeliharaan

Untuk pemeliharaan rutin:

  • Update dependensi: npm update
  • Backup database secara berkala
  • Monitor log aplikasi
  • Restart service jika diperlukan

Troubleshooting

Jika muncul error seperti "SQLITE_ERROR: no such column: invoice_type", jalankan migrasi database:

npm run run-sql-migrations

Jika mengalami masalah koneksi WhatsApp:

  1. Pastikan nomor WhatsApp yang digunakan belum terdaftar di device lain
  2. Hapus folder sesi WhatsApp: rm -rf ./whatsapp-session
  3. Restart aplikasi dan scan ulang QR code
  4. Periksa versi Baileys: npm run check-whatsapp-version

Jika port sudah digunakan aplikasi lain:

  1. Ubah port di file .env
  2. Gunakan port yang tersedia, misalnya 3001, 3002, dst.
  3. Restart aplikasi setelah perubahan