Files
h-school/docs/phases/20-needs-actions.md
T
Leonid Pershin c16c34a83c 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.
2026-08-19 15:57:12 +03:00

3.1 KiB

Фаза 20. Нужды и действия

Зависимости

Зачем

Нужды перестают быть четырьмя неподвижными полосками, а действия — пустым дефом. Появляется то, из чего фаза 21 будет собирать решения.

Задачи

  • ActionDef получает поля: комната, вещь, длительность, восполняемая нужда и величина, роли, вес досуга
  • Действия в core: поесть в столовой, санузел, отдохнуть на перемене, пообщаться, прогуляться по коридору и по двору
  • Деф правил поведения — как StaffingDef у штата: пороги нужд, скорость обучения на уроке, разброс запаса на дорогу, порог переключения решения
  • Декей нужд включается в core. Сон восстанавливается вне школы, а не действием
  • Действие занимает вещь на время: за один стол не садятся вдвоём
  • Выполнение действия: начало, отсчёт минут, восполнение нужды по завершении. Правила — в HSchool.Ai, компоненты и мир — в HSchool.Simulation
  • Валидатор дефов ловит действие без комнаты, с неизвестной нуждой и с неизвестной вещью
  • Карточка человека показывает, что он делает; полоски нужд начинают шевелиться

Тесты, без которых фаза не закрыта

  • Голод падает за игровой час ровно на decayPerHour
  • Обед в столовой поднимает голод на заявленную величину и занимает заявленное время
  • Столов меньше, чем желающих: лишние не начинают действие, а не садятся сквозь друг друга
  • Ночь вне школы возвращает сон к максимуму
  • Действие с неизвестной нуждой роняет загрузку каталога с внятной ошибкой
  • Те же входы дают те же значения нужд на тот же момент

Критерий готовности

  • dotnet test и npm test проходят
  • В карточке за игровой день видно, как нужды опускаются, а после столовой — поднимаются

Стоп

Не подключать выбор действия — люди пока ходят только по обязанности. Не трогать оценки и успеваемость.