I valori principali mostrano al passaggio del mouse un tooltip «perché», con la formula e i suoi termini ai valori di oggi (ADR 0024). Le spiegazioni le calcola il Core con le stesse funzioni che usa la simulazione; il client le mostra soltanto.
Spiegazioni (12)
Prezzo globale e prezzo locale (con domanda e offerta totali e i limiti).
Tariffa merci e tariffa passeggeri.
Efficienza e punteggio di crescita di un'industria.
Crescita delle città.
Condizione del treno, con il componente che determina la stima.
Rating, avanzamento del livello, valore di un veicolo e cassa.
Dove una formula era scritta dentro un sistema, è stata spostata in una funzione comune senza cambiare l'aritmetica: hash di stato e salvataggi non cambiano.
Protocollo
RequestDetail kind 11 (Explain) con il blocco 1 (subject, arg) e il messaggio ExplanationReport (137).
Il server risponde sempre: con available falso per bersagli inesistenti o di un'altra compagnia.
Client
WhyTooltip è un tooltip comune nello stile della palette 05. Si apre dopo 0,45 s, chiede la spiegazione a ogni apertura e resta aperto anche quando il pannello ricostruisce le righe.
È applicato a barra superiore, Mercato, Scalata, Finanze, scheda industria, Treni e Officine.
Due revisori hanno trovato 15 rilievi, tutti corretti. L'allineamento con main (tutorial) è stato risolto tenendo entrambe le parti.
## Cosa cambia e perché
I valori principali mostrano al passaggio del mouse un tooltip «perché», con la formula e i suoi termini ai valori di oggi (ADR 0024). Le spiegazioni le calcola il Core con le stesse funzioni che usa la simulazione; il client le mostra soltanto.
**Spiegazioni (12)**
- Prezzo globale e prezzo locale (con domanda e offerta totali e i limiti).
- Tariffa merci e tariffa passeggeri.
- Efficienza e punteggio di crescita di un'industria.
- Crescita delle città.
- Condizione del treno, con il componente che determina la stima.
- Rating, avanzamento del livello, valore di un veicolo e cassa.
Dove una formula era scritta dentro un sistema, è stata spostata in una funzione comune senza cambiare l'aritmetica: hash di stato e salvataggi non cambiano.
**Protocollo**
- `RequestDetail` kind 11 (`Explain`) con il blocco 1 (`subject`, `arg`) e il messaggio `ExplanationReport` (137).
- Il server risponde sempre: con `available` falso per bersagli inesistenti o di un'altra compagnia.
**Client**
- `WhyTooltip` è un tooltip comune nello stile della palette 05. Si apre dopo 0,45 s, chiede la spiegazione a ogni apertura e resta aperto anche quando il pannello ricostruisce le righe.
- È applicato a barra superiore, Mercato, Scalata, Finanze, scheda industria, Treni e Officine.
Due revisori hanno trovato 15 rilievi, tutti corretti. L'allineamento con main (tutorial) è stato risolto tenendo entrambe le parti.
Closes #44
## Fase
F6
## Verifica
- [x] `scripts/build.sh` verde
- [x] `scripts/test.sh --skip-slow` verde dopo l'allineamento: 218 su 218
- [x] Client: 0 avvisi, 0 errori
- [x] `strings.csv`: solo righe aggiunte
- [x] `docs/STATE.md`, `ARCHITECTURE.md`, `PROTOCOL.md` aggiornati, ADR 0024
- [ ] Prova in Godot: non possibile qui
🤖 Generated with [Claude Code](https://claude.com/claude-code)
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>
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>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Cosa cambia e perché
I valori principali mostrano al passaggio del mouse un tooltip «perché», con la formula e i suoi termini ai valori di oggi (ADR 0024). Le spiegazioni le calcola il Core con le stesse funzioni che usa la simulazione; il client le mostra soltanto.
Spiegazioni (12)
Dove una formula era scritta dentro un sistema, è stata spostata in una funzione comune senza cambiare l'aritmetica: hash di stato e salvataggi non cambiano.
Protocollo
RequestDetailkind 11 (Explain) con il blocco 1 (subject,arg) e il messaggioExplanationReport(137).availablefalso per bersagli inesistenti o di un'altra compagnia.Client
WhyTooltipè un tooltip comune nello stile della palette 05. Si apre dopo 0,45 s, chiede la spiegazione a ogni apertura e resta aperto anche quando il pannello ricostruisce le righe.Due revisori hanno trovato 15 rilievi, tutti corretti. L'allineamento con main (tutorial) è stato risolto tenendo entrambe le parti.
Closes #44
Fase
F6
Verifica
scripts/build.shverdescripts/test.sh --skip-slowverde dopo l'allineamento: 218 su 218strings.csv: solo righe aggiuntedocs/STATE.md,ARCHITECTURE.md,PROTOCOL.mdaggiornati, ADR 0024🤖 Generated with Claude Code