Satu panduan untuk seluruh pekerjaan NXS.
Dari deploy Cloudflare hingga mengelola WLB, menghubungkan HP staff, memproses deposit, dan memulihkan layanan setelah restart.
Cari kata dengan Ctrl + F. Gunakan navigasi kiri untuk berpindah bagian. Pada HP, daftar isi berada di atas.
Mulai di sini
Pilih pekerjaan Anda, lalu ikuti urutan yang sesuai.
Status fitur pada versi ini
| Bagian | Keterangan |
|---|---|
| Panel web, IP, akun dan 2FA | Tersedia. Akses aktual mengikuti izin tiap akun. |
| Pembaca bank di pusat | myBCA, BRImo, Livin’ dan wondr memakai profil dan pengunci sesuai rekening. |
| Pembaca di PC staff versi 2 | Kode serta simulasi tersedia. Login → mutasi → logout nyata di PC staff berbeda belum dinyatakan lulus. Uji tiap bank/HP diperlukan. |
| Withdraw | Menu baca tiket dan pengaturan tersedia sesuai izin. Pengiriman dana melalui panel web belum aktif (tombol kirim belum diaktifkan). |
| Auto Transfer | Dihapus dari alur web. Jangan menganggapnya aktif. |
Panduan disusun pada 19 Oktober 2026. Nama menu Cloudflare dapat berubah. Contoh domain mengikuti pemasangan Anda: bolehcobadong.com.
Cara sistem bekerja
Bedakan panel, mesin pusat, PC staff dan HP.
| Komponen | Tugas | Harus menyala? |
|---|---|---|
| PC pusat | Database akun, jurnal, pencocokan tiket, Sheets, sesi panel WLB, antrean dan approval. | Ya, selama pekerjaan berlangsung. |
| Cloudflare Pages | Alamat web dan penghubung bertanda tangan ke pusat. Bukan tempat menjalankan Python/ADB. | Dikelola Cloudflare; pusat tetap diperlukan. |
| cloudflared | Menyambungkan pusat ke Cloudflare sebagai layanan Windows. | Ya. |
| PC staff | Browser untuk bekerja; jika HP dipasang di sini, jalankan penghubung versi 2 untuk membaca bank. | Ya, saat memakai HP tersebut. |
| HP | Aplikasi bank dan sumber mutasi. Satu HP tidak dipakai dua tugas bersamaan. | Ya, USB dan izin debugging siap. |
Alamat yang benar
| Alamat | Dipakai untuk |
|---|---|
| https://bolehcobadong.com | Panel online dari pusat maupun jaringan staff. |
| http://127.0.0.1:8787 | Panel lokal, hanya pada PC pusat itu sendiri. Di PC staff, 127.0.0.1 menunjuk PC staff. |
http://127.0.0.1:8788 | Tujuan Tunnel. Akses langsung browser ditolak karena tidak ada tanda tangan gateway. |
https://nxs-origin.bolehcobadong.com | Origin khusus gateway. Tidak dipakai login pengguna. |
Pengaturan yang disimpan melalui browser PC lain masuk ke pusat yang sama. Menambah WLB tidak perlu menginstal bot penuh pada setiap PC staff. Database utama belum dipindahkan ke database online.
Daftar file
File deploy, file pusat dan file staff memiliki fungsi berbeda.
| File | Lokasi / tindakan |
|---|---|
NXS-PAGES-READY.zip | Unggah ke project Pages. Ini pilihan untuk project nxs-panel-coba Anda. |
NXS-WORKERS-READY.zip | Alternatif deployment Worker terpisah dengan Wrangler. Tidak diperlukan jika memakai Pages di atas. |
WEB-PUSAT.bat | Jalankan di pusat untuk panel lokal port 8787. |
SETUP-CLOUDFLARE.bat | Mengatur domain panel dan secret penghubung di pusat. Bukan dijalankan ulang setiap hari. |
WEB-CLOUDFLARE.bat | Jalankan di pusat untuk gateway port 8788. |
NXS-PENGHUBUNG-STAFF.zip | Salin/unduh ke PC staff yang menerima HP USB. Gunakan versi 2. |
SIAPKAN-PC-STAFF.bat | Persiapan Python pembaca di staff, satu kali per instalasi. |
PENGHUBUNG-STAFF.bat | Membuka penghubung staff setiap mulai bekerja. |
CEK-KESIAPAN.bat | Diagnostik konfigurasi pusat; tidak membuktikan bahwa semua login bank sudah lulus. |
Folder pusat saat ini: C:\Users\Panda\Downloads\nxs. Launcher pusat menggunakan lingkungan Python pendamping ..\CEK MUTASI HP\mybca-monitor\.venv jika tersedia. Memindahkan folder NXS saja ke laptop baru belum tentu membawa seluruh dependensi.
PC Pusat
Menyalakan, memeriksa, dan menghentikan pusat sementara.
Setelah restart / setiap awal kerja
- Hubungkan laptop ke internet dan listrik. Pastikan tanggal, jam dan zona waktu benar.
- Buka folder NXS, jalankan
WEB-PUSAT.bat. Biarkan jendelanya berjalan. - Jalankan
WEB-CLOUDFLARE.bat. Biarkan berjalan juga. Jika port sedang digunakan, periksa server yang sudah aktif; jangan membuka banyak salinan. - Buka panel lokal 8787. Login kembali jika sesi berakhir.
- Periksa layanan Cloudflared agent pada aplikasi Windows Services. Instalasi service menggunakan startup Automatic; periksa bahwa statusnya Running.
- Buka Cloudflare → Networking → Tunnels → NXS-PUSAT. Status yang diinginkan Healthy.
- Buka domain panel. Periksa WLB, USB dan status pending. Menjalankan dua file web tidak otomatis berarti bot per WLB sudah Mulai.
Menyambungkan ulang Tunnel
- Tekan Windows, ketik cmd.
- Klik kanan Command Prompt → Run as administrator → Yes. Pilihan itu diklik, bukan diketik ke jendela hitam.
- Untuk memeriksa, ketik
sc query cloudflared. Jika perlu sambungkan ulang, gunakan perintah berikut di jendela Administrator:
net stop cloudflared net start cloudflared
Tunggu sekitar 30 detik lalu lihat status Tunnel dan refresh domain. Status service Running saja belum menjamin koneksi ke Cloudflare Healthy.
Selama bekerja
- Atur Windows agar tidak sleep selama bot dipakai. Tutup layar laptop hanya jika pengaturan daya tidak membuatnya sleep.
- Jangan menutup semua tab/profil browser panel penjualan jika sesi situs bergantung pada tab yang tetap terbuka.
- Jangan menjalankan bot lain pada HP yang sedang dipakai NXS. Kunci NXS tidak menjamin aplikasi pihak lain ikut mematuhinya.
Berhenti dengan rapi
- Stop tiap WLB yang sedang berjalan. Tunggu tugas bank selesai dan logout terkonfirmasi.
- Periksa Perlu ditangani dan tugas HELD/penulisan belum pasti.
- Hentikan penghubung staff setelah tugas selesai. Baru tutup layanan web atau matikan pusat.
Restart tidak menghapus konfigurasi. Reset Windows/instal ulang berbeda: data terenkripsi terikat akun Windows dan perlu prosedur pemulihan, bukan sekadar salin folder.
Deploy Cloudflare
Urutan lengkap untuk Pages + domain + Tunnel pada pemasangan ini.
_worker.js sebagai gateway.1 · Siapkan konfigurasi pusat
- Jalankan
SETUP-CLOUDFLARE.batdi PC pusat. - Alamat panel:
https://bolehcobadong.com, tanpa path. - Pada pemasangan pertama saja klik Buat secret lalu Simpan. Jika secret sudah tersimpan, jangan membuat secret baru hanya karena restart.
- Klik Salin secret untuk menempel langsung ke Cloudflare. Secret ini berbeda dari password akun, token Tunnel dan kode authenticator.
- Jalankan
WEB-CLOUDFLARE.bat.
2 · Atur Production variables
Cloudflare → Workers & Pages → nxs-panel-coba → Settings → Variables and secrets. Pilih Production. Klik + Add untuk setiap baris:
| Type | Name | Value |
|---|---|---|
| Text | NXS_PUBLIC_ORIGIN | https://bolehcobadong.com |
| Text | NXS_BACKEND_ORIGIN | https://nxs-origin.bolehcobadong.com |
| Secret | NXS_PROXY_SECRET | Tempel nilai Salin secret dari aplikasi lokal. Tidak dicantumkan dalam panduan. |
Simpan setiap isian. Jika secret diganti, perbarui kedua sisi dan restart server 8788. Perubahan variables perlu deployment Production baru agar digunakan.
3 · Upload Pages
- Buka project Pages → Deployments → Create deployment / Create a new deployment.
- Pilih Production. Unggah
NXS-PAGES-READY.zip, lalu Save and Deploy. - Isi root ZIP harus mencakup
_worker.jsdan_routes.json; jangan menambahkan lapisan folder luar. - Settings → Runtime → Fail open / closed: gunakan Fail closed jika pengaturan tersedia.
- Custom domains → tambahkan
bolehcobadong.comjika belum ada, ikuti instruksi DNS sampai Active. Domain harus berada pada akun yang Anda kelola.
Jika domain baru ditambahkan ke Cloudflare, nameserver diganti pada registrar sesuai pasangan yang diberikan untuk akun tersebut; jangan menyalin nameserver acak. Import DNS hanya menerima file zona DNS, bukan ZIP panel. Salin record situs/email lama yang masih diperlukan sebelum mengganti DNS.
4 · Pasang Tunnel di pusat
- Cloudflare → Networking → Tunnels. Pada tampilan lain dapat masuk melalui Zero Trust → Deploy a tunnel.
- Create Tunnel → Cloudflared jika diminta → nama NXS-PUSAT.
- Pilih Windows → 64-bit. Unduh installer
cloudflared-windows-amd64.msidan jalankan. - Tutup Command Prompt lama, buka yang baru. Ketik
cloudflared --version. Nomor versi harus muncul. - Buka Command Prompt sebagai Administrator melalui menu Start. Pastikan judulnya Administrator: Command Prompt.
- Klik ikon Salin perintah instalasi pada Cloudflare, tempel ke jendela Administrator dan Enter. Perintah itu berisi token; jangan mengirimkannya melalui chat/screenshot.
- Tunggu installed successfully, kemudian pastikan Tunnel Healthy pada dashboard.
5 · Buat published application route
Klik NXS-PUSAT → + Add route → Published application. Ini bukan Private CIDR, Private hostname, atau halaman Routes jaringan umum.
| Kolom | Isian |
|---|---|
| Subdomain | nxs-origin |
| Domain | bolehcobadong.com |
| Path | Kosong |
| Service URL | http://127.0.0.1:8788 |
Klik Add route. Jika UI memisahkan type dan URL, pilih HTTP lalu isi 127.0.0.1:8788. Jangan mengarahkan domain panel utama langsung ke 8788; domain utama tetap melalui Pages, origin melalui Tunnel.
6 · Izin IP dan uji akses
- Di panel lokal, Superadmin membuka Izin IP dan memasukkan IP publik jaringan kantor/staff beserta nama dan remarks.
- Buka domain utama dari jaringan yang diizinkan; login dan cek 2FA.
- Pastikan jaringan yang tidak diizinkan ditolak sebelum halaman login.
- Cek panel, data WLB dan akses akun. Untuk uji sambungan awal, tidak perlu melakukan approval/transfer nyata.
Alternatif Worker terpisah
Hanya jika sengaja memilih Worker: ekstrak NXS-WORKERS-READY.zip, sesuaikan nama project pada wrangler.jsonc, login Wrangler lalu deploy. Pasang tiga variabel dan custom domain yang sama. Jangan men-deploy ZIP Worker sebagai aset HTML biasa dan jangan menimpa route domain Pages tanpa rencana migrasi.
Referensi: Pages Direct Upload · Setup Tunnel · Pages advanced mode.
PC Staff
Pasang penghubung hanya pada komputer tempat HP USB digunakan.
Persiapan satu kali
- Pasang Python 3 untuk Windows dan Android Platform Tools/ADB dari sumber resmi. Aktifkan USB debugging pada HP.
- Di PC staff, buka domain panel lalu menu PC Staff → Unduh aplikasi penghubung. Alternatif: salin ZIP terbaru dari pusat.
- Ekstrak
NXS-PENGHUBUNG-STAFF.zipke folder milik staff. Jangan menjalankannya dari dalam ZIP. - Jalankan
SIAPKAN-PC-STAFF.bat. Tunggu selesai. Script membuat.venvdan memasang pustaka Python; tidak memasang Python atau ADB secara otomatis. - Hubungkan HP via USB. Buka Command Prompt dan jalankan
adb devices. Status harus device. Serial bukan nomor rekening atau nomor HP.
Pairing oleh Superadmin
- Pastikan akun pemilik PC aktif, memiliki izin baca WLB + sinkron tiket, dan ditugaskan ke WLB yang akan dibaca. Atur dari Staff dan penugasan WLB.
- Superadmin membuka menu PC Staff → Tambah PC Staff.
- Isi nama mudah dikenali, contoh PC Staff Lantai 2, pilih pemilik akun.
- Alamat HTTPS panel pusat:
https://bolehcobadong.com. Jangan memakai localhost atau alamat 127.0.0.1. - Isi serial USB persis dari adb devices, satu serial per baris. Satu serial hanya boleh punya satu PC staff aktif.
- Klik Buat penghubung, unduh file pairing yang ditampilkan sekali. Berikan hanya kepada pemilik PC itu.
- Tambahkan IP publik jaringan staff pada Izin IP. Alamat lokal seperti 192.168.x.x biasanya bukan IP yang dilihat domain publik.
Hubungkan di komputer staff
- Jalankan
PENGHUBUNG-STAFF.bat. - Klik Impor pairing dan pilih JSON dari Superadmin. Konfigurasi disimpan terenkripsi pada akun Windows staff itu.
- Jika ADB tidak ada di PATH, isi lokasi lengkap
adb.exepada penghubung. - Klik Hubungkan. Di panel pusat buka PC Staff → Perbarui status.
- Pastikan PC ONLINE, USB Tersambung, dan Pembaca remote terhubung. ONLINE saja tidak membuktikan login bank berhasil.
- Pada pengaturan bank WLB, pilih/isi serial yang sama, simpan login dan Sheets, lalu uji satu rekening dahulu.
Setelah restart PC staff
Sambungkan HP, jalankan PENGHUBUNG-STAFF.bat, klik Hubungkan. Tidak perlu impor pairing lagi selama akun Windows dan konfigurasinya sama. Penghubung saat ini tidak dijanjikan otomatis aktif saat Windows menyala.
Batasan pembaca remote
- Satu PC staff mengerjakan satu tugas bank pada satu waktu. PC staff berbeda dapat membaca bersamaan; approval pusat tetap satu per satu per WLB.
- Tugas maksimal 15 menit. Tugas diambil sekali; kegagalan/koneksi hilang tidak memicu login ulang otomatis.
- Pusat menyimpan antrean terenkripsi, lalu menghapus payload login saat tugas diambil. Hasil maksimal 2 MB dikirim dalam potongan; hasil tidak dipotong diam-diam.
- Login digunakan sementara di memori PC staff. Administrator atau malware pada PC itu dapat membaca memori. Jangan memakai komputer yang tidak dipercaya.
- myBCA membutuhkan profil selector untuk serial HP yang sudah diverifikasi. Profil HP lain tidak otomatis cocok.
- Cabut akses PC saat tidak digunakan. Serial yang aksesnya dicabut tidak otomatis dialihkan ke pembacaan lokal.
Menu penghubung tidak memberikan shell jarak jauh atau akses transfer. Memasang lapisan Cloudflare Access tambahan perlu autentikasi mesin untuk agen; versi ini belum mengirim service-token Access.
Staff, izin dan 2FA
Role menentukan tingkatan; centang akses menentukan izin masing-masing orang.
| Role | Siapa yang dapat dikelola? |
|---|---|
| Superadmin | Akses penuh dan pengelolaan seluruh tingkat sesuai pengaman sistem. |
| Supervisor | PIC dan Staff, jika memiliki izin mengelola akun/akses. |
| PIC | Staff, jika memiliki izin mengelola akun/akses. |
| Staff | Tidak mengelola akses akun lain. |
Non-Superadmin tidak dapat mengelola orang setingkat/lebih tinggi, mengubah akses sendiri untuk menaikkan hak, atau memberikan izin yang tidak dimilikinya. Label Supervisor/PIC tidak otomatis memberikan seluruh menu. Izin disimpan per akun.
Menambah anggota
- Masuk Staff → Kelola Staff dengan akun yang berwenang.
- Buka formulir tambah anggota, isi username, nama, role dan password awal. Jangan memakai password bawaan yang sama untuk semua orang.
- Buka kelompok role pada daftar anggota, pilih anggota lalu Akses. Centang hanya kebutuhan orang tersebut dan simpan.
- Buka WLB terkait → bagian Penanggung jawab/penugasan. Pilih anggota serta posisinya, lalu Simpan penugasan.
- Staff login dari domain, memasang authenticator, lalu mengganti password sendiri melalui menu Staff.
Arti akses penting
| Kelompok | Dampak |
|---|---|
| Lihat WLB | Membaca pending/data WLB sesuai penugasan. |
| Login panel | Meminta browser panel WLB dibuka di PC pusat; bukan membuka sesi panel bank di browser staff. |
| Approve deposit + sinkron tiket | Pemrosesan tiket dan pencatatan. Approval memerlukan pencatatan yang sesuai. |
| Kontrol mutasi | Menjalankan/menghentikan proses sesuai izin. |
| Atur WLB & bank | Mengubah link, rekening, device, login dan tujuan Sheets. Berikan hanya ke pengelola yang dipercaya. |
| Kelola WLB | Tambah/arsip WLB. WLB Utama dilindungi dari pengarsipan. |
| Kelola akun / akses | Mengelola bawahan sesuai tingkatan dan izin sendiri. |
| Semua WLB | Membuka cakupan tanpa penugasan individual. Hindari jika staff hanya memegang WLB tertentu. |
| Action Log / lihat Withdraw | Melihat jurnal atau tiket sesuai izin; bukan berarti bisa mengirim uang. |
Login pertama dengan authenticator
- Masukkan username dan password pada panel.
- Jika diminta aktivasi, scan QR menggunakan aplikasi authenticator atau masukkan kunci pemasangan secara manual.
- Masukkan kode 6 digit untuk mengonfirmasi. Kotak enam digit dapat diisi satu per satu atau ditempel sekaligus.
- Pada login berikutnya gunakan password + kode terbaru. Jam HP dan Windows harus sinkron.
Jangan membagikan QR/kunci. Pemasangan memiliki batas waktu. QR aktif tidak ditampilkan ulang. Jika hilang, pengelola yang memiliki izin Reset 2FA dan tingkatan yang tepat dapat mereset akun. Sesi akun dicabut dan pemasangan baru diwajibkan.
Password verifikasi tindakan
Beberapa pengaturan meminta password akun kembali. Ini verifikasi tindakan sensitif, berlaku sekitar 5 menit pada sesi/IP tersebut; bukan permintaan kode 2FA setiap klik. Perubahan akses target dapat mengakhiri sesi target. Sesi yang berakhir atau IP berubah dapat memerlukan login ulang.
WLB dan panel penjualan
Tambah WLB, bedakan link dan tetapkan penanggung jawab.
- Buka Semua WLB → + Tambah WLB. Gunakan nama unik, contoh WLB Cabang Utara.
- Klik Buka WLB. Periksa bahwa nama pada judul benar sebelum mengubah rekening/link.
- Pada pengaturan link, isi link login, halaman deposit, serta link Withdraw jika dipakai. Halaman Deposit dan Withdraw dapat satu domain dengan form berbeda.
- Gunakan Buka login panel di PC pusat. Selesaikan login manual pada browser pusat dan pastikan tabel transaksi benar.
- Perbarui pending, periksa nomor tiket, User ID, Nama lengkap, Payment to, nominal dan WLB asal.
- Atur penanggung jawab serta rekening dan Sheets sebelum Mulai.
Gunakan penamaan bank/PC/WLB yang mudah dibedakan. Seorang staff dapat ditugaskan ke beberapa WLB. Menu Pending semua WLB menggabungkan tiket yang boleh dilihat akun itu dan memberi filter WLB.
Arsipkan WLB yang tidak digunakan
- Stop WLB, tunggu bank logout dan pastikan transaksi/penulisan belum pasti telah diselesaikan.
- Selesaikan pending tersimpan serta Withdraw yang masih berjalan jika ada.
- Buka WLB tambahan → Kelola WLB → Arsipkan WLB. Konfirmasi.
Arsip mengeluarkan WLB dari daftar aktif dan mempertahankan data/riwayat. Bukan hapus permanen. Tombol memerlukan izin Kelola WLB. WLB Utama tidak bisa diarsipkan. Jika tombol tidak tampil, periksa WLB yang dipilih dan izin, lalu Ctrl + F5. Pemulihan arsip belum disediakan sebagai tombol pada panel web saat ini.
Sesi penjualan berbeda per WLB
Setiap WLB memakai konteks panel/data sendiri. Jangan menganggap login satu WLB berarti semua sudah login. Status perlu diperiksa ulang berarti bukti sesi/tabel belum cukup baru; buka login/perbarui tiket dari WLB itu. Jika portal logout setelah semua tab ditutup, pertahankan sesi browser pusat selama bot bekerja.
Bank, HP dan Sheets
Konfigurasi setiap rekening pada WLB yang benar.
| Bank | Pembaca | Contoh tab terpisah |
|---|---|---|
| BCA | myBCA | Sheet7 |
| BRI | BRImo | Sheet8 |
| MANDIRI | Livin’ | Sheet9 |
| BNI | wondr | Sheet10 |
Tab di atas hanya contoh pemasangan. Boleh satu spreadsheet dengan tab berbeda, atau spreadsheet berbeda. Jangan memakai tab sama untuk dua rekening otomatis.
Urutan konfigurasi
- Buka WLB → Bank & HP → Profil → + Rekening baru.
- Pilih bank, isi nomor rekening dan nama pemilik persis sesuai rekening.
- Isi serial USB/ADB HP. HP boleh di pusat atau terdaftar pada PC staff. Untuk remote, penghubung harus siap dan pemiliknya ditugaskan ke WLB.
- Klik Simpan profil. Profil baru tersimpan tidak aktif dan belum dianggap terverifikasi.
- Pilih profil tersebut pada pengaturan Sheets. Tempel link Google Sheets dan isi nama tab persis, lalu Simpan. Nama tab berbeda dengan nomor gid pada URL.
- Pada pengaturan login bank pilih profil/bank yang benar. Simpan data login sesuai label. Password/PIN tidak dikirim melalui chat.
- Periksa aplikasi, rekening dan nama pemilik pada HP. Centang konfirmasi setelah benar, lalu Aktifkan / perbarui rekening bila dibutuhkan.
- Di Rekening otomatis, aktifkan hanya rekening yang siap diuji. Pastikan tidak ada tugas HP yang masih berjalan.
- Atur Jeda pertama dan Jeda berikutnya dalam detik. Contoh 10 = 10 detik, 60 = 1 menit, 120 = 2 menit.
Google Sheets
Akun Google yang digunakan pusat harus memiliki akses edit. Akses browser biasa tidak selalu sama dengan akun API yang digunakan penyimpanan. Header jurnal contoh: A Ticket Number, B ID, C Date, D Pending/detail mutasi, E Module, F Amount, G DB/CR, H Balance. Jangan menimpa A/B yang sudah berisi tiket dan ID.
Jika Sheet belum memiliki lima mutasi, pembaca memakai tarikan tanggal hari ini untuk bootstrap. Jika sudah memiliki lima, pembaca mencari lima pengunci secara berurutan; bukan menghapus seluruh isi Sheet. Pergantian hari/Sheet berisi tanggal lama dapat ditahan sampai tab hari itu sesuai. Saldo awal H3 digunakan jika diisi valid; bila kosong pembaca tidak boleh mengarang saldo.
Profil tidak digunakan
Pilih profil tidak aktif → Hapus profil tidak aktif. Rekening yang sedang aktif/proses atau memiliki kondisi belum pasti dapat ditolak. Menghapus profil tidak berarti menghapus jurnal transaksi maupun semua arsip kredensial. Cabut akses PC/ubah login bank secara terpisah jika diperlukan.
Cara menggunakan bot
Alur harian deposit dari pending sampai pencatatan.
Sebelum menekan Mulai
- Buka Semua WLB. Lihat nama WLB dan penanggung jawab.
- Klik Perbarui pending untuk mendapatkan bukti tabel terbaru. Di Pending semua WLB pilih filter WLB/bank jika diperlukan.
- Klik Periksa kecocokan untuk penilaian sesuai data/profil yang tersedia. Periksa pesan hasil; tombol itu bukan bukti bahwa semua transaksi sudah approved.
- Mulai WLB hanya setelah konfigurasi dan uji terpantau siap. Ini dapat memproses approval nyata jika syarat cocok; bukan mode tampilan saja.
- Bot membaca bank yang dibutuhkan, memeriksa rekening, nominal, identitas serta pengunci sesuai jalurnya, dan menahan kecocokan yang ambigu.
- Approval menggunakan tombol Approve panel yang sesuai, bukan Approve by Bank Date. Bot harus memastikan hasil panel sebelum menganggap transaksi selesai.
- Tiket dan User ID dicatat pada mutasi yang dipakai di Sheets. Jika approval berhasil tetapi pencatatan gagal, selesaikan sinkronisasi; jangan approve lagi.
- Pantau Deposit, Perlu ditangani, serta Tugas PC pusat. Gunakan Stop jika ada perbedaan rekening/nominal.
Refresh panel dan data terbaru
Saat proses WLB berjalan, bot menjadwalkan refresh pending panel melalui Cari sekitar setiap 60 detik. Pembaruan tampilan dashboard tidak selalu berarti bank sudah ditarik ulang. Pembacaan dapat memerlukan waktu, menunggu HP, atau mengikuti jeda yang Anda atur. Jika bot berhenti atau sesi panel habis, snapshot lama dapat tetap terlihat; periksa waktu terakhir dibaca.
Banyak WLB / bank
Gunakan filter WLB dan label bank. HP yang sama bergantian. Pada PC pusat, pembaca HP berbeda mengikuti scheduler dan kunci perangkat/rekening. Pada PC staff, satu penghubung menjalankan satu tugas bank pada satu waktu; beberapa PC staff dapat berjalan bersamaan. Jalur approval tetap berurutan per WLB, dengan validasi ulang sebelum klik.
Uji awal yang benar
- Mulai dengan satu WLB, satu bank dan satu HP.
- Uji login → rekening yang benar → baca mutasi → logout. Cocokkan nominal dan lima pengunci dengan tampilan bank/Sheet.
- Uji pencatatan dan approval hanya menggunakan tiket uji yang sudah Anda identifikasi dengan jelas.
- Pastikan dialog sukses selesai, tiket hilang/berubah sesuai panel, dan A/B Sheets tepat.
- Uji Stop, USB terlepas dan koneksi terputus tanpa mengulang approval yang belum pasti.
- Baru perluas ke bank/WLB berikutnya setelah tiap tahap terbukti.
Mutasi kosong
Isi User ID langsung pada baris mutasi yang akan dipakai.
- Buka Mutasi kosong, pilih WLB dan bank/rekening yang benar.
- Periksa badge jumlah, nama pemilik, nomor rekening, nama tab, tanggal, detail dan nominal masuk. Jumlah mengikuti baris yang terbaca/belum terpakai, bukan semua saldo rekening.
- Pilih baris yang memang milik transaksi tersebut. Ketik User ID pada kolom di baris itu; nominal mengikuti mutasi yang dipilih.
- Klik Approve pada baris tersebut, baca konfirmasi WLB/bank/nominal, lalu lanjutkan jika benar.
- Pusat memeriksa pending User ID, nominal dan tujuan rekening, serta memastikan mutasi belum dipakai. Hasil ambigu/tidak cocok ditahan.
- Setelah sukses, tiket dan ID dicatat di baris yang digunakan. Periksa Deposit dan Sheets.
Jalur ini digunakan untuk mutasi tanpa nama yang cocok, misalnya dompet digital atau pengirim dengan nama berbeda, setelah Anda mengidentifikasi pemiliknya. Bukan izin untuk memakai sembarang mutasi dengan nominal sama. Dua pending/mutasi yang sama-sama cocok dapat ditahan untuk pemeriksaan.
Aktifkan suara melalui kontrol notifikasi bila tersedia. Browser memerlukan interaksi pengguna sebelum suara dapat berbunyi; tab yang di-mute atau izin browser dapat membuatnya diam. Badge jumlah tetap perlu dipantau. Saldo “Belum tersedia” tidak boleh dianggap nol.
Menu dan status
Panduan membaca panel operasional.
| Menu | Fungsi |
|---|---|
| Semua WLB | Kartu kondisi WLB, Buka WLB, Pending WLB, Mulai dan Stop. |
| Pending semua WLB | Daftar gabungan sesuai izin, filter WLB/bank dan detail tiket. |
| Mutasi kosong | Mutasi belum terpakai serta input User ID per baris. |
| Perlu ditangani | Kondisi yang memerlukan pemeriksaan, status proses dan tindak lanjut per WLB. |
| Deposit | Riwayat jurnal, filter WLB, Approve/Reject/Belum terkonfirmasi, tanggal dan pencarian. Bukan tombol reject transaksi baru. |
| Withdraw | Pengaturan/pembacaan tiket sesuai izin; pengiriman dana web belum aktif. |
| Staff | Akun sendiri, password, authenticator dan Kelola Staff jika diizinkan. |
| PC Staff | Unduh penghubung, pairing, USB, status baca, pencabutan akses dan tahanan tugas. |
| Action Log | Aktivitas sesuai cakupan akun; tampilan membatasi sekitar 500 aktivitas terakhir. |
| Izin IP | Superadmin mengatur IP/CIDR, nama, jenis jaringan dan remarks. |
Arti status
| Status | Arti / tindakan |
|---|---|
| ONLINE | Heartbeat penghubung baru diterima. Bukan bukti rekening atau mutasi valid. |
| Pembaca remote terhubung | Agen versi 2 siap menerima tugas. Tetap uji bank pada HP. |
| WAIT_DEVICE / WAIT_SLOT | Menunggu giliran perangkat/slot; jangan membuka tugas duplikat. |
| SCANNING / RUNNING | Tugas sedang bekerja; jangan mengganti rekening, HP atau tab Sheets. |
| READY / selesai scan | Siklus telah selesai sesuai bukti yang tersedia; lihat waktu dan hasil, bukan hanya label. |
| HELD / belum terkonfirmasi | Tugas memerlukan pemeriksaan. Jangan mengulang tindakan keuangan. |
| STOPPED / BERHENTI | Bot WLB berhenti. Layanan web masih dapat menampilkan snapshot. |
| QUEUED | Antrean staff belum diambil. Setelah diambil berubah RUNNING; tidak dikirim ulang jika respons klaim hilang. |
Withdraw
Isi link WD pada pengaturan WLB jika digunakan, buka Withdraw, pilih WLB dan minta baca tabel panel. Pengaturan sumber/modul/HP bukan jaminan fitur kirim uang siap. Versi web ini menahan fitur pengiriman; jangan mengandalkan auto WD untuk pekerjaan tanpa pemantauan.
IP dan keamanan
Pengaturan akses kantor sehari-hari.
- Superadmin → Izin IP. Tambahkan IP publik jaringan yang benar.
- Isi nama jelas, contoh Kantor lantai 2, pilih jenis dan remarks, contoh Jaringan operator pembelian.
- Jangan menghapus IP sesi sendiri sebelum jalur pemulihan lokal tersedia. Pertahankan akses lokal pusat.
- Uji dari jaringan diizinkan dan yang tidak diizinkan. IP berubah setelah pindah Wi-Fi/VPN/hotspot dapat memerlukan izin baru.
- Nonaktifkan akun yang tidak digunakan dan cabut pairing PC yang tidak lagi dipercaya.
IP publik dapat dipakai beberapa orang sekaligus melalui satu router. Izin IP bukan pengganti akun pribadi, 2FA dan pembatasan WLB. Jangan mengizinkan semua alamat dengan 0.0.0.0/0. Jangan membuka port ADB ke internet.
| Rahasia | Fungsi / penanganan |
|---|---|
| Password akun NXS | Login panel dan verifikasi pengaturan. |
| Kunci/QR 2FA | Pemasangan authenticator. Jangan dibagikan. |
| NXS_PROXY_SECRET | Tanda tangan gateway Pages ↔ pusat. Harus sama pada dua sisi. |
| Token cloudflared | Menghubungkan instalasi Tunnel. Jika bocor, rotasi dan perbarui instalasi dengan token baru sesuai petunjuk Cloudflare. |
| File pairing staff | Identitas PC staff. Jika bocor, cabut akses node dan buat pairing baru. |
| Login/PIN bank | Simpan melalui pengaturan yang benar. Jangan memasukkannya ke HTML, ZIP deploy atau chat. |
HTTPS dan pengaman aplikasi mengurangi risiko, bukan jaminan tidak bisa disalahgunakan. Pembaca staff membutuhkan lingkungan Windows/HP tepercaya. Gunakan akun Windows individual dan batasi administrator.
Pemecahan masalah
Cari pesan yang sesuai sebelum mengulangi tindakan.
| Gejala | Periksa / lakukan |
|---|---|
| Error 1033 | Tunnel tidak terhubung sehat ke Cloudflare. Periksa listrik/internet pusat, service cloudflared, lalu status NXS-PUSAT. Restart service sebagai Administrator bila perlu. Jika Healthy tetapi tetap gagal, periksa DNS origin menunjuk Tunnel yang benar. Tidak perlu membuat secret baru. |
| 502 / connection refused | Tunnel hidup tetapi origin tidak merespons sesuai route. Jalankan WEB-CLOUDFLARE.bat dan pastikan tujuan HTTP 127.0.0.1:8788. |
| Koneksi pusat belum dikonfigurasi | Periksa tiga variables Production dan tipe Secret. Simpan, lalu deploy ulang Pages. Mengganti jaringan tidak memperbaiki variabel yang kosong. |
| Permintaan Cloudflare tidak terverifikasi | Normal saat membuka 8788/origin langsung. Jika pada domain utama, cocokkan public origin, secret kedua sisi, deployment dan jam Windows. |
| 403 sebelum login | IP dapat tidak diizinkan, host/origin salah atau verifikasi gateway gagal. Gunakan panel lokal pusat untuk memeriksa Izin IP. Jangan menonaktifkan pengamanan secara menyeluruh. |
| cloudflared not recognized | Pasang MSI, tutup Command Prompt lama lalu buka baru dan jalankan cloudflared --version. |
| Access is denied saat service install | Buka Command Prompt lewat klik kanan Run as administrator. Jangan mengetik tulisan Run as administrator sebagai perintah. |
| Port already in use | Server sudah berjalan atau port dipakai proses lain. Jangan menjalankan banyak salinan. Identifikasi proses NXS sebelum menghentikannya. |
| USB unauthorized | Buka kunci HP, setujui dialog USB debugging untuk PC tersebut. |
| USB tidak terdeteksi/offline | Periksa kabel data, port USB, driver, izin HP dan adb devices. Pastikan serial pairing sama. |
| Staff online, pembaca belum siap | Gunakan paket versi 2, jalankan setup dependensi, hubungkan ulang dan klik Perbarui status. Agen lama hanya mengirim presence. |
| PC staff ditolak | Periksa domain HTTPS, IP publik, node aktif, akun pemilik aktif, izin baca/sync dan penugasan WLB. |
| Profil belum terverifikasi | Periksa HP/rekening/pemilik dan konfirmasi profil. myBCA memerlukan selector login/mutasi/logout yang sesuai HP. |
| Sheet berubah / pengunci tidak ditemukan | Hentikan penulisan manual, periksa tab/tanggal/urutan mutasi. Jangan menghapus lima pengunci atau isi jurnal untuk memaksa scan. |
| Approve selesai, Sheets belum terisi | Periksa jurnal/tugas dan Sinkron tiket dari WLB. Jangan klik approve lagi. Penyimpanan yang belum pasti perlu diperiksa sebelum sinkron ulang. |
| Menu hilang | Periksa izin per akun, WLB yang ditugaskan dan Ctrl + F5. Beberapa fitur hanya Superadmin atau tidak aktif pada versi ini. |
| Arsipkan WLB tidak muncul | WLB Utama dilindungi. Pilih WLB tambahan dan gunakan akun dengan Kelola WLB. |
| Kode authenticator gagal | Gunakan kode terbaru, sinkronkan jam. Jika hilang gunakan reset oleh pengelola berwenang; jangan membagikan kunci/OTP. |
Tugas remote HELD
- Stop WLB terkait dan hentikan penghubung PC staff.
- Periksa HP secara langsung: login pernah terkirim? mutasi terbuka? sesi sudah logout?
- Periksa apakah transaksi panel/Sheets sudah berubah sebelum mencoba apa pun.
- Jika tugas belum kedaluwarsa, tunggu batas tugas berakhir agar tidak masih berjalan di belakang.
- Setelah HP dipastikan logout dan tidak ada proses staff aktif, Superadmin membuka PC Staff → Perbarui status → Lepas tahanan pembacaan.
- Hubungkan kembali, uji satu tugas baru. Jangan melepas tahanan berulang tanpa memeriksa sebabnya.
Referensi: Cloudflare Tunnel troubleshooting. Saat meminta bantuan kirim pesan error, WLB, bank, waktu dan tahapnya. Sensor token, QR, password dan PIN.
Backup dan pindah PC
Bedakan restart biasa dengan reset Windows atau pemindahan pusat.
Restart biasa
Konfigurasi tetap ada. Jalankan dua layanan web dan penghubung staff kembali sesuai perannya. Tunnel service seharusnya otomatis, tetapi tetap periksa Healthy. Tidak perlu deploy ulang hanya karena restart.
Cadangan
- Stop proses WLB dan tunggu semua tugas bank/penulisan selesai.
- Gunakan Backup & Pemulihan pada aplikasi pengelola desktop jika tersedia. Fitur itu tidak tampil sebagai menu utama web pada versi ini.
- Pahami cakupannya: cadangan WLB lokal bukan cadangan otomatis seluruh Google Sheets, browser login, vault bank, akun tim dan jurnal global Withdraw.
- Untuk backup penuh, sertakan data dan dependensi yang diperlukan melalui media privat dengan kontrol akses; jangan masukkan ke ZIP deploy publik.
- Uji prosedur restore pada salinan terpisah sebelum mengandalkannya. Jangan memulihkan langsung ke pusat yang masih menjalankan tugas.
Pindah ke laptop khusus / instal ulang
File terenkripsi Windows DPAPI terikat identitas Windows. Secret penghubung, pairing, kredensial bank, Google dan 2FA yang terenkripsi belum tentu dapat dipakai di Windows baru. Perlu pencadangan yang sesuai, pengisian ulang rahasia/otorisasi bila dibutuhkan, konfigurasi dependensi, pemasangan Tunnel dan uji rekening satu per satu.
- Tentukan waktu henti, Stop semua proses dan dokumentasikan transaksi belum selesai.
- Cadangkan sumber, konfigurasi, database/jurnal WLB dan data global yang diperlukan secara privat.
- Siapkan Python, dependensi pendamping, browser dan otorisasi penyimpanan pada pusat baru.
- Siapkan kembali secret lokal dan Cloudflare bila kunci lama tidak bisa dibaca. Pasang cloudflared pada pusat baru, ikuti token aktif.
- Pastikan pusat lama berhenti sebelum pusat baru memproses WLB yang sama.
- Verifikasi akun/2FA, IP, Sheets, panel login, HP dan hasil jurnal. Baru mulai satu WLB uji.
Checklist uji dan serah pakai
Gunakan sebagai catatan pemeriksaan, bukan bukti otomatis siap produksi.
Centang disimpan pada browser ini saja. Jangan memasukkan rahasia ke catatan. Tombol Reset checklist menghapus centang lokal, tidak menyentuh bot atau transaksi.
Koneksi dan akses
Per bank / rekening
Pemrosesan tiket dan gangguan
Fitur web/paket telah menjalani pengujian fixture lokal. Checklist nyata harus diisi berdasarkan pengujian pada mesin dan HP yang digunakan. Withdraw kirim uang tidak termasuk fitur web aktif pada panduan ini.