Движок схватки

Движок для ночной поисковой игры Схватка (похожа на Дозоры, Энкаунтер)

Позволяет планировать и проводить игры. Состоит из REST-интерфейса и telegram бота

Core-функционал:

• Редактор сценария игры,

• Управление подготовкой к игре,

• Формирование команды капитаном,

• Назначение заместителей капитана с разными полномочиями,

• Сборка заявок на игру,

• Проведение игры,

• Информирование организаторов о ходе игры,

• Формирование результатов игры,

• Сохранение статистики прошедших игр

Документация

How to run without docker:

1. cp config_dist config

2. Заполнить конфиги в config

3. Заполнить url бд в alembic.ini

4. Запустить и применить миграции python -m alembic upgrade head .

uv pip install .
export BOT_PATH=$PWD
shvatka-tgbot

How to run with Docker

1. cp config_dist config

2. Заполнить конфиги в config

3. Заполнить url бд в alembic.ini

4. Запустить и применить миграции docker-compose run cli -c "python -m alembic upgrade head"

5. docker-compose up -d

How to fix deps

uv pip compile pyproject.toml > lock.txt

How to test

pytest tests

or only unittests (faster):

pytest tests/unit

Linters

Linux:

ruff format . && ruff --fix . && mypy .

Windows:

ruff format . ; ruff --fix . ; mypy .