Refactor project structure and enhance AI and simulation components
- Updated project roles to include a new `HSchool.Ai` component, detailing its responsibilities in routing and decision-making. - Revised the `HSchool.Simulation` component to integrate with the new AI functionalities, improving the interaction between simulation and AI. - Expanded documentation to reflect the changes in project roles and the introduction of AI features. - Added tests for the new AI functionalities, ensuring robust pathfinding and decision-making capabilities. - Updated phase documentation to outline the new stages of school life, focusing on presence and behavior.
This commit is contained in:
Leonid Pershin
@@ -0,0 +1,79 @@
|
||||
# Фаза 18. Присутствие и ходьба
|
||||
|
||||
## Зависимости
|
||||
|
||||
- [Фаза 16](16-timetable-in-school.md)
|
||||
|
||||
## Зачем
|
||||
|
||||
Человек перестаёт быть записью в расписании и получает **место**. Он приходит утром, идёт
|
||||
коридором в кабинет и уходит после последнего урока. Экрана ещё нет — всё проверяется тестами
|
||||
и логом.
|
||||
|
||||
## Задачи
|
||||
|
||||
- [ ] Новый проект `HSchool.Ai` рядом с `People` и `Schedule`: зависит на `Content`, `People` и
|
||||
`Schedule`, без Arch и ASP.NET. Рядом — `tests/HSchool.Ai.Tests`
|
||||
- [ ] `travelMinutes` на `RoomDef` и `TerritoryDef`; в `core` проставлены кабинет 0.5, коридор
|
||||
1.5, лестница 1.5, вестибюль 1, двор 3
|
||||
- [ ] Маршрутизация по `MapLayout.Links` — в библиотеке: матрица следующих шагов считается
|
||||
**один раз** при загрузке школы, не на каждом шаге
|
||||
- [ ] План дня человека — тоже в библиотеке: во сколько выходить, чтобы успеть, и когда уходить.
|
||||
Часы, компоненты и мир туда не проникают
|
||||
- [ ] Место человека — компонент в `World`: узел, остаток пути, минуты до выхода из узла.
|
||||
Человек всегда в узле; рёбер как состояний нет
|
||||
- [ ] Состояние «вне школы» — не удаление сущности: человек остаётся в списке и в карточке
|
||||
- [ ] Приход и уход: у кого сегодня нет уроков, тот не приходит вовсе. Ученик и учитель — по
|
||||
своим урокам, прочий штат — по дню школы
|
||||
- [ ] Запас на дорогу свой у каждого: путь от двора плюс несколько минут из своего потока
|
||||
случайности, с поправкой на черты
|
||||
- [ ] Обязанность как место назначения: урок — кабинет из расписания, должность — комната из
|
||||
`RoomDef.works`. Выбора действий пока нет
|
||||
- [ ] Движение по тику: остаток минут в узле уменьшается, при нуле человек переходит в следующий
|
||||
узел пути
|
||||
- [ ] Стабильный порядок обхода людей — собственный список, а не порядок сущностей в Arch
|
||||
- [ ] Адаптер в `HSchool.Simulation`: собирает значения из компонентов, зовёт библиотеку,
|
||||
записывает ответ обратно. Горячий путь — движение — границу не пересекает
|
||||
- [ ] Ориентир в `AGENTS.md`, `docs/architecture.md` и `docs/design/projects.md` знает про новый
|
||||
проект
|
||||
- [ ] Место, путь и назначение едут в файл часов; кого в файле нет, тот расставляется по
|
||||
обязанности
|
||||
- [ ] Потолок решений за тик — в `SimulationOptions`, как очередь, а не как отсечка
|
||||
- [ ] Предикат «школа пуста»: в здании и во дворе нет никого
|
||||
- [ ] Рабочее окно дня — от шести утра до последнего звонка по **каркасу дня**, а не по
|
||||
фактическому расписанию
|
||||
- [ ] «Ближайшее шесть утра рабочего дня впереди»: ночь ведёт в то же утро, вечер — в следующее,
|
||||
выходные, праздники и каникулы пропускаются. Поиск ограничен разумным числом дней и
|
||||
честно отвечает «нет такого»
|
||||
- [ ] Прыжок часов туда одним шагом: разрешён только при пустой школе и вне рабочего окна,
|
||||
отрабатывает первое сентября и обновление пула за весь пропуск, после себя пишет сейв
|
||||
|
||||
## Тесты, без которых фаза не закрыта
|
||||
|
||||
- [ ] Путь из кабинета 201 в санузел первого этажа идёт через лестницу и коридор, а не напрямую
|
||||
- [ ] Сумма `travelMinutes` совпадает с временем, за которое человек реально доходит
|
||||
- [ ] В воскресенье и в каникулы школа пуста: все вне школы
|
||||
- [ ] Класс без уроков сегодня не приходит, а его учитель с уроками у другого класса — приходит
|
||||
- [ ] К началу первого урока ученик находится в своём кабинете
|
||||
- [ ] Физкультура после урока в главном корпусе: класс доходит до спортзала, и видно, что
|
||||
перемены на это едва хватает
|
||||
- [ ] Тот же сид и та же карта дают то же расположение людей на тот же момент
|
||||
- [ ] Сохранение и загрузка посреди перемены не телепортируют людей
|
||||
- [ ] Прыжок с субботы попадает в понедельник, 6:00; с трёх ночи вторника — в утро того же
|
||||
вторника; с десяти вечера — в утро среды
|
||||
- [ ] Прыжок в учебное время отклоняется. В семь утра рабочего дня, когда школа ещё пуста, —
|
||||
тоже: это уже рабочее окно
|
||||
- [ ] У школы без единого учителя рабочий день не пропускается
|
||||
- [ ] Прыжок через летние каникулы проводит первое сентября: классы перешли, выпуск состоялся,
|
||||
набор пришёл
|
||||
- [ ] Промотанная неделя и прожитая неделя дают одно состояние школы
|
||||
|
||||
## Критерий готовности
|
||||
|
||||
- `dotnet test` проходит
|
||||
- Маршруты и план дня проверены без мира: в `HSchool.Ai.Tests` нет Arch
|
||||
- В `HSchool.Ai` нет упоминаний Arch, ASP.NET и `DateTime.Now`; в `HSchool.Simulation` — сокетов
|
||||
|
||||
## Стоп
|
||||
|
||||
Не трогать протокол и клиент. Не заводить нужды, действия и выбор — это фазы 20 и 21.
|
||||
@@ -0,0 +1,55 @@
|
||||
# Фаза 19. Присутствие на экране
|
||||
|
||||
## Зависимости
|
||||
|
||||
- [Фаза 18](18-presence-walking.md)
|
||||
- [Фаза 17](17-timetable-screen.md)
|
||||
|
||||
## Зачем
|
||||
|
||||
Школа впервые видна живой: в дереве идут числа, на перемене коридор наполняется, к звонку
|
||||
кабинеты сходятся обратно.
|
||||
|
||||
## Задачи
|
||||
|
||||
- [ ] Новое сообщение присутствия, ~2 раза в секунду, только по открытой школе: узлы со
|
||||
счётчиками и люди с их узлом и состоянием
|
||||
- [ ] Снимок карты становится **статическим**: люди и текущий урок уезжают в присутствие,
|
||||
структура уходит один раз при открытии. Пересылка на смене слота убирается
|
||||
- [ ] `ProtocolCodec.cs`, `protocol.ts` и `docs/protocol.md` правятся тем же коммитом, версия
|
||||
бумпится до 7
|
||||
- [ ] Справочник «id → имя» по HTTP: клиент забирает один раз при открытии школы и перечитывает,
|
||||
увидев незнакомый id. Имена в кадр присутствия не кладутся
|
||||
- [ ] Дерево: число людей рядом с узлом, живое. Пустой узел остаётся без числа
|
||||
- [ ] Панель локации: кто здесь сейчас, списком с именами; урок в комнате берётся из присутствия,
|
||||
а не из снимка
|
||||
- [ ] Карточка человека: где он сейчас — узел, «в пути» или «вне школы»
|
||||
- [ ] Присутствие приходит по всей школе, выбранный узел фильтрует клиент
|
||||
- [ ] Кадр часов несёт разрешение на пропуск; клиент это разрешение **не вычисляет**
|
||||
- [ ] Намерение «пропустить» — своё сообщение, как пауза и скорость. Сервер проверяет условия
|
||||
заново: кадр из браузера не доверенный
|
||||
- [ ] Кнопка рядом с паузой и скоростями: появляется только когда сервер разрешил, подписана
|
||||
датой, к которой перенесёт
|
||||
- [ ] Строки через `t(...)`, обе локали
|
||||
|
||||
## Тесты, без которых фаза не закрыта
|
||||
|
||||
- [ ] Байтовая раскладка присутствия сходится с обеих сторон
|
||||
- [ ] Круговой прогон сообщения: сервер → клиент → те же значения
|
||||
- [ ] Снимок карты больше не содержит людей и урока
|
||||
- [ ] Кадр часов с разрешением на пропуск читается обеими сторонами одинаково
|
||||
- [ ] Пропуск, присланный в учебное время, сервер отбрасывает, а не исполняет
|
||||
|
||||
## Критерий готовности
|
||||
|
||||
- Открыть школу в 8:25 и увидеть, как двор и вестибюль пустеют, а кабинеты наполняются
|
||||
- На перемене коридор — самый людный узел дерева
|
||||
- В каникулы дерево без чисел, а карточки говорят «вне школы»
|
||||
- В пятницу после уроков дождаться, пока школа опустеет, нажать «пропустить» и оказаться в
|
||||
понедельник в 6:00; вечером буднего дня та же кнопка ведёт в завтрашнее утро
|
||||
- `dotnet test`, `npm test` и `npm run build` проходят
|
||||
|
||||
## Стоп
|
||||
|
||||
Не рисовать перемещение анимацией. Не заводить серверный `OpenLocation`. Не добавлять нужды и
|
||||
действия.
|
||||
@@ -0,0 +1,44 @@
|
||||
# Фаза 20. Нужды и действия
|
||||
|
||||
## Зависимости
|
||||
|
||||
- [Фаза 19](19-presence-screen.md)
|
||||
|
||||
## Зачем
|
||||
|
||||
Нужды перестают быть четырьмя неподвижными полосками, а действия — пустым дефом. Появляется то,
|
||||
из чего фаза 21 будет собирать решения.
|
||||
|
||||
## Задачи
|
||||
|
||||
- [ ] `ActionDef` получает поля: комната, вещь, длительность, восполняемая нужда и величина,
|
||||
роли, вес досуга
|
||||
- [ ] Действия в `core`: поесть в столовой, санузел, отдохнуть на перемене, пообщаться,
|
||||
прогуляться по коридору и по двору
|
||||
- [ ] Деф правил поведения — как `StaffingDef` у штата: пороги нужд, скорость обучения на уроке,
|
||||
разброс запаса на дорогу, порог переключения решения
|
||||
- [ ] Декей нужд включается в `core`. Сон восстанавливается вне школы, а не действием
|
||||
- [ ] Действие занимает вещь на время: за один стол не садятся вдвоём
|
||||
- [ ] Выполнение действия: начало, отсчёт минут, восполнение нужды по завершении. Правила — в
|
||||
`HSchool.Ai`, компоненты и мир — в `HSchool.Simulation`
|
||||
- [ ] Валидатор дефов ловит действие без комнаты, с неизвестной нуждой и с неизвестной вещью
|
||||
- [ ] Карточка человека показывает, что он делает; полоски нужд начинают шевелиться
|
||||
|
||||
## Тесты, без которых фаза не закрыта
|
||||
|
||||
- [ ] Голод падает за игровой час ровно на `decayPerHour`
|
||||
- [ ] Обед в столовой поднимает голод на заявленную величину и занимает заявленное время
|
||||
- [ ] Столов меньше, чем желающих: лишние не начинают действие, а не садятся сквозь друг друга
|
||||
- [ ] Ночь вне школы возвращает сон к максимуму
|
||||
- [ ] Действие с неизвестной нуждой роняет загрузку каталога с внятной ошибкой
|
||||
- [ ] Те же входы дают те же значения нужд на тот же момент
|
||||
|
||||
## Критерий готовности
|
||||
|
||||
- `dotnet test` и `npm test` проходят
|
||||
- В карточке за игровой день видно, как нужды опускаются, а после столовой — поднимаются
|
||||
|
||||
## Стоп
|
||||
|
||||
Не подключать выбор действия — люди пока ходят только по обязанности. Не трогать оценки и
|
||||
успеваемость.
|
||||
@@ -0,0 +1,51 @@
|
||||
# Фаза 21. Выбор действия
|
||||
|
||||
## Зависимости
|
||||
|
||||
- [Фаза 20](20-needs-actions.md)
|
||||
|
||||
## Зачем
|
||||
|
||||
Последний кусок среза: обязанность перестаёт быть приказом. Ученик с критической нуждой уходит с
|
||||
урока и возвращается, и это видно в кабинете и в его карточке.
|
||||
|
||||
## Задачи
|
||||
|
||||
- [ ] Цели, веса и планирование — целиком в `HSchool.Ai`: на вход значения, на выход решение.
|
||||
В `HSchool.Simulation` — только сбор входов и запись ответа
|
||||
- [ ] Цели и их вес: обязанность — постоянный высокий, нужда — тем больше, чем ближе к нулю,
|
||||
досуг — низкий и только при отсутствии обязанности
|
||||
- [ ] Побеждает наибольший вес. Уход с урока получается из сравнения, а не из отдельного правила
|
||||
- [ ] Планирование «дойти → сделать»: цель выбирает действие, планировщик достраивает дорогу до
|
||||
подходящей комнаты
|
||||
- [ ] Начатое доводится до конца: переключение только при заметном перевесе новой цели
|
||||
- [ ] Решения по событиям — звонок, конец действия, приход в назначенный узел, пересечение
|
||||
нуждой порога, — а не каждый тик
|
||||
- [ ] Очередь решений с потолком за тик: отложенное принимается следующим тиком, а не пропадает
|
||||
- [ ] Возвращение к обязанности после закрытия нужды, если урок ещё идёт
|
||||
- [ ] Навык растёт на уроке: от предмета, с поправкой на черты и на состояние нужд
|
||||
- [ ] Опоздание и отсутствие видны: в панели локации на уроке не весь класс, в карточке написано,
|
||||
где человек
|
||||
- [ ] Строки через `t(...)`, обе локали
|
||||
|
||||
## Тесты, без которых фаза не закрыта
|
||||
|
||||
- [ ] Ученик с нулевым «туалетом» уходит с урока, доходит до санузла и возвращается в кабинет
|
||||
- [ ] Нужда чуть ниже порога урок не срывает
|
||||
- [ ] Две почти равные нужды не заставляют метаться: действие доводится до конца
|
||||
- [ ] На перемене выбирается досуг, на уроке — нет
|
||||
- [ ] Навык после учебного дня вырос, у голодного — меньше
|
||||
- [ ] Потолок решений за тик не теряет решения, а сдвигает их
|
||||
- [ ] Тот же сид и те же действия игрока дают ту же школу через игровую неделю
|
||||
- [ ] Разбор решения таблицей входов и выходов, без мира и без хоста
|
||||
|
||||
## Критерий готовности
|
||||
|
||||
- Прогнать школу на ×4 через учебный день и увидеть осмысленную картину: уроки, перемены с
|
||||
коридором и столовой, редкие отлучки посреди урока
|
||||
- `dotnet test`, `npm test` и `npm run build` проходят
|
||||
|
||||
## Стоп
|
||||
|
||||
Не добавлять оценки, настроение, конфликты и дружбу. Не давать игроку приказы. Не углублять
|
||||
планировщик до полного GOAP.
|
||||
@@ -68,3 +68,26 @@
|
||||
| [15. Планировщик](15-timetable-planner.md) | ✅ | Раскладка часов по слотам, четыре запрета |
|
||||
| [16. Расписание в школе](16-timetable-in-school.md) | ✅ | Сейв, снимок, «кто где сейчас» |
|
||||
| [17. Расписание на экране](17-timetable-screen.md) | ✅ | Скобки в дереве, сетка класса, расписание учителя |
|
||||
|
||||
## Срез 5. Жизнь школы
|
||||
|
||||
Дизайн: [`../design/ai.md`](../design/ai.md).
|
||||
|
||||
Люди начинают ходить и решать. Присутствие перестаёт вычисляться из расписания и становится
|
||||
состоянием: человек приходит утром, идёт коридором, может уйти с урока в туалет и вернуться.
|
||||
|
||||
Срез идёт **двумя этапами**, и между ними можно остановиться — школа останется целостной.
|
||||
|
||||
**Этап A — присутствие.** Люди ходят по обязанности; выбора у них ещё нет.
|
||||
|
||||
| Фаза | Статус | Зачем |
|
||||
| --- | --- | --- |
|
||||
| [18. Присутствие и ходьба](18-presence-walking.md) | ⬜ | `HSchool.Ai`, место человека, маршруты, приход и уход |
|
||||
| [19. Присутствие на экране](19-presence-screen.md) | ⬜ | Своё сообщение ~2 Гц, числа в дереве, статический снимок карты, пропуск пустого времени |
|
||||
|
||||
**Этап B — поведение.** Появляются нужды, действия и выбор между ними и обязанностью.
|
||||
|
||||
| Фаза | Статус | Зачем |
|
||||
| --- | --- | --- |
|
||||
| [20. Нужды и действия](20-needs-actions.md) | ⬜ | `ActionDef` с полями, декей, восполнение |
|
||||
| [21. Выбор действия](21-decisions.md) | ⬜ | Цели и веса, «дойти → сделать», уход с урока, рост навыка |
|
||||
|
||||
Reference in New Issue
Block a user