Files
Rail_Enterprise/docs/adr/0014-nome-ci-e-rilasci.md
Alby96andClaude Opus 5.5 c1a0049bcf
CI / Build e test (pull_request) Successful in 1m20s
CI / Immagine Docker (pull_request) Successful in 37s
Infrastruttura: nome «Rail Enterprise», CI e rilasci su Gitea, documentazione
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>
2026-11-07 11:14:54 +01:00

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.*; soluzione RailEnterprise.sln; strumenti railenterprise-tools; immagine rail-enterprise-server.
  • Variabili d'ambiente: prefisso VF_ → RE_ (RE_PORT, RE_TOKEN, RE_DATA_DIR, RE_DIFFICULTY, …, RE_SERVER_PATH, RE_GAME_DATA); proprietà MSBuild VfServerOnly → ReServerOnly.
  • Formati binari: intestazioni VFSV → RESV (salvataggi) e VFCL → 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_TOKEN deve passare a RE_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.