[Add] New Tasks

2026-04-08 21:23:40 +07:00
parent 5feafdbcd3
commit a97a3f1fc1
3 changed files with 203 additions and 1 deletions
@@ -0,0 +1,99 @@
+---
+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.