Spectra

Spectra è un marchio di hosting di server di gioco per il quale abbiamo costruito l'intero backend del pannello. Questo caso di studio riguarda un pezzo, ma cruciale, di quel puzzle: il client desktop nativo per gli amministratori. Non è un'app separata che vive accanto al pannello - è un'altra scocca sopra lo stesso cuore, che dialoga con lo stesso backend della versione web. Per capire perché sia stata una sfida, bisogna prima vedere quanto grande sia il sistema sottostante.

Il client desktop non disegna belle schermate sopra il vuoto. Poggia su una piattaforma completa: provisioning dei server, gestione della potenza, file, database, telemetria, fatturazione e permessi. Il nostro compito era dare all'amministratore una finestra nativa su tutto questo - senza un browser impacchettato e senza duplicare una logica che già viveva nel pannello web.

Un amministratore di server di gioco non controlla il pannello una volta a settimana. Lo tiene aperto per otto ore, accanto alla console, al client di gioco e alla messaggistica. In questa modalità un'altra scheda del browser non è una comodità, è una quinta ruota del carro: si perde nella folla delle schede, non ha un'icona propria nella barra delle applicazioni, ignora le scorciatoie di sistema e non vede i file locali.

Volevamo dare la stessa vista del web, ma come app che si comporta come il resto dei programmi sul desktop. Una condizione ferrea: niente Chromium impacchettato. Un client che aggiunge 200 MB di memoria all'avvio solo per mostrare esattamente la stessa cosa manca il proprio scopo prima ancora di aver finito di avviarsi. Se l'amministratore deve passare qui la maggior parte della giornata, l'app deve essere leggera, immediata e "di casa" sul suo sistema, non l'ennesima finestra del browser che finge di essere un programma.

Il più grande fraintendimento in un progetto come questo è pensare che "sia solo un pannello". In realtà il pannello è un sottile strato sopra un backend che fa il lavoro pesante: avvia e ferma i server di gioco, alloca le risorse, tiene i database, trasmette i log e la console in diretta e fa rispettare limiti e fatturazione. Quel backend è la corposa API frozcore/frozmod - decine di endpoint, eventi in tempo reale e un modello di permessi che decide chi vede cosa e cosa può fare.

Il client desktop deve dialogare con esattamente la stessa API del pannello web. Non c'è una "versione desktop semplificata": se l'amministratore cambia il limite di memoria di un server o riavvia un'istanza, lo fa attraverso lo stesso contratto che usa il web. Perciò, prima ancora che esistesse una sola schermata, bisognava capire e domare la scala di quell'API - e questa era la vera parte della sfida, non l'aspetto della finestra.

La logica di dominio - autorizzazione, modello del server, comandi di alimentazione, flusso di log, mappatura dei permessi su quell'API - vive in un'unica libreria .NET. Il pannello web e il client desktop sono due scocche sopra quell'unico cuore, cosicché una correzione in una regola di permessi o nel modo di gestire un endpoint atterra in entrambi i posti contemporaneamente. Un'intera classe di bug "funziona sul web, rotto sul desktop" semplicemente scompare.

Avalonia disegna lo strato di vista. Non è un webview - i controlli si renderizzano direttamente tramite Skia, per lo stesso percorso su Windows e Linux, cosicché l'app appare identica su entrambi. Lungo la strada ottiene un accesso reale al file system, agli appunti e alle notifiche che una pagina impacchettata non ha mai avuto.

Questa è stata la parte più pesante. Il backend di Spectra espone decine di operazioni: ciclo di vita del server, console, file, database, pianificazioni di attività, backup, utenti e permessi, telemetria delle risorse. Per evitare che il client desktop si trasformi in un groviglio di chiamate, abbiamo avvolto l'intera API in un unico client tipizzato nel cuore - con un unico posto per autorizzazione, ritentativi e gestione degli errori.

Poiché la condizione al contorno era "niente Chromium impacchettato", le prestazioni non erano un'aggiunta ma l'obiettivo. Avalonia disegna l'interfaccia direttamente, senza motore di browser all'interno, cosicché un binario con il pannello completo pesa una frazione di ciò che peserebbe la stessa vista in Electron, e si avvia in una frazione di secondo.

A questo si aggiunge tutto ciò che un browser non ha mai dato: accesso reale al file system (punti ai file del server direttamente dal disco, senza caricarli prima in un browser), scorciatoie di sistema, notifiche native e un'icona nella barra delle applicazioni. Per chi sta nel pannello tutto il giorno, questa non è cosmesi ma un risparmio di tempo quotidiano.

Con un cuore che contiene il client API e una scocca su Avalonia, il tutto si assemblava in modo ripetibile. La cosa fondamentale era che un'unica sorgente producesse due binari autonomi, davvero testati su entrambi i sistemi, e non solo compilati per entrambi.

L'amministratore ottiene un programma che si avvia in una frazione di secondo, si tiene nella barra delle applicazioni come qualsiasi altra app e mostra esattamente i dati del pannello web - perché sotto è lo stesso codice e la stessa API. Le scorciatoie di sistema funzionano, i file sul disco si possono scegliere senza caricarli prima in un browser, la console e i log scorrono in diretta e la finestra non si perde in un groviglio di schede. Invece di una "pagina in una finestra", l'amministratore ottiene uno strumento che si sente parte del suo sistema.

Dal lato di Spectra il guadagno è altrettanto concreto e duraturo. Una sola logica e un solo client API invece di due tenuti a mano in accordo significano che sviluppare la piattaforma non si moltiplica per il numero di scocche. Una nuova regola di permessi, un nuovo endpoint nel backend o una modifica al modello del server atterra su web e desktop nello stesso commit. Un'intera classe di bug di sincronizzazione scompare, e il client desktop smette di essere un progetto separato da mantenere.

La cosa più importante, tuttavia, è che il desktop non è una "versione light". Dialoga con la stessa API frozcore/frozmod completa del pannello web, cosicché l'amministratore non deve mai tornare al browser per una funzione che mancava all'app - perché non ne mancava nessuna. Questa è la differenza tra una pagina impacchettata e un vero client di piattaforma nativo: quest'ultimo cresce con il backend invece di trascinarsi dietro di esso.