Обычно мои проекты начинаются с какой-нибудь инфраструктурной задачи: автоматизировать развёртывание, проверить работу API или собрать инструмент, которого не хватает в повседневной работе. У Parlor Night история немного другая. Мне хотелось играть в шахматы и шашки с племянником, который находится далеко от меня, и проводить с ним время независимо от расстояния.
С друзьями похожая ситуация: собраться вместе за настольной игрой получается редко. У каждого работа, семья, собственные планы, поэтому поиск свободного вечера иногда напоминает согласование технологического окна между несколькими подразделениями. Хотелось сделать место, куда можно зайти из браузера, пригласить своих и спокойно поиграть.
Так появился Parlor Night - собственная гостиная настольных игр с чатами, видеосвязью и столами для своей компании. Всё работает на моём сервере, без внешних игровых API и телеметрии. А небольшая задача «сделать шахматы для нас с племянником» постепенно приобрела вполне самостоятельную жизнь.
Сначала доска, потом целая гостиная
Для меня было важно, чтобы можно было не только передвигать фигуры, но и разговаривать во время партии. Обсудить ход, показать интересную комбинацию, увидеть реакцию на неожиданную шашечную ловушку - именно из таких вещей складывается совместный вечер. Поэтому рядом с игровым полем появились чат, камера и микрофон.
Потом захотелось добавить игры для друзей. Шахматы хороши для двоих, но когда собирается компания, нужен стол побольше и желательно колода карт. В результате сейчас в Parlor Night восемь игр:
- Шахматы.
- Русские шашки.
- Го на досках 9×9, 13×13 и 19×19.
- Уно.
- Подкидной и переводной дурак.
- Безлимитный техасский холдем до шести игроков.
- Блэкджек против дилера.
- Преферанс на троих.
В шахматы, шашки и го можно играть как с человеком, так и с компьютером. Это удобно, если хочется потренироваться, а остальные сегодня заняты. Компьютер хотя бы не переносит встречу за десять минут до начала, хотя иногда после партии хочется, чтобы всё-таки перенёс.
Как собирается компания
В приложении есть общая гостиная, личный кабинет, друзья и беседы. Можно договориться о партии, создать стол и пригласить участников, а во время игры общаться в чате этого стола. Присоединиться можно по приглашению или коду.
Столы бывают открытыми и закрытыми. Открытую партию разрешено смотреть, закрытую видят только её участники. Можно устроить небольшой турнир со зрителями или спокойно сыграть своей компанией, не объясняя посторонним, почему ферзь оказался под боем и действительно ли это была жертва.
Камера и микрофон включаются по желанию, наблюдатели в созвон не входят. Если разговаривать неудобно, можно оставить только игру и текстовый чат. Для интерфейса предусмотрены светлая и тёмная темы: хотелось сделать спокойное место, в котором комфортно провести вечер.
Фишки без настоящих денег
За победы и ничьи начисляются внутренние фишки. В покере, блэкджеке и преферансе они используются для ставок и формирования банка, а сами эти игры доступны пользователям от 18 лет.
Реальных денег в проекте нет: фишки нельзя купить или вывести. Они нужны для игровой механики и дружеского соперничества, поэтому неудачный вечер за покером заканчивается потерей виртуального банка и необходимостью выслушать довольных друзей. Семейный бюджет в этой партии не участвует.
Что работает под капотом
Серверная часть написана на Python с использованием FastAPI. Страницы формируются через Jinja2, за взаимодействие в браузере отвечает JavaScript. PostgreSQL хранит учётные записи, сессии и данные партий, а Valkey используется для счётчиков входа и отметок присутствия игроков.
Развёртывание выполняется через Docker Compose. Приложение можно поднять рядом с остальными сервисами, поэтому выделять отдельный Kubernetes-кластер ради вечерней партии в шашки пока не пришлось. Хотя человек с домашней инфраструктурой прекрасно понимает, насколько условно здесь слово «пока».
Сейчас приложение рассчитано на один веб-процесс. В нём находятся пулы шахматного и шашечного движков, а также комнаты установления созвонов. Такая архитектура задаёт понятную границу: для запуска нескольких процессов потребуется отдельно решить вопрос общего состояния.
При недоступности Valkey счётчики и отметки присутствия обрабатываются в памяти процесса. Работа продолжается, но после перезапуска эти данные теряются. Основные данные приложения при этом хранятся в PostgreSQL.
Кто думает за компьютер
За шахматного соперника отвечает Stockfish. Для шашек и го реализован собственный поиск ходов, поэтому компьютер выбирает продолжение партии средствами игровых алгоритмов.
Языковых моделей в проекте нет. Здесь нужны легальные ходы и оценка позиции, а Stockfish прекрасно справляется с созданием проблем на доске самостоятельно. Особенно когда ты уже успел решить, что сегодня находишься в отличной форме.
Видеосвязь и ограничения
Аудио и видео передаются напрямую между браузерами участников. Сервер помогает им установить соединение, отдельного медиасервера в проекте нет.
У этого подхода есть ограничение: в некоторых сетях прямое соединение установить не получается, поэтому созвон может не заработать. Сама партия при этом продолжается, поскольку игровое состояние обслуживается сервером независимо от видеосвязи. Неудавшийся разговор не должен забирать с собой почти выигранную партию.
Ради чего всё это
Parlor Night готов к использованию. Текущая конфигурация слушает только localhost, поэтому перед открытием доступа из интернета необходимо настроить фильтрацию входящих соединений.
Главная ценность проекта для меня - возможность чаще проводить время с близкими. Сыграть с племянником, который далеко, собрать друзей за картами, поговорить между ходами. Приятно, когда собственная инфраструктура помогает организовать такой вечер: сервер работает, партия идёт, а мы наконец собрались за одним столом.
Статус: готов
Стек: Python, FastAPI, Jinja2, PostgreSQL, Valkey, Docker Compose, JavaScript, Stockfish.