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.

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.

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 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. Data berkaitan seperti sejarah sesi dan rekod dompet disimpan untuk tujuan pelaporan tetapi tidak lagi dipautkan ke profil ahli aktif.

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.