Konfigurasi

Semua pengaturan utama berada di settings.json (root proyek atau volume docker-data/). Sebagian bisa diubah dari panel admin; sebagian hanya di berkas.

Penting: settings.json, .env, dan database/ tidak boleh di-commit ke Git (sudah masuk .gitignore & .dockerignore).

Umum & Branding

Kunci	Keterangan
`company_header` / `company_name`	Nama perusahaan (tampil di UI, invoice, WhatsApp)
`company_logo`, `logo_portal`, `logo_invoice`	Logo (path/URL)
`project_url`	URL repositori proyek (dipakai di halaman landing/about)
`app_url`	URL publik aplikasi (dipakai untuk link pada notifikasi/QRIS)
`server_port`, `server_host`	Port & host server
`default_lang`	Bahasa default (`id` / `en`)
`timezone`	Zona waktu (mis. `Asia/Jakarta`)
`session_secret`	Rahasia sesi — ganti dengan nilai acak

Menu lanjutan bisa dikunci. Untuk membukanya dipakai kode aktivasi:

Kode tidak dipublikasikan di repo. Atur di settings.json:
- activation_code — kode dalam bentuk teks (dipakai pada alur donasi/layanan untuk menampilkan & mengirim kode).
- feature_password_hash — sha256 kode untuk validasi (opsional; default ada).

Contoh menghasilkan hash:

node -e "console.log(require('crypto').createHash('sha256').update('KODE-ANDA').digest('hex'))"

feature_contact_phone — nomor kontak yang ditampilkan pada menu terkunci.

Pada halaman Dukung OPEN-ISP (/donate) kode ditampilkan dari activation_code (bila diatur).

MikroTik

Multi-router: daftar router, tes koneksi, setup firewall, pemilihan router per pelanggan.
API standar port 8728; dukungan TLS/API-SSL port 8729 (self-signed diperbolehkan).
RouterOS 7 didukung (client API kompatibel).
Profil PPPoE/hotspot, sesi aktif, monitor trafik, jam kalong, FUP, voucher hotspot, backup konfigurasi.

OLT (PON)

Mendukung Hioso & HSGQ (SNMP) serta ZTE & Huawei (CLI/Telnet).
Isi host, community SNMP, port, merek, kredensial web/Telnet.
Aksi ONU: statistik, reboot, rename, otorisasi, konfigurasi WAN/OMCI.
Deteksi OLT baru: node scripts/olt-probe.js.

TR-069 (ACS bawaan & GenieACS)

ACS bawaan (tanpa server terpisah): set use_builtin_acs: true. Arahkan CPE ke http://IP-SERVER:PORT/acs.
Integrasi GenieACS eksternal juga didukung (REST API).

WhatsApp & Telegram

WhatsApp: pilih gateway GoWA (self-hosted), Fonnte, atau Meta Cloud API. Isi kredensial gateway sesuai pilihan.
Telegram: aktifkan bot & isi telegram_bot_token, telegram_admin_id.
Template pesan (tagihan, pengingat, struk) bisa diatur dari panel admin.

Pembayaran

QRIS statis + kode unik untuk pencocokan otomatis.
Webhook generik: POST /api/webhook/v1/payment-notif dengan header/secret MY_WEBHOOK_SECRET (di .env).
Gateway opsional: Midtrans / Tripay / Xendit / Duitku (sesuai konfigurasi).

Speed Test

Mode internal (backend LibreSpeed bawaan server di /speedtest/) atau eksternal (preset provider diatur admin).
Tampilan embed/tab; tersedia tombol Muat Ulang & Bersihkan Cache di portal pelanggan.

Email/SMTP (opsional)

Untuk notifikasi email (bila diaktifkan): isi host, port, user, password SMTP.

Selanjutnya: Panduan Admin.

Fitur Opsional

Voucher / Beli Voucher Wi-Fi — nyalakan/matikan lewat kunci voucher_enabled (Pengaturan → Fitur Opsional). Saat false, halaman voucher publik diblokir & link "Beli Voucher" disembunyikan. Default: aktif.