Мобильное приложение IZI для игроков клуба

Мобильное приложение IZI для игроков клуба

Мобильное приложение IZI — пользовательский инструмент для работы с программой управления клубом IZI. Оно даёт гостям клуба доступ к балансу и сессии в реальном времени и позволяет взаимодействовать с клубом со смартфона — пополнять счёт, заказывать из бара, управлять активной сессией и получать уведомления оператора.

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

---

Что умеет приложение

Мобильное приложение организовано вокруг шести основных разделов. Каждый — отдельный экран, доступный из нижней навигации или бокового меню.

Карта и поиск клуба

Главный экран открывает вид Google Maps с метками всех клубов в регионе игрока. Приложение определяет геолокацию и автоматически масштабирует карту к ближайшему клубу. Нажав на метку, игрок видит данные клуба — название, адрес — и переходит к бронированию или меню бара.

Выбор тарифа и бронирование сессии

Выбрав клуб и зону (зона ПК, зона консолей и т.д.) игрок просматривает доступные тарифы — повременные или мультипасс-планы — и выбирает длительность. Приложение загружает актуальный каталог тарифов при каждом открытии и сбрасывает предыдущие черновые выборы, чтобы игрок всегда видел актуальные цены и доступность.

Оплата происходит на этом шаге с помощью сохранённой карты, Apple Pay или Google Pay. После подтверждения сессия создаётся и игрок проходит к своему месту.

Управление активной сессией

Когда сессия запущена, приложение показывает отдельный экран управления с:

• Таймером обратного отсчёта в реальном времени, синхронизированным с сервером по минутам.
• Текущим статусом ПК (работает или заблокирован/на паузе).
• Кнопкой блокировки или разблокировки ПК удалённо — удобно когда игрок отлучается.
• Оповещениями об остатке времени: когда время опускается ниже порога, появляется баннер с предложением быстрого пополнения или продления тарифа без похода на стойку.
• Кнопками для отмены предстоящего бронирования или досрочного завершения сессии.

Состояние сессии синхронизируется в реальном времени через обновления от сервера.

Способы оплаты и карты участника

Экран «Оплата и абонементы» (ClubMembershipsPage) отображает все клубы, где у игрока есть активный аккаунт. Карточка каждого клуба показывает:

• Игровой баланс — доступный остаток для оплаты компьютерного времени.
• Бонусный баланс — начисленные бонусные очки (отображается второстепенной цифрой «молния»).
• Блок промокода — текущий активный промокод игрока, если есть.
• Привязанные способы оплаты — сохранённые карты с последними четырьмя цифрами. Игроки могут добавлять новые карты, удалять старые и настраивать автопродление.

Автопродление использует выбранную карту для автоматического продления сессии по истечении времени. Игрок выбирает карту для автопродления отдельно для каждого клуба.

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

Заказы из бара

Внутри клуба функция бара (MobileBarHomeScreen) позволяет игрокам просматривать каталог еды и напитков. Экран поддерживает:

• Список товаров с поиском.
• Страницы комбо и акционных предложений.
• Заказ прямо из приложения — заказ оформляется с места.
• Историю заказов в разделе «Заказы».

Это заменяет или дополняет физическое меню и сокращает обращения к персоналу для простых заказов.

Уведомления

Экран «Уведомления» хранит входящие push-уведомления игрока. Операторы могут отправлять оповещения о времени сессии, объявления и рекламные сообщения через FCM (Firebase Cloud Messaging). Игроки могут просматривать историю уведомлений прямо в приложении без необходимости снова открывать системные уведомления.

---

Как работают баланс и бонусы в приложении

Приложение показывает два отдельных баланса для каждого клуба:

• Игровой баланс (также называется денежным балансом) — пополняется игроком, расходуется на компьютерное время.
• Бонусный баланс — начисляется правилами автоматизации клуба (например, бонус при пополнении счёта при зачислении сверх определённой суммы).

Это напрямую соответствует концепциям описанным в разделе бонусы и удержание игроков. Приложение получает данные из того же GraphQL API что использует CRM, поэтому то что видит стойка и то что видит игрок всегда совпадает.

---

С точки зрения оператора клуба

Персонал клуба не настраивает мобильное приложение напрямую — оно наследует данные из CRM. Ключевые связи:

