# NovaPoker — документация команды

> База знаний платформы офлайн-турниров по спортивному покеру: как работает
> каждая функция и каждый сервис. Два входа — продуктовый и инженерный.

Вся документация одним файлом: https://docs.novapoker.ru/llms-full.txt

## Продукт

- [Продукт и действующие лица](https://docs.novapoker.ru/product.md): Что за платформа, кто ей пользуется и чего она сознательно не делает
- [Что можно менять без разработки](https://docs.novapoker.ru/product/levers.md): Полный список рычагов продукта — что настраивается в интерфейсе, а что потребует кода
- [Принятые решения и почему](https://docs.novapoker.ru/product/decisions.md): Что в продукте сделано намеренно, с причинами — чтобы не переспорить это заново
- [Открытые вопросы](https://docs.novapoker.ru/product/open-questions.md): Что в продукте работает не так, как ожидает читатель, и что затронет каждое решение
- [Аккаунт и вход](https://docs.novapoker.ru/product/account.md): Один аккаунт на человека, вход по телефону и коду, обязательная анкета и куда пускает вход
- [Жизненный цикл турнира](https://docs.novapoker.ru/product/tournament-lifecycle.md): Сквозной путь от создания турнира до подтверждённых результатов, и что видит игрок на каждом шаге
- [Запись и лист ожидания](https://docs.novapoker.ru/product/registration.md): Как игрок попадает на турнир, что делает очередь и чем оборачивается неявка
- [День игры и чек-ин](https://docs.novapoker.ru/product/game-day.md): Напоминания, стойка регистрации, walk-in и момент, после которого состав зафиксирован
- [Старт, рассадка и баланс](https://docs.novapoker.ru/product/start-and-seating.md): Что происходит при старте турнира, как считаются места за столами и когда система предлагает пересадку
- [Результаты и итоги вечера](https://docs.novapoker.ru/product/results.md): Как ТД подтверждает итоги, что при этом начисляется и почему это нельзя переиграть
- [Рейтинг, уровни и сезоны](https://docs.novapoker.ru/product/rating.md): Как считаются очки, опыт и сила игрока, и что происходит на границе сезона
- [Уведомления](https://docs.novapoker.ru/product/notifications.md): Что система шлёт игроку сама, что рассылает команда вручную и почему пуши не задваиваются
- [Языки](https://docs.novapoker.ru/product/languages.md): Почему интерфейс русский, а данные двуязычные, и что это значит при заведении контента
- [Клуб — залы, блайнды, настройки](https://docs.novapoker.ru/product/club.md): Что владелец настраивает один раз, чтобы дальше заводить турниры в два клика
- [Сотрудники и дилеры](https://docs.novapoker.ru/product/staff.md): Роли в клубе, как добавляют ТД, как приглашают дилера и почему код передаёт клуб сам
- [Дилеры на турнире](https://docs.novapoker.ru/product/dealers.md): Назначение на стол, что дилер видит на смене и какой стол остался без человека
- [Что ведёт платформа](https://docs.novapoker.ru/product/platform.md): Разделы админки, кто чем управляет из контента и почему правила рейтинга — настройка, а не константа

## Разработка

- [Ландшафт и границы](https://docs.novapoker.ru/dev.md): Четыре сервиса, как они связаны и где проходит контракт между ними
- [poker-api](https://docs.novapoker.ru/dev/poker-api.md): Бэкенд платформы — HTTP, WebSocket, база, фоновые задачи и формулы рейтинга
- [poker-player](https://docs.novapoker.ru/dev/poker-player.md): Приложение игрока — афиша, запись, live-экран, рейтинг и профиль
- [poker-organizer](https://docs.novapoker.ru/dev/poker-organizer.md): Приложение клуба — создание турниров, день игры, live-пульт и результаты
- [poker-admin](https://docs.novapoker.ru/dev/poker-admin.md): Админка платформы — клубы, контент, справочники, модерация и правила рейтинга
- [Доменная модель](https://docs.novapoker.ru/dev/domain-model.md): Тридцать моделей Prisma — люди, клубы, игра, платформа — и что кладёт сид
- [Аутентификация и роли](https://docs.novapoker.ru/dev/auth.md): OTP по телефону, пара токенов с ротацией refresh, матрица прав и проверка ролей клуба
- [Формат ошибок и загрузка файлов](https://docs.novapoker.ru/dev/api-conventions.md): Стабильные коды ошибок, на которые завязаны фронты, и как картинки попадают в хранилище
- [Запись — контракт и переходы](https://docs.novapoker.ru/dev/registration.md): Эндпоинты записи, транзакция под блокировкой турнира, страйки и бан
- [День игры — контракт и фон](https://docs.novapoker.ru/dev/game-day.md): Чек-ин, walk-in, напоминания в pg-boss и что происходит при старте турнира
- [Live-цикл и реалтайм](https://docs.novapoker.ru/dev/live.md): Старт, часы, вылеты и балансировка — операции, защита от гонок и формат LiveState
- [Результаты и аудит](https://docs.novapoker.ru/dev/results.md): Транзакция начисления, гейт от второго нажатия, гости без профиля и журнал действий
- [Рейтинг — пакет формул и начисление](https://docs.novapoker.ru/dev/rating.md): Изолированный пакет rating, точные формулы, конфиг платформы и эндпоинты лидербордов
- [Фоновые задачи и уведомления](https://docs.novapoker.ru/dev/notifications.md): pg-boss без Redis, два расписания, дедупликация напоминаний и работа с токенами устройств
- [Окружения, стенды и деплой](https://docs.novapoker.ru/dev/environments.md): Переменные окружения, локальный стенд на четыре процесса, адреса стейджинга и правила Dokploy
- [Тесты и CI](https://docs.novapoker.ru/dev/testing.md): Чем покрыт каждый репозиторий, как устроены серверные e2e-тесты и что запускает CI
- [Клубы — контракт и оргконтекст](https://docs.novapoker.ru/dev/organizers.md): Членства, роли, приглашения дилеров, залы и структуры блайндов; как фронт выбирает клуб
- [Админка — права, модерация, метрики](https://docs.novapoker.ru/dev/admin.md): Гейт по adminRole, карта разделов на права, слияние дублей и как считаются метрики
- [Как поддерживать документацию](https://docs.novapoker.ru/dev/how-to-maintain.md): Как добавить статью, что значит «сверено», и почему сборка падает на секретах