DOKUMEN RESMI PANDUAN PENGGUNAAN

BUKU PANDUAN PENGGUNAAN & ADMINISTRASI SISTEM NODERA

Petunjuk Lengkap Pengoperasian Billing Otomatis ISP, Integrasi MikroTik RouterOS, Sinkronisasi 2 Arah, Manajemen Pelanggan PPPoE, Cetak Voucher Hotspot, dan Jaringan Fiber Optik (OLT / TR-069)

Penerbit / Pengembang Sistem: NODERA Billing Platform (https://dgtlnetsolution.com)

Peruntukan Dokumen: Pemilik Usaha ISP, RT/RW Net, NOC, Teknisi & Kasir

Kompatibilitas RouterOS: MikroTik RouterOS v6.x & RouterOS v7.x (API / API-SSL)

Status Dokumen: Resmi • Berlaku untuk seluruh pengguna aktif

DAFTAR ISI PANDUAN

1. Alur Mulai Cepat (Onboarding 5 Tahap) Bab 1 2. Panduan Pengisian Semua Form Input Bab 2 3. Kamus & Penjelasan Seluruh Menu Bab 3 4. Arsitektur Sinkronisasi 2 Arah Bab 4 5. Pengaturan Jaringan & Router MikroTik Bab 5 6. Manajemen Paket & Pelanggan PPPoE Bab 6 7. Invoice, Notifikasi WA & Auto-Isolir Bab 7 8. Pembuatan & Cetak Voucher Hotspot Bab 8 9. Fiber OLT, TR-069 GenieACS & GIS Bab 9 10. QRIS Otomatis, Kasir & Portal Mandiri Bab 10 11. Tanya Jawab (FAQ) & Solusi Kendala Bab 11 12. Bantuan Teknis & Layanan Bantuan Bab 12

1 ALUR MULAI CEPAT (ONBOARDING 5 LANGKAH)

Ikuti 5 tahapan berurutan berikut agar seluruh infrastruktur jaringan MikroTik dan otomatisasi penagihan Anda langsung berjalan aktif:

Tahap	Nama Langkah	Menu Aplikasi	Tindakan yang Dilakukan
Langkah 1	Profil Usaha & Rekening Bank	`Sistem → Pengaturan Sistem`	Upload logo brand ISP Anda, isi nama usaha, nomor WhatsApp Customer Service, dan input nomor rekening bank tujuan transfer tagihan.
Langkah 2	Hubungkan Router MikroTik	`MikroTik → Router MikroTik`	Masukkan IP/VPN Remote, username/password API (Port 8728), klik Tes Koneksi lalu klik Tarik Profil / Sinkronisasi.
Langkah 3	Buat Paket Langganan	`Billing → Paket Langganan`	Buat paket bulanan (contoh: Home 10 Mbps Rp 150.000) dan tautkan ke PPP Profile kecepatan MikroTik terkait.
Langkah 4	Input Data Pelanggan	`Billing → Pelanggan`	Masukkan data nama, nomor WhatsApp, serta akun PPPoE. Sistem otomatis membuat Secret PPPoE di RouterOS detik itu juga!
Langkah 5	Otomatisasi Berjalan	`Billing → Invoice`	Tagihan bulanan terbit otomatis, pengingat WA terkirim, auto-isolir jika telat bayar, dan auto-buka isolir 0 detik saat lunas.

2 PANDUAN LENGKAP PENGISIAN SEMUA FORMULIR INPUT

Berikut adalah kamus parameter kolom demi kolom yang menjelaskan fungsi, format pengisian, dan contoh nilai pada seluruh formulir utama di aplikasi NODERA:

Form Tambah Router MikroTik (Menu: MikroTik → Router MikroTik)

Nama Kolom	Status	Contoh Isian	Penjelasan Fungsi & Cara Pengisian
`Nama Router`	Wajib	`Router-Utama`, `CCR1009-Core`	Nama pengenal bebas untuk membedakan router di dashboard.
`Host / IP Publik / VPN`	Wajib	`103.11.41.43` atau `id-1.nodera.net`	Alamat IP publik statis atau domain VPN Remote NODERA. *Jangan sertakan tanda titik dua atau port di kolom ini.
`API Port MikroTik`	Wajib	`8728` (Lokal/Publik) atau `18728` (VPN)	Port service API RouterOS. Default port `8728` (atau `8729` untuk API-SSL). Jika pakai VPN Remote, isi port forwarding remote Anda.
`Username API`	Wajib	`admin` atau `nodera`	User login MikroTik yang memiliki policy group read, write, api.
`Password API`	Opsional	`KatasandiRahasia123`	Password user login API MikroTik tersebut.
`Lokasi / Wilayah`	Opsional	`Ruang Server NOC`	Keterangan lokasi fisik penempatan router.

💡 Panduan Buat User API di Winbox: Buka Winbox → System → Users → Klik (+) → Name: nodera, Group: full → Apply & OK. Di IP → Services pastikan service api aktif di port 8728.

Form Tambah Pelanggan Baru (Menu: Billing → Pelanggan)

Nama Kolom	Status	Contoh Isian	Penjelasan Fungsi & Cara Pengisian
`Nama Lengkap`	Wajib	`Budi Santoso`	Nama pelanggan atau kepala keluarga pemilik sambungan.
`Nomor WhatsApp`	Wajib	`081234567890`	Nomor WA aktif untuk pengiriman invoice dan pengingat jatuh tempo otomatis.
`Jenis Koneksi`	Wajib	`PPPoE` atau `Static IP`	Pilih PPPoE untuk modem rumahan atau Static IP untuk perangkat IP statis.
`Username & Password PPPoE`	Wajib	`budi_net` / `123456`	Akun dial-up modem ONT. Sistem seketika membuatkan secret ini di MikroTik!
`Router & Paket`	Wajib	`CCR1009` • `Home 10 Mbps`	Pilih router yang melayani dan paket kecepatan bulanan pelanggan.
`Titik Tiang ODP & Port`	Opsional	`ODP-01` • `Port 3`	Pilih tiang ODP tempat kabel dropcore dicolokkan untuk pendataan GIS.
`Tanggal Jatuh Tempo & Isolir`	Wajib	`Tgl 20` (Tempo) • `Tgl 25` (Isolir)	Tanggal terbit tagihan bulanan dan tanggal batas akhir sebelum auto-isolir.

Form Tambah Paket Langganan (Menu: Billing → Paket)

Nama Kolom	Status	Contoh Isian	Penjelasan Fungsi & Cara Pengisian
`Nama Paket`	Wajib	`Home 10 Mbps Unlimited`	Nama paket yang tertera di lembar invoice tagihan.
`Harga Bulanan (Rp)`	Wajib	`150000`	Nominal tarif tagihan yang ditagihkan per bulan (tanpa titik).
`Profil MikroTik Normal`	Wajib	`10Mbps`	Nama PPP Profile di MikroTik saat pelanggan dalam status aktif/lunas.
`Profil MikroTik Isolir`	Wajib	`isolir` atau `expired`	Nama PPP Profile di MikroTik saat pelanggan menunggak pembayaran.
`Isolir Otomatis`	Otomatis	`Aktif (ON)`	Saklar agar sistem memutus otomatis koneksi saat melewati tanggal batas isolir.

3 KAMUS & PENJELASAN LENGKAP SEMUA MENU APLIKASI

Penjelasan fungsi dari seluruh modul menu yang tersedia pada navigasi aplikasi NODERA:

Grup & Nama Menu	URL Endpoint	Kegunaan & Fitur Utama
Dashboard	`/dashboard`	Ringkasan total omzet, grafik live traffic, pelanggan aktif vs terisolir, router online, dan tagihan jatuh tempo.
Pelanggan	`/admin/billing/customers`	Database pelanggan PPPoE & Static IP, filter isolir, redaman ODP, dan isolir instan 0 detik.
Invoice Tagihan	`/admin/billing/invoices`	Daftar tagihan bulanan, tombol generate tagihan massal, kasir bayar tunai, cetak nota PDF, dan kirim WA.
Paket Langganan	`/admin/billing/packages`	Manajemen tarif internet bulanan dan mapping kecepatan PPP Profile MikroTik.
Payment Gateway	`/admin/payments/gateway`	Integrasi Midtrans, TriPay, Duitku, Xendit untuk pembayaran otomatis QRIS & Virtual Account.
Router MikroTik	`/admin/mikrotik/routers`	Kelola router, tes port API 8728, telemetri Suhu/Voltase/CPU, dan Live Traffic 120 FPS.
Studio Script & Tools	`/tools/mikrotik`	Generator Load Balance PCC Multi-ISP, Pisah Game, Pisah Streaming, Bypass Speedtest.
Daftar Voucher	`/admin/voucher`	Generator kode voucher massal, cetak kertas A4/F4 (Grid 15/24/36) dengan QR code dan struk POS Bluetooth.
OLT & ONU	`/admin/olt`	Manajemen OLT GPON/EPON (ZTE, Huawei, HSGQ, V-Sol), Port PON, dan Redaman Optik (RX Power dBm) live.
GenieACS TR-069	`/admin/genieacs`	Remote modem ONT pelanggan (ganti nama SSID WiFi, ganti password, reboot ONT jarak jauh).
Mapping Network & GIS	`/admin/map`	Peta geografis tiang ODP, ODC, jalur kabel fiber optik, dan ketersediaan port.
VPN Remote	`/admin/vpn`	Akses aman router & OLT tanpa perlu IP publik statis dari jaringan modem GSM/Starlink.
Notifikasi WhatsApp	`/admin/whatsapp-templates`	Blast pesan invoice H-3/H-1/Hari H dan broadcast pengumuman perbaikan massal.
Laporan Keuangan	`/admin/finance` • `/expenses`	Arus kas masuk keluar (cashflow), laba rugi, dan pencatatan biaya operasional (upstream, sewa tiang).
Pengaturan Sistem	`/admin/my-settings`	Profil nama usaha ISP, upload logo brand, nomor rekening bank, dan manajemen backup.

4 SISTEM SINKRONISASI 2 ARAH (TWO-WAY SYNC)

NODERA menggunakan arsitektur Two-Way Realtime Sync yang menjamin konsistensi data antara database web dengan perangkat RouterOS dan OLT fisik:

Aplikasi Web NODERA
Database Master

←———————→ Two-Way Sync

MikroTik RouterOS & OLT
Perangkat Hardware

1. Arah Push Sync (Aplikasi Web → MikroTik RouterOS)

Kapan Terjadi: Saat menambah/mengedit pelanggan, merubah paket langganan, atau saat router baru menyala kembali setelah mati listrik.

Sistem otomatis membuat / mengupdate akun /ppp/secret di MikroTik lengkap dengan Username, Password, dan Profil Bandwidth.
Untuk pelanggan Static IP → Otomatis inject IP-MAC ARP Binding dan Simple Queue Rate Limit.
Voucher Hotspot yang dibuat di web otomatis ter-push menjadi Hotspot Users aktif di RouterOS.

2. Arah Pull Sync (MikroTik Winbox → Database Web)

Kapan Digunakan: Jika sebelumnya Anda sudah memiliki ratusan data pelanggan di Winbox MikroTik atau jika teknisi menambahkan secret langsung di lapangan.

Buka menu Billing → Pelanggan, klik tombol “Tarik Profil / Sinkronisasi”.
Sistem membaca seluruh data live dari /ppp/secret/print dan profil bandwidth MikroTik.
Data otomatis masuk ke database NODERA tanpa duplikasi akun (Smart Idempotent Import).

⚡ Sinkronisasi Isolir 0 Detik: Saat jatuh tempo lewat batas → Profil PPPoE otomatis diubah ke isolir tanpa memutus pelanggan lain. Begitu tagihan dibayar lunas → Sistem seketika mengembalikan koneksi pelanggan ke normal dalam hitungan milidetik tanpa perlu restart router!

5 CETAK VOUCHER HOTSPOT & PEMBAYARAN QRIS

Panduan operasional pencetakan voucher WiFi serta integrasi pembayaran digital otomatis:

Format Pencetakan Voucher Hotspot

Format Kertas A4 / F4 (Grid 15, 24, 36 per lembar): Cocok untuk penjualan di warung dan konter pulsa. Dilengkapi logo brand ISP Anda, QR code login otomatis (scan kamera langsung masuk tanpa ketik username), dan garis putus-putus siap potong gunting.
Format Thermal POS Bluetooth (58mm / 80mm): Cetak instan per lembar dari smartphone atau laptop kasir ke printer thermal portabel.

Pembayaran QRIS Otomatis & Kasir Lapangan

Payment Gateway QRIS & Virtual Account: Terhubung ke Midtrans, TriPay, Duitku, Xendit. Pelanggan scan QRIS dari GoPay, Dana, OVO, ShopeePay, atau BCA Mobile → Tagihan seketika lunas dan isolir terbuka detik itu juga.
Aplikasi Kolektor Keliling (/kolektor/dashboard): Teknisi atau penagih lapangan dapat mencatat pembayaran tunai langsung di rumah pelanggan dan mencetak struk tanda terima resmi melalui printer thermal portabel.
Portal Pelanggan Self-Service (/portal/login): Pelanggan dapat mengecek masa aktif langganan, mengunduh nota PDF, dan membayar tagihan secara mandiri.

6 PERTANYAAN YANG SERING DIAJUKAN (FAQ)

Q: Apakah saya harus menyediakan server komputer fisik yang hidup 24 jam?

A: Tidak perlu! Sistem NODERA berjalan sepenuhnya di Cloud. Anda cukup memiliki router MikroTik yang terhubung internet. Panel admin dapat diakses dari browser HP atau Laptop kapan saja.

Q: Bagaimana jika router MikroTik saya tidak memiliki IP Publik Statis?

A: Anda dapat menggunakan fitur VPN Remote NODERA (menu Fiber & OLT → VPN Remote). Router MikroTik Anda tetap bisa terhubung lancar dan aman ke sistem meskipun menggunakan jaringan modem GSM, Starlink, atau IP dinamik biasa.

Q: Apakah data pelanggan lama di Winbox bisa dimasukkan secara otomatis?

A: Ya! Cukup sambungkan router di menu MikroTik → Router MikroTik, lalu klik tombol “Tarik Profil / Sinkronisasi”. Seluruh PPP Profiles, Secrets, dan data pengguna akan otomatis tertarik masuk ke database NODERA dalam hitungan detik tanpa duplikasi.