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>
24 lines
2.2 KiB
Markdown
24 lines
2.2 KiB
Markdown
# 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).
|