tajnyj_ded_bot v0.1.0

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.