Files
Alby96andClaude Opus 5.5 3d394c01d3 F6: bilanciamento con i bot su simulate
Banco di prova ripetibile per tarare l'economia (ADR 0025, obiettivi O1–O14
scritti prima della taratura):

- railenterprise-tools balance: semi × difficoltà × bot × anni in parallelo,
  rapporto deterministico (rapporto.txt con gli obiettivi, anni/mesi/prezzi/
  esecuzioni.csv, tempi.txt); simulate --bot <id>.
- Bot giocatore (PlayerBot): l'agente delle IA con le personalità di
  ai.json → bots guida la compagnia del giocatore; pianifica per primo; non
  è salvato né nell'hash, il formato dei salvataggi non cambia.
- Le IA usano la compravendita in proprio (supera ADR 0016 §9) con una regola
  mensile deterministica e parametri in ai.json → trading.
- Agente corretto: un trasformatore è fonte solo con gli input alimentati
  (prima i bot fallivano su linee rimaste senza merce finite le scorte
  iniziali); la linea dei ricambi di una rete nuova esce dal budget iniziale
  se l'utile la ripaga entro planning.partsDeferYears.
- Dati: market.world volumeShare 0,5 → 1,0 ed elasticity 1,0 → 2,5;
  townBonus 1,8 → 3,0, townRoiFactor 0,5 → 0,35.

Matrice predefinita (72 esecuzioni da 12 anni, 533 s): obiettivi da 5 a 9
su 14; livello 2 del bot competente in «Imprenditore» al 4° anno (prima 7°),
nessun fallimento dei bot in «Apprendista» e «Imprenditore», prezzi medi tra
0,77 e 1,42 volte il base (prima 0,38–2,78). Restano aperti O7–O11.

EconomyTests.PriceRisesWhenDemandExceedsSupply: la soglia passa da 1,5 a
1,25 volte in 120 giorni perché il mondo a volume pieno ed elasticità 2,5
assorbe parte dello squilibrio (aumento misurato ~1,36). Accettazioni F2, F4
e F5 invariate e verdi; 222 test verdi.

Refs #47.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-08 16:30:31 +01:00

3.0 KiB
Raw Permalink 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, balance, 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).