Pratinjau terbatas — dokumentasi ini masih berstatus draf dan belum diterbitkan.
KonsepMenengah5 menitOwnerAdminManajer

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.

Status: Draf — belum diterbitkanTerverifikasi di UI · 2026-10-26
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".

Lease kedaluwarsa dan status Perlu takeover.

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.