F6: tooltip perché, correzioni della revisione

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>
This commit is contained in:
Alby96andClaude Opus 5.5 committed 2026-11-08 15:39:47 +01:00
1 parent 19a3dd3af1
commit 4beedd2e75
14 files changed
+381 -112

No files matched your search

@@ -828,6 +828,7 @@ Audio (M: muto),,Audio (M: mute)
Perché questo valore,,Why this value
in arrivo…,,on its way…
aggiornamento in arrivo…,,update on its way…
Il numero sul pannello è di inizio giornata; qui c'è quello di adesso.,,The number on the panel is from the start of the day; this is the current one.
motore,,engine
freni,,brakes
cassa,,body
@@ -842,13 +843,18 @@ Domanda della regione (finestra),,Regional demand (window)
Offerta della regione (finestra),,Regional supply (window)
Prezzo mondiale,,World price
Scambi con il resto del mondo,,Trade with the rest of the world
Rapporto domanda / offerta (con il mondo),,Demand / supply ratio (with the world)
Rapporto domanda / offerta (con il mondo, limitato),,"Demand / supply ratio (with the world, bounded)"
Elasticità degli scambi con il mondo,,Elasticity of trade with the world
Domanda con il resto del mondo,,Demand including the rest of the world
Offerta con il resto del mondo,,Supply including the rest of the world
Rapporto minimo,,Minimum ratio
Rapporto massimo,,Maximum ratio
Sensibilità al rapporto,,Sensitivity to the ratio
Prezzo minimo,,Minimum price
Prezzo massimo,,Maximum price
Prezzo obiettivo,,Target price
Peso del giorno,,Weight of the day
"D e S comprendono gli scambi con il resto del mondo al prezzo mondiale, che segue il ciclo economico e gli shock.",,"D and S include trade with the rest of the world at the world price, which follows the business cycle and shocks."
"D e S sono la domanda e l'offerta della regione; Dtot e Stot aggiungono gli scambi con il resto del mondo al prezzo mondiale, che segue il ciclo economico e gli shock.",,"D and S are the regional demand and supply; Dtot and Stot add trade with the rest of the world at the world price, which follows the business cycle and shocks."
Il prezzo è cambiato dopo l'ultimo passo del mercato.,,The price changed after the last market step.
Prezzo locale,,Local price
"Prezzo a cui l'industria compra la prossima unità: Dl è la scorta desiderata dell'ingresso, Sl la scorta.",,"Price at which the industry buys the next unit: Dl is the desired input stock, Sl the stock."
@@ -907,7 +913,8 @@ Giacimento,,Deposit
margine,,margin
Margine (media mobile),,Margin (moving average)
condizione,,condition
Condizione degli impianti (0–100),,Plant condition (0–100)
Condizione degli impianti alla produzione (0–100),,Plant condition at production (0–100)
"lavoro = min(cL, cP) × pf × mc (0 se ferma); e = lavoro × cI × g × ev",,"work = min(cL, cP) × pf × mc (0 if stopped); e = work × cI × g × ev"
"Industria ferma (guasto, incidente, revisione o ammodernamento): il ritmo del lavoro è zero.",,"Industry stopped (failure, accident, overhaul or upgrade): the work pace is zero."
Livello 0: l'industria è inattiva.,,Level 0: the industry is inactive.
Sopra la soglia di crescita per i trimestri richiesti il livello sale; sotto la soglia di calo scende.,,Above the growth threshold for the required quarters the level rises; below the decline threshold it falls.
@@ -954,7 +961,11 @@ Condizione del treno,,Train condition
Componente più debole,,Weakest component
veicolo,,vehicle
Veicolo,,Vehicle
Usura al giorno (media mobile),,Wear per day (moving average)
Usura al giorno del componente (media mobile),,Component wear per day (moving average)
Componente che dà la stima,,Component driving the estimate
Veicolo del componente della stima,,Vehicle of the estimate component
veicolo cs,,vehicle cs
Il componente è già all'obiettivo o sotto: la stima vale −margine.,,The component is already at or below the target: the estimate is −margin.
c rischio,,c risk
Componente più a rischio,,Component most at risk
Rischio di base al giorno,,Base risk per day
@@ -972,7 +983,7 @@ stima,,estimate
Giorni all'intervento sulla condizione,,Days to condition-based maintenance
Nessuna stima del pianificatore: i componenti non si sono ancora consumati.,,No planner estimate: the components have not worn yet.
Il guasto è estratto ogni giorno con il rischio h: 1/h è il numero medio di giorni prima del prossimo.,,A failure is drawn every day with risk h: 1/h is the average number of days before the next one.
"c = min(componenti); h = h₀·exp(k·(c₀ − c)/σ) sotto c₀, altrimenti h₀/div; stima = (c − obiettivo)/usura − margine",,"c = min(components); h = h₀·exp(k·(c₀ − c)/σ) below c₀, otherwise h₀/div; estimate = (c − target)/wear − margin"
"c = min(componenti); h = h₀·exp(k·(c₀ − c)/σ) sotto c₀, altrimenti h₀/div; stima = min sui componenti di (cs − obiettivo)/usura − margine",,"c = min(components); h = h₀·exp(k·(c₀ − c)/σ) below c₀, otherwise h₀/div; estimate = min over components of (cs − target)/wear − margin"
Valore del veicolo,,Vehicle value
prezzo,,price
Prezzo di listino,,List price
1 keys it en
828 Perché questo valore Why this value
829 in arrivo… on its way…
830 aggiornamento in arrivo… update on its way…
831 Il numero sul pannello è di inizio giornata; qui c'è quello di adesso. The number on the panel is from the start of the day; this is the current one.
832 motore engine
833 freni brakes
834 cassa body
843 Offerta della regione (finestra) Regional supply (window)
844 Prezzo mondiale World price
845 Scambi con il resto del mondo Trade with the rest of the world
846 Rapporto domanda / offerta (con il mondo) Rapporto domanda / offerta (con il mondo limitato) Demand / supply ratio (with the world)
847 Elasticità degli scambi con il mondo Elasticity of trade with the world
848 Domanda con il resto del mondo Demand including the rest of the world
849 Offerta con il resto del mondo Supply including the rest of the world
850 Rapporto minimo Minimum ratio
851 Rapporto massimo Maximum ratio
852 Sensibilità al rapporto Sensitivity to the ratio
853 Prezzo minimo Minimum price
854 Prezzo massimo Maximum price
855 Prezzo obiettivo Target price
856 Peso del giorno Weight of the day
857 D e S comprendono gli scambi con il resto del mondo al prezzo mondiale, che segue il ciclo economico e gli shock. D e S sono la domanda e l'offerta della regione; Dtot e Stot aggiungono gli scambi con il resto del mondo al prezzo mondiale, che segue il ciclo economico e gli shock. D and S include trade with the rest of the world at the world price, which follows the business cycle and shocks. D and S are the regional demand and supply; Dtot and Stot add trade with the rest of the world at the world price, which follows the business cycle and shocks.
858 Il prezzo è cambiato dopo l'ultimo passo del mercato. The price changed after the last market step.
859 Prezzo locale Local price
860 Prezzo a cui l'industria compra la prossima unità: Dl è la scorta desiderata dell'ingresso, Sl la scorta. Price at which the industry buys the next unit: Dl is the desired input stock, Sl the stock.
913 margine margin
914 Margine (media mobile) Margin (moving average)
915 condizione condition
916 Condizione degli impianti (0–100) Condizione degli impianti alla produzione (0–100) Plant condition (0–100) Plant condition at production (0–100)
917 lavoro = min(cL, cP) × pf × mc (0 se ferma); e = lavoro × cI × g × ev work = min(cL, cP) × pf × mc (0 if stopped); e = work × cI × g × ev
918 Industria ferma (guasto, incidente, revisione o ammodernamento): il ritmo del lavoro è zero. Industry stopped (failure, accident, overhaul or upgrade): the work pace is zero.
919 Livello 0: l'industria è inattiva. Level 0: the industry is inactive.
920 Sopra la soglia di crescita per i trimestri richiesti il livello sale; sotto la soglia di calo scende. Above the growth threshold for the required quarters the level rises; below the decline threshold it falls.
961 Componente più debole Weakest component
962 veicolo vehicle
963 Veicolo Vehicle
964 Usura al giorno (media mobile) Usura al giorno del componente (media mobile) Wear per day (moving average) Component wear per day (moving average)
965 Componente che dà la stima Component driving the estimate
966 Veicolo del componente della stima Vehicle of the estimate component
967 veicolo cs vehicle cs
968 Il componente è già all'obiettivo o sotto: la stima vale −margine. The component is already at or below the target: the estimate is −margin.
969 c rischio c risk
970 Componente più a rischio Component most at risk
971 Rischio di base al giorno Base risk per day
983 Giorni all'intervento sulla condizione Days to condition-based maintenance
984 Nessuna stima del pianificatore: i componenti non si sono ancora consumati. No planner estimate: the components have not worn yet.
985 Il guasto è estratto ogni giorno con il rischio h: 1/h è il numero medio di giorni prima del prossimo. A failure is drawn every day with risk h: 1/h is the average number of days before the next one.
986 c = min(componenti); h = h₀·exp(k·(c₀ − c)/σ) sotto c₀, altrimenti h₀/div; stima = (c − obiettivo)/usura − margine c = min(componenti); h = h₀·exp(k·(c₀ − c)/σ) sotto c₀, altrimenti h₀/div; stima = min sui componenti di (cs − obiettivo)/usura − margine c = min(components); h = h₀·exp(k·(c₀ − c)/σ) below c₀, otherwise h₀/div; estimate = (c − target)/wear − margin c = min(components); h = h₀·exp(k·(c₀ − c)/σ) below c₀, otherwise h₀/div; estimate = min over components of (cs − target)/wear − margin
987 Valore del veicolo Vehicle value
988 prezzo price
989 Prezzo di listino List price
@@ -2,6 +2,7 @@ using Godot;
using RailEnterprise.Client.App;
using RailEnterprise.Client.Net;
using RailEnterprise.Client.Panels;
using RailEnterprise.Core.Common;
using RailEnterprise.Core.Economy;
using RailEnterprise.Protocol.Messages;
using static RailEnterprise.Client.App.Localization;
@@ -70,7 +71,9 @@ public partial class TopBar : PanelContainer
row.AddChild(Stat(T("Patrimonio netto"), _worth));
row.AddChild(Stat(T("Rating"), _rating));
// tooltip «perché» (ADR 0024): cassa con i movimenti del mese, rating, avanzamento del livello
WhyTooltip.Attach(_cash, () => new ExplainTarget(ExplainSubject.Cash));
// la cassa della barra è quella dell'ultimo aggiornamento delle entità (inizio giornata o dopo un comando),
// la spiegazione è di adesso: se differiscono il tooltip lo dice
WhyTooltip.Attach(_cash, () => new ExplainTarget(ExplainSubject.Cash), shown: () => ShownCash()?.Cents);
WhyTooltip.Attach(_rating, () => new ExplainTarget(ExplainSubject.Rating));
WhyTooltip.Attach(tierBox, () => new ExplainTarget(ExplainSubject.TierProgress), T("Clic per aprire «La tua scalata»"));
var chip = new PanelContainer();
@@ -104,6 +107,17 @@ public partial class TopBar : PanelContainer
public void Bind(GameSession session) => _session = session;
/// <summary>
/// Cassa mostrata: quella della compagnia nelle entità, aggiornata a inizio giornata e dopo ogni comando
/// (un prestito, un acquisto), altrimenti quella del resoconto del giorno.
/// </summary>
private Money? ShownCash()
{
var w = _session?.World;
if (w?.Summary is null) return null;
return w.Companies.GetValueOrDefault(w.Summary.CompanyId)?.Cash ?? w.LastDigest?.Cash;
}
public override void _Process(double delta)
{
var w = _session?.World;
@@ -128,7 +142,7 @@ public partial class TopBar : PanelContainer
: climb is not null && climb.Tier == tier ? $"{Fmt.Progress(climb.Progress)} {T("verso")} {Fmt.Tier(w, tier + 1)}"
: $"{T("prossimo")}: {Fmt.Tier(w, tier + 1)}";
_date.Text = w.LastDigest?.Date ?? w.Summary.Date;
_cash.Text = (w.LastDigest?.Cash ?? me?.Cash ?? default).ToString();
_cash.Text = (ShownCash() ?? default).ToString();
_worth.Text = (w.LastDigest?.NetWorth ?? me?.NetWorth ?? default).ToString("short");
_rating.Text = w.LastDigest?.Rating ?? me?.Rating ?? "—";
byte speed = _session!.RequestedSpeed ?? w.LastDigest?.Speed ?? w.Speed;
@@ -67,7 +67,7 @@ public partial class FinancePanel : VBoxContainer
_cash.HorizontalAlignment = HorizontalAlignment.Right;
cash.AddChild(cashCaption);
cash.AddChild(_cash);
WhyTooltip.Attach(_cash, () => new ExplainTarget(ExplainSubject.Cash));
WhyTooltip.Attach(_cash, () => new ExplainTarget(ExplainSubject.Cash), shown: () => _session.World.Finance?.Cash.Cents);
header.AddChild(cash);
var close = new Button { Text = T("Torna alla mappa"), SizeFlagsVertical = SizeFlags.ShrinkCenter, CustomMinimumSize = new Vector2(170, 48) };
close.Pressed += () => CloseRequested?.Invoke();
@@ -439,9 +439,16 @@ public partial class MarketPanel : VBoxContainer
line.ClipText = true;
line.TextOverrunBehavior = TextServer.OverrunBehavior.TrimEllipsis;
row.AddChild(line);
box.TooltipText = p.Line >= 0
// il suggerimento della riga sta sul nome e sulla linea, non sul riquadro: sul prezzo c'è il tooltip «perché»,
// e il suggerimento nativo di un antenato gli comparirebbe sopra
string tip = p.Line >= 0
? $"{name}: {T("servita dalla tua linea")} {LineName(w, p.Line)}"
: $"{name}: {T("nessuna tua stazione servita da una linea con treni ha questa destinazione nel bacino")}";
foreach (var l in new[] { label, line })
{
l.TooltipText = tip;
l.MouseFilter = MouseFilterEnum.Pass;
}
return box;
}
@@ -10,10 +10,13 @@ namespace RailEnterprise.Client.Panels;
/// <summary>
/// Tooltip «perché» comune (F6, ADR 0024): sopra un valore dei pannelli, dopo un breve ritardo, mostra la
/// spiegazione calcolata dal server (titolo, valore, formula, termini con i valori di oggi, note) nello stile
/// della palette 05. Il client non calcola nulla: se la spiegazione manca o è di un giorno passato la chiede
/// (RequestDetail con DetailKind.Explain) e intanto mostra «in arrivo…». Un solo tooltip per schermata, su
/// un suo CanvasLayer sopra l'interfaccia; i pannelli lo agganciano con <see cref="Attach"/>.
/// spiegazione calcolata dal server (titolo, valore, formula, termini con i valori di adesso, note) nello stile
/// della palette 05. Il client non calcola nulla: a ogni apertura chiede la spiegazione (RequestDetail con
/// DetailKind.Explain) e poi, finché il puntatore resta, al più una volta al secondo per valore; intanto mostra
/// quella in cache con «aggiornamento in arrivo…» (o «in arrivo…» se manca). Un solo tooltip per schermata, su
/// un suo CanvasLayer sopra l'interfaccia; i pannelli lo agganciano con <see cref="Attach"/>. Se il controllo
/// sotto il puntatore viene ricostruito (i pannelli rifanno le righe a ogni scheda), il tooltip passa al
/// sostituto con la stessa spiegazione senza chiudersi.
/// </summary>
public partial class WhyTooltip : PanelContainer
{
@@ -22,20 +25,36 @@ public partial class WhyTooltip : PanelContainer
/// <summary>Ritardo prima dell'apertura (secondi).</summary>
private const double OpenDelay = 0.45;
/// <summary>Intervallo minimo tra due richieste della stessa spiegazione (secondi).</summary>
private const double RequestInterval = 1.0;
/// <summary>Intervallo minimo tra due richieste della stessa spiegazione (millisecondi).</summary>
private const ulong RequestIntervalMs = 1000;
/// <summary>Tempo per trovare il sostituto di un controllo ricostruito prima di chiudere (secondi).</summary>
private const double ReplaceGrace = 0.3;
private const float MaxWidth = 440;
/// <summary>Aggancio di un controllo: bersaglio, suggerimento e, se serve, il valore che il controllo mostra.</summary>
private sealed record Hook(Control Control, Func<ExplainTarget?> Target, string Hint, Func<double?>? Shown);
/// <summary>Agganci dei controlli nell'albero, per ritrovare il sostituto di un controllo ricostruito.</summary>
private static readonly List<Hook> Hooks = [];
private readonly GameSession _session;
private readonly VBoxContainer _body = new();
private Control? _hover;
private Func<ExplainTarget?>? _target;
private string _hint = "";
private Hook? _hook;
/// <summary>Il controllo agganciato è stato tolto o sta per esserlo: si cerca il sostituto sotto il puntatore.</summary>
private bool _lost;
private double _lostFor;
private (byte Subject, int Target, int Arg) _key;
private bool _hasKey;
private double _wait;
private double _sinceRequest = double.MaxValue;
private int _shownVersion = -1;
/// <summary>Spiegazione in cache all'apertura: finché non ne arriva un'altra si mostra come in aggiornamento.</summary>
private ExplanationReport? _baseline;
private bool _fresh;
private ExplanationReport? _shown;
private bool _shownFresh;
private bool _dirty = true;
private bool _settling;
/// <summary>Per valore: istante dell'ultima richiesta e spiegazione in cache in quel momento.</summary>
private readonly Dictionary<(byte, int, int), (ulong At, ExplanationReport? Before)> _requests = [];
public WhyTooltip(GameSession session)
{
@@ -60,74 +79,177 @@ public partial class WhyTooltip : PanelContainer
/// Aggancia il tooltip a un controllo: al passaggio del mouse chiede a <paramref name="target"/> quale valore
/// spiegare (null: nessuna spiegazione per ora). Il controllo riceve il mouse senza fermare i clic dei genitori.
/// <paramref name="hint"/> (già tradotto) compare in fondo, per esempio che un clic apre un pannello.
/// <paramref name="shown"/> dà il numero che il controllo mostra (nell'unità della spiegazione), quando può
/// essere di un altro momento della giornata: se differisce da quello spiegato il tooltip lo dice.
/// </summary>
public static void Attach(Control control, Func<ExplainTarget?> target, string hint = "")
public static void Attach(Control control, Func<ExplainTarget?> target, string hint = "", Func<double?>? shown = null)
{
var hook = new Hook(control, target, hint, shown);
if (control.MouseFilter == MouseFilterEnum.Ignore) control.MouseFilter = MouseFilterEnum.Pass;
control.MouseEntered += () => Instance?.Enter(control, target, hint);
control.MouseExited += () => Instance?.Leave(control);
control.MouseEntered += () => Instance?.Enter(hook);
control.MouseExited += () => Instance?.Leave(hook);
control.TreeEntered += () =>
{
if (!Hooks.Contains(hook)) Hooks.Add(hook);
};
control.TreeExiting += () => Hooks.Remove(hook);
if (control.IsInsideTree()) Hooks.Add(hook);
}
private void Enter(Control control, Func<ExplainTarget?> target, string hint)
private static (byte, int, int)? KeyOf(Hook hook) =>
hook.Target() is { Subject: not ExplainSubject.None } t ? ((byte)t.Subject, t.A, t.B) : null;
private void Enter(Hook hook)
{
_hover = control;
_target = target;
_hint = hint;
if (_hook == hook)
{
_lost = false;
return;
}
// il sostituto di un controllo ricostruito, con la stessa spiegazione: il tooltip resta aperto
if (_hook is not null && _hasKey && KeyOf(hook) == _key)
{
Adopt(hook);
return;
}
_hook = hook;
_lost = false;
_lostFor = 0;
_wait = 0;
_hasKey = false;
_shown = null;
_shownVersion = -1;
_dirty = true;
Visible = false;
}
private void Leave(Control control)
private void Leave(Hook hook)
{
if (_hover != control) return;
_hover = null;
_target = null;
if (_hook != hook) return;
// tolto dall'albero o in via di liberazione: il pannello lo sta ricostruendo, si cerca il sostituto
if (Doomed(hook.Control)) _lost = true;
else Close();
}
private void Adopt(Hook hook)
{
_hook = hook;
_lost = false;
_lostFor = 0;
}
private void Close()
{
_hook = null;
_lost = false;
_hasKey = false;
Visible = false;
}
/// <summary>Il controllo non c'è più o sta per essere liberato (lui o un suo antenato).</summary>
private static bool Doomed(Control c)
{
if (!IsInstanceValid(c) || !c.IsInsideTree()) return true;
for (Node? n = c; n is not null; n = n.GetParent())
{
if (n.IsQueuedForDeletion()) return true;
}
return false;
}
/// <summary>Il controllo agganciato, vivo e visibile, sotto il puntatore con la stessa spiegazione (il più piccolo).</summary>
private Hook? Replacement()
{
Hook? best = null;
float area = float.MaxValue;
foreach (var h in Hooks)
{
var c = h.Control;
if (Doomed(c) || !c.IsVisibleInTree()) continue;
var rect = c.GetGlobalRect();
if (!rect.HasPoint(c.GetGlobalMousePosition())) continue;
if (_hasKey && KeyOf(h) != _key) continue;
float a = rect.Size.X * rect.Size.Y;
if (a >= area) continue;
area = a;
best = h;
}
return best;
}
public override void _Process(double delta)
{
if (_hover is null || _target is null) return;
if (!IsInstanceValid(_hover) || !_hover.IsVisibleInTree())
if (_hook is null) return;
var control = _hook.Control;
if (_lost || Doomed(control))
{
Leave(_hover);
if (Replacement() is { } next) Adopt(next);
else
{
_lostFor += delta;
if (_lostFor > ReplaceGrace) Close();
return;
}
control = _hook.Control;
}
else if (!control.IsVisibleInTree() || !control.GetGlobalRect().HasPoint(control.GetGlobalMousePosition()))
{
// nascosto, oppure il puntatore è uscito senza che il controllo l'abbia mai saputo (sostituto adottato)
Close();
return;
}
_wait += delta;
_sinceRequest += delta;
if (_wait < OpenDelay) return;
if (_target() is not { Subject: not ExplainSubject.None } t)
if (_hook.Target() is not { Subject: not ExplainSubject.None } t)
{
Visible = false;
return;
}
var key = ((byte)t.Subject, t.A, t.B);
var w = _session.World;
if (key != _key)
{
_key = key;
_sinceRequest = double.MaxValue;
_shown = null;
_shownVersion = -1;
}
var e = w.Explanations.GetValueOrDefault(key);
// una spiegazione di un giorno passato si mostra finché arriva quella di oggi
bool stale = e is null || e.Day < Fmt.Today(w);
if (stale && _sinceRequest >= RequestInterval && _session.IsOpen)
ulong now = Time.GetTicksMsec();
_requests.TryGetValue(key, out var last);
bool recent = last.At > 0 && now - last.At < RequestIntervalMs;
if (!_hasKey || key != _key)
{
_sinceRequest = 0;
_hasKey = true;
_key = key;
// quella in cache vale solo se è la risposta a una richiesta di meno di un secondo fa
_fresh = e is not null && recent && !ReferenceEquals(e, last.Before);
_baseline = e;
_shown = null;
_dirty = true;
}
if (!_fresh && e is not null && !ReferenceEquals(e, _baseline)) _fresh = true;
// a ogni apertura e poi al più una volta al secondo per valore, finché il puntatore resta
if (!recent && _session.IsOpen)
{
if (_requests.Count > 64) Prune(now);
_requests[key] = (now, e);
_session.Send(new RequestDetail { Kind = DetailKind.Explain, Target = t.A, Subject = (byte)t.Subject, Arg = t.B });
}
if (!ReferenceEquals(e, _shown) || _shownVersion < 0)
if (_dirty || !ReferenceEquals(e, _shown) || _fresh != _shownFresh)
{
_dirty = false;
_shown = e;
_shownVersion = w.ExplanationVersion;
_shownFresh = _fresh;
Rebuild(w, e, t);
// il riquadro si misura al prossimo fotogramma, a impaginazione fatta: niente salti di lato
_settling = true;
return;
}
if (_settling)
{
_settling = false;
Size = Vector2.Zero;
}
Visible = true;
Place();
Visible = true;
}
private void Prune(ulong now)
{
foreach (var k in _requests.Where(r => now - r.Value.At >= RequestIntervalMs).Select(r => r.Key).ToList()) _requests.Remove(k);
}
/// <summary>Vicino al puntatore, in basso a destra, dentro la finestra.</summary>
@@ -145,9 +267,14 @@ public partial class WhyTooltip : PanelContainer
private void Rebuild(Protocol.Client.ClientWorld w, ExplanationReport? e, ExplainTarget t)
{
foreach (var child in _body.GetChildren()) child.QueueFree();
// via subito dall'albero: la misura del riquadro non deve contare i figli vecchi
foreach (var child in _body.GetChildren())
{
_body.RemoveChild(child);
child.QueueFree();
}
Content(w, e, t);
if (_hint.Length > 0) _body.AddChild(UiTheme.Text(_hint, 12, Palette.Amber));
if (_hook?.Hint is { Length: > 0 } hint) _body.AddChild(UiTheme.Text(hint, 12, Palette.Amber));
}
private void Content(Protocol.Client.ClientWorld w, ExplanationReport? e, ExplainTarget t)
@@ -167,7 +294,8 @@ public partial class WhyTooltip : PanelContainer
foreach (var n in e.Notes) _body.AddChild(Wrapped(T(n), 13, Palette.TextSecondary));
return;
}
string value = Format(e.Value, e.Unit, (ExplainSubject)e.Subject);
var subject = (ExplainSubject)e.Subject;
string value = Format(e.Value, e.Unit, subject, headline: true);
_body.AddChild(UiTheme.TitleLabel(e.ValueText.Length > 0 ? $"{e.ValueText} ({value})" : value, 28, Palette.Text));
if (e.Formula.Length > 0)
{
@@ -187,7 +315,11 @@ public partial class WhyTooltip : PanelContainer
var symbol = UiTheme.Text(term.Symbol.Length >= 3 ? T(term.Symbol) : term.Symbol, 13, Palette.Amber, bold: true);
var label = UiTheme.Text(T(term.Label), 13, Palette.TextSecondary);
label.SizeFlagsHorizontal = SizeFlags.ExpandFill;
var v = UiTheme.Text(term.Unit == (byte)ExplainUnit.Text ? Translated(term.Text) : Format(term.Value, term.Unit, (ExplainSubject)e.Subject), 13, bold: true);
// un termine numerico può portare anche un testo (il componente del veicolo): si mostrano entrambi
string text = term.Unit == (byte)ExplainUnit.Text ? Translated(term.Text)
: term.Text.Length > 0 ? $"{Format(term.Value, term.Unit, subject)} · {Translated(term.Text)}"
: Format(term.Value, term.Unit, subject);
var v = UiTheme.Text(text, 13, bold: true);
v.HorizontalAlignment = HorizontalAlignment.Right;
foreach (var l in new[] { symbol, label, v }) l.MouseFilter = MouseFilterEnum.Ignore;
grid.AddChild(symbol);
@@ -197,7 +329,9 @@ public partial class WhyTooltip : PanelContainer
_body.AddChild(grid);
}
foreach (var n in e.Notes) _body.AddChild(Wrapped(T(n), 12, Palette.TextSecondary));
if (e.Day < Fmt.Today(w)) _body.AddChild(UiTheme.Text(T("aggiornamento in arrivo…"), 12, Palette.TextSecondary));
if (_hook?.Shown?.Invoke() is { } shown && Format(shown, e.Unit, subject, headline: true) != value)
_body.AddChild(Wrapped(T("Il numero sul pannello è di inizio giornata; qui c'è quello di adesso."), 12, Palette.TextSecondary));
if (!_fresh) _body.AddChild(UiTheme.Text(T("aggiornamento in arrivo…"), 12, Palette.TextSecondary));
}
/// <summary>Nome dell'oggetto: i beni nella lingua dell'interfaccia, il resto com'è (nomi propri dal server).</summary>
@@ -222,23 +356,30 @@ public partial class WhyTooltip : PanelContainer
_ => text,
};
/// <summary>Formato del valore secondo l'unità, con gli arrotondamenti dei pannelli.</summary>
public static string Format(double v, byte unit, ExplainSubject subject)
/// <summary>
/// Formato del valore secondo l'unità, con gli arrotondamenti dei pannelli: prezzi come la scheda
/// dell'industria (<see cref="Fmt.PricePrecise"/>), importi sotto ₤ 1.000 con i centesimi (tariffe), la
/// condizione per difetto con il segno di percentuale come le officine (intera nel valore principale, con
/// un decimale nei termini).
/// </summary>
public static string Format(double v, byte unit, ExplainSubject subject, bool headline = false)
{
if (double.IsPositiveInfinity(v)) return "∞";
if (double.IsNegativeInfinity(v)) return "−∞";
if (double.IsNaN(v)) return "—";
return (ExplainUnit)unit switch
{
ExplainUnit.Money => new Money((long)Math.Round(v)).ToString(),
ExplainUnit.Price => Money.FromCentsRounded(v).ToString(),
ExplainUnit.Money => new Money((long)Math.Round(v)).ToString(Math.Abs(v) < 100_000 ? "it2" : "it"),
ExplainUnit.Price => Fmt.PricePrecise(v),
// l'avanzamento si legge per difetto come nella barra superiore e nella scalata (ADR 0018)
ExplainUnit.Percent => subject == ExplainSubject.TierProgress ? Fmt.Progress(v) : Fmt.Pct(v, Math.Abs(v) < 0.01 && v != 0 ? 3 : 1),
ExplainUnit.Factor => "× " + Fmt.Number(v, 3),
ExplainUnit.Km => Fmt.Number(v, 1) + " km",
ExplainUnit.Days => Fmt.Number(v, 1) + " " + T("giorni"),
ExplainUnit.Units => Fmt.Number(v, Math.Abs(v - Math.Round(v)) < 1e-9 ? 0 : 1),
ExplainUnit.Condition => Fmt.Number(v, 1),
ExplainUnit.Condition => headline
? Fmt.Number(Math.Floor(v + 1e-9), 0) + "%"
: Fmt.Number(Math.Floor(v * 10 + 1e-9) / 10, 1) + "%",
ExplainUnit.Years => Fmt.Number(v, 1) + " " + T("anni"),
_ => Fmt.Number(v, Math.Abs(v) < 0.01 && v != 0 ? 5 : 3),
};
+2 -2
View File
@@ -93,7 +93,7 @@ Requisito: stesso seme + stessi comandi agli stessi tick ⇒ stesso hash di stat
## 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. `Explanations` (F6, ADR 0024) costruisce le spiegazioni «perché» (`Explanation`: formula, termini con i valori di oggi, note) di prezzo globale e locale, tariffe, efficienza e crescita delle industrie, crescita delle città, condizione dei treni, rating, avanzamento del livello, valore dei veicoli e cassa, chiamando le stesse funzioni del motore (`Market.NextPrice` e `LocalPriceTerms`, `Tariffs.FreightTerms` e `PassengerTerms`, `TownSystem.GrowthOf`, `Fleet.DailyHazard`, `Industry.LastEfficiency` registrato da `IndustrySystem`, transitorio): il valore spiegato è lo stesso numero del motore. 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.
- 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. `Explanations` (F6, ADR 0024) costruisce le spiegazioni «perché» (`Explanation`: formula, termini con i valori di oggi, note) di prezzo globale e locale, tariffe, efficienza e crescita delle industrie, crescita delle città, condizione dei treni, rating, avanzamento del livello, valore dei veicoli e cassa, chiamando le stesse funzioni del motore (`Market.NextPrice` e `LocalPriceTerms`, `Tariffs.FreightTerms` e `PassengerTerms`, `TownSystem.GrowthOf`, `Fleet.DailyHazard` e `ConditionDue`, `Industry.LastEfficiency` registrato da `IndustrySystem`, transitorio): il valore spiegato è lo stesso numero del motore. 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.
@@ -128,7 +128,7 @@ Requisito: stesso seme + stessi comandi agli stessi tick ⇒ stesso hash di stat
- `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. Il tooltip «perché» (`WhyTooltip`, uno per la schermata di gioco su un suo `CanvasLayer`, ADR 0024) si aggancia ai valori di barra superiore, Mercato globale, Scalata, Finanze, scheda dell'industria, Treni e Officine: mostra la spiegazione ricevuta dal server (`ExplanationReport`, in cache in `ClientWorld.Explanations`) e, se manca o è vecchia, la chiede.
- 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. Il tooltip «perché» (`WhyTooltip`, uno per la schermata di gioco su un suo `CanvasLayer`, ADR 0024) si aggancia ai valori di barra superiore, Mercato globale, Scalata, Finanze, scheda dell'industria, Treni e Officine: mostra la spiegazione ricevuta dal server (`ExplanationReport`, in cache in `ClientWorld.Explanations`), la chiede a ogni apertura e poi al più una volta al secondo per valore, e resta aperto quando il pannello ricostruisce il controllo sotto il puntatore.
- 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.
+3 -2
View File
@@ -243,8 +243,9 @@ Record (ognuno chiude con `flags`):
`MarketReport` (quadro del mercato globale per la compagnia della sessione), che il pannello chiede
all'apertura e a ogni nuovo giorno; il server non lo manda da solo. Così anche `ClimbReport` (quadro della scalata), che il pannello chiede all'apertura, a ogni nuovo giorno e dopo un prestito, e la barra superiore una volta al mese, e `FinanceReport` (quadro delle finanze), che il pannello «Finanze» chiede all'apertura, a ogni nuovo giorno e dopo un prestito o un rimborso, e `FleetReport` (quadro del rinnovo della flotta), che i pannelli Treni e Officine chiedono all'apertura, a ogni nuovo giorno e dopo i loro comandi.
Infine `ExplanationReport` (tooltip «perché», ADR 0024): il client lo chiede con `RequestDetail` kind 11
quando il puntatore resta su un valore e la spiegazione in cache manca o è di un giorno passato (al più
una richiesta al secondo per valore); il server risponde sempre, anche con `available` falso.
quando il puntatore resta su un valore: a ogni apertura del tooltip e poi, finché il puntatore resta, al
più una richiesta al secondo per valore; il server risponde sempre, anche con `available` falso
(bersaglio inesistente o, per tariffe, treni, veicoli, rating, livello e cassa, di un'altra compagnia).
- Backpressure: i moti si scartano oltre 256 KB in coda; oltre 64 MB di messaggi affidabili la
sessione si chiude (il client può riprenderla).
- Obiettivo di banda in regime: < 100 KB/s per client.
+4 -4
View File
@@ -195,11 +195,11 @@ Aggiornato alla fine di ogni fase (guida, sezione 18).
- campioni del protocollo con i blocchi nuovi; `Welcome` senza blocco 1 (server F5) con stato del server assente nella copia locale.
Con le ere e l'audio: 218 test (198 senza i lenti).
- **Tooltip «perché» (issue #44, ADR 0024)**:
- Core: modello comune `Explanation` (soggetto e argomenti, valore con unità, formula, termini con i valori di oggi, note) e `Explanations`, pure funzioni del mondo 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`; `IndustrySystem` registra i termini dell'ultima produzione in `Industry.LastEfficiency` (transitorio: né salvato né nell'hash);
- Core: modello comune `Explanation` (soggetto e argomenti, valore con unità, formula, termini con i valori di oggi, note) e `Explanations`, pure funzioni del mondo 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`, `Fleet.ConditionDue` (stima del pianificatore con il componente che la dà), `GameClock.YearsAt`; `IndustrySystem` registra i termini dell'ultima produzione in `Industry.LastEfficiency`, con la condizione da cui viene mc (transitorio: né salvato né nell'hash);
- spiegazioni: prezzo globale (passo del mercato rifatto), prezzo locale, tariffa merci e passeggeri (una unità puntuale sulla tratta più lunga, con la tariffa a due volte il tempo atteso), efficienza e punteggio di crescita dell'industria, crescita della città (stima del prossimo mese), condizione del treno (componente più debole, rischio di guasto, stima del pianificatore), rating, avanzamento del livello, valore del veicolo, cassa;
- protocollo: `RequestDetail` kind 11 con il blocco 1 (`subject`, `arg`) e `ExplanationReport` (137); il server risponde sempre, con `available` falso per un bersaglio che non c'è; nessun campo nei delta, formato dei salvataggi invariato;
- client: `WhyTooltip` comune nello stile della palette 05, su un suo `CanvasLayer`, si apre dopo 0,45 s, chiede la spiegazione se manca o è vecchia e intanto mostra «in arrivo…»; agganciato a barra superiore (cassa, rating, livello), Mercato globale (prezzo globale, prezzi locali), Scalata (avanzamento, requisiti), Finanze (cassa, rating), scheda dell'industria (efficienza, prezzo di vendita, punteggio, prezzi dei partner), Treni (valore dei veicoli in deposito, condizione dei treni), Officine (condizione); testi in `strings.csv` (non provato in Godot: manca l'editor);
- test: `Economy/ExplanationTests.cs`, 10: ogni valore spiegato uguale per uguaglianza esatta a quello del motore (prezzo globale e locale, tariffe, efficienza, crescite, condizione, valore dei veicoli, rating, avanzamento, cassa), spiegazioni in sola lettura con hash invariato e round-trip, spiegazione su richiesta via WebSocket; campioni del protocollo con il blocco 1 della richiesta e `ExplanationReport`.
- protocollo: `RequestDetail` kind 11 con il blocco 1 (`subject`, `arg`) e `ExplanationReport` (137); il server risponde sempre, con `available` falso per un bersaglio che non c'è o, per tariffe, treni, veicoli e valori della compagnia, di un'altra compagnia; nessun campo nei delta, formato dei salvataggi invariato;
- client: `WhyTooltip` comune nello stile della palette 05, su un suo `CanvasLayer`, si apre dopo 0,45 s, chiede la spiegazione a ogni apertura e poi al più una volta al secondo per valore, intanto mostra quella in cache («aggiornamento in arrivo…») o «in arrivo…»; resta aperto quando il pannello ricostruisce il controllo sotto il puntatore; agganciato a barra superiore (cassa, rating, livello), Mercato globale (prezzo globale, prezzi locali), Scalata (avanzamento, requisiti), Finanze (cassa, rating), scheda dell'industria (efficienza, prezzo di vendita, punteggio, prezzi dei partner), Treni (valore dei veicoli in deposito, condizione dei treni), Officine (condizione); testi in `strings.csv` (non provato in Godot: manca l'editor);
- test: `Economy/ExplanationTests.cs`, 10: ogni valore spiegato uguale per uguaglianza esatta a quello del motore (prezzo globale e locale, tariffe, efficienza, crescite, condizione, valore dei veicoli, rating, avanzamento, cassa) e ricomposto dai termini con la formula dichiarata (rapporto D/S dagli scambi con il mondo, stima dal componente che la dà anche quando non è il più debole), linee di altre compagnie non spiegate, spiegazioni in sola lettura con hash invariato e round-trip, spiegazione su richiesta via WebSocket; campioni del protocollo con il blocco 1 della richiesta e `ExplanationReport`.
Con il tooltip: 228 test (208 senza i lenti).
- Restano della F6: tutorial, bilanciamento con i bot.
+19 -6
View File
@@ -40,14 +40,18 @@ non cambia.
(usato da `LocalPrice`);
- `Tariffs.FreightTerms` / `PassengerTerms` (usati da `Freight` / `Passenger`);
- `TownSystem.GrowthOf` (usato da `Grow`), `Fleet.DailyHazard` (usato da
`FleetMaintenanceSystem.CheckFailure`), `GameClock.YearsAt`;
`FleetMaintenanceSystem.CheckFailure`), `Fleet.ConditionDue` (usato da `Fleet.Dues`: la stima del
pianificatore con il componente che la dà, che non è per forza il più debole), `GameClock.YearsAt`;
- per gli altri valori bastano le funzioni già esistenti: `IndustryMath.GrowthScore`,
`FinanceOutlook.Explain`, `ClimbOutlook.Requirements`, `Obsolescence`, `Dues.Condition`,
`FinanceOutlook.Explain`, `ClimbOutlook.Requirements`, `Obsolescence`,
`TradingMath.ConsumerPrice` / `ProducerPrice`.
I termini ricompongono il valore con la formula dichiarata: il prezzo globale mostra anche domanda e
offerta con il resto del mondo (`Dtot`, `Stot`), l'elasticità e i limiti del rapporto D/S.
I test (`Economy/ExplanationTests.cs`) confrontano per uguaglianza esatta il valore di ogni
spiegazione con quello del motore.
3. **Efficienza: termini transitori.** `IndustrySystem` registra i termini dell'ultima produzione in
`Industry.LastEfficiency` (giorno, coperture, fattori, efficienza). Non è salvato né entra nell'hash:
`Industry.LastEfficiency` (giorno, coperture, fattori, la condizione degli impianti da cui viene mc,
letta prima della manutenzione dello stesso tick, efficienza). Non è salvato né entra nell'hash:
dopo un caricamento la spiegazione dice che i termini arrivano con la prossima produzione.
4. **Prezzo globale ricostruito.** Il passo del mercato avviene all'ultimo tick eseguito, quindi la
spiegazione rifà `Market.NextPrice` con il prezzo di ieri dallo storico, le finestre di domanda e
@@ -62,14 +66,23 @@ non cambia.
`kind` 11 (`Explain`) e un blocco 1 (`subject: u8, arg: i32`, scritto solo se `subject` ≠ 0;
`target` è A, `arg` è B). Il server risponde sempre con `ExplanationReport` (id 137), anche per un
bersaglio inesistente, chiuso o di un'altra compagnia (`available` falso, nota «Valore non
disponibile.»), così il tooltip smette di aspettare. Un server vecchio non conosce il kind 11 e non
disponibile.»), così il tooltip smette di aspettare. Sono riservati alla compagnia della sessione
(uno spettatore non li riceve): tariffe di una linea, condizione di un treno, valore di un veicolo,
rating, avanzamento del livello, cassa. Prezzi, industrie e città sono pubblici come nei quadri. Un server vecchio non conosce il kind 11 e non
risponde; un lettore vecchio ignora il blocco della richiesta.
7. **Testi.** Titoli, formule, etichette, note e i simboli che sono parole sono testi italiani fissi:
il client li traduce con `T()` (chiavi in `strings.csv`); i numeri viaggiano solo nei termini.
8. **Client.** `WhyTooltip` è un solo controllo per la schermata di gioco, su un `CanvasLayer` sopra
l'interfaccia, nello stile della palette 05. I pannelli lo agganciano con `WhyTooltip.Attach(controllo,
bersaglio, suggerimento)`; si apre dopo 0,45 s, mostra la spiegazione in cache e, se manca o è di un
giorno passato, la chiede (al più una volta al secondo) mostrando «in arrivo…». Agganci: barra
bersaglio, suggerimento, valore mostrato)`; si apre dopo 0,45 s e chiede la spiegazione a ogni
apertura e poi, finché il puntatore resta, al più una volta al secondo per valore (molti valori
cambiano dentro la giornata: cassa, condizione, prezzi locali). Intanto mostra quella in cache con
«aggiornamento in arrivo…», o «in arrivo…» se manca. Se il pannello ricostruisce il controllo sotto il
puntatore (le schede si rifanno a ogni secondo), il tooltip passa al sostituto con la stessa
spiegazione senza chiudersi. Dove il pannello mostra un numero di un altro momento (la cassa della
barra superiore e delle Finanze) il tooltip, se differisce, dice che quello spiegato è di adesso.
Prezzi con i decimali della scheda dell'industria, importi sotto ₤ 1.000 con i centesimi, condizione
per difetto in percentuale come nelle Officine. Agganci: barra
superiore (cassa, rating, livello), Mercato (prezzo globale, prezzi locali), Scalata (avanzamento e
requisiti), Finanze (cassa, rating), scheda industria (efficienza, prezzo di vendita, punteggio di
crescita, prezzi dei partner), Treni (valore dei veicoli in deposito, condizione dei treni), Officine
+32 -20
View File
@@ -24,8 +24,8 @@ public static class Explanations
{
ExplainSubject.GlobalPrice => GlobalPrice(w, target),
ExplainSubject.LocalPrice => LocalPrice(w, target),
ExplainSubject.FreightTariff => FreightTariff(w, target),
ExplainSubject.PassengerTariff => PassengerTariff(w, target),
ExplainSubject.FreightTariff => FreightTariff(w, target, company),
ExplainSubject.PassengerTariff => PassengerTariff(w, target, company),
ExplainSubject.IndustryEfficiency => IndustryEfficiency(w, target),
ExplainSubject.IndustryGrowth => IndustryGrowth(w, target),
ExplainSubject.TownGrowth => TownGrowth(w, target),
@@ -65,7 +65,8 @@ public static class Explanations
var cal = w.Calendar;
var terms = new List<ExplanationTerm>();
var notes = new List<string>();
const string formula = "Pg = α·Pg′ + (1 − α)·Pg₋₁; Pg′ = clamp(Pg₋₁·(1 + k·(D/S − 1)), Pmin, Pmax)";
const string formula = "Pg = α·Pg′ + (1 − α)·Pg₋₁; Pg′ = clamp(Pg₋₁·(1 + k·(D/S − 1)), Pmin, Pmax); "
+ "D/S = clamp(Dtot/Stot, rmin, rmax); Dtot = D + V·(Pw/Pg₋₁)^η; Stot = S + V·(Pg₋₁/Pw)^η";
long stepTick = w.Clock.Tick == 0 ? -1 : (w.Clock.Tick - 1) / cal.TicksPerDay * cal.TicksPerDay;
int stepYear = stepTick < 0 ? cal.StartYear : cal.StartYear + (int)(stepTick / cal.TicksPerDay / cal.DaysPerYear);
if (stepTick < 0 || def.Era > stepYear)
@@ -90,13 +91,18 @@ public static class Explanations
terms.Add(T("S", "Offerta della regione (finestra)", step.Supply, ExplainUnit.Units));
terms.Add(T("Pw", "Prezzo mondiale", step.WorldPrice, ExplainUnit.Price));
terms.Add(T("V", "Scambi con il resto del mondo", step.WorldVolume, ExplainUnit.Units));
terms.Add(T("D/S", "Rapporto domanda / offerta (con il mondo)", step.Ratio, ExplainUnit.Factor));
terms.Add(T("η", "Elasticità degli scambi con il mondo", m.World.Elasticity, ExplainUnit.Number));
terms.Add(T("Dtot", "Domanda con il resto del mondo", step.DemandTotal, ExplainUnit.Units));
terms.Add(T("Stot", "Offerta con il resto del mondo", step.SupplyTotal, ExplainUnit.Units));
terms.Add(T("rmin", "Rapporto minimo", m.RatioMin, ExplainUnit.Factor));
terms.Add(T("rmax", "Rapporto massimo", m.RatioMax, ExplainUnit.Factor));
terms.Add(T("D/S", "Rapporto domanda / offerta (con il mondo, limitato)", step.Ratio, ExplainUnit.Factor));
terms.Add(T("k", "Sensibilità al rapporto", m.K, ExplainUnit.Number));
terms.Add(T("Pmin", "Prezzo minimo", m.MinPriceFactor * def.BasePrice, ExplainUnit.Price));
terms.Add(T("Pmax", "Prezzo massimo", m.MaxPriceFactor * def.BasePrice, ExplainUnit.Price));
terms.Add(T("Pg′", "Prezzo obiettivo", step.Target, ExplainUnit.Price));
terms.Add(T("α", "Peso del giorno", m.Alpha, ExplainUnit.Number));
notes.Add("D e S comprendono gli scambi con il resto del mondo al prezzo mondiale, che segue il ciclo economico e gli shock.");
notes.Add("D e S sono la domanda e l'offerta della regione; Dtot e Stot aggiungono gli scambi con il resto del mondo al prezzo mondiale, che segue il ciclo economico e gli shock.");
if (Math.Abs(step.Price - pg) > 1e-9 * Math.Max(1, pg)) notes.Add("Il prezzo è cambiato dopo l'ultimo passo del mercato.");
return new Explanation
{
@@ -190,8 +196,9 @@ public static class Explanations
return (from, to, best / 1000);
}
private static Line? LiveLine(World w, int id) =>
id >= 0 && id < w.Lines.Count && w.Lines[id] is { Removed: false } l ? l : null;
/// <summary>Linea viva della compagnia della sessione (null per una linea rimossa o di un'altra compagnia).</summary>
private static Line? LiveLine(World w, int id, CompanyId company) =>
id >= 0 && id < w.Lines.Count && w.Lines[id] is { Removed: false } l && l.Owner == company ? l : null;
/// <summary>Tempo atteso della tratta per il carico (giorni), 0 se nessun treno la collega.</summary>
private static double ExpectedDays(World w, Line line, Station from, Station to, ulong cargo)
@@ -204,9 +211,9 @@ public static class Explanations
/// Tariffa merci per una unità sulla tratta della linea con <see cref="Tariffs.FreightTerms"/>: puntuale
/// (tf = 1 alla consegna nel tempo atteso) e, per confronto, a due volte il tempo atteso.
/// </summary>
public static Explanation FreightTariff(World w, ExplainTarget target)
public static Explanation FreightTariff(World w, ExplainTarget target, CompanyId company)
{
var line = LiveLine(w, target.A);
var line = LiveLine(w, target.A, company);
int g = target.B;
if (line is null || g < 0 || g >= w.Data.GoodCount || Stretch(w, line) is not { } stretch) return Missing(w, target, "Tariffa merci");
var t = w.Data.Balance.Tariffs;
@@ -252,9 +259,9 @@ public static class Explanations
/// Tariffa passeggeri per un posto sulla tratta della linea con <see cref="Tariffs.PassengerTerms"/>, poi
/// × comfort delle carrozze del primo treno della linea (come alla consegna: due arrotondamenti al centesimo).
/// </summary>
public static Explanation PassengerTariff(World w, ExplainTarget target)
public static Explanation PassengerTariff(World w, ExplainTarget target, CompanyId company)
{
var line = LiveLine(w, target.A);
var line = LiveLine(w, target.A, company);
if (line is null || target.B is < 0 or > 1 || Stretch(w, line) is not { } stretch) return Missing(w, target, "Tariffa passeggeri");
var cls = target.B == 1 ? PaxClass.Staff : PaxClass.Worker;
var t = w.Data.Balance.Tariffs;
@@ -300,7 +307,7 @@ public static class Explanations
/// <summary>
/// Efficienza dell'industria con i termini dell'ultima produzione (<see cref="Industry.LastEfficiency"/>):
/// e = min(cL, cP) × pf × mc (0 se ferma) × cI × g × ev, lo stesso prodotto di IndustrySystem.
/// lavoro = min(cL, cP) × pf × mc (0 se ferma), e = lavoro × cI × g × ev, lo stesso prodotto di IndustrySystem.
/// </summary>
public static Explanation IndustryEfficiency(World w, ExplainTarget target)
{
@@ -322,7 +329,8 @@ public static class Explanations
terms.Add(T("g", "Giacimento", e.Depletion, ExplainUnit.Factor));
terms.Add(T("ev", "Eventi in corso", e.EventCapacity, ExplainUnit.Factor));
terms.Add(T("margine", "Margine (media mobile)", ind.Margin, ExplainUnit.Percent));
terms.Add(T("condizione", "Condizione degli impianti (0–100)", ind.Condition, ExplainUnit.Condition));
// la condizione da cui viene mc: la manutenzione dello stesso tick la cambia subito dopo la produzione
terms.Add(T("condizione", "Condizione degli impianti alla produzione (0–100)", e.Condition, ExplainUnit.Condition));
if (e.Stopped) notes.Add("Industria ferma (guasto, incidente, revisione o ammodernamento): il ritmo del lavoro è zero.");
if (ind.Level <= 0) notes.Add("Livello 0: l'industria è inattiva.");
}
@@ -330,7 +338,7 @@ public static class Explanations
{
Target = target, Day = w.Clock.Day, Available = true, Title = "Efficienza", Name = ind.Name,
Value = value, Unit = ExplainUnit.Percent,
Formula = "e = min(cL, cP) × pf × mc × cI × g × ev",
Formula = "lavoro = min(cL, cP) × pf × mc (0 se ferma); e = lavoro × cI × g × ev",
Terms = terms, Notes = notes,
};
}
@@ -427,8 +435,6 @@ public static class Explanations
var comps = Fleet.ComponentsOf(w.Data, weakest.Def);
terms.Add(T("c", "Componente più debole", low, ExplainUnit.Condition, comp < comps.Count ? comps[comp].Id : ""));
terms.Add(T("veicolo", "Veicolo", weakest.Id.Value, ExplainUnit.Text, weakest.Def.NameIt));
double rate = comp < weakest.WearEma.Length ? weakest.WearEma[comp] : 0;
terms.Add(T("usura", "Usura al giorno (media mobile)", rate, ExplainUnit.Condition));
}
if (hv is not null && hc >= 0)
{
@@ -445,12 +451,18 @@ public static class Explanations
terms.Add(T("h", "Rischio di guasto al giorno", hazard, ExplainUnit.Percent));
if (hazard > 0) terms.Add(T("1/h", "Giorni attesi al prossimo guasto", 1 / hazard, ExplainUnit.Days));
}
var dues = Fleet.Dues(w, t);
if (dues.Condition < double.MaxValue)
// la stima viene dal componente con meno giorni all'obiettivo, che non è per forza il più debole
var due = Fleet.ConditionDue(w, t);
if (due.Vehicle is { } dv && due.Days < double.MaxValue)
{
var dcomps = Fleet.ComponentsOf(w.Data, dv.Def);
terms.Add(T("cs", "Componente che dà la stima", due.Condition, ExplainUnit.Condition, due.Component < dcomps.Count ? dcomps[due.Component].Id : ""));
if (dv != weakest) terms.Add(T("veicolo cs", "Veicolo del componente della stima", dv.Id.Value, ExplainUnit.Text, dv.Def.NameIt));
terms.Add(T("usura", "Usura al giorno del componente (media mobile)", due.Rate, ExplainUnit.Number));
terms.Add(T("obiettivo", "Condizione obiettivo del pianificatore", m.Planner.TargetCondition, ExplainUnit.Condition));
terms.Add(T("margine", "Margine del pianificatore", m.Planner.MarginDays, ExplainUnit.Days));
terms.Add(T("stima", "Giorni all'intervento sulla condizione", dues.Condition, ExplainUnit.Days));
terms.Add(T("stima", "Giorni all'intervento sulla condizione", due.Days, ExplainUnit.Days));
if (due.Condition <= m.Planner.TargetCondition) notes.Add("Il componente è già all'obiettivo o sotto: la stima vale −margine.");
}
else notes.Add("Nessuna stima del pianificatore: i componenti non si sono ancora consumati.");
notes.Add("Il guasto è estratto ogni giorno con il rischio h: 1/h è il numero medio di giorni prima del prossimo.");
@@ -458,7 +470,7 @@ public static class Explanations
{
Target = target, Day = w.Clock.Day, Available = true, Title = "Condizione del treno", Name = t.Name,
Value = condition, Unit = ExplainUnit.Condition,
Formula = "c = min(componenti); h = h₀·exp(k·(c₀ − c)/σ) sotto c₀, altrimenti h₀/div; stima = (c − obiettivo)/usura − margine",
Formula = "c = min(componenti); h = h₀·exp(k·(c₀ − c)/σ) sotto c₀, altrimenti h₀/div; stima = min sui componenti di (cs − obiettivo)/usura − margine",
Terms = terms, Notes = notes,
};
}
+4 -3
View File
@@ -17,10 +17,11 @@ public readonly record struct IndustryStopRecord(long Day, int Days, IndustrySto
/// <summary>
/// Termini dell'efficienza dell'ultima produzione giornaliera (IndustrySystem), conservati per la spiegazione
/// del valore (ADR 0024): e = min(lavoratori, personale) × pf × mc (0 se ferma) × copertura degli input di oggi
/// × giacimento × eventi. Non si salvano: dopo un caricamento mancano fino alla produzione del giorno dopo.
/// del valore (ADR 0024): lavoro = min(lavoratori, personale) × pf × mc (0 se ferma); e = lavoro × copertura degli
/// input di oggi × giacimento × eventi. <c>Condition</c> è la condizione degli impianti da cui viene mc, letta prima
/// della manutenzione dello stesso tick. Non si salvano: dopo un caricamento mancano fino alla produzione del giorno dopo.
/// </summary>
public readonly record struct EfficiencyTerms(long Day, double CovWorkers, double CovStaff, double ProfitFactor, double ConditionMultiplier,
public readonly record struct EfficiencyTerms(long Day, double CovWorkers, double CovStaff, double ProfitFactor, double Condition, double ConditionMultiplier,
bool Stopped, double Labour, double CovInputToday, double Depletion, double EventCapacity, double Efficiency);
/// <summary>
@@ -7,6 +7,12 @@ namespace RailEnterprise.Core.Simulation.Systems;
/// <summary>Scadenze di un treno in giorni (negative se già scadute).</summary>
public readonly record struct FleetDues(double Inspection, double Service, double Overhaul, double Condition, bool ConditionIsBrakes);
/// <summary>
/// Stima del pianificatore sulla condizione (giorni) con il veicolo e il componente che la danno, la loro
/// condizione e la loro usura giornaliera (ADR 0024): Days = MaxValue se nessun componente si consuma.
/// </summary>
public readonly record struct ConditionDueInfo(double Days, Vehicle? Vehicle, int Component, double Condition, double Rate, bool IsBrakes);
/// <summary>Prossimo intervento di un treno: indice in maintenance.json e giorni alla scadenza.</summary>
public readonly record struct NextIntervention(int Intervention, double Days);
@@ -148,8 +154,7 @@ public static class Fleet
double f = policy.IntervalFactor;
long today = w.Clock.Day;
double kmPerDay = Math.Max(t.ServiceKmPerDay, 1e-6);
double ins = double.MaxValue, ser = double.MaxValue, ov = double.MaxValue, cond = double.MaxValue;
bool condBrakes = false;
double ins = double.MaxValue, ser = double.MaxValue, ov = double.MaxValue;
foreach (var id in t.Vehicles)
{
var v = w.Vehicles[id.Value];
@@ -158,6 +163,23 @@ public static class Fleet
ser = Math.Min(ser, Math.Min((m.Intervals.ServiceKm * f - (v.OdometerKm - v.LastServiceKm)) / kmPerDay,
m.Intervals.ServiceDays * f - (today - v.LastServiceDay)));
ov = Math.Min(ov, m.Intervals.OverhaulYears * f * w.Calendar.DaysPerYear - (today - v.LastOverhaulDay));
}
var cond = ConditionDue(w, t);
return new FleetDues(ins, ser, ov, cond.Days, cond.IsBrakes);
}
/// <summary>
/// Stima del pianificatore sulla condizione: il minimo su tutti i componenti di (c − obiettivo)/usura − margine
/// (−margine se il componente è già all'obiettivo o sotto; esclusi quelli che non si consumano), con il
/// componente che la dà (il primo a parità). La usano <see cref="Dues"/> e la spiegazione della condizione.
/// </summary>
public static ConditionDueInfo ConditionDue(World w, Train t)
{
var m = w.Data.Maintenance;
var best = new ConditionDueInfo(double.MaxValue, null, -1, 100, 0, false);
foreach (var id in t.Vehicles)
{
var v = w.Vehicles[id.Value];
var comps = ComponentsOf(w.Data, v.Def);
for (int j = 0; j < v.Components.Length && j < comps.Count; j++)
{
@@ -167,14 +189,10 @@ public static class Fleet
if (c <= m.Planner.TargetCondition) days = -m.Planner.MarginDays;
else if (rate > 1e-9) days = (c - m.Planner.TargetCondition) / rate - m.Planner.MarginDays;
else continue;
if (days < cond)
{
cond = days;
condBrakes = comps[j].Id == Brakes;
}
if (days < best.Days) best = new ConditionDueInfo(days, v, j, c, rate, comps[j].Id == Brakes);
}
}
return new FleetDues(ins, ser, ov, cond, condBrakes);
return best;
}
/// <summary>
@@ -40,7 +40,8 @@ public sealed class IndustrySystem : ISimSystem
ind.CovStaff = Ema.Step(ind.CovStaff, covS, ib.CoverageWindowDays);
double pf = IndustryMath.ProfitFactor(ind, ib);
double mc = IndustryMath.ConditionMultiplier(ind.Condition, data.Balance.IndustryMaintenance);
double condition = ind.Condition;
double mc = IndustryMath.ConditionMultiplier(condition, data.Balance.IndustryMaintenance);
double eLabor = Math.Min(ind.CovWorkers, ind.CovStaff) * pf * mc;
// fermo per guasto, incidente, revisione o ammodernamento: nessuna produzione (sezione 11)
bool stopped = ind.IsStopped(ctx.Day);
@@ -113,7 +114,7 @@ public sealed class IndustrySystem : ISimSystem
}
ind.Efficiency = eLabor * covInToday * depletion * capacity;
// termini di oggi per la spiegazione dell'efficienza (ADR 0024): non entrano nel salvataggio né nell'hash
ind.LastEfficiency = new EfficiencyTerms(ctx.Day, ind.CovWorkers, ind.CovStaff, pf, mc, stopped, eLabor, covInToday, depletion, capacity, ind.Efficiency);
ind.LastEfficiency = new EfficiencyTerms(ctx.Day, ind.CovWorkers, ind.CovStaff, pf, condition, mc, stopped, eLabor, covInToday, depletion, capacity, ind.Efficiency);
// salari giornalieri ai presenti
double wages = (ind.WorkersPresent * ib.WagePerWorkerPerMonth + ind.StaffPresent * ib.WagePerStaffPerMonth) / dpm;
@@ -71,6 +71,11 @@ public static class ExplanationTests
Assert.Equal(e.Value, alpha * target + (1 - alpha) * prev, $"{when}: passo del prezzo di {world.Data.Goods[g].Id}");
Assert.Equal(target, DMath.Clamp(prev * (1 + V(e, "k") * (V(e, "D/S") - 1)), V(e, "Pmin"), V(e, "Pmax")), $"{when}: prezzo obiettivo");
Assert.True(V(e, "D") >= 0 && V(e, "S") >= 0 && V(e, "V") > 0, $"{when}: domanda, offerta e volume mondiale");
// il rapporto viene da D, S e dagli scambi con il mondo: Dtot = D + V·(Pw/Pg₋₁)^η, Stot = S + V·(Pg₋₁/Pw)^η
double pw = V(e, "Pw"), v = V(e, "V"), eta = V(e, "η");
Assert.Equal(V(e, "D") + v * DMath.Pow(pw / prev, eta), V(e, "Dtot"), $"{when}: domanda con il mondo");
Assert.Equal(V(e, "S") + v * DMath.Pow(prev / pw, eta), V(e, "Stot"), $"{when}: offerta con il mondo");
Assert.Equal(DMath.Clamp(V(e, "Dtot") / Math.Max(1e-9, V(e, "Stot")), V(e, "rmin"), V(e, "rmax")), V(e, "D/S"), $"{when}: rapporto limitato");
}
Assert.True(stepped > 0, $"{when}: almeno un bene in commercio");
}
@@ -129,7 +134,7 @@ public static class ExplanationTests
var line = w.Lines[lineId];
var stretch = Explanations.Stretch(w, line)!.Value;
double km = Vec2.Distance(stretch.From.Position, stretch.To.Position) / 1000;
var freight = Explanations.FreightTariff(w, new ExplainTarget(ExplainSubject.FreightTariff, lineId, ore));
var freight = Explanations.FreightTariff(w, new ExplainTarget(ExplainSubject.FreightTariff, lineId, ore), f.Me);
Available(freight);
double expected = V(freight, "giorni");
Assert.True(expected > 0, "la linea porta il minerale: tempo atteso noto");
@@ -145,7 +150,7 @@ public static class ExplanationTests
Assert.Equal(Tariffs.LatenessFactor(2 * expected, expected, t), V(freight, "tf 2×"));
Assert.True(V(freight, "tariffa 2×") < freight.Value, "in ritardo la tariffa scende");
var pax = Explanations.PassengerTariff(w, new ExplainTarget(ExplainSubject.PassengerTariff, lineId, 0));
var pax = Explanations.PassengerTariff(w, new ExplainTarget(ExplainSubject.PassengerTariff, lineId, 0), f.Me);
Available(pax);
double comfort = Fleet.Comfort(w, w.Trains[trainId], PaxClass.Worker);
Assert.Equal(comfort, V(pax, "comfort"));
@@ -155,9 +160,14 @@ public static class ExplanationTests
double paxCents = V(pax, "p") * V(pax, "Tp") * V(pax, "km^e") * V(pax, "classe") * V(pax, "tf") * V(pax, "d");
Assert.Equal((double)Money.FromCentsRounded(paxCents).Cents, V(pax, "senza comfort"));
Assert.Equal(pax.Value, (double)(new Money((long)V(pax, "senza comfort")) * V(pax, "comfort")).Cents);
var staff = Explanations.PassengerTariff(w, new ExplainTarget(ExplainSubject.PassengerTariff, lineId, 1));
var staff = Explanations.PassengerTariff(w, new ExplainTarget(ExplainSubject.PassengerTariff, lineId, 1), f.Me);
Assert.Equal(t.ClassMultipliers["staff"], V(staff, "classe"));
Assert.False(Explanations.FreightTariff(w, new ExplainTarget(ExplainSubject.FreightTariff, 999, ore)).Available, "linea inesistente");
Assert.False(Explanations.FreightTariff(w, new ExplainTarget(ExplainSubject.FreightTariff, 999, ore), f.Me).Available, "linea inesistente");
// la linea di un'altra compagnia non si spiega (tempi attesi e comfort sono della sua rete)
var rival = new CompanyId(f.Me.Value + 1);
Assert.False(Explanations.Build(w, rival, new ExplainTarget(ExplainSubject.FreightTariff, lineId, ore)).Available, "tariffa merci di una linea altrui");
Assert.False(Explanations.Build(w, rival, new ExplainTarget(ExplainSubject.PassengerTariff, lineId, 0)).Available, "tariffa passeggeri di una linea altrui");
Assert.False(Explanations.Build(w, CompanyId.None, new ExplainTarget(ExplainSubject.FreightTariff, lineId, ore)).Available, "spettatore");
}
[Test(Description = "Efficienza dell'industria: i termini dell'ultima produzione ricompongono ind.Efficiency; dopo un caricamento arrivano con il giorno dopo")]
@@ -175,6 +185,8 @@ public static class ExplanationTests
if (V(e, "lavoro") != 0 || labour == 0) Assert.Equal(labour, V(e, "lavoro"), $"{ind.Name}: ritmo del lavoro");
else Assert.True(e.Notes.Count > 0, $"{ind.Name}: ferma, lo dice la nota");
Assert.Equal(e.Value, V(e, "lavoro") * V(e, "cI") * V(e, "g") * V(e, "ev"), $"{ind.Name}: prodotto dei fattori");
// la condizione mostrata è quella da cui viene mc, non quella dopo la manutenzione dello stesso tick
Assert.Equal(IndustryMath.ConditionMultiplier(V(e, "condizione"), w.Data.Balance.IndustryMaintenance), V(e, "mc"), $"{ind.Name}: mc dalla condizione");
}
var steel = w.Industries.First(i => i.Def.Id == "steel_mill");
Assert.Equal(IndustryOutlook.Build(w, steel, f.Me).Efficiency, Explanations.IndustryEfficiency(w, new ExplainTarget(ExplainSubject.IndustryEfficiency, steel.Id.Value)).Value,
@@ -236,12 +248,50 @@ public static class ExplanationTests
Assert.Equal(Fleet.DailyHazard(w, train, w.Clock.Day).Hazard, V(e, "h"));
Assert.Equal(1 / V(e, "h"), V(e, "1/h"));
Assert.Equal(Fleet.Dues(w, train).Condition, V(e, "stima"), "stima del pianificatore");
Stima(e);
// la stima viene dal componente con meno giorni all'obiettivo, non dal più debole: freni a 60 che calano
// di 2 al giorno contro il motore a 55 che cala di 0,1
var loco = w.Vehicles[train.Vehicles[0].Value];
var comps = Fleet.ComponentsOf(w.Data, loco.Def);
int brakes = Fleet.ComponentIndex(comps, Fleet.Brakes), engine = Fleet.ComponentIndex(comps, Fleet.Engine);
Assert.True(brakes >= 0 && engine >= 0, "la locomotiva ha freni e motore");
foreach (var id in train.Vehicles)
{
var v = w.Vehicles[id.Value];
for (int j = 0; j < v.Components.Length; j++)
{
v.Components[j] = 90;
if (j < v.WearEma.Length) v.WearEma[j] = 0.01;
}
}
loco.Components[brakes] = 60;
loco.WearEma[brakes] = 2;
loco.Components[engine] = 55;
loco.WearEma[engine] = 0.1;
var split = Explanations.TrainCondition(w, new ExplainTarget(ExplainSubject.TrainCondition, trainId), f.Me);
Assert.Equal(55.0, V(split, "c"), "il più debole è il motore");
Assert.Equal(Fleet.Engine, split.Term("c")!.Text);
Assert.Equal(60.0, V(split, "cs"), "la stima viene dai freni");
Assert.Equal(Fleet.Brakes, split.Term("cs")!.Text);
Assert.Equal(2.0, V(split, "usura"));
Assert.Equal(Fleet.Dues(w, train).Condition, V(split, "stima"));
Stima(split);
// un treno di un'altra compagnia non si spiega
var other = Explanations.Build(w, new CompanyId(f.Me.Value + 1), new ExplainTarget(ExplainSubject.TrainCondition, trainId));
Assert.False(other.Available);
}
/// <summary>La stima del pianificatore ricomposta dai termini: (cs − obiettivo)/usura − margine, −margine all'obiettivo.</summary>
private static void Stima(Explanation e)
{
if (e.Term("stima") is null) return;
double cs = V(e, "cs"), target = V(e, "obiettivo"), margin = V(e, "margine");
double expected = cs <= target ? -margin : (cs - target) / V(e, "usura") - margin;
Assert.Equal(expected, V(e, "stima"), "stima ricomposta dai termini");
}
[Test(Description = "Valore del veicolo: valore di libro e rivendita di Obsolescence, con la curva del residuo nuovo e superato")]
public static void VehicleValueMatchesObsolescence()
{