Руководство пользователя SpikePC

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

Это руководство по панели организации (веб-интерфейс). Техническая документация для разработчиков клиентского ПО, клубного сервера и мобильного приложения поставляется отдельно.

---

1. Что такое SpikePC

Система управления компьютерным клубом. Состоит из четырёх частей:

Всё связано через сервис реального времени: станция держит постоянное соединение с сервером, поэтому карта клуба показывает состояние сразу, а команды оператора долетают мгновенно.

Роли

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

---

2. Интерфейс

Наверху — единая полоса:

• слева название организации, дата и погода;
• показатели за сегодня: клиентские сессии, станции онлайн, выручка касс, бонусные начисления, загрузка «средняя / текущая»;
• справа иконки: заказы (со счётчиком новых), карта клуба, касса, брони, разделы системы, меню пользователя.

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

Язык интерфейса выбирается в профиле (меню пользователя → «Профиль», список языков рядом с именем и телефоном) — отдельного переключателя в полосе больше нет. Язык сохраняется той же кнопкой, что остальные поля карточки, и применяется сразу: панель открывается заново на том же разделе.

Разделы системы (иконка сетки) открывают окно со всеми разделами панели, с поиском. Разделы сгруппированы по смыслу: Клуб, Клиенты (включая историю переписки), Магазин (включая склад), Тарифы и оплата (включая кассу и кассовые смены), Игры, Персонал, Франшиза, Система. Меню пользователя (иконка человека) — профиль, смена пароля и выход.

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

С телефона

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

Списки выводятся карточками. Строка — отдельный блок: главное поле заголовком, остальные колонки парами «подпись: значение», кнопки строки внизу. Кнопка создания записи переезжает в строку с названием раздела, потому что шапка таблицы на телефоне не показывается.

Четыре экрана остаются таблицей и прокручиваются: расписания тарифов и абонементов, доска заказов, бронирование станций и касса. Там смысл именно в сетке — часы недели, колонки статусов, станции по времени, — и в карточки её разворачивать нельзя.

На карте клуба вместо воронки стоит шестерёнка, и под ней не только выбор клуба: туда же убраны счётчики станций по статусам, масштаб, запрос состояния сервера и переход в редактирование схемы. В строке с названием остаются имя открытого клуба и две кнопки справа: чаты со счётчиком непрочитанных и шестерёнка — всё остальное место отдано залу.

Что делается иначе:

---

3. Клубы

Раздел Клубы — список площадок организации. Параметры карточки:

При создании клуба система автоматически заводит 10 тестовых клиентов (логин и пароль совпадают с почтой вида <club><org>NN@домен) — чтобы сразу было на ком проверить вход, тарифы и заказы.

---

4. Игровые станции

Игровые станции — список ПК и консолей. Параметры:

Ссылку Expirenza можно менять отдельно от карточки станции: в списке рядом со значком QR есть карандаш. У этого действия своё право («Expirenza link»), поэтому ссылку доверяют сменному персоналу, не открывая ему правку IP, MAC и группы — там одна опечатка отключает станцию от сервера.

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

В новой организации уже есть три станции — «1», «2» и «3», по одной в каждой стартовой группе. Это заготовки: IP 192.168.1.1–3 и MAC aa:aa:aa:aa:aa:aa…cc в них условные, и подключать по ним нечего. Откройте карточку и впишите настоящие IP и MAC своей машины — станция заработает. Лишние заготовки удалите.

---

5. Группы игровых станций

Деление зала на зоны: Standard, VIP, PS5, «руль». У группы есть название и цвет — цветом она подписана на карте клуба и в сетке бронирования.

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

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

В новой организации уже созданы три группы — pro, vip и normal, в каждой по одной станции. Переименуйте их под свой зал или удалите лишние; главное — не оставить станцию без группы и не забыть про расписание цен: пока группа не закрашена тарифом, время в ней идёт бесплатно.

6. Карта клуба

Главный рабочий экран администратора. Показывает зал в реальном времени.

Что видно на карте

Онлайн определяется по факту соединения станции с сервером, а не по последней активности — выключенный ПК становится серым сразу.

Масштаб схемы меняется кнопками «− / % / +» в шапке (клик по проценту возвращает стартовые 90%, Ctrl+колесо мыши тоже работает). Выбранное значение запоминается за оператором и переживает переход в другой раздел и повторный вход: за одним компьютером работает смена, и настройка следует за человеком, а не за машиной.

Действия по правому клику

