Files
Rail_Enterprise/docs/ARCHITECTURE.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

23 KiB
Raw Blame History

Rail Enterprise — Architettura

Questo documento descrive come è fatto il codice. Va aggiornato a ogni fase: le parti non ancora implementate sono marcate (pianificato, Fn).

1. Progetti e dipendenze

RailEnterprise.Core      (net10.0; net8.0)  simulazione deterministica, dati, mappa, economia, rete, salvataggi
RailEnterprise.Protocol  (net10.0; net8.0)  frame binari, messaggi, SpanWriter/SpanReader       → Core
RailEnterprise.Server    (net10.0, Web SDK) Kestrel, WebSocket, GameLoop, API HTTP, autosave    → Core, Protocol
RailEnterprise.Tools     (net10.0)          railenterprise-tools: validate-data, genmap, profile, simulate, balance, bench, smoke, replay → Core, Protocol
RailEnterprise.Tests     (net10.0)          harness interno, test di unità, scenari             → Core, Protocol, Server
client/RailEnterprise.Client (Godot .NET)   rendering, input, UI; anteprime con Core            → Core, Protocol

Regole:

  • Nessun PackageReference (controllato da scripts/check-nuget.sh). Il solo SDK esterno è Godot.NET.Sdk nel client, fuori dalla soluzione principale.
  • Core e Protocol compilano anche per net8.0 perché il client Godot li referenzia direttamente: niente API successive a .NET 8 in questi due progetti (per esempio System.Threading.Lock).
  • Il client non decide nulla: invia comandi, riceve stato, e usa Core solo per anteprime (profilo del binario, stime nei tooltip) che il server ricalcola.

2. Core: struttura dei namespace

