Skip to content

1.0.0

Choose a tag to compare

@iSlavok iSlavok released this 11 Oct 15:36
b72a518

The first release of the club Ш bot and its admin panel.

Bot

  • Students
    • /start registers the student.
    • /vk links their VK, once and for good: a profile link with confirmation, or a VK ID sign-in. The mode is chosen in the settings.
    • /status shows the VK, the club, the block, "you are in the next block too" and the chat state, with a join button.
    • /schedule lists 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
    • /login gives a code to sign in to the admin panel; /adminka gives the link.
    • /summary shows 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.yml for 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.