Repository navigation
Feature Admin
Denis Revyagin edited this page Nov 12, 2026
·
2 revisions
Это целевая спецификация последующего релиза, а не перечень уже реализованных возможностей. Фактический статус — на странице Home.
Назад к Requirements.
Команда проекта следит за тем, пользуются ли ботом (это критерий SMART-цели из Concept: 60 пользователей, половина активна еженедельно) и работает ли парсер. Панель реализуется внутри самого бота как набор команд, доступных только администраторам; отдельный веб-интерфейс не создаётся.
- Администраторы задаются списком Telegram ID в конфигурации сервиса; команды панели для остальных пользователей недоступны и не отображаются.
- FR-15. Команда
/usersпоказывает список пользователей постранично: Telegram ID, группа, дата регистрации, дата последней активности. - FR-16. Команда
/statsпоказывает сводку: всего пользователей, активных за 7 дней, активных за 30 дней, число групп, заметок, пользователей с включёнными уведомлениями; дата и результат последнего обновления расписания. - FR-17. Команда
/updateзапускает внеплановое обновление расписания; можно указать группу:/update ЕТ-414. - Команда
/logпоказывает последние 20 записей журнала парсера. - Через интерфейс администратора нельзя читать тексты личных заметок пользователей; статистика содержит только их количество. Это ограничение интерфейса, а не утверждение об отсутствии прямого доступа к базе у её владельца.
| Краткое описание | Администратор просматривает, кто зарегистрирован в боте и когда последний раз им пользовался |
| Актор | Администратор |
| Предусловия | Telegram ID администратора указан в конфигурации |
| Постусловия | Администратору отправлен список пользователей с постраничной навигацией |
Основной сценарий
- Администратор отправляет
/users. - Бот проверяет, что Telegram ID отправителя есть в списке администраторов.
- Бот читает первые 20 пользователей, отсортированных по дате последней активности.
- Бот отправляет список и кнопки «Дальше» / «Назад».
- Администратор листает страницы.
Альтернативные сценарии
- 2а. Отправитель не администратор: бот отвечает как на неизвестную команду, не раскрывая существование панели.
- 3а. Пользователей нет: бот сообщает «Пользователей пока нет».
| Краткое описание | Администратор принудительно обновляет расписание после сообщения об изменении на сайте |
| Актор | Администратор |
| Предусловия | Telegram ID администратора указан в конфигурации |
| Постусловия | Запрос обработан по правилам очереди и ограничения частоты; после выполнения администратору отправлен результат с успешными обновлениями и ошибками |
Основной сценарий
- Администратор отправляет
/updateили/update ЕТ-414. - Бот проверяет права администратора.
- Бот ставит задачу обновления в очередь PostgreSQL и отвечает «Запрос обновления принят». Принятие запроса не означает, что загрузка уже началась.
- Парсер выполняет обновление по сценарию UC-06 для указанных групп. Если час с начала предыдущего обычного цикла группы ещё не прошёл, запрос ждёт разрешённого времени; ручной запуск не обходит NFR-3.
- По завершении бот отправляет администратору отчёт: число обновлённых групп, число изменённых пар, список ошибок.
Альтернативные сценарии
- 1а. Указанная группа не найдена в базе: бот сообщает об этом и обновление не запускается.
- 3а. Запрошенная группа уже обновляется: бот сообщает об этом и не создаёт для неё параллельный дубль. Остальные группы общего запроса могут ожидать своей обработки в очереди.
- 3б. Такой запрос уже ожидает в очереди: бот сообщает об ожидании и не создаёт дубликат.
- 4а. Сайт недоступен: парсер действует по сценарию UC-07, администратор получает отчёт с ошибкой.