Архитектура Electron

src/
├── main/
│   ├── app/                    # composition root
│   ├── core/                   # API, config, settings, storage, native paths
│   ├── electron/
│   │   ├── ipc/handlers/       # узкие IPC adapters
│   │   └── window/             # BrowserWindow policies
│   └── modules/
│       ├── auth/               # site/device OAuth
│       │   └── device-authorization-protocol.ts # проверка OAuth DTO и polling
│       ├── builds/
│       │   ├── build-preparation-service.ts          # orchestration only
│       │   ├── build-storage-service.ts              # layout and atomic JSON
│       │   ├── build-download-resolver.ts            # public/signed URLs
│       │   ├── native-build-tools-service.ts          # scanner/downloader process
│       │   ├── build-resource-preparation-service.ts  # scan/download/verify
│       │   └── build-preparation-state-service.ts     # state and IPC events
│       ├── game/
│       │   ├── game-launch-service.ts                 # lifecycle orchestration
│       │   ├── game-launch-plan-service.ts            # launch-plan composition
│       │   ├── game-classpath-service.ts              # classpath discovery
│       │   ├── minecraft-arguments-service.ts         # JVM/client arguments
│       │   ├── guardian-policy-service.ts             # trusted policy file
│       │   ├── guardian-process-service.ts            # Guardian child process
│       │   ├── game-window-service.ts                 # hide/restore windows
│       │   └── game-launch-state-service.ts           # state and IPC events
│       ├── hardware/           # native fingerprint, OS snapshot, API registration
│       ├── session/            # state, contract и encrypted persistence
│       ├── update/             # feed selection, state publishing, updater orchestration
│       ├── discord/            # Rich Presence
│       └── debug/              # отдельная debug console
├── preload/
│   ├── api/                    # core, preferences и runtime bridge factories
│   └── index.ts                # только сборка и exposeInMainWorld
├── renderer/src/
│   ├── entities/               # server/user domain UI и запросы
│   ├── features/               # auth, bootstrap, download, settings
│   ├── pages/                  # композиция маршрута без системной логики
│   ├── shared/                 # UI kit, preview bridge, общие утилиты
│   └── widgets/                # header, footer, top bar
└── shared/contracts/           # IPC DTO и состояния

Границы процессов

Слой	Разрешено	Запрещено
Renderer	React, routing, UI state, typed `window.launcherAPI`	`fs`, `spawn`, access token, прямой HTTP к приватным launcher endpoint
Preload	`ipcRenderer.invoke/on`, строго перечисленный bridge	Произвольный IPC channel, Node API в UI
Main	filesystem, encrypted session, API, native processes, Guardian	Передача секретов renderer’у
Native	Ограниченная файловая/процессная задача по JSON contract	Чтение Electron session и конфигурации сайта

Composition root

create-application-services.ts создаёт сервисы один раз и явно передаёт зависимости конструкторам: Глобальных mutable singleton imports в feature-модулях нет. Это позволяет тестировать lifecycle с подменёнными зависимостями.

Системная конфигурация

Настройки пользователя, выбранный storage root, настройки отдельных серверов и флаги миграции находятся в одном config.json. Внутри файла они разделены на settings, storage, servers и migrations. Старые storage-location.json и server-client-settings.json читаются один раз при обновлении, переносятся в общий store и больше не используются. Запись config.json проходит через единый adapter. На Windows он сохраняет атомарную запись electron-store, но умеет повторить замену файла при кратковременном EPERM от антивируса. Несколько экземпляров приложения не могут одновременно менять store: второй процесс останавливается через single-instance lock.

Модуль подготовки сборки

BuildPreparationService — тонкий сценарный координатор. Он владеет только текущей операцией, AbortController и готовым PreparedBuild. Файловая, процессная и presentation-логика вынесена в специализированные сервисы:

Сервис	Ответственность
`LauncherStorageService`	Выбранный `storageRoot`, проверка целевого пути и места, staged migration между дисками, переключение и очистка старого каталога
`BuildStorageService`	Создание `storage/common`, `storage/runtimes`, `storage/metadata`; безопасные имена; атомарная запись manifest/plan
`BuildDownloadResolver`	Выбор public URL или запрос временных signed URL через API
`NativeBuildToolsService`	Единственная точка `spawn` Rust scanner/downloader, разбор JSON progress и отмена дочернего процесса
`BuildResourcePreparationService`	Единый pipeline `scan → resolve → download → verify` для клиента и Java
`BuildPreparationStateService`	`BuildPreparationState`, расчёт progress и отправка `builds:changed`

