Files
magistr/UX_SITE_CHECKLIST.md
2026-08-20 00:55:27 +03:00

9.4 KiB
Raw Permalink Blame History

Чек-лист проверки UX-изменений на сайте

Перед проверкой

  1. Запустите проект: docker compose up -d --build.
  2. Откройте http://localhost:80 или production-сайт.
  3. Для полной проверки нужны пользователи с ролями ADMIN, EDUCATION_OFFICE, DEPARTMENT, TEACHER и STUDENT.
  4. Пагинацию можно полноценно проверить, если в справочнике больше 25 записей.

Что проверить

№ Роль и куда зайти Что нажать Что должно быть видно
1 ADMIN → Дашборд, Группы обучения или Пользователи Просто откройте вкладки Под заголовком нет общей панели КОНТЕКСТ; она не занимает место в разделах, которым учебный период не нужен
2 ADMIN → Группы обучения Введите текст в Поиск, выберите форму обучения и сортировку, затем обновите страницу Фильтры остаются выбранными, а в адресной строке появляются параметры groupQuery, groupEducationForm, groupSort, groupPage
3 ADMIN → Группы обучения, Пользователи, Дисциплины, Заявки Используйте поиск, фильтры, сортировку, Назад / Далее и список На странице: 25 / 50 / 100 Таблица обновляется без полной загрузки всех записей; показан диапазон вида «Показано 1–25 из …»
4 ADMIN или EDUCATION_OFFICE → Просмотр расписаний Откройте вкладку, не нажимая на поле Группа; затем раскройте Дополнительные фильтры, выберите Учебный год и Семестр и нажмите Показать При открытии список групп свёрнут; семестры ограничиваются выбранным годом, значения сохраняются в URL; экран показывает опубликованное расписание
5 ADMIN → Группы обучения → у группы кнопка Календарь Выберите учебный год и начните печатать название графика Совместимые календарные графики ищутся асинхронно; весь справочник заранее не загружается. Сохранять назначение для проверки не обязательно
6 ADMIN или EDUCATION_OFFICE → Конструктор правил В верхней карточке по очереди выберите Учебный год, Семестр, Версию расписания; затем раскройте Группы и найдите преподавателя или аудиторию Каждый селект ограничивает следующий; загружаются версии только выбранного семестра, а большие справочники ищутся через поисковые списки
7 ADMIN или EDUCATION_OFFICE → Запросы преподавателей → блок Зарегистрировать отсутствие Начните вводить ФИО преподавателя из любой кафедры Поиск находит преподавателя, а список результатов отображается поверх блока Реестр инцидентов, не прячется за ним
8 ADMIN → Календарный график → Сетки Выберите график → Загрузить сетку → измените ячейку или примените Заполнить диапазон → нажмите другую вкладку слева Кнопка меняется на Сохранить сетку •, затем появляется диалог Несохранённые изменения с действиями Остаться и Покинуть без сохранения
9 ADMIN → Конструктор правил Сначала сразу перейдите в другой раздел, затем вернитесь, измените любое поле правила и снова попробуйте уйти Без изменений переход выполняется без предупреждения; после ручного изменения появляется диалог Несохранённые изменения
10 ADMIN → Группы обучения У активной группы нажмите Архив, затем в диалоге нажмите Отмена Появляется проектный диалог Архивировать группу?, а не системное окно браузера; данные после отмены не меняются
11 TEACHER → Расписание Просто откройте кабинет; затем нажмите Сегодня Над недельным расписанием видны карточки Сегодня и Следующая пара; кнопка возвращает к текущей неделе
12 STUDENT → страница расписания Начните вводить название группы, выберите её и нажмите Сегодня Группа ищется асинхронно; появляются карточки Сегодня и Следующая пара; выбранная группа сохраняется после перезагрузки
13 TEACHER → Мои пожелания или Заявки на изменение Переключите вкладку и обновите страницу Открытая вкладка восстанавливается из URL; выбранная неделя также сохраняется
14 Любой серверный реестр, например ADMIN → Дисциплины Введите заведомо отсутствующую строку, например ___нет_такой_записи___ Появляется понятное пустое состояние Дисциплины не найдены, а не пустая таблица
15 ADMIN или EDUCATION_OFFICE → Версии расписания, затем Анализ качества На обеих вкладках смените Учебный год и Семестр; в анализе дополнительно выберите Версию В «Версиях» обновляются карточки публикации/черновиков выбранного семестра, в «Анализе качества» — список доступных версий

Дополнительные проверки

Ошибка и повторная загрузка

  1. Откройте DevTools → Network → включите Offline.
  2. Обновите реестр групп, пользователей, дисциплин или заявок.
  3. Должно появиться сообщение об ошибке и кнопка Повторить.
  4. Верните Online и нажмите Повторить — данные должны загрузиться.

UX-аналитика

До выполнения действий вставьте в консоль браузера:

document.addEventListener('magistr:ux-event', event => console.log(event.detail));

После смены вкладки, фильтра или загрузки расписания в консоли должны появляться UX-события. На production они также преобразуются в OpenTelemetry spans.

Ролевое ограничение кафедры

Войдите как DEPARTMENT → Запросы преподавателей и начните искать преподавателя в блоке регистрации отсутствия. В результатах должны быть только преподаватели текущей кафедры. Во вкладке Просмотр расписаний доступны локальные селекты учебного года и семестра, но не черновики версий.

Что пока не проверяем

Массовое назначение одного календарного графика нескольким группам намеренно не реализовано. Проверяется только существующее одиночное назначение через Группы обучения → Календарь.