Учёт посещаемости без бумажного журнала — с понятными границами автоматизации

У каждой группы есть постоянный checkinToken. Именно он зашит в QR-карточку, которую можно распечатать или показать на экране. Это не одноразовый код конкретной тренировки.

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

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

Для отметки по QR нужен вход в аккаунт SportControl. Система проверяет, что пользователь состоит в организации и является участником именно этой группы. Обычно это спортсмен, который занимается в группе.

Родитель не может закрыть визит ребёнка своим QR-кодом. Его доступ к посещаемости только для чтения: он видит занятия детей, но не ставит и не меняет отметки. Если ребёнок не может отметиться сам, это делает тренер вручную.

Тренер не использует QR для массовой отметки: он открывает занятие и ставит статусы в списке каждому участнику.

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

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

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

Тренер открывает занятие в расписании и загружает состав группы. Список не обновляется сам: чтобы увидеть новые QR-отметки, нужно нажать «Обновить» или заново открыть карточку. Это важно, если несколько человек отмечаются прямо на тренировке.

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

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

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

Экран только для чтения. Родитель не ставит статус, не исправляет его и не отмечает ребёнка через свой аккаунт. Изменения делает тренер или администратор.

Спортсмен видит свои последние отметки: занятие, группа, статус и время. Это ограниченная выборка, а не полная история за все годы.

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

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

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

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

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

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

Начните с одной группы и одной недели. Распечатайте QR-карточку, покажите тренеру список и кнопку обновления, договоритесь, кто отмечает вручную. После тренировки проверяйте, что все участники получили статус.

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

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