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>
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, balance, 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).