Il gioco esportato della release v0.7.0 passa il pilota automatico: le
quattro schermate nuove della F6 entrano in docs/screenshots per la Wiki,
e lo STATE registra l'esito della verifica con due difetti grafici minori
visti nella scheda dell'industria.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
La F6 è completa: scalata e livelli, finanza, ere e obsolescenza, scheda
industria e connessione, audio, tutorial, tooltip «perché» e bilanciamento
con i bot sono su main. La versione passa a 0.7.0 per il rilascio.
Nello STATE la F6 passa fra le fasi fatte e la nuova F7 (grafica 3D,
interfaccia e progressione, ombrello #68) diventa il lavoro in corso.
Refs #19, #20.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Misure del banco corrette (ADR 0025, «Correzioni della revisione»):
- O8: «trasformatori che vendono» = vendite nell'ultimo trimestre, non
RevenueEma > 0 (la media mobile non torna a zero e contava impianti fermi
da anni). Misurato bene il margine è positivo nel 62 % dei mesi dopo la
taratura contro il 75 % di prima: la conclusione «logistica, non prezzo»
non reggeva.
- O6 per partita e bene; O7 per difficoltà con la fascia allargata dalla
volatilità del preset; O3–O5 solo sulle partite in cui il bot costruisce
(O3 «non valutabile» se in una difficoltà non costruisce mai); O11 sulle
IA presenti al 3° anno; O12 con gli interessi di dicembre (anno campionato
dopo la chiusura); obiettivi del mondo su una partita per seme e
difficoltà; mediana sui due valori centrali con un numero pari di semi.
- Verifica sui semi 4–9, mai usati nella taratura: O1 non tiene (livello 2
al 4° anno in 3 semi su 6), O11 sì. Il test lento usa i semi 4–9.
Agente:
- il blocco in attesa della linea dei ricambi ferma solo le reti nuove e
al più per partsDeferYears dall'apertura della rete;
- la linea dei ricambi si rimanda solo se l'utile la ripaga prima che
finisca la dotazione del deposito (stimata dai tagliandi): con la regola
di prima il bot competente falliva nel seme 9 di «Imprenditore»;
- il budget della compravendita vale per tutti gli affari del mese.
Una soglia minima al tasso dei prestiti per le linee urbane è stata provata
e scartata (O1 cade sul seme 3): motivazione nell'ADR.
Dati: limiti espliciti negli schemi per ai.json → planning e
balance.json → market.world, più due controlli del validatore.
Test: determinismo con più mondi in parallelo (anche con compravendita),
limiti degli schemi. ADR e STATE: 24 esecuzioni (non 72), tempi, legame
non monotono tra elasticità e accettazione F4 (un'unità di margine), tabella
prima / dopo / verifica rifatta con le misure nuove.
Matrice predefinita: 7 su 13 obiettivi (prima della taratura 4 su 13);
semi 4–9: 7 su 13. 244 test verdi (222 senza i lenti), client compilato.
Refs #47.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Tooltip «perché» (PR #52) e tutorial (PR #51) entrano nel ramo; in STATE.md restano le due sezioni di main e quella del bilanciamento, con i passi rimasti della F6.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
Le spiegazioni ora si ricompongono davvero dai termini mostrati e il
tooltip resta coerente con il pannello su cui sta.
Core:
- prezzo globale: termini Dtot, Stot, η, rmin, rmax e formula del rapporto
D/S = clamp(Dtot/Stot, rmin, rmax) con gli scambi con il mondo;
- condizione del treno: la stima viene da Fleet.ConditionDue (estratta da
Fleet.Dues senza cambiare l'aritmetica), con condizione e usura del
componente che la dà, distinto dal più debole;
- tariffe merci e passeggeri riservate alla compagnia della linea;
- efficienza: la condizione mostrata è quella da cui viene mc (salvata in
EfficiencyTerms prima della manutenzione), formula con «lavoro».
Client:
- WhyTooltip chiede la spiegazione a ogni apertura e poi al più una volta
al secondo per valore (per chiave), mostrando la cache come in
aggiornamento; passa al sostituto quando il pannello ricostruisce il
controllo sotto il puntatore, invece di chiudersi e lampeggiare;
- prezzi come la scheda dell'industria, importi piccoli con i centesimi,
condizione per difetto in percentuale, componente accanto al numero;
- misura del riquadro dopo l'impaginazione (niente salti di lato);
- cassa della barra dalle entità e nota quando il numero mostrato non è
quello spiegato; nel Mercato il suggerimento nativo della riga non copre
più il tooltip del prezzo.
Refs #44.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Ogni valore importante dei pannelli spiega al passaggio del mouse da dove
viene: formula, termini con i valori di oggi e note, calcolati dal Core e
mandati dal server, perché il client non deve rifare né ricomporre formule.
- Core: modello comune Explanation ed Explanations, pure funzioni che
chiamano le stesse funzioni del motore; estratte senza cambiare
l'aritmetica (hash invariati) Market.NextPrice e LocalPriceTerms,
Tariffs.FreightTerms e PassengerTerms, TownSystem.GrowthOf,
Fleet.DailyHazard, GameClock.YearsAt; Industry.LastEfficiency
transitorio (né salvato né nell'hash).
- Protocollo: RequestDetail kind 11 con un blocco 1 (subject, arg) ed
ExplanationReport 137; il server risponde sempre, anche con available
falso. Nessun campo nei delta, formato dei salvataggi invariato.
- Client: WhyTooltip comune (palette 05, apertura dopo 0,45 s, «in
arrivo…» finché la spiegazione manca) su barra superiore, Mercato,
Scalata, Finanze, scheda industria, Treni e Officine; testi in
strings.csv.
- ADR 0024, PROTOCOL.md, ARCHITECTURE.md, STATE.md; 10 test nuovi in
Economy/ExplanationTests.cs con uguaglianza esatta ai valori del motore.
Refs #44.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Unisce origin/main (audio, ere e obsolescenza, scheda dell'industria e
schermata di connessione) e corregge i rilievi della revisione del
tutorial (ADR 0023 aggiornato).
- Chiave dell'avanzamento senza l'impronta del terreno, che il server
ricalcola e che cambia giocando (città, industrie): origine della
partita, seme, lato, anno d'inizio, regione e compagnia. Un tutorial
ripreso dopo un anno di gioco ritrova la sua voce.
- «Tutorial» apre una partita locale di prova sempre nuova in
user://tutorial-server invece di riprendere l'autosalvataggio del
giocatore e rifare il tutorial lì dentro; con salvataggi locali già
presenti la casella «Mostra il tutorial» parte spenta. Casella e
pulsante passano nella nuova ConnectScreen (MenuScreen non c'è più).
- La casella spuntata vale anche su una voce chiusa o completata (stesso
seme di una partita vecchia).
- Contorno ritagliato dai contenitori a scorrimento, con l'elemento
portato in vista; del tutto nascosto si usa il ripiego.
- Pulsanti del riquadro senza fuoco: Invio e spazio restano alla
partita (Costruisci, pausa) e non saltano il passo.
- La base di «increase» è presa al completamento del passo precedente e
gli esiti dei comandi si valutano subito: un binario costruito appena
dopo conta per il passo nuovo.
- Velocità contata solo dalle richieste di questo client.
- Copione mancante o non valido segnalato nella partita; validazione
dei null ammessi dal JSON.
- Test: chiave stabile con impronta diversa, base al completamento,
piano con la casella, null nel copione. 228 test (208 senza i lenti).
Refs #45.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Correzioni dalla revisione della scheda industria e della schermata di
connessione.
- Dati di altre compagnie: la forza lavoro della scheda 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. Lo stesso filtro vale per provenienze, conteggio e viaggio
medio.
- Prezzo: «prezzo medio realizzato» mescolava una media mobile dei
ricavi con i totali del trimestre in corso. Al suo posto c'è il prezzo
di vendita, cioè il prezzo globale del giorno (SalePrice).
- Avvisi del server: hanno il giorno −1, così il rifiuto di Load o
NewGame non si confonde più con gli eventi del mondo che arrivano
mentre si aspetta il Welcome.
- Schermata di connessione:
- all'apertura avvia la strada scelta l'ultima volta;
- cambiando strada chiude la sessione dell'altra;
- senza sessione «Connetti e riprendi» la apre;
- il cambio di lingua passa la sessione alla schermata nuova;
- la scelta del salvataggio si tiene per id;
- Load e nuova partita chiedono conferma;
- stato del server su 3×2 con la versione del protocollo, salvataggi
su tre colonne, «Attivo da» che avanza.
- Scheda dell'industria:
- collegamenti e nodi non collegati sono leggibili;
- testo per l'industria inattiva;
- revisione e ammodernamento disabilitati, con il motivo, quando il
server li rifiuterebbe;
- l'esito dell'acquisto compare accanto al pulsante;
- le righe lunghe vanno a capo;
- «in sede» al posto di «al lavoro ora».
- Gli avvisi dei comandi compaiono anche sulle schermate a tutto
schermo.
- Pilota automatico:
- la schermata 20 sta su un suo CanvasLayer sopra l'interfaccia;
- 12 e 12b sono ora la scheda a tutto schermo.
- Test: pendolari di altri vettori nascosti, Load rifiutato via
WebSocket, Welcome senza ServerInfo. 202 test, 183 senza i lenti.
Refs #42.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Due revisori hanno trovato 12 rilievi. I principali:
- Il rinnovo si ricontrolla all'avvio dei lavori: piano, spesa e cassa
possono cambiare tra prenotazione e avvio. Se la cassa non basta il
rinnovo si annulla senza pagare e con un avviso, così non va mai in
scoperto.
- La cassa impegnata dai rinnovi prenotati e non ancora avviati
(Obsolescence.Committed) conta per il giocatore e per le IA, così la
stessa cassa non si spende due volte nello stesso mese.
- Le IA comprano il successore solo se non peggiora il treno, e rinnovano
solo se le prestazioni restano almeno quelle di oggi.
- Dopo un deragliamento la ricostruzione non ringiovanisce nel patrimonio
un modello fuori produzione.
- Quadro della flotta e pannelli mostrano un rinnovo già prenotato e la
spesa netta al netto degli altri rinnovi.
Suite completa 210 su 210, client senza avvisi.
Refs #41.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Tutorial facoltativo che accompagna il giocatore dalla mappa alla prima
linea in servizio e poi a Mercato globale, Finanze e La tua scalata. È
un'esperienza del solo client: osserva ciò che il client già riceve
(entità della compagnia in ClientWorld, esiti riusciti dei comandi,
pannello aperto, camera, velocità, anteprime del tracciato), non invia
comandi e non decide regole; Core, Protocol, Server e salvataggi non
cambiano (ADR 0023).
- Copione in assets/tutorial/tutorial.json (19 passi, chiavi di testo
per T(), elemento da evidenziare con ripiego, condizione osservabile),
esportato con il gioco; testi italiani e inglesi in strings.csv.
- Logica pura senza Godot in scripts/Tutorial/Logic: copione con
validazione, fatti, condizioni counter/panel/all/any, macchina a stati,
avanzamento salvato; compilata anche dal progetto dei test (8 test).
- Riquadro non modale in basso a sinistra della mappa, contorno ambra
animato, Avanti / Salta passo / Chiudi tutorial, F1 per nasconderlo o
riaprirlo; nel menu la casella «Mostra il tutorial» (attiva alla prima
partita) e l'opzione «Tutorial».
- Avanzamento per partita in user://settings.cfg, ripreso dopo il
caricamento; il pilota automatico non crea il tutorial.
Refs #45.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
I treni suonano solo se si sentono davvero e solo mentre il server li dà in
marcia; il fischio all'arrivo, che non poteva mai suonare, è tolto.
- Il client non riceve mai un moto Loading (all'arrivo il percorso si svuota e
Projection.Motion non manda nulla): via fischio e tromba all'arrivo da
AudioManager e documenti; tornerà con una modifica del protocollo decisa a
parte. Synth.SteamWhistle e Synth.Horn restano pronti.
- Un treno suona solo con un moto ricevuto da meno di 500 ms
(GameSession.MotionReceivedMs): fermo in stazione o fuori dalla zona
sottoscritta tace invece di restare sull'ultimo moto Moving.
- I candidati oltre metà diagonale non prendono un canale: niente Play e Stop
a ogni fotogramma.
- Clic dei pulsanti collegato una volta sola (IsConnected con un Callable
preparato): MarketPanel riattacca il TradeBox a ogni resoconto.
- Volumi e muto si salvano all'uscita del pannello e di AudioManager se
cambiati, anche chiudendo la finestra con il pannello aperto; lo sfondo
chiude solo con il clic sinistro, non con rotella o tasto destro.
- Sbuffi da 1,2 a 10 al secondo fino a 30 m/s, in modo lineare: seguono la
velocità su tutto l'esercizio; ADR corretto (non è il passo della ruota).
- Tabelle d'onda dei temi limitate alle armoniche sotto il 45 % della
frequenza di campionamento per nota: niente ripiegamento oltre Nyquist.
Refs #46.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
La scheda dell'industria e la schermata di connessione si allineano alle
immagini di riferimento 07 e 09. I dati che mancavano li calcola il Core
con una funzione pura, e viaggiano in blocchi compatibili del protocollo.
Il formato dei salvataggi non cambia (ADR 0021).
- IndustryOutlook calcola la scheda in sola lettura:
- 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, distanza e linea che li collega;
- forza lavoro dai contratti dei pendolari;
- punteggio di crescita del trimestre con le soglie;
- prezzo medio, utile annuo, stazioni che la servono, sblocco
dell'acquisto.
IndustryMath.GrowthScore è ora l'unica formula del punteggio e la usa
anche IndustrySystem: gli hash non cambiano. Nuovi parametri in
balance.json, industry.outlook.
- Protocollo:
- IndustryCard: blocco 1 IndustrySheetInfo;
- Welcome: blocco 1 ServerInfo (versione, sistema, Docker, tempo di
attività, passo del ciclo, client collegati);
- ClientWorld conserva lo stato del server e l'elenco dei salvataggi.
- Client:
- IndustryPanel a tutto schermo, con tre schede, il grafo della
catena, impianti e crescita, e i comandi del proprietario;
- ConnectScreen sostituisce MenuScreen: server locale o in rete,
stato del server, partite salvate, «Connetti e riprendi» e «Nuova
partita sul server» su una sessione di prova;
- testi in strings.csv;
- pilota automatico: schermate 19_scheda_industria e 20_connessione.
- Test:
- IndustryOutlookTests;
- scheda e stato del server via WebSocket;
- campioni del protocollo con i blocchi nuovi.
200 test, 181 senza i lenti.
Refs #42.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
La tecnologia avanzava solo come filtro d'acquisto: nessuna notizia del
cambio d'era, nessun modello «superato», due formule diverse per valore di
libro e rivendita e nessun modo di sostituire i veicoli di un treno. Ora
rinnovare la flotta è una scelta con costi e benefici visibili.
- vehicles.json: successore per modello (validato: stessa categoria,
introdotto dopo) e parametri di obsolescenza; Obsolescence, senza stato,
ricava produzione, superato, successore consigliato, curva del valore
(gradino all'arrivo del successore, poi ammortamento più rapido) e
fattore di manutenzione: una sola fonte per patrimonio, SellVehicle,
rinnovo e quadri.
- Rinnovo come intervento «renewal» di maintenance.json prenotato con
ScheduleService: in officina i veicoli superati si vendono e il
successore prende il loro posto. Nessun comando nuovo.
- EraSystem: il 1° gennaio la notizia dell'era e delle novità dell'anno
lette dai dati, annotata nella Cronaca, una volta sola anche attraverso
un salvataggio.
- Nessuno stato nuovo, quindi il salvataggio resta alla versione 7.
- IA: modelli dei progetti aggiornati quando escono di produzione e
rinnovo mensile con una regola in ai.json.
- Protocollo: DetailKind.Fleet (10) e FleetReport (136); client: catalogo
senza i fuori produzione e con i superati segnati, rivendita, Vendi e
Rinnova nel pannello Treni, sezione «Rinnovo della flotta» in Officine.
- ADR 0020, STATE, ARCHITECTURE e PROTOCOL aggiornati; ErasTests (11).
Accettazione F4 e F5 invariate.
Refs #41.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Il client ora ha l'audio della F6 senza file esterni né download: effetti,
anelli d'ambiente e temi musicali si sintetizzano in memoria all'avvio, su un
altro thread, con classi senza dipendenze da Godot (Synth, MusicComposer,
AudioMix) e semi fissi.
- Bus Master, Music, Ambience, Sfx, Ui creati da codice in modo idempotente,
limitatore sul Master; volumi per bus e muto in user://settings.cfg; pannello
«Audio» dal menu e dall'altoparlante della barra superiore, tasto M.
- AudioManager (figlio di Main) reagisce solo a ciò che il client riceve: clic
dei pulsanti, esiti dei comandi, notifiche per gravità, cantieri completati
dal DailyDigest, fischio o tromba all'arrivo in stazione, fino a 3 treni
vicini al centro con rotolamento, motore e sbuffi modulati dalla velocità,
ambiente dal terreno visibile e dallo zoom, tema per era con dissolvenza.
- Nessuna allocazione nel ciclo per fotogramma; audio spento nel pilota
automatico e senza schermo.
- ADR 0022, STATE e ARCHITECTURE aggiornati; testi in strings.csv.
Non ascoltato: Godot non è eseguibile qui. Funzioni pure provate a parte.
Refs #46.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Corregge i rilievi della revisione della finanza completa (ADR 0019).
- Rating: il margine resta neutro finché la finestra non è piena e ha meno
di finance.ratingMinRevenueMonths (3) mesi con ricavi, così il primo
incasso piccolo dopo mesi di soli costi non fa perdere tre o quattro
gradini (e non fissa uno spread pessimo per dieci anni); senza ricavi e
in perdita il margine è il minimo. Corretta l'affermazione dell'ADR.
- Avvisi di cassa negativa dopo finance.negativeCashNoticeDays (3) giorni
di fila e notizia di rientro solo dopo quel primo avviso: una cassa che
oscilla intorno a zero non riempie le notizie.
- Spiegazione del rating: se il punteggio vale già il gradino sopra lo dice
(NextAlreadyMet, ScoreRating) senza obiettivi negativi né leve infinite
sul filo; il rimborso indicato è segnato come non possibile oggi se
supera la cassa o il residuo dei prestiti (RepayAffordable).
- Nuovi concorrenti: la quota dei trasporti usa Company.TransportRevenue
(tariffe, noli, contratti), non dividendi incassati né commercio.
- Client: barra del conto alla rovescia solo con lo scoperto, frasi intere
con segnaposto in strings.csv, testo distinto per bancarotta e
amministrazione controllata; ClimbOutlook.LoansAllowed allineato.
- PROTOCOL.md: tabella dei valori di LedgerEntry e campi nuovi di
FinanceReport; ServerTests non dipende più dal cambio di mese.
Refs #39.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
La revisione del pannello «La tua scalata» ha trovato numeri che promettevano
più di quanto il motore concede e qualche incoerenza con l'immagine 08.
- Avanzamento: il client mostra le percentuali per difetto (Fmt.Progress),
così il 100 % compare solo a requisito o livello raggiunto; prima 0,996
si leggeva «100%» senza promozione. Il tetto del motore resta 0,999.
- Rating: la frazione è 1 − gradini mancanti / ratingProgressSteps (2,5 in
tiers.json, con schema e validatore). Lo stato dell'immagine 08 torna al
58 % (rating al 60 %); misurato dalla D dava l'86 % per un solo gradino.
- Concessioni: non compaiono più tra gli sblocchi né nella notizia finché il
comando non esiste (F7); il rifiuto dice che non sono ancora disponibili.
- Validatore: gli sblocchi non possono diminuire salendo di livello (fido e
funzioni), come presumono notizie, rifiuti e pannello.
- Industrie possedute inattive (livello 0): a libro valgono solo la cassa.
- Migrazione 1-5: il giorno del livello ricostruito dallo storico è quello
della fotografia (primo giorno dell'anno dopo), tra fondazione e oggi.
- Storico del patrimonio: un punto per anno di calendario (oggi sostituisce
il primo giorno dell'anno in corso); i livelli si segnano sull'anno della
promozione, anche sull'ultimo punto.
- Barra superiore: richiede di nuovo il quadro se uno stato completo lo ha
azzerato.
- ADR 0018 aggiornato; ADR 0015 §12 segnato come sostituito.
- Test nuovi per avanzamento, storico, migrazione, concessioni, industria
inattiva e validatore (174 test verdi).
Refs #38.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
I livelli esistevano dalla F5 ma il giocatore li vedeva solo come distintivo
e come rifiuti con nomi scritti a mano. Ora il motore espone un quadro della
scalata e il client lo mostra come l'immagine di riferimento 08.
- ClimbOutlook (Core, sola lettura): livelli con gli sblocchi letti dai dati,
giorno in cui sono stati raggiunti, requisiti del prossimo livello con
valore, soglia, frazione e avanzamento (media delle tre frazioni, ora
anche nel Mercato globale), stato patrimoniale, conto economico, prestiti,
storico del patrimonio dalla Cronaca.
- Stato patrimoniale con una sola fonte: FinanceSystem.BookValues scompone il
valore contabile per voce e AssetBookValue ne e' la somma, cosi' il pannello
somma al centesimo al patrimonio netto del motore. Le industrie possedute
entrano nel patrimonio (impianti piu' cassa, senza avviamento): prima
comprarle bruciava patrimonio.
- Notizia di promozione con gli sblocchi ottenuti; rifiuti dei comandi
bloccati con il livello che serve e il suo nome dai dati (compravendita,
industrie, quotazione, scalate, concessioni, fido).
- Salvataggio versione 6 (BalanceSheetSerializer) con voci e giorni dei
livelli nell'hash; le versioni 1-5 si migrano con lo stesso patrimonio.
- Protocollo: DetailKind.Climb (8) e ClimbReport (134), su richiesta.
- Client: pannello ClimbPanel a tutto schermo, pulsante Scalata, livello e
avanzamento nella barra superiore, schermata nel pilota automatico.
- Test: Economy/ClimbTests.cs e quadro via WebSocket (170 test verdi).
Decisioni in docs/adr/0018-scalata-e-livelli.md.
Refs #38.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
TestClient.WaitUntil ingoiava il tempo scaduto con ContinueWith(_ => true):
se il moto dell'ultimo tick non arrivava, il test proseguiva e confrontava
un moto vecchio (scarto di 884 m nel rilascio v0.5.0). Ora lo scadere fa
fallire il test, e la pausa si ripete finché coglie il treno in marcia,
perché per un treno fermo il server non rimanda il moto.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Il gioco esportato della release v0.6.0 passa il pilota automatico: la
schermata del Mercato globale entra in docs/screenshots per la Wiki, e
lo STATE registra l'esito della verifica.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Prima versione con i pezzi della F6 già in main: il rilascio esporta il gioco
per verificare con il pilota automatico i nuovi pannelli.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Allinea i giorni degli eventi a quelli annunciati, toglie le sovrapposizioni
di zona e impedisce che l'IA trasformi un effetto temporaneo in un
investimento permanente.
- Un evento è in vigore nei giorni [inizio, fine) per tutti: le
interrogazioni di WorldEventState contano solo gli eventi in vigore nel
giorno dell'orologio, l'usura conta il maltempo del giorno del traffico.
Il maltempo non rallenta più i treni il giorno dell'estrazione e agisce
per intero l'ultimo giorno; l'evento esce dall'elenco il mattino del
primo giorno libero, con la notizia di fine. {until} è l'ultimo giorno.
- Niente zone sovrapposte tra due maltempi o tra due eventi sulla domanda
dello stesso bene (né due boom né boom e crollo insieme): nessuna città
e nessun arco ricevono due volte lo stesso effetto.
- IA: stime dei candidati sulla domanda senza eventi, sui posti scoperti
senza le assenze di epidemie e scioperi (PresentWithoutEvents) e
sull'efficienza senza il moltiplicatore di capacità (ADR 0017 §9).
- 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 in sciopero; dal resoconto il notiziario prende
solo le notizie di fine, le altre arrivano già come Notification.
ADR 0017, STATE, ARCHITECTURE e PROTOCOL aggiornati; 2 test nuovi e
3 adattati alla nuova finestra.
Refs #33.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Aggiunge gli eventi della F6: fatti del mondo che cambiano il gioco per
un periodo limitato, leggibili nel notiziario e reversibili.
- Catalogo data/events.json con schema e validazione: incidente e boom
di un'industria, fiera ed epidemia, boom e crollo della domanda di un
bene in una zona, maltempo su un'area, sciopero di città o deposito.
- Effetti come moltiplicatori letti da un'unica sorgente
(World.WorldEvents) dai sistemi esistenti: capacità delle industrie,
consumi delle città, presenze dei pendolari, velocità dei treni e usura
del binario. A evento finito il moltiplicatore torna 1.
- EventSystem tra le IA e l'hash, con flusso Rng dedicato «events»,
bersaglio in ordine di id, frequenza per mappa scalata dalla difficoltà
(eventFrequencyMultiplier), tetto di 6, niente doppioni, notizie di
inizio e fine in italiano (EventKind.World).
- Salvataggio corpo versione 5 con gli eventi nell'hash; le versioni 1-4
si caricano senza eventi e con la frequenza del preset.
- Protocollo: eventi in corso nel DailyDigest e nel MarketReport; client
con il riquadro «Eventi in corso», avvisi nelle schede e «evento in
corso» nel Mercato globale.
- Lo scenario Valdoria disattiva gli eventi: con gli eventi attivi la
flotta F4 senza linea dei ricambi non scendeva più sotto 40, e
l'accettazione deve misurare la manutenzione, non la fortuna (ADR 0017).
Accettazione F4 invariata: 35 / 20 guasti senza linea, 75 / 2 con.
Decisioni in docs/adr/0017-eventi-del-mondo.md; 17 test nuovi.
Refs #33.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
La revisione ha trovato casi in cui la merce della compagnia, già pagata,
poteva perdersi o restare bloccata, e il magazzino di destinazione
restare prenotato per sempre. Le correzioni:
- Il percorso della merce propria rispetta i flag carico e scarico delle
fermate: LineGraph.From ha l'opzione stopFlags. ShipGoods rifiuta con
Blocked la spedizione che esiste solo ignorando i flag. I pacchetti dei
clienti non cambiano: l'accettazione F4 dà ancora 35/20 e 75/2.
- La scadenza in stazione della merce propria riparte a ogni trasbordo.
- La merce propria in attesa ricalcola ogni giorno il tratto sulle linee
di quel giorno; se non c'è più un percorso torna nel magazzino.
- La merce propria a bordo scende alla prima fermata quando il suo tratto
non è più sulla linea del treno. Un treno che lascia la linea
(riassegnato, al deposito, in riserva, fine copertura) la lascia alla
stazione dove si trova o alla prossima fermata.
- Una stazione con merce propria in partenza o in arrivo non si demolisce.
- La merce propria, in magazzino e in viaggio, entra nel valore contabile
al prezzo globale: un acquisto non abbassa più il patrimonio netto
dell'intero importo.
- Solo l'acquisto richiede lo sblocco del livello: la merce ereditata con
una fusione si vende e si spedisce, e il riquadro del pannello compare.
- Nel riquadro, la stazione di arrivo predefinita è diversa da quella di
partenza.
ADR 0016 e STATE aggiornati; sei test nuovi in TradingTests.
Refs #31.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Dal livello che sblocca il commercio la compagnia può comprare e vendere
merci in proprio. Così può fare arbitraggio tra un produttore con il
magazzino pieno e un consumatore a secco anche dove il vettore non ha
contratti. Le regole sono nell'ADR 0016.
- Ogni stazione della compagnia ha un magazzino: 500 unità e una
giacenza di 25 centesimi per unità al mese, in balance.json, blocco
«trading». La merce in magazzino rientra nell'invariante delle merci.
- BuyGoods compra al prezzo locale marginale dell'ADR 0004, unità per
unità, partendo dal più economico, dai produttori del bacino e dagli
hub. La merce presa dagli hub conta come importata.
- SellGoods vende ai consumatori del bacino partendo dal prezzo più
alto, entro lo spazio libero e la cassa di ciascuno. Vende anche agli
hub, e quella merce conta come esportata.
- Il denaro di entrambi i comandi passa dal registro, sulla voce
«Commercio».
- ShipGoods (comando 40) spedisce la merce propria come pacchetto senza
tariffa né consumatore. Il pacchetto entra nel magazzino di
destinazione, che riserva lo spazio alla partenza. Il percorso dei
pacchetti già esistenti non cambia: l'accettazione F4 dà ancora
35/20 guasti senza la linea e 75/2 con la linea.
- Il salvataggio passa al corpo versione 4 (TradingSerializer). I
salvataggi più vecchi si caricano con i magazzini vuoti, e i magazzini
entrano nell'hash di stato.
- MarketReport porta i magazzini nel blocco 1. Il Mercato globale ha il
riquadro «Compravendita in proprio».
- Le IA non commerciano ancora.
Refs #31.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- «Dove conviene vendere» dice che il prezzo locale è quello della
compravendita in proprio: oggi le consegne del vettore si pagano al prezzo
globale (ADR 0015 §9).
- Gli hub che hanno esaurito la capacità del mese non compaiono tra le
destinazioni.
- Senza compagnia l'avanzamento verso il commercio mostra comunque i
requisiti del livello.
- I quattro test lunghi del mercato sono marcati lenti.
- «oggi» va in cima alla riga del grafico, per non coprire le etichette dei
mesi.
- L'ADR annota la piccola differenza tra offerta e domanda mostrate e quelle
del passo di mercato.
Refs #29.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Prima parte della F6: il pannello «Mercato globale» dell'immagine di
riferimento 06, con i dati calcolati dal server.
- Lo storico dei prezzi globali passa da 360 a 720 giorni. I salvataggi
con lo storico di un anno si migrano al caricamento allungando la
finestra (RollingWindow.Extended), senza cambiare formato.
- MarketOutlook (Core) è un'analisi in sola lettura del mondo: storico
mensile, variazione a 30 giorni, offerta e domanda con la quota
mondiale, scorte in mesi, indice materie prime, previsione a 4 mesi
dalla componente mondiale con banda, destinazioni di vendita ordinate
per prezzo con la linea che le collega, hub, evento in corso e
avanzamento verso la compravendita in proprio. Parametri nuovi in
balance.json (market.outlook); interpretazioni nell'ADR 0015.
- Protocollo: DetailKind.Market (7) e MarketReport (129); il server
risponde su richiesta, il client lo mostra in un pannello a tutto
schermo e il pilota automatico ne fa la schermata 16_mercato.
- Test: finestra allungata e migrazione, storico mensile, previsione
deterministica ed entro i limiti, evento, analisi su Valdoria,
round-trip del messaggio e quadro via WebSocket.
La simulazione non cambia: l'analisi non scrive nel mondo e
l'accettazione F4 dà gli stessi numeri di prima.
Closes#29.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>