HandyCafe Docs
owner cashier

بسته‌های زمانی

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

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

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

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

فیلدهای اعتبار زمانی

هر رکورد اعتبار زمانی شامل:

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

انواع اعتبار

هر اعتبار زمانی نحوه ایجادش را پیگیری می‌کند:

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

وضعیت اعتبار

هر اعتبار زمانی از وضعیت‌های زیر عبور می‌کند:

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

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

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

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

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

پیگیری مصرف

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

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

انواع زمینه

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

یکپارچگی با بسته‌های کمپین

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

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

نحوه کسر زمان در نشست

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

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

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