buat aplikasi billing untuk internal

Buat aplikasi enterprise modern bernama “TS SMART BILLING” (TSB) untuk ISP FTTH / RT RW Net profesional dengan sistem all-in-one berbasis web dan mobile.

==================================================
KONSEP UTAMA
==================================================

TS SMART BILLING adalah platform enterprise untuk ISP yang mencakup:
- Smart Billing
- CRM pelanggan
- Ticketing
- Finance
- Inventory Management
- GIS Fiber Map
- Monitoring jaringan
- Tracking teknisi
- GPS realtime
- WhatsApp automation
- MikroTik integration
- OLT monitoring
- Customer portal
- Speedtest Ookla
- WiFi management
- SLA monitoring
- Realtime dashboard

==================================================
IDENTITAS BRAND
==================================================

Nama:
TS SMART BILLING

Singkatan:
TSB

Tagline:
“Smart ISP Management System”

Warna:
- merah pekat
- putih
- hitam elegan
- abu modern

Style:
- modern
- premium
- elegant
- enterprise SaaS
- realtime monitoring

==================================================
UI/UX STYLE
==================================================

Gunakan:
- dark mode premium
- glassmorphism ringan
- clean modern dashboard
- floating card
- animated chart
- elegant sidebar
- smooth transition
- responsive mobile
- loading skeleton
- realtime animation
- toast modern

Referensi:
- Ubiquiti UISP
- Datadog
- Vercel
- Linear
- modern SaaS platform

==================================================
STACK WAJIB
==================================================

Frontend:
- Next.js 15 App Router
- TypeScript
- TailwindCSS
- shadcn/ui
- Framer Motion
- TanStack Table
- Recharts
- Zustand

Backend:
- Laravel 12 API
- Laravel Sanctum / JWT
- Redis Queue
- Scheduler
- Laravel Reverb

Database:
- PostgreSQL

Realtime:
- Redis
- Websocket

Maps:
- Leaflet
- OpenStreetMap

Mobile Teknisi:
- Flutter

Monitoring:
- MikroTik API
- SNMP
- OLT API integration

WhatsApp:
- WABlast API integration

==================================================
ROLE USER
==================================================

1. Superadmin
2. Helpdesk
3. Teknisi
4. Finance
5. Gudang
6. NOC
7. Pelanggan

Gunakan RBAC lengkap dengan middleware permission.

==================================================
AUTH & LOGIN SYSTEM
==================================================

Superadmin dapat:
- membuat akun user
- edit akun
- reset password
- nonaktifkan akun
- assign role
- melihat histori login
- force logout user

Gunakan:
- JWT auth
- bcrypt password
- refresh token
- session management
- audit log
- OTP reset password via WhatsApp

==================================================
AUTO LOGIN PELANGGAN
==================================================

Saat Helpdesk membuat pelanggan baru:

Contoh:
Nama:
Mejeruk Rendi

Sistem otomatis membuat:
username:
mejerukrendi

password default:
123456

Login otomatis:
- tersimpan database
- dikirim ke WhatsApp pelanggan
- bisa dicetak

Pelanggan dapat:
- mengganti password
- edit profile
- logout device lain

==================================================
FITUR SUPERADMIN
==================================================

Dashboard realtime:
- total pendapatan hari ini
- total pendapatan bulan ini
- total pelanggan aktif
- pelanggan suspend
- pelanggan overdue
- pelanggan offline
- grafik pemasangan
- grafik pendapatan
- grafik gangguan
- grafik churn pelanggan
- monitoring teknisi realtime
- monitoring inventory
- monitoring ODP/ODC/POP
- statistik area pelanggan
- statistik area gangguan
- major incident
- monitoring bandwidth realtime

Superadmin dapat:
- melihat omzet penuh
- melihat profit
- monitoring seluruh jaringan
- melihat GPS teknisi realtime
- melihat audit log
- melihat histori user
- melihat histori inventory

