Hong Kong Karaoke — Sistem Booking Room

Booking room karaoke untuk staf/kasir, berjalan di Vercel (Go serverless), data disimpan di Google Sheets, dan timer + alarm di TV setiap room.

Bagian	Lokasi	Keterangan
Halaman staf	/ (public/index.html)	Login username + PIN, jadwal per room, booking, check-in, perpanjang, check-out, batal, laporan, aktivitas, kelola room & user
Halaman TV	/tv?room=R01&key=... (public/tv.html)	Sisa waktu, peringatan 5 menit, alarm saat waktu habis
API	/api/* (api/index.go → pkg/httpapi)	Satu Go function di Vercel
Aturan bisnis	pkg/booking	Harga, cek bentrok, status, laporan
Penyimpanan	pkg/sheetstore	Google Sheets API
Aplikasi Android TV	android-tv/	APK WebView fullscreen, auto-start saat TV nyala

Tampilan

• Halaman staf: gaya terang dengan warna brand navy #1E3A8A, font Inter, menu di sidebar kiri (di HP menjadi menu lipat lewat tombol ☰).
• Jadwal punya dua tampilan (pilihan tersimpan di browser):
  • Timeline: baris per room, kolom per jam (default 10:00–02:00, melebar otomatis), garis merah = sekarang. Klik blok untuk detail dan aksi; klik area kosong untuk booking baru di room dan jam itu (dibulatkan ke 30 menit).
  • Kartu: tampilan per room seperti sebelumnya.
• Layar TV tetap gelap (navy) agar tidak menyilaukan di ruangan karaoke, dengan logo dan nama Hong Kong Karaoke.
• Nama dan warna brand ada di public/index.html, public/tv.html, public/css/app.css (--brand) dan public/css/tv.css.

WhatsApp ke tamu

Tombol WhatsApp di setiap booking (kartu, detail timeline, tab Daftar, kartu pengingat) membuka dialog pratinjau: nomor tujuan, jenis pesan, dan isi pesan yang bisa diedit. Buka WhatsApp membuka chat tamu di WhatsApp Web/Desktop/HP kasir dengan pesan terisi; staf menekan Kirim di WhatsApp. Sistem ini tidak mengirim pesan sendiri.

• Jenis pesan: Konfirmasi booking (Tentative menyebut batas tahan), Pengingat sebelum datang, Waktu hampir habis/perpanjangan, Terima kasih. Default dipilih dari status booking.
• Nomor dirapikan otomatis (0812… → 62812…, +62 … → 62…). Jika kolom HP kosong tetapi nomor terketik di kolom Nama, nomor itu dipakai.
• Form booking menolak nomor HP di kolom Nama tamu.
• Tidak tampil untuk Accounting.

Role dan hak akses

Aksi	Staff	Supervisor	Admin	Accounting
Lihat jadwal & daftar booking	✓	✓	✓	✓
Booking baru, check-in, perpanjang, check-out	✓	✓	✓
Konfirmasi Tentative, batalkan Tentative	✓	✓	✓
Batalkan booking Confirm		✓	✓
Booking Compliment (gratis, alasan wajib)	✓	✓	✓
Check-out lebih awal, tagih sesuai pemakaian		✓	✓
Laporan (harian atau rentang tanggal), log aktivitas		✓	✓	✓
Kelola room (tambah, ubah nama, aktif/nonaktif) dan tabel harga			✓
Kelola user (tambah, ubah role, nonaktifkan, reset PIN)			✓
Kelola TV (buat kode pairing, cabut TV)			✓
Unduh CSV (daftar booking, laporan)		✓	✓	✓

• Accounting hanya melihat dan mengunduh: tidak ada tombol aksi, tidak bisa membuat/mengubah booking, room, harga, user, atau TV (server menolak dengan 403), dan tidak mendapat pengingat/alarm. Nomor HP tamu tampil lengkap.
• Unduh CSV: tab Daftar (sesuai filter dan rentang tanggal, maks. 92 hari) dan tab Laporan. File UTF-8, dipisah koma. Sel yang diawali = + - @ diberi tanda ' agar tidak dijalankan sebagai rumus di Excel. Setiap unduhan tercatat di Aktivitas. Jika Excel menampilkan semua kolom dalam satu kolom (pengaturan wilayah Indonesia memakai ;), buka lewat Data → From Text/CSV dan pilih pemisah koma, atau buka di Google Sheets.
• Tabel hak akses ada di satu tempat: pkg/booking/roles.go. Server memeriksanya di setiap request; halaman web hanya menyembunyikan tombol.
• Role user dibaca ulang dari sheet di setiap request (cache 5 detik), jadi menonaktifkan user atau menurunkan role langsung berlaku.
• Semua user bisa mengganti PIN sendiri (tombol Ganti PIN). PIN 6-12 angka; angka sama (111111) atau berurutan (123456) ditolak.
• Admin tidak bisa menurunkan role atau menonaktifkan akun sendiri, dan harus selalu ada minimal satu admin aktif.
• Salah PIN 5 kali: username dikunci 5 menit.
• Login pertama: selama tab Users kosong, login dengan username admin dan PIN = ADMIN_PIN. Akun admin itu langsung tersimpan di sheet; ganti PIN-nya setelah login. Jika semua admin terkunci, kosongkan isi tab Users (sisakan header) untuk memakai ADMIN_PIN lagi.

Log aktivitas (tab Activity): login, ganti/reset PIN, booking baru, check-in, perpanjang, check-out, batal, perubahan room dan user, lengkap dengan waktu, username, dan detail (mis. tarif Rp100.000 -> Rp120.000). Booking juga menyimpan created_by, confirmed_by, checked_in_by, checked_out_by, cancelled_by, dan hold_until (batas tahan Tentative).

Alur booking

tentative ──konfirmasi──> booked (Confirm) ──check-in──> checked_in ──check-out──> finished
    │                         │                              └─ +30 / +1 jam (perpanjang)
    └──batal──> cancelled <───┘ batal

This is the beginning of the README. Read the rest at the original. Read the full README ↗