Memahami Lease, Heartbeat, dan Epoch Sesi Register
Penjelasan sederhana masa sewa sesi, detak, dan nomor epoch yang menentukan siapa yang sah memegang register serta kapan takeover diperlukan.
Kata kunci: lease, heartbeat, epoch, masa sewa sesi, takeover. Modul: Shift & Operasional.
Di halaman ini
Penjelasan sederhana#
Bayangkan register sebagai laci kasir. Sesi adalah peminjaman kunci laci itu. Tiga istilah menjelaskannya:
- Lease (masa sewa): batas waktu peminjaman. Bila tidak diperpanjang, sewa habis.
- Heartbeat / HB (detak): sinyal "saya masih di sini" yang dikirim aplikasi kasir secara berkala untuk memperpanjang lease.
- Epoch: nomor urut kepemilikan sesi. Setiap kali sesi dipindahkan (takeover), epoch naik satu. Server hanya menerima tindakan yang membawa epoch terbaru.
Ketiganya mencegah dua masalah: dua perangkat memakai satu register bersamaan, dan perangkat lama yang "bangun kembali" mengirim transaksi dengan hak yang sudah dicabut.
Di layar#
Pada tabel Sesi Register, kolom HEARTBEAT / LEASE memuat "HB: (waktu detak terakhir)" dan "Lease s/d: (batas)". Saat batas itu lewat, baris menulis Lease kedaluwarsa berwarna merah dan statusnya Perlu takeover (teramati pada sesi yang ada). Epoch tampil di kolom pemegang, misalnya "epoch 1".
Contoh#
Angka berikut ilustrasi. Masa sewa 120 detik, detak terakhir 13:49:00, sehingga sewa habis 13:51:00. Pukul 13:50:30 sesi masih aktif; pukul 13:52:00 statusnya Perlu takeover. Bila kasir lain membuka register pukul 13:55:00, epoch naik menjadi 2 dan perangkat lama yang masih memegang epoch 1 ditolak server.
Hal yang perlu diingat#
- Masa sewa bawaan 120 detik, minimal 15 detik, dapat diatur per outlet atau register di Pengaturan › Kebijakan POS.
- Takeover biasa hanya bila masa sewa sudah habis; takeover darurat (Manajer ke atas) dapat memaksa saat masih berjalan.
- Backoffice tidak mengirim detak. Sesi hasil takeover dari Backoffice akan kedaluwarsa sendiri.
- "Epoch kasir" pada halaman Shift Kasir adalah hal lain: naik saat serah terima kasir, bukan saat sesi register berpindah.