Отдельных пунктов «Заблокировать» и «Разблокировать станцию» в меню нет: они говорили о том же, о чём «Завершить сессию» и «Авторизовать клиента». Состояние станции для человека одно — за ней либо играет клиент, либо нет; поэтому эти два пункта взаимно исключают друг друга.

Режимы станции

Обычно станция «в работе»: клиент входит, контроль простоя действует, оператор управляет ею как всегда. Кроме этого есть три особых режима — их ставит и снимает только администратор из панели, правым кликом по станции:

Отличие администрирования от обслуживания одно, но важное: пока станция в нём, клубный сервер не откатывает её диск к эталонному образу при перезагрузке. Иначе всё, что админ поставил, исчезало бы на первом же рестарте.

Общие правила для всех трёх:

• режим переживает выключение станции и обрыв связи — он не про питание, а про то, что с машиной делают; снять его может только человек;
• перевести можно только свободную станцию: если за ней играет клиент, сперва завершите сессию — иначе администратор садился бы за машину, с которой только что выгнали человека;
• контроль простоя такие станции не трогает, и выключить их с карты нельзя (ни по одной, ни рамкой) — на машине в этот момент работают. Включить по сети можно в любом режиме;
• меню станции в особом режиме сводится к возврату в работу, переходу в соседний режим и двум операциям с самой машиной — так оператор не выдаст кредит и не пошлёт сообщение на компьютер, который настраивают. Эти две операции: «Включить ПК» (для выключенной станции, в любом режиме) и «Создать золотой образ» — он доступен в режиме администрирования у выключенной станции. Это обычный порядок работы: админ поставил игры, выключил машину и снял с неё эталонный образ, который клубный сервер будет раздавать остальным;
• станция, выведенная из проката, не считается в загрузке зала — иначе процент занятости занижало бы оборудование, которого в зале фактически нет. На карте она остаётся видимой, приглушённой: должно быть понятно, почему в ряду дыра.

Групповые действия

Выделите станции рамкой — появится панель действий. В ней только то, что к выделению применимо: кнопка появляется, если среди выделенных станций есть хоть одна подходящая, и рядом с подписью стоит число таких станций. Действие уходит ровно им, остальные не трогаются.

Прежде чем действие выполнится, вы увидите разбор выделения: двумя группами — кому действие уйдёт и кого пропускаем. Станции в списке нарисованы тем же значком и цветом, что на схеме зала, а при наведении подписана причина пропуска. У действий с вводом (сумма, текст, абонемент) этот разбор стоит в шапке формы — состав группы виден, пока вы заполняете поля.

Результат по каждой станции показывается отдельной панелью статуса: «выполнено», «доставлено», «не в сети» или «пропущено» — состояние могло измениться между последним обновлением карты и нажатием, и такие станции сервер пропустит сам.

Абонемент прямо на месте

Абонемент не обязательно продавать из карточки клиента — его можно продать там, где человек сидит. Два случая:

Клиент уже играет. Правый клик по его станции → «Продать абонемент». В окне — абонементы клуба с ценой для этого клиента (перманентная скидка учтена, если абонемент её допускает), касса и комментарий. Деньги принимает касса, абонемент появляется у клиента сразу и привязывается к группе той станции, за которой он играет.

Абонемент, которого нет в прайсе этого зала, в списке подписан — продать его можно, но вы увидите расхождение до того, как возьмёте деньги.

Клиент ещё не сел. Правый клик по свободной станции → «Пополнить после авторизации», и рядом с суммой выберите абонемент. Как только человек войдёт на эту станцию, система сделает два действия подряд: зачислит принятые деньги и купит на них абонемент. Так удобно работать на входе: приняли оплату, назначили станцию, человек сел и уже играет по абонементу.

Сумма в заявке остаётся отдельным полем и подставляется по цене абонемента. Это не мелочь: заявка ставится на станцию, а кто за неё сядет — ещё неизвестно, и у него может оказаться личная скидка. В кассу идёт то, что вы приняли, абонемент покупается по его цене, разница остаётся клиенту на балансе.

Для обоих случаев нужна открытая кассовая смена — как для любого приёма денег. Право на продажу то же, что в карточке клиента: «Продажа абонемента».

Станции, которые простаивают

Станция включена, но за ней никого нет: ни клиента, ни сотрудника, и она не в особом режиме. Через число минут из настроек клуба (по умолчанию 7) в левом нижнем углу карты появляется окно со списком таких станций: сколько уже простаивает и сколько осталось до выключения. Кнопка «Сбросить» рядом со станцией обнуляет счётчик — это ответ «вижу, она занята, не выключай»; кнопка в шапке окна сбрасывает сразу все.

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

