# 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).