- 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
2.2 KiB
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
- 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.0per compilare Core e Protocol anche per net8.0 senza scaricare pacchetti di riferimento). - Formato della soluzione:
ViaFerrea.slnclassico (non.slnx, che .NET 10 crea per default) per compatibilità con Godot e con gli strumenti più vecchi; si crea condotnet new sln -n ViaFerrea --format sln. - Target: Core e Protocol
net10.0;net8.0perché il client Godot 4.x compila per net8.0; Server, Tools e Tests solonet10.0. In Core e Protocol non si usano API successive a .NET 8. - 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, quindicheck-nuget.shescludeclient/. - Punti d'ingresso espliciti: i progetti eseguibili usano classi
static Maincon nome proprio (ServerProgram,ToolsProgram,TestProgram) invece delle istruzioni di primo livello, perché il progetto di test referenzia il server e due tipiProgramglobali entrerebbero in conflitto (CS0436 trattato come errore). - Harness di test: interno, in
tests/ViaFerrea.Tests/Harness, con esecuzione parallela dei test indipendenti; i test marcatiIsolatedgirano da soli, quelliSlowsi possono escludere con--skip-slow. - 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).