• Тарифы: то что игрок видит в выборе тарифа — это именно то что опубликовано в разделе Тарифы и ценообразование. Неопубликованные или ограниченные по зонам тарифы не отображаются.
• Каталог бара: список товаров и комбо берётся из модуля бара и склада. В приложении отображаются только позиции, отмеченные как доступные в CRM.
• Аккаунт игрока: создаётся автоматически когда игрок регистрируется с номером телефона, привязанным к посещению клуба.
• Push-уведомления: отправляются из инструмента уведомлений CRM и доставляются через FCM. Экран «Уведомления» в приложении — это входящий ящик для этих сообщений.

Отдельной панели администратора мобильного приложения не существует. Приложение — это слой чтения и действий поверх существующей модели данных IZI.

---

Техническое описание (для вопросов интеграции)

Мобильное приложение IZI разработано на Flutter с использованием структуры Melos суб-монорепо. Основная логика находится в пакете shared и переиспользуется:

• Оболочкой mobile (iOS и Android — данное приложение).
• Оболочкой widget (десктопный виджет для Windows на станциях клубов).
• Приложением iZi.Boss (для владельцев, отдельная сборка).

Аутентификация — OTP по номеру телефона с дополнительным входом по email. GraphQL через WebSocket обеспечивает состояние сессии в реальном времени. Токенизация платёжной карты проходит через перенаправление WebView, поэтому приложение никогда не обрабатывает номера карт напрямую.

Сборка iOS включает реализацию Live Activities для Dynamic Island и экрана блокировки (обратный отсчёт сессии). В текущей кодовой базе это собрано, но развёрнуто с kill-switch; активация — это изменение конфигурации, а не кода.

---

Вопросы и ответы

Что может сделать игрок в мобильном приложении IZI? Игроки могут просматривать игровой и бонусный балансы, пополнять счёт через сохранённую карту, Apple Pay или Google Pay, выбирать и активировать тарифы, управлять активной сессией (поставить на паузу, продлить, завершить), заказывать еду и напитки из меню бара, а также получать push-уведомления о времени сессии, акциях и новостях.

Работает ли приложение в нескольких клубах одной сети? Да. Приложение показывает все клубы региона на карте. После регистрации по номеру телефона аккаунт игрока привязывается к каждому клубу отдельно. Балансы, способы оплаты и карты участника отображаются по каждому клубу на экране «Оплата и абонементы».

Как работает управление сессией в приложении? Когда сессия активна в клубе, приложение показывает таймер обратного отсчёта в реальном времени, текущий статус ПК и кнопки для паузы (блокировки ПК) или завершения сессии. Когда время заканчивается, появляется баннер с предложением быстрого пополнения или продления тарифа без похода на стойку.

Может ли игрок пополнить баланс через приложение? Да. Игроки могут добавить банковскую карту (через токенизацию в WebView), назначить одну карту основной для автопродления и пополнять счёт прямо в приложении. Apple Pay и Google Pay поддерживаются на совместимых устройствах.

Что такое автопродление и как его включить игроку? Автопродление автоматически продлевает сессию когда время заканчивается, используя привязанный способ оплаты. Игроки включают его для каждого клуба отдельно в разделе «Оплата и абонементы», выбрав нужную карту как источник автопродления.

Поддерживает ли приложение IZI iOS Live Activities? В кодовой базе есть реализация Live Activities (Dynamic Island и виджет на экране блокировки с обратным отсчётом сессии). По состоянию на момент проверки функция отключена через kill-switch. Время сессии отображается во внутреннем таймере приложения.

Как работают push-уведомления? Приложение использует Firebase Cloud Messaging для доставки уведомлений. Игроки получают уведомления о времени сессии, акциях и объявлениях оператора. Страница «Уведомления» хранит историю входящих сообщений, чтобы игроки могли просматривать прошлые уведомления.

Что такое функция бара в приложении? Игроки внутри клуба могут просматривать меню еды и напитков клуба, просматривать страницы товаров и комбо и делать заказ не вставая с места. Заказы отслеживаются в приложении в разделе «Заказы».

Обязательна ли регистрация для использования приложения? Да. Регистрация производится по номеру телефона с подтверждением через OTP. Один номер телефона связывает аккаунт игрока со всеми клубами IZI. Дополнительно доступен вход по email.

На каких платформах доступно мобильное приложение IZI для игроков? Приложение разработано на Flutter и поддерживает iOS и Android. Оно использует общую логику с десктопным виджетом IZI для Windows, который применяется на станциях клуба.