Files
Rail_Enterprise/docs/STATE.md
T
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

53 KiB
Raw Blame History

Rail Enterprise — Stato dei lavori

Aggiornato alla fine di ogni fase (guida, sezione 18).

Versioni degli strumenti

Strumento Versione Note
.NET SDK 10.0.112 (cloud), 10.0.403 (Windows) da apt (Ubuntu 24.04, dotnet-sdk-10.0); su Windows dall'installer
Runtime .NET / ASP.NET Core 10.0.12
Targeting pack net8.0 8.0.31 dotnet-targeting-pack-8.0, per Core e Protocol
Godot .NET 4.7.2.stable.mono scaricato dal mirror SourceForge (github.com non raggiungibile); client compilato con Godot.NET.Sdk 4.7.2 da NuGet
Docker 29.6.2 (CLI e demone) demone avviato a mano nell'ambiente cloud; immagini di base da mcr.microsoft.com
Xvfb + Mesa (llvmpipe) 21.1.12 / 25.2.8 rendering software per il collaudo grafico del client
Sistema Ubuntu 24.04.4 LTS x86_64, 4 core, 15 GB

Fatto

F0 — Fondamenta

  • Soluzione RailEnterprise.sln con Core, Protocol (net10.0 + net8.0), Server (Web SDK), Tools (railenterprise-tools), Tests.
  • Directory.Build.props con Nullable, ImplicitUsings, LangVersion latest, warning come errori, globalizzazione invariante, build deterministica, versione unica (0.1.0).
  • Script: build.sh, build.ps1, test.sh, check-nuget.sh, publish-image.sh.
  • Documenti: GUIDA, GDD, ARCHITECTURE, PROTOCOL (bozza), STATE, ADR 0001.
  • Harness di test interno ([Test], Assert, esecuzione parallela, filtri, --skip-slow).

