TheDeclineOfWarriors/docs/tasks/items/TASK-0025.md

---

id: TASK-0025 title: Описать flow локального теста билда summary: Зафиксировать repeatable flow локального теста билда: как собрать проект, как запускать host/client сценарий и что обязательно проверять перед ручным прогоном. priority: Highest area: build owner: unassigned created: 2026-03-31 updated: 2026-03-31 execution_time: 1d depends_on: [] canonical_docs:

• docs/tasks/Index.md related_files:
• ProjectSettings/
• Assets/Scenes/

---

TASK-0025 - Описать flow локального теста билда

Status

Статус задачи ведется в docs/tasks/Index.md и является каноническим там.

Why

Без зафиксированного локального flow билд-тестов сложно быстро и одинаково проверять игру перед изменениями, особенно когда проект одновременно развивается в networking, voxel worldgen и gameplay.

Expected Outcome

Есть понятный и повторяемый локальный сценарий проверки билда: как собрать проект, как запустить игру, как проверить host/client сценарий и какие smoke-checks обязательны перед ручным завершением теста.

Current Context

Сейчас локальная проверка билда не оформлена как канонический процесс. Из-за этого каждый новый прогон легко делается по-разному и важные регрессии можно пропустить.

Source Of Truth

• ProjectSettings/...
• фактический build pipeline проекта
• актуальные игровые сцены и точка входа в игру

Read First

• README.md
• docs/tasks/Index.md
• ProjectSettings/...
• Assets/Scenes/...

Scope In

• описать локальную сборку проекта для основного target
• зафиксировать host/client сценарий локального прогона
• описать smoke checklist после запуска билда
• указать, какие артефакты или логи нужно смотреть при сбое

Scope Out

• автоматизация CI/CD
• полное end-to-end покрытие всех игровых сценариев

Constraints

• flow должен быть достаточно коротким для частого повторения
• шаги должны быть воспроизводимыми на одной машине разработчика

Suggested Approach

1. Зафиксировать основной build target и точку входа.
2. Описать последовательность сборки и запуска host/client локально.
3. Сформировать короткий smoke checklist.
4. Добавить заметки по типовым ошибкам и логам.

Acceptance Criteria

• есть документированный flow локального теста билда
• есть checklist для host/client smoke test
• новый человек или AI может повторить прогон без уточнений в чате

Verification

• пройти описанный flow вручную
• убедиться, что шаги не зависят от скрытых предположений

Risks / Open Questions

• если build flow сильно зависит от окружения, понадобится отдельно фиксировать prerequisites

Human Decisions Needed

• none currently

Decision Log

• 2026-03-31 - задача добавлена для стандартизации ручной локальной проверки билда.

Handoff Notes

Если в проекте появится отдельный build script или launcher, этот task нужно обновить и сослаться уже на него как на канонический entry point.