Repository navigation
1.0.0
The first release of the club Ш bot and its admin panel.
Bot
- Students
/startregisters the student./vklinks their VK, once and for good: a profile link with confirmation, or a VK ID sign-in. The mode is chosen in the settings./statusshows the VK, the club, the block, "you are in the next block too" and the chat state, with a join button./schedulelists lessons, curator calls and homework deadlines up to the end of the block.
- Club chat
- Students with access get a personal join link. The bot approves only the link's owner and never declines anyone.
- It removes the students it let in once they lose access. Kicks wait while the next block's list is empty.
- Optionally it hides join and leave messages.
- Reminders. Lessons, curator calls and homework deadlines are posted to the club chat topic on configurable offsets. Optional notices go out when a lesson is moved, cancelled or its deadline changes.
- Admins
/logingives a code to sign in to the admin panel;/adminkagives the link./summaryshows each club: block, members, sheet sync, reminders and chat.- Owner alerts cover sync failures, sheet problems, removals to confirm, failed reminders and chat problems.
Sheet sync
- The club's Google Sheet is mirrored into block memberships, periodically and on demand.
- Sheet problems are reported.
- Removals from a block wait for confirmation in the alert chat.
Admin panel
- Sign-in with a code from the bot (or the Telegram widget).
- Roles and permissions, admins.
- Clubs, blocks and their members with the chat state.
- Sheet sync history and problems.
- Lessons with homework, reminder feed with preview and cancel.
- Users and bot settings.
Delivery
- One backend process: FastAPI, the aiogram bot and the APScheduler worker. The admin panel is served by its own nginx image.
docker-compose.ymlfor a single VPS, with migrations as a one-shot service and container log rotation.- CI: gitleaks, ruff, pyright, pytest with an alembic drift check, frontend lint, types, tests and build, and a docker build.
- CD: a published release → images in GHCR → deploy over SSH with
up --wait. A manual Deploy of an older version is the rollback.