Files
Rail_Enterprise/docs/STATE.md
T
Alby96andClaude Opus 5.5 e57231b15a
CI / Build e test (pull_request) Successful in 3m12s
CI / Immagine Docker (pull_request) Successful in 37s
Rilascio: soluzione del client per l'esportazione Godot, versione 0.5.1
Il gioco desktop di v0.5.0 si avviava senza codice C# perché Godot esporta
gli assembly .NET solo se trova la soluzione del client, che non era nel
repository. Aggiunge RailEnterprise.Client.sln con le configurazioni di
esportazione, fa fallire il rilascio se mancano gli assembly, porta la
versione di sviluppo a 0.5.1 e indica nel modello di PR le parole chiave
inglesi che Gitea usa per chiudere le issue.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-07 11:52:14 +01:00

21 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.
  • Test instabile sotto carico BuildLineWithBridgeOverTheNetworkAndWatchTheTrain (scarto 884 m una volta sul runner, issue #24).

In corso

  • Nessun lavoro a metà: F5 chiusa.

Prossimo passo

  • F6: hub e commercio (BuyGoods/SellGoods), eventi, storico dei prezzi, finanza completa, livelli e sblocchi nell'interfaccia, ere e obsolescenza, pannelli 06–08, tooltip «perché», tutorial, audio, bilanciamento con i bot su simulate, esportazione Windows con il server.

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): i pannelli Mercato, Industria e Scalata e la schermata di connessione vanno allineati in F6.
  • 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: commercio, 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 il commercio (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