Инструкция

1. Добавьте кураторов и тренеров — это справочники для договоров и привязки к кортам.
2. Создайте группы игроков — в клубе 4 фиксированные: спортивная/реабилитационная, взрослая/детская.
3. Заведите игроков: телефон (+7) для входа в приложение, email — для сброса пароля. Новые регистрации из приложения разбирайте в фильтре «Новые регистрации».
4. Добавьте корты: регион и город выбираются из справочника России.
5. В карточке корта настройте занятия тренеров (день, время, тренер, макс. игроков) и закрепите группу за слотом.
6. В разделе «Расписание» проверьте занятия и при необходимости запишите отдельных игроков.
7. Создавайте турниры и назначайте сдачу нормативов — приглашения уйдут в приложение игрока.

Все формы добавления открываются кнопкой «Добавить» вверху страницы. Клик по строке таблицы открывает карточку для редактирования.

• Нажмите «Добавить куратора», заполните ФИО, телефон, паспорт и реквизиты.
• При необходимости укажите срок договора и прикрепите скан.
• В карточке куратора можно загрузить фото и обновить договор.
• Куратора можно назначить на корт при создании или в карточке корта.

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

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

• При добавлении укажите ФИО, телефон (+7), город, дату рождения, диагноз и группу.
• Для игроков младше 18 лет обязательны контакты родителя.
• Карточка игрока разделена на вкладки: профиль и спорт, турниры, документы.
• В профиле — разряд и история разрядов; в документах — договор, справки.
• Телефон — для входа в приложение; email — для регистрации и сброса пароля.
• В таблице есть столбец «Вход в приложение» — дата последнего входа или «Не входил».
• Если письмо с кодом не дошло: в карточке «Задать пароль» (вход сразу по телефону) или «Выслать код» ещё раз.
• Фильтр «Регистрация → Новые регистрации» — очередь игроков из приложения на разбор оператором.
• В карточке можно заблокировать или разблокировать доступ к мобильному приложению — без перевода игрока в «неактивен».

• Создайте корт: название, регион, город, адрес, покрытие, контакты, стоимость.
• Назначьте куратора и закрепите тренеров.
• В карточке корта: дата открытия, договор аренды, занятия тренеров.
• В «Занятиях тренеров» задайте день недели, время, тренера и максимум игроков.
• Можно закрепить группу за слотом — тогда занятия появятся в расписании автоматически.

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

• Вкладка «Журнал месяца» — отчёт по площадкам (табель + фото), выгрузка Excel.
• Отметки посещения и фото занятия — в «Расписании» (чек-лист + загрузка фото с отметкой игроков).
• Дата открытия группы задаётся в карточке группы; в среднем % группа со следующего месяца.
• Новички учитываются в % со следующего месяца после 1-й личной тренировки (без opening).
• Вкладка «Игроки» — пропуски за период; фильтры по группе, региону и городу.

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

• Сначала добавьте упражнения в справочник: тип (повторения / время), норматив, оценки.
• Можно прикрепить короткое видео с инструкцией.
• Назначьте сдачу: период, упражнения, группы, кому отправить приглашения.
• Тренер отмечает результаты в мобильном приложении; игрок видит достижения.

• Заведите категории товаров, затем позиции инвентаря (название, категория, остаток).
• Оформляйте приход, расход и передачу на корт — остатки на складе и по кортам обновятся.
• Вкладки показывают сводку склада, остатки по кортам и журнал операций.
• Массовая загрузка — кнопка «Из Excel» (скачайте шаблон и заполните категории и количества).

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

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

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

Где открыть

• Сайт: https://tenniscrm33.ru
• Приложение игрока: https://tenniscrm33.ru/app/player/
• Приложение тренера: https://tenniscrm33.ru/app/coach/
• Устанавливать из магазина приложений не нужно — открывается в браузере телефона.
• Удобно добавить ярлык на главный экран: в браузере «Поделиться» / «…» → «На экран Домой».
• Игроку и тренеру — разные ссылки, не путайте.

Регистрация нового игрока

1. Откройте https://tenniscrm33.ru/app/player/ и нажмите «Регистрация».
2. Заполните ФИО, телефон (+7), email, город (из списка) и дату рождения.
3. На email придёт письмо с 6-значным кодом (проверьте «Входящие» и «Спам»).
4. Введите код и придумайте пароль — регистрация завершена.
5. Дальше вход: телефон + пароль. Администратор позже проверит анкету и группу.

Вход игрока, который уже есть в базе

