Il progetto adotta il nome «Rail Enterprise» ovunque (codice RailEnterprise.*, variabili RE_*, intestazioni RESV/RECL, immagine rail-enterprise-server) per allinearsi al repository Gitea. Aggiunge Gitea Actions sul modello di Chronos: CI su PR e main, rilascio da tag con gioco Windows (client Godot + server in server/), server Windows/Linux e immagine Docker nel registro Gitea, nightly. Aggiunge i riferimenti visivi 06–09, i modelli di PR e issue, l'ADR 0014 e aggiorna README (comandi locali), STATE e CLAUDE.md. 120 test verdi. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.0 KiB
ADR 0014 — Nuovo nome «Rail Enterprise», CI e rilasci su Gitea
Contesto
Il progetto è nato come «Via Ferrea» (guida v2). Il repository su Gitea si chiama già BalboSoft/Rail_Enterprise e il
proprietario ha deciso di adottare «Rail Enterprise» ovunque. Mancavano inoltre una CI sulle PR e una pipeline di
pubblicazione delle versioni: gioco desktop per Windows (.exe) e server in Docker. Le altre repository BalboSoft
(in particolare Chronos) usano Gitea Actions con act_runner in modalità Docker sullo stesso server di Gitea.
Decisione
Nome
- Testi, documenti e UI: «Via Ferrea» → «Rail Enterprise» (anche nella guida
docs/GUIDA.md, che resta la specifica vincolante: cambia solo il nome). - Codice: namespace, progetti, cartelle e assembly
ViaFerrea.*→RailEnterprise.*; soluzioneRailEnterprise.sln; strumentirailenterprise-tools; immaginerail-enterprise-server. - Variabili d'ambiente: prefisso
VF_→RE_(RE_PORT,RE_TOKEN,RE_DATA_DIR,RE_DIFFICULTY, …,RE_SERVER_PATH,RE_GAME_DATA); proprietà MSBuildVfServerOnly→ReServerOnly. - Formati binari: intestazioni
VFSV→RESV(salvataggi) eVFCL→RECL(registro dei comandi). Il gioco non è ancora stato rilasciato: i salvataggi di sviluppo precedenti non si leggono più e non è prevista migrazione. - Utente del container:
vf→rail. - Il vettore di prova di XxHash64 sulla stringa del nome è stato ricalcolato; gli altri vettori di riferimento (vuoto, «a», «abc», con seme) restano quelli pubblici e garantiscono la correttezza dell'implementazione.
CI (.gitea/workflows/ci.yml)
Su ogni PR e su ogni push su main: controllo zero NuGet, build Release con warning come errori, validazione dei dati,
test (sulle PR senza i test lunghi, su main la suite completa), compilazione incrociata del server per Windows,
compilazione C# del client Godot, build dell'immagine Docker con prova dell'healthcheck. Checkout con git (l'immagine
dell'SDK non ha Node.js, quindi niente azioni JavaScript), nessuna cache né artefatto.
Rilasci (.gitea/workflows/release.yml)
Un tag vMAJOR.MINOR.PATCH[-PRERELEASE] produce:
| File sulla release Gitea | Contenuto |
|---|---|
RailEnterprise-<v>-windows-x64.zip |
client Godot esportato (RailEnterprise.exe) con il server autonomo in server/ |
RailEnterprise-Server-<v>-windows-x64.zip |
server autonomo per Windows |
RailEnterprise-Server-<v>-linux-x64.tar.gz |
server autonomo per Linux |
docker-compose.yml, unraid-template.xml |
installazione del server |
SHA256SUMS |
somme di controllo |
e l'immagine gitea.encke-hake.ts.net/balbosoft/rail-enterprise-server:<v> (più :latest per le versioni stabili)
nel registro container di Gitea. La versione viene dal tag e sovrascrive Directory.Build.props (passata a MSBuild e
al Dockerfile con RE_VERSION). Il client si esporta con Godot .NET senza interfaccia scaricato dalla release ufficiale
(variabile GODOT_MIRROR per un mirror) nella versione di Godot.NET.Sdk del client.
nightly.yml pubblica ogni notte :nightly da main.
Segreti e variabili
REGISTRY_TOKEN(segreto di organizzazione, già presente): token di un utente con permesso di scrittura sui pacchetti; il token del workflow non può scrivere i pacchetti di un'organizzazione.- Facoltative:
PUBLIC_URL,REGISTRY,REGISTRY_USER,GODOT_MIRROR.
Flusso di lavoro
Rami claude/<argomento> o feature/<argomento>, PR verso main con il modello .gitea/PULL_REQUEST_TEMPLATE.md,
merge solo con la CI verde. Ogni lavoro ha una issue nel milestone della sua fase e nel progetto «Roadmap».
Conseguenze
- I comandi e le variabili cambiano nome: chi aveva un container con
VF_TOKENdeve passare aRE_TOKEN. - L'esportazione del client richiede che il runner raggiunga il sito di download di Godot (circa 1 GB fra editor e modelli a ogni rilascio, nessuna cache).
- Il client esportato non è firmato: Windows SmartScreen può chiedere conferma al primo avvio.