Bantuan
Panduan & Bantuan
Kumpulan panduan penggunaan aplikasi Kieomo. Pilih aplikasi untuk melihat petunjuk memulai, langkah kerja, dan pengaturan penting.
Kieomo Wega
Instalasi
Instalasi & Persyaratan
1. Persyaratan: Windows 10/11 (atau Linux/macOS), Python 3.9+, dan (opsional) driver USB-to-Serial CH340/CP210x/FTDI untuk timbangan RS232 serta server MySQL.
2. Menjalankan dari kode sumber: buat venv (python -m venv .venv), aktifkan, lalu pip install -r requirements.txt; salin .env.example menjadi .env dan isi sesuai kebutuhan; jalankan python main.py.
3. Build binary: py -3.9 compile.py (Windows + Linux via WSL) — opsi lain --windows-only, --manylinux, --wsl-distro, --upx. Hasil di C:\temp\dist\<os>.
4. Binary Linux: instal dependensi runtime Qt dengan bash setup.sh di server tujuan.
5. Shortcut desktop dibuat otomatis pada run pertama; pada run pertama juga muncul dialog persetujuan telemetry.
2. Menjalankan dari kode sumber: buat venv (python -m venv .venv), aktifkan, lalu pip install -r requirements.txt; salin .env.example menjadi .env dan isi sesuai kebutuhan; jalankan python main.py.
3. Build binary: py -3.9 compile.py (Windows + Linux via WSL) — opsi lain --windows-only, --manylinux, --wsl-distro, --upx. Hasil di C:\temp\dist\<os>.
4. Binary Linux: instal dependensi runtime Qt dengan bash setup.sh di server tujuan.
5. Shortcut desktop dibuat otomatis pada run pertama; pada run pertama juga muncul dialog persetujuan telemetry.
Laporan & Dashboard
Laporan & Dashboard
1. Menu Laporan > Dashboard: KPI + grafik (tren harian, distribusi muatan, partner teratas, status transaksi) dengan filter rentang tanggal dan ekspor PDF.
2. Laporan Transaksi memiliki tiga mode: Rekap Transaksi, Detail Muatan (per item), dan Rekap Ringkasan, dengan filter gabungan (tanggal, terminal, status, pengemudi, partner, muatan, area, grade, jenis dokumen, field kustom).
3. Dashboard Perbandingan tersedia per Terminal, Muatan, Partner, Pengemudi, Grade, Area, Jenis Dokumen, Kendaraan, dan Potongan.
4. Ekspor mendukung CSV, Excel (XLSX), dan PDF; ekspor Excel/PDF memuat seluruh kolom termasuk baris muatan.
5. Ekspor per transaksi disimpan ke exports/YYYY/MM/<terminal>/<tiket>/.
2. Laporan Transaksi memiliki tiga mode: Rekap Transaksi, Detail Muatan (per item), dan Rekap Ringkasan, dengan filter gabungan (tanggal, terminal, status, pengemudi, partner, muatan, area, grade, jenis dokumen, field kustom).
3. Dashboard Perbandingan tersedia per Terminal, Muatan, Partner, Pengemudi, Grade, Area, Jenis Dokumen, Kendaraan, dan Potongan.
4. Ekspor mendukung CSV, Excel (XLSX), dan PDF; ekspor Excel/PDF memuat seluruh kolom termasuk baris muatan.
5. Ekspor per transaksi disimpan ke exports/YYYY/MM/<terminal>/<tiket>/.
Master Data
Master Data
1. Menu Master Data berisi: Pengemudi, Area, Muatan, Partner, Jenis Dokumen, Grade, Kendaraan, Referensi Dokumen, dan Pengguna.
2. Setiap jendela master punya tombol Tambah, Ubah, Hapus, dan Muat Ulang, plus kotak pencarian.
3. Muatan dan Grade menyimpan persen Potongan default (mis. kadar air/susut); otomatis mengurangi Netto dan tampil di nota, laporan, Remote View, dan webhook.
4. Jenis Dokumen punya Umur Maks. (hari) untuk menyaring dokumen referensi yang terlalu lama.
5. Item bisa dinonaktifkan (bukan dihapus) agar tetap terbaca pada transaksi lama.
2. Setiap jendela master punya tombol Tambah, Ubah, Hapus, dan Muat Ulang, plus kotak pencarian.
3. Muatan dan Grade menyimpan persen Potongan default (mis. kadar air/susut); otomatis mengurangi Netto dan tampil di nota, laporan, Remote View, dan webhook.
4. Jenis Dokumen punya Umur Maks. (hari) untuk menyaring dokumen referensi yang terlalu lama.
5. Item bisa dinonaktifkan (bukan dihapus) agar tetap terbaca pada transaksi lama.
Master Kendaraan (Tare)
1. Simpan Berat Kendaraan (KG) per plat, pemilik (Sendiri/Partner), centang "Bruto boleh diedit", dan keterangan.
2. Plat terdaftar tanpa transaksi berjalan langsung masuk mode TIMBANG KELUAR: Bruto terisi otomatis dari master, Tara dari indikator, transaksi langsung COMPLETED.
3. Bila "Bruto boleh diedit" tidak dicentang, nilai dari master dikunci (cukup satu kali timbang); centang baru aktif otomatis untuk record kendaraan baru.
4. Pada transaksi masuk yang berjalan, Tara terisi otomatis dari master dan dikunci bila centang tersebut nonaktif.
2. Plat terdaftar tanpa transaksi berjalan langsung masuk mode TIMBANG KELUAR: Bruto terisi otomatis dari master, Tara dari indikator, transaksi langsung COMPLETED.
3. Bila "Bruto boleh diedit" tidak dicentang, nilai dari master dikunci (cukup satu kali timbang); centang baru aktif otomatis untuk record kendaraan baru.
4. Pada transaksi masuk yang berjalan, Tara terisi otomatis dari master dan dikunci bila centang tersebut nonaktif.
Memulai
Memulai Kieomo Wega
1. Instal aplikasi Wega pada PC yang terhubung ke jembatan timbang, lalu jalankan dan login dengan akun yang diberikan admin (default: user "admin", password "admin123" — segera ganti).
2. Lengkapi konfigurasi awal pada menu Pengaturan: profil perusahaan, ID terminal, nomor transaksi, dan koneksi alat timbang (indikator serial RS232 atau TCP/IP jaringan).
3. Siapkan master data: kendaraan (berat tare per plat), muatan, grade, partner, pengemudi, dan jenis dokumen.
4. Saat server MySQL tidak terjangkau, aplikasi otomatis beralih ke database lokal (mode offline); transaksi tersimpan dan tersinkron otomatis saat koneksi pulih.
5. Hubungi tim Kieomo via email resmi untuk bantuan aktivasi lisensi dan dukungan.
2. Lengkapi konfigurasi awal pada menu Pengaturan: profil perusahaan, ID terminal, nomor transaksi, dan koneksi alat timbang (indikator serial RS232 atau TCP/IP jaringan).
3. Siapkan master data: kendaraan (berat tare per plat), muatan, grade, partner, pengemudi, dan jenis dokumen.
4. Saat server MySQL tidak terjangkau, aplikasi otomatis beralih ke database lokal (mode offline); transaksi tersimpan dan tersinkron otomatis saat koneksi pulih.
5. Hubungi tim Kieomo via email resmi untuk bantuan aktivasi lisensi dan dukungan.
Login & Peran Pengguna
1. Masukkan Username dan Password. Bila aplikasi baru diinstal, akun default: user "admin", password "admin123" — ganti segera lewat Akun > Ganti Password.
2. Peran (role): admin (semua menu termasuk Master Data, Pengaturan, dan Manajemen Pengguna), supervisor (operator + master data + hapus transaksi), operator (hanya input transaksi).
3. Bila username/password salah, jendela login tetap terbuka dan isian dikosongkan untuk dicoba kembali.
4. Lupa password: reset dengan tool "python tools/reset_password.py" (kode sumber) atau buat user baru di Pengaturan > Manajemen Pengguna.
2. Peran (role): admin (semua menu termasuk Master Data, Pengaturan, dan Manajemen Pengguna), supervisor (operator + master data + hapus transaksi), operator (hanya input transaksi).
3. Bila username/password salah, jendela login tetap terbuka dan isian dikosongkan untuk dicoba kembali.
4. Lupa password: reset dengan tool "python tools/reset_password.py" (kode sumber) atau buat user baru di Pengaturan > Manajemen Pengguna.
Pemecahan Masalah
Pemecahan Masalah
1. "PySide6 belum terinstal" — jalankan pip install -r requirements.txt.
2. Lupa password login — reset dengan tool python tools/reset_password.py atau buat user baru di Pengaturan > Manajemen Pengguna.
3. Port COM tidak ditemukan — cek driver USB-to-Serial di Device Manager (Ports COM & LPT).
4. Gagal konek MySQL — pastikan server aktif dan kredensial benar di Pengaturan > Database; indikator baris bawah OFFLINE berarti server tak terjangkau.
5. Binary Linux tidak muncul UI — jalankan bash setup.sh untuk dependensi runtime Qt.
6. Password MySQL tidak terbawa saat .env disalin ke mesin lain — isi ulang via Pengaturan > Database > Uji Koneksi > Simpan (enkripsi terkunci per mesin).
2. Lupa password login — reset dengan tool python tools/reset_password.py atau buat user baru di Pengaturan > Manajemen Pengguna.
3. Port COM tidak ditemukan — cek driver USB-to-Serial di Device Manager (Ports COM & LPT).
4. Gagal konek MySQL — pastikan server aktif dan kredensial benar di Pengaturan > Database; indikator baris bawah OFFLINE berarti server tak terjangkau.
5. Binary Linux tidak muncul UI — jalankan bash setup.sh untuk dependensi runtime Qt.
6. Password MySQL tidak terbawa saat .env disalin ke mesin lain — isi ulang via Pengaturan > Database > Uji Koneksi > Simpan (enkripsi terkunci per mesin).
Pengaturan
Indikator Timbangan (Serial / Jaringan)
1. Pengaturan > Serial: pilih sumber Serial Port (RS232) atau TCP/IP (Jaringan) dan protokol (auto-detect, Yaohua XK3190, atau regex kustom).
2. Parameter serial lengkap: baudrate (2400–115200), data bits, paritas, stop bits, dan mode perintah dengan interval pembacaan.
3. "Bagikan ke Jaringan" menyiarkan data indikator (baris JSON) via UDP/TCP ke komputer lain — port default 8020, hanya untuk sumber serial.
4. Panel "Preview Indikator": klik Mulai Preview untuk membuka port tanpa menyimpan; tampil status koneksi (TERHUBUNG / SIAP MENERIMA / UDP AKTIF), berat, dan log frame mentah.
5. Perubahan port/baudrate langsung berlaku tanpa restart; status aktif tampil di baris status bawah (RS232 / TCP host:port / Stream).
2. Parameter serial lengkap: baudrate (2400–115200), data bits, paritas, stop bits, dan mode perintah dengan interval pembacaan.
3. "Bagikan ke Jaringan" menyiarkan data indikator (baris JSON) via UDP/TCP ke komputer lain — port default 8020, hanya untuk sumber serial.
4. Panel "Preview Indikator": klik Mulai Preview untuk membuka port tanpa menyimpan; tampil status koneksi (TERHUBUNG / SIAP MENERIMA / UDP AKTIF), berat, dan log frame mentah.
5. Perubahan port/baudrate langsung berlaku tanpa restart; status aktif tampil di baris status bawah (RS232 / TCP host:port / Stream).
Kamera / CCTV
1. Pengaturan > Kamera/CCTV: atur jumlah kamera (0 = tanpa kamera; panel disembunyikan dan auto-capture mati), hingga 6 kamera (RTSP/IP/ONVIF/NVR/Webcam).
2. Auto-capture saat timbang (opsional): semua kamera otomatis memotret saat tombol TIMBANG MASUK/KELUAR ditekan; foto tersimpan ke folder transaksi.
3. Streaming Kamera N (centang per kamera): mengizinkan kamera dilihat dari komputer lain lewat halaman Kamera/CCTV pada Remote View (live stream MJPEG + snapshot, dilindungi token yang sama).
4. Di jendela utama: klik dua kali kamera untuk melihat besar (popup); tombol Capture Semua menyimpan tangkapan semua kamera.
2. Auto-capture saat timbang (opsional): semua kamera otomatis memotret saat tombol TIMBANG MASUK/KELUAR ditekan; foto tersimpan ke folder transaksi.
3. Streaming Kamera N (centang per kamera): mengizinkan kamera dilihat dari komputer lain lewat halaman Kamera/CCTV pada Remote View (live stream MJPEG + snapshot, dilindungi token yang sama).
4. Di jendela utama: klik dua kali kamera untuk melihat besar (popup); tombol Capture Semua menyimpan tangkapan semua kamera.
Printer & Format Nota
1. Pengaturan > Printer: tiga mode cetak — Simpan ke File (folder exports/), Langsung ke Printer (ESC/POS via port serial + baudrate), atau Printer Sistem (driver: Render Driver untuk laser/inkjet, RAW ESC/POS untuk thermal).
2. Gunakan tombol Uji Cetak dan Muat Ulang Port & Printer; status printer tampil di baris bawah (Printer: AKTIF / TIDAK AKTIF).
3. Format Nota: buat dan pilih template nota sendiri (header/body/footer), pratinjau, dan salinan nota.
4. Di form transaksi: PREVIEW untuk melihat nota, CETAK untuk mencetak langsung.
2. Gunakan tombol Uji Cetak dan Muat Ulang Port & Printer; status printer tampil di baris bawah (Printer: AKTIF / TIDAK AKTIF).
3. Format Nota: buat dan pilih template nota sendiri (header/body/footer), pratinjau, dan salinan nota.
4. Di form transaksi: PREVIEW untuk melihat nota, CETAK untuk mencetak langsung.
REST API
1. Pengaturan > API: nyalakan REST API, atur port, token (master / rw / ro), mode read-only, dan keamanan (rate limit, IP bypass, filter IP whitelist/blacklist).
2. Endpoint CRUD umum: GET/POST/PUT/PATCH/DELETE /api/<tabel>[/<id>] (whitelist tabel) plus /api/tables dan /api/system_info.
3. Autentikasi: header Authorization: Bearer <token> atau X-API-Key. Kolom rahasia (token, password) diredaksi pada respons.
4. Buka http://<IP>:<PORT>/api untuk dokumentasi interaktif beserta contoh cURL, PHP, Python, dan JavaScript.
2. Endpoint CRUD umum: GET/POST/PUT/PATCH/DELETE /api/<tabel>[/<id>] (whitelist tabel) plus /api/tables dan /api/system_info.
3. Autentikasi: header Authorization: Bearer <token> atau X-API-Key. Kolom rahasia (token, password) diredaksi pada respons.
4. Buka http://<IP>:<PORT>/api untuk dokumentasi interaktif beserta contoh cURL, PHP, Python, dan JavaScript.
Webhook
1. Pengaturan > Webhook: kirim data transaksi (weigh_in dan weigh_out) ke URL eksternal via HTTP POST/PUT/PATCH.
2. Autentikasi: Basic, Bearer, atau API Key (header kustom).
3. Terdapat antrian retry dengan batas percobaan, jeda, dan maksimum antrean; kirim ulang manual serta status pending pada jendela antrean webhook.
4. Gunakan tombol uji coba webhook dan pratinjau payload sebelum dipakai produksi.
2. Autentikasi: Basic, Bearer, atau API Key (header kustom).
3. Terdapat antrian retry dengan batas percobaan, jeda, dan maksimum antrean; kirim ulang manual serta status pending pada jendela antrean webhook.
4. Gunakan tombol uji coba webhook dan pratinjau payload sebelum dipakai produksi.
Remote View (Pantau dari Browser)
1. Pengaturan > Remote View: nyalakan halaman pantau (port default 8080), atur auto-refresh (detik), header/footer, dan Custom CSS & JavaScript.
2. Buka http://<IP_KOMPUTER>:<PORT> dari browser perangkat lain di jaringan yang sama; dilindungi token akses (fail-closed, auto-generate).
3. Halaman Transaksi: kartu transaksi terbaru, pencarian (tiket, plat, kontainer, no. dokumen, pengemudi, partner, muatan), filter terminal, pagination.
4. Halaman Dashboard: KPI + grafik (tren harian, jam sibuk, bruto/netto/tara, muatan, area, partner, per terminal, status) dengan filter tanggal.
5. Halaman Kamera/CCTV: live stream MJPEG + snapshot hanya untuk kamera yang streaming-nya dicentang.
6. Tema gelap/terang tersimpan per browser; halaman dimuat ulang otomatis tiap interval refresh.
2. Buka http://<IP_KOMPUTER>:<PORT> dari browser perangkat lain di jaringan yang sama; dilindungi token akses (fail-closed, auto-generate).
3. Halaman Transaksi: kartu transaksi terbaru, pencarian (tiket, plat, kontainer, no. dokumen, pengemudi, partner, muatan), filter terminal, pagination.
4. Halaman Dashboard: KPI + grafik (tren harian, jam sibuk, bruto/netto/tara, muatan, area, partner, per terminal, status) dengan filter tanggal.
5. Halaman Kamera/CCTV: live stream MJPEG + snapshot hanya untuk kamera yang streaming-nya dicentang.
6. Tema gelap/terang tersimpan per browser; halaman dimuat ulang otomatis tiap interval refresh.
Database & Mode Offline
1. Pengaturan > Database: pilih SQLite (lokal) atau MySQL (multi-terminal). Database dibuat otomatis saat pertama dijalankan.
2. Password MySQL tersimpan terenkripsi (kunci sistem Windows/DPAPI, awalan "enc:"), bukan teks biasa. Tombol Uji Koneksi mengetes tanpa menyimpan.
3. Fallback otomatis: bila MySQL tidak terjangkau, aplikasi beralih ke SQLite lokal (offline); transaksi tetap bisa dicatat.
4. Saat koneksi pulih, aplikasi mendeteksi otomatis, mengirim seluruh transaksi offline (transaksi gagal dipertahankan dan dicoba ulang), lalu kembali online.
5. Indikator baris bawah: MySQL ONLINE (hijau), MySQL OFFLINE (merah), MySQL ONLINE — sinkronisasi (N) (kuning), atau DB: SQLite.
6. Perubahan database baru berlaku setelah aplikasi di-restart.
2. Password MySQL tersimpan terenkripsi (kunci sistem Windows/DPAPI, awalan "enc:"), bukan teks biasa. Tombol Uji Koneksi mengetes tanpa menyimpan.
3. Fallback otomatis: bila MySQL tidak terjangkau, aplikasi beralih ke SQLite lokal (offline); transaksi tetap bisa dicatat.
4. Saat koneksi pulih, aplikasi mendeteksi otomatis, mengirim seluruh transaksi offline (transaksi gagal dipertahankan dan dicoba ulang), lalu kembali online.
5. Indikator baris bawah: MySQL ONLINE (hijau), MySQL OFFLINE (merah), MySQL ONLINE — sinkronisasi (N) (kuning), atau DB: SQLite.
6. Perubahan database baru berlaku setelah aplikasi di-restart.
Transaksi
Timbang Masuk (Bruto)
1. Pada form Transaksi, isi No. Kendaraan (plat). Bila plat sudah terdaftar di master kendaraan, berat master dipakai otomatis.
2. Tekan tombol TIMBANG MASUK — berat indikator saat itu menjadi Bruto dan transaksi mulai berjalan (status IN_PROGRESS).
3. Lengkapi isian lain: muatan, partner, jenis dokumen + no. dokumen, area masuk/keluar, pengemudi, grade, dan field kustom.
4. Tekan SIMPAN — No. Tiket dibuat, transaksi masuk antrian, dan webhook (bila aktif) terkirim dengan event=weigh_in.
5. Tanpa indikator terhubung, berat tetap bisa diisi manual.
2. Tekan tombol TIMBANG MASUK — berat indikator saat itu menjadi Bruto dan transaksi mulai berjalan (status IN_PROGRESS).
3. Lengkapi isian lain: muatan, partner, jenis dokumen + no. dokumen, area masuk/keluar, pengemudi, grade, dan field kustom.
4. Tekan SIMPAN — No. Tiket dibuat, transaksi masuk antrian, dan webhook (bila aktif) terkirim dengan event=weigh_in.
5. Tanpa indikator terhubung, berat tetap bisa diisi manual.
Timbang Keluar (Tara / Netto)
1. Pilih kendaraan yang keluar dari Antrian Kendaraan (atau ketik plat yang sama pada form).
2. Tekan TIMBANG KELUAR — berat saat itu menjadi Tara dan Netto terhitung otomatis: Bruto − Tara, dikurangi Potongan bila muatan/grade memilikinya.
3. Tekan SIMPAN — transaksi berstatus COMPLETED dan nota dapat dicetak; webhook (bila aktif) terkirim dengan event=weigh_out.
4. Kendaraan yang terdaftar di master dan tidak punya transaksi berjalan langsung masuk mode ini: Bruto dari master, Tara dari indikator, transaksi langsung COMPLETED (tanpa antrian).
5. Gunakan PREVIEW untuk melihat nota sebelum mencetak, atau CETAK untuk langsung mencetak (ke printer atau file sesuai pengaturan).
2. Tekan TIMBANG KELUAR — berat saat itu menjadi Tara dan Netto terhitung otomatis: Bruto − Tara, dikurangi Potongan bila muatan/grade memilikinya.
3. Tekan SIMPAN — transaksi berstatus COMPLETED dan nota dapat dicetak; webhook (bila aktif) terkirim dengan event=weigh_out.
4. Kendaraan yang terdaftar di master dan tidak punya transaksi berjalan langsung masuk mode ini: Bruto dari master, Tara dari indikator, transaksi langsung COMPLETED (tanpa antrian).
5. Gunakan PREVIEW untuk melihat nota sebelum mencetak, atau CETAK untuk langsung mencetak (ke printer atau file sesuai pengaturan).
Penimbangan Bertahap (Mode Split)
1. Centang Mode Split pada form transaksi sebelum timbang masuk; tombol Tambah Tahap menjadi aktif (warna aksen).
2. Untuk tiap tahap kendaraan (mis. kendaraan panjang/gandeng), tekan Tambah Tahap — berat saat itu ditambahkan sebagai satu tahap; total semua tahap menjadi Bruto.
3. Timbang keluar juga bisa bertahap: pilih transaksi yang berjalan, centang Mode Split, lalu tekan Tambah Tahap untuk tiap tahap keluar (total menjadi Tara).
4. Daftar tahap split masuk (split_weights) dan keluar (split_weights_out) tampil pada nota dan Remote View.
2. Untuk tiap tahap kendaraan (mis. kendaraan panjang/gandeng), tekan Tambah Tahap — berat saat itu ditambahkan sebagai satu tahap; total semua tahap menjadi Bruto.
3. Timbang keluar juga bisa bertahap: pilih transaksi yang berjalan, centang Mode Split, lalu tekan Tambah Tahap untuk tiap tahap keluar (total menjadi Tara).
4. Daftar tahap split masuk (split_weights) dan keluar (split_weights_out) tampil pada nota dan Remote View.
Antrian Kendaraan
1. Panel kanan menampilkan kendaraan yang sedang diproses; gunakan kotak pencarian untuk memfilter cepat.
2. Model tampilan (combo "Tampilan"): Tabel, Kartu, Daftar Ringkas, atau Mode Monitor — pilihan tersimpan antar sesi.
3. Mode Kartu responsif: 3 kolom bila layar cukup lebar, 2 kolom bila sempit, menyesuaikan saat jendela di-resize.
4. Filter Terminal (Semua / terminal tertentu) tampil bila ada lebih dari satu terminal; saat memantau terminal jauh antrian dimuat ulang otomatis.
5. Klik baris untuk memuat data ke form; klik ganda untuk melihat isi muatan; tombol gear mengatur kolom yang tampil.
6. Beban antrian dikendalikan di Pengaturan > Terminal: Rentang Hari dan Maksimal Record (notifikasi beban berat default 1000 record).
2. Model tampilan (combo "Tampilan"): Tabel, Kartu, Daftar Ringkas, atau Mode Monitor — pilihan tersimpan antar sesi.
3. Mode Kartu responsif: 3 kolom bila layar cukup lebar, 2 kolom bila sempit, menyesuaikan saat jendela di-resize.
4. Filter Terminal (Semua / terminal tertentu) tampil bila ada lebih dari satu terminal; saat memantau terminal jauh antrian dimuat ulang otomatis.
5. Klik baris untuk memuat data ke form; klik ganda untuk melihat isi muatan; tombol gear mengatur kolom yang tampil.
6. Beban antrian dikendalikan di Pengaturan > Terminal: Rentang Hari dan Maksimal Record (notifikasi beban berat default 1000 record).
Butuh bantuan lebih lanjut?
Hubungi tim dukungan Kieomo melalui email resmi info@kiemono.com.
Hubungi Kami