HandyCafe Docs
owner cashier

Pengurusan Ahli

Ahli ialah pelanggan berdaftar di kafe internet atau pusat permainan anda. Profil ahli menyimpan identiti pelanggan, maklumat perhubungan, kelayakan log masuk dan keutamaan pengebilan. Ahli boleh log masuk dari PC klien, mengumpul baki dompet, membeli pakej masa, memperoleh mata kesetiaan dan menerima diskaun berdasarkan tahap pada sesi dan pesanan.

Medan Profil Ahli

Setiap rekod ahli mengandungi maklumat berikut:

  • Nama pengguna: Pengecam unik yang tidak sensitif huruf besar yang ahli gunakan untuk log masuk di PC klien. Setelah dicipta, nama pengguna tidak boleh diduplikasi merentas sistem.
  • Nama paparan: Nama yang ditunjukkan dalam Panel Pentadbir, senarai sesi dan sapaan di sisi klien. Ini adalah medan wajib.
  • Kata laluan: Ahli boleh menetapkan kata laluan untuk log masuk layan diri di PC klien. Kata laluan disimpan sebagai hash dan boleh dibiarkan kosong pada awalnya (ahli menetapkannya pada log masuk pertama).
  • E-mel: Alamat e-mel pilihan. Keterlihatan dikawal oleh kebenaran DISPLAY_EMAIL.
  • Telefon bimbit: Nombor telefon pilihan. Keterlihatan dikawal oleh kebenaran DISPLAY_GSM.
  • Avatar: URL imej profil yang dipaparkan pada skrin kunci klien dan dalam senarai ahli.
  • Jantina: Lalai kepada "tidak diketahui". Boleh ditetapkan kepada lelaki, perempuan atau lain-lain untuk penapisan demografi.
  • Memo: Medan nota teks bebas untuk kegunaan dalaman. Hanya boleh dilihat oleh kakitangan, bukan oleh ahli.

Keadaan Ahli

Setiap ahli mempunyai dua bendera keadaan bebas:

Aktif / Tidak Aktif

Togol aktif/tidak aktif mengawal sama ada ahli muncul dalam hasil carian standard dan boleh berinteraksi dengan sistem. Menyahaktifkan ahli ialah pemadaman lembut. Profil dan semua data berkaitan (kredit dompet, kredit masa, sejarah sesi) disimpan tetapi ahli disembunyikan daripada operasi harian.

Kebenaran Log Masuk

Bendera can_login mengawal sama ada ahli dibenarkan log masuk dari PC klien. Ahli boleh aktif (boleh dilihat dalam sistem) tetapi mempunyai log masuk dilumpuhkan, berguna untuk ahli dengan hutang tertunggak atau pelanggaran polisi.

Penetapan Tahap

Setiap ahli boleh ditetapkan kepada tahap kesetiaan. Tahap menentukan:

  • Diskaun dalam BPS: Diskaun mata asas yang dikenakan pada penetapan harga sesi. Sebagai contoh, tahap dengan discount_bps = 500 memberi ahli diskaun 5% pada kadar sejam.
  • Label peranan: Label deskriptif (seperti Perak, Emas, VIP) yang ditunjukkan dalam kad profil ahli dan dalam panel sesi.

Penetapan tahap boleh secara manual atau automatik berdasarkan sistem mata kesetiaan. Lihat halaman Tahap Kesetiaan untuk butiran tentang cara tahap dikonfigurasikan dan cara ahli maju melaluinya.

Baki Masa dan Skop Peranti

Baki masa seorang ahli bukan satu nombor tunggal. Masa disimpan dalam lot. Setiap lot boleh digunakan pada PC sahaja, pada konsol sahaja atau pada kedua-duanya. Baldi ini tidak bertindih. Jumlah baki ialah hasil tambah biasa kesemuanya.

Apa yang ahli benar-benar boleh belanjakan bergantung pada tempat mereka duduk:

Tempat duduk Masa yang boleh digunakan
Sebuah PC Lot PC sahaja ditambah lot dua peranti
Sebuah konsol Lot konsol sahaja ditambah lot dua peranti

Panel keahlian memaparkan jumlah baki dan, secara berasingan, berapa banyak daripadanya yang boleh digunakan pada PC dan pada konsol. Semasa ahli sedang duduk, ia turut memaparkan berapa banyak yang boleh digunakan di tempat duduk itu, dikira dengan kumpulan harga dan skop peranti yang mereka gunakan. Lencana itu hilang apabila mereka meninggalkan tempat duduk.

Inilah sebabnya seorang ahli boleh memiliki 480 minit secara keseluruhan sedangkan hanya beberapa minit tersedia pada mesin di hadapan mereka. Pakej berskop konsol tidak bernilai apa-apa pada sebuah PC.

Jika sesi dibuka pada peranti yang tidak dilindungi oleh mana-mana masa ahli tersebut, panel akan memaparkan Masa ahli tidak boleh digunakan pada peranti ini.

Masa yang akan luput

