Volunteers Telegram Bot

Volunteers Bot is a production-oriented Telegram bot for managing volunteers, built with Python and aiogram 3. It handles registration through a guided FSM flow, a database-backed FAQ that admins can edit, and a support-ticket system where user messages reach an admin group and admins reply simply by responding to the bot's post.

It also supports mass broadcasts (text or photo with optional URL buttons), a suggestions box, group commands, and a super-admin panel for searching users and promoting or demoting admins. The bot ships with Uzbek and Russian interfaces, per-user rate limiting, centralised logging, and a global error handler.

It uses SQLAlchemy 2 (async) with PostgreSQL in production and SQLite locally, Redis for FSM state and rate limits, and Alembic for migrations.