100 lines
4.3 KiB
Markdown
100 lines
4.3 KiB
Markdown
---
|
|
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.
|