Skip to content

Feature Admin

Denis Revyagin edited this page Nov 12, 2026 · 2 revisions

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

Это целевая спецификация последующего релиза, а не перечень уже реализованных возможностей. Фактический статус — на странице Home.

Назад к 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. Бот ставит задачу обновления в очередь PostgreSQL и отвечает «Запрос обновления принят». Принятие запроса не означает, что загрузка уже началась.
  4. Парсер выполняет обновление по сценарию UC-06 для указанных групп. Если час с начала предыдущего обычного цикла группы ещё не прошёл, запрос ждёт разрешённого времени; ручной запуск не обходит NFR-3.
  5. По завершении бот отправляет администратору отчёт: число обновлённых групп, число изменённых пар, список ошибок.

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

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

Clone this wiki locally