---
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.
