Leonid Pershin
5a00ad7746
- Updated protocol documentation to include `nativeLanguages` in `nameSets` and added `nativeLanguage` to school creation options. - Enhanced the UI for school creation to allow selection of native languages, improving user experience. - Revised API interfaces to accommodate new native language features, ensuring proper data handling. - Improved localization strings to support new native language functionalities in both English and Russian. - Updated tests to validate the new native language features and ensure robust functionality in staffing scenarios.
12 KiB
Расписание
Договорённость на срез после штата, не текущий код.
Штат и предметы: staffing.md. Люди: people.md.
Типы и карта: defs.md. Экран: near-term.md.
Часы из учебного плана раскладываются по дням и кабинетам. Школа впервые начинает жить по времени: в 10:15 у 5Б математика в кабинете 204, и это видно на карте.
Зачем это раньше ходьбы
Расписание закрывает дыру, которая тянется с первого среза: в панели локации пустуют «Персонажи» и «Сейчас». Заполнить их можно без системы перемещения — если урок стоит в расписании, мы знаем, кто в кабинете и чем занят. Ни поиска пути, ни шагов по коридору: таблица и часы.
Люди по-прежнему не ходят. Они находятся там, где их застало расписание.
Каркас дня
В core, дефом: первый урок в 8:30, до семи уроков, урок 45 минут, перемены по 10 с одной
большой на 20. Одна смена.
Длина недели — в настройках, а не в контенте: пять дней по умолчанию. Это школьное правило, а не свойство мира, и его меняют, чтобы посмотреть, что будет.
Каникулы — дефами: осенние, зимние, весенние и лето, диапазонами дат внутри учебного года. В каникулы расписание не действует, школа стоит.
Учебный план
Уже есть: SubjectDef знает, в каких параллелях преподаётся предмет и сколько часов в неделю.
Расписание ничего не решает про количество — только про расстановку.
Кто его строит
Сервер, сам, детерминированно — из учебного плана, назначений и карты. Игрок не раскладывает пасьянс на одиннадцать классов; он влияет тем, кого нанял и что назначил.
Но игрок может править готовое: передвинуть урок, поменять кабинет.
Отсюда правило, без которого правки будут пропадать: исправленное игроком закрепляется. Перестроение — а оно случается при каждом найме и назначении — сохраняет закреплённые уроки и пересобирает только остальное. Иначе первый же наём стёр бы всю ручную работу.
Снять закрепление игрок может явно; тогда урок снова участвует в общей раскладке.
Правила раскладки
Четыре запрета, нарушать которые нельзя:
- Учитель не в двух местах. Один человек — один урок в слоте.
- Класс не в двух местах. Один класс — один урок в слоте.
- Кабинет не занят дважды. Два класса в одной комнате одновременно невозможны.
- Класс влезает в кабинет. Учеников не больше, чем мест.
Урок идёт не обязательно в своём кабинете. У предмета может быть требование к типу помещения: физкультура — в спортзале, информатика — в компьютерном классе. Без требования урок идёт в кабинете, закреплённом за классом.
Это и делает карту нужной: один спортзал на одиннадцать классов — узкое место, которое видно в расписании, а не в отчёте.
Некому вести — урока нет
Предмет без учителя не ставится вовсе. В расписании класса на этом месте пусто, а в разделе «Управление» предмет числится непокрытым.
Так наём получает прямое последствие: нанял человека, назначил ему предмет — в расписании появились уроки. Это единственная обратная связь среза, и она должна быть мгновенной.
То же самое, если часов больше, чем вытягивают нанятые: лишние часы просто не встают.
Что видит игрок
В дереве карты — что происходит в комнате прямо сейчас, скобками рядом с названием:
Этаж 2
Кабинет 204 (Математика · 5Б)
Кабинет 205 (Физика · 9А)
Кабинет 206
Так классы не сливаются в одинаковые строчки: комната подписана тем, что в ней идёт. Пусто — значит свободна.
В панели локации — «Сейчас» и «Персонажи» наконец не пустуют: урок, класс, учитель.
В «Управлении» — расписание класса: сетка «день × урок» на одну параллель.
В карточке учителя — его личное расписание: где он и когда. Это же карточка, что и в «Людях», так что расписание видно всюду, где человек открывается.
Общей сетки на всю школу нет: одиннадцать классов на шесть дней не читаются с экрана, а нужны они только тому, кто раскладывает вручную, — а раскладывает сервер.
Где это живёт
Планировщик — отдельная библиотека, как HSchool.People: зависит от HSchool.Content, не
знает ни Arch, ни ASP.NET, отдаёт простую таблицу. Причина та же, что и с генератором людей: то,
что строится по детерминированным правилам, проверяется только тестами — «этот штат и эта карта
дают вот такую раскладку», — а тест не должен поднимать хост.
Расписание сохраняется вместе с составом: оно дешевле пересчитывается, чем восстанавливается, но ручные правки восстановить нельзя. Пишется по тем же правилам, что и ростер — при изменении, а не по таймеру.
Советы, которые стоит принять сразу
- Не давать игроку раскладывать всё вручную. Автоматика с правками — это управление; пустая сетка на 66 ячеек — это работа завуча.
- Не пересобирать расписание на каждый тик. Оно меняется от найма и назначения, а не от времени.
- Не хранить «кто где сейчас» отдельным состоянием. Это вычисляется из расписания и часов; вторая копия немедленно разойдётся с первой.
- Не ставить урок, который некому вести. Дыра в расписании честнее, чем урок без учителя.
- Требование к типу помещения — у предмета, а не у комнаты. Комната не знает, что в ней физкультура.
Заведомо не сейчас
- Перемещение по карте: люди находятся в комнате, но не идут в неё.
- Оценки, посещаемость, домашние задания, успеваемость.
- Замены заболевшего учителя.
- Вторая смена, деление класса на подгруппы (языки, труд).
- Четверти, триместры, экзамены.
- Кружки, продлёнка, всё вне уроков.
- Предпочтения учителей: «не ставьте мне первым уроком».
Зафиксировано этим разговором
| Тема | Решение |
|---|---|
| Кто строит | Сервер, детерминированно, из плана и назначений |
| Правки игрока | Можно; исправленное закрепляется и переживает перестроение |
| Каркас дня | core: 8:30, до 7 уроков, 45 минут, перемены 10 и одна 20; одна смена |
| Длина недели | В настройках, пять дней по умолчанию |
| Каникулы | Дефами, диапазонами дат; в каникулы расписания нет |
| Учебный план | Часы из SubjectDef, расписание их только расставляет |
| Запреты | Учитель, класс и кабинет — не более одного урока в слоте; класс влезает в кабинет |
| Место урока | Кабинет класса, если у предмета нет требования к типу помещения |
| Нет учителя | Урок не ставится; предмет числится непокрытым |
| Карта | В дереве рядом с комнатой — что и у кого там сейчас |
| Панель локации | «Сейчас» и «Персонажи» заполняются из расписания — с срезом 5 из присутствия, см. ai.md |
| Расписание класса | В разделе «Управление», сетка «день × урок» |
| Расписание учителя | В его карточке, там же где навыки и семья |
| Общая сетка школы | Не делаем: её читает только тот, кто раскладывает вручную |
| Где живёт код | Отдельная библиотека рядом с HSchool.People |
| Люди и место | Находятся по расписанию; ходьбы нет — отменено срезом 5, присутствие стало состоянием (ai.md) |