исправление хранения календаря

docs/ACADEMIC_CALENDAR.md

@@ -2,7 +2,7 @@
 
 ## Назначение
 
-Календарный учебный график хранит правила учебного года в той же логике, что и исходные Excel-таблицы: для каждого курса и каждой даты указывается код активности. Динамическое расписание использует этот график как фильтр: обычные пары выводятся только в дни теоретического обучения.
+Календарный учебный график представляет правила учебного года в той же логике, что и исходные Excel-таблицы: для каждого курса и каждой даты указывается код активности. В базе последовательные даты с одинаковой активностью хранятся одним периодом. Динамическое расписание использует график как фильтр: обычные пары выводятся только в дни теоретического обучения.
 
 График нужен, чтобы разные образовательные программы могли иметь разные периоды теории, экзаменов, практики, каникул и нерабочих дней. Несколько групп могут использовать один и тот же график, если они учатся по одной календарной модели.
 
@@ -18,7 +18,7 @@
 - `specialty_profiles` хранит профили внутри специальности. У одной специальности может быть несколько профилей.
 - `academic_calendars` хранит график профиля, формы обучения и учебного года.
 - Форма обучения графика берётся из общего справочника `education_forms`; отдельной таблицы форм для календаря нет.
-- `academic_calendar_days` хранит дневную сетку графика по курсу и дате.
+- `academic_calendar_periods` хранит непересекающиеся периоды активности по курсу с включительными границами дат.
 - `academic_calendar_subjects` хранит дисциплины графика по номерам учебных семестров; дисциплины выбираются из справочника `subjects`.
 - `student_groups` связана со специальностью, профилем и той же таблицей форм обучения.
 - `student_group_calendar_assignments` назначает группе конкретный график на учебный год.
@@ -52,7 +52,7 @@
 1. Определяется учебный год и семестр даты.
 2. Для группы находится назначение графика на этот учебный год.
 3. По году начала обучения группы вычисляется текущий курс.
-4. В `academic_calendar_days` ищется ячейка для курса и даты.
+4. В `academic_calendar_periods` ищется период курса, содержащий дату.
 5. Если код ячейки разрешает обычные пары, применяются правила `schedule_rules`.
 6. Если код не разрешает пары, день пропускается и академические часы не списываются.
 
@@ -74,6 +74,8 @@
 
 - Старый отдельный механизм праздников не используется: праздник хранится кодом `*` в дневной сетке.
 - Дни вне учебного года или пустые периоды Excel хранятся кодом `=`.
+- Дневной REST-контракт сохранён: при чтении backend разворачивает периоды в ячейки, а при полной замене объединяет соседние даты с одинаковой активностью в одну строку `academic_calendar_periods`.
+- Отсутствие периода для даты означает отсутствие разрешённой активности; периоды одного курса и графика не могут пересекаться.
 - График привязан к профилю обучения, а не только к коду специальности.
 - Форма обучения графика должна совпадать с формой обучения группы при назначении графика.
 - Название группы не является уникальным ключом; идентичные названия допустимы, если различаются другие параметры.