Files
Rail_Enterprise/docs/adr/0001-stack.md
T
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

2.2 KiB

ADR 0001 — Stack tecnologico

Stato: accettato (F0).

Contesto

La guida (sezioni 1 e 3) fissa C# 14 su .NET 10, ASP.NET Core come shared framework per il server, Godot 4 .NET per il client e il divieto di pacchetti NuGet. In fase di avvio vanno fissati alcuni dettagli che la guida lascia aperti.

Decisione

  1. SDK: .NET SDK 10.0.1xx. Nell'ambiente di sviluppo cloud è installato dai repository Ubuntu 24.04 (dotnet-sdk-10.0, più dotnet-targeting-pack-8.0 per compilare Core e Protocol anche per net8.0 senza scaricare pacchetti di riferimento).
  2. Formato della soluzione: RailEnterprise.sln classico (non .slnx, che .NET 10 crea per default) per compatibilità con Godot e con gli strumenti più vecchi; si crea con dotnet new sln -n RailEnterprise --format sln.
  3. Target: Core e Protocol net10.0;net8.0 perché il client Godot 4.x compila per net8.0; Server, Tools e Tests solo net10.0. In Core e Protocol non si usano API successive a .NET 8.
  4. Godot: versione stabile più recente pubblicata, 4.7.2. Il client usa Godot.NET.Sdk/4.7.2; è l'unica dipendenza esterna ammessa e sta fuori dalla soluzione principale, quindi check-nuget.sh esclude client/.
  5. Punti d'ingresso espliciti: i progetti eseguibili usano classi static Main con nome proprio (ServerProgram, ToolsProgram, TestProgram) invece delle istruzioni di primo livello, perché il progetto di test referenzia il server e due tipi Program globali entrerebbero in conflitto (CS0436 trattato come errore).
  6. Harness di test: interno, in tests/RailEnterprise.Tests/Harness, con esecuzione parallela dei test indipendenti; i test marcati Isolated girano da soli, quelli Slow si possono escludere con --skip-slow.
  7. Strumenti: l'eseguibile dei Tools si chiama railenterprise-tools (AssemblyName), come nei comandi della guida.

Conseguenze

  • Build e test non richiedono rete dopo l'installazione dell'SDK: nessun restore da feed esterni.
  • Se Godot passa a net9.0 o net10.0 basta allineare il TargetFramework del client; Core e Protocol restano compatibili verso il basso.
  • Il divieto di API post-.NET 8 in Core va ricordato nelle revisioni (il build net8.0 lo fa rispettare in automatico).