Чаты с клиентами

Клиент на станции может написать администратору, не вставая с места, — например, «не работает мышка» или «принесите колу». Переписка привязана к текущей сессии клиента: он ушёл — разговор закончен, следующий за этой станцией начинает с чистого листа.

Кнопка «Чаты с клиентами» в шапке карты показывает число непрочитанных сообщений и открывает панель справа от схемы зала. В ней два экрана:

1. Список чатов — строка на станцию: иконка станции с номером и той же подсветкой, что на схеме, имя клиента, последнее сообщение и счётчик непрочитанных. Сначала показываются станции с непрочитанными, затем со свежими разговорами. В списке только станции, где сейчас авторизован клиент — писать больше некому. 2. Переписка — открывается по клику в том же месте, назад ведёт стрелка. История, поле ввода, набор смайликов (включая кальян). Enter отправляет, Shift+Enter переносит строку.

Рядом с именем клиента — иконка «i»: открывает его карточку, не уходя из чата. Там контакты и дата рождения, баланс и долг, скидки, язык, заметки, текущая сессия (начало, длительность, остаток времени, потрачено на время и покупки, кредит), непотраченные абонементы и пять последних операций по счёту.

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

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

Новое сообщение сопровождается звуком. У чата он свой — выбирается в настройках организации рядом с сигналом заказа: на слух сообщение должно отличаться от заказа, иначе персонал идёт к стойке вместо ответа в переписке. Пока клуб не выбрал чату отдельный сигнал, звучит тот же, что у заказов. Звук включается после первого клика по странице (требование браузера) и не звучит, если вы уже открыли переписку с этой станцией.

Клубный сервер

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

Кончается место на диске — панель скажет сама. Сервер сообщает о себе каждые несколько секунд, и как только занятое место переходит порог клуба (параметр «Предупреждать при занятом месте на диске», по умолчанию 90%), в шапке панели появляется значок диска с худшим процентом — он виден в любом разделе, не только на карте. Нажмите на него: откроется то же окно состояния сервера, переполненный диск в нём подсвечен красным. Если предупреждений несколько, сверху окна появятся кнопки клубов. Проверяется и диск сервера целиком, и каждый его пул: место под образами станций кончается именно в пуле, а системный диск при этом бывает почти пустым. Значок не исчезнет, пока место не освободят, — даже если сервер перестанет выходить на связь: диск сам себя не чистит, а время последнего отчёта видно в окне.

---

7. Клиенты

Раздел Клиенты — люди, играющие в ваших клубах.

Учётная запись клиента глобальная: одна почта — один клиент во всей системе. Поэтому имя, фамилия, почта, телефон, дата рождения, пол и пароль в панели организации только показываются: их владелец меняет сам через станцию или мобильное приложение.

Организация управляет своими данными о клиенте:

Операции с деньгами

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

Комментарий к пополнению. При зачислении можно указать, за что оно. Для бонусной кассы комментарий обязателен — иначе система не примет операцию: бонус без пояснения невозможно разобрать в отчётах.

---

8. Тарифы

Раздел Тарифы — стоимость часа игры.

Расписание — сетка «день недели × час». Выбираете тариф как кисть и закрашиваете часы для нужной группы станций. Час, отмеченный в сетке, входит целиком: «10:00–14:00» означает, что оплата по этому тарифу идёт до 13:59:59 включительно.

Если на текущий час тариф не задан, станция сообщит об этом, а время не будет тарифицироваться — следите, чтобы в сетке не оставалось дыр.

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

Выключение не снимает тариф с тех часов, где он уже стоит. Так сделано нарочно: минута без тарифа бесплатна, и тумблер, вычищающий тариф из сетки, тихо сделал бы зал бесплатным. Рядом со статусом в списке стоит колонка «В расписании» — сколько интервалов ещё считаются по этому тарифу; пока там не прочерк, тариф продолжает брать деньги. Чтобы он перестал применяться, снимите его с этих часов в расписании (в сетке они помечены штриховкой) или закрасьте их другим тарифом.

Поэтому выключение и нужно вместо удаления, когда тариф снимают на время: удаление уносит вместе с тарифом и все его интервалы, и часы останутся без тарифа, то есть бесплатными.

---

8.1 Скидки

Скидок две, и к одному клиенту применяется только одна — они не складываются.

