Глоссарий - Wraithbound Engineering

Одинаковые сущности должны называться одинаково в коде, интерфейсе, логах и документации. Эта страница фиксирует базовую терминологию.

Продукт

Термин	Значение
Wraithbound	Вся платформа: сайт, лаунчер, игровые клиенты и инфраструктура
сайт	Next.js frontend и backend-сервисы основного monorepo
лаунчер	Electron-приложение, установленное у игрока
игровой клиент	Конкретная Minecraft-сборка, например Architechnica
профиль	`profile.json` с правилами установки и запуска клиента
сборка / build	Постоянная логическая сборка, связанная с `buildId`
релиз / release	Неизменяемое опубликованное состояние сборки

Launcher platform

Термин	Значение
launcher-server	Rust control plane для manifests, обслуживания и операций
publisher	Операторский CLI, который готовит и публикует сборки
signed envelope	Protobuf-сообщение вместе с Ed25519-подписью
active release	Релиз, который сейчас предлагается лаунчерам
scanner	Проверяет локальные файлы по размеру и SHA-256
downloader	Скачивает и атомарно заменяет недостающие файлы
Guardian	Запускает и контролирует дерево процессов Minecraft
trust bundle	Реестр публичных ключей, которым доверяет система

Инфраструктура

Термин	Значение
PVE	Proxmox Virtual Environment
node	Физический Proxmox-хост
guest	Виртуальная машина или LXC-контейнер
VMID	Уникальный числовой ID guest внутри Proxmox
bridge	Виртуальный L2-коммутатор Proxmox, например `vmbr0`
VLAN	Изолированный L2-сегмент с числовым тегом
edge	Публичная точка входа с DNS, TLS и reverse proxy
private service	Сервис, доступный только через VPN/внутреннюю сеть
source of truth	Единственное место, где значение считается каноническим
runbook	Проверенная последовательность действий для операции или инцидента

Правило именования

В документации сначала используется человекочитаемое имя, затем технический идентификатор: «Launcher Server (launcher-server)». В командах, путях и переменных сохраняется точное написание из кода.