Klien Lawas

HandyCafe dapat mengelola instalasi klien V3 dan V4 bersama klien modern pada server yang sama. Klien lawas muncul di Panel Admin sebagai tipe kartu tersendiri, dengan set aksi yang lebih terbatas dan menyesuaikan apa yang didukung protokol asli.

Sebelum Anda bisa melihat klien lawas di Panel Admin, aktifkan dukungan runtime di Pengaturan > Klien Lawas.

Cara Klien Lawas Muncul

Klien lawas terhubung ke server melalui protokol UDP multicast asli. Mereka tidak memakai mDNS seperti klien modern. Sebagai gantinya, server menemukan mereka dengan dua cara:

Jalur Penemuan	Pemicu
TCP Login	Klien mengirim LoginRequest pada port perintah TCP. Server mencatat peer lalu memancarkan event connected.
UDP Ping	Klien menyiarkan frame Ping pada multicast group. Server menerimanya, memperbarui catatan peer, lalu memancarkan event online.

Status per MAC disimpan di store klien lawas bersama IP, hostname, pengguna yang masuk, versi klien, timer sesi, dan cap waktu last seen. Setiap frame masuk mengatur ulang timer inaktivitas. Jika timer habis tanpa traffic (default 10 detik), klien ditandai offline. Catatan tetap bertahan di database sehingga riwayat tidak hilang.

Kartu Klien Lawas

Setiap klien lawas dirender sebagai kartu yang berbeda dari kartu klien modern. Header menampilkan nama tampilan (hostname bila ada, MAC bila tidak), badge online atau offline dengan warna, dan label status.

Warna dan Label Status

Status	Warna	Arti
Online	Hijau	Sesi aktif sedang berjalan.
Idle	Sian	Klien terhubung dan menunggu. Tidak ada sesi aktif.
Paused	Amber	Sesi dijeda. Penagihan dihentikan.
Busy	Ungu	Klien sedang memproses permintaan.
Payment	Rose	Klien berada dalam alur pembayaran.
Admin	Indigo	Klien berada dalam mode admin atau pemeliharaan.
Offline	Abu-abu	Tidak ada traffic baru. Aksi dinonaktifkan sampai klien kembali online.
Timed	Biru langit	Sesi berbatas waktu sedang berjalan dengan tenggat.

Jam Sesi

Saat sesi aktif, kartu menampilkan blok jam:

Waktu mulai.
Waktu selesai (untuk sesi berbatas waktu).
Menit terpakai.
Menit tersisa dengan hitung mundur live.
Biaya yang sudah terakumulasi.

Info Identitas

Kartu selalu menampilkan:

Alamat MAC.
Alamat IP.
Versi klien (misalnya "3.4.01").
User yang login jika ada.

Toolbar Aksi

Saat klien online, toolbar aksi di bawah info identitas menawarkan operasi yang tersedia.

Kontrol Sesi

Tombol	Tampil Saat	Perilaku
Masuk	Status idle	Membuka dialog Login Perangkat. Pilih menit dan metode pembayaran. Server mengirim perintah Masuk dengan nilai yang dipilih. Sesi dimulai di klien.
Keluar	Status online, berbatas waktu, dijeda, sibuk, atau pembayaran	Jika sesi bersifat postpaid, dialog pembayaran mengumpulkan jumlah dan metode. Sebuah transaksi ditulis ke buku besar. Server mengirim perintah Keluar. Sesi ditutup di klien.

Tambah Waktu

Membuka pemilih menit. Menerima nilai positif (memperpanjang) atau negatif (mengurangi). Batas maksimum besarnya 10.000 menit ke arah mana pun. Berfungsi untuk sesi prepaid dan postpaid.

Jika Anda mengonfigurasi nilai menit preset di pengaturan harga, kartu juga menampilkan baris tombol preset. Ketuk preset untuk menerapkan nilai tanpa membuka pemilih.

Tangkapan Layar

Meminta screenshot live dari klien lawas melalui port transfer file. Alurnya:

Server mengirim command permintaan screenshot.
Klien membuka TCP listener sementara pada port ephemeral.
Server menyambung, mengirim header transfer file 9 byte, lalu menunggu.
Klien menangkap layar, meng-encode-nya sebagai BMP terkompresi, lalu mengalirkannya kembali.
Server mendekompresi BMP dan menyimpannya di folder legacy_screenshots di dalam direktori data HandyCafe Anda.
Penampil screenshot terbuka dengan gambar baru.

Jika klien tidak merespons dalam batas waktu (default 30 detik untuk menyambung, 20 detik untuk data), permintaan gagal dan toast error muncul. Anda bisa mencoba lagi segera.

Aksi Daya

Aksi	Konfirmasi	Dampak
Keluar	Tidak ada	Mengeluarkan pengguna Windows di mesin klien. Sesi Windows berakhir tetapi komputer tetap menyala.
Mulai Ulang	Ya	Mengirim perintah mulai ulang. Mesin klien restart.
Matikan	Ya	Mengirim perintah mematikan. Mesin klien mati.

Mulai Ulang dan Matikan menampilkan dialog konfirmasi untuk mencegah aksi daya yang tidak sengaja.

Operasi yang Tidak Didukung

Klien lawas tidak mendukung semua fitur yang tersedia di klien HandyCafe modern. Kesenjangan utamanya:

Tidak ada penyesuaian jeda di tengah sesi. Perubahan waktu yang dikirim saat sesi dijeda akan masuk antrean, tetapi klien bisa mengabaikannya. Lanjutkan sesi terlebih dahulu, terapkan perubahan, lalu jeda lagi jika perlu.
Tidak ada mode Admin via command server. Status admin internal klien tidak bisa di-toggle dari server. Mode admin hanya dikontrol di mesin klien itu sendiri.
Tidak ada registrasi lisensi dari server. Server hanya mencerminkan byte lisensi yang dilihatnya dalam frame klien, tetapi tidak bisa mendorong lisensi baru ke klien. Registrasikan klien secara lokal.
Tidak ada integrasi dompet anggota untuk sesi yang dimulai di klien lawas. Pembayaran dicatat sebagai baris transactions biasa dengan transaction_type=sessions dan MAC klien. Alur dompet modern tidak berlaku.
Tidak ada remote desktop. Fitur remote desktop memakai jalur streaming UDP yang tidak ada pada klien lawas.
Tidak ada sinkronisasi file dorong. Sync Explorer hanya mendorong file melalui protokol modern.

Untuk fungsi penuh, migrasikan ke klien HandyCafe modern bila memungkinkan.

Perilaku Offline

Saat timeout inaktivitas habis, kartu menjadi redup, badge status berubah abu-abu, dan setiap tombol aksi dinonaktifkan. Catatan klien tetap ada di store sehingga riwayat, MAC, hostname, dan data last seen tetap terjaga. Saat klien kembali online (UDP ping baru atau TCP login), kartu hidup kembali dan aksi menjadi tersedia lagi.

Catatan tidak dihapus otomatis. Untuk menghapus klien lama secara permanen, edit dari database admin atau hapus melalui alat admin yang relevan.

Tips

Pertahankan batas waktu inaktivitas di 10 detik kecuali Anda tahu klien lawas Anda melakukan beacon lebih lambat dari itu. Timeout yang terlalu pendek akan menandai klien sehat sebagai offline saat ada gangguan jaringan singkat.
Jika klien lawas terlihat online tetapi tidak merespons perintah, konfirmasi Varian Protokol di Pengaturan. Ketidaksesuaian antara varian server (STE vs Standard) dan build klien akan menyebabkan perintah dibuang tanpa suara.
Screenshot dari klien lawas adalah BMP terkompresi, yang ukurannya lebih besar daripada capture PNG modern. Simpan folder legacy_screenshots di drive dengan ruang kosong yang memadai jika Anda mengambil banyak capture.
Gunakan Tambah Waktu dengan tombol preset saat pergantian shift. Satu ketukan memperpanjang sesi dengan increment yang sudah ditentukan, lebih cepat daripada mengetik menit secara manual.
Pensiunkan klien lawas secara bertahap. Migrasikan satu batch pada satu waktu, konfirmasi klien baru bekerja identik di Panel Admin, lalu baru nonaktifkan yang lama.