Постоянная стоит в карточке клиента. Действует на списание за время и на цену абонемента при покупке. Именно ею дают 100% сотрудникам клуба: они играют при нулевом балансе.

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

Выдаётся с карты клуба: правый клик по станции → «Выдать скидку» → выбор повода из списка. Пункт появляется только у включённой станции и только если скидки заведены в разделе «Скидки» — процент на месте не придумывается. Если за станцией играет клиент, скидка идёт в его сессию; если станция свободна — ждёт того, кто сядет, 30 минут. Снять скидку можно там же.

На карте станция со скидкой подписана процентом («−20%»); у ждущей скидки подпись приглушена — обещание есть, но действовать начнёт со входом клиента.

В карточке тарифа и абонемента есть галочка «Скидки действуют». Снимите её там, где цена и так ниже обычной (ночной тариф, акционный пакет) — скидка к ним применяться не будет, какой бы она ни была.

Процент, под которым прошло списание, виден в истории операций: по нему разбирают вопрос «почему за час списали 52, а не 60».

В списке клиентов есть колонка скидки, фильтр «со скидкой / без скидки» и сортировка по размеру — удобно проверить, кому и сколько роздано.

---

9. Абонементы

Раздел Абонементы — пакеты времени за фиксированную цену.

Абонемент принадлежит клубу: у него своя цена и свои сетки расписания, поэтому список всегда показывает один выбранный клуб (как и раздел тарифов), и создаваемый абонемент достаётся именно ему. Варианта «все клубы» в фильтре нет намеренно: при нём новый абонемент сохранялся без клуба — в расписании его было не выбрать и на станции он не появлялся.

У абонемента две сетки расписания:

• продажи — когда его можно купить (по ней он появляется в списке на станции);
• действия — когда купленным можно играть. Пустая сетка означает «всегда».

Важное правило: абонемент горит по обычным часам с момента активации. Купили в 12:00 на 3 часа — в 15:00 его нет, независимо от того, играл клиент или ушёл пить кофе. Пауза время не сохраняет.

Абонемент действует только в той группе станций, где куплен. Если клиент сядет в другую зону, время пойдёт за деньги по её тарифу.

Когда абонемент включается сам, а когда клиент выбирает. Сам — только если подходящий абонемент у клиента один и у него стоит галочка «Включать автоматически». Если подходящих несколько, станция всегда спрашивает, какой включить: поднятый абонемент сразу начинает гореть по часам, и решать, какой из двух жечь, должен человек. Отказ («играю за деньги») станция запоминает до конца сессии; клиент может включить абонемент позже сам из меню.

Если станция не ответила за минуту, абонемент включается сам — первый по очереди, даже когда галочка снята. Так сделано на время, пока не все залы обновили программу на машинах: клиент с абонементом на счету не должен платить деньгами из-за версии программы. Молчание станции — не то же самое, что отказ клиента: сам отказ система помнит и абонемент после него не включает.

Когда у абонемента заканчивается окно действия по расписанию, он перестаёт работать, и станция предложит выбрать следующий. Часы при этом не останавливаются — они уже идут.

В настройках организации можно ограничить: максимум хранимого времени и «не больше одного непотраченного абонемента».

Как снять абонемент с продажи, не удаляя его. В списке у каждого абонемента есть тумблер статуса. Выключенный абонемент пропадает из продажи везде: из меню на станции, из мобильного приложения, из кассы и из окна «Продать абонемент» на карте клуба. При этом он остаётся в разделе со своей ценой и обоими расписаниями — включить обратно можно тем же тумблером.

Уже купленные абонементы продолжают работать и гореть по часам: выключение снимает с продажи, а не отбирает у клиентов купленное. Поэтому не нужно удалять абонемент, когда кончилась акция или пересчитывается цена — достаточно выключить.

Если абонемент выключили в тот момент, когда клиент уже открыл меню покупки, станция ответит «Этот абонемент не продаётся» и обновит список.

---

10. Кредит: игра в долг

Когда у клиента заканчиваются деньги, а он хочет доиграть, администратор выдаёт кредит: правый клик по станции → «Дать кредит» → сумма.

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

После игры клиент рассчитывается, а вы проводите обычное пополнение на сумму долга — баланс возвращается к нулю. Пока долг не погашен, клиент не сможет войти на станцию: она покажет «На счету есть долг, обратитесь к администратору».

Касса и постоплата

Раздел «Касса» собирает работу кассира на одной странице, по вкладкам:

