HandyCafe Docs
owner cashier

Управление сессиями

Сессии являются основной единицей биллинга в HandyCafe. Каждый раз когда клиент в вашем интернет-кафе или игровом центре использует ПК или игровую консоль, сессия отслеживает время использования и рассчитывает стоимость. На этой странице описывается полный жизненный цикл сессии от запуска до приема оплаты.

Типы сессий

HandyCafe поддерживает два типа сессий:

  • Сессии на ПК. Сессии на клиентских ПК, управляемые через Панель администрирования. Клиентское ПО блокирует ПК в режиме ожидания и разблокирует при запуске сессии.
  • Консольные сессии. Сессии на игровых консолях (PlayStation, Xbox и др.), управляемые через страницу Консоли. Они отслеживаются только сервером; клиентское ПО на самой консоли не устанавливается.

Оба типа сессий используют одну и ту же систему тарификации и жизненный цикл, но управляются с разных страниц панели управления.

Жизненный цикл сессии

Каждая сессия проходит через определенный жизненный цикл с четкими переходами состояний:

Старт --> Работает --> (Пауза <--> Возобновление) --> Добавление времени --> Стоп

Состояния подробно:

  1. Старт. Кассир инициирует сессию. Клиентский ПК разблокируется или запускается таймер консоли.
  2. Работает. Сессия активна. Время идет и стоимость накапливается.
  3. Пауза. Кассир временно приостанавливает сессию. Биллинг останавливается. На клиенте отображается состояние паузы.
  4. Возобновление. Кассир продолжает приостановленную сессию. Биллинг возобновляется с нового тарифного сегмента.
  5. Добавление времени. Кассир добавляет (или убавляет) минуты к активной сессии.
  6. Стоп. Сессия завершается. Система рассчитывает итоговую стоимость и предлагает произвести оплату.

Запуск сессии

Для запуска новой сессии на клиентском ПК:

  1. Выберите клиент. В Панели администрирования нажмите на ПК в состоянии «Ожидание» (голубой) для отображения кнопок действий.
  2. Выберите тип биллинга. Выберите Постоплата (оплата в конце) или Предоплата (оплата вперед).
  3. Назначьте участника (по желанию). Если клиент является зарегистрированным участником, найдите его аккаунт через поле поиска с автодополнением. Назначение участника позволяет оплату с кошелька и отслеживание сессии в его истории.
  4. Задайте продолжительность или сумму (только для предоплаты). Для предоплатных сессий введите количество минут или денежную сумму оплаты. Система рассчитает соответствующее время на основе текущего тарифного слота.
  5. Выберите способ оплаты. Выберите способ оплаты (Наличные, Банковская карта или любой настроенный вами способ).
  6. Подтвердите. Проверьте детали и подтвердите. Клиентский ПК разблокируется немедленно и таймер сессии начнет отсчет.

Для консольных сессий процесс аналогичен, но инициируется со страницы Консоли.

Постоплатные сессии

В постоплатной сессии клиент сначала пользуется ПК и оплачивает при завершении. Это наиболее распространенный режим биллинга в интернет-кафе, кибер-кафе и игровых центрах.

Как это работает:

  • Сессия запускается без предварительной оплаты.
  • Таймер работает и стоимость накапливается в реальном времени на основе активного тарифного слота.
  • При остановке сессии система показывает итоговую рассчитанную стоимость.
  • Кассир принимает оплату и подтверждает транзакцию.

Постоплатные сессии не имеют ограничения по времени. Они работают пока кассир не остановит их или клиент не попросит завершить.

Предоплатные сессии

В предоплатной сессии клиент оплачивает вперед определенное количество времени. Сессия автоматически завершается по истечении оплаченного времени.

Существует два режима предоплатной тарификации, настраиваемых в Настройки > Тарификация:

Фиксация при покупке

Стоимость фиксируется в момент запуска сессии. Тарифный слот и множитель, действующие на момент покупки, используются на всю продолжительность сессии, вне зависимости от изменений расписания в ходе сессии.

Пример: клиент покупает 60 минут в 10:00 в стандартном тарифном слоте. Даже если расписание переключится на слот с половинной ценой в 11:00, оставшееся время клиента не изменится. Он получает именно то, за что заплатил по первоначальной ставке.

Живое расписание

Стоимость корректируется в реальном времени при переходе сессии через различные тарифные слоты. Если сессия клиента пересекает границу смены слота, оставшееся время пересчитывается на основе нового ценообразования.

Пример: клиент покупает 60 минут в 10:00 в стандартном тарифном слоте. В 11:00 расписание переключается на слот с половинной ценой. Поскольку каждая минута теперь стоит вдвое дешевле, оставшееся время клиента фактически растягивается. В итоге он может получить больше минут, чем было куплено изначально.

Постановка на паузу

Пауза временно приостанавливает биллинг без завершения сессии. Это удобно когда клиенту нужно ненадолго отойти.

Чтобы поставить сессию на паузу:

  1. Выберите активный ПК в Панели администрирования и нажмите кнопку Пауза на карточке.

Что происходит при постановке сессии на паузу:

  • Биллинг останавливается немедленно. Стоимость в период паузы не начисляется.
  • Текущий тарифный сегмент закрывается с границей «pause».
  • На клиентском ПК отображается состояние паузы с оранжевым индикатором.
  • Таймер сессии замирает.

Приостановленные сессии остаются на паузе бессрочно пока кассир не возобновит или не остановит их.

Возобновление сессии

Возобновление продолжает приостановленную сессию с того места, где она была поставлена на паузу.

