# D0: прототип локального тестового мира Этот документ описывает общий запуск редактора и изолированного игрового сервера. Цель D0 — доказать способ доставки готовых компонентов до создания мастера D1. Приёмка на чистой Windows остаётся отдельным условием завершения этапа. ## Контракт прототипа Общий запуск из checkout выполняется через `scripts/start-editor.ps1 -WithRuntime`. Скрипт собирает редактор, подготавливает сервер, проверяет готовность и открывает редактор с подключённой БД. Вариант `scripts/start-editor.ps1` запускает редактор отдельно; в готовом ZIP этот вариант использует поставленный exe без Cargo. Для просмотра мира нужны собственные ресурсы WoW. Каталог и серверные проверки требуют подключения к БД. Серверный кандидат использует готовые образы Docker через WSL2. Прототип создаёт отдельные сеть, контейнеры и БД, использует другие порты на loopback и собственные секреты. Исходники ядра и установленная игра остаются входами только для чтения. Живые аккаунты, персонажи, пароли и БД владельца не копируются. Собственные миграции контента из checkout ядра не входят в исходный снимок мира. Воспроизводимость проверяется по идентификаторам образов, ревизии схемы и хешу исходного снимка. Наличие локального образа с тегом `dev` само по себе не доказывает соответствие текущему исходному коду ядра. Успешный импорт и старт подтверждают проверенную комбинацию, но не создают отсутствующую цепочку происхождения бинарного файла. ## Сравнение вариантов | Вариант | Доступные основания | Что ещё требуется | | --- | --- | --- | | Готовые процессы Windows: vMaNGOS и MariaDB | Предпочтительный кандидат ROADMAP; не требует Linux VM | В этом окружении не найдены готовый Windows сервер и воспроизводимый pipeline его поставки; запуск, зависимости и остановка не проверены | | Готовые Linux образы через WSL2 и Docker | Доступны образы сервера и MariaDB, статический world seed, схемы и производные данные карт | Изолированный импорт, запуск и остановка; затем упаковка входов независимо от checkout, доставка runtime и приёмка на чистой Windows | Для локального экспериментального прогона выбран второй вариант: он позволяет проверить новую БД и мир без сборки сервера. Это пока не окончательный выбор runtime для всех пользователей. WSL2, виртуализация и Docker являются реальными предпосылками этого прототипа. Их установка, права администратора и возможная перезагрузка не проверены на чистой машине и не скрываются за командой запуска. ## Запуск прототипа Из PowerShell в checkout редактора: ```powershell ./scripts/start-editor.ps1 -WithRuntime ./scripts/d0-runtime.ps1 -Action status -Name mw-editor-d0-local ./scripts/d0-runtime.ps1 -Action down -Name mw-editor-d0-local ``` Первая команда собирает редактор, поднимает окружение `mw-editor-d0-local`, ждёт готовности БД, авторизации и мира, затем проверяет все три опубликованных порта из Windows и открывает редактор. Для уже собранного release есть `-NoBuild`, для другого окружения — `-RuntimeName`. После закрытия редактора сервер продолжает работать, остановка выполняется командой `down`. Повторный запуск использует существующую БД и фактические порты сохранённого manifest. Профиль редактора создаётся в `%LOCALAPPDATA%/MoonWell/Editor/d0/<имя окружения>`. Скрипт автоматически записывает адрес изолированной world-базы в `config/settings.json`. Секрет поступает внутри helper из закрытого состояния WSL. Пароль хранится в локальном JSON профиля по текущему формату редактора. Сам профиль и его настройки содержат секреты и предназначены для локального использования. Обычный профиль продолжает обслуживать отдельный запуск редактора. Для своих ресурсов WoW задайте `-WowDataDirectory 'C:/Games/World of Warcraft/Data'`. При первом запуске доступный путь подставляется из обычных настроек; при повторном сохраняется путь отдельного профиля. Стартовое окно позволяет выбрать ресурсы и проект. Для прямого открытия проекта используется `-EditorArguments @('C:/Content/camp.json')`. Явный `-ProfileDirectory` принимает пустой каталог или профиль, созданный этим helper для того же окружения. Унаследованные настройки подключения окружения очищаются на время запуска, затем восстанавливаются. Общий запуск доступен в исходном checkout. В portable ZIP используется отдельный запуск редактора. Для ручного управления сервером остаётся `scripts/d0-runtime.ps1 -Action up`. По умолчанию входы берутся из `/home/sindo/core`, данные — из `deploy/local/data` этого checkout. Для другого расположения есть `-CoreDirectory` и `-DataDirectory`; это абсолютные пути внутри WSL. Требуются WSL, Python 3.11 или новее, работающий Docker с Compose и уже доступные закреплённые образы. Скрипт не скачивает образы и не собирает сервер. Порты по умолчанию: БД `127.0.0.1:13806`, авторизация `127.0.0.1:13724`, мир `127.0.0.1:18085`; для нового окружения есть `-DatabasePort`, `-AuthPort`, `-WorldPort`. Состояние хранится в WSL: `~/.local/share/moonwell-editor/d0/<имя>`, либо в явно выбранном `-StateDirectory`. Каталог закрыт от других пользователей Linux, секреты генерируются заново и не печатаются. Здесь находятся `manifest.json`, снимок схем/миграций и world seed, `compose.json`, `last-start.json` с временем готовности и очищенный от известных секретов `diagnostics.log`. Секреты и целый каталог состояния нельзя публиковать или прикладывать к отчёту. Для диагностики достаточно проверенных файлов без секретов. `up` ждёт успешного завершения инициализации БД, затем настраивает realm и проверяет доступность портов авторизации и мира **внутри контейнеров**. По умолчанию лимит — 900 секунд, изменяется через `-TimeoutSeconds`. Это не проверка входа игрока через Windows. При ошибке первого запуска скрипт пытается остановить контейнеры выбранного окружения, сохраняя БД и журнал. Если в нём уже работали службы до вызова, окружение сохраняется работающим для диагностики. Ошибка проверки опубликованных портов из Windows также оставляет runtime работающим и показывает команду проверки состояния. `down` останавливает и удаляет контейнеры/сеть своего окружения, но сохраняет тома БД и журналов. Посторонние службы и окружение владельца не останавливаются. Неудачный первоначальный импорт не считается готовой БД. Для нового импорта после такой ошибки используйте новое имя окружения; существующий том сохраняется для диагностики. Автоматическое удаление или восстановление повреждённого окружения относится к D2. ## Результаты локального прогона 2026-11-14 Общий запуск проверен командой `./scripts/start-editor.ps1 -NoBuild -WithRuntime -RuntimeName mw-editor-d0-acceptance` с явным путём к WoW Data и диагностическому проекту. Сохранённая БД стала готова за 7.80 секунды, мир — за 12.67 секунды. Helper создал отдельный профиль с подключением к `127.0.0.1:13806/mangos`, все три опубликованных порта доступны из Windows. Редактор загрузил мир и каталог. Кадр `target/d0-unified-start/world-catalog.png` показывает результаты запроса `Kobold`, включая Kobold Vermin и Kobold Miner, и 293 серверных спавна. Поиск задан через диагностический параметр, ручные действия в интерфейсе не выполнялись. Процесс завершился с кодом 0, runtime оставлен работающим. Первая попытка с перенаправлением вывода обнаружила прерывание wrapper на диагностическом stderr движка в PowerShell 5. Обработка исправлена, повтор с журналом и кадром `target/d0-unified-start/redirected.png` завершился с кодом 0. Прошли 11 Python-тестов и `scripts/test_start_editor.ps1`. Последний проверяет изоляцию и восстановление переменных, сохранение обычного профиля, обработку повреждённых настроек и устаревшего пути WoW Data, отказ от импорта стороннего окружения в профиль runtime. Созданная им временная копия исполняемого файла удалена. Rust-код и release-сборка в этом дополнении не менялись. После диагностики редактор повторно открыт общим запуском без автоматического закрытия, с проектом `target/d0-smoke/probe.json`. В окне подтверждены мир и 293 серверных спавна. Профиль находится в `%LOCALAPPDATA%/MoonWell/Editor/d0/mw-editor-d0-acceptance`. Редактор собран заново из текущего checkout. Portable ZIP открыт из пути с пробелами и кириллицей, с пустым `EDITOR_HOME`: стартовое окно показало выбор проекта и настройки. Второй запуск использовал новый пустой проект и собственный WoW Data без подключения БД. Через 30 секунд получен кадр 1600×900 с загруженным миром и зданием; процесс завершился с кодом 0. Снимок — `target/d0-smoke/world.png`, описание — `target/d0-smoke/verification.md`. Интерактивное редактирование, экспорт и Play этим запуском не проверялись. В отдельном серверном окружении `mw-editor-d0-proof2` статический импорт завершился за 160.36 секунды; авторизация и мир стали доступны за 171.45 секунды после подготовки снимка входных файлов, от начала запуска контейнеров. Доступность трёх опубликованных портов 13806, 13724 и 18085 дополнительно проверена из Windows через `127.0.0.1`. Вход игрока не проверялся. Времена относятся к этой машине с уже имеющимися образами и игровыми данными, без загрузки и установки WSL/Docker. Повторный свежий импорт окончательной версии скрипта в `mw-editor-d0-acceptance` подтвердил создание manifest с хешами вспомогательных файлов штатным путём: БД готова за 212.59 секунды, мир — за 217.51 секунды. Manifest вручную не менялся. После штатной остановки повторный запуск этого же окружения дал 7.67 секунды до БД и 12.68 секунды до мира. Повторная доступность портов из Windows подтверждена. Проверены 175 таблиц world-базы, 0 аккаунтов и 0 персонажей: данные живых игроков не копировались. Измеренный каталог БД занимает 640 191 142 байта, приватное состояние со снимком SQL — 202 047 757 байт. Снятый в покое расход памяти контейнеров: БД 115.7 MiB, авторизация 2.422 MiB, мир 260.9 MiB; игроков нет, это не системные минимумы. После исходных проверок контейнеры и сети всех трёх тестовых окружений остановлены и удалены; тома БД и журналов сохранены согласно контракту `down`. Чтобы повторно открыть именно проверенное окружение, используйте `./scripts/d0-runtime.ps1 -Action up -Name mw-editor-d0-acceptance`, затем тот же вызов с `-Action down`. Имя по умолчанию `mw-editor-d0-local` оставлено свободным для нового мира. Шесть проверок из `scripts/test_d0_runtime.py` прошли без Docker и БД владельца: исключение пользовательского контента и обнаружение подмены снимка, отказ на неизвестный том журналов, занятый порт до создания ресурсов, очистка секретов в диагностике, порядок остановки мира перед БД и отказ при неверном владельце/конфигурации состояния. Проверены синтаксис PowerShell, Python и Bash и хеши файлов пакета. Rust-проверки также прошли: форматирование, Clippy workspace/all-targets с `-D warnings`, 60 тестов workspace; 5 opt-in тестов штатно пропущены, ошибок нет. Журнал и сводка: `target/d0-runtime-checks/cargo-test.log`, `target/d0-runtime-checks/report.json`. Первая попытка `mw-editor-d0-proof` завершилась до импорта SQL из-за прав доступа к bind-mounted скрипту. Контейнеры этой попытки остановлены, причина исправлена и новый импорт выполнен в отдельном томе. Это обнаруженная и исправленная ошибка прототипа, а не успешный первоначальный прогон. Каталоги состояния/секретов имеют режим 0700; файлы, читаемые пользователями внутри контейнеров, доступны им для чтения. ## Исходные данные исследования Исследование выполнено 2026-11-14. Локально доступны Docker 28.0.4 и Compose 2.34.0. Входы находятся в `/home/sindo/core`, ревизия на момент исследования — `ed6eea2f4`. Прототип не меняет этот репозиторий. - Серверный образ: `sha256:d759d063561780cc60d1a3f526cb924273d43b1020d3b6310fc25115136a0336`, размер образа по Docker — 56 158 759 байт; связь сборки с ревизией ядра не подтверждена. - MariaDB 10.11: `sha256:7db29378d4fdab73f8123bbc2b48905c90d1a4b00cf848b028f1e81e623257f2`, размер образа по Docker — 104 174 329 байт. - `database/mangos.sql`: около 137 MiB, SHA-256 `7c5c064a160a2e65b55b94d65cce26a19bac40f33b83454d5e89ecc2667fe8cf`. - Данные клиента для сервера: `dbc` около 28 MiB, `maps` 279 MiB, `vmaps` 574 MiB, `mmaps` 2.0 GiB. Это локальные данные собственной установки, а не разрешение включать игровые файлы в распространяемый пакет. Размер образа Docker не равен размеру скачивания или всей установки. Размеры выше — инвентаризация локальных входов, не минимальные системные требования и не бюджет первого запуска. Точные требования требуют отдельного измерения готового поставляемого пакета. ## Незакрытые условия D0 - Чистая поддерживаемая Windows без Rust, Git, настроенной БД и серверных исходников. - Независимый пакет server seed/schema/data с происхождением, версиями и проверкой совместимости, без ссылок на личный checkout разработчика. - Совместимая готовая клиентская сборка с доказанной ревизией. Найденный локально `MoonWell 0.3.2` от 2026-11-08 не имеет подтверждённой связи с закреплённой ревизией Benilla редактора; имя папки и отсутствие `.probe-identity` этого не доказывают. - Подготовка тестового аккаунта и персонажа. Штатные команды `account create` и `account set gmlevel` описаны в [play.md](play.md); обычный персонаж создаётся в клиенте. Автоматическое создание персонажа для поставляемого player-клиента ещё не подтверждено. - Замеры загрузки, диска, памяти, времени первого запуска и обновления на чистой машине; проверка native Windows кандидата до окончательного решения о runtime. - Сквозная приёмка «проект → NPC → Play» и прохождение человеком. Открытое окно редактора или слушающий порт мира не считаются таким прохождением.