История пополнений фильтруется: выпадающий список касс и поиск по клиенту, комментарию кассира и сумме — «верни мне ту тысячу» обычно и ищут по сумме, когда имя не вспомнить. Фильтр применяет сервер, поэтому он находит операции по всей смене, а не только среди последних показанных строк; рядом подпись «найдено N из M». Крестик рядом с поиском сбрасывает оба фильтра.

Пробили не ту кассу? В строке истории есть кнопка со стрелками — она открывает под строкой выбор кассы и комментарий. Это не возврат: деньги остаются у клиента, сумма и время операции не меняются — меняется только то, в какой кассе они числятся. Выручка смены, показания касс и «должно быть в ящике» пересчитываются сразу. Поменять кассу можно у пополнений текущей открытой смены (их история и показывает) и только пока пополнение не возвращено; перенос в бонусную кассу требует комментария — «за что». Каждая такая правка попадает в журнал изменений: видно, кто и куда перенёс деньги. Если кнопки нет — у вашей группы доступа нет права «Change payment method» в блоке «Касса».

Постоплата — клиент играет, а время не списывается с баланса, а копится к оплате; по окончании сессии администратор принимает оплату в кассу. Включить можно:

• клиенту за станцией — с этого момента сессия идёт в постоплате;
• при входе — на свободной станции, начнётся с входом следующего клиента;
• гостю — без учётки: станция сразу открывает гостевую сессию.

То же доступно правым кликом по станции на карте; станция в постоплате помечена значком, жёлтым — когда ждёт оплаты. Лимит — потолок суммы: дошли до него — сессия завершается. Не задали — действует максимум из настроек организации; в идущей постоплате лимит можно поменять, но не выше максимума. В постоплате не расходуются абонементы и не мешает долг на балансе; бесплатные минуты клуба действуют. Набежал ноль — постоплата закрывается сама. Нужна открытая смена.

---

11. Магазин

Категории товаров

Раздел Группы товаров — категории (напитки, еда, снеки). Общие для всей организации, у каждой есть название и картинка.

Товары

Раздел Товары. Параметры карточки:

Списание со склада включается в настройках организации (раздел «Глобальные настройки»).

Время доступности — когда товар вообще продаётся. По умолчанию «доступен всегда», и большинству товаров этого достаточно. Если выбрать «по расписанию», появляются семь строк — день недели и окно времени: понедельник 00:00–23:59, вторник 18:00–22:00, а воскресенье можно просто не отмечать, и в этот день товар продаваться не будет. Вне своих часов товар не показывается клиенту на станции вовсе — как выключенный, поэтому кухню, которая работает до 22:00, больше не нужно выключать и включать руками каждый вечер. Если корзину собрали до закрытия, а заказ отправили после, станция получит отказ «этот товар сейчас не продаётся».

Конец окна включает выбранную минуту целиком, поэтому «00:00–23:59» — это ровно сутки. Если конец раньше начала, окно переходит на следующие сутки: «пятница 20:00–04:00» означает ночь с пятницы на субботу. В списке товаров колонка «Доступность» показывает значок у тех, у кого расписание есть (часы видно, если задержать на нём курсор), и прочерк у остальных.

Склад: движение товара

Раздел Склад — журнал, в котором видно каждое изменение остатка: что приняли, что продали, что списали. Раньше остаток был просто числом в карточке товара, и ответить на вопрос «куда делись двадцать банок колы» было нечем.

Приём товара оформляется одним окном. Слева — поиск по товарам клуба: по названию, артикулу или штрихкоду, поэтому можно просто сканировать штрихкоды сканером (Enter добавляет найденный товар). Справа набирается список: количество и цена по каждой позиции, внизу — число позиций и сумма. Комментарий — поставщик или номер накладной. Кнопка «Провести документ» записывает всё одной операцией: либо документ проходит целиком, либо не проходит вовсе.

Тем же окном оформляются списание и инвентаризация. Разница в смысле количества: в приходе оно прибавляется, в списании вычитается, в инвентаризации вводится со знаком — +10 излишек, −10 недостача.

В журнале есть фильтры по клубу, типу движения и периоду, поиск по названию, артикулу и штрихкоду, а над таблицей — итоги за выбранный период. Каждая строка показывает «было → стало», а по номеру документа открывается весь приход целиком.

Право на просмотр журнала выдаётся вместе с товарами, а проведение документов — отдельное: смотреть остатки может весь персонал, а принимать поставку — не каждый.

---

12. Заказы

Клиент делает заказ со станции; деньги при этом не списываются — оплата на месте.

