Membuat Sistem Antrean dengan CodeIgniter 4: Nomor Anti Dobel, Panggil Suara Bahasa Indonesia, dan Layar TV
Sistem antrean kelihatannya sederhana: ambil nomor, tunggu, dipanggil. Masalahnya baru muncul saat dipakai sungguhan. Dua kios ditekan bersamaan lalu keluar nomor yang sama, dua petugas memanggil pasien yang sama, atau pengumuman suara di TV tidak berbunyi karena diblokir browser.
Di tutorial ini kita bahas lima teknik inti untuk membuat sistem antrean klinik yang andal dengan CodeIgniter 4 dan MySQL. Contohnya diambil dari Sistem Antrean Klinik CodeIgniter 4 yang bisa kamu download gratis di Papicode (link di akhir artikel).
1. Struktur tabel: nomor dimulai dari 1 setiap hari
Simpan nomor sebagai angka biasa per tanggal dan per poli, lalu lindungi dengan kunci unik:
CREATE TABLE antrean (
id INT AUTO_INCREMENT PRIMARY KEY,
tanggal DATE NOT NULL,
poli_id INT NOT NULL,
nomor INT NOT NULL,
token CHAR(10) NOT NULL UNIQUE, -- untuk cek status dari HP
status ENUM('menunggu','dipanggil','selesai','lewat') NOT NULL DEFAULT 'menunggu',
loket VARCHAR(40) NOT NULL DEFAULT '',
dibuat_at DATETIME NOT NULL,
dipanggil_at DATETIME NULL,
UNIQUE KEY nomor_harian (tanggal, poli_id, nomor)
);
Tidak perlu cron untuk me-reset nomor tengah malam. Begitu tanggal berganti, MAX(nomor) untuk tanggal baru otomatis kosong dan nomor kembali ke 1. Kode tampilan seperti A-007 cukup dirakit saat ditampilkan:
public static function kode(array $a): string
{
return $a['kode_poli'] . '-' . str_pad((string) $a['nomor'], 3, '0', STR_PAD_LEFT);
}
2. Ambil nomor tanpa dobel: kunci baris poli
Cara naif SELECT MAX(nomor) + 1 lalu INSERT akan memberi nomor yang sama bila dua kios ditekan di milidetik yang sama. Mengunci hasil MAX() dengan FOR UPDATE juga bukan jawaban sempurna: pada nomor pertama hari itu, dua transaksi bisa saling menunggu sampai MySQL melaporkan deadlock.
Solusi yang lebih sederhana dan stabil adalah mengunci satu baris yang pasti ada, yaitu baris poli itu sendiri. Semua pengambilan nomor untuk poli yang sama jadi antre satu per satu:
$this->db->transStart();
$this->db->query('SELECT id FROM poli WHERE id = ? FOR UPDATE', [$poliId]); // "mutex" per poli
$akhir = (int) $this->db->query('SELECT MAX(nomor) n FROM antrean WHERE tanggal = ? AND poli_id = ?', [$hari, $poliId])->getRow()->n;
if ($poli['kuota'] > 0 && $akhir >= $poli['kuota']) {
throw new RuntimeException('Kuota hari ini sudah habis.');
}
$this->db->table('antrean')->insert([
'tanggal' => $hari, 'poli_id' => $poliId, 'nomor' => $akhir + 1,
'token' => bin2hex(random_bytes(5)), 'dibuat_at' => date('Y-m-d H:i:s'),
]);
$this->db->transComplete();
Poli yang berbeda tetap berjalan paralel karena barisnya berbeda. Pemeriksaan kuota juga aman karena berada di dalam transaksi yang sama. Di aplikasi, delapan permintaan serentak ke poli yang sama selalu menghasilkan nomor 1 sampai 8 tanpa ada yang dobel atau terlewat.
3. Panggil berikutnya untuk banyak loket
Poli umum sering punya dua ruang periksa. Kedua petugas bisa menekan Panggil berikutnya bersamaan, jadi kita pakai kunci yang sama:
public function panggilBerikutnya(int $poliId, string $loket, int $petugasId): ?array
{
$hari = date('Y-m-d');
$this->db->transStart();
$this->db->query('SELECT id FROM poli WHERE id = ? FOR UPDATE', [$poliId]);
// Pasien yang sedang dilayani di loket ini dianggap selesai
$this->db->query("UPDATE antrean SET status = 'selesai', selesai_at = NOW()
WHERE tanggal = ? AND poli_id = ? AND status = 'dipanggil' AND loket = ?", [$hari, $poliId, $loket]);
$a = $this->db->query("SELECT id FROM antrean WHERE tanggal = ? AND poli_id = ? AND status = 'menunggu'
ORDER BY nomor LIMIT 1", [$hari, $poliId])->getRowArray();
if ($a) $this->tandaiDipanggil((int) $a['id'], $loket, $petugasId);
$this->db->transComplete();
;
}
Petugas cukup menekan satu tombol untuk menyelesaikan pasien sekarang dan memanggil berikutnya. Pasien yang tidak hadir diberi status lewat, dan petugas bisa memanggilnya lagi bila ia datang belakangan.
4. Catat setiap panggilan, bukan hanya status
Layar TV perlu tahu kapan harus berbunyi, termasuk saat petugas menekan Panggil ulang. Kalau TV hanya membaca kolom status, panggil ulang tidak terdeteksi karena statusnya tetap dipanggil. Karena itu setiap panggilan dicatat sebagai baris baru:
private function tandaiDipanggil(int $id, string $loket, int $petugasId): void
{
$this->db->query("UPDATE antrean SET status = 'dipanggil', loket = ?, petugas_id = ?,
panggil_ke = panggil_ke + 1, dipanggil_at = COALESCE(dipanggil_at, NOW()) WHERE id = ?",
[$loket, $petugasId, $id]);
$this->db->table('panggilan')->insert(['antrean_id' => $id, 'waktu' => date('Y-m-d H:i:s'), 'loket' => $loket]);
}
Layar TV meminta data JSON setiap 2 detik dan cukup membandingkan id panggilan terakhir. Setiap id yang lebih besar berarti ada panggilan baru yang harus diumumkan.
if (terakhir !== null && p && p.id > terakhir)
j.panggilan.filter(x => x.id > terakhir).reverse().forEach(umumkan);
terakhir = Math.max(terakhir || 0, p ? p.id : 0);
Saat halaman pertama kali dibuka, terakhir masih null, jadi panggilan lama ditampilkan tanpa dibacakan ulang.
5. Suara panggilan Bahasa Indonesia di browser
Mesin suara browser (speechSynthesis) membaca "A-012" kurang jelas. Ubah angka menjadi kata lebih dulu:
var SATUAN = ['', 'satu', 'dua', 'tiga', 'empat', 'lima', 'enam', 'tujuh', 'delapan', 'sembilan', 'sepuluh', 'sebelas'];
function terbilang(n) {
if (n < 12) return SATUAN[n];
if (n < 20) return SATUAN[n - 10] + ' belas';
if (n < 100) return SATUAN[Math.floor(n / 10)] + ' puluh ' + SATUAN[n % 10];
if (n < 200) return 'seratus ' + terbilang(n - 100);
return SATUAN[Math.floor(n / 100)] + ' ratus ' + terbilang(n % 100);
}
var kalimat = 'Nomor antrean, A, ' + terbilang() + ;
Dua hal penting di layar TV:
- Browser memblokir suara sebelum ada klik. Tampilkan tombol "Aktifkan suara" yang membuat
AudioContextsekali saja. Setelah itu nada dan suara boleh diputar kapan pun. - Gunakan antrean Promise supaya dua panggilan yang datang hampir bersamaan dibacakan bergantian, bukan bertumpuk:
antre = antre.then(dingdong).then(() => ucap(kalimat)).
Ringkasan
- Nomor disimpan per tanggal + poli dengan kunci unik, sehingga reset harian terjadi otomatis.
- Kunci baris poli dengan
FOR UPDATEsaat mengambil nomor dan memanggil, agar tidak dobel dan tidak terjadi deadlock. - Panggil berikutnya sekaligus menyelesaikan pasien sebelumnya di loket yang sama.
- Catat setiap panggilan di tabel tersendiri agar layar TV juga mengumumkan panggil ulang.
- Ubah angka menjadi kata sebelum dibacakan, aktifkan audio lewat satu klik, dan bacakan lewat antrean Promise.
Download source code lengkapnya
Semua teknik di atas sudah dipakai di Sistem Antrean Klinik CodeIgniter 4 & MySQL: kios layar sentuh, tiket 58 mm ber-QR, cek antrean dari HP, layar TV dengan suara panggilan, halaman loket untuk banyak ruang, kuota harian, laporan waktu tunggu, dan pengaturan poli serta petugas. Tampilannya ramah dengan font Montserrat dan langsung jalan di XAMPP lewat setup.bat.
Source code lengkapnya gratis
Lihat semua yang dibahas di artikel ini langsung berjalan.