Remove off-queue.md and add new design documentation files including README.md, defs.md, near-term.md, projects.md, runtime.md, people.md, staffing.md, and schedule.md to outline the structure and agreements for the game's design phases.

2026-08-20 12:26:13 +03:00
parent 12cc36b4dd
commit a37a5eb82d
101 changed files with 1015 additions and 921 deletions
@@ -0,0 +1,432 @@
+# Одежда, вещи и климат
+
+Договорённость на следующий срез, не текущий код.
+Люди: [`people.md`](../02-people/people.md). Типы и карта: [`defs.md`](../01-shell/defs.md). Жизнь школы: [`ai.md`](../05-ai/ai.md).
+Экран: [`near-term.md`](../01-shell/near-term.md). Проекты: [`projects.md`](../01-shell/projects.md).
+
+У человека появляется то, что на нём надето и что он несёт. Школа получает климат и правила
+одежды. Игрок это **смотрит** и выбирает правила; надевает не он — система сама приводит гардероб
+к уместности, сезону и погоде.
+
+Срез отвечает на вопросы «во что одеты», «что в сумке», «какая на улице погода» и «что человек
+делал сегодня». Магазинов, стирки, краж и выдачи со склада нет.
+
+## Что меняется в уже принятом
+
+| Было | Стало | Почему |
+| --- | --- | --- |
+| Create выбирает набор имён | Create выбирает **страну**; набор имён вложен в неё | Климат, имена и вкус к одежде — одна культура, а не три пикера |
+| `ThingDef` — мебель на карте | Тот же вид def, поля отличают размещаемое / носимое / переносимое | Стул и футболка — предметы, но живут в разных местах |
+| Карточка — один свиток | Вкладки: обзор, одежда, ноша, сейчас + история | Гардероб в узкую колонку списком навыков не влезает |
+| «Управление» — деньги и штат | Плюс вкладка **«Правила»** | Дресс-код — единственное действие игрока в этом срезе |
+| Часы несут дату и паузу | Плюс температура и осадки | Погода должна быть видна, не спрятана в карточке |
+| Одна раздевалка на 12 шкафчиков | Две (м / ж); шкафчик принадлежит ученику | Переодевание на физкультуру и личное хранение — разные вещи |
+
+Старые школы без страны поднимаются: нынешний набор имён отображается на ванильную страну,
+климат — первый пресет этой страны. Файл не переписывается молча в новый вид, пока школа не
+сохранится сама.
+
+## Страна
+
+Новый вид def — `CountryDef`. Это то, что игрок выбирает при создании школы.
+
+В стране лежит всё, что раньше было «набором имён», плюс ссылки на климатические пресеты:
+
+```jsonc
+{
+  "defName": "Russia",
+  "climatePresets": ["TemperateContinental", "ContinentalCold"],
+  "names": {
+    "patronymicRule": "Slavic",
+    "nativeLanguages": ["Russian", "Belarusian", "Ukrainian"],
+    "relatedLanguageChance": 0.35,
+    // maleGiven, femaleGiven, surnames — как у нынешнего NameSetDef
+  },
+}
+```
+
+Набор имён **перестаёт быть выбираемым видом**. Он не удаляется как форма данных: это вложенный
+объект страны. Мод, который хочет другую страну, кладёт свой `CountryDef` целиком, а не «набор
+имён плюс климат сбоку».
+
+Родной язык по-прежнему выбирается из `names.nativeLanguages`, если их больше одного. Это не
+третий пикер культуры — это язык внутри уже выбранной страны. Не указан — бросает сид школы,
+как сейчас.
+
+Климатический пресет школа получает **случайный из списка страны**, от того же сида, и
+записывает у себя. Повтор create с тем же сидом даёт ту же погоду. Сменить пресет у живой школы
+нельзя: это часть рождения, как набор имён раньше.
+
+В `core` одна страна — `Russia`: нынешний славянский набор вложен в неё, пресеты — умеренно-
+континентальные. Другие страны приходят модами.
+
+Форма создания говорит «Страна», не «Набор имён». `GET /api/catalog` отдаёт `countries` вместо
+`nameSets`. `POST /api/schools` принимает `countryId`; неизвестная страна — `400` `unknown-country`.
+Старое поле `nameSetId` не принимается.
+
+## Климат и погода
+
+Погода — не картинка и не текст. На школе живёт состояние: **уличная температура** и **осадки**
+(нет / дождь / снег). Его видно у часов, и от него одеваются. Дождь и снег ещё добавляют минуты
+к запасу на дорогу (`BehaviorDef.commuteRainMinutes` / `commuteSnowMinutes`): план дня получает
+уже число, симуляция считает его с улицы. Ходьбу по коридору это не режет.
+
+Числа живут в `ClimatePresetDef`, не в коде. Страна только ссылается на id. Мод меняет зиму,
+не трогая имена.
+
+Пресет описывает:
+
+- ход температуры по году (месячные нормы);
+- как температура гуляет внутри дня и от нормы (разброс);
+- когда и какие осадки — с поправкой на температуру: ниже нуля тот же бросок даёт снег, выше —
+  дождь.
+
+Погода пересчитывается не каждый тик, а когда это меняет одежду или надпись у часов: сдвиг на
+несколько десятых градуса, смена осадков. Детерминизм: пресет + сид школы + календарная дата и
+час. Тот же сид, тот же день — та же улица.
+
+**В здании теплее, чем на улице**, даже без сотрудника: стены держат. Но комфорт — работа
+техника. Без него зимой в кабинетах прохладно, летом душно; с ним держится жилая полоса.
+Двор, крыльцо и переход между корпусами — улица.
+
+Пропуск пустого времени погоду не «перепрыгивает молча»: к утру рабочего дня состояние считается
+из даты, как годовой набор уже считается через каникулы.
+
+## Тепло как нужда
+
+Новая нужда — **тепло** (`Warmth`). Шкала как у остальных: 0–1, полоска на карточке.
+
+Она падает, когда одежда не соответствует **температуре места**, где человек сейчас: на морозе
+без куртки, в жару в шубе. В комфортной полосе почти не падает. Дома (вне школы) восстанавливается
+за кадром, как сон.
+
+Две черты, несовместимые друг с другом:
+
+- **теплолюбивый** — комфортная полоса сдвинута вверх, на жару реагирует спокойнее, на холод —
+  раньше;
+- **холодолюбивый** — наоборот.
+
+Сдвиг — поле на `TraitDef` (смещение комфортной температуры), не список фамилий в коде. Мод
+добавляет «мерзлявый» тем же полем.
+
+Голодный учится хуже уже сейчас. Замёрзший — тоже: та же `NeedFactor`, что у голода. Нужда
+видна, двигает переодевание и режет рост навыка на уроке. Оценок как журнала нет.
+
+## Один ThingDef, три роли
+
+Мебель, одежда и портфель — один вид. Различают поля, а не отдельные классы. Стул без слоёв
+по-прежнему ставится на карту; футболка со слоями на карту не ставится.
+
+| Поле | Зачем |
+| --- | --- |
+| `layers` | Какие слои занимает. Пусто — не одежда |
+| `portable` | Можно нести в сумке / шкафчике / дома |
+| `mass` | Килограммы; ноша складывается |
+| `insulation` | Насколько греет (и преет в жару) |
+| `formality` | Формальность, 0–100 |
+| `age` | Допустимый возраст |
+| `sex` | `male` / `female` / нет поля = любой |
+| `colors` | Какие `ColorDef` допустимы на этом def |
+| `skirtLength` | Длина низа; для «короткой» формы |
+| `pe` | Форма для физкультуры |
+| `subject` | Только у дефа учебника: какой предмет |
+
+Учебник — **один** `ThingDef`, экземпляр несёт id предмета. Не двенадцать дефов «учебник математики».
+
+Цвет — поле **экземпляра**, не отдельный def вещи. «Синяя футболка» и «красная футболка» — один
+`TShirt` с разным `color`.
+
+`ColorDef` — свой вид: id, теги уместности (`neutral`, `bright`, `school`). Правила школы
+фильтруют теги, а не имена цветов. Мод добавляет «бордовый» файлом, не пересборкой.
+
+Новые слои — пересборка: слои как роли, код их знает. Подписи — в локалях.
+
+### Слои
+
+Код знает десять, в `core` все используются:
+
+| Слой | Что надевают |
+| --- | --- |
+| `Underwear` | трусы |
+| `UpperUnderwear` | бюстгальтер (поверх трусов, под верх) |
+| `Socks` | носки |
+| `Bottom` | юбка, штаны, джинсы, брюки |
+| `Top` | футболка, рубашка |
+| `OverTop` | свитер, жилет |
+| `Outer` | куртка, пальто, шуба |
+| `Shoes` | обувь |
+| `Head` | шапка, кепка |
+| `Accessory` | ремень, шарф, значок |
+
+Платье — **один предмет на несколько слоёв**: `layers: ["Bottom", "Top"]`. Пиджак, если его можно
+снять отдельно от брюк, — отдельная вещь на `OverTop` или `Outer`, не «костюм-монолит».
+
+На одном слое — не больше одной вещи. Надеть свитер поверх рубашки можно: это разные слои.
+Надеть две футболки нельзя.
+
+### Ванильный набор
+
+Не витрина моды, а достаточный гардероб, чтобы генератор и правила было чем кормить:
+
+- бельё: абстрактный `Underwear`, от него трусы / боксеры / трусики и бюстгальтеры (`UpperUnderwear`);
+- носки нескольких цветов;
+- низы: юбка (женская), штаны, джинсы, брюки — длины обычная и короткая;
+- верх: футболка, рубашка;
+- поверх: свитер;
+- верхняя: куртка, пальто, шуба;
+- обувь: повседневная и зимняя;
+- голова: шапка;
+- аксессуары: ремень, шарф;
+- платье (два слоя);
+- форма физкультуры (верх + низ, `pe: true`);
+- ноша: портфель, учебник (один def), телефон, бутылка.
+
+Цвета палитры: белый, чёрный, серый, синий, голубой, красный, зелёный, бежевый. Красный и
+зелёный — `bright`; белый, чёрный, серый, синий — `school` и `neutral`.
+
+## Где лежит вещь
+
+У экземпляра одно место из четырёх:
+
+| Место | Что это |
+| --- | --- |
+| **Надето** | занимает слои |
+| **Сумка** | с собой, давит на ношу |
+| **Шкафчик** | в школе, не несёт |
+| **Дом** | не локация, а состояние «не в школе» |
+
+Домашнего узла на карте нет и не будет. «Дом» — событие и подпись текущего дела, как «вне школы»
+уже есть у присутствия.
+
+**Шкафчик — слот на карте, привязанный к ученику.** Число шкафчиков в раздевалке = число слотов.
+Раздача: ученики этого пола, старшие параллели раньше, при равенстве — стабильный id. Не хватило —
+не досталось: запас только в сумке и дома. Сотрудники шкафчик ученика не получают.
+
+Сменить одежду в школе можно и без шкафчика: снятое уходит в сумку. Шкафчик — чтобы не таскать
+форму для физкультуры весь день.
+
+Две раздевалки на ванильной карте — два узла, мужская и женская, у спортзала. Def разный, чтобы
+ИИ шёл в свою. В редакторе шкафчики по-прежнему число в слоте: поставили 40 — сорок учеников
+этого пола получат место.
+
+## Генератор одевает
+
+Люди больше не рождаются голыми. Генератор, тем же семейным сидом, собирает гардероб:
+
+- повседневное и уместное полу, возрасту и дефолтным правилам школы;
+- сезонную верхнюю одежду;
+- форму для физкультуры ученикам, у кого в сетке есть этот предмет;
+- учебники **по одному на каждый предмет параллели** (не все книги каталога);
+- портфель, телефон и бутылку — с шансом и возрастом (первокласснику телефон не обязателен).
+
+Родители одеты: на них есть планы появиться в школе, и раздетой карточки быть не должно.
+Соискатели — тоже полные люди, значит тоже одеты.
+
+Цвет бросается из допустимых у def с учётом правил школы. Красную рубашку в школу с политикой
+«без яркого» генератор не выдаст на тело; в домашнем запасе яркое может лежать.
+
+Детерминизм тот же: страна + пресет + сид + карта + язык = те же люди в той же одежде. Золотой
+отпечаток ростера обновляется в той фазе, которая начинает одевать.
+
+## Ноша
+
+Новый навык `Hauling` («Переноска»), `always`, как сила. Предел массы:
+
+**предел = f(Strength, Endurance, Hauling)** — точная формула в `BehaviorDef` или соседнем
+дефе правил, не константа в коде.
+
+На карточке — два числа: несёшь / можешь. Перегруз **не** замедляет ходьбу в этом срезе. Вещи
+сверх предела генератор не выдаёт в сумку: лишнее остаётся дома или в шкафчике.
+
+В сумке в учебный день: портфель, учебники **сегодняшних** уроков, телефон, бутылка, то, чему
+не хватило шкафчика. Остальные учебники — в шкафчике или дома. Иначе одиннадцатиклассник с
+двенадцатью учебниками всегда перегружен, и шкала лжёт.
+
+## Износ
+
+У экземпляра одежды прочность 0–1. Пока вещь **на теле в школе**, она чуть падает со временем.
+Ходьбу отдельно не считаем. Сумка и шкафчик не изнашиваются.
+
+На карточке — полоска и подпись по порогам из данных (`целая`, `поношенная`, `порванная`,
+`висит лохмотьями`). Пороги — def, не `if` в UI.
+
+Из дома в одежде ниже порога **не выходят**. Утром вне школы срабатывает событие: ветхая вещь
+заменяется свежей того же def и цвета (или ближайшего уместного). Это видно в истории («получил
+новую рубашку»), не как поход по узлам карты.
+
+Пропуск ночи это событие обязан применить: иначе после «пропустить» школа выходит в лохмотьях.
+
+## Уместность
+
+Не запрет «юбку надеть нельзя», а оценка. Надеть можно; система сама так не оденет, а если
+ситуация сменилась — переоденет.
+
+Оси, все из данных на вещи, цвете и правилах школы:
+
+- пол и возраст;
+- сезон и текущая погода (утепление vs улица);
+- урок: на физкультуре нужна `pe`-форма;
+- формальность вещи vs дресс-код;
+- цвет vs цветовая политика;
+- длина низа vs «короткая» форма.
+
+«Короткая» форма — про **длину юбки** (и летний короткий рукав), не про «можно без формы».
+Малышам короткое неуместно: даже если школа выбрала «короткую», младшие параллели ходят в
+обычной. Порог возраста — поле на правиле, не магическая семёрка в коде.
+
+Цветовая политика **отдельно от строгости**. Строгая форма всё ещё может быть «без яркого» или
+«белый верх, чёрный низ». У учителей свой комплект правил: ученику белая рубашка, директору —
+не обязательно.
+
+Смена правил в «Управлении» вступает в силу **со следующего рабочего дня**. Сегодняшняя одежда
+не вспыхивает в раздевалках посреди урока. На карточке правил видно: «с завтра».
+
+## Переодевание
+
+Дома — мгновенно, событием, в момент ухода/прихода.
+
+В школе — **действие**: дойти до своей раздевалки и сменить. Снятое — в шкафчик, если он есть,
+иначе в сумку. Надетое — из шкафчика или сумки.
+
+Типичные поводы, все через уже существующий выбор цели:
+
+- утром пришёл не по погоде (вчера было тепло, ночью ударил мороз) — переодеть верх;
+- сейчас физкультура — форма `pe`, после урока — обратно;
+- с завтра действует новый дресс-код — утром уже в нём (домашнее мгновенное + проверка при входе).
+
+Действие занимает раздевалку как комнату, не чужой шкафчик. Вместимость переодевания — сколько
+человек одновременно могут здесь действовать; это не путать с числом личных шкафчиков.
+
+## Техник
+
+Новая должность и комната: **техник** (`Technician`) в теплоузле / кабинете техника. Комната
+открывает должность, как медкабинет — медсестру. Игрок нанимает из пула.
+
+Пока техник не нанят, здание держит тепло по-плохому: зимой зябко, летом душно. Нанятый сдвигает
+внутреннюю температуру в комфортную полосу. Числа — в дефе правил климата, не в `if (month)`.
+
+Ванильная карта получает эту комнату в основном корпусе. Без неё должность не рождается, и
+нанять некого.
+
+## Что видит игрок
+
+### Часы
+
+Рядом с датой: температура улицы и осадки. Клиент не считает погоду из месяца — только рисует
+кадр. Кадр часов растёт, версия протокола поднимается.
+
+### Карточка человека — вкладки
+
+Не отдельный экран и не вкладка оболочки. То же окно подробностей справа, внутри него вкладки:
+
+1. **Обзор** — то, что есть сейчас: тело, навыки, черты, нужды (включая тепло), семья,
+   расписание.
+2. **Одежда** — слои, надетое, цвет, прочность с полоской и подписью, уместность к текущей
+   ситуации (коротко: «к уроку», «холодно», «не по форме»).
+3. **Ноша** — сумка, масса несёшь/можешь, шкафчик если есть, домашнее не тащить сюда списком
+   из пятидесяти строк: дом — кратко «ещё N вещей дома».
+4. **Сейчас** — текущее дело на территории школы (`ест`, `идёт`, `учится (математика)`,
+   `переодевается`). Вне школы — одна подпись «дома», без фальшивого расписания домашней жизни.
+   Ниже — **история за сегодня**: сортировка, поиск, пейджинг.
+
+Игрок с карточки ничего не надевает и не забирает. Чистый просмотр.
+
+История — HTTP, как список людей: `GET .../people/{id}/log`, страница, фильтр. Не сокет и не
+общая лента школы. Хранится на работнике за текущие сутки (граница — шесть утра), к новому дню
+обнуляется. Пропуск ночи не оставляет вчерашний лог.
+
+### Управление — «Правила»
+
+Вкладка рядом с нынешним штатом, не новый верхний режим. Четыре комбобокса:
+
+| Кого | Форма | Цвет |
+| --- | --- | --- |
+| Ученики | обычная / короткая / строгая | свободно / без яркого / белый верх чёрный низ |
+| Сотрудники | обычная / короткая / строгая | свободно / без яркого / белый верх чёрный низ |
+
+«Применить» меняет **завтрашнее** правило. Сегодняшний день доигрывается как был.
+
+## Поток данных
+
+Инвентарь лежит **на человеке** в `people.json`. Он меняется чаще состава (переодевание, износ),
+но реже нужд: писать файл на каждом тике нельзя, писать при смене состава — мало. Шов тот же, что
+у найма: запись, когда гардероб изменился содержательно (утро, переодевание, выдача новой вещи),
+не каждый кадр.
+
+Карточка по-прежнему через мейлбокс: нужды и текущее действие живые, одежда едет тем же ответом.
+Список людей одежду не несёт.
+
+История — отдельный GET, чтобы карточку не раздувать сотней строк.
+
+Погода — в кадре часов. Открытая школа, 20 Гц, потеря старого кадра допустима: как с датой.
+
+## Где живёт код
+
+Нового проекта нет.
+
+| Что | Куда |
+| --- | --- |
+| `CountryDef`, `ClimatePresetDef`, `ColorDef`, поля `ThingDef`, слои | `HSchool.Content` |
+| Генерация гардероба, раздача шкафчиков, учебники параллели | `HSchool.People` |
+| Погода от пресета и даты, износ, утренняя замена | `HSchool.Simulation` |
+| Действие «переодеться», цель «одеться по погоде / к физкультуре» | `HSchool.Ai` |
+| Кадр часов, карточка, лог, правила, create | `HSchool.Server` + клиент |
+| Раскладка часов | `HSchool.Protocol` + `protocol.ts` + `docs/protocol.md` |
+
+## Советы, которые стоит принять сразу
+
+- Не заводить `ApparelDef`. Поля на `ThingDef` дешевле, чем два загрузчика и вечный вопрос
+  «а рюкзак — это что».
+- Не делать цвет отдельным def вещи. Экземпляр + палитра.
+- Не ставить домашний узел на карту. Тридцать тысяч «комнат» семей не окупить.
+- Не раздавать шкафчик каждому на ванильной карте. Нехватка — правило, не баг.
+- Не вешать перегруз на ходьбу, пока не измерен. Число на карточке сначала.
+- Не возвращать общую ленту событий школы. История — у человека, за сегодня.
+
+## Заведомо не сейчас
+
+- Магазины, деньги за одежду, стирка, кража, выдача со склада игроком.
+- Игрок одевает человека с карточки.
+- Болезни от промокания, прогул «не в форме» как оценка. Штраф к уроку от холода — фаза 51.
+- Смена страны или климатического пресета у живой школы.
+- Почасовая анимация погоды, ветер, грязь, зонты как система.
+- Шкафчики сотрудников, раздевалки в каждом корпусе сверх двух ванильных.
+- История старше суток и школьная лента на весь экран.
+- Портреты и спрайты одежды. Слои — текст и цвет, не картинка.
+
+## Зафиксировано этим разговором
+
+| Тема | Решение |
+| --- | --- |
+| Вид def | Один `ThingDef`; одежда и ноша — поля |
+| Цвет | Поле экземпляра; `ColorDef` с тегами уместности |
+| Костюм / платье | Один предмет на несколько слоёв; снимаемый пиджак — отдельная вещь |
+| Слои | Бельё, носки, низ, верх, поверх, верхняя, обувь, голова, аксессуар |
+| Уместность | Пол, возраст, сезон/погода, урок (физкультура), формальность, дресс-код, цвет |
+| Запрет vs оценка | Оценка; система сама не наденет неуместное |
+| Короткая форма | Длина юбки и летний рукав; малышам неуместно — ходят в обычной |
+| Цвет vs строгость | Два независимых правила; своё у учеников и у сотрудников |
+| Ноша | Навык `Hauling` + сила + выносливость; на карточке число, ходьбу не трогает |
+| Учебники | Один def, экземпляр на предмет параллели; в сумке — сегодняшние |
+| Прочее в сумке | Портфель, телефон, бутылка |
+| Генератор | Одевает всех, включая родителей и соискателей |
+| Переодевание дома | Мгновенно, событием |
+| Переодевание в школе | Действие в своей раздевалке |
+| Дом | Не узел карты; текущее дело «дома» |
+| Шкафчик | Слот карты, один ученик; старшие раньше; не хватило — не досталось |
+| Раздевалки | Два узла, м/ж; шкафчики добавляются числом в редакторе |
+| Износ | Падает на теле в школе; полоска + подписи; из дома в ветхом не выходят |
+| Замена одежды | Утром дома событием |
+| Страна | `CountryDef`: вложенные имена + ссылки на пресеты климата |
+| Create | Пикер страны вместо набора имён; язык — если у страны их несколько |
+| Климат | Пресет выбирается сидом из списка страны, на живой школе не меняется |
+| Погода | Температура и осадки; у часов; одежда; минуты на дорогу |
+| В здании | Теплее улицы всегда; комфорт — если нанят техник |
+| Техник | Комната + должность; холод летом и тепло зимой |
+| Нужда | `Warmth`; черты теплолюбивый / холодолюбивый |
+| Правила | Вкладка в «Управлении»; четыре комбобокса; с завтра |
+| Карточка | Вкладки обзор / одежда / ноша / сейчас+история; чистый просмотр |
+| История | Только этот человек, только сегодня, HTTP, поиск и пейджинг |
+| Инвентарь в сейве | На человеке в `people.json`, писать при содержательной смене |
+| Игрок надевает | Нет |
+| Погода влияет на ИИ | Да: переодеться. Ходьбу не штрафует. Урок — через нужду тепла |