41 KiB
План интеграции публичного каталога AzerothCore в систему Modules V2 (CSM)
Документ: MODULE_CATALOG_V2_INTEGRATION_PLAN.md
Дата аудита: Ноябрь 2026 г.
Проект: CoA Server Manager (CSM)
Исследуемая целевая ветка: preview/modules-v2
Рабочее дерево Preview: C:\games\coa-server-manager-preview
Статус: Исследование и планирование архитектуры (без модификации рабочих компонентов)
Содержание
- Фактическая архитектура Modules V2
- Карта существующих компонентов с путями и функциями
- Точки интеграции каталога
- Перечень уже реализованных возможностей
- Перечень отсутствующих компонентов
- Предлагаемые минимальные изменения Backend
- Предлагаемые изменения Frontend
- Схема потоков данных
- Модель кэширования и обновления
- Интеграция с анализатором совместимости
- План тестирования (Интеграционная матрица)
- Риски и потенциальные регрессии
- План реализации небольшими независимыми этапами
- Сводная таблица компонентов
- Анализ различий веток:
mastervspreview/modules-v2 - Главный вопрос и итоговый вердикт
1. Фактическая архитектура Modules V2
В ветке preview/modules-v2 (развернута в рабочем дереве C:\games\coa-server-manager-preview) реализована полноценная платформа динамических модулей и плагинов для Conquest of Azeroth.
1.1. Классификация компонентов (Authoritative Inventory)
В отличие от старой архитектуры, где наличие .conf в папке считалось признаком установки, в Modules V2 введена строгая модель типов компонентов (PREVIEW_DISTRIBUTION_ARCHITECTURE.md):
DYNAMIC_DLL: динамически загружаемые C++ библиотеки, компилируемые под CoA Plugin SDK v0.3.2. Хранятся в.manager/plugin-store/<id>/<version>/и линкуются вplugins/. Поддерживают полный динамический жизненный цикл (can_remove = true).CORE_EMBEDDED: легаси C++ модули, монолитно вкомпилированные вworldserver.exe. Не могут быть удалены на лету (can_remove = false).CONTENT_PACK: пакеты контента (DBC, карты, спавны), неизменяемые в рантайме.CLIENT_PATCH: клиентские MPQ-патчи (patch-Z.mpq).LOGICAL_FEATURE: логические переключатели ядра (client-compat).
1.2. Конвейер сборки DLL и границы совместимости
Modules V2 содержит изолированный сборочный движок (crates/coa-core/src/build_engine.rs):
- Тулчейн: автоматическое обнаружение MSVC x64 (
vcvars64.bat), CMake, Ninja и дерева экспортированного SDK (C:\games\coa-work\plugin-spike\sdk-v03). - Генератор адаптера (
generate_adapter): лексически анализирует исходники модуля, находит функцию входаAdd...Scripts(), генерирует файлadapter.cpp, реализующий интерфейсIPluginи функцию запроса контрактаCoaPluginQuery. - Границы совместимости DLL:
- Поддерживаются: модули, написанные на чистом C++ с использованием хуков ScriptMgr (
PlayerScript,WorldScript,CreatureScript,ItemScriptи т.д.), не модифицирующие ядро. - Не поддерживаются: модули, требующие изменений ядра (
CorePatchRequired— патчиPlayer.cpp, DBC-структур), модули с внешними нелинкуемыми библиотеками (ALEбез LuaJIT рантайма), или модули с отсутствующими экспортами ядра (SdkExportMissing). - ABI-контроль: сборка возможна только при совпадении хэша ABI хоста (
realm_sdk_fingerprint) со слепком SDK.
- Поддерживаются: модули, написанные на чистом C++ с использованием хуков ScriptMgr (
1.3. Транзакционная установка и ворота безопасности
Установка модулей управляется через crates/coa-core/src/preview.rs и plugins.rs:
- Stop-Gate (
require_server_stopped): установка, удаление или обновление DLL строго блокируются, если процессworldserver.exeактивен. - SQL Review Gate (
plan_sql_review): статический парсер SQL выявляет наличие DDL-мутаций (CREATE/ALTER TABLE) и требует явного подтверждения пользователя. - Реестр: состояние фиксируется в
.manager/plugins.jsonсо слепками SHA-256 файлов, версиями и путями к конфигам.
2. Карта существующих компонентов с путями и функциями
graph TD
UI["ModulesPage.tsx (React/Tailwind)"] -->|IPC Invoke| Tauri["src-tauri/src/lib.rs"]
Tauri --> Analyzer["analyzer.rs (Intake & L0 Static Audit)"]
Tauri --> Builder["build_engine.rs (MSVC / CMake / Adapter Gen)"]
Tauri --> Preview["preview.rs (Stop-Gate / SQL Gate / Orchestration)"]
Preview --> Plugins["plugins.rs (Store & .manager/plugins.json)"]
| Уровень / Назначение | Путь к файлу | Ключевые функции / Точки входа |
|---|---|---|
| Intake & Static Audit | crates/coa-core/src/analyzer.rs |
analyze_github_module_for_realm(&url, &realm_root, cache_dir)analyze_github_repository(&url, cache_dir)parse_and_validate_github_url(&url) |
| Controlled Build Engine | crates/coa-core/src/build_engine.rs |
detect_toolchain()build_module_from_source(&source_dir, &realm_root, ...)generate_adapter(&module_dir) |
| Lifecycle & Orchestration | crates/coa-core/src/preview.rs |
install_qualified_module(&realm_root, &id, &ver, apply_sql, ...)list_installed_preview_plugins(&realm_root)toggle_preview_module(&realm_root, &id, enable)remove_preview_module(&realm_root, &id)plan_sql_review(&module_id, &report) |
| Plugin Store & Registry | crates/coa-core/src/plugins.rs |
load_registry(&root) / save_registry(&root, ®)install(...) / remove(...)require_server_stopped(&root) |
| Tauri IPC Bridge | src-tauri/src/lib.rs |
analyze_github_module(url, realm_id) (L2800)preview_build_module(realm_id, source) (L2849)preview_install_module(realm_id, id, ver, sql) (L2895)preview_toggle_module(realm_id, id, enable) (L2919)preview_remove_module(realm_id, id) (L2934)preview_list_installed_plugins(realm_id) (L2948) |
| Frontend API Layer | src/lib/api.ts |
api.analyzeGithubModule(url, realmId) (L733)api.previewBuildModule(realmId, source)api.previewInstallModule(...)api.previewToggleModule(...) |
| Modules V2 UI View | src/screens/ModulesPage.tsx |
Вкладка installed (L2151)Вкладка catalog (L2813)Вкладка builds (L3431)Вкладка toolchain (L3500)Функция интейка: runAnalysis(url) (L1328)Функция сборки: startControlledBuild(url) (L1365) |
3. Точки интеграции каталога
Существующая архитектура Modules V2 полностью готова к приёму URL репозиториев.
Точкой интеграции на стороне Frontend является функция:
// src/screens/ModulesPage.tsx, строки 1328–1362
async function runAnalysis(urlToAnalyze?: string) {
const targetUrl = (urlToAnalyze || githubUrl).trim();
if (!targetUrl) return;
setGithubUrl(targetUrl);
setAnalyzing(true);
// ...
const rep = await api.analyzeGithubModule(targetUrl, serverId);
setReport(rep);
}
Принцип бесшовной стыковки:
- Каталог модулей отображает карточки доступных репозиториев.
- При нажатии на карточке кнопки «Анализировать и подготовить к установке» вызывается:
runAnalysis(module.html_url); - CSM автоматически переключает контекст на анализ репозитория, скачивает исходники в кэш, выполняет L0-аудит и отображает модальное окно совместимости.
- Пользователь нажимает «Собрать DLL» (
startControlledBuild()), после чего срабатываетpreviewInstallModule().
Результат: Не требуется создавать второй установщик, дублировать сборщик или менять логику реестра .manager/plugins.json.
4. Перечень уже реализованных возможностей
В ветке preview/modules-v2 уже полностью реализованы и протестированы:
- Загрузка исходных кодов с GitHub с кэшированием в
%LOCALAPPDATA%\CSMModulesPreview\github_cacheи дедупликацией по SHA дерева коммита. - Статический анализатор совместимости (L0 Static Analysis) с проверкой сигнатур функций
Add...Scripts(), детекцией core patches, парсингом SQL-миграций и проверкой лицензий. - Автоматический генератор C++ адаптеров
IPluginпод CoA Plugin SDK. - Сборочный движок MSVC x64 + Ninja + CMake с захватом логов компиляции в реальном времени.
- Stop-Gate валидация (защита от изменения DLL и баз данных работающего сервера).
- SQL Review Gate (анализ рисков DDL/DML перед наложением на базу данных).
- Установка DLL в хранилище
.manager/plugin-store/, создание символических ссылок вplugins/и фиксация в.manager/plugins.json. - Полный жизненный цикл установленных плагинов: включение, отключение, безопасное удаление (с сохранением пользовательских таблиц БД).
- Пользовательский интерфейс с вкладками «Установленные плагины», «Сборка & логи MSVC» и «Среда сборки & SDK».
5. Перечень отсутствующих компонентов
Для полноценной работы каталога в Modules V2 отсутствуют исключительно компоненты обнаружения и доставки метаданных:
- Сетевой загрузчик официального JSON (
PublicCatalogueFetcher): сервис вcrates/coa-core, скачивающийhttps://www.azerothcore.org/data/catalogue.jsonс поддержкой ETag и сохранением на диск. - Локальный дисковый кэш каталога: файл кэша в
%LOCALAPPDATA%\CSMModulesPreview\catalogue_cache.jsonс оффлайн-фоллбэком. - Парсер и фильтр категории
azerothcore-module: извлечение 545 репозиториев, нормализация данных, отсеивание заведомо нерелевантных проектов (чистые Lua/SQL). - Кураторский оверлей CoA (
coa-modules-overlay.json): встроенный или подгружаемый файл, содержащий экспертные вердикты для ядра CoA (Verified,Incompatible,RequiresAdapter). - Tauri IPC команда
get_public_module_catalog: эндпоинт передачи каталога во фронтенд. - Динамический каталог в UI (
ModulesPage.tsx): расширение вкладкиcatalog, заменяющее жестко закодированный массивVERIFIED_CATALOGна динамический список с поиском, сортировкой и карточкой деталей.
6. Предлагаемые минимальные изменения Backend
6.1. Новый модуль crates/coa-core/src/catalogue.rs
Добавляется один изолированный файл со структурами и логикой:
// crates/coa-core/src/catalogue.rs
use std::collections::BTreeMap;
use std::fs;
use std::path::{Path, PathBuf};
use serde::{Deserialize, Serialize};
use crate::error::{Error, Result};
pub const OFFICIAL_CATALOGUE_URL: &str = "https://www.azerothcore.org/data/catalogue.json";
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RawRepoEntry {
pub id: u64,
pub name: String,
pub full_name: String,
pub description: Option<String>,
pub stargazers_count: u32,
pub default_branch: String,
pub html_url: String,
pub forks_count: u32,
pub watchers_count: u32,
#[serde(default)]
pub pushed_at: Option<String>,
#[serde(default)]
pub updated_at: Option<String>,
#[serde(default)]
pub license: Option<RawLicense>,
#[serde(default)]
pub topics: Vec<String>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RawLicense {
pub spdx_id: Option<String>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RawCatalogue {
pub global_search: bool,
pub organizations: BTreeMap<String, BTreeMap<String, Vec<RawRepoEntry>>>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PublicModuleCard {
pub id: u64,
pub name: String,
pub full_name: String,
pub description: String,
pub stars: u32,
pub html_url: String,
pub default_branch: String,
pub last_pushed: String,
pub license: String,
pub topics: Vec<String>,
pub coa_status: String, // "verified", "unverified", "incompatible", "blocked"
pub coa_note: Option<String>,
}
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CatalogueResponse {
pub modules: Vec<PublicModuleCard>,
pub cached_at: String,
pub is_offline: bool,
}
pub fn get_catalogue(cache_dir: &Path, force_refresh: bool) -> Result<CatalogueResponse> {
let cache_file = cache_dir.join("catalogue_cache.json");
let etag_file = cache_dir.join("catalogue_etag.txt");
// 1. Проверка необходимости обновления и загрузка с ETag через reqwest
// 2. Слияние с coa-modules-overlay.json
// 3. Возврат нормализованного списка
// ...
}
6.2. Регистрация в crates/coa-core/src/lib.rs
Добавить строку:
pub mod catalogue;
6.3. Экспорт команды в src-tauri/src/lib.rs
Добавить одну команду:
#[tauri::command]
async fn get_public_module_catalog(
state: State<'_, AppState>,
force_refresh: bool,
) -> std::result::Result<coa_core::catalogue::CatalogueResponse, UiError> {
let cache_dir = data_dir().join("catalogue");
blocking(move || {
coa_core::catalogue::get_catalogue(&cache_dir, force_refresh)
.map_err(Into::into)
}).await
}
И зарегистрировать её в generate_handler!.
7. Предлагаемые изменения Frontend
7.1. Расширение src/lib/api.ts
Добавить один метод:
getPublicModuleCatalog: (forceRefresh = false) =>
invoke<CatalogueResponse>("get_public_module_catalog", { forceRefresh }),
7.2. Минимальные изменения в src/screens/ModulesPage.tsx
В существующей вкладке catalog (строки 2813–3100):
- Загрузка данных: При открытии вкладки
catalogвызыватьapi.getPublicModuleCatalog(). - Панель фильтров и поиска:
- Поле поиска: фильтрация списка по
name,description,topics. - Сортировка: «По звёздам (популярные)», «По дате обновления (свежие)».
- Фильтр категорий: «Все» (545), «Проверенные CoA», «Геймплей», «Утилиты».
- Поле поиска: фильтрация списка по
- Карточка модуля:
- Название, автор, описание, бейдж звёзд и лицензии.
- Бейдж совместимости с CoA:
- Зелёный:
Verified CoA(из оверлея). - Серый:
Unverified Public(из официального каталога). - Красный:
Incompatible with CoA(известный конфликт).
- Зелёный:
- Кнопка действия:
- Если модуль уже установлен (совпадает
repoс установленными вinstalledPlugins): отображать бейджУстановленс версией. - Если не установлен: кнопка «Анализировать и установить».
- Если модуль уже установлен (совпадает
- Обработчик кнопки установки:
Больше ничего не требуется: клик переключает состояние, запускает L0-анализ, открывает окно совместимости и передает управление в готовый сборочный движок.
onClick={() => { runAnalysis(module.html_url); }}
8. Схема потоков данных
sequenceDiagram
autonumber
actor User as Пользователь
participant UI as ModulesPage (Catalog Tab)
participant IPC as Tauri IPC (lib.rs)
participant Cat as CatalogueFetcher (crates/coa-core)
participant CDN as azerothcore.org (Cloudflare CDN)
participant Analyzer as analyzer.rs (Intake & L0)
participant Builder as build_engine.rs (MSVC)
participant Installer as preview.rs & plugins.rs
User->>UI: Переход во вкладку "Каталог"
UI->>IPC: get_public_module_catalog(force_refresh=false)
IPC->>Cat: get_catalogue(cache_dir)
alt Кэш отсутствует или устарел
Cat->>CDN: GET /data/catalogue.json (If-None-Match: etag)
CDN-->>Cat: 200 OK (804 KB JSON)
Cat->>Cat: Сохранение cache.json и etag.txt
else Кэш актуален
Cat->>CDN: GET /data/catalogue.json
CDN-->>Cat: 304 Not Modified
end
Cat->>Cat: Слияние с coa-modules-overlay.json
Cat-->>UI: CatalogueResponse (545 модулей)
UI-->>User: Отображение каталога с поиском и бейджами CoA
User->>UI: Клик "Анализировать и установить" (выбран mod-aoe-loot)
UI->>IPC: analyze_github_module(url, realm_id)
IPC->>Analyzer: analyze_github_module_for_realm()
Analyzer->>Analyzer: Git intake, AST аудит, проверка Add...Scripts, SQL аудит
Analyzer-->>UI: CompatibilityReport (L0 PASS, Buildable)
UI-->>User: Модальное окно аудита совместимости
User->>UI: Клик "Собрать DLL"
UI->>IPC: preview_build_module(realm_id, url)
IPC->>Builder: build_module_from_source()
Builder->>Builder: Генерация adapter.cpp, компиляция MSVC + Ninja
Builder-->>UI: BuildResult (Success, DLL SHA-256)
User->>UI: Клик "Установить в сервер"
UI->>IPC: preview_install_module(realm_id, module_id, ver, apply_sql)
IPC->>Installer: install_qualified_module()
Installer->>Installer: Stop-Gate check, копирование DLL, plugins.json
Installer-->>UI: PreviewInstallResult (Success)
UI-->>User: Модуль активен в сервере!
9. Модель кэширования и обновления
- Заголовки ETag / Conditional Requests:
Сервер
azerothcore.orgвозвращает стандартный HTTP заголовокETag: "88aa9d...". При повторном запросе CSM отправляетIf-None-Match. Получение304 Not Modifiedполностью исключает передачу 800 КБ по сети. - Дисковый кэш:
Кэш сохраняется в
%LOCALAPPDATA%\CSMModulesPreview\catalogue\cache.json. - Оффлайн-режим:
Если подключение к сети отсутствует (NetworkUnreachable, DNS failure), клиент не выдает ошибку, а прозрачно возвращает сохранённый
cache.jsonс флагомis_offline = true. - Защита от повреждений:
Запись файла кэша производится атомарно через временный файл (
fsx::atomic_write). При повреждении JSON кэш отбрасывается, и используется встроенный в бинарник минимальный снапшот. - Дедупликация и переименования:
Естественным ключом в каталоге является числовой
idрепозитория GitHub. При переименовании репозиторияidсохраняется, обновляется только полеfull_name.
10. Интеграция с анализатором совместимости
Каталог и существующий анализатор crates/coa-core/src/analyzer.rs работают в синергии:
- В каталоге (до выбора): пользователь видит метаданные GitHub (звезды, дату обновления) + кураторский статус CoA (
Verified,Incompatible,Unverified). - После выбора модуля: запускается глубокий анализ
analyze_github_module_for_realm:- Вычисляется точный хэш исходного кода (
.coa_tree_digest). - Проверяется наличие экспортов ядра через PE-парсинг
worldserver.exe(parse_pe_exports). - Проверяется совпадение ABI-фингерпринта.
- Проверяется канонический загрузчик
Add<module_name>Scripts(). - Проводится аудит SQL-миграций на наличие
CREATE/ALTER TABLE. - Формируется отчет
CompatibilityReportс многомерным статусом (BuildStatus,RuntimeStatus,GameplayStatus).
- Вычисляется точный хэш исходного кода (
Таким образом, публичный каталог выступает витриной обнаружения, а существующий анализатор Modules V2 — воротами допуска.
11. План тестирования (Интеграционная матрица)
| № | Тестовый сценарий | Ожидаемый результат | Метод проверки |
|---|---|---|---|
| 1 | Загрузка каталога онлайн | Загружено 545 модулей, статус 200 OK, сохранен кэш и ETag | Unit-тест test_catalogue_fetch_online с mock-сервером |
| 2 | Повторная загрузка с валидным ETag | Сервер отвечает 304 Not Modified, данные берутся из локального кэша | Mock HTTP тест с проверкой заголовка If-None-Match |
| 3 | Загрузка в оффлайн-режиме | Возвращаются данные из cache.json, флаг is_offline == true |
Тест с отключенным сетевым адаптером / mock network error |
| 4 | Поврежденный кэш на диске | Ошибка перехватывается, загружается резервный снапшот, приложение не падает | Повреждение файла cache.json битыми байтами |
| 5 | Дедупликация репозиториев | В списке отсутствуют дублирующиеся ID репозиториев | Проверка Set<id>.len() == list.len() |
| 6 | Распознавание установленных модулей | Модуль, установленный в сервере, помечается в каталоге бейджем Установлен |
Сверка repo каталога со списком list_installed_preview_plugins |
| 7 | Передача URL в runAnalysis |
При клике по модулю поле githubUrl заполняется корректным URL, стартует L0-анализ |
Проверка аргументов вызова api.analyzeGithubModule |
| 8 | Сохранение ручного ввода URL | Поле ввода произвольного GitHub URL продолжает функционировать | Ручной ввод https://github.com/custom/repo и запуск анализа |
| 9 | Передача данных в анализатор | Анализатор получает URL, загружает репозиторий и возвращает CompatibilityReport |
Прогон анализатора на модуле mod-aoe-loot |
| 10 | Ворота безопасности (Stop-Gate) | Попытка установить модуль при работающем worldserver.exe блокируется |
Интеграционный тест require_server_stopped |
| 11 | Отображение ошибок сборки | При ошибке компиляции в логах MSVC пользователь видит подсказку в UI | Сборка заведомо битого C++ модуля |
| 12 | Предупреждение о конфликтах CoA | Модуль mod-learn-spells отображает предупреждение о конфликте с драфтом |
Проверка поля coa_status == "incompatible" |
| 13 | Фиксация версий установленных модулей | Обновление каталога не затрагивает скомпилированные DLL в .manager/plugins/ |
Сравнение хэшей DLL до и после обновления каталога |
| 14 | Производительность UI | Рендеринг 545 карточек с виртуализацией или пагинацией не вызывает фризов UI | React Profiler тест рендеринга страницы |
12. Риски и потенциальные регрессии
| Риск | Вероятность | Влияние | Мера предотвращения |
|---|---|---|---|
| Регрессия существующего ручного ввода URL | Низкая | Высокое | Ручной ввод GitHub URL остается в интерфейсе как приоритетный альтернативный способ; каталог только передает URL в ту же функцию runAnalysis. |
| Падение UI при рендеринге 500+ элементов | Средняя | Среднее | Использование поиска/фильтрации на клиенте с лимитом отображения (пагинация по 24 карточки или виртуальный скроллинг). |
| Изменение формата JSON официального каталога AC | Низкая | Среднее | Использование serde(default) для всех необязательных полей; строгие fallback-значения при отсутствии полей. |
| Ложная уверенность пользователя в совместимости | Высокая | Высокое | Яркие бейджи: статус Unverified Public для всех сторонних модулей из каталога до прохождения L0–L5 тестов. |
| Блокировка сервером CDN (HTTP 429) | Минимальная | Низкое | Запросы отправляются только раз в 12–24 часа или по явному клику пользователя «Обновить»; наличие оффлайн-кэша. |
13. План реализации небольшими независимыми этапами
Этап 1: Backend & Сетевой кэш (Бэкенд-сервис каталога)
- Создать
crates/coa-core/src/catalogue.rs. - Реализовать загрузку
https://www.azerothcore.org/data/catalogue.jsonс поддержкой ETag. - Реализовать чтение локального файла
coa-modules-overlay.jsonи слияние статусов. - Написать модульные тесты парсинга и кэширования.
- Результат: Автономный протестированный Rust-модуль, готовый к вызову из Tauri.
Этап 2: Tauri IPC Bridge & Frontend API
- Зарегистрировать команду
get_public_module_catalogвsrc-tauri/src/lib.rs. - Добавить типизированный метод в
src/lib/api.ts. - Результат: Фронтенд может запрашивать актуальный список модулей одной асинхронной функцией.
Этап 3: UI интеграция в ModulesPage.tsx
- Во вкладке
catalogзаменить хардкодVERIFIED_CATALOGна динамическую загрузку черезapi.getPublicModuleCatalog(). - Добавить строку поиска, фильтры категорий и селектор сортировки.
- Привязать кнопку действия карточки модуля к существующей функции
runAnalysis(module.html_url). - Результат: Пользователь выбирает любой модуль из официального каталога AzerothCore и запускает штатный процесс анализа и сборки Modules V2 в один клик.
14. Сводная таблица компонентов
| Компонент | Уже существует | Требуется изменить | Новый компонент | Описание и роль |
|---|---|---|---|---|
| GitHub downloader | analyzer.rs (analyze_github_repository) |
НЕ МЕНЯТЬ | Нет | Клонирует и кэширует исходники репозитория в %LOCALAPPDATA%\CSMModulesPreview\github_cache. Полностью готов. |
| Compatibility analyzer | analyzer.rs (analyze_github_module_for_realm) |
НЕ МЕНЯТЬ | Нет | Выполняет L0 Static Audit, проверяет хуки, сигнатуру Add...Scripts, структуру SQL и лицензии. Полностью готов. |
| Module builder | build_engine.rs (build_module_from_source) |
НЕ МЕНЯТЬ | Нет | Генерирует C++ адаптер IPlugin, компилирует MSVC x64 + Ninja против CoA SDK v0.3. Полностью готов. |
| Module installer | preview.rs (install_qualified_module) & plugins.rs |
НЕ МЕНЯТЬ | Нет | Контролирует Stop-Gate, SQL Review Gate, копирует DLL в .manager/plugin-store/, прописывает в plugins.json. Полностью готов. |
| Module registry | .manager/plugins.json (plugins.rs) |
НЕ МЕНЯТЬ | Нет | Авторитетный реестр установленных плагинов realm'а. Полностью готов. |
| Module Catalogue Fetcher | Нет | Нет | ДА (catalogue.rs) |
Скачивает официальный JSON с CDN AzerothCore с ETag-кэшированием и оверлеем CoA. Новый легковесный компонент. |
| Modules UI | ModulesPage.tsx |
Минимально расширить | Нет | В существующую вкладку catalog добавляется вызов getPublicModuleCatalog() и связка с runAnalysis(). Без переписывания UI. |
15. Анализ различий веток: master vs preview/modules-v2
| Характеристика / Возможность | Состояние в master (предыдущий аудит) |
Состояние в preview/modules-v2 (целевая ветка) |
Влияние на план интеграции |
|---|---|---|---|
| Модель модулей | Только монолитная компиляция в worldserver.exe |
Полноценная архитектура динамических DLL плагинов | Отпала необходимость проектировать систему сборки и загрузки модулей. |
| Сборочный движок | Отсутствовал в коде CSM | Реализован в build_engine.rs (MSVC + Ninja + Adapter Gen) |
Сборщик уже написан, отлажен и квалифицирован на тестовой когорте T01–T04. |
| Анализатор совместимости | Базовые заготовки | Мощный модуль analyzer.rs (2445 строк, L0–L6 верификация) |
Анализатор готов к приему любого репозитория из каталога. |
| Установщик и транзакции | Только текстовая правка .conf файлов |
Транзакционный установщик в preview.rs со Stop-Gate и SQL Review |
Установщик готов и защищает сервер от крашей на лету. |
| Интерфейс управления | Простой список из 9 карточек | 4-вкладочный интерфейс ModulesPage.tsx (2737 строк) |
Интерфейс готов: нужно лишь заменить статический каталог на динамический. |
| Каталог модулей | Статический modules/catalog.json (9 шт.) |
Статический VERIFIED_CATALOG в TypeScript (8 шт.) |
Единственная недостающая часть — подключение официального JSON к каталогу. |
16. Главный вопрос и итоговый вердикт
Главный вопрос:
Как добавить официальный публичный каталог AzerothCore в уже работающую систему Modules V2 с минимальными изменениями, без дублирования существующей логики и без регрессий установки модулей?
Итоговый технический вердикт:
-
Готова ли Modules V2 к подключению каталога?
Да, на 100%. Архитектура веткиpreview/modules-v2находится в состоянии полной готовности: вся сквозная цепочка (Intake URL -> Analyze -> Build DLL -> Review SQL -> Install -> Toggle -> Remove) уже функционирует и протестирована. Каталог нужен исключительно как поставщик URL для этой цепочки. -
Сколько новых компонентов действительно необходимо?
Ровно один новый модуль на Backend:crates/coa-core/src/catalogue.rs(~200 строк чистого кода на Rust) для загрузкиhttps://www.azerothcore.org/data/catalogue.jsonс ETag-кэшированием и наложением кураторских статусов CoA. -
Какие существующие функции будут переиспользованы?
analyze_github_module_for_realm(analyzer.rs) — для глубокого аудита выбранного модуля.build_module_from_source(build_engine.rs) — для компиляции выбранного модуля в DLL.install_qualified_module(preview.rs) — для безопасной установки плагина.runAnalysis(ModulesPage.tsx) — как готовая точка запуска пайплайна по клику в UI.
-
Есть ли архитектурные препятствия?
Архитектурных препятствий нет. Никаких конфликтов зависимостей, ограничений по типам данных или блокеров в дизайне Modules V2 не обнаружено. -
Какой минимальный безопасный объём изменений требуется для первого рабочего релиза?
- Добавить
crates/coa-core/src/catalogue.rs(загрузка JSON и дисковый кэш). - Зарегистрировать IPC-команду
get_public_module_catalogвsrc-tauri/src/lib.rs. - В
src/screens/ModulesPage.tsxзаменить хардкодVERIFIED_CATALOGна рендеринг списка из API и вызовrunAnalysis(module.html_url)при клике.
- Добавить
Все остальные механизмы Modules V2 остаются нетронутыми.