.
This commit is contained in:
Zuev
22
docs/API.md
22
docs/API.md
@@ -894,7 +894,7 @@ API возвращает `409 Conflict`; соседние интервалы и
|
||||
|
||||
| Метод | URL | Назначение |
|
||||
|-------|-----|------------|
|
||||
| `GET` | `/api/edu-office/schedule/quality?semesterId=&versionId=` | Итоговая оценка, метрики и объяснимый список проблем выбранной версии |
|
||||
| `GET` | `/api/edu-office/schedule/quality?semesterId=&versionId=` | Итоговая оценка, метрики и объяснимый список проблемных правил выбранной версии |
|
||||
| `GET` | `/api/edu-office/schedule/quality/recommendations?semesterId=&versionId=&scheduleRuleSlotId=&lessonDate=` | Проверенные локальные варианты улучшения опубликованного занятия |
|
||||
|
||||
Доступ имеют только `ADMIN` и `EDUCATION_OFFICE`. `versionId` необязателен: без него
|
||||
@@ -921,7 +921,7 @@ override текущей публикации. Для них доступны о
|
||||
"score": 84,
|
||||
"rawPenalty": 17,
|
||||
"lessonCount": 36,
|
||||
"totalProblemCount": 5,
|
||||
"totalProblemCount": 1,
|
||||
"problemsTruncated": false,
|
||||
"metrics": [
|
||||
{
|
||||
@@ -935,11 +935,16 @@ override текущей публикации. Для них доступны о
|
||||
],
|
||||
"problems": [
|
||||
{
|
||||
"id": "GROUP_GAP:2026-09-14:31:18",
|
||||
"id": "RULE:24",
|
||||
"type": "GROUP_GAP",
|
||||
"severity": "MEDIUM",
|
||||
"title": "Окно в расписании группы",
|
||||
"penalty": 2,
|
||||
"title": "Правило «Архитектура систем» снижает качество",
|
||||
"description": "3 занятия этого правила снижают оценку: Окно в расписании группы; Избыточно крупная аудитория",
|
||||
"penalty": 8,
|
||||
"scheduleRuleId": 24,
|
||||
"affectedLessonCount": 3,
|
||||
"problemTypes": ["GROUP_GAP", "ROOM_OVERSIZED"],
|
||||
"issueLabels": ["Окно в расписании группы", "Избыточно крупная аудитория"],
|
||||
"scheduleRuleSlotId": 31,
|
||||
"lessonDate": "2026-09-14",
|
||||
"optimizable": true
|
||||
@@ -949,8 +954,11 @@ override текущей публикации. Для них доступны о
|
||||
```
|
||||
|
||||
`score` находится в диапазоне от 0 до 100 и нормализует сумму объяснимых штрафов
|
||||
относительно числа занятий. Поле `totalProblemCount` содержит полный размер результата,
|
||||
а массив `problems` ограничен 300 элементами; `problemsTruncated` сообщает об усечении.
|
||||
относительно числа занятий. Нарушения сначала рассчитываются для каждого фактического
|
||||
занятия, затем объединяются по `scheduleRuleId`: `penalty` хранит сумму всех штрафов правила,
|
||||
`affectedLessonCount` — число затронутых занятий, `problemTypes` и `issueLabels` — все его
|
||||
категории и объяснения. Поле `totalProblemCount` содержит число проблемных правил, а массив
|
||||
`problems` ограничен 300 элементами; `problemsTruncated` сообщает об усечении.
|
||||
|
||||
Рекомендации подбирают другой эффективный временной слот того же учебного дня либо
|
||||
подходящую активную аудиторию. Занятия, уже закреплённые ручным override, исключаются.
|
||||
|
||||
@@ -435,9 +435,11 @@ constraint. При чтении API разворачивает периоды о
|
||||
Неравномерность дневной нагрузки выводится отдельной диагностической метрикой в процентах
|
||||
и не добавляет скрытого штрафа к итоговой оценке.
|
||||
|
||||
В ответе сохраняются исходный штраф, вклад каждого критерия и конкретные проблемы с
|
||||
датой, занятием и затронутой сущностью. Это делает оценку воспроизводимой и позволяет
|
||||
фильтровать проблемы по типу и серьёзности.
|
||||
Внутренне штраф рассчитывается для каждого фактического занятия, поэтому повторяющиеся
|
||||
пары одного правила увеличивают его вклад в оценку. Перед выдачей нарушения объединяются
|
||||
по правилу: одна карточка содержит суммарный штраф, число затронутых занятий, все типы и
|
||||
краткие причины. Это сохраняет воспроизводимость оценки, но направляет пользователя к
|
||||
изменению базового правила вместо ручного исправления каждой пары.
|
||||
|
||||
Для проблемы опубликованной версии помощник перебирает другие слоты эффективной сетки того же дня и
|
||||
активные аудитории достаточной вместимости. Каждый вариант повторно проходит
|
||||
@@ -445,9 +447,10 @@ constraint. При чтении API разворачивает периоды о
|
||||
показывает улучшения и компромиссы. Занятия с ручным override считаются закреплёнными и не
|
||||
получают рекомендаций. Применение возможно только после подтверждения пользователя через
|
||||
обычный механизм `schedule_overrides`; автоматической публикации и полного solver в MVP
|
||||
нет. Для черновика доступны те же оценка, метрики и объяснимые проблемы, но рекомендации
|
||||
не создаются: пользователь исправляет правила в изолированном конструкторе и повторяет
|
||||
проверку до публикации. Архив анализируется только для чтения.
|
||||
нет. Интерфейс анализа для опубликованной версии и черновика открывает выбранное правило
|
||||
в конструкторе соответствующей версии; черновик остаётся изолированным до публикации.
|
||||
Архив анализируется только для чтения. API локальных рекомендаций сохраняется для
|
||||
совместимости и точечных сценариев, но реестр качества работает на уровне правил.
|
||||
|
||||
## Привязка преподаватель ↔ дисциплина
|
||||
|
||||
|
||||
@@ -76,7 +76,7 @@ frontend/
|
||||
│ │ ├── schedule-view.js # Просмотр расписаний и запуск разовой правки из карточки
|
||||
│ │ ├── schedule-override-panel.js # Боковая панель и реестр разовых изменений
|
||||
│ │ ├── teacher-absences.js # Отсутствия, согласование пожеланий и заявок на изменение
|
||||
│ │ ├── schedule-quality.js # Оценка, фильтры и локальные рекомендации
|
||||
│ │ ├── schedule-quality.js # Оценка, фильтры и переход к редактированию правил
|
||||
│ │ ├── schedule-versions.js # Черновики, публикация, восстановление, diff и аудит
|
||||
│ │ ├── schedule.js # Конструктор правил и подсказки пожеланий преподавателей
|
||||
│ │ ├── academic-calendar-grid.js # Расчёт ISO-недели дневной сетки
|
||||
@@ -182,7 +182,7 @@ frontend/
|
||||
| `teacher-absences` | Запросы преподавателей: отсутствия и мастер замены, согласование семестровых пожеланий, заявки на перенос, аудиторию или отмену | `/api/teacher-absences`, `/api/teacher-preferences`, `/api/teacher-change-requests`, `/api/users/teachers` |
|
||||
| `schedule` | Конструктор правил: по умолчанию редактирует опубликованное расписание, позволяет переключиться на черновик или создать его из выбранной версии; содержит подсказки пожеланий и визуальную матрицу групп | `/api/admin/schedule-rules`, `/api/edu-office/schedule/versions`, `/api/teacher-preferences`, `/api/admin/time-slots`, `/api/admin/calendar/years`, `/api/lesson-types`, `/api/subgroups` |
|
||||
| `schedule-versions` | Контур публикации: текущая версия, черновики, diff, архив, восстановление и журнал | `/api/edu-office/schedule/versions` |
|
||||
| `schedule-quality` | Диагностика выбранной версии семестра: оценка, метрики, фильтруемые проблемы; для публикации — подтверждаемое локальное улучшение | `/api/edu-office/schedule/quality`, `/api/edu-office/schedule/quality/recommendations`, `/api/edu-office/schedule/overrides` |
|
||||
| `schedule-quality` | Диагностика выбранной версии семестра: оценка, метрики и проблемные правила с переходом к их редактированию | `/api/edu-office/schedule/quality`, `/api/admin/schedule-rules` |
|
||||
| `academic-calendar` | Учебные годы, семестры, создание календарных графиков, Excel-подобный редактор дневной сетки и привязка дисциплин к семестрам графика | `/api/admin/calendar`, `/api/admin/academic-calendars`, `/api/admin/academic-calendars/{id}/subjects`, `/api/admin/calendar/activity-types`, `/api/specialties`, `/api/specialties/{id}/profiles`, `/api/education-forms`, `/api/subjects` |
|
||||
| `auditorium-workload` | Динамическая загруженность аудиторий, преподавателей и кафедр: сводная матрица по дате или совмещённая таблица выбранной сущности по чётной/нечётной неделе | `/api/classrooms`, `/api/users/teachers`, `/api/departments`, `/api/admin/time-slots`, `/api/equipments`, `/api/groups`, `/api/schedule`, `/api/admin/calendar/years` |
|
||||
|
||||
@@ -208,14 +208,13 @@ frontend/
|
||||
действий. Каждая карточка показывает исходное и запрошенное состояние, результат
|
||||
предварительной проверки и хронологию решения.
|
||||
- Вкладка `schedule-quality` доступна администратору и учебному отделу. После выбора
|
||||
семестра и версии она выводит круговую оценку от 0 до 100, карточки метрик и реестр проблем с
|
||||
фильтрами по серьёзности и типу. Для проблемы, связанной с конкретным незакреплённым
|
||||
занятием опубликованной версии, кнопка `Подобрать улучшение` запрашивает проверенные варианты времени и
|
||||
аудитории. Карточка кандидата показывает изменение оценки, улучшения и компромиссы;
|
||||
override создаётся только после явного подтверждения, затем анализ запускается заново.
|
||||
Для `DRAFT` экран рассчитывает те же метрики и проблемы напрямую по правилам черновика,
|
||||
но направляет пользователя в конструктор и не создаёт override. `ARCHIVED` анализируется
|
||||
только для чтения. Экран не предлагает автоматически менять занятия, уже отредактированные вручную.
|
||||
семестра и версии она выводит круговую оценку от 0 до 100, карточки метрик и реестр правил
|
||||
с фильтрами по серьёзности и типу. Все проблемные занятия одного правила показаны одной
|
||||
карточкой; в ней выводятся число затронутых занятий, категории и суммарный штраф. Кнопка
|
||||
`Изменить правило` открывает выбранную версию в конструкторе и сразу заполняет форму этим
|
||||
правилом. Сценарий одинаков для `PUBLISHED` и `DRAFT`; `ARCHIVED` анализируется только для
|
||||
чтения. Переход между вкладками передаёт ID версии и правила через одноразовые ключи
|
||||
`magistr.schedule.openVersionId` и `magistr.schedule.openRuleId` в `localStorage`.
|
||||
- Вкладка `schedule-versions` доступна администратору и учебному отделу и оформлена как
|
||||
отдельный контур публикации. Верхняя карточка показывает версию, которую видят конечные
|
||||
пользователи; ниже расположены черновики, сравнение правил и занятий, архив и журнал.
|
||||
|
||||
Reference in New Issue
Block a user