Panel menamakan tempoh luput seterusnya sebagai satu kumpulan dan bukan sebagai lot tunggal. Setiap lot yang luput pada saat yang sama dicampurkan dan dipecahkan mengikut skop. Oleh itu amaran tersebut menggambarkan keseluruhan jumlah yang bakal hilang.

Kad Ahli

Seorang ahli boleh diberikan kad NFC atau RFID yang membuka sesi dengan satu ketukan dan bukannya nama pengguna serta kata laluan. Kad diberikan, dipulangkan dan dibatalkan dari panel ahli tersebut. Lihat Kad Ahli.

Had Sambungan Serentak

Medan max_connection menetapkan bilangan maksimum sesi aktif serentak yang ahli boleh miliki merentas semua PC klien. Nilai lalai ialah 1, bermakna ahli hanya boleh dilog masuk ke satu PC pada satu masa. Jika ahli cuba log masuk pada PC kedua semasa sudah dalam sesi aktif, sistem akan menolak log masuk.

Meningkatkan nilai ini berguna untuk ahli yang mengurus berbilang mesin (seperti akaun kakitangan) atau untuk tahap keahlian khas yang membenarkan penggunaan berbilang peranti.

Mencari dan Menapis Ahli

Halaman Ahli menyediakan senarai tatal maya yang mengendalikan pangkalan data ahli yang besar dengan cekap. Anda boleh:

  • Cari: Taip dalam bar carian untuk menapis mengikut nama pengguna, nama paparan, e-mel atau nombor telefon bimbit. Carian tidak sensitif huruf besar dan mengemas kini hasil secara masa nyata.
  • Tapis mengikut status: Togol antara menunjukkan semua ahli, hanya ahli aktif atau hanya ahli tidak aktif.
  • Isih: Klik pengepala lajur untuk mengisih mengikut nama, tarikh terakhir dilihat atau tarikh penciptaan.

Pelaksanaan tatal maya hanya memuatkan bahagian senarai ahli yang kelihatan ke dalam memori supaya prestasi kekal lancar walaupun dengan puluhan ribu ahli berdaftar.

Penunjuk Status Dalam Talian

Apabila ahli sedang dilog masuk ke PC klien atau mempunyai sesi konsol aktif, profil mereka menunjukkan penunjuk dalam talian hijau dalam senarai ahli. Penunjuk juga memaparkan klien atau konsol tertentu mana yang ahli sedang gunakan supaya kakitangan boleh mencari pelanggan dengan cepat.

Mencipta Ahli Baharu

Untuk mencipta ahli baharu:

  1. Navigasi ke halaman Ahli dari bar sisi.
  2. Klik butang Tambah Ahli dalam bar alat.
  3. Isi sekurang-kurangnya nama paparan (wajib) dan secara pilihan nama pengguna untuk log masuk.
  4. Tetapkan tahap jika berkenaan atau biarkan pada nilai lalai.
  5. Laraskan nilai sambungan maksimum jika lalai 1 tidak sesuai.
  6. Klik Simpan untuk mencipta ahli.

Sistem secara automatik menjana ID unik untuk ahli dan merekodkan identiti juruwang yang mencipta.

Menyunting Ahli

Pilih ahli dari senarai untuk membuka paparan butiran profil mereka. Dari sini anda boleh:

  • Kemas kini mana-mana medan profil (nama paparan, e-mel, telefon bimbit, jantina, memo).
  • Tukar penetapan tahap ahli.
  • Togol bendera aktif dan can_login.
  • Tetapkan semula atau tukar kata laluan ahli.
  • Laraskan had sambungan serentak.

Semua perubahan disimpan serta-merta dan entri log audit dicipta.

Memadamkan Ahli

Memadamkan ahli membuang profil mereka dari sistem aktif. Tindakan ini memerlukan kebenaran MEMBER_DELETE. Seorang ahli boleh dipadam walaupun mereka mempunyai sesi lampau atau sejarah log masuk. Sejarah sesi dan transaksi disimpan untuk tujuan pelaporan tetapi tidak lagi dipautkan kepada profil ahli. Baki dompet dan kredit masa dibuang bersama profil. Untuk mengekalkan rekod penuh seorang ahli, nyahaktifkan mereka dan bukannya memadamnya.

Keperluan Kebenaran

Akses kepada ciri pengurusan ahli dikawal oleh kebenaran berikut pada peranan juruwang:

Kebenaran Memberi
MEMBER_VIEW Lihat senarai ahli dan cari ahli
MEMBER_ADD Cipta profil ahli baharu
MEMBER_UPDATE Sunting profil ahli sedia ada
MEMBER_DELETE Padamkan profil ahli
DISPLAY_EMAIL Lihat alamat e-mel ahli dalam paparan butiran
DISPLAY_GSM Lihat nombor telefon bimbit ahli dalam paparan butiran

Jika peranan juruwang tidak menyertakan DISPLAY_EMAIL atau DISPLAY_GSM, medan tersebut disembunyikan dalam panel butiran ahli walaupun data wujud dalam pangkalan data.