==================================================
FITUR HELPDESK
==================================================

Helpdesk dapat:
- input pelanggan baru
- edit pelanggan
- membuat tiket manual
- assign tiket
- reset password pelanggan
- ubah paket internet
- ubah SSID pelanggan
- ubah password WiFi pelanggan
- cek status ONU
- melihat permintaan isolir
- melakukan isolir pelanggan
- membuka isolir pelanggan

Helpdesk TIDAK dapat:
- melihat omzet
- melihat profit
- melihat laporan keuangan

==================================================
KONSEP INPUT PELANGGAN
==================================================

Konsep:
Saat pelanggan diinput oleh Helpdesk,
berarti teknisi sudah selesai pemasangan.

Tidak perlu menu pending instalasi.

==================================================
FIELD INPUT PELANGGAN
==================================================

Field wajib:
- nama pelanggan
- nomor HP
- alamat lengkap
- titik GPS
- sharelok
- paket internet
- ODP
- ODC
- POP
- serial number ONU
- nama teknisi pemasang

==================================================
VALIDASI SERIAL NUMBER ONU
==================================================

Saat serial number ONU diinput:
sistem otomatis:
- cek serial tersedia
- cek serial belum dipakai
- tampilkan detail ONU
- tampilkan status stok

Jika serial sudah dipakai:
- tampil error
- tidak boleh duplicate

==================================================
AUTO ASSIGN ONU KE PELANGGAN
==================================================

Saat pelanggan disimpan:
otomatis:
- ONU menjadi milik pelanggan
- status ONU berubah menjadi “TERPASANG”
- histori pemasangan tersimpan
- teknisi pemasang tersimpan
- lokasi pelanggan tersimpan

==================================================
AUTO POTONG STOK
==================================================

Saat pelanggan berhasil dibuat:
otomatis:
- stok ONU berkurang
- stok adaptor berkurang
- histori inventory tersimpan

Jika ONU berasal dari stok teknisi:
- stok teknisi otomatis berkurang

==================================================
FITUR TEKNISI
==================================================

Teknisi hanya dapat:
- melihat tiket sendiri
- melihat lokasi pelanggan
- melihat sharelok pelanggan
- melihat histori tiket sendiri

Teknisi TIDAK dapat:
- melihat omzet
- melihat total tagihan
- melihat laporan finance

==================================================
UPDATE TIKET VIA WHATSAPP
==================================================

Teknisi cukup update via grup WhatsApp.

Contoh:
OTW TCK-001
PROSES TCK-001
DONE TCK-001

Sistem otomatis:
- membaca pesan WA
- update status tiket
- menghitung SLA
- kirim notifikasi internal

==================================================
WA GROUP TEKNISI
==================================================

Saat tiket dibuat:
otomatis share ke grup teknisi.

Contoh:

🚨 TIKET BARU
ID: TCK-001
Nama: Ahmad
Area: Bulurejo
Keluhan: LOS merah

Konsep:
- grup khusus notifikasi
- minim spam
- hanya admin/bot yang kirim

==================================================
FITUR BILLING
==================================================

Billing berdasarkan tanggal pemasangan.

Contoh:
pasang tanggal 15
jatuh tempo setiap tanggal 15.

Reminder:
- hanya dikirim tepat hari jatuh tempo
- hanya 1x per hari
- anti spam

Jika pembayaran diterima:
otomatis:
- invoice lunas
- kirim struk WA
- cetak thermal
- aktifkan PPPoE MikroTik
- update masa aktif

==================================================
FITUR STRUK PEMBAYARAN
==================================================

Tombol:
“KIRIM & CETAK”

Sekali klik:
- kirim WA pelanggan
- print thermal
- generate PDF
- update invoice

Struk:
- logo TSB
- QR code invoice
- nomor invoice
- nominal pembayaran
- paket internet
- masa aktif

