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,45 @@
+# Фаза 27. Версия сейва и взгляд внутрь
+
+## Зависимости
+
+- [Фаза 2](../01-shell/02-school-worker.md) — сейв и дев-поверхность уже есть
+
+## Зачем
+
+Две дыры в обслуживании. Первая: `Format` в сейве штампуется при записи и копируется при чтении,
+но никогда не сравнивается — файл из будущей версии загрузится молча и будет понят неправильно, а
+места для миграции просто нет. Вторая: посмотреть внутрь живой школы нечем. Всё ревью замеры
+делались временными тестами, потому что другого способа узнать, кто где и с какими нуждами, не
+существует.
+
+## Задачи
+
+- [x] Загрузка читает `Format`: новее своего — школу не стартовать, файл не трогать, в лог. Как с
+      пропавшей папкой мода
+- [x] Формат старее своего — явный шов для апгрейда: сегодня пустой, но названный и с комментарием
+- [x] `GET /api/dev/schools/{id}/dump` — ростер, присутствие, расписание и нужды одним JSON. За тем
+      же переключателем, что и `reload-schools`, и никогда в проде по умолчанию
+- [x] Дамп читает опубликованные снимки и мейлбокс, а не лезет в `World` мимо работника
+- [x] Раздел «Things that will bite you» в `AGENTS.md` пополняется тем, что нашло ревью: сид школы
+      был её id; тесты хоста делят один сервер и одну папку сейвов, поэтому начинают с очистки;
+      на паузе кадры присутствия не приходят вовсе
+- [x] Классы тестов вокруг Arch перестают идти параллельно: `HSchool.Simulation.Tests` получает
+      запрет параллельности, потому что нативная память Arch этого не любит
+- [x] `docs/protocol.md` описывает дамп в разделе дев-ручек
+
+## Тесты, без которых фаза не закрыта
+
+- [x] Сейв с `format` больше текущего оставляет школу незапущенной и файл нетронутым
+- [x] Сейв текущего формата грузится как раньше
+- [x] Дамп отдаёт людей, их узлы и текущее расписание для живой школы
+- [x] Дамп неизвестной школы — `404`
+
+## Критерий готовности
+
+- Подсунуть сейв из будущего — сервер стартует, эта школа не поднимается, в логе понятно почему
+- Снять дамп с идущей школы и увидеть, кто где стоит
+- `dotnet test` проходит; полный прогон решения стабилен
+
+## Стоп
+
+Не писать миграции, которых пока не нужно. Не открывать дев-ручки без переключателя.