Задача Егора 2ч.

docs/FRONTEND.md

@@ -16,6 +16,9 @@
 
 ```
 frontend/
+├── package.json            # Dependency-free проверки frontend через node:test
+├── tests/
+│   └── dashboard-conflicts.test.mjs # Регрессии дат и состояний проверки конфликтов
 ├── index.html              # 🔐 Страница авторизации (общая)
 ├── script.js               # Логика авторизации
 ├── style.css               # Стили страницы авторизации
@@ -34,6 +37,7 @@ frontend/
 │   ├── js/
 │   │   ├── main.js         # Инициализация, маршрутизация, навигация
 │   │   ├── api.js          # HTTP-обёртка (fetch + Authorization)
+│   │   ├── dashboard-conflicts.js # Чистые функции дат, загрузки и состояний Red Zone
 │   │   ├── utils.js        # Утилиты
 │   │   ├── otel.js         # OpenTelemetry (клиентская телеметрия, только прод)
 │   │   └── views/          # Модули представлений
@@ -125,6 +129,7 @@ frontend/
 
 | Tab | Описание | API |
 |-----|----------|-----|
+| `dashboard` | Сводные метрики и проверка конфликтов текущей недели с явным статусом полноты данных | `/api/departments`, `/api/classrooms`, `/api/groups`, `/api/users/teachers`, `/api/schedule/search`, `/api/admin/time-slots` |
 | `teacher-requests` | Очередь заявок кафедр на создание преподавателей с редактированием перед одобрением | `/api/teacher-requests`, `/api/departments` |
 | `users` | CRUD пользователей | `/api/users` |
 | `groups` | CRUD групп, мультифильтр списка по формам обучения, настройка 0/2/3 подгрупп для лабораторных и назначения графиков | `/api/groups`, `/api/subgroups` |
@@ -139,6 +144,7 @@ frontend/
 
 ### Особенности админских вкладок
 
+- Вкладка `dashboard` формирует date-only значения из локальных компонентов даты, а текущую неделю — от отдельного объекта понедельника до `понедельник + 6 дней`. Расписания кафедр загружаются независимо через `Promise.allSettled`: `COMPLETE` означает ответы всех кафедр, `PARTIAL` — только части, `NOT_RUN` — отсутствие пригодных ответов или кафедр. Зелёная карточка «Конфликты расписания не обнаружены» разрешена только для `COMPLETE` без найденных конфликтов; частичный результат всегда остаётся предупреждением, а полный отказ показывается как «Проверка не выполнена». Технические причины отказов в DOM не выводятся.
 - Вкладка `groups` загружает кафедры, специальности, профили, учебные годы и календарные графики. Список групп открывается через `/api/groups?includeArchived=true`, поэтому в таблице видны активные, будущие, завершившие обучение и архивные группы со статусом. Группа создаётся через `/api/groups` с `specialtyId` и `specialtyProfileId`, а модалка редактирования использует широкую сетку полей без внутреннего пустого скролла. Блок подгрупп использует `/api/subgroups` и `/api/groups/{id}/subgroups`, а блок назначений использует `/api/groups/{id}/calendar-assignments`. После назначения графика в таблице назначений сразу выводятся дисциплины графика, сгруппированные по номерам семестров. В селекты подгрупп и назначений попадают только группы с `active=true`.
 - Вкладка `teacher-requests` показывает pending-заявки кафедр на создание преподавателей. Администратор может скорректировать кафедру, логин, ФИО и должность, задать пароль минимум 8 символов, затем одобрить заявку через `/api/teacher-requests/{id}/approve` или отклонить её через `/api/teacher-requests/{id}/reject`. Для роли `ADMIN` счётчик pending-заявок выводится в пункте меню «Заявки» и рядом с заголовком страницы, чтобы очередь была видна без открытия вкладки.
 - Вкладка `department-workspace` в блоке преподавателей объединяет данные `/api/department/teachers` и `/api/workload/teachers`: каждый преподаватель показывается одной карточкой с должностью и нагрузкой за выбранный период, преподаватели без занятий получают нулевую нагрузку, а преподаватели из расписания добавляются без дублей. Если дата начала периода выбрана позже даты окончания, поле окончания очищается, а расчёт нагрузки ждёт корректный период.
@@ -208,6 +214,19 @@ export const api = {
 
 ---
 
+## Frontend-тесты
+
+Регрессионные проверки frontend используют встроенный `node:test` без сторонних npm-зависимостей (Node.js 18+). Тесты `dashboard-conflicts.test.mjs` покрывают локальные даты `Europe/Moscow` в интервале 00:00–03:00, первые дни месяца, переход года, полную/частичную/не выполненную загрузку и запрет ложного зелёного статуса.
+
+Команды выполняются из каталога `frontend/`:
+
+```bash
+npm test       # unit-тесты дат, загрузки кафедр и UI-состояний
+npm run check  # синтаксис модулей дашборда + unit-тесты
+```
+
+---
+
 ## Аутентификация (Frontend)
 
 ### Страница входа (`/index.html`)