==================================================
FITUR FINANCE
==================================================

Finance menjadi pusat monitoring pembayaran.

Finance dapat:
- melihat pelanggan jatuh tempo
- melihat pelanggan overdue
- memberi toleransi pembayaran
- mengajukan isolir pelanggan
- approve pembayaran
- cetak struk
- kirim struk WA

Finance tidak dapat:
- melihat profit perusahaan

==================================================
FITUR TOLERANSI PEMBAYARAN
==================================================

Tambahkan menu:
“Toleransi Pembayaran”

Finance dapat:
- memberi tambahan hari toleransi
- memberi catatan toleransi
- menentukan tanggal akhir toleransi

Contoh:
- toleransi 3 hari
- alasan: pelanggan janji transfer

==================================================
NOTIF BELUM MEMBAYAR
==================================================

Sistem hanya memberi notif ke:
- dashboard Finance

Jangan kirim spam otomatis ke pelanggan.

Dashboard Finance:
- jatuh tempo hari ini
- overdue
- pelanggan toleransi
- pelanggan perlu isolir

==================================================
FITUR PERMINTAAN ISOLIR
==================================================

Tambahkan tombol:
“Ajukan Isolir”

Saat Finance klik:
otomatis:
- membuat permintaan isolir
- masuk ke dashboard Helpdesk
- status menjadi:
MENUNGGU ISOLIR

==================================================
FITUR ISOLIR HELPDESK
==================================================

Helpdesk hanya melaksanakan isolir.

Saat klik “Isolir”:
- PPPoE disable MikroTik
- status pelanggan menjadi:
TERISOLIR

Saat klik “Buka Isolir”:
- PPPoE enable MikroTik
- status pelanggan kembali aktif

==================================================
ALUR ISOLIR
==================================================

Pelanggan belum bayar
↓
Notif muncul di Finance
↓
Finance review pelanggan
↓
Finance klik “Ajukan Isolir”
↓
Permintaan masuk Helpdesk
↓
Helpdesk klik “Isolir”
↓
PPPoE disable MikroTik

==================================================
FITUR HISTORI ISOLIR
==================================================

Simpan:
- siapa mengajukan isolir
- siapa melakukan isolir
- tanggal isolir
- alasan isolir
- tanggal buka isolir

==================================================
STATUS PELANGGAN
==================================================

Status:
- aktif
- jatuh tempo
- overdue
- toleransi
- menunggu isolir
- terisolir

==================================================
FITUR INVENTORY PROFESSIONAL
==================================================

Inventory realtime:
- ONU
- adaptor
- kabel
- ODP
- splitter
- router
- fast connector

==================================================
FITUR BARANG MASUK GUDANG
==================================================

Gudang dapat:
- scan barcode
- scan QR
- input serial number manual
- upload foto serial number/barcode ONU

Contoh:
ZTEGC8A112233

Sistem otomatis:
- simpan serial number
- generate QR internal
- update stok realtime

==================================================
AUTO QR CODE
==================================================

Setiap barang memiliki:
- QR code
- barcode
- unique asset ID

Contoh:
TSB-ONU-000231

==================================================
TRACKING ONU
==================================================

Klik ONU tampil:
- serial number
- pelanggan terpasang
- alamat pelanggan
- teknisi pemasang
- tanggal pemasangan
- histori perpindahan
- histori gangguan

==================================================
STOK TEKNISI
==================================================

Setiap teknisi memiliki stok pribadi.

Contoh:
- ONU 10 pcs
- adaptor 10 pcs
- kabel 300 meter

Saat digunakan:
otomatis berkurang.

==================================================
MUTASI BARANG
==================================================

Gudang dapat:
- kirim barang ke teknisi
- transfer antar gudang
- retur barang

Teknisi wajib approve penerimaan.

==================================================
FITUR GIS FIBER MAP
==================================================

Peta realtime:
- pelanggan
- ODP
- ODC
- POP
- jalur FO
- teknisi realtime

