Files
Rail_Enterprise/CLAUDE.md
T
Alby96andClaude Opus 5.5 c1a0049bcf
CI / Build e test (pull_request) Successful in 1m20s
CI / Immagine Docker (pull_request) Successful in 37s
Infrastruttura: nome «Rail Enterprise», CI e rilasci su Gitea, documentazione
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>
2026-11-07 11:14:54 +01:00

3.0 KiB
Raw Blame History

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 PackageReference in 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 in data/schema/).
  • Simulazione deterministica: solo Rng (xoshiro256**) con Fork, niente Random/Guid.NewGuid/DateTime.Now/Environment.TickCount, niente iterazione di Dictionary/HashSet per produrre effetti, funzioni trascendenti solo da DMath, denaro in Money (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.md aggiornato, commit F<n>: <cosa>.
  • Nuovi test nel harness interno ([Test], Assert), un file per area in tests/RailEnterprise.Tests/<Area>/.
  • I test lunghi si marcano [Test(Slow = true)].

Gitea, CI e rilasci

  • Repository BalboSoft/Rail_Enterprise su Gitea (gitea.encke-hake.ts.net, in LAN 192.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 main con .gitea/PULL_REQUEST_TEMPLATE.md, merge con la CI verde.
  • .gitea/workflows/ci.yml (PR e main), release.yml (tag vX.Y.Z: gioco Windows + server + immagine Docker), nightly.yml. Segreto di organizzazione REGISTRY_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 (vedi docs/ARCHITECTURE.md).
  • src/RailEnterprise.Protocol — frame e messaggi (vedi docs/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).