Доска заказов — рабочий экран: колонки «Новые», «В процессе», «Готово», «Отменено». Карточка показывает станцию, клиента, позиции (включая выбор в комбо), сумму и комментарий клиента. Кнопки двигают заказ по статусам. Доска обновляется сама, и список заказов тоже: обе страницы перерисовываются в тот же момент, когда в шапке меняется счётчик, поэтому сигнал и появление заказа совпадают.

У заказа три рабочих состояния: новый → в обработке → готов (или отменён). Отдельного «готовится» нет — на доске он попадал в ту же колонку «В процессе», отличить его от «в обработке» было нечем, а персонал жал лишнюю кнопку.

Фильтры: клуб, период (сутки, 3 дня, неделя, всё), поиск по клиенту.

Тумблер «Приём заказов» отключает приём для выбранного клуба — станции получат отказ.

Отмена заказа возвращает товар на склад, если по нему было списание.

Уведомления. Новый заказ и смена статуса уходят в Telegram-канал: клуба, если он указан в карточке клуба, иначе — организации. Там же появляются предупреждения о малом остатке товара.

В шапке панели висит корзина. Счётчик показывает только новые заказы — те, что требуют внимания прямо сейчас; заказы в работе и готовые видны в списке при наведении, с разбивкой по статусам. Клик по корзине ведёт на доску.

На новый заказ звучит сигнал. Звук выбирается в настройках организации — резкие встроенные сигналы или свой загруженный файл, с громкостью и повтором. У сообщения клиента в чате сигнал свой, он настраивается там же. Браузер разрешает звук только после первого клика по странице — до этого на корзине виден оранжевый колокольчик.

---

Доска заказов

Тот же набор заказов, но канбаном: колонки Новые / В процессе / Готово / Отменено, карточка с номером станции крупно в левом верхнем углу — с ним сотрудник идёт к клиенту. Доска сама обновляется раз в десять секунд, кнопки на карточке двигают заказ по колонкам.

Здесь же тумблер «Приём заказов»: выключили — станции получают отказ и заказ не создаётся. Полезно, когда кухня закрылась раньше зала.

12.1 Кассовые смены

Смена — рабочий период кассира в клубе. Пока смена не открыта, пополнить баланс клиента нельзя ни одним способом: ни из карточки клиента, ни с карты клуба, ни заявкой «после авторизации». Так деньги всегда закреплены за тем, кто их принял.

Раздел Кассовые смены:

В списке по каждой смене видно: клуб, кто и когда открыл и закрыл, принято наличными, безналично и бонусами, «в кассе» — сколько должно быть (у открытой) или сколько пересчитали и на сколько разошлось (у закрытой). Расхождение подсвечивается: плюс — зелёным, минус — красным.

Одна открытая смена на клуб. Смены соседних клубов друг другу не мешают.

> Пока смена открыта, в шапке деньги показываются за смену, а не за календарные > сутки — смена часто переходит за полночь. Подпись рядом с цифрой говорит, за какой > период сумма.

---

13. Способы оплаты и операции по счёту

Способы оплаты (в обиходе — кассы) — куда попадают деньги. В меню раздел называется «Способы оплаты», чтобы не путать его с разделом «Касса» — рабочим местом кассира.

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

Операции по счёту — журнал всех движений: пополнения, списания за время, покупки абонементов, возвраты, корректировки. Фильтры по дате, типу, источнику и кассе, поиск по клиенту. У пополнений доступен возврат (если право выдано).

---

14. Промокоды

Раздел Промокоды.

Сейчас промокоды применяются при регистрации клиента на станции: он вводит код и получает начисление.

---

15. Баннеры

Картинки на экране станции. Настраивается область показа (сетка 16×9, выделяется мышью), период (всегда или диапазон дат), время (дни недели и часы, окно через полночь допустимо), группы станций и длительность показа в секундах.

16. Игры

Каталог игр клуба: название и описание с переводами, изображение, рейтинг (растёт при запусках) и способ запуска. Для локальных файлов указывается путь, для лаунчеров (Steam, Battle.net, Epic, Riot, Ubisoft, EA, GOG, Rockstar, Wargaming) — только ID игры, ссылку система соберёт сама. В карточке есть подсказка, где взять ID, и предпросмотр итоговой строки запуска.

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

Клиент может отметить игру звёздочкой — избранное хранится за парой «клиент + клуб» и приходит на станцию сразу при входе. Из панели избранное не правится: это выбор клиента.

17. Жанры игр

