Spectra

Spectra - это бренд хостинга игровых серверов, для которого мы построили полный панельный бекенд. Этот кейс посвящён одной, но ключевой части этой головоломки: нативному десктопному клиенту для администраторов. Это не отдельное приложение, живущее рядом с панелью - это ещё одна оболочка над тем же ядром, общающаяся с тем же бекендом, что и веб-версия. Чтобы понять, почему это было вызовом, сначала нужно увидеть, насколько велика система под ним.

Десктопный клиент не рисует красивые экраны над пустотой. Он стоит на полноценной платформе: провижининг серверов, управление мощностью, файлы, базы данных, телеметрия, биллинг и права доступа. Наша задача была дать администратору нативное окно на всё это - без обёрнутого браузера и без дублирования логики, которая и так уже жила в веб-панели.

Администратор игровых серверов не заглядывает в панель раз в неделю. Он держит её открытой восемь часов, рядом с консолью, игровым клиентом и мессенджером. В таком режиме очередная вкладка браузера - не удобство, а пятое колесо в телеге: она теряется в толпе вкладок, у неё нет своего значка на панели задач, она не реагирует на системные сочетания клавиш и не видит локальных файлов.

Мы хотели дать тот же вид, что и веб, но как приложение, которое ведёт себя как остальные программы на рабочем столе. Одно жёсткое условие: никакого обёрнутого Chromium. Клиент, который добавляет 200 МБ памяти при старте только для того, чтобы показать ровно то же самое, промахивается мимо цели ещё до того, как успевает полностью запуститься. Раз администратор проводит здесь большую часть дня, приложение должно быть лёгким, мгновенным и "своим" на его системе, а не очередным окном браузера, притворяющимся программой.

Самое большое заблуждение в таком проекте - думать, что "это всего лишь панель". На самом деле панель - это тонкий слой над бекендом, который делает тяжёлую работу: запускает и останавливает игровые серверы, распределяет ресурсы, держит базы данных, транслирует логи и консоль в прямом эфире, следит за лимитами и биллингом. Этот бекенд - это обширный API семейства frozcore/frozmod - десятки эндпоинтов, события в реальном времени и модель прав доступа, которая решает, кто что видит и что может сделать.

Десктопный клиент должен общаться ровно с тем же API, что и веб-панель. Здесь нет "упрощённой десктопной версии": если администратор меняет лимит памяти сервера или перезапускает инстанс, он делает это через тот же контракт, через который это делает веб. Поэтому, прежде чем появился хоть один экран, нужно было понять и обуздать масштаб этого API - и это была реальная часть вызова, а не сам вид окна.

Доменная логика - авторизация, модель сервера, команды питания, поток логов, отображение прав доступа на это API - живёт в одной библиотеке .NET. Веб-панель и десктопный клиент - это две оболочки над этим одним ядром, поэтому правка в правиле доступа или в обработке эндпоинта попадает в оба места сразу. Целый класс ошибок "на вебе работает, на десктопе сломано" просто исчезает.

Слой вида рисует Avalonia. Это не webview - контролы рендерятся напрямую через Skia, тем же путём на Windows и на Linux, поэтому приложение выглядит идентично на обоих. Заодно оно получает реальный доступ к файловой системе, буфер обмена и уведомлениям, которого обёрнутая страница никогда не имела.

Это была самая тяжёлая часть. Бекенд Spectra выставляет десятки операций: жизненный цикл сервера, консоль, файлы, базы данных, расписания задач, резервные копии, пользователи и права доступа, телеметрия ресурсов. Чтобы десктопный клиент не превратился в клубок вызовов, мы обернули весь API в один типизированный клиент в ядре - с одним местом для авторизации, повторов и обработки ошибок.

Раз граничным условием было "без обёрнутого Chromium", производительность была не добавкой, а целью. Avalonia рисует интерфейс напрямую, без движка браузера внутри, поэтому бинарник с полной панелью весит долю того, что весил бы тот же вид в Electron, и стартует за долю секунды.

К этому добавляется то, чего браузер никогда не давал: реальный доступ к файловой системе (файлы сервера вы указываете прямо с диска, без их предварительной загрузки в браузер), системные сочетания клавиш, нативные уведомления и значок на панели задач. Для того, кто сидит в панели весь день, это не косметика, а ежедневная экономия времени.

Имея ядро с клиентом API и оболочку на Avalonia, всё собиралось повторяемым способом. Ключевым было то, чтобы один источник давал два самостоятельных бинарника, реально протестированных на обеих системах, а не просто компилирующихся под оба.

Администратор получает программу, которая стартует за долю секунды, держится на панели задач как любое другое приложение и показывает ровно те же данные, что и веб-панель - потому что под спудом это тот же код и то же API. Системные сочетания клавиш работают, файлы с диска можно указать без их предварительной загрузки в браузер, консоль и логи летят в прямом эфире, а окно не теряется в гуще вкладок. Вместо "страницы в окне" администратор получает инструмент, который ощущается как часть его системы.

Со стороны Spectra выгода столь же конкретна и многолетняя. Одна логика и один клиент API вместо двух, поддерживаемых вручную в согласии, означают, что развитие платформы не умножается на число оболочек. Новое правило доступа, новый эндпоинт в бекенде или изменение в модели сервера попадает в веб и на десктоп одним и тем же коммитом. Целый класс ошибок синхронизации исчезает, а десктопный клиент перестаёт быть отдельным проектом для поддержки.

Самое важное всё же то, что десктоп - не "облегчённая версия". Он общается с тем же полным API frozcore/frozmod, что и веб-панель, поэтому администратору не нужно возвращаться в браузер за функциями, которых в приложении не хватило - потому что не хватило ни одной. Это разница между обёрнутой страницей и настоящим, нативным клиентом платформы: второй растёт вместе с бекендом, а не тащится за ним.