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>
3.0 KiB
3.0 KiB
CLAUDE.md — Rail Enterprise
Gestionale ferroviario dall'alto: motore headless in C# (.NET 10), server ASP.NET Core in Docker, client Godot 4 .NET.
La specifica vincolante è docs/GUIDA.md; lo stato dei lavori è in docs/STATE.md. Leggili entrambi a inizio sessione.
Comandi
scripts/build.sh # check-nuget + build Release della soluzione
scripts/test.sh [filtri] # build + validate-data + tutti i test (--skip-slow, --serial)
dotnet run --project tests/RailEnterprise.Tests -- --list
dotnet run --project src/RailEnterprise.Tools -- <comando> # validate-data, genmap, profile, simulate, bench, replay
Regole non negoziabili
- Zero
PackageReferencein tutta la soluzione (scripts/check-nuget.sh). Unica eccezione: l'SDK Godot nel client. - Identificatori in inglese; commenti, documentazione e testi UI in italiano.
- Nessun numero magico nella simulazione: i parametri stanno in
data/*.json(con schema indata/schema/). - Simulazione deterministica: solo
Rng(xoshiro256**) conFork, nienteRandom/Guid.NewGuid/DateTime.Now/Environment.TickCount, niente iterazione diDictionary/HashSetper produrre effetti, funzioni trascendenti solo daDMath, denaro inMoney(centesimi). - Core e Protocol compilano anche per net8.0 (client Godot): niente API successive a .NET 8 lì.
- Il client non contiene logica di gioco; il server è autorevole.
- Ogni decisione non coperta dalla guida →
docs/adr/NNNN-titolo.md.
Flusso di lavoro
- Una fase alla volta (sezione 16 della guida). Fine fase: build verde, test verdi,
docs/STATE.mdaggiornato, commitF<n>: <cosa>. - Nuovi test nel harness interno (
[Test],Assert), un file per area intests/RailEnterprise.Tests/<Area>/. - I test lunghi si marcano
[Test(Slow = true)].
Gitea, CI e rilasci
- Repository
BalboSoft/Rail_Enterprisesu Gitea (gitea.encke-hake.ts.net, in LAN192.168.30.23:3000). Il progetto si chiamava «Via Ferrea»: il nome attuale è «Rail Enterprise» ovunque (ADR 0014). - Ogni lavoro ha una issue nel milestone della sua fase (F0…F7, «Infrastruttura») e nel progetto «Roadmap»; PR verso
maincon.gitea/PULL_REQUEST_TEMPLATE.md, merge con la CI verde. .gitea/workflows/ci.yml(PR e main),release.yml(tagvX.Y.Z: gioco Windows + server + immagine Docker),nightly.yml. Segreto di organizzazioneREGISTRY_TOKEN.- La Wiki su Gitea (guida del giocatore, schermate) si aggiorna quando cambia l'interfaccia.
Mappa del codice
src/RailEnterprise.Core— Common, Time, Data, Map, Economy, Rail, Commands, Simulation, Persistence (vedidocs/ARCHITECTURE.md).src/RailEnterprise.Protocol— frame e messaggi (vedidocs/PROTOCOL.md).src/RailEnterprise.Server— GameLoop, sessioni WebSocket, API HTTP.src/RailEnterprise.Tools—railenterprise-tools.client/RailEnterprise.Client— progetto Godot.reference/— immagini di riferimento visivo vincolanti (01–09: mappa, binari, treni, edifici, palette, mercato, industria, scalata, connessione).