F6: tooltip «perché» sui valori calcolati dal server #52

Merged
Alby96 merged 3 commits from claude/f6-tooltip into main 2026-11-08 15:49:00 +01:00
Owner

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

  • scripts/build.sh verde
  • scripts/test.sh --skip-slow verde dopo l'allineamento: 218 su 218
  • Client: 0 avvisi, 0 errori
  • strings.csv: solo righe aggiunte
  • docs/STATE.md, ARCHITECTURE.md, PROTOCOL.md aggiornati, ADR 0024
  • Prova in Godot: non possibile qui

🤖 Generated with Claude Code

## 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)
Alby96 added 3 commits 2026-11-08 15:43:25 +01:00
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>
Merge remote-tracking branch 'origin/main' into claude/f6-tooltip
CI / Build e test (pull_request) Successful in 1m37s
CI / Immagine Docker (pull_request) Successful in 35s
69416e7db8
# Conflicts:
#	client/RailEnterprise.Client/scripts/Hud/TopBar.cs
#	docs/STATE.md
Alby96 merged commit 4bea03ab6b into main 2026-11-08 15:49:00 +01:00
Alby96 deleted branch claude/f6-tooltip 2026-11-08 15:49:01 +01:00
Sign in to join this conversation.