Чтобы возобновить сессию:

  1. Выберите приостановленный ПК в Панели администрирования и нажмите кнопку Возобновить на карточке.

Что происходит при возобновлении сессии:

  • Начинается новый тарифный сегмент с текущего времени, используя активный тарифный слот.
  • Биллинг возобновляется.
  • Клиентский ПК возвращается в активное (зеленое) состояние.

Тарифный слот при возобновлении может отличаться от слота, действовавшего на момент паузы. Новый сегмент использует ставку, активную на данный момент по расписанию.

Добавление времени

Вы можете добавить или убрать минуты из активной сессии в любое время.

Чтобы добавить время:

  1. Выберите активный ПК в Панели администрирования и нажмите кнопку Добавить время на карточке.
  2. Введите количество минут. Используйте положительное значение для продления или отрицательное для сокращения сессии.
  3. Подтвердите.

Что происходит при добавлении времени:

  • Создается запись транзакции в истории сессии.
  • Для предоплатных сессий время окончания корректируется вперед (или назад) на указанное количество минут.
  • Для постоплатных сессий событие добавления времени фиксируется, но не устанавливает жесткое время окончания.

Остановка сессии

Остановка сессии завершает биллинг, блокирует клиентский ПК и запускает процесс оплаты.

Чтобы остановить сессию:

  1. Выберите активный или приостановленный ПК в Панели администрирования и нажмите кнопку Стоп на карточке.
  2. Появляется диалог оплаты с информацией о сессии.

Диалог оплаты

Диалог оплаты отображает следующую информацию:

Поле Описание
Продолжительность Общее активное время (без учета пауз)
Расчетная сумма Необработанная рассчитанная стоимость на основе тарифных сегментов
Сумма к оплате Сумма к списанию с клиента (по умолчанию равна расчетной, но может быть изменена)
НДС Сумма налога, если настроен
Комиссия Комиссия способа оплаты, если применимо
Фиксированная комиссия Фиксированная комиссия способа оплаты, если применимо
Способ оплаты Выпадающий список для выбора способа оплаты

Коррекция кассиром: кассир может вручную скорректировать сумму к оплате. Например, кассир может округлить вниз в качестве любезности или применить ручную скидку. Исходная расчетная сумма всегда сохраняется в записях для аудита.

  1. Выберите способ оплаты и подтвердите. Сессия записывается, клиентский ПК блокируется и транзакция сохраняется.

Процесс расчета

При остановке сессии механизм расчета выполняет следующие шаги:

  1. Закрывает последний открытый тарифный сегмент.
  2. Суммирует все закрытые сегменты.
  3. Применяет правила округления (всегда вверх до настроенного шага округления).
  4. Применяет минимальную стоимость запуска (итого никогда не меньше стоимости запуска).
  5. Рассчитывает комиссию способа оплаты (процентную) и фиксированную комиссию.
  6. Показывает итоговые суммы в диалоге оплаты.

Подробное описание расчета тарифных сегментов и итогового расчета см. в разделе Тарификация сессий.

Сессии участников

Когда участник назначен на сессию, становятся доступны дополнительные варианты оплаты:

  • Оплата с кошелька. Стоимость сессии может быть списана с баланса кошелька участника.
  • Списание временного пакета. Если участник приобрел временной пакет, минуты списываются из баланса пакета вместо денежной оплаты.
  • Скидка участника. Если у участника настроена скидка, она применяется к стоимости сессии.
  • История сессий. Сессия привязывается к аккаунту участника и отображается в его истории сессий.

Участники также могут запускать собственные сессии с экрана ожидания клиента, войдя с помощью логина и пароля или через OAuth (если настроен).

Значения статусов сессий

Каждый клиентский ПК отображает цветовой индикатор состояния:

Статус Цвет Значение
Онлайн Зеленый Сессия активна и работает
Пауза Оранжевый Сессия приостановлена; биллинг остановлен
Ожидание Голубой Клиент подключен, но сессия не запущена
Офлайн Красный Клиент не подключен к серверу
Админ Фиолетовый Клиент в режиме администрирования/обслуживания
Занят Желтый Клиент обрабатывает запрос

Эти цвета статусов отображаются на карточках клиентов в Панели администрирования, позволяя с первого взгляда видеть состояние каждого ПК.

Тарифные сегменты сессии

Каждая сессия разделяется на один или более тарифных сегментов. Новый сегмент создается при каждом событии, влияющем на биллинг:

  • Запуск сессии
  • Пауза
  • Возобновление
  • Смена тарифного слота (когда часы пересекают границу другого временного слота по расписанию)
  • Изменение базовой цены (если администратор меняет почасовую ставку в ходе сессии)
  • Отключение или повторное подключение

Каждый сегмент записывает тарифный слот, множитель, базовую цену, время начала, время окончания и рассчитанную сумму. Итог сессии равен сумме всех сегментов с учетом правил округления и минимального сбора.

Подробности расчета сегментов см. в разделе Тарификация сессий.

Минимальный сбор и стоимость запуска

Даже очень короткие сессии тарифицируются как минимум на сумму стоимости запуска. Это значение настраивается в Настройки > Тарификация и гарантирует, что каждая сессия генерирует минимальный уровень выручки вне зависимости от продолжительности.

Пример: если стоимость запуска установлена в $1.00 и клиент использует ПК всего 30 секунд, списанная сумма составит $1.00, а не долю цента, которую стоили бы 30 секунд по почасовой ставке.


Дальнейшие шаги