Skip to content

tajnyj_ded_bot v0.1.0

Latest

Choose a tag to compare

@xelvhk xelvhk released this 03 Jun 12:13

tajnyj_ded_bot v0.1.0

First documented release for tajnyj_ded_bot, a Telegram Secret Santa bot for participant registration, gift wishes, random matching, and private assignment delivery.

Highlights

  • Added release-ready bilingual documentation.
  • Added .env.example for local setup.
  • Added GitHub Actions CI for dependency installation, compile checks, and module import smoke checks.
  • Added CHANGELOG.md.
  • Added data/.gitkeep so the local SQLite runtime directory exists while database files stay out of git.

Setup

git clone https://github.com/xelvhk/tajnyj_ded_bot.git
cd tajnyj_ded_bot
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python main.py

Known Limitations

  • Local SQLite storage is used, so deployments should preserve the data/ directory.
  • Matching starts after a fixed participant threshold in the current implementation.
  • Admin dry-run preview is not implemented yet.

Next

  • Add smoke tests for matching logic.
  • Add admin commands for stats and dry-run preview.
  • Add backup export/import for event state.