Отдельный справочник организации: список жанров один на всю сеть, а игры принадлежат клубам и ссылаются на него — иначе «Шутер» пришлось бы заводить в каждом клубе заново.

В списке видно, сколько игр в каждом жанре. Удаление жанра снимает его и с игр — сами игры остаются на месте.

18. Бронирование игровых станций

Время брони выбирается часом и минутами, минуты — с шагом 5 (00, 05, … 55; по умолчанию 00): клиент приходит не к ровному часу, и округление до получаса дарило ему или отнимало почти полчаса.

Сетка «станции × время» размечена по часам — обычно 24 колонки на сутки. Бронь, которая занимает часть часа, и нарисована частью: с 13:20 до 14:40 плашка начинается на трети первой клетки и обрывается на двух третях второй. Так видно и точное время, и общую картину вечера, а 288 пятиминутных колонок не поместились бы на экран.

Дважды в год в сутках не 24 часа. В последнее воскресенье марта часы переводят вперёд, и часа 03:00 в этот день нет вовсе — в сетке на одну колонку меньше. В последнее воскресенье октября их переводят назад, и один час идёт дважды: колонка перед ним длится два часа, то есть бронь «02:00–03:00» на этот день — это два часа игры. Такие колонки помечены в шапке пунктиром, подсказка по наведению объясняет, что происходит.

Выделение мышью сразу по нескольким станциям создаёт групповую бронь; минуты затем уточняются в окне. Занятые часы и прошедшие выбрать нельзя; отыгравшие брони показываются приглушённо, но остаются доступными для правки.

Клиент может забронировать станцию сам — из мобильного приложения. Он выбирает клуб, дату и станцию, а бронь появляется в этом же разделе и на карте клуба: отдельного «мира» для приложения нет, администратор видит её наравне со своими. Система сама проверяет, что время в будущем и не дальше 30 дней вперёд, длительность от 30 минут до 12 часов, станция в это время свободна и клуб принимает брони; одновременно у клиента может быть не больше пяти броней. Свою бронь он может и отменить, пока она не закончилась.

Станцию нельзя забронировать дважды. Пересечение по времени проверяет сервер — и в сетке, и при групповом выделении, и в мобильном приложении. Стык «конец в конец» разрешён: бронь до 15:00 и бронь с 15:00 не конфликтуют. В групповой брони станции, у которых это время уже занято, пропускаются, а их номера названы в сообщении.

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

19. Образы станций

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

20. Сессии

Журнал клиентских сессий: когда, кто, на какой станции, сколько времени и на какую сумму. Только просмотр.

21. История событий

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

22. Локаль

Локали — языки, на которых работают станции и каталог. У каждого языка код (uk, ru, en, pl…), название, флаг и признак «по умолчанию». Клиент видит станцию на своём языке, а каталог — названия игр и товаров — подставляется из переводов этого языка; нет перевода, остаётся язык по умолчанию.

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

23. История переписки

Разговоры с клиентами, которые уже закончились. Чат на карте работает только с активной сессией, поэтому закрытый разговор можно прочитать только здесь: список с датами, станцией, клиентом, числом сообщений и непрочитанными, фильтры по клубу и периоду и поиск по тексту сообщений — вспомнить разговор обычно получается как раз по фразе.

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

24. Отзывы и оценки клубов

Клиент ставит клубу оценку от 1 до 5 и может написать отзыв — со станции (прямо там, где играет) или в мобильном приложении. Отзыв один на клуб: новая отправка переписывает прежнюю, поэтому накрутить рейтинг повторами нельзя.

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

Отзыв публикуется не сразу — он проходит проверку. Три ступени, от бесплатной к платной:

1. Простые правила: ссылки и контакты, номера телефонов, мат. 2. Бесплатная проверка OpenAI: угрозы, травля, непристойности. 3. Проверка моделью: реклама других клубов, спам, обвинения конкретных сотрудников, текст не по теме.

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

Отклонённый отзыв видит только его автор, вместе с причиной. Если проверка недоступна (например, кончились деньги на счёте OpenAI), отзыв публикуется с пометкой — иначе отзывы копились бы в очереди, и никто бы об этом не узнал.

Ключ OpenAI и модель задаются один раз администратором системы (настройки системы, группа AI). Без ключа работают только простые правила — система продолжает принимать отзывы.

25. API ключи

Ключ, по которому сторонний партнёр обращается к данным вашей организации: касса, система лояльности, сайт с онлайн-записью, витрина сети. Ключ создаёте вы и передаёте его партнёру — как пароль: по нему работают от имени вашей организации.

