HandyCafe Docs
owner cashier

مدیریت اعضا

اعضا مشتریان ثبت‌شده در کافی‌نت یا گیمینگ سنتر شما هستند. پروفایل عضو هویت، اطلاعات تماس، اطلاعات ورود و ترجیحات صورت‌حساب مشتری را ذخیره می‌کند. اعضا می‌توانند از رایانه‌های کلاینت وارد شوند، موجودی کیف پول جمع کنند، بسته‌های زمانی خریداری کنند، امتیاز وفاداری کسب کنند و تخفیف‌های مبتنی بر سطح روی نشست‌ها و سفارش‌ها دریافت کنند.

فیلدهای پروفایل عضو

هر رکورد عضو اطلاعات زیر را شامل می‌شود:

  • نام کاربری: شناسه منحصربه‌فرد غیرحساس به حروف بزرگ و کوچک که عضو برای ورود در رایانه‌های کلاینت استفاده می‌کند. پس از ایجاد، نام کاربری نمی‌تواند تکراری باشد.
  • نام نمایشی: نامی که در پنل مدیر، فهرست نشست‌ها و خوشامدگویی سمت کلاینت نمایش داده می‌شود. این فیلد الزامی است.
  • رمز عبور: اعضا می‌توانند رمز عبوری برای ورود سلف‌سرویس در رایانه‌های کلاینت تنظیم کنند. رمز عبور به‌صورت هش ذخیره شده و می‌تواند ابتدا خالی باشد (عضو در اولین ورود تنظیم می‌کند).
  • ایمیل: آدرس ایمیل اختیاری. قابلیت مشاهده با مجوز DISPLAY_EMAIL کنترل می‌شود.
  • تلفن همراه: شماره تلفن اختیاری. قابلیت مشاهده با مجوز DISPLAY_GSM کنترل می‌شود.
  • آواتار: آدرس تصویر پروفایل که روی صفحه قفل کلاینت و فهرست اعضا نمایش داده می‌شود.
  • جنسیت: پیش‌فرض "نامشخص". قابل تنظیم به مرد، زن یا سایر برای فیلتر جمعیتی.
  • یادداشت: فیلد متنی آزاد برای استفاده داخلی. فقط برای کارکنان قابل مشاهده است نه عضو.

وضعیت‌های عضو

هر عضو دو پرچم وضعیت مستقل دارد:

فعال / غیرفعال

کلید فعال/غیرفعال کنترل می‌کند آیا عضو در نتایج جستجوی استاندارد ظاهر شده و بتواند با سیستم تعامل کند. غیرفعال کردن عضو حذف نرم است. پروفایل و تمام داده‌های مرتبط (اعتبارهای کیف پول، اعتبارهای زمانی، سابقه نشست) حفظ شده اما عضو از عملیات روزمره پنهان می‌شود.

مجوز ورود

پرچم can_login کنترل می‌کند آیا عضو مجاز به ورود از رایانه‌های کلاینت باشد. عضوی می‌تواند فعال (در سیستم قابل مشاهده) باشد اما ورودش غیرفعال شده باشد که برای اعضای دارای بدهی معوقه یا نقض سیاست مفید است.

اختصاص سطح

هر عضو می‌تواند به یک سطح وفاداری اختصاص یابد. سطح تعیین می‌کند:

  • تخفیف BPS: تخفیف به واحد BPS که به قیمت‌گذاری نشست اعمال می‌شود. مثلا سطحی با discount_bps = 500 به عضو ۵ درصد تخفیف روی نرخ ساعتی می‌دهد.
  • برچسب نقش: برچسب توصیفی (مانند نقره‌ای، طلایی، VIP) که در کارت پروفایل عضو و پنل‌های نشست نمایش داده می‌شود.

اختصاص سطح می‌تواند دستی یا خودکار بر اساس سیستم امتیاز وفاداری باشد. برای جزئیات، صفحه سطوح وفاداری را مشاهده کنید.

حداکثر اتصال هم‌زمان

فیلد max_connection حداکثر تعداد نشست‌های فعال هم‌زمان عضو را در تمام رایانه‌های کلاینت تنظیم می‌کند. مقدار پیش‌فرض ۱ است یعنی عضو فقط می‌تواند در یک رایانه وارد شده باشد. اگر عضو بخواهد در رایانه دوم وارد شود در حالی که نشست فعالی دارد، سیستم ورود را رد می‌کند.

افزایش این مقدار برای اعضایی که چندین دستگاه مدیریت می‌کنند (مانند حساب‌های کارکنان) یا سطوح عضویت ویژه که استفاده چنددستگاهی مجاز است مفید خواهد بود.

