d229117a23
Support project-local editing of existing NPC services and quest links, with guarded migrations and preserved server data. Add custom appearance artifacts, Russian-first quests with independent English text, and the local D0 launcher and content catalog. Validation: cargo fmt --all; cargo clippy --workspace --all-targets -- -D warnings; cargo test --workspace (106 passed, 0 failed, 32 ignored). Co-Authored-By: Codex <noreply@openai.com>
204 lines
22 KiB
Markdown
204 lines
22 KiB
Markdown
# 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» и прохождение человеком. Открытое окно редактора
|
||
или слушающий порт мира не считаются таким прохождением.
|