Координатор выполняет только последовательность:

получает {profile, build, runtime};
получает безопасный storage layout;
передаёт профиль клиента в общий resource pipeline;
передаёт Java runtime в тот же pipeline;
сохраняет PreparedBuild только после обеих финальных проверок;
переводит состояние в ready.

PreparedBuild не отдаётся renderer’у. В нём находятся profile, manifests и абсолютные пути, необходимые только main-процессу.

Модуль запуска игры

GameLaunchService — координатор одного запуска Guardian/Minecraft. Он не обходит файловое дерево, не формирует classpath и не вызывает spawn самостоятельно:

Сервис	Ответственность
`GamePathService`	Защита от выхода пути за trusted storage root и portable relative path
`GameClasspathService`	Разворачивание `classPath`/`altClassPath`, рекурсивный поиск JAR, сортировка и удаление дублей
`MinecraftArgumentsService`	Placeholder-ы, RAM, JVM/client args, блокировка agent/attach flags
`GuardianPolicyService`	Проверка Java executable, версия Java, protected files/modules, атомарная policy
`GameLaunchPlanService`	Сборка classpath + arguments + policy в один `GameLaunchPlan`
`GuardianProcessService`	Жизненный цикл Rust Guardian и типизированные callbacks его JSON events
`GameWindowService`	Скрытие основного окна во время игры и гарантированное восстановление
`GameLaunchStateService`	`GameLaunchState` и отправка `game:changed` всем renderer-окнам

Сам координатор:

не допускает параллельный запуск;
при необходимости вызывает подготовку сборки;
передаёт пользовательскую сессию сервису launch plan только в памяти;
связывает Guardian events с состоянием, Discord Presence и окнами;
восстанавливает UI после любого exit code.

Состояние GameLaunchState:

type GameLaunchStatus =
  | 'idle'
  | 'preparing'
  | 'launching'
  | 'running'
  | 'stopping'
  | 'exited'
  | 'error'

IPC game API

Preload предоставляет renderer’у только четыре операции:

window.launcherAPI.game.launch(serverId)
window.launcherAPI.game.stop()
window.launcherAPI.game.getState()
window.launcherAPI.game.onChanged(callback)

Renderer не передаёт username, token, Java path, JVM args или policy. Все эти значения main-процесс получает из доверенных сервисов и профиля.

Автоматический сценарий страницы загрузки

При открытии /servers/:serverId/downloads поверх страницы сервера появляется не отдельная страница, а небольшой modal. Feature build-download подписывается на build/game events и вызывает game.launch(serverId). В modal остаются только текущий ресурс, скорость, оставшийся объём и расчётное время. Внутренний async lifecycle продолжается в main, а IPC сразу возвращает текущее состояние.

Сессия и секреты

Access token хранится только в SessionManager и зашифрованном session.json через Electron safeStorage. Он:

не доступен renderer’у;
не хранится в electron-store;
не записывается в Guardian policy;
не выводится в debug console;
передаётся Minecraft как динамический argument после --.

Отмена

Build service завершает активный Rust-процесс и AbortController. Game service дополнительно хранит stopRequested, поэтому отмена между финальной проверкой и spawn(guardian) не создаст Java-процесс. После запуска остановка Guardian закрывает Windows Job Object и всё дерево Minecraft.

Устройство

Игровой контур

Выпуск лаунчера

Границы процессов

Composition root

Системная конфигурация

Модуль подготовки сборки

Модуль запуска игры

IPC game API

Автоматический сценарий страницы загрузки

Сессия и секреты

Отмена

​Границы процессов

​Composition root

​Системная конфигурация

​Модуль подготовки сборки

​Модуль запуска игры

​IPC game API

​Автоматический сценарий страницы загрузки

​Сессия и секреты

​Отмена

Границы процессов

Composition root

Системная конфигурация

Модуль подготовки сборки

Модуль запуска игры

IPC game API

Автоматический сценарий страницы загрузки

Сессия и секреты

Отмена