جستجو و فیلتر اعضا

صفحه اعضا فهرستی با اسکرول مجازی فراهم می‌کند که پایگاه داده بزرگ اعضا را به‌صورت کارآمد مدیریت می‌کند. می‌توانید:

  • جستجو: در نوار جستجو تایپ کنید تا بر اساس نام کاربری، نام نمایشی، ایمیل یا شماره تلفن فیلتر شود. جستجو غیرحساس به حروف بوده و نتایج را بلادرنگ به‌روزرسانی می‌کند.
  • فیلتر بر اساس وضعیت: بین نمایش تمام اعضا، فقط اعضای فعال یا فقط اعضای غیرفعال جابه‌جا شوید.
  • مرتب‌سازی: روی سرستون‌ها کلیک کنید تا بر اساس نام، تاریخ آخرین مشاهده یا تاریخ ایجاد مرتب شود.

پیاده‌سازی اسکرول مجازی فقط بخش قابل مشاهده فهرست اعضا را در حافظه بارگذاری می‌کند تا عملکرد حتی با ده‌ها هزار عضو ثبت‌شده روان باقی بماند.

نشانگر وضعیت آنلاین

هنگامی که عضوی در رایانه کلاینت وارد شده یا نشست کنسول فعالی دارد، پروفایل او نشانگر سبز آنلاین را در فهرست اعضا نشان می‌دهد. نشانگر همچنین نمایش می‌دهد عضو در حال حاضر از کدام کلاینت یا کنسول خاص استفاده می‌کند تا کارکنان بتوانند مشتری را به‌سرعت پیدا کنند.

ایجاد عضو جدید

برای ایجاد عضو جدید:

  1. از نوار کناری به صفحه اعضا بروید.
  2. روی دکمه افزودن عضو در نوار ابزار کلیک کنید.
  3. حداقل نام نمایشی (الزامی) و به‌صورت اختیاری نام کاربری برای ورود را وارد کنید.
  4. در صورت نیاز سطح تنظیم کنید یا در پیش‌فرض بگذارید.
  5. مقدار حداکثر اتصال را در صورت نامناسب بودن پیش‌فرض ۱ تنظیم کنید.
  6. روی ذخیره کلیک کنید تا عضو ایجاد شود.

سیستم به‌صورت خودکار یک شناسه منحصربه‌فرد برای عضو تولید کرده و هویت صندوق‌دار ایجادکننده را ثبت می‌کند.

ویرایش عضو

عضوی را از فهرست انتخاب کنید تا نمای جزئیات پروفایل باز شود. از اینجا می‌توانید:

  • هر فیلد پروفایل (نام نمایشی، ایمیل، تلفن، جنسیت، یادداشت) را به‌روزرسانی کنید.
  • اختصاص سطح عضو را تغییر دهید.
  • پرچم‌های فعال و مجوز ورود را تغییر دهید.
  • رمز عبور عضو را بازنشانی یا تغییر دهید.
  • حداکثر اتصال هم‌زمان را تنظیم کنید.

تمام تغییرات فورا ذخیره شده و ورودی گزارش حسابرسی ایجاد می‌شود.

حذف عضو

حذف عضو پروفایل او را از سیستم فعال حذف می‌کند. این عملیات نیازمند مجوز MEMBER_DELETE است. داده‌های مرتبط مانند سابقه نشست و رکوردهای کیف پول برای گزارش‌دهی حفظ شده اما دیگر به پروفایل عضو فعالی مرتبط نیستند.

مجوزهای لازم

دسترسی به قابلیت‌های مدیریت عضو با مجوزهای زیر روی نقش صندوق‌دار کنترل می‌شود:

مجوز دسترسی
MEMBER_VIEW مشاهده فهرست اعضا و جستجوی اعضا
MEMBER_ADD ایجاد پروفایل‌های عضو جدید
MEMBER_UPDATE ویرایش پروفایل‌های عضو موجود
MEMBER_DELETE حذف پروفایل‌های عضو
DISPLAY_EMAIL مشاهده آدرس ایمیل عضو در نمای جزئیات
DISPLAY_GSM مشاهده شماره تلفن عضو در نمای جزئیات

اگر نقش صندوق‌دار شامل DISPLAY_EMAIL یا DISPLAY_GSM نباشد، آن فیلدها در پنل جزئیات عضو پنهان هستند حتی اگر داده‌ها در پایگاه داده وجود داشته باشند.