Files
sindoring d229117a23 Add NPC authoring, custom appearances and bilingual quests
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>
2026-11-14 18:43:02 +04:00

204 lines
22 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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» и прохождение человеком. Открытое окно редактора
или слушающий порт мира не считаются таким прохождением.