Namespace Contenuto
RailEnterprise.Core.Common Rng (xoshiro256**), StableHash, XxHash64, DMath (funzioni trascendenti deterministiche), Money, identità tipizzate, Vec2.
RailEnterprise.Core.Time GameClock, GameDate, costanti di calendario.
RailEnterprise.Core.Data Definizioni immutabili caricate da data/*.json (GameData), contesto JSON con source generator, validatore di schema e validatore semantico.
RailEnterprise.Core.Map Terrain (altezze ushort in decimetri, tipi cella byte, larghezza dei fiumi), MapGenerator (ADR 0005), ValueNoise, TerrainSampler, NameGenerator, chunk 64×64.
RailEnterprise.Core.Economy Città, industrie, hub, mercato, compagnie, registro contabile a partita doppia, finanza.
RailEnterprise.Core.Rail TrackGeometry (raccordi), TrackPlanner (profilo a 25 m, opere, costi, tempi, vincoli per era), RailNetwork (nodi, archi campionati, stazioni, depositi, cantieri, indice spaziale), Pathfinder (A* sugli archi orientati), veicoli, treni, linee, pacchetti, LineGraph con maschere dei carichi (ADR 0007, 0008).
RailEnterprise.Core.Commands Comandi di gioco (record immutabili) ed esiti. Sono l'unico modo di cambiare il mondo dall'esterno, anche per le IA.
RailEnterprise.Core.Simulation World, WorldContext, SystemPipeline e Systems/, WorldFactory, IndustryPlacer, CommandProcessor e gestori dei comandi, Corporate (fusioni, liquidazioni, fine partita), Estimators (stime condivise da IA e tooltip), ChronicleReport, Ai/ (agenti delle compagnie IA, ricerca del percorso sulle celle), eventi in uscita, WorldEvents (eventi del mondo attivi e loro moltiplicatori, ADR 0017).
RailEnterprise.Core.Persistence SaveWriter/SaveReader, SaveFile (Brotli), StateHasher.

3. Il tick

World.Tick() esegue i sistemi in ordine fisso (SystemPipeline.CreateDefault) e poi avanza l'orologio. L'ordine della guida è:

Clock → Commands → Construction → Trains → Signals → Stations → Maintenance (treni)
→ Demand (giornaliero) → Commuting → Industries → IndustryMaintenance → Towns → Market
→ Finance → StockMarket → AiAgents (mensile) → Events → Eras (annuale) → Contracts → Hash (giornaliero)

Sistemi implementati (F1–F5), nella loro posizione:

Sistema Frequenza Cosa fa
ClockSystem tick calcola una volta gli indicatori di giorno, mese, trimestre, anno
CommandSystem tick drena la coda dei comandi (CommandProcessor), registra esiti ed eventualmente il log per il replay
ConstructionSystem giorno squadre e cantieri, usura e manutenzione del binario, ispezioni e invecchiamento di ponti e gallerie
TrainSystem tick percorsi, prenotazioni di blocchi, versi e binari di stazione fino al punto sicuro, fisica, soste, carico e scarico (StationWork), Stalled
StationSystem giorno bacini (mensili), scadenze dei pacchetti, consegne in attesa del consumatore, ritiro della produzione verso la destinazione migliore
LocalTransportSystem giorno trasporto locale su strada tra produttori, consumatori e hub entro 3 km (posto di «Stations», ADR 0004)
FleetMaintenanceSystem giorno usura per componente in km di servizio, rischio e guasti (lieve, grave con soccorso, deragliamento), pianificatore predittivo e prenotazioni, officine con stalli, ricambi e personale, riserve, avvisi (posto di «Maintenance», ADR 0010); formule senza stato in Fleet
DemandSystem giorno domanda delle città (con elasticità) e input richiesti dalle industrie
EmploymentSystem giorno/mese servizi cittadini, lavoratori in sede, contratti a piedi e su rotaia per industrie e depositi (IWorkplace, abbinamento mensile sul LineGraph), motivi dei posti scoperti, convenzioni, pacchetti giornalieri dei pendolari, presenze e coperture (posto di «Commuting», ADR 0008 e 0010)
IndustrySystem giorno/trimestre/anno produzione (nulla durante i fermi), esaurimento giacimenti, salari, crescita delle industrie servite, chiusure, nascite
IndustryMaintenanceSystem giorno/mese condizione degli impianti (usura con l'utilizzo, recupero del budget), consumo di ricambi, fermi e incidenti, revisioni e ammodernamenti in attesa di macchinari, scelte dei proprietari privati, conguaglio con il proprietario (ADR 0011)
TownSystem giorno/mese/anno consumo e soddisfazione, crescita, migrazione, espansione dell'abitato
MarketSystem giorno prezzi globali con componente mondiale e shock, domanda insoddisfatta
FinanceSystem giorno/mese/anno costi di esercizio dei veicoli (RunningCosts) e di stazioni e depositi (StationUpkeep), stipendi del personale presente nei depositi (Wages), valori di libro per voce (BookValues, ADR 0018), cassa negativa con gli avvisi e bancarotta ai giorni della difficoltà, rate dei prestiti a tasso fisso, chiusura del mese nel conto economico per voce (IncomeMonths, IncomeYears) e nell'anello dei 12 mesi, rating da margine (12 mesi) e leva (debiti / patrimonio) con le misure conservate, livelli (Tiers), chiusura dei conti (ADR 0019)
StockMarketSystem giorno/mese/anno prezzi e sentiment, valore delle partecipazioni, offerte pubbliche (adesioni, esito), controllo e utili delle controllate, amministrazione controllata del giocatore, fallimenti e aste, storico annuale, nuovi concorrenti (ADR 0012)
AiSystem giorno/mese agenti delle compagnie IA: progetti, stalli, offerte; una volta al mese (giorno diverso per IA) finanza, treni aggiuntivi, borsa, industrie, linee dei ricambi e nuovi progetti, tutto con i comandi (ADR 0013)
EventSystem giorno eventi del mondo (F6, ADR 0017): chiude quelli scaduti, estrae i nuovi dal catalogo events.json con il flusso «events» e la frequenza della difficoltà, notizie d'inizio e di fine (posto di «Events»)
EraSystem anno novità tecnologiche (F6, ADR 0020): il 1° gennaio, dai dati, la notizia dell'era che inizia, di trazioni, veicoli, ponti, gallerie, binari, segnali, elettrificazione, merci e industrie introdotti, dei modelli superati e di quelli fuori produzione (EventKind.Technology), annotata nella Cronaca; senza stato
HashSystem giorno hash dello stato dinamico
  • Ogni sistema implementa ISimSystem.Step(WorldContext ctx); i sistemi giornalieri o mensili controllano ctx.IsNewDay / ctx.IsNewMonth e ritornano subito negli altri tick: nei 239 tick su 240 lavora solo TrainSystem.
  • SystemPipeline.Profile misura tempo e allocazioni per sistema (usato da bench).
  • WorldContext espone il mondo, i dati e il calendario; gli eventi in uscita (notifiche, notizie) vanno in World.Events, che il server svuota.
  • I comandi arrivano in una coda; il server la riempie dai socket e il sistema Commands la drena a inizio tick. Le IA eseguono i loro comandi direttamente con CommandProcessor dal sistema AiAgents (stesse validazioni, esito immediato, numeri di sequenza ≥ 0x80000000, non registrati per il replay: le IA si rigiocano da sole). Il bot giocatore del banco di bilanciamento (World.PlayerBot, ADR 0025) usa lo stesso agente per la compagnia del giocatore, prima delle IA, e non è salvato. Per il replay si registrano (tick, comando) in World.CommandLog.
  • I flussi pseudo-casuali dei sottosistemi si ottengono con World.Stream(nome) (derivati dalla radice con Rng.Fork, salvati per nome).

4. Determinismo

Requisito: stesso seme + stessi comandi agli stessi tick ⇒ stesso hash di stato, su Windows e Linux.

  • Un solo generatore pseudo-casuale, Rng (xoshiro256**), con un flusso per sottosistema ottenuto da Fork(nome); i flussi fanno parte del salvataggio.
  • Vietati nella simulazione: System.Random, Guid.NewGuid, DateTime.Now, Environment.TickCount, string.GetHashCode, iterazione su Dictionary/HashSet per produrre effetti, parallelismo che cambia l'ordine delle operazioni.
  • Aritmetica in virgola mobile IEEE a doppia precisione solo con operazioni elementari (+ − × ÷ √), che .NET garantisce identiche su x64 e ARM64. Le funzioni trascendenti (exp, log, pow, sin, cos, atan2) passano da DMath, implementata in Core, perché le librerie C delle piattaforme possono differire nell'ultimo bit (ADR 0003).
  • Denaro in long centesimi (Money); quantità di merci intere, con accumulatori frazionari per la produzione.
  • Lo stato è in liste ordinate per id; i dizionari sono solo indici.
  • StateHasher calcola ogni giorno un XxHash64 dello stato dinamico serializzato (il terreno, immutabile salvo opere, ha un proprio hash calcolato alla generazione e alle modifiche).

5. Dati

  • File in data/*.json, schema in data/schema/*.schema.json (sottoinsieme di JSON Schema validato da Core senza librerie esterne), deserializzazione rigorosa (proprietà sconosciute vietate, proprietà required), validazione semantica (id univoci, riferimenti risolti, limiti) in DataValidator (ADR 0002).
  • Caricamento con System.Text.Json e source generator (DataJsonContext), nessuna reflection.
  • events.json (F6, ADR 0017) è il catalogo degli eventi del mondo: bersaglio, zona, probabilità annua per mappa, durata, effetti come moltiplicatori con ampiezza min/max e testi delle notizie; DataValidator controlla anche che ogni effetto sia compatibile con il bersaglio.
  • GameData.Hash (XxHash64 dei file normalizzati) viaggia nel Welcome: client e server devono avere gli stessi dati.

6. Economia e contabilità

  • Entità in RailEnterprise.Core.Economy: Town, Industry, Hub, ResourceSite, Company (con Loan), CommuteContract, Market, Tariffs; MarketOutlook (F6, ADR 0015) è l'analisi in sola lettura per il pannello «Mercato globale»: storico mensile, previsione dalla componente mondiale, destinazioni di vendita, hub, evento in corso, avanzamento verso il commercio. ClimbOutlook (F6, ADR 0018) è l'analisi in sola lettura per «La tua scalata»: livelli con gli sblocchi dai dati (Tiers.NewUnlocks), requisiti del prossimo livello con l'avanzamento (media delle tre frazioni, usata anche dal Mercato globale), stato patrimoniale per voce che somma al patrimonio netto del motore, conto economico, prestiti, storico del patrimonio dalla Cronaca. FinanceOutlook (F6, ADR 0019) è l'analisi in sola lettura per il pannello «Finanze»: conto economico per voce (mese in corso, mesi chiusi, anno in corso, anni chiusi) che somma all'utile operativo del motore, spiegazione del rating (misure, componenti, soglie, cosa serve per salire), prestiti con rata e scadenza, fido, giorni di cassa negativa sul limite della difficoltà. IndustryOutlook (F6, ADR 0021) è l'analisi in sola lettura per la scheda dell'industria: fattori dell'efficienza e quello che la limita, ingressi e uscite al mese con giorni di scorta o di magazzino, fornitori e clienti con prezzo e linea che li collega, forza lavoro dai contratti dei pendolari, punteggio di crescita del trimestre (IndustryMath.GrowthScore, la stessa formula del motore) con le soglie, sblocco dell'acquisto. FleetOutlook (F6, ADR 0020) è il quadro in sola lettura del rinnovo della flotta: era in corso e prossima, veicoli con età, superato, successore consigliato, valore di libro, rivendita e fattore di manutenzione, catalogo dei modelli in produzione, treni da rinnovare con la spesa netta. Produzione, obsolescenza e valore dei veicoli vengono da Simulation.Systems.Obsolescence (senza stato, dai dati, dal calendario e dal giorno d'acquisto): è l'unica fonte del valore per il patrimonio (FinanceSystem.BookValues), SellVehicle, il rinnovo in officina (intervento «renewal», effetto renew) e i costi di manutenzione dei modelli superati.
  • Ogni movimento di denaro passa dal registro (MoneyLedger.Transfer) tra conti: compagnie, industrie e il conto Esterno (famiglie, clienti delle tariffe, mercato mondiale). La somma di tutti i saldi è sempre zero: è l'invariante «denaro» dei test. Le voci del conto economico delle compagnie (LedgerEntry) si accumulano per mese e per anno; LedgerEntries ne fissa l'ordine e le sezioni (ricavi, costi, investimenti e finanziamenti) e Company.OperatingProfit è la somma di ricavi e costi (ADR 0019). Un trasferimento può usare voci diverse per chi paga e chi incassa (dividendi pagati e incassati).
  • Ogni unità di merce sta in un magazzino tracciato (industrie, città, magazzini delle compagnie nelle stazioni, pacchetti in stazione e a bordo dei treni) e GoodsCounters registra prodotto, consumato, deperito, importato, esportato: giacenza = prodotto + importato − consumato − deperito − esportato. È l'invariante «merci».
  • Compravendita in proprio (F6, ADR 0016): TradingCommandHandlers esegue BuyGoods, SellGoods e ShipGoods con il prezzo locale marginale di Systems/TradingMath (unità per unità, controparti ordinate per prezzo). La merce comprata sta in Station.Stock; quella spedita viaggia in pacchetti con Packet.Owned, senza tariffa né consumatore, ed entra nel magazzino della stazione d'arrivo. Gli scambi con le industrie passano dal registro sulla voce «Commercio», quelli con gli hub contano come importazione ed esportazione; StationSystem addebita ogni mese la giacenza dei magazzini.
  • Eventi del mondo (F6, ADR 0017): World.WorldEvents (WorldEventState) è l'unica sorgente dei loro effetti. I sistemi chiedono un moltiplicatore per entità (1 senza eventi): IndustryCapacity in IndustrySystem e nella domanda di input di DemandSystem, TownDemand in DemandSystem.TownDemand, Attendance nelle presenze dei pendolari di EmploymentSystem, EdgeSpeed in TrainSystem ed EdgeWear nell'usura del binario di ConstructionSystem (traffico del giorno prima). Contano solo gli eventi in vigore nel giorno dell'orologio, [inizio, fine). Nessuno stato di base viene modificato: a evento finito il moltiplicatore torna 1. Le stime dei candidati delle IA leggono i valori senza eventi.
  • Interpretazioni delle formule della guida: ADR 0004.

7. Salvataggi

  • SaveFile: intestazione RESV leggibile senza decomprimere, corpo Brotli scritto da WorldSerializer con SaveWriter (little endian, nessuna reflection).
  • Definizioni salvate per id testuale e rimappate al caricamento; terreno salvato per intero.
  • StateHasher = XxHash64 di WorldSerializer.WriteDynamic (stato senza terreno, impostazioni ed eventi; il terreno entra con il suo hash). Dettagli: ADR 0006.
  • Corpo versione 2 (F4): MaintenanceSerializer aggiunge in coda allo stato dinamico manutenzione di veicoli e treni, officine, politiche, convenzioni e motivi dei posti scoperti; i salvataggi della versione 1 si migrano (ADR 0010).
  • Corpo versione 3 (F5): CorporateSerializer aggiunge manutenzione e proprietà delle industrie, libro dei soci, prezzi, controllo e storico delle compagnie, offerte, aste, fine partita e stato degli agenti IA (progetti, candidati scartati); i salvataggi precedenti si migrano (ADR 0012).
  • Corpo versione 4 (F6): TradingSerializer aggiunge i magazzini delle compagnie nelle stazioni (beni per id testuale) e gli id dei pacchetti di merce propria in stazione e a bordo; i salvataggi precedenti si caricano con i magazzini vuoti. WorldSerializer.Write(w, s, versione) scrive un corpo di una versione precedente per i test di migrazione (ADR 0016).
  • Corpo versione 5 (F6): EventSerializer aggiunge il prossimo id e gli eventi del mondo attivi (tipo e bene per id testuale, bersaglio, giorni, intensità; la zona si ricalcola dal catalogo); le impostazioni salvano eventFrequencyMultiplier. I salvataggi precedenti si caricano senza eventi e con la frequenza del preset (ADR 0017).
  • Corpo versione 6 (F6): BalanceSheetSerializer aggiunge per ogni compagnia il valore contabile per voce (AssetCategory) e il giorno in cui ha raggiunto ogni livello. I salvataggi precedenti ripartiscono il totale salvato in proporzione alle voci calcolate al caricamento (stesso patrimonio netto) e ricostruiscono i giorni dai fatti salienti o dallo storico (ADR 0018).
  • Corpo versione 7 (F6): FinanceSerializer aggiunge per ogni compagnia i mesi e gli anni chiusi per voce del registro e le misure dell'ultimo calcolo del rating. I salvataggi precedenti partono senza mesi chiusi, con l'ultimo anno chiuso dal registro e la spiegazione del rating sulle misure del giorno fino al primo calcolo mensile (ADR 0019).

8. Server

  • ServerProgram: Kestrel minimale, log JSON su stdout, configurazione da ambiente (ServerConfig: RE_PORT, RE_TOKEN, RE_DATA_DIR, RE_TICK_MS, RE_AUTOSAVE_MIN, RE_SEED, RE_MAP_SIZE, RE_DIFFICULTY, RE_LOG_LEVEL) e argomenti --local (127.0.0.1 su porta casuale, stampa LISTENING porta), --healthcheck, --token, --port, --data.
  • GameHost: possiede il mondo su un thread dedicato. Ogni giro drena la coda delle azioni (messaggi delle sessioni, richieste HTTP), esegue i tick dovuti con un accumulatore (velocità 0/1/2/4/8, budget RE_TICK_MS), adegua la velocità effettiva se i tick costano troppo (slow), pubblica e fa l'autosave a rotazione.
  • Session / SessionEndpoint: WebSocket su /ws, primo frame Hello, coda d'invio a due classi (affidabili e moti scartabili), ripresa con sessionId entro 120 s.
  • Projection: mondo → record del protocollo (entità, archi, chunk, moto dei treni, resoconti con gli eventi del mondo in corso, cartelle di manutenzione, registri officina, Registro degli impieghi); i delta per sessione si calcolano con gli hash dei record; i dettagli F4 si mandano su RequestDetail, gli avvisi di manutenzione (World.Alerts) come MaintenanceAlert.
  • SaveStore: salvataggi .vfsave in $RE_DATA_DIR/saves, ultimi cinque automatici; all'avvio si riprende il più recente.
  • HTTP: /health, /metrics (Prometheus), GET/POST /api/saves, GET /api/saves/{id}.
  • Docker: docker/Dockerfile (build in due stadi, utente non root, healthcheck), docker-compose.yml, unraid-template.xml; scripts/publish-image.sh per il registry Gitea.

9. Client

  • Progetto Godot 4.7 .NET in client/RailEnterprise.Client (fuori dalla soluzione), compilato con Godot.NET.Sdk; referenzia Core e Protocol (net8.0). I file dati e gli schemi si copiano in res://data a ogni build.
  • Main → ConnectScreen (immagine 09: server locale o in rete, stato dal blocco ServerInfo del Welcome, partite salvate, riprendi o nuova partita su una sessione di prova che poi diventa la partita) → GameScreen. LocalServerLauncher avvia il server come processo figlio per la partita locale.
  • GameSession applica i messaggi a ClientWorld (Protocol) sul thread principale; i comandi sono l'unico modo di cambiare il mondo; le anteprime del tracciato usano TrackPreview di Core.
  • MapView (Node2D + Camera2D): TerrainLayer (texture per chunk con fasce, ombreggiatura, sponde e curve di livello; shader per le rive), EntityLayer (case, industrie, stazioni, depositi, alberi in MultiMesh), TrackLayer (massicciata, traversine, rotaie, opere, cantieri, segnali), TrainLayer (veicoli interpolati, fumo, avvisi), ToolOverlay; LabelLayer disegna le etichette in coordinate schermo.
  • HUD: TopBar (con l'altoparlante dell'audio), Toolbar, pannello destro (pannelli degli strumenti e schede) con Minimap, Ticker. Pannelli: binari con profilo, stazione, deposito, treni, linee, officine (politica della flotta, avvisi, flotta per condizione, cartella di manutenzione, Registro officina, scorta di ricambi, mappa di calore), impieghi (Registro degli impieghi e convenzioni), mercato, finanze; a tutto schermo «Compagnie e borsa», «Mercato globale» (MarketPanel, immagine 06) e «La tua scalata» (ClimbPanel, immagine 08: binario dei livelli, storico del patrimonio con SeriesChart e i livelli segnati, requisiti, stato patrimoniale, conto economico, prestiti), che si apre anche dal livello nella TopBar, e la scheda dell'industria (IndustryPanel, immagine 07: ingressi, forza lavoro, produzione, grafo della catena ChainGraph, impianti e crescita, dati da IndustryOutlook nel blocco 1 di IndustryCard); scheda dell'entità (con manutenzione del treno, lavoratori dell'industria, dove lavorano gli abitanti, avvisi degli eventi in corso). Sopra la minimappa il riquadro «Eventi in corso» (WorldEventsBox, testi in WorldEventText) elenca gli eventi del mondo del DailyDigest; il Mercato globale mostra quelli sulla domanda di un bene.
  • Audio (scripts/Audio/, ADR 0022): AudioManager, figlio di Main con AudioManager.Instance, crea i bus Music, Ambience, Sfx, Ui (AudioBuses.Ensure, idempotente), applica i volumi di AudioSettings (user://settings.cfg, sezione audio) e reagisce a ciò che il client riceve: clic dei pulsanti (segnale node_added), esiti dei comandi, Notification, cantieri completati nel DailyDigest, treni visibili in moto vicini al centro (TrainLayer.Heads, al più 3 canali, solo con un moto recente in GameSession.MotionReceivedMs), terreno e zoom della vista per l'ambiente, anno corrente per il tema dell'era. I suoni si sintetizzano su un altro thread con classi senza Godot: Synth (effetti e anelli senza scatti), MusicComposer (temi per era da un seme fisso), AudioMix (miscelazione, scelta dei treni senza allocazioni, PCM). Pannello AudioSettingsPanel (dalla schermata di connessione e da SpeakerButton nella TopBar), tasto M per il muto; nel pilota automatico l'audio è spento.
  • Collaudo: pilota automatico (-- --autopilot cartella, scripts/client-autopilot.sh) con schermate.

10. Prestazioni

  • Treni e pacchetti in liste di struct riutilizzate; nel tick ordinario si alloca meno di 1 KB (crescita delle liste), nessuna raccolta gen0 durante bench.
  • Sistemi giornalieri e mensili distribuiti: i calcoli pesanti (abbinatore del pendolarismo, pianificatore di manutenzione, IA) girano una volta al giorno o al mese.
  • Misure reali in docs/STATE.md.