Выбор функций в режиме «свой набор» выглядит так же, как права группы доступа: блоки, группы, пункты и поиск. Рядом с каждым пунктом подписано название функции в системе — именно его партнёр указывает в запросе, и именно эту строку вы отмечаете, когда он просит доступ.

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

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

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

Частота ограничена: 120 запросов в минуту на ключ. Опрос состояния зала раз в несколько секунд в это укладывается с запасом.

Документация для партнёра — API для партнёров: адрес, формат запроса и ответа, список действий, коды ошибок, готовая коллекция Postman. Отдайте эту ссылку вместе с ключом, больше разработчику ничего не нужно. ---

26. Глобальные настройки (настройки организации)

Клиенты и заказы

Раздел Общие настройки.

Импорт из другой системы (SENET)

Мастер в четыре шага: набор данных → реквизиты доступа → цель → запуск.

Опция «очистить текущий список» удаляет прежние записи перед загрузкой — применяйте осознанно. Импорт идёт в фоне, результат остаётся в задаче.

---

27. Сотрудники и права

Сотрудники

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

Сотрудник видит только назначенные ему клубы — это касается и карты, и заказов, и показателей в шапке.

Группы доступа

Раздел Группы доступа — наборы разрешённых функций.

В окне группы права сгруппированы по блокам (Клуб, Магазин, Клиенты, Тарификация, Персонал и доступ, Организация) и разделам. Есть поиск по названию и чекбокс «выбрать всю группу целиком».

В списке групп у каждой строки — иконка со счётчиком сотрудников: она открывает состав группы, где отмечаются сотрудники организации. У сотрудника одна группа доступа, поэтому отметка переводит его сюда из прежней (она подписана рядом), а снятая — оставляет без группы.

Владельцу группы не нужны: у него полный доступ всегда.

---

28. Аналитика

Раздел Аналитика — дашборд за выбранный период.

Период: готовые варианты (сегодня, вчера, 7 дней, месяц, год…) или свой период. У своего периода задаются не только даты, но и время начала и конца — можно посмотреть, например, только вечерние часы. Конец включается целиком: 00:00–23:59 — это ровно сутки.

Гранулярность — по дням или по месяцам.

Показатели: общая выручка, выручка станций и магазина, отдельно кальян и алкоголь, загрузка, активные и новые клиенты.

Графики: выручка по периодам, загрузка, выручка по группам станций, средняя загрузка по часам суток и тепловая карта загрузки.

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

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

Выручка по неделям — график за последние 18 недель: столбцы — сумма недели, линия — средняя выручка за день этой недели. Неделя считается с понедельника; текущая, ещё не законченная, делится на прошедшие дни и в подсказке подписана «неполная», иначе она всегда выглядела бы провалом.

Окна этих двух блоков фиксированные — 30 дней и 18 недель, они не зависят от фильтра периода в шапке (меняется только выбор клуба). Об этом сказано в подписи каждой карточки.

Данные за прошедшие дни считает ночной расчёт, сегодняшний день — на лету. Если задать время, весь период пересчитывается по исходным данным.

---

29. Как клиент пользуется станцией

1. Регистрация — на станции по почте и паролю, код подтверждения приходит письмом. Можно сразу ввести промокод. 2. Вход — почта и пароль, QR-код через мобильное приложение или помощь администратора (он вводит данные с карты клуба, станция подтверждает вход). 3. Сессия — идут бесплатные минуты клуба, затем абонемент, затем деньги с баланса. Клиент видит остаток и баланс. 4. Каталог — игры (запуск в один клик), товары с ценами своего клуба. 5. Заказ — корзина с комбо и сопутствующими товарами; заказ появляется на доске у персонала, деньги не списываются. 6. Завершение — клиент выходит сам, либо сессия закрывается по исчерпании средств. Брошенную сессию система закроет сама и не спишет лишнего.

---

30. Частые задачи

---

31. Что важно помнить

• Учётная запись клиента общая для всех клубов системы, а баланс, скидки и абонементы — ваши, внутри организации.
• Кассу указывать обязательно при любом пополнении: без этого не сойдутся показания.
• Абонемент горит по часам, а не по наигранному времени.
• Тариф привязан к группе станций: дыра в расписании означает бесплатную игру.
• Заказы не списывают деньги — оплата на месте, поэтому отмена ничего не возвращает на баланс (кроме товара на склад).
• Долг блокирует вход клиента до расчёта.
• Сотрудник видит только свои клубы — если данных не видно, проверьте его список клубов и группу доступа.