F6: finanza completa, correzioni della revisione
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>
This commit is contained in:
1 parent
9bf64b9286
commit
1f8830337a
20 files changed
+354
-97
No files matched your search
@@ -609,11 +609,6 @@ Anni,,Years
|
||||
patrimonio netto,,net worth
|
||||
Bancarotta dichiarata,,Bankruptcy declared
|
||||
La compagnia non ha riportato la cassa sopra zero entro il limite della difficoltà.,,The company did not bring its cash back above zero within the difficulty limit.
|
||||
Cassa negativa da,,Cash negative for
|
||||
bancarotta tra,,bankruptcy in
|
||||
Scoperto,,Overdraft
|
||||
Il limite della difficoltà è di,,The difficulty limit is
|
||||
"riporta la cassa sopra zero con un prestito, vendendo treni o riducendo i costi.",,"bring cash back above zero with a loan, by selling trains or by cutting costs."
|
||||
in corso,,in progress
|
||||
finora,,so far
|
||||
Voce,,Item
|
||||
@@ -654,13 +649,8 @@ patrimonio non positivo,,non-positive equity
|
||||
Leva (debiti / patrimonio netto),,Leverage (debt / net worth)
|
||||
In bancarotta il rating è D finché la situazione non si risolve.,,While bankrupt the rating is D until the situation is resolved.
|
||||
È il rating più alto: i prestiti costano il minimo.,,This is the highest rating: loans cost the least.
|
||||
un margine di almeno,,a margin of at least
|
||||
rimborsando,,by repaying
|
||||
una leva non oltre,,leverage no higher than
|
||||
serve migliorare insieme margine e leva,,margin and leverage must improve together
|
||||
oppure,,or
|
||||
Per salire a,,To rise to
|
||||
serve un punteggio di,,a score of
|
||||
Punteggio da,,Score from
|
||||
Tasso,,Rate
|
||||
componente,,component
|
||||
@@ -672,6 +662,18 @@ Rata mensile,,Monthly payment
|
||||
interessi,,interest
|
||||
scadenza,,maturity
|
||||
Estingui,,Pay off
|
||||
Un nuovo prestito costa il,,A new loan costs
|
||||
base,,base
|
||||
rating,,rating
|
||||
La cassa è tornata positiva,,Cash is back above zero
|
||||
"Dopo {0} di cassa negativa il conto alla rovescia della bancarotta si azzera domani.",,"After {0} of negative cash, the bankruptcy countdown resets tomorrow."
|
||||
Cassa negativa da oggi: bancarotta tra {0},,Cash negative since today: bankruptcy in {0}
|
||||
Cassa negativa da {0}: bancarotta tra {1},,Cash negative for {0}: bankruptcy in {1}
|
||||
"Scoperto {0}. Il limite della difficoltà è di {1}; riporta la cassa sopra zero con un prestito, vendendo treni o riducendo i costi.",,"Overdraft {0}. The difficulty limit is {1}; bring cash back above zero with a loan, by selling trains or by cutting costs."
|
||||
neutro,,neutral
|
||||
"Il margine conta da quando ci sono almeno {0} mesi chiusi con ricavi (ora {1}): fino ad allora vale 0, così i primi incassi non fanno crollare il rating.",,"The margin counts once there are at least {0} closed months with revenue (now {1}): until then it is 0, so the first takings do not sink the rating."
|
||||
"Il punteggio {0} vale già {1}: il rating si aggiorna al prossimo calcolo mensile, a inizio mese.",,"The score {0} is already worth {1}: the rating is updated at the next monthly calculation, at the start of the month."
|
||||
un margine di almeno {0},,a margin of at least {0}
|
||||
una leva non oltre {0},,leverage no higher than {0}
|
||||
una leva non oltre {0} (rimborsando {1}),,leverage no higher than {0} (by repaying {1})
|
||||
"una leva non oltre {0} (servirebbe rimborsare {1}, più di quanto la cassa consenta oggi)",,"leverage no higher than {0} (it would take repaying {1}, more than cash allows today)"
|
||||
Per il gradino {0} serve un punteggio di {1}: {2}.,,To reach {0} you need a score of {1}: {2}.
|
||||
In bancarotta non si possono chiedere prestiti,,Loans cannot be requested while bankrupt
|
||||
Fido disponibile {0} su {1}. Tasso di un nuovo prestito: {2} fisso (base {3} + rating {4} {5}) per {6} anni.,,Available credit {0} of {1}. Rate of a new loan: {2} fixed (base {3} + rating {4} {5}) for {6} years.
|
||||
|
@@ -363,9 +363,10 @@ public partial class ClimbPanel : VBoxContainer
|
||||
_repay.Text = $"{T("Rimborsa")} {repay}";
|
||||
_repay.Disabled = loan is null;
|
||||
_borrow.Disabled = report is null || !report.LoansAllowed;
|
||||
bool bankrupt = report is not null && _session.World.Companies.TryGetValue(report.Company, out var me) && me.Bankrupt;
|
||||
_borrow.TooltipText = report is null ? "" : report.LoansAllowed
|
||||
? $"{T("Fido disponibile")} {report.LoanAvailable} {T("su")} {report.MaxLoan}, {T("al")} {Fmt.Pct(report.NewLoanRate, 1)}"
|
||||
: T("In amministrazione controllata non si possono chiedere prestiti");
|
||||
: bankrupt ? T("In bancarotta non si possono chiedere prestiti") : T("In amministrazione controllata non si possono chiedere prestiti");
|
||||
}
|
||||
|
||||
private void Borrow() =>
|
||||
|
||||
@@ -187,12 +187,18 @@ public partial class FinancePanel : VBoxContainer
|
||||
RefreshLoans(report);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Barra della cassa negativa. Il motore conta i giorni una volta al giorno, quindi dopo un prestito il
|
||||
/// contatore può restare indietro di un giorno rispetto alla cassa: il conto alla rovescia si mostra solo
|
||||
/// con la cassa davvero negativa (scoperto) o in bancarotta.
|
||||
/// </summary>
|
||||
private void RefreshDanger(FinanceReport r)
|
||||
{
|
||||
bool negative = r.NegativeCashDays > 0 || r.Overdraft.Cents > 0 || r.Bankrupt;
|
||||
_danger.Visible = negative;
|
||||
if (!negative) return;
|
||||
int left = Math.Max(0, r.BankruptcyDays - r.NegativeCashDays);
|
||||
bool overdraft = r.Overdraft.Cents > 0;
|
||||
bool recovering = !overdraft && !r.Bankrupt && r.NegativeCashDays > 0;
|
||||
_danger.Visible = overdraft || r.Bankrupt || recovering;
|
||||
_dangerBar.Visible = overdraft || r.Bankrupt;
|
||||
if (!_danger.Visible) return;
|
||||
_dangerBar.Value = r.BankruptcyDays > 0 ? Math.Clamp((double)r.NegativeCashDays / r.BankruptcyDays, 0, 1) : 1;
|
||||
if (r.Bankrupt)
|
||||
{
|
||||
@@ -200,9 +206,18 @@ public partial class FinancePanel : VBoxContainer
|
||||
_dangerDetail.Text = T("La compagnia non ha riportato la cassa sopra zero entro il limite della difficoltà.");
|
||||
return;
|
||||
}
|
||||
_dangerText.Text = $"{T("Cassa negativa da")} {Days(r.NegativeCashDays)}: {T("bancarotta tra")} {Days(left)}";
|
||||
_dangerDetail.Text = $"{T("Scoperto")} {r.Overdraft}. {T("Il limite della difficoltà è di")} {Days(r.BankruptcyDays)}; "
|
||||
+ T("riporta la cassa sopra zero con un prestito, vendendo treni o riducendo i costi.");
|
||||
if (recovering)
|
||||
{
|
||||
_dangerText.Text = T("La cassa è tornata positiva");
|
||||
_dangerDetail.Text = string.Format(T("Dopo {0} di cassa negativa il conto alla rovescia della bancarotta si azzera domani."), Days(r.NegativeCashDays));
|
||||
return;
|
||||
}
|
||||
int left = Math.Max(0, r.BankruptcyDays - r.NegativeCashDays);
|
||||
_dangerText.Text = r.NegativeCashDays == 0
|
||||
? string.Format(T("Cassa negativa da oggi: bancarotta tra {0}"), Days(r.BankruptcyDays))
|
||||
: string.Format(T("Cassa negativa da {0}: bancarotta tra {1}"), Days(r.NegativeCashDays), Days(left));
|
||||
_dangerDetail.Text = string.Format(T("Scoperto {0}. Il limite della difficoltà è di {1}; riporta la cassa sopra zero con un prestito, vendendo treni o riducendo i costi."),
|
||||
r.Overdraft, Days(r.BankruptcyDays));
|
||||
}
|
||||
|
||||
private static string Days(int n) => n == 1 ? $"1 {T("giorno")}" : $"{n} {T("giorni")}";
|
||||
@@ -335,7 +350,10 @@ public partial class FinancePanel : VBoxContainer
|
||||
+ $"{T("Punteggio")} {Ratio(r.Score)}.";
|
||||
foreach (var c in _ratingBody.GetChildren()) c.QueueFree();
|
||||
|
||||
_ratingBody.AddChild(Measure(T("Margine (utile / ricavi)"), Fmt.Pct(r.Margin, 1), r.MarginWeight, r.MarginComponent));
|
||||
_ratingBody.AddChild(Measure(T("Margine (utile / ricavi)"), r.MarginNeutral ? T("neutro") : Fmt.Pct(r.Margin, 1), r.MarginWeight, r.MarginComponent));
|
||||
if (r.MarginNeutral)
|
||||
_ratingBody.AddChild(Note(string.Format(T("Il margine conta da quando ci sono almeno {0} mesi chiusi con ricavi (ora {1}): fino ad allora vale 0, così i primi incassi non fanno crollare il rating."),
|
||||
r.MinRevenueMonths, r.RevenueMonths)));
|
||||
string leverage = r.LeverageUnbounded ? T("patrimonio non positivo") : Ratio(r.Leverage);
|
||||
_ratingBody.AddChild(Measure(T("Leva (debiti / patrimonio netto)"), leverage, r.LeverageWeight, r.LeverageComponent));
|
||||
|
||||
@@ -347,17 +365,24 @@ public partial class FinancePanel : VBoxContainer
|
||||
{
|
||||
_ratingBody.AddChild(Note(T("È il rating più alto: i prestiti costano il minimo.")));
|
||||
}
|
||||
else if (r.NextAlreadyMet)
|
||||
{
|
||||
_ratingBody.AddChild(Note(string.Format(T("Il punteggio {0} vale già {1}: il rating si aggiorna al prossimo calcolo mensile, a inizio mese."),
|
||||
Ratio(r.Score), r.ScoreRating)));
|
||||
}
|
||||
else
|
||||
{
|
||||
var ways = new List<string>();
|
||||
if (r.MarginReachable) ways.Add($"{T("un margine di almeno")} {Fmt.Pct(r.MarginNeeded, 1)}");
|
||||
if (r.MarginReachable) ways.Add(string.Format(T("un margine di almeno {0}"), Fmt.Pct(r.MarginNeeded, 1)));
|
||||
if (r.LeverageReachable)
|
||||
{
|
||||
string repay = r.DebtToRepay.Cents > 0 ? $" ({T("rimborsando")} {r.DebtToRepay})" : "";
|
||||
ways.Add($"{T("una leva non oltre")} {Ratio(r.LeverageMax)}{repay}");
|
||||
string way = r.DebtToRepay.Cents <= 0 ? T("una leva non oltre {0}")
|
||||
: r.RepayAffordable ? T("una leva non oltre {0} (rimborsando {1})")
|
||||
: T("una leva non oltre {0} (servirebbe rimborsare {1}, più di quanto la cassa consenta oggi)");
|
||||
ways.Add(string.Format(way, Ratio(r.LeverageMax), r.DebtToRepay));
|
||||
}
|
||||
string how = ways.Count == 0 ? T("serve migliorare insieme margine e leva") : string.Join($" {T("oppure")} ", ways);
|
||||
_ratingBody.AddChild(Note($"{T("Per salire a")} {r.NextRating} {T("serve un punteggio di")} {Ratio(r.NextThreshold)}: {how}."));
|
||||
_ratingBody.AddChild(Note(string.Format(T("Per il gradino {0} serve un punteggio di {1}: {2}."), r.NextRating, Ratio(r.NextThreshold), how)));
|
||||
}
|
||||
|
||||
// soglie e tassi per rating
|
||||
@@ -442,10 +467,10 @@ public partial class FinancePanel : VBoxContainer
|
||||
}
|
||||
|
||||
_borrow.Disabled = !r.LoansAllowed || r.LoanAvailable.Cents <= 0;
|
||||
_credit.Text = !r.LoansAllowed
|
||||
? T("In amministrazione controllata non si possono chiedere prestiti")
|
||||
: $"{T("Fido disponibile")} {r.LoanAvailable} {T("su")} {r.MaxLoan}. {T("Un nuovo prestito costa il")} {Fmt.Pct(r.NewLoanRate, 1)} "
|
||||
+ $"{T("fisso")} ({T("base")} {Fmt.Pct(r.BaseRate, 1)} + {T("rating")} {r.Rating} {Fmt.Pct(r.Spread, 1)}) {T("per")} {r.LoanTermMonths / 12} {T("anni")}.";
|
||||
_credit.Text = r.Bankrupt ? T("In bancarotta non si possono chiedere prestiti")
|
||||
: r.Receivership ? T("In amministrazione controllata non si possono chiedere prestiti")
|
||||
: string.Format(T("Fido disponibile {0} su {1}. Tasso di un nuovo prestito: {2} fisso (base {3} + rating {4} {5}) per {6} anni."),
|
||||
r.LoanAvailable, r.MaxLoan, Fmt.Pct(r.NewLoanRate, 1), Fmt.Pct(r.BaseRate, 1), r.Rating, Fmt.Pct(r.Spread, 1), r.LoanTermMonths / 12);
|
||||
}
|
||||
|
||||
private void Borrow() =>
|
||||
|
||||
+3
-1
@@ -142,7 +142,9 @@
|
||||
"bookValueFloor": 0.1,
|
||||
"incomeMonths": 12,
|
||||
"incomeYears": 10,
|
||||
"bankruptcyWarningDaysLeft": [ 30, 14, 7, 3, 1 ]
|
||||
"bankruptcyWarningDaysLeft": [ 30, 14, 7, 3, 1 ],
|
||||
"ratingMinRevenueMonths": 3,
|
||||
"negativeCashNoticeDays": 3
|
||||
},
|
||||
"stockMarket": {
|
||||
"shares": 1000000,
|
||||
|
||||
+2
-1
@@ -161,7 +161,7 @@ loro fase i comandi 35–38 rispondono `NotImplemented`. Il server imposta l'emi
|
||||
| 132 | Newspaper | `day: i64`, `title: string`, `articles: [(headline: string, body: string)]` |
|
||||
| 133 | SaveList | `saves: [SaveInfo]` |
|
||||
| 134 | ClimbReport | `day: i64, company: i32, foundedDay: i64, initialCapital: Money, tier: u8, nextTier: u8 (0 all'ultimo livello), tiers: [TierInfo]`; requisiti del prossimo livello: `netWorth, netWorthRequired: Money, netWorthFraction: f32, netWorthMet: bool, towns, townsRequired, townPopulation: i32, townsFraction: f32, townsMet: bool, rating, ratingRequired: string, ratingFraction: f32, ratingMet: bool, progress: f32` (media delle tre frazioni); stato patrimoniale: `assets: [AmountInfo]` (kind 0 binari e opere, 1 stazioni e depositi, 2 veicoli, 3 industrie possedute, 4 merce propria), `portfolio, cash (positiva), totalAssets, loans: Money, loansRate: f32 (medio), overdraft (scoperto), totalLiabilities, balanceNetWorth: Money` (= totalAssets − totalLiabilities = patrimonio netto del motore); conto economico: `incomeYear: i32, incomePartial: bool, income: [AmountInfo]` (kind 0 tariffe e noli, 1 altri ricavi, 2 costi operativi, 3 manutenzione, 4 interessi; con segno), `profit: Money`; prestiti: `loanList: [LoanInfo], maxLoan, loanAvailable: Money, newLoanRate: f32, loansAllowed: bool`; `history: [NetWorthPointInfo]` (fondazione, fine di ogni anno, oggi) (su richiesta, F6; ADR 0018) |
|
||||
| 135 | FinanceReport | `day: i64, company: i32, cash, netWorth, loans, overdraft: Money`; conto economico: `lines: [FinanceLineInfo]` (voci in ordine di presentazione), `columns: [IncomeColumnInfo]` (mese in corso, mesi chiusi dal più recente, anno in corso, anni chiusi dal più recente); rating: `rating: string, ratingInitial: bool, ratingMonths: u8, margin, leverage: f32, leverageUnbounded: bool, marginWeight, leverageWeight, marginComponent, leverageComponent, score: f32, thresholds: [RatingThresholdInfo], nextRating: string ("" ad AAA), nextThreshold, marginNeeded: f32, marginReachable: bool, leverageMax: f32, leverageReachable: bool, debtToRepay: Money`; prestiti: `loanList: [FinanceLoanInfo], maxLoan, loanAvailable: Money, newLoanRate, baseRate, spread: f32, loanTermMonths: i32, loanStep: Money, loansAllowed: bool`; bancarotta: `negativeCashDays, bankruptcyDays: i32, bankrupt, receivership: bool` (su richiesta, F6; ADR 0019) |
|
||||
| 135 | FinanceReport | `day: i64, company: i32, cash, netWorth, loans, overdraft: Money`; conto economico: `lines: [FinanceLineInfo]` (voci in ordine di presentazione), `columns: [IncomeColumnInfo]` (mese in corso, mesi chiusi dal più recente, anno in corso, anni chiusi dal più recente); rating: `rating: string, ratingInitial: bool, ratingMonths, revenueMonths: u8, marginNeutral: bool (margine 0 finché la finestra non è piena e ha meno di minRevenueMonths mesi con ricavi), minRevenueMonths: u8, margin, leverage: f32, leverageUnbounded: bool, marginWeight, leverageWeight, marginComponent, leverageComponent, score: f32, thresholds: [RatingThresholdInfo], nextRating: string ("" ad AAA), nextThreshold: f32, nextAlreadyMet: bool (il punteggio basta già: rating scoreRating al prossimo calcolo mensile, obiettivi a zero), scoreRating: string, marginNeeded: f32, marginReachable: bool, leverageMax: f32 (sempre finita), leverageReachable: bool, debtToRepay: Money, repayAffordable: bool (il rimborso non supera la cassa né il residuo dei prestiti; lo scoperto non si rimborsa)`; prestiti: `loanList: [FinanceLoanInfo], maxLoan, loanAvailable: Money, newLoanRate, baseRate, spread: f32, loanTermMonths: i32, loanStep: Money, loansAllowed: bool`; bancarotta: `negativeCashDays, bankruptcyDays: i32, bankrupt, receivership: bool` (su richiesta, F6; ADR 0019) |
|
||||
|
||||
Record (ognuno chiude con `flags`):
|
||||
|
||||
@@ -200,6 +200,7 @@ Record (ognuno chiude con `flags`):
|
||||
- `GoodMarketInfo { good, available, price: f64 (centesimi), change: f32 (30 giorni), supplyMonth, demandMonth, worldSupplyMonth, worldDemandMonth, stockUnits: f64, stockMonths: f32 (−1 senza domanda), history: [PricePointInfo { day: i64, price: f64 }] (un campione per mese, l'ultimo è oggi), forecast: [ForecastInfo { months: u8, price, low, high: f64 }], sellPlaces: [SellPlaceInfo { kind: u8 (0 industria, 1 hub), target, price: f64, line: i32 (−1 non collegato) }] }`
|
||||
- `TierInfo { level: u8, nameIt, nameEn: string, netWorthRequired: Money, townsRequired, townPopulation: i32, ratingRequired: string, reached: bool, reachedDay: i64 (fondazione per il livello 1; −1 se non raggiunto o sconosciuto), unlocks: [UnlockInfo] }`; `UnlockInfo { kind: u8 (0 fido, 1 squadre di cantiere, 2 compravendita in proprio, 3 acquisto di industrie, 4 quotazione, 5 scalate ostili, 6 concessioni), value: i64 (fido in centesimi o numero di squadre; 0 per gli altri) }`: gli sblocchi che il livello aggiunge al precedente
|
||||
- `AmountInfo { kind: u8, value: Money }`, `LoanInfo { loan, remaining: Money, annualRate: f32, monthsLeft: i32 }`, `NetWorthPointInfo { day: i64, value: Money }`
|
||||
- `LedgerEntry` (voce del registro, u8): 0 FreightRevenue (noli merci), 1 PassengerRevenue (biglietti), 2 Construction (costruzioni), 3 VehiclePurchase (acquisto di treni), 4 VehicleSale (vendita di treni), 5 RunningCosts (esercizio dei treni), 6 TrackMaintenance (manutenzione dei binari), 7 FleetMaintenance (manutenzione dei treni), 8 Wages (stipendi), 9 Interest (interessi), 10 LoanTaken (prestiti ricevuti), 11 LoanRepaid (prestiti rimborsati), 12 Trading (commercio in proprio), 13 IndustryPurchase (acquisto di industrie), 14 Dividends (dividendi pagati), 15 Shares (azioni), 16 Contracts (contratti), 17 Penalties (penali), 18 Other (altro), 19 Industries (industrie possedute), 20 Subsidiaries (controllate), 21 StationUpkeep (stazioni e depositi), 22 Storage (magazzini), 23 Duties (dazi), 24 DividendsReceived (dividendi incassati). Sezione: ricavi 0, 1, 12, 16, 19, 20, 24; costi 5–9, 17, 21–23; investimenti e finanziamenti gli altri (ADR 0019)
|
||||
- `FinanceLineInfo { kind: u8 (LedgerEntry), section: u8 (0 ricavi, 1 costi, 2 investimenti e finanziamenti) }`, `IncomeColumnInfo { kind: u8 (0 mese in corso, 1 mese chiuso, 2 anno in corso, 3 anno chiuso), year: i32, month: u8 (1–12, 0 per gli anni), values: [AmountInfo] (solo le voci diverse da zero, kind = LedgerEntry, con segno), profit: Money (utile operativo del motore), cashFlow: Money }`, `RatingThresholdInfo { rating: string, minScore, loanRate: f32 }`, `FinanceLoanInfo { loan: i32, principal, remaining: Money, annualRate: f32 (fisso), monthsLeft: i32, payment, nextInterest: Money, maturityDay: i64 }`
|
||||
- `HubMarketInfo { hub, kind: u8 (0 porto, 1 valico), monthlyCapacity, duty: f32, usedThisMonth, line: i32 (−1 non collegato) }`
|
||||
- `WarehouseInfo { station, capacity, incoming: i32 (merce propria in viaggio verso la stazione), goods: [WarehouseGoodInfo] }` (stazioni vive della compagnia)
|
||||
|
||||
+4
-4
@@ -132,15 +132,15 @@ Aggiornato alla fine di ogni fase (guida, sezione 18).
|
||||
- **Finanza completa (issue #39, ADR 0019)**:
|
||||
- analisi delle lacune nell'ADR: prestiti, fido per livello, rate, rating mensile e bancarotta ai giorni di `difficulty.json` c'erano già; mancavano stipendi delle compagnie, finestra di 12 mesi e leva su patrimonio nel rating, misure conservate, conto economico per voce mensile e annuale, voci separate per stazioni, dazi, magazzini e dividendi incassati, avvisi prima della bancarotta, quadro nel protocollo e pannello definitivo;
|
||||
- prestiti a tasso fisso (base della difficoltà + spread del rating all'accensione: niente spirale rating → rata → utile), rimborso anticipato parziale (stessa durata, rata più bassa) e totale senza penale, messaggi con tasso, rata, residuo e cassa disponibile;
|
||||
- rating ogni mese da margine = utile operativo / ricavi sugli ultimi 12 mesi chiusi e leva = (prestiti + scoperto) / patrimonio netto; punteggio, misure e mesi della finestra in `Company`; `FinanceOutlook.Explain` dice componenti, soglie con il tasso per rating, gradino sopra, margine che basta, leva massima e debito da rimborsare;
|
||||
- rating ogni mese da margine = utile operativo / ricavi sugli ultimi 12 mesi chiusi e leva = (prestiti + scoperto) / patrimonio netto; punteggio, misure e mesi della finestra in `Company`; margine neutro finché la finestra non è piena e ha meno di `finance.ratingMinRevenueMonths` (3) mesi con ricavi, minimo senza ricavi e in perdita; `FinanceOutlook.Explain` dice componenti, soglie con il tasso per rating, gradino sopra, margine che basta, leva massima e debito da rimborsare (se la cassa basta), oppure che il punteggio vale già il gradino sopra;
|
||||
- voci nuove del registro: `StationUpkeep` (21), `Storage` (22), `Duties` (23), `DividendsReceived` (24, ora nell'utile); `LedgerEntries` fissa ordine e sezioni; stipendi giornalieri del personale presente nei depositi alle paghe delle industrie (`Wages`);
|
||||
- conto economico per voce: ultimi 12 mesi chiusi e 10 anni chiusi (`finance.incomeMonths`, `incomeYears`), ogni colonna con l'utile operativo e il flusso di cassa del motore;
|
||||
- avvisi di cassa negativa il primo giorno e a 30, 14, 7, 3, 1 giorni dal limite (`finance.bankruptcyWarningDaysLeft`, validati), notizia di rientro, esito dell'ADR 0012 invariato;
|
||||
- avvisi di cassa negativa dopo `finance.negativeCashNoticeDays` (3) giorni di fila e a 30, 14, 7, 3, 1 giorni dal limite (`finance.bankruptcyWarningDaysLeft`, validati), notizia di rientro solo dopo il primo avviso, esito dell'ADR 0012 invariato; la quota dei trasporti dei nuovi concorrenti usa `Company.TransportRevenue` (tariffe, noli, contratti);
|
||||
- salvataggio: corpo versione 7 (`FinanceSerializer`) con mesi, anni e misure del rating nell'hash; le versioni 1–6 partono senza mesi chiusi, con l'ultimo anno dal registro;
|
||||
- protocollo: `DetailKind.Finance` (9) e `FinanceReport` (135); server: quadro su richiesta; `ClientWorld.Finance`;
|
||||
- client: pannello «Finanze» a tutto schermo (`FinancePanel`): conto economico con «Mesi» e «Anni», rating con misure e «per salire…», soglie e tassi, prestiti con rata, interessi, scadenza, «Rimborsa» ed «Estingui», richiesta con fido e tasso, barra dei giorni di cassa negativa; testi in `strings.csv`; schermata `18_finanze` nel pilota automatico (non provata qui: manca l'editor);
|
||||
- client: pannello «Finanze» a tutto schermo (`FinancePanel`): conto economico con «Mesi» e «Anni», rating con misure e «per salire…», soglie e tassi, prestiti con rata, interessi, scadenza, «Rimborsa» ed «Estingui», richiesta con fido e tasso, barra dei giorni di cassa negativa solo con lo scoperto; frasi intere con segnaposto in `strings.csv`; schermata `18_finanze` nel pilota automatico (non provata qui: manca l'editor);
|
||||
- IA invariate: usano gli stessi comandi di prestito; accettazione F5 (un'IA al livello 3 in 15 anni) e F4 (35 / 20 guasti senza la linea, 75 / 2 con la linea) invariate;
|
||||
- test (`Economy/FinanceTests.cs`, 16, più il quadro via WebSocket in `ServerTests` e il round-trip di `FinanceReport`): tasso per rating e fisso, fido dal livello e rifiuti, interessi e quota capitale sul registro, rimborso parziale e totale, rating dalle due misure e leva infinita, spiegazione che porta al gradino sopra, finestra di 12 mesi, conto economico che somma all'utile, stipendi dei depositi, dazi, magazzini, dividendi incassati nell'utile, avvisi e bancarotta ai giorni di ogni preset (lento), rientro, salvataggio versione 7 e migrazione dalla 6, determinismo con gli invarianti, proiezione. 191 test (172 senza i lenti).
|
||||
- test (`Economy/FinanceTests.cs`, 19, più il quadro via WebSocket in `ServerTests` e il round-trip di `FinanceReport`): tasso per rating e fisso, fido dal livello e rifiuti, interessi e quota capitale sul registro, rimborso parziale e totale, rating dalle due misure e leva infinita, spiegazione che porta al gradino sopra e rimborso possibile con la cassa, punteggio che basta già (senza infiniti), margine neutro ai primi incassi, finestra di 12 mesi, conto economico che somma all'utile, stipendi dei depositi, dazi, magazzini, dividendi incassati nell'utile, avvisi e bancarotta ai giorni di ogni preset (lento), rientro e oscillazioni senza notizie, quota dei trasporti senza dividendi, salvataggio versione 7 e migrazione dalla 6, determinismo con gli invarianti, proiezione. 194 test (175 senza i lenti).
|
||||
- Restano della F6: ere e obsolescenza, pannello 07, tooltip «perché», tutorial, audio, bilanciamento con i bot.
|
||||
|
||||
## Prossimo passo
|
||||
|
||||
@@ -53,7 +53,13 @@ Mancava o era sbagliato:
|
||||
Il rimborso parziale lascia la durata invariata e ricalcola la rata.
|
||||
2. **Rating spiegabile.** Ogni mese, dopo il pagamento delle rate e la chiusura del mese:
|
||||
- *margine* = utile operativo / ricavi sugli ultimi 12 mesi chiusi (`finance.incomeMonths`; meno se la
|
||||
compagnia è più giovane), con i ricavi = tariffe e noli più le altre voci di ricavo solo se positive;
|
||||
compagnia è più giovane), con i ricavi = tariffe e noli più le altre voci di ricavo solo se positive.
|
||||
Finché la finestra non è piena e ha meno di `finance.ratingMinRevenueMonths` (3) mesi con ricavi il
|
||||
margine è neutro (0): senza questa soglia i mesi d'avvio con soli costi davano margine 0 e il primo
|
||||
incasso, piccolo rispetto a quei costi, faceva perdere tre o quattro gradini per un mese, proprio
|
||||
quando un prestito nuovo avrebbe fissato lo spread peggiore per dieci anni. Con la finestra piena (o
|
||||
con abbastanza mesi di ricavi) conta il margine vero; senza ricavi e in perdita il margine è il minimo
|
||||
(−100 %, componente nulla);
|
||||
- *leva* = debiti / patrimonio netto, con debiti = prestiti + scoperto di cassa; 0 senza debiti, infinita
|
||||
con patrimonio non positivo;
|
||||
- punteggio = `profitMarginWeight` × clamp(0,5 + margine, 0, 1) + `leverageWeight` × 1 / (1 + leva)
|
||||
@@ -64,7 +70,12 @@ Mancava o era sbagliato:
|
||||
`RatingLeverage`, `RatingScore`, `RatingMonths`). `FinanceOutlook.Explain` ne ricava, senza scrivere
|
||||
nulla, le componenti, le soglie con il tasso di un nuovo prestito per ogni rating, il gradino sopra, il
|
||||
margine che basterebbe da solo a raggiungerlo, la leva massima e il debito da rimborsare per arrivarci
|
||||
(a patrimonio invariato). Il client legge «BBB perché…, per salire ad A serve…» senza calcolare nulla.
|
||||
(a patrimonio invariato) con l'indicazione se quel rimborso è possibile oggi: si rimborsa con la cassa,
|
||||
quindi non oltre la cassa positiva né il residuo dei prestiti, e lo scoperto non si rimborsa. Se il
|
||||
punteggio raggiunge già il gradino sopra (rating iniziale dei dati, o D rimasto da una bancarotta
|
||||
risolta fino al calcolo successivo) la spiegazione lo dice («vale già A, si aggiorna a inizio mese»)
|
||||
senza obiettivi già raggiunti e senza leve infinite sul filo. Il client legge «BBB perché…, per il
|
||||
gradino A serve…» senza calcolare nulla.
|
||||
Prima del primo calcolo mensile (partita nuova o salvataggio migrato) il rating è quello iniziale dei
|
||||
dati e la spiegazione usa le misure del giorno.
|
||||
3. **Voci nuove del registro.** `StationUpkeep` (21, esercizio di binari di stazione e depositi, separato
|
||||
@@ -84,16 +95,22 @@ Mancava o era sbagliato:
|
||||
prestiti ricevuti e rimborsati, azioni, dividendi pagati, altro. I dividendi incassati ora entrano
|
||||
nell'utile (sono un reddito della compagnia), quelli pagati restano fuori. `LedgerEntries` (Core) fissa
|
||||
ordine e sezioni; `Company.OperatingProfit` ne è la somma, usata da rating, borsa, scalata e pannello.
|
||||
La quota dei trasporti che fa entrare un nuovo concorrente (12.1) usa invece `Company.TransportRevenue`
|
||||
(tariffe, noli e contratti): dividendi incassati, commercio in proprio, industrie e controllate non
|
||||
sono trasporto e non devono far sembrare una compagnia dominante.
|
||||
6. **Conto economico per voce.** A ogni chiusura di mese il registro del mese entra in
|
||||
`Company.IncomeMonths` (ultimi `finance.incomeMonths` = 12), a ogni chiusura d'anno quello dell'anno in
|
||||
`Company.IncomeYears` (ultimi `finance.incomeYears` = 10). Il quadro (`FinanceOutlook`) mostra il mese in
|
||||
corso, i mesi chiusi, l'anno in corso e gli anni chiusi, ogni colonna con l'utile operativo e il flusso
|
||||
di cassa del motore: le righe sommano al centesimo all'utile perché sono le stesse voci del registro.
|
||||
7. **Avvisi di bancarotta.** Il primo giorno di cassa negativa una notizia (avviso) dice lo scoperto e i
|
||||
giorni al limite della difficoltà; poi una notizia a 30, 14, 7, 3 e 1 giorno dal limite
|
||||
(`finance.bankruptcyWarningDaysLeft`, l'ultima critica); se la cassa torna positiva una notizia dice che
|
||||
il conto alla rovescia si azzera; al limite la notizia della bancarotta. L'esito resta quello
|
||||
dell'ADR 0012.
|
||||
7. **Avvisi di bancarotta.** Dopo `finance.negativeCashNoticeDays` (3) giorni di fila di cassa negativa
|
||||
una notizia (avviso) dice lo scoperto e i giorni al limite della difficoltà; poi una notizia a 30, 14,
|
||||
7, 3 e 1 giorno dal limite (`finance.bankruptcyWarningDaysLeft`, l'ultima critica); se la cassa torna
|
||||
positiva dopo almeno quei giorni una notizia dice che il conto alla rovescia si azzera; al limite la
|
||||
notizia della bancarotta. Una cassa che oscilla intorno a zero (costi giornalieri contro incassi) azzera
|
||||
il conto ogni volta senza riempire le notizie. Il pannello mostra il conto alla rovescia solo con la
|
||||
cassa davvero negativa: dopo un prestito che la riporta sopra zero dice che il conto si azzera domani
|
||||
(il motore conta i giorni una volta al giorno). L'esito resta quello dell'ADR 0012.
|
||||
8. **Salvataggio versione 7.** `FinanceSerializer` in coda allo stato dinamico, nell'hash: mesi e anni
|
||||
chiusi (voci allungate a zero se in futuro se ne aggiungono) e misure del rating. Le versioni 1–6 si
|
||||
caricano con zero mesi chiusi (la finestra si riempie dal mese dopo), l'ultimo anno chiuso ricavato dal
|
||||
@@ -109,8 +126,10 @@ Mancava o era sbagliato:
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Le compagnie con depositi pagano gli stipendi e hanno utili un po' più bassi; il rating guarda 12 mesi
|
||||
e la leva sul patrimonio, quindi reagisce meno ai primi mesi e più all'indebitamento. Le IA usano gli
|
||||
- Le compagnie con depositi pagano gli stipendi e hanno utili un po' più bassi; il rating guarda fino a
|
||||
12 mesi e la leva sul patrimonio. Nei primi mesi il margine non conta finché non ci sono tre mesi con
|
||||
ricavi, quindi all'avvio il rating dipende dalla leva; da lì in poi la finestra cresce mese per mese e il
|
||||
rating si muove più dei mesi successivi, quando la finestra è piena. Le IA usano gli
|
||||
stessi prestiti e lo stesso rating (nessun cambiamento nel loro codice); le soglie restano provvisorie
|
||||
fino al bilanciamento della F6.
|
||||
- Il salvataggio cresce di circa 22 mesi × 25 voci per compagnia; l'hash giornaliero li include.
|
||||
|
||||
@@ -396,9 +396,19 @@ public sealed class FinanceBalance
|
||||
public required int IncomeYears { get; init; }
|
||||
/// <summary>
|
||||
/// Giorni mancanti alla bancarotta in cui la compagnia riceve un avviso, in ordine decrescente
|
||||
/// (oltre all'avviso del primo giorno di cassa negativa, ADR 0019).
|
||||
/// (oltre al primo avviso dopo <see cref="NegativeCashNoticeDays"/> giorni, ADR 0019).
|
||||
/// </summary>
|
||||
public required int[] BankruptcyWarningDaysLeft { get; init; }
|
||||
/// <summary>
|
||||
/// Mesi chiusi con ricavi che servono, finché la finestra del rating non è piena, perché il margine
|
||||
/// conti: prima il margine è neutro (0), così i primi incassi non fanno crollare il rating (ADR 0019).
|
||||
/// </summary>
|
||||
public required int RatingMinRevenueMonths { get; init; }
|
||||
/// <summary>
|
||||
/// Giorni di cassa negativa di fila prima del primo avviso; il rientro si annuncia solo dopo almeno
|
||||
/// altrettanti giorni, così una cassa che oscilla intorno a zero non riempie le notizie (ADR 0019).
|
||||
/// </summary>
|
||||
public required int NegativeCashNoticeDays { get; init; }
|
||||
}
|
||||
|
||||
public sealed class StockMarketBalance
|
||||
|
||||
@@ -192,6 +192,9 @@ public static class DataValidator
|
||||
Increasing("balance.json", "finance.ratingByScore (decrescente)", Enumerable.Reverse(b.Finance.RatingByScore), errors);
|
||||
if (b.Finance.IncomeMonths < 1 || b.Finance.IncomeMonths > 120) Err("balance.json", "finance.incomeMonths deve stare tra 1 e 120");
|
||||
if (b.Finance.IncomeYears < 1 || b.Finance.IncomeYears > 100) Err("balance.json", "finance.incomeYears deve stare tra 1 e 100");
|
||||
if (b.Finance.RatingMinRevenueMonths < 1 || b.Finance.RatingMinRevenueMonths > b.Finance.IncomeMonths)
|
||||
Err("balance.json", "finance.ratingMinRevenueMonths deve stare tra 1 e finance.incomeMonths");
|
||||
if (b.Finance.NegativeCashNoticeDays < 1) Err("balance.json", "finance.negativeCashNoticeDays deve essere almeno 1");
|
||||
if (b.Finance.ProfitMarginWeight <= 0 || b.Finance.LeverageWeight <= 0) Err("balance.json", "finance.profitMarginWeight e finance.leverageWeight devono essere positivi");
|
||||
for (int i = 0; i < b.Finance.BankruptcyWarningDaysLeft.Length; i++)
|
||||
{
|
||||
|
||||
@@ -119,7 +119,7 @@ public sealed class ClimbOutlookReport
|
||||
public required Money MaxLoan { get; init; }
|
||||
public required Money LoanAvailable { get; init; }
|
||||
public required double NewLoanRate { get; init; }
|
||||
/// <summary>In amministrazione controllata i prestiti non si possono chiedere.</summary>
|
||||
/// <summary>In bancarotta o in amministrazione controllata i prestiti non si possono chiedere (come in <see cref="FinanceOutlook"/>).</summary>
|
||||
public required bool LoansAllowed { get; init; }
|
||||
/// <summary>Patrimonio netto: fondazione, fine di ogni anno dello storico, oggi.</summary>
|
||||
public required List<NetWorthPoint> History { get; init; }
|
||||
@@ -165,7 +165,7 @@ public static class ClimbOutlook
|
||||
MaxLoan = max,
|
||||
LoanAvailable = Money.Max(Money.Zero, max - c.Debt),
|
||||
NewLoanRate = FinanceSystem.LoanRate(w, c),
|
||||
LoansAllowed = !c.Receivership,
|
||||
LoansAllowed = !c.Receivership && !c.Bankrupt,
|
||||
History = History(w, c),
|
||||
};
|
||||
}
|
||||
|
||||
@@ -294,6 +294,14 @@ public sealed class Company
|
||||
return sum;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Ricavi dei trasporti: tariffe merci e passeggeri e contratti con le industrie (se positivi). Misura la
|
||||
/// quota dei trasporti dei nuovi concorrenti (12.1), senza commercio in proprio, industrie, controllate
|
||||
/// e dividendi incassati, che non sono trasporto.
|
||||
/// </summary>
|
||||
public static long TransportRevenue(long[] entries) =>
|
||||
entries[(int)LedgerEntry.FreightRevenue] + entries[(int)LedgerEntry.PassengerRevenue] + Math.Max(0, entries[(int)LedgerEntry.Contracts]);
|
||||
|
||||
/// <summary>
|
||||
/// Ricavi d'esercizio: tariffe merci e passeggeri come sono, le altre voci di ricavo solo se positive
|
||||
/// (commercio, contratti, industrie, controllate, dividendi incassati).
|
||||
|
||||
@@ -47,6 +47,15 @@ public sealed class RatingExplanation
|
||||
public required bool Bankrupt { get; init; }
|
||||
/// <summary>Mesi chiusi nella finestra del margine (fino a finance.incomeMonths).</summary>
|
||||
public required int Months { get; init; }
|
||||
/// <summary>Mesi della finestra con ricavi.</summary>
|
||||
public required int RevenueMonths { get; init; }
|
||||
/// <summary>
|
||||
/// Margine neutro (0) perché la finestra non è piena e ha meno di <see cref="MinRevenueMonths"/> mesi
|
||||
/// con ricavi (avvio della compagnia).
|
||||
/// </summary>
|
||||
public required bool MarginNeutral { get; init; }
|
||||
/// <summary>Mesi con ricavi che servono perché il margine conti prima che la finestra sia piena (finance.ratingMinRevenueMonths).</summary>
|
||||
public required int MinRevenueMonths { get; init; }
|
||||
public required double Margin { get; init; }
|
||||
/// <summary>Debiti / patrimonio netto (+∞ con patrimonio non positivo e debiti: <see cref="LeverageUnbounded"/>).</summary>
|
||||
public required double Leverage { get; init; }
|
||||
@@ -61,6 +70,13 @@ public sealed class RatingExplanation
|
||||
/// <summary>Gradino sopra (null ad AAA) e punteggio che richiede.</summary>
|
||||
public required CreditRating? Next { get; init; }
|
||||
public required double NextThreshold { get; init; }
|
||||
/// <summary>Rating che corrisponde al punteggio (D in bancarotta).</summary>
|
||||
public required CreditRating ScoreRating { get; init; }
|
||||
/// <summary>
|
||||
/// Il punteggio raggiunge già il gradino sopra: il rating mostrato è quello iniziale o di un calcolo
|
||||
/// precedente e cambia al prossimo calcolo mensile. Margine e leva necessari non si calcolano.
|
||||
/// </summary>
|
||||
public required bool NextAlreadyMet { get; init; }
|
||||
/// <summary>Margine che basterebbe da solo, a leva invariata (se raggiungibile).</summary>
|
||||
public required double MarginNeeded { get; init; }
|
||||
public required bool MarginReachable { get; init; }
|
||||
@@ -69,6 +85,11 @@ public sealed class RatingExplanation
|
||||
public required bool LeverageReachable { get; init; }
|
||||
/// <summary>Debiti da rimborsare oggi per scendere sotto <see cref="LeverageMax"/> (0 se già sotto o irraggiungibile).</summary>
|
||||
public required Money DebtToRepay { get; init; }
|
||||
/// <summary>
|
||||
/// Il rimborso di <see cref="DebtToRepay"/> si può fare oggi: non supera la cassa disponibile né il
|
||||
/// residuo dei prestiti (lo scoperto non si rimborsa, si copre solo riportando la cassa sopra zero).
|
||||
/// </summary>
|
||||
public required bool RepayAffordable { get; init; }
|
||||
}
|
||||
|
||||
/// <summary>Prestito in corso con rata e scadenza.</summary>
|
||||
@@ -204,13 +225,14 @@ public static class FinanceOutlook
|
||||
/// Spiegazione del rating con le misure dell'ultimo calcolo mensile (prima del primo calcolo, quelle di
|
||||
/// oggi). Per il gradino sopra: il margine che basterebbe a leva invariata, il debiti/patrimonio massimo
|
||||
/// a margine invariato e quanto debito rimborsare oggi per arrivarci (a patrimonio invariato: il
|
||||
/// rimborso toglie lo stesso importo da cassa e debiti).
|
||||
/// rimborso toglie lo stesso importo da cassa e debiti). Se il punteggio raggiunge già il gradino sopra
|
||||
/// (rating iniziale o rimasto da un calcolo precedente) lo dice e non calcola obiettivi già raggiunti.
|
||||
/// </summary>
|
||||
public static RatingExplanation Explain(World w, Company c)
|
||||
{
|
||||
var fb = w.Data.Balance.Finance;
|
||||
bool initial = c.RatingMonths == 0;
|
||||
var live = FinanceSystem.Measures(c);
|
||||
var live = FinanceSystem.Measures(w, c);
|
||||
double margin = initial ? live.Margin : c.RatingMargin;
|
||||
double leverage = initial ? live.Leverage : c.RatingLeverage;
|
||||
double cm = FinanceSystem.MarginComponent(margin), cl = FinanceSystem.LeverageComponent(leverage);
|
||||
@@ -221,32 +243,41 @@ public static class FinanceOutlook
|
||||
|
||||
CreditRating? next = c.Rating > CreditRating.AAA ? c.Rating - 1 : null;
|
||||
double target = next is { } n ? fb.RatingByScore[(int)n] : 0;
|
||||
var scoreRating = c.Bankrupt ? CreditRating.D : FinanceSystem.RatingOf(w, score);
|
||||
bool alreadyMet = next is not null && !c.Bankrupt && score >= target;
|
||||
double marginNeeded = 0, leverageMax = 0;
|
||||
bool marginOk = false, leverageOk = false;
|
||||
bool marginOk = false, leverageOk = false, affordable = false;
|
||||
var repay = Money.Zero;
|
||||
if (next is not null && !c.Bankrupt)
|
||||
if (next is not null && !c.Bankrupt && !alreadyMet)
|
||||
{
|
||||
// punteggio sotto la soglia: needCm > cm ≥ 0 e needCl > cl ≥ 0, quindi niente infiniti
|
||||
// pesoMargine·clamp(0,5 + m) + pesoLeva·cl = soglia → m
|
||||
double needCm = (target - fb.LeverageWeight * cl) / fb.ProfitMarginWeight;
|
||||
marginOk = needCm <= 1;
|
||||
marginNeeded = Math.Max(-0.5, needCm - 0.5);
|
||||
marginNeeded = needCm - 0.5;
|
||||
// pesoMargine·cm + pesoLeva / (1 + ℓ) = soglia → ℓ
|
||||
double needCl = (target - fb.ProfitMarginWeight * cm) / fb.LeverageWeight;
|
||||
leverageOk = needCl <= 1;
|
||||
leverageMax = needCl <= 0 ? double.PositiveInfinity : leverageOk ? 1 / needCl - 1 : 0;
|
||||
if (leverageOk && live.Equity > 0 && needCl > 0)
|
||||
leverageMax = leverageOk ? 1 / needCl - 1 : 0;
|
||||
if (leverageOk && live.Equity > 0)
|
||||
{
|
||||
repay = new Money(Math.Max(0, live.Debt - (long)Math.Floor(leverageMax * live.Equity)));
|
||||
// si rimborsano i prestiti con la cassa: non oltre la cassa positiva né oltre il residuo
|
||||
long repayable = Math.Min(c.Debt.Cents, Math.Max(0, c.Cash.Cents));
|
||||
affordable = repay.Cents <= repayable;
|
||||
}
|
||||
}
|
||||
return new RatingExplanation
|
||||
{
|
||||
Rating = c.Rating, Initial = initial, Bankrupt = c.Bankrupt,
|
||||
Months = initial ? live.Months : c.RatingMonths,
|
||||
RevenueMonths = live.RevenueMonths, MarginNeutral = live.MarginNeutral, MinRevenueMonths = fb.RatingMinRevenueMonths,
|
||||
Margin = margin, Leverage = leverage,
|
||||
MarginWeight = fb.ProfitMarginWeight, LeverageWeight = fb.LeverageWeight,
|
||||
MarginComponent = cm, LeverageComponent = cl, Score = score,
|
||||
Thresholds = thresholds, Next = next, NextThreshold = target,
|
||||
Thresholds = thresholds, Next = next, NextThreshold = target, ScoreRating = scoreRating, NextAlreadyMet = alreadyMet,
|
||||
MarginNeeded = marginNeeded, MarginReachable = marginOk,
|
||||
LeverageMax = leverageMax, LeverageReachable = leverageOk, DebtToRepay = repay,
|
||||
LeverageMax = leverageMax, LeverageReachable = leverageOk, DebtToRepay = repay, RepayAffordable = affordable,
|
||||
};
|
||||
}
|
||||
|
||||
|
||||
@@ -73,16 +73,19 @@ public sealed class FinanceSystem : ISimSystem
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Giorni di cassa negativa (guida 6.3): avviso il primo giorno, poi quando mancano i giorni di
|
||||
/// finance.bankruptcyWarningDaysLeft; bancarotta al limite della difficoltà (difficulty.json,
|
||||
/// bankruptcyDays). Se la cassa torna positiva il conto alla rovescia si azzera con un avviso.
|
||||
/// Giorni di cassa negativa (guida 6.3): primo avviso dopo finance.negativeCashNoticeDays giorni di
|
||||
/// fila, poi quando mancano i giorni di finance.bankruptcyWarningDaysLeft; bancarotta al limite della
|
||||
/// difficoltà (difficulty.json, bankruptcyDays). Se la cassa torna positiva il conto alla rovescia si
|
||||
/// azzera, con un avviso solo se era durato almeno i giorni del primo avviso: una cassa che oscilla
|
||||
/// intorno a zero non riempie le notizie.
|
||||
/// </summary>
|
||||
private static void UpdateNegativeCash(WorldContext ctx, Company c)
|
||||
{
|
||||
var w = ctx.World;
|
||||
int notice = w.Data.Balance.Finance.NegativeCashNoticeDays;
|
||||
if (!c.Cash.IsNegative)
|
||||
{
|
||||
if (c.NegativeCashDays > 0)
|
||||
if (c.NegativeCashDays >= notice)
|
||||
ctx.Emit(new GameEvent(ctx.Day, EventKind.Finance, EventSeverity.Info,
|
||||
$"{c.Name}: la cassa torna positiva dopo {Days(c.NegativeCashDays)} di scoperto, il conto alla rovescia della bancarotta si azzera",
|
||||
EntityKind.Company, c.Id.Value, c.Id));
|
||||
@@ -99,10 +102,10 @@ public sealed class FinanceSystem : ISimSystem
|
||||
return;
|
||||
}
|
||||
var warnings = w.Data.Balance.Finance.BankruptcyWarningDaysLeft;
|
||||
if (c.NegativeCashDays == 1)
|
||||
if (c.NegativeCashDays == notice)
|
||||
{
|
||||
ctx.Emit(new GameEvent(ctx.Day, EventKind.Finance, EventSeverity.Warning,
|
||||
$"{c.Name}: cassa negativa ({c.Cash}); se non torna sopra zero la bancarotta arriva tra {Days(left)}",
|
||||
$"{c.Name}: cassa negativa da {Days(c.NegativeCashDays)} ({c.Cash}); se non torna sopra zero la bancarotta arriva tra {Days(left)}",
|
||||
EntityKind.Company, c.Id.Value, c.Id));
|
||||
}
|
||||
else if (Array.IndexOf(warnings, left) >= 0)
|
||||
@@ -286,20 +289,29 @@ public sealed class FinanceSystem : ISimSystem
|
||||
/// Misure del rating (ADR 0019): margine = utile operativo / ricavi dei mesi chiusi conservati
|
||||
/// (finance.incomeMonths, 12), leva = debiti (prestiti e scoperto di cassa) / patrimonio netto
|
||||
/// (+∞ con patrimonio non positivo e debiti).
|
||||
/// Il margine è neutro (0) finché la finestra non è piena e ha meno di finance.ratingMinRevenueMonths
|
||||
/// mesi con ricavi: i primi incassi, piccoli rispetto ai costi dei mesi d'avvio, non fanno crollare il
|
||||
/// rating per poi farlo risalire il mese dopo. Con la finestra piena (o con abbastanza mesi di ricavi)
|
||||
/// conta il margine vero; senza ricavi e in perdita è il minimo (−100 %, componente nulla).
|
||||
/// </summary>
|
||||
public static RatingMeasures Measures(Company c)
|
||||
public static RatingMeasures Measures(World w, Company c)
|
||||
{
|
||||
var fb = w.Data.Balance.Finance;
|
||||
long revenue = 0, profit = 0;
|
||||
int revenueMonths = 0;
|
||||
foreach (var m in c.IncomeMonths)
|
||||
{
|
||||
revenue += Company.Revenue(m.Entries);
|
||||
long r = Company.Revenue(m.Entries);
|
||||
revenue += r;
|
||||
profit += Company.OperatingProfit(m.Entries);
|
||||
if (r > 0) revenueMonths++;
|
||||
}
|
||||
double margin = revenue > 0 ? (double)profit / revenue : 0;
|
||||
bool neutral = revenueMonths < fb.RatingMinRevenueMonths && c.IncomeMonths.Count < fb.IncomeMonths;
|
||||
double margin = neutral ? 0 : revenue > 0 ? (double)profit / revenue : profit < 0 ? -1 : 0;
|
||||
long debt = c.Debt.Cents + Math.Max(0, -c.Cash.Cents);
|
||||
long equity = c.NetWorth.Cents;
|
||||
double leverage = debt <= 0 ? 0 : equity <= 0 ? double.PositiveInfinity : (double)debt / equity;
|
||||
return new RatingMeasures(c.IncomeMonths.Count, revenue, profit, margin, debt, equity, leverage);
|
||||
return new RatingMeasures(c.IncomeMonths.Count, revenueMonths, neutral, revenue, profit, margin, debt, equity, leverage);
|
||||
}
|
||||
|
||||
/// <summary>Componente del margine nel punteggio: clamp(0,5 + margine, 0, 1).</summary>
|
||||
@@ -336,7 +348,7 @@ public sealed class FinanceSystem : ISimSystem
|
||||
/// </summary>
|
||||
public static CreditRating ComputeRating(World w, Company c)
|
||||
{
|
||||
var m = Measures(c);
|
||||
var m = Measures(w, c);
|
||||
return c.Bankrupt ? CreditRating.D : RatingOf(w, Score(w, m.Margin, m.Leverage));
|
||||
}
|
||||
|
||||
@@ -346,7 +358,7 @@ public sealed class FinanceSystem : ISimSystem
|
||||
/// </summary>
|
||||
public static void UpdateRating(World w, Company c)
|
||||
{
|
||||
var m = Measures(c);
|
||||
var m = Measures(w, c);
|
||||
c.RatingMargin = m.Margin;
|
||||
c.RatingLeverage = m.Leverage;
|
||||
c.RatingScore = Score(w, m.Margin, m.Leverage);
|
||||
@@ -369,7 +381,9 @@ public sealed class FinanceSystem : ISimSystem
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Misure del rating (ADR 0019): mesi della finestra, ricavi e utile operativo dei mesi, margine,
|
||||
/// debiti (prestiti e scoperto) e patrimonio netto in centesimi, leva = debiti / patrimonio.
|
||||
/// Misure del rating (ADR 0019): mesi della finestra e quanti con ricavi, margine neutro (avvio), ricavi e
|
||||
/// utile operativo dei mesi, margine, debiti (prestiti e scoperto) e patrimonio netto in centesimi,
|
||||
/// leva = debiti / patrimonio.
|
||||
/// </summary>
|
||||
public readonly record struct RatingMeasures(int Months, long Revenue, long Profit, double Margin, long Debt, long Equity, double Leverage);
|
||||
public readonly record struct RatingMeasures(int Months, int RevenueMonths, bool MarginNeutral, long Revenue, long Profit, double Margin,
|
||||
long Debt, long Equity, double Leverage);
|
||||
@@ -362,8 +362,8 @@ public sealed class StockMarketSystem : ISimSystem
|
||||
Corporate.AddYear(w, c, Corporate.Snapshot(w, c, w.Clock.Year - 1, c.LastYearEntries));
|
||||
|
||||
/// <summary>
|
||||
/// Nuovi concorrenti (12.1): se una compagnia supera la soglia di concentrazione dei ricavi
|
||||
/// dell'anno, entra una nuova IA (al massimo una ogni pochi anni e fino al numero massimo).
|
||||
/// Nuovi concorrenti (12.1): se una compagnia supera la soglia di concentrazione dei ricavi dei
|
||||
/// trasporti dell'anno (<see cref="Company.TransportRevenue"/>), entra una nuova IA (al massimo una ogni pochi anni e fino al numero massimo).
|
||||
/// </summary>
|
||||
private static void NewCompetitors(WorldContext ctx)
|
||||
{
|
||||
@@ -377,7 +377,7 @@ public sealed class StockMarketSystem : ISimSystem
|
||||
{
|
||||
if (c.Defunct) continue;
|
||||
active++;
|
||||
long r = Company.Revenue(c.LastYearEntries);
|
||||
long r = Company.TransportRevenue(c.LastYearEntries);
|
||||
total += r;
|
||||
if (r > best)
|
||||
{
|
||||
|
||||
@@ -151,6 +151,13 @@ public sealed class FinanceReport : IMessage
|
||||
/// <summary>Prima del primo calcolo mensile: rating iniziale dei dati, misure di oggi.</summary>
|
||||
public bool RatingInitial { get; init; }
|
||||
public byte RatingMonths { get; init; }
|
||||
/// <summary>
|
||||
/// Mesi della finestra con ricavi; con <see cref="MarginNeutral"/> il margine vale 0 finché non ce ne
|
||||
/// sono <see cref="MinRevenueMonths"/> (o la finestra non è piena).
|
||||
/// </summary>
|
||||
public byte RevenueMonths { get; init; }
|
||||
public bool MarginNeutral { get; init; }
|
||||
public byte MinRevenueMonths { get; init; }
|
||||
public float Margin { get; init; }
|
||||
/// <summary>Debiti / patrimonio netto; con <see cref="LeverageUnbounded"/> il patrimonio non è positivo e la leva è infinita.</summary>
|
||||
public float Leverage { get; init; }
|
||||
@@ -161,14 +168,22 @@ public sealed class FinanceReport : IMessage
|
||||
public float LeverageComponent { get; init; }
|
||||
public float Score { get; init; }
|
||||
public List<RatingThresholdInfo> Thresholds { get; init; } = [];
|
||||
/// <summary>Gradino sopra ("" ad AAA) con la soglia, il margine che basterebbe, la leva massima e il debito da rimborsare.</summary>
|
||||
/// <summary>
|
||||
/// Gradino sopra ("" ad AAA) con la soglia, il margine che basterebbe, la leva massima e il debito da
|
||||
/// rimborsare; con <see cref="NextAlreadyMet"/> il punteggio basta già (rating <see cref="ScoreRating"/>
|
||||
/// al prossimo calcolo mensile) e gli obiettivi non si calcolano.
|
||||
/// </summary>
|
||||
public string NextRating { get; init; } = "";
|
||||
public float NextThreshold { get; init; }
|
||||
public bool NextAlreadyMet { get; init; }
|
||||
public string ScoreRating { get; init; } = "";
|
||||
public float MarginNeeded { get; init; }
|
||||
public bool MarginReachable { get; init; }
|
||||
public float LeverageMax { get; init; }
|
||||
public bool LeverageReachable { get; init; }
|
||||
public Money DebtToRepay { get; init; }
|
||||
/// <summary>Il rimborso indicato non supera la cassa né il residuo dei prestiti (lo scoperto non si rimborsa).</summary>
|
||||
public bool RepayAffordable { get; init; }
|
||||
|
||||
/// <summary>Prestiti, fido e condizioni di un nuovo prestito (base della difficoltà + spread del rating).</summary>
|
||||
public List<FinanceLoanInfo> LoanList { get; init; } = [];
|
||||
@@ -194,12 +209,13 @@ public sealed class FinanceReport : IMessage
|
||||
foreach (var l in Lines) l.Write(ref w);
|
||||
w.Count(Columns.Count);
|
||||
foreach (var c in Columns) c.Write(ref w);
|
||||
w.String(Rating); w.Bool(RatingInitial); w.U8(RatingMonths); w.F32(Margin); w.F32(Leverage); w.Bool(LeverageUnbounded);
|
||||
w.String(Rating); w.Bool(RatingInitial); w.U8(RatingMonths); w.U8(RevenueMonths); w.Bool(MarginNeutral); w.U8(MinRevenueMonths); w.F32(Margin); w.F32(Leverage); w.Bool(LeverageUnbounded);
|
||||
w.F32(MarginWeight); w.F32(LeverageWeight); w.F32(MarginComponent); w.F32(LeverageComponent); w.F32(Score);
|
||||
w.Count(Thresholds.Count);
|
||||
foreach (var t in Thresholds) t.Write(ref w);
|
||||
w.String(NextRating); w.F32(NextThreshold); w.F32(MarginNeeded); w.Bool(MarginReachable); w.F32(LeverageMax); w.Bool(LeverageReachable);
|
||||
w.Money(DebtToRepay);
|
||||
w.String(NextRating); w.F32(NextThreshold); w.Bool(NextAlreadyMet); w.String(ScoreRating);
|
||||
w.F32(MarginNeeded); w.Bool(MarginReachable); w.F32(LeverageMax); w.Bool(LeverageReachable);
|
||||
w.Money(DebtToRepay); w.Bool(RepayAffordable);
|
||||
w.Count(LoanList.Count);
|
||||
foreach (var l in LoanList) l.Write(ref w);
|
||||
w.Money(MaxLoan); w.Money(LoanAvailable); w.F32(NewLoanRate); w.F32(BaseRate); w.F32(Spread); w.I32(LoanTermMonths); w.Money(LoanStep);
|
||||
@@ -222,18 +238,24 @@ public sealed class FinanceReport : IMessage
|
||||
for (int n = r.Count(), i = 0; i < n; i++) columns.Add(IncomeColumnInfo.Read(ref r));
|
||||
string rating = r.String();
|
||||
bool initial = r.Bool();
|
||||
byte months = r.U8();
|
||||
byte months = r.U8(), revenueMonths = r.U8();
|
||||
bool neutral = r.Bool();
|
||||
byte minRevenueMonths = r.U8();
|
||||
float margin = r.F32(), leverage = r.F32();
|
||||
bool unbounded = r.Bool();
|
||||
float marginWeight = r.F32(), leverageWeight = r.F32(), marginComponent = r.F32(), leverageComponent = r.F32(), score = r.F32();
|
||||
var thresholds = new List<RatingThresholdInfo>();
|
||||
for (int n = r.Count(), i = 0; i < n; i++) thresholds.Add(RatingThresholdInfo.Read(ref r));
|
||||
string next = r.String();
|
||||
float nextThreshold = r.F32(), marginNeeded = r.F32();
|
||||
float nextThreshold = r.F32();
|
||||
bool alreadyMet = r.Bool();
|
||||
string scoreRating = r.String();
|
||||
float marginNeeded = r.F32();
|
||||
bool marginReachable = r.Bool();
|
||||
float leverageMax = r.F32();
|
||||
bool leverageReachable = r.Bool();
|
||||
var repay = r.Money();
|
||||
bool affordable = r.Bool();
|
||||
var loanList = new List<FinanceLoanInfo>();
|
||||
for (int n = r.Count(), i = 0; i < n; i++) loanList.Add(FinanceLoanInfo.Read(ref r));
|
||||
var maxLoan = r.Money();
|
||||
@@ -249,11 +271,12 @@ public sealed class FinanceReport : IMessage
|
||||
{
|
||||
Day = day, Company = company, Cash = cash, NetWorth = worth, Loans = loans, Overdraft = overdraft,
|
||||
Lines = lines, Columns = columns,
|
||||
Rating = rating, RatingInitial = initial, RatingMonths = months, Margin = margin, Leverage = leverage, LeverageUnbounded = unbounded,
|
||||
Rating = rating, RatingInitial = initial, RatingMonths = months, RevenueMonths = revenueMonths, MarginNeutral = neutral,
|
||||
MinRevenueMonths = minRevenueMonths, Margin = margin, Leverage = leverage, LeverageUnbounded = unbounded,
|
||||
MarginWeight = marginWeight, LeverageWeight = leverageWeight, MarginComponent = marginComponent, LeverageComponent = leverageComponent,
|
||||
Score = score, Thresholds = thresholds,
|
||||
NextRating = next, NextThreshold = nextThreshold, MarginNeeded = marginNeeded, MarginReachable = marginReachable,
|
||||
LeverageMax = leverageMax, LeverageReachable = leverageReachable, DebtToRepay = repay,
|
||||
NextRating = next, NextThreshold = nextThreshold, NextAlreadyMet = alreadyMet, ScoreRating = scoreRating, MarginNeeded = marginNeeded, MarginReachable = marginReachable,
|
||||
LeverageMax = leverageMax, LeverageReachable = leverageReachable, DebtToRepay = repay, RepayAffordable = affordable,
|
||||
LoanList = loanList, MaxLoan = maxLoan, LoanAvailable = available, NewLoanRate = newRate, BaseRate = baseRate, Spread = spread,
|
||||
LoanTermMonths = term, LoanStep = step, LoansAllowed = allowed,
|
||||
NegativeCashDays = negDays, BankruptcyDays = limit, Bankrupt = bankrupt, Receivership = receivership,
|
||||
|
||||
@@ -605,12 +605,15 @@ public static class Projection
|
||||
Values = c.Entries.Select((v, i) => (v, i)).Where(x => x.v != 0).Select(x => new AmountInfo { Kind = (byte)x.i, Value = new Money(x.v) }).ToList(),
|
||||
}).ToList(),
|
||||
Rating = r.Rating.ToString(), RatingInitial = r.Initial, RatingMonths = (byte)Math.Clamp(r.Months, 0, 255),
|
||||
RevenueMonths = (byte)Math.Clamp(r.RevenueMonths, 0, 255), MarginNeutral = r.MarginNeutral, MinRevenueMonths = (byte)Math.Clamp(r.MinRevenueMonths, 0, 255),
|
||||
Margin = F(r.Margin), Leverage = r.LeverageUnbounded ? 0 : F(r.Leverage), LeverageUnbounded = r.LeverageUnbounded,
|
||||
MarginWeight = (float)r.MarginWeight, LeverageWeight = (float)r.LeverageWeight, MarginComponent = (float)r.MarginComponent,
|
||||
LeverageComponent = (float)r.LeverageComponent, Score = (float)r.Score,
|
||||
Thresholds = r.Thresholds.Select(t => new RatingThresholdInfo { Rating = t.Rating.ToString(), MinScore = (float)t.MinScore, LoanRate = (float)t.LoanRate }).ToList(),
|
||||
NextRating = r.Next?.ToString() ?? "", NextThreshold = (float)r.NextThreshold, MarginNeeded = F(r.MarginNeeded), MarginReachable = r.MarginReachable,
|
||||
NextRating = r.Next?.ToString() ?? "", NextThreshold = (float)r.NextThreshold,
|
||||
NextAlreadyMet = r.NextAlreadyMet, ScoreRating = r.ScoreRating.ToString(), MarginNeeded = F(r.MarginNeeded), MarginReachable = r.MarginReachable,
|
||||
LeverageMax = F(r.LeverageMax), LeverageReachable = r.LeverageReachable, DebtToRepay = r.DebtToRepay,
|
||||
RepayAffordable = r.RepayAffordable,
|
||||
LoanList = report.LoanList.Select(l => new FinanceLoanInfo
|
||||
{
|
||||
Loan = l.Id.Value, Principal = l.Principal, Remaining = l.Remaining, AnnualRate = (float)l.AnnualRate, MonthsLeft = l.MonthsLeft,
|
||||
|
||||
@@ -90,10 +90,10 @@ public sealed class SimulateCommand : IToolCommand
|
||||
csv.AppendLine(string.Join(';', year.ToString(It), "", def.Id, Dec(price), produced.ToString(It), consumed.ToString(It),
|
||||
population.ToString(It), Dec(efficiency), "", Dec(plant), "", "", "", note));
|
||||
}
|
||||
long totalCarrier = w.Companies.Sum(c => Company.Revenue(c.LastYearEntries));
|
||||
long totalCarrier = w.Companies.Sum(c => Company.TransportRevenue(c.LastYearEntries));
|
||||
foreach (var c in w.Companies)
|
||||
{
|
||||
long revenue = Company.Revenue(c.LastYearEntries);
|
||||
long revenue = Company.TransportRevenue(c.LastYearEntries);
|
||||
double share = totalCarrier > 0 ? (double)revenue / totalCarrier : 0;
|
||||
string note = $"{(c.IsPlayer ? "giocatore" : c.AiPersonality)}, rating {c.Rating}, livello {c.Tier}{(c.Bankrupt ? ", bancarotta" : "")}{(c.Merged ? ", fusa" : "")}{AiNote(w, c)}";
|
||||
bool fleet = w.Trains.Any(t => !t.Removed && t.Owner == c.Id && t.Vehicles.Count > 0);
|
||||
|
||||
@@ -240,16 +240,91 @@ public static class FinanceTests
|
||||
{
|
||||
Assert.Equal(e.Next.Value, FinanceSystem.RatingOf(w, FinanceSystem.Score(w, c.RatingMargin, e.LeverageMax - 1e-9)), "con la leva indicata si sale");
|
||||
// rimborsando il debito indicato la leva scende sotto il massimo (il patrimonio non cambia)
|
||||
var live = FinanceSystem.Measures(c);
|
||||
var live = FinanceSystem.Measures(w, c);
|
||||
Assert.True((double)(live.Debt - e.DebtToRepay.Cents) / live.Equity <= e.LeverageMax + 1e-9, "debito da rimborsare");
|
||||
Assert.True(e.RepayAffordable == (e.DebtToRepay <= Money.Min(c.Debt, Money.Max(Money.Zero, c.Cash))), "rimborso possibile con la cassa");
|
||||
}
|
||||
Assert.True(e.MarginReachable || e.LeverageReachable, "almeno una via per salire");
|
||||
Assert.False(e.NextAlreadyMet, "il punteggio non basta ancora");
|
||||
|
||||
// la prima volta il rating è quello dei dati e le misure sono di oggi
|
||||
// pochi contanti e molti attivi non monetari: il rimborso che servirebbe supera la cassa, quindi oggi
|
||||
// non è percorribile (si rimborsa con la cassa; lo scoperto non si rimborsa)
|
||||
SetCash(w, c, Money.FromLire(10_000));
|
||||
c.BookValues[(int)AssetCategory.Vehicles] += Money.FromLire(400_000).Cents;
|
||||
var poor = FinanceOutlook.Explain(w, c);
|
||||
Assert.True(poor.LeverageReachable && poor.DebtToRepay > c.Cash && !poor.RepayAffordable, $"rimborso {poor.DebtToRepay} con cassa {c.Cash}");
|
||||
SetCash(w, c, Money.FromLire(-1));
|
||||
Assert.False(FinanceOutlook.Explain(w, c).RepayAffordable, "con la cassa negativa nessun rimborso");
|
||||
}
|
||||
|
||||
[Test(Description = "Se il punteggio basta già per il gradino sopra (rating iniziale o rimasto indietro) la spiegazione lo dice senza obiettivi né infiniti")]
|
||||
public static void RatingExplanationWhenTheScoreAlreadyMeetsTheNextNotch()
|
||||
{
|
||||
var fb = TestData.Data.Balance.Finance;
|
||||
// partita nuova: rating iniziale dei dati, misure di oggi (margine neutro, nessun debito)
|
||||
var fresh = TestWorlds.NoAi(907);
|
||||
var first = FinanceOutlook.Explain(fresh, fresh.Player);
|
||||
Assert.True(first.Initial);
|
||||
Assert.Equal(fb.StartingRating, first.Rating);
|
||||
Assert.True(first.MarginNeutral, "nessun mese chiuso: margine neutro");
|
||||
Assert.True(first.Score >= first.NextThreshold, $"con i dati attuali il punteggio iniziale {first.Score} supera la soglia {first.NextThreshold}");
|
||||
Assert.True(first.NextAlreadyMet, "il punteggio basta già");
|
||||
Assert.Equal(FinanceSystem.RatingOf(fresh, first.Score), first.ScoreRating);
|
||||
Assert.False(first.MarginReachable || first.LeverageReachable, "nessun obiettivo da raggiungere");
|
||||
Assert.Approx(0, first.MarginNeeded, 1e-12);
|
||||
Assert.Approx(0, first.LeverageMax, 1e-12);
|
||||
var message = Projection.Finance(fresh, fresh.Player.Id);
|
||||
Assert.True(message.NextAlreadyMet && message.ScoreRating == first.ScoreRating.ToString(), "nel protocollo");
|
||||
|
||||
// rating rimasto a D dopo una bancarotta risolta, con un punteggio normale: niente leva infinita
|
||||
var w = TestWorlds.NoAi(908);
|
||||
var c = w.Player;
|
||||
for (int m = 1; m <= 12; m++) c.IncomeMonths.Add(Month(1850, m, 100_000_00, 95_000_00));
|
||||
FinanceSystem.UpdateRating(w, c);
|
||||
c.Rating = CreditRating.D;
|
||||
var e = FinanceOutlook.Explain(w, c);
|
||||
Assert.True(e.NextAlreadyMet && e.Next == CreditRating.C, "il punteggio vale già più di C");
|
||||
Assert.True(double.IsFinite(e.LeverageMax) && double.IsFinite(e.MarginNeeded), "nessun infinito");
|
||||
var wire = Projection.Finance(w, c.Id);
|
||||
Assert.True(wire.LeverageMax < 1e6 && wire.MarginNeeded > -0.5 - 1e-6, $"leva {wire.LeverageMax}, margine {wire.MarginNeeded}");
|
||||
}
|
||||
|
||||
[Test(Description = "I primi incassi non fanno crollare il rating: il margine resta neutro finché la finestra non ha abbastanza mesi con ricavi")]
|
||||
public static void FirstRevenueDoesNotSinkTheRating()
|
||||
{
|
||||
var w = TestWorlds.NoAi(909);
|
||||
var c = w.Player;
|
||||
var fb = w.Data.Balance.Finance;
|
||||
Assert.True(fb.RatingMinRevenueMonths > 1 && fb.RatingMinRevenueMonths + 3 < fb.IncomeMonths, "parametri del test");
|
||||
// tre mesi d'avvio con soli costi, poi il primo incasso piccolo (margine vero −90 %)
|
||||
c.IncomeMonths.Clear();
|
||||
for (int m = 1; m <= 3; m++) c.IncomeMonths.Add(Month(1850, m, 0, 50_000_00));
|
||||
FinanceSystem.UpdateRating(w, c);
|
||||
var start = c.Rating;
|
||||
Assert.Approx(0, c.RatingMargin, 1e-12, "solo costi nell'avvio: margine neutro");
|
||||
c.IncomeMonths.Add(Month(1850, 4, 10_000_00, 50_000_00));
|
||||
FinanceSystem.UpdateRating(w, c);
|
||||
var m4 = FinanceSystem.Measures(w, c);
|
||||
Assert.True(m4.MarginNeutral && m4.RevenueMonths == 1, "un solo mese con ricavi");
|
||||
Assert.Approx(0, c.RatingMargin, 1e-12, "margine ancora neutro");
|
||||
Assert.True((int)c.Rating - (int)start <= 1, $"primo incasso: da {start} a {c.Rating}");
|
||||
Assert.True(FinanceOutlook.Explain(w, c).MarginNeutral, "la spiegazione lo dice");
|
||||
|
||||
// con abbastanza mesi di ricavi il margine conta
|
||||
for (int m = 5; c.IncomeMonths.Count(x => Company.Revenue(x.Entries) > 0) < fb.RatingMinRevenueMonths; m++)
|
||||
c.IncomeMonths.Add(Month(1850, m, 40_000_00, 50_000_00));
|
||||
FinanceSystem.UpdateRating(w, c);
|
||||
var counted = FinanceSystem.Measures(w, c);
|
||||
Assert.False(counted.MarginNeutral, "margine vero");
|
||||
Assert.Approx((double)counted.Profit / counted.Revenue, c.RatingMargin, 1e-12);
|
||||
Assert.True(c.RatingMargin < 0, "in perdita");
|
||||
|
||||
// finestra piena senza ricavi e in perdita: margine minimo, componente nulla
|
||||
c.IncomeMonths.Clear();
|
||||
for (int m = 1; m <= fb.IncomeMonths; m++) c.IncomeMonths.Add(Month(1850, m, 0, 50_000_00));
|
||||
FinanceSystem.UpdateRating(w, c);
|
||||
Assert.Approx(-1, c.RatingMargin, 1e-12, "margine minimo");
|
||||
Assert.Approx(0, FinanceSystem.MarginComponent(c.RatingMargin), 1e-12);
|
||||
}
|
||||
|
||||
[Test(Description = "Il rating si aggiorna ogni mese sulla finestra degli ultimi 12 mesi chiusi")]
|
||||
@@ -398,8 +473,10 @@ public static class FinanceTests
|
||||
Assert.True(c.Bankrupt, $"{preset.Id}: bancarotta");
|
||||
Assert.Equal(preset.BankruptcyDays, c.NegativeCashDays, $"{preset.Id}: giorni di cassa negativa");
|
||||
Assert.Equal(preset.BankruptcyDays, days, $"{preset.Id}: giorni trascorsi");
|
||||
Assert.True(warnings[0].Day == 1 && warnings[0].Event.Text.Contains($"bancarotta arriva tra {preset.BankruptcyDays - 1} giorni"), $"{preset.Id}: {warnings[0].Event.Text}");
|
||||
foreach (int left in fb.BankruptcyWarningDaysLeft.Where(l => l < preset.BankruptcyDays - 1))
|
||||
int notice = fb.NegativeCashNoticeDays;
|
||||
Assert.True(warnings[0].Day == notice && warnings[0].Event.Text.Contains($"bancarotta arriva tra {preset.BankruptcyDays - notice} giorni"),
|
||||
$"{preset.Id}: {warnings[0].Event.Text}");
|
||||
foreach (int left in fb.BankruptcyWarningDaysLeft.Where(l => l < preset.BankruptcyDays - notice))
|
||||
{
|
||||
Assert.True(warnings.Any(x => x.Day == preset.BankruptcyDays - left && x.Event.Text.Contains($"bancarotta tra {(left == 1 ? "1 giorno" : $"{left} giorni")}")),
|
||||
$"{preset.Id}: avviso a {left} giorni");
|
||||
@@ -413,12 +490,27 @@ public static class FinanceTests
|
||||
}
|
||||
}
|
||||
|
||||
[Test(Description = "Se la cassa torna positiva il conto alla rovescia si azzera con un avviso")]
|
||||
[Test(Description = "Se la cassa torna positiva il conto alla rovescia si azzera con un avviso; una cassa che oscilla intorno a zero non genera notizie")]
|
||||
public static void PositiveCashResetsTheCountdown()
|
||||
{
|
||||
var w = TestWorlds.NoAi(911);
|
||||
var c = w.Player;
|
||||
var cash = c.Cash;
|
||||
int notice = w.Data.Balance.Finance.NegativeCashNoticeDays;
|
||||
Assert.True(notice > 1 && notice < 5, "parametri del test");
|
||||
// oscillazioni più brevi del primo avviso: il contatore riparte, nessuna notizia
|
||||
w.Events.Drain();
|
||||
for (int i = 0; i < 4; i++)
|
||||
{
|
||||
SetCash(w, c, Money.FromLire(-50));
|
||||
w.RunDays(notice - 1);
|
||||
Assert.Equal(notice - 1, c.NegativeCashDays);
|
||||
SetCash(w, c, cash);
|
||||
w.RunDays(1);
|
||||
Assert.Equal(0, c.NegativeCashDays, "il conto alla rovescia si azzera");
|
||||
}
|
||||
Assert.False(w.Events.Drain().Any(e => e.Company == c.Id && e.Kind == EventKind.Finance), "nessun avviso per le oscillazioni");
|
||||
|
||||
SetCash(w, c, Money.FromLire(-1_000));
|
||||
w.RunDays(5);
|
||||
Assert.Equal(5, c.NegativeCashDays);
|
||||
@@ -543,4 +635,20 @@ public static class FinanceTests
|
||||
Assert.Equal(IncomeSection.Capital, LedgerEntries.Section(LedgerEntry.Dividends));
|
||||
Assert.Equal(0L, w.MoneyBalanceSum());
|
||||
}
|
||||
|
||||
[Test(Description = "La quota dei trasporti dei nuovi concorrenti conta solo tariffe, noli e contratti, non dividendi né commercio")]
|
||||
public static void TransportShareIgnoresDividendsAndTrading()
|
||||
{
|
||||
var e = new long[Company.EntryCount];
|
||||
e[(int)LedgerEntry.FreightRevenue] = 1_000;
|
||||
e[(int)LedgerEntry.PassengerRevenue] = 500;
|
||||
e[(int)LedgerEntry.Contracts] = 200;
|
||||
long transport = Company.TransportRevenue(e);
|
||||
Assert.Equal(1_700L, transport);
|
||||
e[(int)LedgerEntry.DividendsReceived] = 1_000_000;
|
||||
e[(int)LedgerEntry.Trading] = 50_000;
|
||||
e[(int)LedgerEntry.Subsidiaries] = 7_000;
|
||||
Assert.Equal(transport, Company.TransportRevenue(e), "dividendi, commercio e controllate fuori dalla quota");
|
||||
Assert.True(Company.Revenue(e) > transport, "restano nei ricavi del rating");
|
||||
}
|
||||
}
|
||||
@@ -200,11 +200,11 @@ public static class ProtocolTests
|
||||
new IncomeColumnInfo { Kind = IncomeColumnInfo.ClosedYear, Year = 1871, Values = [new AmountInfo { Kind = 9, Value = new Money(-66_000) }, new AmountInfo { Kind = 2, Value = new Money(-1_000) }],
|
||||
Profit = new Money(-66_000), CashFlow = new Money(-67_000) },
|
||||
],
|
||||
Rating = "BBB", RatingInitial = false, RatingMonths = 12, Margin = 0.28f, Leverage = 0.31f, LeverageUnbounded = false,
|
||||
Rating = "BBB", RatingInitial = false, RatingMonths = 12, RevenueMonths = 9, MarginNeutral = true, MinRevenueMonths = 3, Margin = 0.28f, Leverage = 0.31f, LeverageUnbounded = false,
|
||||
MarginWeight = 0.6f, LeverageWeight = 0.4f, MarginComponent = 0.78f, LeverageComponent = 0.76f, Score = 0.772f,
|
||||
Thresholds = [new RatingThresholdInfo { Rating = "AAA", MinScore = 0.85f, LoanRate = 0.055f }, new RatingThresholdInfo { Rating = "C", MinScore = 0.05f, LoanRate = 0.17f }],
|
||||
NextRating = "A", NextThreshold = 0.65f, MarginNeeded = 0.31f, MarginReachable = true, LeverageMax = 0.12f, LeverageReachable = false,
|
||||
DebtToRepay = new Money(7_000_000),
|
||||
NextRating = "A", NextThreshold = 0.65f, NextAlreadyMet = true, ScoreRating = "AA", MarginNeeded = 0.31f, MarginReachable = true, LeverageMax = 0.12f, LeverageReachable = false,
|
||||
DebtToRepay = new Money(7_000_000), RepayAffordable = true,
|
||||
LoanList = [new FinanceLoanInfo { Loan = 4, Principal = new Money(15_000_000), Remaining = new Money(12_000_000), AnnualRate = 0.075f, MonthsLeft = 97,
|
||||
Payment = new Money(171_234), NextInterest = new Money(75_000), MaturityDay = 5520 }],
|
||||
MaxLoan = new Money(60_000_000), LoanAvailable = new Money(48_000_000), NewLoanRate = 0.075f, BaseRate = 0.05f, Spread = 0.025f,
|
||||
|
||||
@@ -379,7 +379,9 @@ public static class ServerTests
|
||||
Assert.Equal(col.Profit.Cents, operating, $"le voci d'esercizio sommano all'utile ({col.Kind} {col.Month}/{col.Year})");
|
||||
}
|
||||
Assert.Equal(data.Balance.Finance.RatingByScore.Length, report.Thresholds.Count);
|
||||
Assert.True(report.RatingInitial, "prima del primo mese il rating è quello iniziale");
|
||||
// con TickMs = 1 il primo mese può già essere passato su una macchina lenta: il rating iniziale vale solo prima
|
||||
int dpm = scenario.World.Calendar.DaysPerMonth;
|
||||
if (report.Day < dpm) Assert.True(report.RatingInitial, "prima del primo mese il rating è quello iniziale");
|
||||
Assert.Equal(limit, report.BankruptcyDays);
|
||||
Assert.Equal(0, report.LoanList.Count);
|
||||
|
||||
@@ -392,7 +394,12 @@ public static class ServerTests
|
||||
Assert.Equal(1, after.LoanList.Count);
|
||||
var loan = after.LoanList[0];
|
||||
Assert.Equal(Money.FromLire(5_000), loan.Principal);
|
||||
Assert.Approx(after.NewLoanRate, loan.AnnualRate, 1e-6, "tasso fissato all'accensione");
|
||||
// il tasso del prestito è quello di un rating (base + spread all'accensione); se il quadro è dello stesso
|
||||
// mese del prestito il rating non è cambiato e coincide con il tasso di un prestito nuovo
|
||||
double baseRate = scenario.World.Difficulty.BaseInterestRate;
|
||||
var rates = data.Balance.Finance.RatingSpreads.Values.Select(s => (float)(baseRate + s)).ToList();
|
||||
Assert.True(rates.Any(r => Math.Abs(r - loan.AnnualRate) < 1e-6), $"tasso {loan.AnnualRate} = base + spread di un rating");
|
||||
if (after.Day / dpm == report.Day / dpm) Assert.Approx(after.NewLoanRate, loan.AnnualRate, 1e-6, "tasso fissato all'accensione");
|
||||
Assert.True(loan.Payment.Cents > 0 && loan.MaturityDay > after.Day, "rata e scadenza");
|
||||
Assert.Equal(Money.FromLire(5_000), after.Loans);
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user