Skip to content

Feature Admin

Denis Revyagin edited this page Oct 30, 2026 · 2 revisions

F6. Панель администратора

Назад к Requirements.

Назначение

Команда проекта следит за тем, пользуются ли ботом (это критерий SMART-цели из Concept: 60 пользователей, половина активна еженедельно) и работает ли парсер. Панель реализуется внутри самого бота как набор команд, доступных только администраторам; отдельный веб-интерфейс не создаётся.

Требования

  • Администраторы задаются списком Telegram ID в конфигурации сервиса; команды панели для остальных пользователей недоступны и не отображаются.
  • FR-15. Команда /users показывает список пользователей постранично: Telegram ID, группа, дата регистрации, дата последней активности.
  • FR-16. Команда /stats показывает сводку: всего пользователей, активных за 7 дней, активных за 30 дней, число групп, заметок, пользователей с включёнными уведомлениями; дата и результат последнего обновления расписания.
  • FR-17. Команда /update запускает внеплановое обновление расписания; можно указать группу: /update ЕТ-414.
  • Команда /log показывает последние 20 записей журнала парсера.
  • Администратор не может читать заметки пользователей.

Сценарии

UC-13. Просмотр списка пользователей

Краткое описание Администратор просматривает, кто зарегистрирован в боте и когда последний раз им пользовался
Актор Администратор
Предусловия Telegram ID администратора указан в конфигурации
Постусловия Администратору отправлен список пользователей с постраничной навигацией

Основной сценарий

  1. Администратор отправляет /users.
  2. Бот проверяет, что Telegram ID отправителя есть в списке администраторов.
  3. Бот читает первые 20 пользователей, отсортированных по дате последней активности.
  4. Бот отправляет список и кнопки «Дальше» / «Назад».
  5. Администратор листает страницы.

Альтернативные сценарии

  • 2а. Отправитель не администратор: бот отвечает как на неизвестную команду, не раскрывая существование панели.
  • 3а. Пользователей нет: бот сообщает «Пользователей пока нет».

UC-14. Ручной запуск обновления расписания

Краткое описание Администратор принудительно обновляет расписание после сообщения об изменении на сайте
Актор Администратор
Предусловия Администратор авторизован по Telegram ID; парсер в данный момент не выполняется
Постусловия Расписание указанной группы (или всех активных групп) обновлено; администратору отправлен результат

Основной сценарий

  1. Администратор отправляет /update или /update ЕТ-414.
  2. Бот проверяет права администратора.
  3. Бот ставит задачу обновления в очередь парсера и отвечает «Обновление запущено».
  4. Парсер выполняет обновление по сценарию UC-06 для указанных групп.
  5. По завершении бот отправляет администратору отчёт: число обновлённых групп, число изменённых пар, список ошибок.

Альтернативные сценарии

  • 1а. Указанная группа не найдена в базе: бот сообщает об этом и обновление не запускается.
  • 3а. Парсер уже выполняется: бот сообщает «Обновление уже идёт» и не запускает второе.
  • 4а. Сайт недоступен: парсер действует по сценарию UC-07, администратор получает отчёт с ошибкой.

Clone this wiki locally