school_menu/README.en.md

School Menu Bot

Русский · English

A school cafeteria Telegram bot: every morning it posts the menu from the school website, takes breakfast, lunch and snack orders by class and compiles a summary for the cafeteria.

Status: school project (2021–2022), completed, archived

Stack: Python 3.10 · aiogram 2 · SQLite · openpyxl (menu from Excel) · pymorphy2

• Today's and tomorrow's menu (/today, /tomorrow) and a 06:00 broadcast
• Ordering with buttons, cancelling and changing an order
• Class registration by code, separate groups for students and the cafeteria
• Order summary by class with correct Russian word forms

Running

pip install -r requirements.txt
cd code && BOT_TOKEN=token BOT_ID=bot_id TECH_GROUP_ID=group_id python bot.py

Portion weights and calories from Excel are parsed without eval: only numbers and + - * / are allowed.

Docker: docker run -d -e BOT_TOKEN=token -e BOT_ID=bot_id -e TECH_GROUP_ID=group_id -v school-menu-db:/app/db ghcr.io/edeev/school_menu (same as git.deev.su/edeev/school_menu); on first start the databases from the repository are copied into the volume.

License

School project (2021–2022). The code is open for study; there is no separate license.

Author

Egor Deev — GitHub · Telegram · egor@deev.space

---

_{⭐ If you find this project useful, give it a star on GitHub!}

_{Made with ❤️ — deev.space}