F1 — Economia headless

  • Base: Rng (xoshiro256** con Fork), Money (centesimi, formati italiani), 20 identità tipizzate, DMath deterministica (ADR 0003), XxHash64, Vec2, Calendar/GameClock/GameDate.
  • Dati: 12 file data/*.json (16 beni con ricambi e macchinari, 14 industrie, 13 veicoli, 4 ere, 5 livelli, 4 difficoltà; costruzione, manutenzione, IA, contratti, regioni) con 12 schemi in data/schema/; caricamento con source generator, validatore di schema interno, deserializzazione rigorosa, validazione semantica, hash dei dati (ADR 0002). railenterprise-tools validate-data.
  • Mappa: generatore deterministico (rilievo con domain warping, mare, priority-flood, fiumi larghi 1–4 celle, laghi, copertura, giacimenti con riserva, città, porto e valico, 14 tipi di industria) e railenterprise-tools genmap con BMP di controllo (ADR 0005).
  • Economia: città (domanda con elasticità, soddisfazione per categoria, servizi, crescita, migrazione, espansione), industrie (efficienza dalle coperture, fattore di profitto, condizione, esaurimento giacimenti, salari, crescita trimestrale delle industrie servite, chiusure, nascita per capacità mancante), hub, mercato con componente mondiale e shock, prezzi locali, tariffe, lavoratori in sede e a piedi, trasporto locale su strada, registro a partita doppia, prestiti e rating, difficoltà applicata (ADR 0004).
  • Comandi: TakeLoan, RepayLoan, SetIndustryPolicy; gli altri tipi esistono e rispondono NotImplemented.
  • Persistenza: SaveFile (intestazione + Brotli), WorldSerializer con rimappatura per id, StateHasher giornaliero (ADR 0006).
  • railenterprise-tools simulate con KPI annuali in CSV (separatore ;).
  • 45 test: dati, determinismo, round-trip dei salvataggi, invarianti di merci e denaro, limiti dei prezzi, crescita e chiusura delle industrie, città, prestiti, collocazione e distanze della mappa, tempi di generazione.

F2 — Rete ferroviaria realistica headless

  • Tracciato: TrackGeometry (raccordi al raggio minimo della classe), TrackPlanner (profilo a 25 m, inviluppi di pendenza in avanti e all'indietro, smussatura, rilevati, trincee, ponti e gallerie, ponte obbligatorio su acqua, palude e binari altrui, campate per classe di fiume, limiti per era, costi, giorni di cantiere, esproprio), railenterprise-tools profile con CSV.
  • Rete: RailNetwork con agganci e scambi, stazioni con bacino, depositi, segnali, cantieri con squadre per livello, rinnovi e ammodernamenti, usura e manutenzione del binario, ispezioni e invecchiamento di ponti e gallerie (ADR 0007).
  • Treni: acquisto e vendita di veicoli, composizioni, linee con ordini (carica, scarica, attendi il pieno con tempo massimo), A* con vincolo di svolta, blocchi e versi fino al punto sicuro, fisica con aderenza e Stalled, soste proporzionali alle unità movimentate.
  • Pacchetti e linee: LineGraph per compagnia con maschere dei carichi, capacità e durata dei giri; ritiro della produzione verso la destinazione migliore, trasbordi, consegna in attesa del consumatore, tariffe merci e passeggeri, costi di esercizio (ADR 0008).
  • Pendolarismo su rotaia: abbinamento mensile entro 60/90 minuti con i tratti a piedi, quote proporzionali ai lavoratori liberi, capacità residua delle linee, pacchetti giornalieri di andata e ritorno, coperture, scioglimento dei contratti e insoddisfazione «lavoro».
  • Salvataggi: tutto lo stato ferroviario (rete, cantieri, veicoli, treni in movimento, linee, pacchetti, contratti) entra nel salvataggio e nell'hash.
  • Scenario tests/RailEnterprise.Tests/scenarios/valdoria.json e test di accettazione: tracciato diretto rifiutato per gMax; valico con trincea e ponte accettato a 2,5 volte il costo in piano e 180 giorni di cantiere; con tre linee (merci, lavoratori, personale) l'acciaieria passa dal 20 % a oltre l'80 % di media mensile in tre mesi, senza stalli.
  • railenterprise-tools bench --trains 2000: rete di 300 linee a doppio binario costruita con i comandi.
  • 75 test (dati, mappa, economia, persistenza, pianificatore, rete, treni, incroci senza stallo, Stalled, salvataggio con treni in moto, pendolarismo, scenario Valdoria).

F3 — Server e client minimo

  • Protocollo (RailEnterprise.Protocol, normativo in docs/PROTOCOL.md): SpanWriter/SpanReader, frame, tutti i messaggi dei due versi e i 38 comandi (record definitivi in Core anche per le fasi future), byte di estensione, test di round-trip, troncamento e corruzione (ADR 0009).
  • ClientWorld e ProtocolClient condivisi da client, test e strumenti; TrackPreview in Core: anteprima del client e piano del server con lo stesso codice (PreviewMismatch se differiscono).
  • Server: GameHost con ciclo su thread dedicato, velocità e slow, sessioni WebSocket con backpressure e ripresa, snapshot e delta per hash, TrackWorks a lotti, chunk del viewport, moto dei treni, resoconti giornalieri e mensili, /health, /metrics, /api/saves, autosave a rotazione, log JSON, --local, --healthcheck.
  • Docker: docker/Dockerfile, docker-compose.yml, unraid-template.xml; immagine costruita e provata (health, metriche, healthcheck interno, utente non root).
  • Registro dei comandi (--record / RE_RECORD, con salvataggio di partenza) e railenterprise-tools replay con confronto dell'hash; railenterprise-tools smoke per collaudare un server in esecuzione.
  • Client Godot 4.7 .NET: menu, collegamento, partita locale con server figlio, mappa con terreno (fasce, ombreggiatura, sponde, curve di livello), opere, entità, alberi, treni interpolati con fumo; strumenti binari (scatto a 45°, quota, ponti e gallerie, classe, profilo con opere, costo e giorni), stazione, deposito, segnali, demolizione; pannelli treni, linee, mercato, finanze, schede; barra superiore con velocità, minimappa, notiziario; italiano e inglese.
  • Accettazione F3 verificata senza intervento umano: test in processo (linea con ponte via WebSocket, anteprima identica al server, scarto client/server sotto 1 cm), railenterprise-tools smoke contro il container Docker (ponte di 275 m, scarto 0,00 m) e pilota automatico del client Godot con schermate (docs/screenshots/).
  • 85 test.

F4 — Pendolarismo e manutenzione dei treni

  • Manutenzione della flotta (FleetMaintenanceSystem, formule in Fleet, ADR 0010): usura giornaliera per componente in km di servizio (wear.distanceScale = 30 km per km simulato) con pendenza, alta velocità, carico, età e difficoltà; rischio di guasto del componente più esposto; guasti lievi (velocità dimezzata fino al deposito), gravi (fermo in linea con soccorso dal deposito o da una riserva, poi rimorchio) e deragliamenti (carico perso, binario chiuso tre giorni, notizia e insoddisfazione); effetti su velocità, consumo, comfort e rivendita.
  • Interventi (ispezione, tagliando, revisione, riparazioni, ricostruzione) con costi e ricambi per veicolo, effetti scalati dalla politica; officine con stalli in ordine d'arrivo, lavori che aspettano i ricambi occupando lo stallo e ritmo ridotto senza personale; politiche per flotta, linea e treno; pianificatore predittivo (scadenze della politica e stima del giorno a condizione 40) con scelta del deposito raggiungibile e con ricambi; treni di riserva che coprono le linee durante gli interventi lunghi; avvisi sotto 40 e 30 e per ricambi esauriti.
  • Ricambi via treno: depositi consumatori di spare_parts nel bacino delle stazioni, scorta desiderata (OrderParts), importazione dagli hub verso la stazione con più bisogno.
  • Pendolarismo completo: depositi come posti di lavoro (personale e operai per stallo), motivi dei posti scoperti nel Registro degli impieghi, convenzioni CommuteAgreement proposte dalle industrie (canone, copertura, rottura con penale) con i comandi Accetta e Rifiuta.
  • Comandi attivi: SetReserve, SetMaintenancePolicy, ScheduleService, OrderParts, AcceptAgreement, RejectAgreement.
  • Circolazione: inversione di marcia in un nodo intermedio come sosta tecnica e transito in stazione che libera l'arco d'arrivo (due stalli trovati con i viaggi verso le officine).
  • Salvataggio: corpo versione 2 con sezione di manutenzione e migrazione dei salvataggi F3.
  • Protocollo: riepilogo di manutenzione nei record (blocco 1), RequestDetail (10), MaintenanceCard (124), WorkshopRegister (125), EmploymentReport con depositi, motivi e convenzioni, MaintenanceAlert dagli avvisi.
  • Client: pannelli «Officine» (politica della flotta, avvisi, flotta per condizione, cartella di manutenzione con componenti e storico, Registro officina, scorta di ricambi, mappa di calore della condizione) e «Impieghi» (Registro degli impieghi con convenzioni da accettare o rifiutare); schede di treno, industria e città con i dati nuovi; schermate in docs/screenshots/f4-*.jpg.
  • Test di 14.5 su manutenzione (rischio monotono, usura monotona nei fattori, condizione che non sale senza interventi, tagliando/revisione/ispezione con la condizione attesa, pianificatore sopra 30 con politica Standard e ricambi) e pendolarismo; guasto grave con soccorso e riserva, deragliamento, ricambi dal porto, politiche, salvataggio a metà officina, convenzioni, registro, dettagli via WebSocket.
  • Accettazione F4 (rete di Valdoria con officina a Valdoria e due treni per linea): senza la linea dei ricambi la flotta scende sotto 40 al giorno 697 con 12 guasti (19,5 per milione di km di servizio); con la linea dal Porto di Levante resta sopra 73 con 3 guasti (3,2 per milione di km).
  • 102 test.

F5 — Industrie, IA, borsa e scalate

  • Manutenzione degli impianti (sezione 11, ADR 0011): usura giornaliera con efficienza, intensità e difficoltà, recupero dal budget (dimezzato senza ricambi), fermi sotto 40 con storico e insoddisfazione della città vicina, incidenti gravi sotto 10 per trasformazione e manifattura, revisione e ammodernamento programmabili; ricambi e macchinari come domanda esplicita dell'industria (in treno, dal trasporto locale e per trasbordo nel bacino di una stazione servita); politica dei privati.
  • Industrie possedute: BuyIndustry dal livello 3 con prezzo chiesto (attivi, condizione, utile, cassa), cassa di riserva, surplus e perdite al proprietario (voce «Industrie»), SetIndustryPolicy, OverhaulIndustry, UpgradeIndustry e OrderParts per l'industria.
  • Livelli (Tiers): patrimonio netto, città collegate sopra una soglia di abitanti e rating, soglie ritarate in tiers.json; ritaratura economica di costi di costruzione, manutenzione e tariffe misurata con le IA (ADR 0011 §7).
  • Borsa e società (sezione 12.2–12.3, ADR 0012): libro dei soci, prezzo da patrimonio e utili con sentiment ciclico, ordini con spread e limite, quotazione dal livello 4, aumento di capitale, riacquisto, dividendi ordinari e straordinari, controllo oltre il 50 % con quota dell'utile al controllante, fusione (MergeCompany, comando 39), offerte pubbliche condizionate con adesione del flottante, risposte delle compagnie azioniste e tre difese, esiti per difficoltà (amministrazione controllata, fine partita), aste degli attivi delle IA fallite, nuovi concorrenti quando una compagnia domina i ricavi, GameOver con osservatore e Cronaca finale con prestigio.
  • Agenti IA (sezione 12.1, ADR 0013): pianificazione mensile con candidati (merci e pendolari), regioni collegabili, Dijkstra a 8 direzioni con pendenze, fiumi e ostacoli, semplificazione che non taglia ostacoli, TrackPreview, ROI con soglia della personalità; esecuzione con gli stessi comandi del giocatore (stazioni, binario, deposito, linea, treni), treni aggiuntivi, linee dei ricambi, rimedio agli stalli di capacità, liquidità, rimborso dei prestiti, borsa (partecipazioni, offerte, adesioni, difese, fusioni); tre personalità (Espansiva, Prudente, Predatoria). railenterprise-tools simulate --trace-ai con riepilogo per compagnia.
  • Salvataggio: corpo versione 3 con sezione societaria (libro dei soci, storici, offerte, aste, stato degli agenti, fine partita) nell'hash; migrazione dei salvataggi F4.
  • Protocollo: prezzi e offerte nei record (blocco 1), CompanyCard (126), IndustryCard (127), Chronicle (128), RequestDetail per compagnia, industria e cronaca, MergeCompany e campi nuovi di OrderParts e RespondBid (blocco 1 dei comandi).
  • Server: listino quotidiano, schede di compagnia e industria su richiesta, Cronaca una volta per sessione a fine partita.
  • Client: pannelli «Borsa» (listino, offerte, schede delle compagnie con soci e storico, comandi di compravendita, quotazione, offerte e difese) e scheda del proprietario dell'industria (condizione, fermi, budget, revisione, ammodernamento, acquisto), Cronaca finale; schermate in docs/screenshots/f5-*.jpg.
  • Test di 14.5: manutenzione delle industrie (usura, fermi, ricambi, revisione, acquisto), borsa (prezzo, quotazione, controllo e fusione, scalata riuscita, esiti per difficoltà, asta dell'IA fallita, salvataggio dello stato societario), IA (comandi rifiutati ≤ 5 %, IA con capitale ×2 sopra il giocatore passivo in 10 anni, determinismo con le IA anche passando da un salvataggio).
  • Accettazione F5 (OnMagnateAnAiReachesTierThreeIn15Years, seme 7, 128 km, «Magnate», giocatore passivo): la Società Ferroviaria Adriatica arriva al livello 3 nel 1863 (13 anni) con ₤ 2,7 milioni di patrimonio, rating BBB e 3 città sopra 1.000 abitanti collegate.
  • 120 test.

Infrastruttura — nome, CI e rilasci (novembre 2026)

  • Nuovo nome «Rail Enterprise» ovunque: namespace e progetti RailEnterprise.*, RailEnterprise.sln, railenterprise-tools, variabili RE_*, intestazioni dei file RESV/RECL, immagine rail-enterprise-server (ADR 0014).
  • Gitea Actions: ci.yml (PR e main: zero NuGet, build, dati, test, server Windows, client, immagine con healthcheck), release.yml (tag v*: gioco desktop Windows con server in server/, server Windows e Linux, SHA256SUMS, immagine :<versione> e :latest), nightly.yml (:nightly).
  • Modelli di PR e issue in .gitea/; issue, milestone F0–F7 e progetto «Roadmap» su Gitea con tutto il lavoro svolto; Wiki con guida e schermate.
  • Immagini di riferimento 06–09 aggiunte in reference/.
  • Primo rilascio v0.5.0 (7/11/2026): CI verde, release Gitea con server Windows/Linux e immagine rail-enterprise-server:0.5.0/latest; collaudo smoke contro il server reale superato (ponte di 175 m, scarto 0,00 m). Il gioco desktop di v0.5.0 però parte senza codice C#: mancava la soluzione client/RailEnterprise.Client/RailEnterprise.Client.sln che Godot richiede per esportare. Aggiunta la soluzione e un controllo che fa fallire il rilascio senza assembly; correzione in v0.5.1.
  • v0.5.1 (7/11/2026): il gioco desktop scaricato dalla release funziona. Il pilota automatico (RailEnterprise.exe -- --autopilot <cartella>) avvia il server incluso, costruisce linea, ponte e treni e salva le 17 schermate; esce con codice 0. Restava un difetto: strings.csv non era nel gioco esportato (avviso «Traduzioni non trovate», inglese assente), corretto con l'importatore «keep».
  • Test instabile sotto carico (issue #24): BuildLineWithBridgeOverTheNetworkAndWatchTheTrain (scarto 884 m una volta sul runner). Causa nel test: TestClient.WaitUntil ingoiava il tempo scaduto (ContinueWith(_ => true)), quindi se il moto dell'ultimo tick non arrivava in 10 s il test confrontava un moto vecchio (il run fallito durò 19 s invece di 7). Il moto non arriva quando la pausa coglie il treno fermo: il server rimanda solo i moti dei treni in marcia. Ora WaitUntil fa fallire il test allo scadere e la pausa si ripete finché il treno è in marcia; 24 esecuzioni dei test del server su 24 verdi con 8 processi in parallelo.
  • MaintenanceDetailsOnRequest falliva a volte per un difetto del test: leggeva il registro degli impieghi che il server manda da solo a inizio mese (giorno 0, prima dell'officina) invece della risposta alla richiesta; in locale falliva 2 volte su 4, dopo la correzione 6 su 6 verdi.
  • v0.6.0 (7/11/2026): prima versione con i pezzi della F6: Mercato globale (ADR 0015), compravendita in proprio (ADR 0016) ed eventi del mondo (ADR 0017). Il gioco scaricato dalla release passa il pilota automatico (18 schermate, codice 0): il pannello «Mercato globale» si disegna come l'immagine 06, con storico, previsione e banda, offerta, domanda, scorte, «Dove conviene vendere», hub, evento e riquadro della compravendita bloccato al livello 1 (docs/screenshots/f6-mercato-globale.jpg). Il riquadro «Eventi in corso» non compare nelle schermate perché nei primi tre mesi della partita del pilota non scatta nessun evento.

In corso

F6 — Economia completa, eventi, rifinitura

  • Mercato globale (issue #29, ADR 0015):
    • storico dei prezzi a 24 mesi (market.historyDays 720); i salvataggi con lo storico di 360 giorni si migrano al caricamento con RollingWindow.Extended, senza cambiare formato;
    • MarketOutlook (Core, sola lettura): storico mensile (un campione per mese di calendario), variazione a 30 giorni, offerta e domanda mensili con la quota mondiale, scorte in mesi, indice materie prime, previsione a 4 mesi dalla componente mondiale con banda, «Dove conviene vendere» (industrie al prezzo locale dell'ADR 0004 e hub) con la linea che collega, hub, evento in corso, avanzamento verso la compravendita in proprio; parametri in balance.json (market.outlook);
    • protocollo: DetailKind.Market (7) e MarketReport (129); server: quadro su richiesta;
    • client: pannello «Mercato globale» a tutto schermo come l'immagine 06 (beni, storico e previsione nel grafico, offerta, domanda, scorte, vendite, hub con «Pianifica la linea», evento, compravendita in proprio); schermata 16_mercato nel pilota automatico;
    • test: finestra allungata, migrazione di un salvataggio a 360 giorni, storico mensile, previsione deterministica ed entro i limiti, evento, analisi su Valdoria (linea che collega, ordine delle vendite, indice, commercio, nessun effetto sull'hash), round-trip di MarketReport, quadro via WebSocket. 126 test (120 senza i lenti).
  • Compravendita in proprio (issue #31, ADR 0016):
    • magazzino della compagnia in ogni sua stazione (Station.Stock), capacità e giacenza mensile in balance.json (trading: 500 unità, 25 centesimi per unità al mese sulla voce «Commercio»); la merce in magazzino entra nell'invariante «merci» e nelle scorte del Mercato globale; una stazione con merce in magazzino non si demolisce, con la liquidazione la merce si perde;
    • BuyGoods (23): dai produttori del bacino al prezzo locale marginale (ADR 0004 §3, unità per unità, dal più economico) e dagli hub al prezzo d'importazione entro la capacità; SellGoods (24): ai consumatori del bacino (dal prezzo più alto, entro lo spazio dell'input e la loro cassa) e agli hub al prezzo d'esportazione; denaro sul registro, rifiuti in italiano per livello, stazione, merce, era, prezzo, cassa, magazzino pieno;
    • ShipGoods (40): pacchetti di merce propria (Packet.Owned) senza tariffa né consumatore, instradati sulle linee come gli altri ed entrati nel magazzino di destinazione; lo spazio di destinazione si riserva alla partenza (rifiuto se pieno), senza percorso il comando si rifiuta; i pacchetti esistenti non cambiano (accettazione F4 invariata: 35 / 20 guasti senza la linea, 75 / 2 con la linea);
    • salvataggio: corpo versione 4 (TradingSerializer), migrazione delle versioni 1–3 con i magazzini vuoti, magazzini e merce propria nell'hash;
    • protocollo: comando 40, blocco 1 di MarketReport con i magazzini e le quotazioni della prossima unità; client: riquadro «Compravendita in proprio» del Mercato globale (stazione, quantità, Compra, Vendi, Spedisci a, giacenze; tetto e minimo al 10 % dal prezzo mostrato), testi in strings.csv;
    • le IA non commerciano ancora (ADR 0016 §9);
    • correzioni della revisione: la merce propria segue i flag carico/scarico delle fermate (LineGraph con stopFlags), la scadenza riparte al trasbordo, ricalcolo giornaliero del tratto in attesa, scarico della merce a bordo dei treni che lasciano la linea o il cui tratto non è più sulla linea, niente demolizione con merce propria in partenza o in arrivo, merce propria nel valore contabile al prezzo globale, vendita e spedizione senza lo sblocco del livello (solo l'acquisto lo richiede), stazione di arrivo predefinita diversa dalla partenza nel riquadro;
    • test (Economy/TradingTests.cs, 17): acquisto dal produttore e dall'hub, vendita al consumatore e all'hub, rifiuti senza effetti, spedizione senza tariffa, un anno di commercio con gli invarianti, determinismo e salvataggio con merce in magazzino e in viaggio, migrazione dalla versione 3, magazzini nel quadro del mercato, round-trip del comando 40, flag delle fermate, treno tolto dalla linea, linea modificata con la merce a bordo, scadenza al trasbordo, demolizione bloccata, valore contabile. 143 test (126 senza i lenti).
  • Eventi del mondo (issue #33, ADR 0017):
    • catalogo data/events.json con schema e validazione (effetti compatibili con il bersaglio): incidente e boom di un'industria, fiera ed epidemia in una città, boom e crollo della domanda di un bene nella zona di una città, maltempo su un'area (treni più lenti, usura del binario più rapida), sciopero dei lavoratori di una città o del personale di un deposito; probabilità annua per mappa × eventFrequencyMultiplier della difficoltà (0,7 / 1,0 / 1,2 / 1,4; 0 li disattiva), al massimo 6 eventi insieme, nessun doppione dello stesso tipo sullo stesso bersaglio;
    • effetti come moltiplicatori letti da un'unica sorgente (World.WorldEvents): capacità delle industrie (produzione e domanda di input), consumi delle città, presenze dei pendolari, velocità dei treni e usura del binario; a evento finito tutto torna come prima;
    • EventSystem tra le IA e l'hash, flusso pseudo-casuale dedicato «events», bersaglio in ordine di id, notizie d'inizio e di fine in italiano (EventKind.World = 10); EventSystem.Force per test e scenari;
    • salvataggio: corpo versione 5 (EventSerializer) con gli eventi attivi nell'hash e la frequenza nelle impostazioni; le versioni 1–4 si caricano senza eventi e con la frequenza del preset;
    • protocollo: blocco 1 di DailyDigest con gli eventi in corso (WorldEventInfo), blocco 2 di MarketReport con quelli sulla domanda di un bene; client: riquadro «Eventi in corso» sopra la minimappa, avvisi nelle schede di industria e città e nel Registro officina, «evento in corso» nel Mercato globale, notizie degli eventi sempre nel notiziario, testi in strings.csv (corretta anche una chiave con la virgola non tra virgolette);
    • scenari: campo facoltativo eventFrequencyMultiplier; valdoria.json lo mette a 0, così l'accettazione F2 e F4 resta invariata (35 / 20 guasti senza la linea, 75 / 2 con la linea). Con gli eventi a frequenza «Imprenditore» la rete senza linea si fermava a 41 con 10 guasti e il criterio «sotto 40 entro 3 anni» non valeva più (ADR 0017 §8);
    • le IA non reagiscono agli eventi: ne subiscono gli effetti attraverso i sistemi, ma stimano i candidati sui valori senza eventi (domanda delle città, posti scoperti, efficienza delle industrie di trasformazione; ADR 0017 §9);
    • correzioni della revisione: un evento è in vigore nei giorni [inizio, fine) per tutti (sistemi giornalieri, treni a ogni tick, usura del traffico del giorno prima) ed esce dall'elenco il mattino del primo giorno libero con la notizia di fine; nessuna sovrapposizione di zone tra due maltempi o tra due eventi sulla domanda dello stesso bene; {until} è l'ultimo giorno; client: conto alla rovescia dalla durata a 1 e «da domani» per gli eventi estratti oggi, avviso anche nelle città della zona e nel Registro officina del deposito, notiziario senza doppioni (dal resoconto solo le notizie di fine, le altre arrivano come Notification);
    • test (Simulation/EventTests.cs, 19): catalogo e validazione, effetti di ogni tipo e loro fine, solo la zona per domanda e maltempo, treni rallentati, officina senza personale, durata, niente doppioni né zone sovrapposte, giorni del maltempo per treni, usura e resoconto con il conto alla rovescia, presenti senza eventi per l'IA, frequenza 0, stesso seme stessi eventi, salvataggio con eventi attivi, migrazione dalla versione 4, un anno di eventi frequenti con gli invarianti (lento), eventi nel DailyDigest e nel MarketReport. 162 test (144 senza i lenti).
  • Livelli e sblocchi visibili, «La tua scalata» (issue #38, ADR 0018):
    • ClimbOutlook (Core, sola lettura): livelli con gli sblocchi letti dai dati (Tiers.NewUnlocks: fido, squadre di cantiere, compravendita, acquisto di industrie, quotazione, scalate, concessioni), quando sono stati raggiunti, requisiti del prossimo livello con valore, soglia, frazione e avanzamento complessivo (media delle tre frazioni, ora anche nel Mercato globale al posto del minimo dell'ADR 0015), stato patrimoniale, conto economico dell'ultimo anno chiuso, prestiti, storico del patrimonio netto dalla Cronaca;
    • stato patrimoniale per voce con una sola fonte: FinanceSystem.BookValues (binari e opere, stazioni e depositi, veicoli, industrie possedute, merce propria) scritto ogni mese in Company.BookValues; AssetBookValue ne è la somma e la scomposizione (con partecipazioni, cassa, prestiti e scoperto) somma al centesimo al patrimonio netto del motore; le industrie possedute entrano nel patrimonio al valore degli impianti più la loro cassa (prezzo d'acquisto senza avviamento);
    • notizia di promozione con gli sblocchi ottenuti e giorno annotato (Company.TierReachedDay); rifiuti con il livello che serve e il suo nome dai dati (compravendita, acquisto di industrie, quotazione, scalate ostili, concessioni, fido insufficiente con il livello che alza il fido); il validatore pretende squadre per livello uguali in tiers.json e construction.json;
    • salvataggio: corpo versione 6 (BalanceSheetSerializer) con voci e giorni dei livelli nell'hash; le versioni 1–5 ripartiscono il totale salvato (stesso patrimonio netto) e ricostruiscono i giorni dai fatti salienti o dallo storico;
    • protocollo: DetailKind.Climb (8) e ClimbReport (134); server: quadro su richiesta; ClientWorld.Climb;
    • client: pannello «La tua scalata» a tutto schermo come l'immagine 08 (ClimbPanel: binario dei livelli con il treno e l'avanzamento, sblocchi sotto ogni livello, storico del patrimonio con i livelli segnati in SeriesChart, «Per diventare…» con tre barre, stato patrimoniale, conto economico, «Chiedi un prestito» e «Rimborsa»), pulsante «Scalata» nella barra degli strumenti, livello e avanzamento nella barra superiore (un clic apre il pannello), testi in strings.csv, schermata 17_scalata nel pilota automatico;
    • test (Economy/ClimbTests.cs, 7, più il quadro via WebSocket in ServerTests): requisiti coerenti con Tiers.Meets e avanzamento, sblocchi dai dati, stato patrimoniale con industria, merce, prestito e scoperto che somma al patrimonio netto, notizia di promozione con gli sblocchi, rifiuti con il livello, salvataggio versione 6 e migrazione dalla 5, proiezione e round-trip di ClimbReport. 170 test (152 senza i lenti).
  • Finanza completa (issue #39, ADR 0019):
    • analisi delle lacune nell'ADR: prestiti, fido per livello, rate, rating mensile e bancarotta ai giorni di difficulty.json c'erano già; mancavano stipendi delle compagnie, finestra di 12 mesi e leva su patrimonio nel rating, misure conservate, conto economico per voce mensile e annuale, voci separate per stazioni, dazi, magazzini e dividendi incassati, avvisi prima della bancarotta, quadro nel protocollo e pannello definitivo;
    • prestiti a tasso fisso (base della difficoltà + spread del rating all'accensione: niente spirale rating → rata → utile), rimborso anticipato parziale (stessa durata, rata più bassa) e totale senza penale, messaggi con tasso, rata, residuo e cassa disponibile;
    • rating ogni mese da margine = utile operativo / ricavi sugli ultimi 12 mesi chiusi e leva = (prestiti + scoperto) / patrimonio netto; punteggio, misure e mesi della finestra in Company; margine neutro finché la finestra non è piena e ha meno di finance.ratingMinRevenueMonths (3) mesi con ricavi, minimo senza ricavi e in perdita; FinanceOutlook.Explain dice componenti, soglie con il tasso per rating, gradino sopra, margine che basta, leva massima e debito da rimborsare (se la cassa basta), oppure che il punteggio vale già il gradino sopra;
    • voci nuove del registro: StationUpkeep (21), Storage (22), Duties (23), DividendsReceived (24, ora nell'utile); LedgerEntries fissa ordine e sezioni; stipendi giornalieri del personale presente nei depositi alle paghe delle industrie (Wages);
    • conto economico per voce: ultimi 12 mesi chiusi e 10 anni chiusi (finance.incomeMonths, incomeYears), ogni colonna con l'utile operativo e il flusso di cassa del motore;
    • avvisi di cassa negativa dopo finance.negativeCashNoticeDays (3) giorni di fila e a 30, 14, 7, 3, 1 giorni dal limite (finance.bankruptcyWarningDaysLeft, validati), notizia di rientro solo dopo il primo avviso, esito dell'ADR 0012 invariato; la quota dei trasporti dei nuovi concorrenti usa Company.TransportRevenue (tariffe, noli, contratti);
    • salvataggio: corpo versione 7 (FinanceSerializer) con mesi, anni e misure del rating nell'hash; le versioni 1–6 partono senza mesi chiusi, con l'ultimo anno dal registro;
    • protocollo: DetailKind.Finance (9) e FinanceReport (135); server: quadro su richiesta; ClientWorld.Finance;
    • client: pannello «Finanze» a tutto schermo (FinancePanel): conto economico con «Mesi» e «Anni», rating con misure e «per salire…», soglie e tassi, prestiti con rata, interessi, scadenza, «Rimborsa» ed «Estingui», richiesta con fido e tasso, barra dei giorni di cassa negativa solo con lo scoperto; frasi intere con segnaposto in strings.csv; schermata 18_finanze nel pilota automatico (non provata qui: manca l'editor);
    • IA invariate: usano gli stessi comandi di prestito; accettazione F5 (un'IA al livello 3 in 15 anni) e F4 (35 / 20 guasti senza la linea, 75 / 2 con la linea) invariate;
    • test (Economy/FinanceTests.cs, 19, più il quadro via WebSocket in ServerTests e il round-trip di FinanceReport): tasso per rating e fisso, fido dal livello e rifiuti, interessi e quota capitale sul registro, rimborso parziale e totale, rating dalle due misure e leva infinita, spiegazione che porta al gradino sopra e rimborso possibile con la cassa, punteggio che basta già (senza infiniti), margine neutro ai primi incassi, finestra di 12 mesi, conto economico che somma all'utile, stipendi dei depositi, dazi, magazzini, dividendi incassati nell'utile, avvisi e bancarotta ai giorni di ogni preset (lento), rientro e oscillazioni senza notizie, quota dei trasporti senza dividendi, salvataggio versione 7 e migrazione dalla 6, determinismo con gli invarianti, proiezione. 194 test (175 senza i lenti).
  • Ere e obsolescenza dei veicoli (issue #41, ADR 0020):
    • analisi delle lacune nell'ADR: ere, sblocchi per anno, rifiuto d'acquisto fuori produzione, valore di libro per età e SellVehicle c'erano già; mancavano notizie d'era e Cronaca, successori e modelli superati, una sola fonte del valore, costi di manutenzione dei superati, un modo di sostituire i veicoli di un treno, il quadro della flotta, la vendita nel client e l'aggiornamento dei modelli dei progetti delle IA;
    • vehicles.json: campo successor (stessa categoria, introdotto dopo, validato) e blocco obsolescence (perdita immediata 15 %, ammortamento 2 volte più rapido, manutenzione × 1,5 per i superati); catena vapore 1850 → 1878 → 1902 → diesel 1925, elettrica 1950 → alta velocità 1990, carrozza operai → moderna;
    • Obsolescence (senza stato): in produzione, superato dal 1° gennaio dell'anno del successore, successore consigliato, curva del valore, valore di libro (patrimonio) e rivendita (× condizione) da una sola fonte, fattore della manutenzione in Fleet.CostOf;
    • rinnovo con l'intervento «renewal» di maintenance.json (effetto renew) prenotato con ScheduleService: in officina, all'avvio dei lavori, i veicoli superati si vendono e il successore entra nella stessa posizione; nessun comando nuovo; rifiuto senza veicoli superati o con la spesa netta oltre la cassa meno i rinnovi già prenotati; all'avvio piano e cassa si ricontrollano e, se non bastano, il rinnovo si annulla con un avviso senza scoperto; la ricostruzione dopo un deragliamento non rende nuovo nel patrimonio un modello fuori produzione;
    • EraSystem: il 1° gennaio la notizia (EventKind.Technology = 11) dell'era che inizia e delle novità dell'anno lette dai dati (trazioni, veicoli, ponti, gallerie, binari, segnali, elettrificazione, merci, industrie, superati, fuori produzione), annotata nella Cronaca; una volta sola anche attraverso un salvataggio;
    • salvataggio invariato (corpo versione 7): nessuno stato nuovo, «renewal» in coda agli interventi;
    • IA: i modelli dei progetti superati passano al successore se non peggiora trazione, potenza e velocità, quelli fuori produzione al migliore dell'anno (che scarta i superati); ogni mese al massimo un treno in linea con veicoli superati da 3 anni o a metà vita va al rinnovo se il treno non peggiora e se resta in cassa libera il doppio della riserva (ai.json, renewal); la spesa dei rinnovi prenotati resta impegnata per borsa, industrie, progetti e treni;
    • protocollo: DetailKind.Fleet (10) e FleetReport (136); server: quadro su richiesta; ClientWorld.Fleet;
    • client: Treni con il catalogo dal server (fuori produzione nascosti, superati segnati con il successore, prestazioni e prezzo del successore), rivendita e «superato» sui veicoli liberi, «Vendi», treni «da rinnovare» e «Rinnova i veicoli superati» con la spesa netta; Officine con la riga di obsolescenza nella cartella, il pulsante del rinnovo e la sezione «Rinnovo della flotta» (nome dell'era, «rinnovo prenotato» al posto di «Rinnova», righe ricostruite solo all'arrivo di un nuovo quadro); testi in strings.csv (non provato in Godot: manca l'editor);
    • accettazione F4 (35 / 20 guasti senza la linea, 75 / 2 con la linea) e F5 invariate;
    • test (Economy/ErasTests.cs, 16, più il round-trip di FleetReport): sblocchi per anno, validazione dei successori, notizia d'era una volta anche attraverso un salvataggio, fuori produzione non acquistabile, curva del valore e rivendita, manutenzione dei superati, valore di libro uguale al patrimonio, rinnovo in officina con gli invarianti, determinismo e salvataggio con un rinnovo in corso, quadro e round-trip, cassa ricontrollata all'avvio e impegnata tra prenotazioni, rinnovo annullato con il piano vuoto, ricostruzione di un modello fuori produzione, Cronaca di un anno con soli fuori produzione, scelte delle IA, un'IA che rinnova (lento).
  • Audio (issue #46, ADR 0022):
    • solo client, nessun file audio: effetti, anelli e temi sintetizzati in memoria all'avvio su un altro thread da classi senza dipendenze da Godot (Synth, MusicComposer, AudioMix in scripts/Audio/), semi fissi, PCM a 16 bit in AudioStreamWav;
    • bus Master, Music, Ambience, Sfx, Ui creati da codice in modo idempotente, limitatore sul Master; volumi per bus e muto generale nella sezione audio di user://settings.cfg; pannello «Audio» dalla schermata di connessione e dall'altoparlante nella barra superiore, tasto M per il muto;
    • AudioManager (figlio di Main): clic di ogni pulsante, conferma ed errore dagli esiti dei comandi, campanelle per opportunità, avvisi e notizie critiche, «cantiere completato» dal DailyDigest; fino a 3 treni in moto vicini al centro dello schermo con rotolamento, motore diesel o ronzio elettrico e sbuffi del vapore modulati dalla velocità (solo con un moto ricevuto da meno di 500 ms ed entro metà della diagonale dello schermo); ambiente (vento e uccelli in campagna, fiume e lago, mare, città) dalla griglia del terreno visibile e dallo zoom; tema per era dall'anno corrente con dissolvenza incrociata di 3 s;
    • nel pilota automatico e senza schermo niente sintesi e Master muto; testi in strings.csv;
    • nessun test nel harness (il client non è referenziato): le funzioni pure sono state provate a parte (nessun NaN, picchi entro i limiti, anelli senza salti, temi identici a ogni composizione; circa 0,1 s per gli effetti, 0,1–0,4 s per tema). Non ascoltato: qui manca l'editor. 194 test (175 senza i lenti), invariati.
  • Scheda dell'industria e schermata di connessione (issue #42, ADR 0021):
    • IndustryOutlook (Core, sola lettura): la scheda dell'immagine 07 è calcolata con le stesse formule del motore. Contiene:
      • i fattori dell'efficienza e il fattore che la limita (IndustryLimit);
      • per ogni ingresso e uscita: quantità al mese a piena capacità e attuale, scorta, capienza, giorni di scorta o al magazzino pieno;
      • fornitori e clienti (industrie, hub, città) con fabbisogno o produzione mensile, prezzo (globale, locale o dell'hub), distanza e la linea della compagnia che li collega;
      • forza lavoro dai contratti dei pendolari: posti, presenti, al lavoro, mancanti, motivo, provenienze, viaggio medio;
      • crescita: punteggio del trimestre in corso con le componenti, soglie, trimestri sopra soglia, servita o no;
      • prezzo di vendita (prezzo globale del giorno), utile annuo stimato, stazioni e linea che la servono, sblocco dell'acquisto con l'avanzamento. La forza lavoro mostra solo i contratti a piedi, quelli della compagnia della sessione e, se l'industria è sua, quelli di tutti i vettori (come il Registro degli impieghi). IndustryMath.GrowthScore è ora l'unica formula del punteggio (anche per IndustrySystem.Quarter, hash invariati). Parametri di presentazione in balance.json → industry.outlook (partnersPerGood 3, workforceSources 4).
    • protocollo:
      • blocco 1 di IndustryCard: IndustrySheetInfo con IndustryFlowInfo, ChainPartnerInfo, WorkforceInfo, WorkforceSourceInfo;
      • blocco 1 del Welcome: ServerInfo con versione, sistema, Docker, tempo di attività, passo del ciclo, client collegati e massimi, locale;
      • ClientWorld.Server e ClientWorld.Saves (risposta a ListSaves e Save). Server: scheda per qualunque industria richiesta, calcolata per la compagnia della sessione.
    • client:
      • scheda dell'industria a tutto schermo come l'immagine 07 (IndustryPanel):
        • selettore dell'industria, intestazione con livello su massimo, proprietà, stazione e linea, valore stimato, anello dell'efficienza con il fattore che la limita;
        • schede «Materie prime in ingresso», «Forza lavoro» con il collo di bottiglia, «Produzione»;
        • grafo «Catena produttiva» (ChainGraph: merci su linea, lavoratori, personale, non collegato; i nodi delle industrie si aprono), «Crea una linea verso questa industria» e «Fai un'offerta di acquisto» o il livello che la sblocca con l'avanzamento;
        • «Impianti e crescita» con condizione, resa, rischio di fermo, barra del punteggio con le soglie, comandi del proprietario e storico dei fermi;
      • schermata iniziale e di connessione come l'immagine 09 (ConnectScreen, al posto di MenuScreen):
        • mappa decorativa con il titolo e «Dove gira il motore di gioco?»;
        • «Gioca in locale» e «Connetti a un server» con indirizzo, token e «Ricorda questo server»;
        • all'apertura avvia la strada scelta l'ultima volta (server locale, o verifica del server ricordato); cambiando strada la sessione dell'altra si chiude; senza sessione «Connetti e riprendi» la apre ed entra in partita; il cambio di lingua passa la sessione alla schermata nuova;
        • nel piede lingua, «Audio» (il pannello dell'ADR 0022, come nel vecchio menu) ed «Esci»;
        • stato del server in tre colonne: versione e protocollo, sistema, attivo da (avanza sul client), tick al secondo, latenza, client collegati;
        • «Partite salvate sul server» in tre colonne (nome, data di gioco, quanto tempo fa), scelta tenuta per id; «Connetti e riprendi» (Load e attesa del Welcome), «Nuova partita sul server», entrambe con conferma perché sostituiscono il mondo per tutti; il rifiuto si riconosce dal giorno −1 dell'avviso del server;
      • gli avvisi in alto (esiti dei comandi) compaiono anche sulle schermate a tutto schermo; l'esito dell'offerta di acquisto compare accanto al pulsante;
      • testi in strings.csv; pilota automatico: 12_industria e 12b_industria_scorte sono ora la scheda a tutto schermo di un'industria dei privati (in cima con l'avviso dell'acquisto rifiutato, e in fondo), non più la mappa con il pannello laterale; 19_scheda_industria e 20_connessione (la schermata su un suo CanvasLayer sopra l'interfaccia) in coda (non provate qui: manca l'editor).
    • test:
      • Economy/IndustryOutlookTests.cs, 6: scheda dell'acciaieria servita (fornitore collegato, clienti al prezzo locale e all'hub, stazione e linea, crescita, sblocco, prezzo di vendita, hash invariato), forza lavoro dai contratti, pendolari di altri vettori nascosti (visibili al vettore e al proprietario), fattore limitante per ogni causa, pesi del punteggio, round-trip nella IndustryCard e carta vecchia senza scheda;
      • ServerTests: scheda via WebSocket attesa come risposta nuova, ServerInfo nel Welcome, elenco dei salvataggi dopo Save, Load rifiutato con l'avviso del server al giorno −1;
      • campioni del protocollo con i blocchi nuovi; Welcome senza blocco 1 (server F5) con stato del server assente nella copia locale. Con le ere e l'audio: 218 test (198 senza i lenti).
    • bilanciamento con i bot su simulate (issue #47, ADR 0025):
      • obiettivi O1–O14 scritti nell'ADR prima della taratura, ciascuno con il suo motivo nella guida;
      • railenterprise-tools balance (semi × difficoltà × bot × anni, in parallelo, rapporto deterministico): rapporto.txt con gli obiettivi e la sintesi (livelli per anno, patrimonio, rating, fallimenti, interessi, prezzi/base min/medio/max, margini dei trasformatori, coperture, ampliamenti, crescita delle città, veicoli superati), anni.csv, mesi.csv, prezzi.csv, esecuzioni.csv, tempi.txt; simulate --bot <id>;
      • bot giocatore (PlayerBot): l'agente delle IA con le personalità di ai.json → bots (bot_competent, bot_prudent) alla guida della compagnia del giocatore; pianifica per primo; non salvato e fuori dall'hash (il formato dei salvataggi non cambia);
      • le IA (e i bot) usano la compravendita in proprio (supera ADR 0016 §9): vendita delle scorte, arbitraggio nel bacino o verso le stazioni raggiungibili dalle linee merci, con margine minimo, tetti e prezzi limite in ai.json → trading;
      • agente corretto: un trasformatore è una fonte solo con gli input alimentati (prima i bot fallivano su linee che si svuotavano finite le scorte iniziali); la linea dei ricambi di una rete nuova esce dal budget iniziale se l'utile la ripaga entro planning.partsDeferYears (3 anni);
      • dati: market.world.volumeShare 0,5 → 1,0 ed elasticity 1,0 → 2,5; planning.townBonus 1,8 → 3,0 e townRoiFactor 0,5 → 0,35;
      • risultato sulla matrice predefinita (72 esecuzioni da 12 anni): obiettivi raggiunti da 5 a 9 su 14; livello 2 del bot competente in «Imprenditore» al 4° anno (mediana, prima 7°); nessun fallimento dei bot in «Apprendista» e «Imprenditore» (prima 2); prezzi medi tra 0,77 e 1,42 volte il base (prima 0,38–2,78); mesi-bene entro 0,7–1,6 dal 35 % al 91 %; restano aperti O7 (95 %), O8 (margini dei trasformatori, ora per logistica e non per prezzo), O9–O10 (servono linee pendolari), O11 (IA in «Ferro e sangue»);
      • test: Balance/BalanceTests.cs, 4: rapporto deterministico (stesso seme, stesse righe, 1 o 2 thread), bot che gioca con i comandi e non entra nel salvataggio, compravendita dell'agente nello scenario, banco ridotto lento (3 semi, «Imprenditore», 6 anni) sugli obiettivi principali; EconomyTests.PriceRisesWhenDemandExceedsSupply con soglia 1,25 (il mondo assorbe parte dello squilibrio). Con il bilanciamento: 222 test (201 senza i lenti), suite completa ~4 minuti.
  • Restano della F6: tooltip «perché», tutorial.

Prossimo passo

  • F6: tooltip «perché», tutorial.

Limiti noti

  • Godot non è eseguibile nell'ambiente cloud: il client potrà essere compilato con Godot.NET.Sdk ma non avviato né esportato qui.
  • Senza vettori il mondo è in lento declino: le città perdono circa l'1 % di abitanti l'anno e le industrie lavorano a circa il 15–30 % (voluto, ADR 0004).
  • Il client non è stato provato su Windows né esportato (servono i template di esportazione di Godot); la partita locale usa il server compilato dal repository o RE_SERVER_PATH.
  • Nella vista d'insieme i fiumi larghi una cella mostrano ancora gradini. Le immagini di riferimento 06–09 sono arrivate (novembre 2026): il Mercato globale è allineato alla 06, la scheda dell'industria alla 07, «La tua scalata» alla 08 e la schermata di connessione alla 09 (F6, non ancora provati in Godot: qui manca l'editor). Della 07 mancano le quantità consegnate su ogni collegamento della catena (il motore non le registra: si mostrano produzione o fabbisogno del partner, prezzo e linea) e quantità diverse per ingresso (il consumo segue la ricetta); lo stato del server nella 09 è quello del collegamento (ADR 0021): «Client collegati» resta quello del Welcome e «Attivo da» avanza con l'orologio del client; il server non salva prima di Load o NewGame (la conferma lo dice).
  • Compravendita in proprio (ADR 0016): la quotazione nel pannello non considera la cassa delle industrie compratrici; una spedizione tiene occupato lo spazio di destinazione per tutto il viaggio; se una linea sparisce durante il viaggio la merce si ferma nel magazzino della stazione dove si trova anche oltre la capacità; un treno che lascia la linea in viaggio lascia la merce propria alla prossima fermata senza percorrere il tratto; la merce in attesa in stazione scade come le altre merci (la scadenza riparte a ogni trasbordo); il riquadro non è ancora stato provato in Godot (qui manca l'editor).
  • Eventi del mondo (ADR 0017): le medie mobili (coperture a 30 giorni, margini) si riprendono gradualmente dopo un evento; il maltempo prende un arco per intero secondo il suo punto medio; la notizia di fine arriva la sera dell'ultimo giorno; il riquadro mostra al massimo quattro eventi; le IA non reagiscono; client non ancora provato in Godot (qui manca l'editor).
  • Audio (ADR 0022): suoni mono senza panoramica; timbri semplici di sintesi, da tarare all'ascolto (non ancora provati in Godot: qui manca l'editor); niente fischio all'arrivo in stazione: il client non riceve moti Loading (all'arrivo il server non manda moti), serve una modifica del protocollo con una decisione a parte.
  • Mercato globale (ADR 0015): la previsione segue solo la componente mondiale (ciclo e shock), non domanda e offerta della mappa; «Dove conviene vendere» dà il prezzo alla destinazione, senza il costo del trasporto.
  • Scalata (ADR 0018): il livello non scende; lo storico del patrimonio ha un punto all'anno (più la fondazione e oggi); il capitale iniziale mostrato è quello della difficoltà; il valore contabile si aggiorna a inizio mese, mentre cassa, partecipazioni e debiti sono del giorno; i salvataggi delle versioni 1–5 ripartiscono il totale degli attivi in proporzione alle voci del giorno di caricamento fino al ricalcolo del mese; il pannello non è ancora stato provato in Godot (qui manca l'editor).
  • In F3 tutte le sessioni guidano la compagnia del giocatore (ADR 0009).
  • Bilanciamento (ADR 0025): sulla matrice del banco i beni lavorati (acciaio, legname, materiali edili) restano a lungo sopra 1,6 volte il base nelle difficoltà alte (91 % dei mesi-bene nella fascia contro il 95 % dell'obiettivo); i trasformatori che vendono hanno margine medio negativo perché l'output si vende solo se qualcuno lo ritira; con le sole linee merci le industrie servite lavorano a circa 0,35 (copertura dei lavoratori 0,36) e le città calano dello 0,9 % l'anno; in «Magnate» e «Ferro e sangue» i bot non trovano una prima rete sopra la soglia del ROI e in «Ferro e sangue» poche IA partono entro il 3° anno; nello scenario l'acciaieria cresce ancora ogni due trimestri finché la linea operai non satura (sulla mappa generata 0,3 ampliamenti per industria servita all'anno).
  • La lunghezza dei marciapiedi non è modellata; i segnali sono solo a blocco fisso (niente segnali di percorso).
  • Comandi ancora NotImplemented: concessioni, contratti, ricerca, regioni (fasi F6–F7).
  • Manutenzione (ADR 0010): il viaggio verso l'officina si stima in linea d'aria; un treno rimorchiato completa il tratto in corso prima di dirigersi all'officina; con un solo treno su una linea di pendolari e un deposito senza personale la copertura cala durante gli interventi (servono riserve e personale); la mappa dei flussi dei pendolari (frecce blu, opzionale nella guida) non è ancora disegnata.
  • Una rete a binario semplice con pochi binari di stazione può ancora bloccarsi se tutti i binari alle due estremità sono occupati da treni che devono incrociarsi (stallo di capacità segnalato al giocatore come «possibile stallo»): la rete dell'accettazione F4 è dimensionata di conseguenza.
  • IA (ADR 0013): su mappe da 128 km in «Magnate» di solito una o due IA crescono (livello 2–3 in 15 anni) mentre le altre restano piccole o falliscono quando la regione non offre candidati con ROI sopra soglia; nel 1850 i grandi fiumi dividono la mappa in regioni fino ai ponti in ferro. Le IA non comprano ancora industrie se non dal livello 3; la compravendita in proprio (ADR 0025) guarda solo i venditori del bacino delle proprie stazioni e i compratori raggiungibili dalle linee merci, senza costruire linee apposta; costruiscono di rado linee pendolari.
  • Borsa (ADR 0012): per le compagnie piccole il prezzo per azione è di pochi centesimi e il premio di un'offerta ha la granularità di un centesimo; antitrust e finanziamenti statali arrivano in F7.

Misure di prestazione

Misura Valore Fase
Build Release da pulito ~15 s F0
Generazione mappa 64 / 128 / 256 km 0,8 / 1,4 / 5,6 s F1
simulate --years 20 su 128 km (110 industrie, 26 città) 1,7 s (+1,4 s di creazione) F1
Suite di test (45, parallela su 4 core) ~10 s F1
Suite di test (75, parallela su 4 core) ~11 s F2
Scenario Valdoria, 24 mesi con tre linee 2,3 s F2
bench --trains 2000 (256 km, 600 stazioni, 300 linee, 2.280 km di binario, 2.089 segnali) tick medio 0,84 ms, p95 0,92, p99 1,21, massimo 10,5 (cambio di giorno); TrainSystem 0,79 ms F2
Allocazioni nel tick ordinario con 2.000 treni < 1 KB (crescita delle liste), nessuna raccolta gen0 in 1.200 tick F2
Suite di test (85, parallela su 4 core) ~14 s (il test di accettazione via WebSocket ~8 s) F3
Immagine Docker del server 344 MB, build ~15 s con le immagini di base in cache F3
smoke contro il container (64 km, tick 50 ms) 48 s: 28 giorni di cantiere a 8×, treno in moto, scarto 0,00 m F3
Build del client Godot (Debug) ~13 s F3
Pilota automatico del client sotto Xvfb ~60 s, 8 schermate F3
bench --trains 2000 con la manutenzione tick medio 0,97–1,02 ms, p99 1,6–2,0; cambio di giorno ~19 ms (hash 10, manutenzione 5, stazioni 2) F4
Accettazione F4 (due corse di 3 anni, 6–7 treni) 3,7 s F4
Suite di test (102, parallela su 4 core) ~15 s F4
Pilota automatico del client con i pannelli F4 ~90 s, 12 schermate F4
Suite di test (120, parallela su 4 core, con i test lenti delle IA) ~137 s (accettazione F5 70 s) F5
simulate --years 15 su 128 km «Magnate» con 3 IA ~60 s F5
balance matrice predefinita (72 esecuzioni da 12 anni su 128 km, 12 in parallelo) 533 s; 176 s per esecuzione in media, 400 s la più lunga F6
balance --difficulties imprenditore --years 8 (6 esecuzioni) ~85 s F6