HandyCafe Docs
owner cashier

کیف پول عضو

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

معماری مبتنی بر اعتبار

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

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

موجودی کل کیف پول عضو مجموع تمام مقادیر باقی‌مانده در ورودی‌های اعتبار فعال اوست.

انواع اعتبار

هر اعتبار کیف پول دارای نوع اعتبار است که نشان می‌دهد وجوه چگونه وارد سیستم شده:

نوع اعتبار توضیحات
پرداخت‌شده عضو برای این وجوه پرداخت کرده (نقدی، کارتی یا روش پرداخت دیگر). هنگام خرید بسته پولی کمپین ایجاد می‌شود.
جایزه وجوه تبلیغاتی اعطاشده به‌عنوان بخشی از خرید بسته. مثلا "۱۰۰ دقیقه بخرید، ۲۰ دقیقه جایزه اعتبار بگیرید."
دستی به‌صورت دستی توسط صندوق‌دار یا مدیر بارگذاری شده. برای اعتبارهای حسن‌نیت یا ترتیبات ویژه استفاده می‌شود.
اصلاح تنظیم مدیریتی برای رفع خطا در موجودی عضو.
مهاجرت وجوه وارداتی از سیستم قبلی هنگام انتقال داده‌ها.
بازگشت استرداد وجوه بازگشتی هنگام ابطال استردادی که قبلا صادر شده.

نوع اعتبار هنگام ایجاد تنظیم شده و قابل تغییر نیست. به‌عنوان مسیر حسابرسی دائمی عمل می‌کند.

وضعیت اعتبار

هر اعتبار کیف پول یک چرخه عمر با وضعیت‌های زیر طی می‌کند:

  • فعال: اعتبار وجوه باقی‌مانده دارد و منقضی نشده. وجوه قابل مصرف هستند.
  • منقضی: تاریخ انقضای اعتبار گذشته. وجوه باقی‌مانده دیگر قابل استفاده نیستند.
  • مصرف‌شده: موجودی باقی‌مانده اعتبار از طریق مصرف عادی به صفر رسیده.
  • لغو: اعتبار به‌صورت دستی توسط مدیر لغو شده و وجوه باقی‌مانده باطل شده.

مصرف کیف پول

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

هر رکورد مصرف شامل زمینه‌ای است که مشخص می‌کند چه چیزی کسر را فعال کرده:

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

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

گزارش موجودی

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

نوع رویداد توضیحات
بارگذاری وجوه به کیف پول اضافه شده (ورودی اعتبار جدید ایجاد یا موجودی شارژ شده).
هزینه وجوه از کیف پول مصرف شده (پرداخت نشست، پرداخت سفارش).
استرداد وجوه به کیف پول بازگشته (استرداد سفارش، استرداد نشست).
تنظیم تغییر مدیریتی در موجودی (اصلاح، حذف).

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

محدودیت دستگاه

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

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

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

دسته‌بندی کیف پول و هزینه بین‌دسته‌ای

اعتبارهای کیف پول می‌توانند با دسته‌بندی کیف پول (مثلا "بازی" یا "عمومی") برچسب‌گذاری شوند. این به کافه امکان ایجاد مخازن موجودی جداگانه‌ای می‌دهد که فقط در زمینه‌های خاص قابل هزینه هستند.

گزینه هزینه بین‌دسته‌ای روی هر اعتبار کنترل می‌کند آیا وجوه آن خارج از دسته‌بندی تعیین‌شده قابل استفاده باشند:

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

اگر اعتباری دسته‌بندی کیف پول نداشته باشد، به‌عنوان اعتبار عمومی تلقی شده و توسط هر تراکنشی صرف‌نظر از دسته‌بندی قابل مصرف است.

نحوه شارژ

وجوه کیف پول از چندین روش قابل افزودن هستند:

  1. خرید بسته کمپین: هنگامی که عضو بسته پولی از کمپین خریداری می‌کند، سیستم به‌صورت خودکار اعتبارهای کیف پول بر اساس تعریف بسته ایجاد می‌کند. یک خرید بسته ممکن است چندین اعتبار ایجاد کند (یکی برای بخش پرداخت‌شده و یکی برای بخش جایزه).

  2. بارگذاری دستی: صندوق‌دار می‌تواند به‌صورت دستی از پنل جزئیات عضو وجوه به کیف پول عضو اضافه کند. این ورودی اعتبار با نوع "دستی" ایجاد می‌کند.

  3. مهاجرت: در طول راه‌اندازی سیستم، موجودی‌های موجود از سیستم قبلی می‌توانند به‌عنوان ورودی‌های اعتبار با نوع "مهاجرت" وارد شوند.

نحوه مصرف کیف پول در نشست

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

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