HandyCafe Docs
owner cashier

Пакети часу

Пакети часу надають учасникам передплачений баланс хвилин. Замість погодинної оплати за стандартною ставкою учасник може придбати блок хвилин наперед та використовувати їх протягом кількох сеансів. Система відстежує залишок та автоматично списує хвилини по мірі використання ПК або консолей.

Система кредитів часу

Аналогічно системі гаманця, пакети часу використовують кредитну архітектуру. Кожне додавання часового балансу створює новий кредит часу. Кожен кредит -- незалежний запис з власним балансом хвилин, джерелом, терміном дії та обмеженнями за пристроєм.

Загальна кількість доступних хвилин учасника -- це сума залишків хвилин по всіх активних кредитах часу.

Поля кредиту часу

Кожен запис кредиту часу містить:

Поле Опис
Загальні хвилини Початкова кількість хвилин, завантажених у цей кредит при створенні.
Залишок хвилин Поточний баланс невикористаних хвилин. Зменшується по мірі використання сеансів.
Тип кредиту Як був створений цей кредит (див. Типи кредитів нижче).
Обмеження за пристроєм Які типи пристроїв можуть споживати з цього кредиту (див. нижче).
Статус Поточний стан життєвого циклу кредиту.
Термін дії Необов'язкова мітка часу закінчення. Після цієї дати залишок хвилин більше не може використовуватись.
ID покупки Якщо кредит створено з покупки пакета акції -- посилання на запис покупки.

Типи кредитів

Кожен кредит часу відстежує спосіб створення:

Тип кредиту Опис
Оплачений Учасник заплатив за ці хвилини через пряму покупку або як базове нарахування пакета акції.
Бонусний Промоційні хвилини, надані як бонус з покупкою пакета. Наприклад, "купи 120 хвилин, отримай 30 бонусних хвилин безкоштовно".
Ручний Хвилини, додані вручну касиром або адміністратором. Використовується для компенсаційних кредитів або спеціальних домовленостей.

Статус кредиту

Кожен кредит часу проходить через такі стани:

  • Активний: кредит має залишок хвилин та не прострочений. Хвилини можуть споживатися з цього кредиту.
  • Прострочений: дата закінчення кредиту минула. Будь-який залишок хвилин більше не доступний, навіть якщо баланс більше нуля.
  • Спожитий: залишок хвилин кредиту досяг нуля через нормальне використання.
  • Скасований: кредит вручну скасовано адміністратором, анулюючи будь-який залишок.

Обмеження за пристроями

Кожен кредит часу має обмеження за пристроєм, що контролює, які типи пристроїв можуть списувати з нього:

Обмеження Значення
Клієнт Використовується на клієнтських ПК. Також на консолях, якщо явно не обмежено.
Консоль Використовується на ігрових консолях. Також на ПК, якщо явно не обмежено.
Лише ПК Виключно для клієнтських ПК. Сеанси консолей не можуть списувати з цього кредиту.
Лише консолі Виключно для ігрових консолей. Сеанси ПК не можуть списувати з цього кредиту.
Обидва Використовується на будь-якому типі пристрою без обмежень. Значення за замовчуванням.

Обмеження встановлюється при створенні кредиту та не може бути змінене пізніше. Зазвичай успадковується від визначення пакета акції, що згенерував кредит.

Відстеження споживання

Кожного разу при списанні хвилин з кредиту часу система створює запис споживання часу:

Поле Опис
Спожиті хвилини Кількість списаних хвилин. Завжди позитивне ціле число.
Час споживання Мітка часу списання.
Контекст Що спричинило списання (див. нижче).
Посилання Посилання на конкретний сеанс, кредит або коригування, що спричинили списання.

Типи контексту

Контекст Опис
Використання сеансу Хвилини спожиті для оплати активного сеансу. Основний шлях споживання.
Закінчення терміну Хвилини прибрані при закінченні терміну дії кредиту або при коригуванні залишку.
Повернення Хвилини повернуті до кредиту як частина процесу повернення.

Інтеграція з пакетами акцій

Кредити часу найчастіше створюються через покупки пакетів акцій:

  1. Власник створює акцію з одним або кількома пакетами типу "хвилини".
  2. Учасник обирає та купує пакет (через Панель учасника на клієнті або через касира).
  3. Система створює відповідні кредити часу:
    • Оплачений кредит для базових хвилин (базова сума з пакета).
    • Якщо пакет визначає бонусний тип "хвилини" з бонусною сумою більше нуля, створюється окремий бонусний кредит.
  4. Кредити успадковують обмеження за пристроєм з пакета.
  5. Якщо пакет має встановлений період дії, дата закінчення кредиту розраховується як дата покупки плюс кількість дійсних днів.

Як час списується під час сеансів

Коли учасник з доступними хвилинами запускає сеанс:

  1. Система перевіряє наявність активних кредитів часу, що відповідають типу пристрою сеансу.
  2. Кредити споживаються в порядку дати закінчення (найраніше прострочені першими) для мінімізації втрат від кредитів, що скоро закінчуються.
  3. По мірі роботи сеансу хвилини періодично списуються з відповідних кредитів.
  4. Кожне списання створює запис споживання як "Використання сеансу".
  5. Якщо всі кредити часу вичерпані до завершення сеансу, сеанс продовжується і залишковий час тарифікується за стандартною погодинною ставкою (оплата при закритті сеансу).

Це означає, що часовий баланс та баланс гаманця учасника можуть працювати разом. Кредити часу покривають стільки хвилин, скільки доступно, а будь-який перевищення переходить до балансу гаманця або оплати готівкою.