• Если пароль уже задан — на экране входа укажите телефон из карточки и пароль.
• Если пароля ещё нет (игрок заведён в админке): укажите email в карточке игрока → в приложении «Забыли пароль?» → код на email → новый пароль → вход по телефону и паролю.
• Либо в карточке игрока нажмите «Задать пароль» / «Выслать код» — без ожидания письма.
• Повторная регистрация не нужна — она только для тех, кого ещё нет в базе.

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

• «Мои занятия» — ближайшие тренировки; можно отметить «иду» / «не иду» (с причиной, если попросит).
• «Код для тренера» — QR и короткий код (~2 минуты) для отметки посещения на занятии.
• «NFC у корта» — поднести телефон к метке (есть не на всех телефонах; иначе используйте код).
• «Приглашения на турниры» — принять / отклонить; при необходимости загрузить видео навыков.
• «Нормативы» — период сдачи, упражнения, подтверждение участия; результаты обычно вносит тренер.
• «Достижения» — разряды и награды из карточки игрока.
• Профиль (⋯ в шапке) — контакты, смена email и пароля, выход.

Как оператор видит новые регистрации

1. В админке откройте раздел «Игроки».
2. В фильтре «Регистрация» выберите «Новые регистрации» — очередь на разбор.
3. У таких игроков в списке бейдж «Новая регистрация»; в карточке — подсказка дозаполнить профиль.
4. Проверьте и уточните диагноз, группу, документы, контакты родителя (если нужно).
5. Нажмите «Разобрано» — игрок исчезнет из очереди новых регистраций.
6. Столбец «Вход в приложение» показывает, кто уже заходил, а кто ещё нет.
7. В карточке: «Заблокировать приложение» / «Разблокировать приложение» — без перевода в «неактивен».

Приложение тренера

• Ссылка: https://tenniscrm33.ru/app/coach/ — регистрация, вход телефон+пароль, «Забыли пароль?» — как у игрока.
• Если тренер уже в справочнике: укажите email в карточке → «Забыли пароль?» в приложении → задайте пароль.
• Вкладка «Профиль» — контакты, смена email и пароля, выход.
• В админке «Тренеры» — фильтр новых регистраций, столбец входа, «Задать пароль» / «Выслать код», блокировка приложения.
• «Мои занятия» — ближайшие тренировки и сколько игроков отметили «иду» / «не иду».
• «Сканировать игрока» — камера на QR или код вручную; отметить посещение на выбранном занятии.
• «Нормативы» — внести результаты упражнений по игрокам; статус появится у игрока в приложении.

Отметка на тренировке

1. Игрок на занятии нажимает «Код для тренера» и показывает QR / код.
2. Тренер в своём приложении выбирает занятие → «Сканировать игрока» → сканирует или вводит код.
3. Код действует около 2 минут; при ошибке игрок обновляет код, тренер сканирует сразу.
4. Альтернатива: NFC у корта (если метка настроена и телефон поддерживает).
5. Отметка обычно возможна в окне около начала занятия (±30 минут).

Частые вопросы игроков и тренеров

• Письмо с кодом не пришло — подождите 1–2 минуты, проверьте «Спам», запросите код ещё раз.
• Не могу войти — убедитесь, что открыто своё приложение (игрок ≠ тренер), телефон +7…, при необходимости сбросьте пароль.
• «Нет занятий» — на неделю пустое расписание или анкета ещё не в группе; обратитесь к администратору.
• Код не принимается — код протух или занятие ведёт другой тренер.
• Подробная памятка для пользователей: docs/USER_GUIDE_MOBILE.md в репозитории.

• Вход в админку: логин и пароль из раздела «Пользователи». Выход — кнопка «Выйти» под «Инструкцией» в меню слева.
• На проде (tenniscrm33.ru) админ-авторизация включена; в .env нужны ADMIN_SESSION_SECRET и DATABASE_URL.
• После смены .env на сервере: pm2 restart tcm_prod --update-env.
• Телефоны вводятся с маской +7 — формат единый во всех формах.
• Города и регионы выбираются из встроенного справочника России.
• Массовая загрузка: кнопка «Из Excel» в разделах Корты, Кураторы, Тренеры и Игроки — скачайте шаблон и заполните его.
• Данные хранятся в PostgreSQL; фото и сканы — в каталоге data/ на сервере. Делайте бэкап БД (pg_dump).
• Сроки договоров и справок подсвечиваются в таблицах: действует / скоро истекает / просрочен.
• Если раздел не загружается локально — перезапустите: npm run dev. На сервере: pm2 logs tcm_prod.

Деплой и CI — docs/DEPLOY_SOURCECRAFT.md; памятка для мобильных пользователей — docs/USER_GUIDE_MOBILE.md.