Files
Rail_Enterprise/docs/adr/0001-stack.md
T
Claude 290a1d886c F0: fondamenta della soluzione, script, documenti e harness di test
- ViaFerrea.sln con Core e Protocol (net10.0 + net8.0), Server, Tools, Tests
- Directory.Build.props con versione unica e warning come errori
- Script build/test/check-nuget/publish-image (+ build.ps1)
- Documenti: GUIDA, GDD, ARCHITECTURE, PROTOCOL (bozza), STATE, ADR 0001
- Harness di test interno con i primi test su Rng (xoshiro256**)
- Immagini di riferimento 01-05

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0191R7vXgtbAvSV4V8tj8uzL
2026-10-01 21:50:41 +00: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: ViaFerrea.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 ViaFerrea --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/ViaFerrea.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 viaferrea-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).