Files
Rail_Enterprise/docs/STATE.md
T
Alby96andClaude Opus 5.5 9bf64b9286 F6: finanza completa con prestiti per rating, conto economico e bancarotta
Completa la finanza della guida 6.3 partendo da un'analisi delle lacune
(ADR 0019): prestiti, fido per livello, rate e bancarotta ai giorni di
difficulty.json c'erano già; mancavano gli stipendi delle compagnie, un
rating spiegabile, il conto economico per voce e gli avvisi.

- Prestiti a tasso fisso (base della difficoltà + spread del rating
  all'accensione), per non innescare la spirale rating -> rata -> utile;
  rimborso anticipato parziale e totale con messaggi chiari in italiano.
- Rating mensile da margine (utile/ricavi sugli ultimi 12 mesi chiusi) e
  leva (debiti/patrimonio netto); il motore conserva le misure e
  FinanceOutlook spiega soglie, tassi e cosa serve per salire.
- Voci nuove del registro (stazioni e depositi, magazzini, dazi, dividendi
  incassati) e stipendi del personale presente nei depositi, così il conto
  economico per voce somma esattamente all'utile operativo del motore.
- Mesi e anni chiusi per voce nel salvataggio (versione 7, con migrazione
  e nell'hash); avvisi di cassa negativa alle scadenze fisse prima del
  limite della difficoltà, esito dell'ADR 0012 invariato.
- Protocollo: DetailKind.Finance e FinanceReport; client: pannello
  «Finanze» a tutto schermo con conto economico, rating, prestiti e barra
  della cassa negativa, schermata 18_finanze nel pilota automatico.
- Test in Economy/FinanceTests.cs, round-trip del protocollo e quadro via
  WebSocket; IA e accettazioni F4/F5 invariate.

Refs #39.

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

38 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; FinanceOutlook.Explain dice componenti, soglie con il tasso per rating, gradino sopra, margine che basta, leva massima e debito da rimborsare;
    • 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 il primo giorno e a 30, 14, 7, 3, 1 giorni dal limite (finance.bankruptcyWarningDaysLeft, validati), notizia di rientro, esito dell'ADR 0012 invariato;
    • 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; testi 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, 16, 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, 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, salvataggio versione 7 e migrazione dalla 6, determinismo con gli invarianti, proiezione. 191 test (172 senza i lenti).
  • Restano della F6: ere e obsolescenza, pannello 07, tooltip «perché», tutorial, audio, bilanciamento con i bot.

Prossimo passo

  • F6: ere e obsolescenza, pannello 07, tooltip «perché», tutorial, audio, bilanciamento con i bot su simulate.

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 e «La tua scalata» alla 08 (F6, non ancora provati in Godot: qui manca l'editor); Industria e la schermata di connessione vanno allineati in F6.
  • 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).
  • 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).
  • Il bilanciamento economico è provvisorio (F6): nello scenario l'acciaieria cresce di livello ogni due trimestri finché la linea operai non satura; il prezzo del minerale sale oltre 1,5 volte il base e il margine dei trasformatori diventa negativo quando la domanda supera l'offerta delle miniere.
  • 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 e non usano la compravendita in proprio (ADR 0016: da aggiungere ai candidati degli agenti con il bilanciamento della F6).
  • 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.
  • Prezzi, soglie dei livelli e taratura economica restano provvisori fino al bilanciamento della F6.

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