Klik pelanggan:
- nama
- nomor HP
- status ONU
- histori tiket
- histori pembayaran

Klik ODP:
- kapasitas
- pelanggan aktif
- pelanggan offline

Warna:
- hijau = online
- merah = offline
- kuning = gangguan
- abu = suspend

==================================================
GPS TEKNISI REALTIME
==================================================

Superadmin dapat:
- melihat posisi realtime teknisi
- histori perjalanan
- teknisi idle
- tiket yang sedang dikerjakan

Gunakan websocket realtime tracking.

==================================================
FITUR MONITORING
==================================================

Monitoring realtime:
- MikroTik
- OLT
- ONU
- bandwidth
- CPU router
- RAM router
- backup link
- pelanggan offline
- flapping ONU

Jika mass outage:
otomatis:
- deteksi area gangguan
- buat major incident
- kirim notif WA grup teknisi

==================================================
FITUR SPEEDTEST OOKLA
==================================================

Integrasikan speedtest Ookla:
- pelanggan
- teknisi
- helpdesk
- superadmin

Tampilkan:
- ping
- jitter
- download
- upload

Simpan histori:
- user
- lokasi
- waktu
- hasil

==================================================
FITUR WIFI MANAGEMENT
==================================================

Pelanggan dapat:
- mengganti nama WiFi
- mengganti password WiFi
- restart WiFi

Integrasikan:
- MikroTik API
- ONU API jika support

Validasi:
- password minimal 8 karakter

==================================================
PORTAL PELANGGAN
==================================================

Portal pelanggan modern:
- dashboard internet
- status online/offline
- tagihan
- invoice
- histori pembayaran
- histori gangguan
- restart internet
- speedtest
- ubah SSID
- ubah password WiFi
- ganti password akun
- lihat masa aktif

==================================================
HALAMAN WAJIB
==================================================

- login
- dashboard superadmin
- dashboard helpdesk
- dashboard teknisi
- dashboard finance
- dashboard gudang
- dashboard pelanggan
- halaman billing
- halaman GIS map
- halaman monitoring
- halaman inventory
- halaman speedtest
- halaman pengaturan WiFi
- halaman tiket
- halaman laporan
- halaman user management
- halaman overdue pelanggan
- halaman toleransi pembayaran
- halaman permintaan isolir
- halaman histori isolir

==================================================
DATABASE
==================================================

Generate:
- ERD lengkap
- migration Laravel
- relasi database
- seed dummy data

Tabel:
- users
- roles
- permissions
- customers
- invoices
- payments
- tickets
- ticket_logs
- technicians
- gps_logs
- devices
- onu_devices
- mikrotik_routers
- inventory_items
- inventory_categories
- inventory_serials
- inventory_mutations
- inventory_transactions
- warehouse_stocks
- technician_stocks
- wifi_settings
- wifi_change_logs
- speedtest_logs
- login_logs
- outages
- maps
- odc
- odp
- pop_sites
- sla_logs
- whatsapp_logs
- notifications
- payment_tolerance
- isolation_requests
- isolation_logs
- overdue_customers

==================================================
KEAMANAN
==================================================

Gunakan:
- JWT auth
- bcrypt password
- RBAC
- audit log
- rate limiting
- CSRF protection
- API validation
- secure upload
- role middleware

==================================================
OUTPUT YANG DIINGINKAN
==================================================

Generate:
- struktur folder enterprise
- backend Laravel API lengkap
- frontend Next.js modern
- Flutter teknisi app
- reusable component system
- dark mode premium
- responsive mobile
- websocket realtime
- API MikroTik integration
- API WABlast integration
- QR generator
- barcode scanner integration
- realtime inventory
- modern charts
- modern sidebar
- loading skeleton
- clean architecture
- scalable enterprise structure
- reusable hooks
- TypeScript strict mode
- modular architecture