Files
Rail_Enterprise/src/ViaFerrea.Core/Data/BalanceDefs.cs
T
Claude 7879ac502d F5: manutenzione delle industrie, livelli, borsa e scalate, agenti IA
- Sezione 11: usura e recupero degli impianti, fermi e incidenti, ricambi e macchinari come
  domanda esplicita (treno, trasporto locale, trasbordo nel bacino), revisione e ammodernamento,
  acquisto delle industrie dal livello 3, conguaglio mensile con il proprietario (ADR 0011).
- Livelli della compagnia con soglie ritarate e ritaratura economica misurata con le IA.
- Sezione 12.2–12.3: libro dei soci, prezzo con sentiment, quotazione, riacquisto, dividendi,
  controllo e fusione (comando 39), offerte pubbliche con difese, esiti per difficoltà,
  aste delle IA fallite, nuovi concorrenti, fine partita e Cronaca finale (ADR 0012).
- Sezione 12.1: agenti IA con candidati, Dijkstra sulle celle, TrackPreview e ROI, tre
  personalità, linee dei ricambi, rimedio agli stalli, borsa (ADR 0013).
- Salvataggio versione 3, protocollo (messaggi 126–128, blocchi di estensione), server,
  simulate --trace-ai; test di 14.5 su IA e borsa e accettazione F5 (120 test).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0191R7vXgtbAvSV4V8tj8uzL
2026-10-12 10:36:31 +00:00

480 lines
23 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using System.Text.Json.Serialization;
namespace ViaFerrea.Core.Data;
// Contenuto di balance.json: costanti delle formule (guida, sezioni 6–11).
// Ogni proprietà è obbligatoria: un valore mancante o un nome sbagliato blocca il caricamento.
public sealed class BalanceFile
{
[JsonPropertyName("$schema")] public string? Schema { get; init; }
public required int Version { get; init; }
public required TimeBalance Time { get; init; }
public required MapBalance Map { get; init; }
public required MarketBalance Market { get; init; }
public required LocalPriceBalance LocalPrice { get; init; }
public required IndustryBalance Industry { get; init; }
public required GrowthBalance Growth { get; init; }
public required TownBalance Town { get; init; }
public required MigrationBalance Migration { get; init; }
public required EmploymentBalance Employment { get; init; }
public required LocalTransportBalance LocalTransport { get; init; }
public required HubsBalance Hubs { get; init; }
public required TariffBalance Tariffs { get; init; }
public required FinanceBalance Finance { get; init; }
public required StockMarketBalance StockMarket { get; init; }
public required IndustryMaintenanceBalance IndustryMaintenance { get; init; }
}
public sealed class TimeBalance
{
public required int TickMs { get; init; }
public required int TicksPerDay { get; init; }
public required int DaysPerMonth { get; init; }
public required int MonthsPerYear { get; init; }
/// <summary>Secondi di orologio dei treni per secondo reale a 1×.</summary>
public required double TrainClockFactor { get; init; }
public required int[] Speeds { get; init; }
public required int DefaultStartYear { get; init; }
}
public sealed class MapBalance
{
public required double CellSizeM { get; init; }
public required int[] SizesKm { get; init; }
public required int ChunkCells { get; init; }
public required double MaxElevationM { get; init; }
public required NoiseParams Noise { get; init; }
public required ReliefParams Relief { get; init; }
public required HydrologyParams Hydrology { get; init; }
public required CoverParams Cover { get; init; }
public required DepositGenParams Deposits { get; init; }
public required TownGenParams Towns { get; init; }
public required IndustryGenParams Industries { get; init; }
public required HubGenParams Hubs { get; init; }
}
public sealed class NoiseParams
{
public required int Octaves { get; init; }
public required double BaseWavelengthKm { get; init; }
public required double Persistence { get; init; }
public required double Lacunarity { get; init; }
public required double WarpStrengthKm { get; init; }
public required double WarpWavelengthKm { get; init; }
public required int WarpOctaves { get; init; }
public required int RidgeOctaves { get; init; }
public required double RidgeWavelengthKm { get; init; }
}
public sealed class ReliefParams
{
/// <summary>Ampiezza del rumore di base nell'entroterra.</summary>
public required double NoiseAmplitudeM { get; init; }
/// <summary>Frazione dell'ampiezza del rumore sulla costa (cresce linearmente verso l'interno).</summary>
public required double NoiseCoastFactor { get; init; }
public required double InlandGradientM { get; init; }
/// <summary>Esponente del profilo costa-entroterra (2 = pianura costiera ampia, salita interna).</summary>
public required double InlandExponent { get; init; }
public required double SeaOffsetM { get; init; }
public required double MountainAmplitudeM { get; init; }
public required double MountainStart { get; init; }
public required double SeaBandFraction { get; init; }
public required double CoastNoiseM { get; init; }
/// <summary>Microrilievo che fa serpeggiare i fiumi nelle pianure.</summary>
public required double MicroReliefM { get; init; }
public required double MicroWavelengthKm { get; init; }
}
public sealed class HydrologyParams
{
public required double RiverThresholdKm2 { get; init; }
public required int[] RiverWidthSteps { get; init; }
public required double CarveDepthM { get; init; }
public required int ValleyRadiusCells { get; init; }
public required double ValleyDepthM { get; init; }
public required double LakeMinDepthM { get; init; }
public required int LakeMinCells { get; init; }
/// <summary>Le conche sopra questo percentile di quota si colmano invece di diventare laghi.</summary>
public required double LakeMaxPercentile { get; init; }
public required double MinSourcePercentile { get; init; }
}
public sealed class CoverParams
{
public required double RockPercentile { get; init; }
public required double RockMinSlope { get; init; }
public required double MountainPercentile { get; init; }
public required double HillMinSlope { get; init; }
public required double HillPercentile { get; init; }
public required double ForestMinSlope { get; init; }
public required double ForestMaxSlope { get; init; }
public required double ForestNoiseThreshold { get; init; }
public required double ForestWavelengthKm { get; init; }
public required double MarshMaxPercentile { get; init; }
public required int MarshRiverDistanceCells { get; init; }
public required double MarshMaxSlope { get; init; }
public required double MarshNoiseThreshold { get; init; }
public required int FieldRadiusCells { get; init; }
public required double FieldShare { get; init; }
}
public sealed class DepositGenParams
{
public required Dictionary<string, double> PerThousandKm2 { get; init; }
public required int[] RadiusCells { get; init; }
public required Dictionary<string, long[]> ReserveTonnes { get; init; }
public required double MinSpacingKm { get; init; }
public required Dictionary<string, double> PreferredMinPercentile { get; init; }
public required Dictionary<string, double> PreferredMaxPercentile { get; init; }
}
public sealed class TownGenParams
{
public required Dictionary<string, int> CountBySize { get; init; }
public required double MinDistanceKm { get; init; }
public required double MaxWaterDistanceKm { get; init; }
public required double MaxSlope { get; init; }
public required double MaxHeightPercentile { get; init; }
public required int[] LargestPopulation { get; init; }
public required double ZipfExponent { get; init; }
public required int MinPopulation { get; init; }
public required double RadiusBaseCells { get; init; }
public required double RadiusPerSqrtPop { get; init; }
/// <summary>Crescita minima del raggio (celle) prima di allargare l'abitato.</summary>
public required double RadiusHysteresisCells { get; init; }
}
public sealed class IndustryGenParams
{
public required Dictionary<string, int> CountBySize { get; init; }
public required int[] InitialLevels { get; init; }
/// <summary>Ripartizione delle industrie non legate a giacimenti: farm, logging, processing, manufacturing.</summary>
public required Dictionary<string, double> Shares { get; init; }
public required int PlacementAttempts { get; init; }
public required double MaxSlope { get; init; }
public required int SpacingCells { get; init; }
}
public sealed class HubGenParams
{
public required int Ports { get; init; }
public required int Borders { get; init; }
public required double PortMinPopulationNearbyKm { get; init; }
}
public sealed class MarketBalance
{
public required double K { get; init; }
public required double Alpha { get; init; }
public required int WindowDays { get; init; }
public required double MinPriceFactor { get; init; }
public required double MaxPriceFactor { get; init; }
public required double RatioMin { get; init; }
public required double RatioMax { get; init; }
public required WorldMarketParams World { get; init; }
public required int HistoryDays { get; init; }
}
public sealed class WorldMarketParams
{
public required double Amplitude { get; init; }
public required double PeriodYears { get; init; }
public required double VolumeShare { get; init; }
public required double BaselinePerDay { get; init; }
public required double Elasticity { get; init; }
public required double ShockChancePerYear { get; init; }
public required double ShockMin { get; init; }
public required double ShockMax { get; init; }
public required double ShockDecayDays { get; init; }
/// <summary>Minimo della componente mondiale del prezzo, come frazione del prezzo base.</summary>
public required double PriceFloor { get; init; }
}
public sealed class LocalPriceBalance
{
public required double Lambda { get; init; }
public required double MaxDeviation { get; init; }
public required double Epsilon { get; init; }
}
public sealed class IndustryBalance
{
public required int CoverageWindowDays { get; init; }
public required double ProfitFactorSlope { get; init; }
public required double ProfitFactorMin { get; init; }
public required double ProfitFactorMax { get; init; }
public required int MarginWindowDays { get; init; }
public required long WagePerWorkerPerMonth { get; init; }
public required long WagePerStaffPerMonth { get; init; }
public required double OnSiteWorkerShare { get; init; }
public required double OnSiteStaffShare { get; init; }
public required int InitialStockDays { get; init; }
public required Dictionary<string, int> FootprintCells { get; init; }
public required double DepletionStartFraction { get; init; }
public required long StartingCash { get; init; }
}
public sealed class GrowthBalance
{
public required int QuarterDays { get; init; }
public required double WeightShipped { get; init; }
public required double WeightCoverage { get; init; }
public required double WeightProfit { get; init; }
public required double UpgradeThreshold { get; init; }
public required int UpgradeQuarters { get; init; }
public required double DowngradeThreshold { get; init; }
public required int CloseQuartersAtZero { get; init; }
public required int MaxLevel { get; init; }
public required int SpawnUnmetDays { get; init; }
public required double SpawnUnmetRatio { get; init; }
public required int SpawnMaxPerYear { get; init; }
}
public sealed class TownBalance
{
/// <summary>Giorni in cui l'insoddisfazione «lavoro» si riduce di un fattore e.</summary>
public required int WorkDissatisfactionDecayDays { get; init; }
public required double DemandPriceFactorMin { get; init; }
public required double DemandPriceFactorMax { get; init; }
/// <summary>Soglia di popolazione annunciata nella cronaca.</summary>
public required int PopulationMilestone { get; init; }
public required double BaseGrowth { get; init; }
public required double SatisfactionWeight { get; init; }
public required double EmploymentWeight { get; init; }
public required double EmploymentPivot { get; init; }
public required double MaxMonthlyGrowth { get; init; }
public required double SatisfactionPivot { get; init; }
public required double WorkforceShare { get; init; }
public required double StaffShare { get; init; }
public required int StaffMinPopulation { get; init; }
public required int StaffMinServices { get; init; }
public required double ServicesSatisfactionThreshold { get; init; }
/// <summary>Servizi di base (scuole, ospedali…) ogni tanti abitanti, oltre alle categorie soddisfatte.</summary>
public required int BaseServicesPerPopulation { get; init; }
public required double ServiceJobsShare { get; init; }
public required int SatisfactionEmaDays { get; init; }
public required double InitialSatisfaction { get; init; }
public required int StockDays { get; init; }
public required double WorkSatisfactionPenalty { get; init; }
public required int MaxPopulation { get; init; }
}
public sealed class MigrationBalance
{
public required double Share { get; init; }
public required double SatisfactionThreshold { get; init; }
public required double MaxDistanceKm { get; init; }
public required double EmigrationShareWhenNoTarget { get; init; }
}
public sealed class EmploymentBalance
{
public required double WalkRadiusKm { get; init; }
public required double WorkerMaxMinutes { get; init; }
public required double StaffMaxMinutes { get; init; }
public required int CoverageEmaDays { get; init; }
public required double DissolveCoverage { get; init; }
public required int DissolveDays { get; init; }
public required double WalkSpeedKmh { get; init; }
/// <summary>Giorni entro cui un pendolare deve salire sul treno, all'andata e al ritorno.</summary>
public required int BoardDays { get; init; }
public required int ReturnBoardDays { get; init; }
/// <summary>Copertura iniziale di un contratto su rotaia appena creato.</summary>
public required double RailStartCoverage { get; init; }
/// <summary>Quota della capacità stimata delle linee assegnabile ai contratti (margine per ritardi e soste).</summary>
public required double LineCapacityUtilization { get; init; }
/// <summary>Convenzioni di pendolarismo proposte dalle industrie ai vettori (sezione 9).</summary>
public required AgreementBalance Agreements { get; init; }
}
public sealed class AgreementBalance
{
/// <summary>Pendolari su rotaia con lo stesso vettore oltre i quali un'industria propone una convenzione.</summary>
public required int MinSeats { get; init; }
/// <summary>Probabilità mensile che un'industria idonea proponga una convenzione.</summary>
public required double ProposalChance { get; init; }
/// <summary>Canone mensile per posto garantito (centesimi).</summary>
public required long FeePerSeatPerMonth { get; init; }
/// <summary>Giorni per accettare una proposta prima che decada.</summary>
public required int ProposalDays { get; init; }
public required int DurationMonths { get; init; }
/// <summary>Mesi senza nuove proposte dopo un rifiuto o una rottura.</summary>
public required int CooldownMonths { get; init; }
/// <summary>Copertura media (arrivati/posti) sotto la quale la capacità manca.</summary>
public required double MinCoverage { get; init; }
/// <summary>Giorni consecutivi di capacità mancante dopo cui la convenzione salta.</summary>
public required int BreakDays { get; init; }
/// <summary>Penale alla rottura, in mensilità del canone.</summary>
public required double PenaltyMonths { get; init; }
}
public sealed class LocalTransportBalance
{
public required bool Enabled { get; init; }
public required double RadiusKm { get; init; }
public required double DailyShare { get; init; }
public required int MaxUnitsPerDay { get; init; }
}
public sealed class HubsBalance
{
public required HubParams Port { get; init; }
public required HubParams Border { get; init; }
public HubParams For(HubKind kind) => kind == HubKind.Port ? Port : Border;
}
public sealed class HubParams
{
[JsonPropertyName("name_it")] public required string NameIt { get; init; }
public required int MonthlyCapacity { get; init; }
public required double Duty { get; init; }
public required Footprint Footprint { get; init; }
}
public sealed class TariffBalance
{
public required double FreightBaseRate { get; init; }
public required double FreightFixedWeight { get; init; }
public required double FreightPriceWeight { get; init; }
public required double FreightKmExponent { get; init; }
public required double PaxBaseFare { get; init; }
public required double PaxKmExponent { get; init; }
public required Dictionary<string, double> ClassMultipliers { get; init; }
public required double LateThreshold { get; init; }
public required double LateFactorMin { get; init; }
public required double LateFactorSpan { get; init; }
}
public sealed class FinanceBalance
{
public required Dictionary<string, double> RatingSpreads { get; init; }
/// <summary>Soglie del punteggio (0–1) da AAA a C; sotto l'ultima soglia il rating è D.</summary>
public required double[] RatingByScore { get; init; }
public required double ProfitMarginWeight { get; init; }
public required double LeverageWeight { get; init; }
public required int LoanTermMonths { get; init; }
public required long LoanStep { get; init; }
public required CreditRating StartingRating { get; init; }
public required int DepreciationYearsTrack { get; init; }
public required double BookValueFloor { get; init; }
}
public sealed class StockMarketBalance
{
public required int Shares { get; init; }
public required double EarningsMultiple { get; init; }
public required double SentimentMin { get; init; }
public required double SentimentMax { get; init; }
public required double Spread { get; init; }
public required double IpoMaxShare { get; init; }
public required double ControlShare { get; init; }
public required int MergeAfterDays { get; init; }
public required double BidPremiumMin { get; init; }
public required double BidPremiumMax { get; init; }
public required int BidDurationDays { get; init; }
public required double RansomShare { get; init; }
public required double ReceivershipDividend { get; init; }
/// <summary>Peso della crescita degli utili sul sentiment (crescita relativa, limitata a ±1).</summary>
public required double SentimentEarningsWeight { get; init; }
/// <summary>Peso del ciclo di mercato mondiale (A·sin(2πt/T)) sul sentiment.</summary>
public required double SentimentCycleWeight { get; init; }
/// <summary>Peso del rendimento dei dividendi degli ultimi 12 mesi sul sentiment.</summary>
public required double SentimentDividendWeight { get; init; }
public required int SentimentSmoothingDays { get; init; }
/// <summary>Spinta temporanea del dividendo straordinario (difesa), che decade linearmente.</summary>
public required double ExtraDividendSentimentBoost { get; init; }
public required int ExtraDividendDecayDays { get; init; }
/// <summary>Flottante delle compagnie IA all'inizio (quotate dall'inizio).</summary>
public required double AiFloatAtStart { get; init; }
/// <summary>Quota del flottante residuo che aderisce ogni giorno a un'offerta con il premio minimo.</summary>
public required double TenderDailyShare { get; init; }
/// <summary>Quota della cassa pagata come dividendo straordinario nella difesa.</summary>
public required double ExtraDividendCashShare { get; init; }
/// <summary>Premio del cavaliere bianco sul prezzo dell'offerta ostile.</summary>
public required double WhiteKnightPremium { get; init; }
/// <summary>Premio sul prezzo di mercato per riscattare azioni dal controllante in amministrazione controllata.</summary>
public required double RansomPremium { get; init; }
/// <summary>Massimo di azioni scambiabili al giorno da una compagnia, in quota del capitale.</summary>
public required double MaxDailyTradeShare { get; init; }
/// <summary>Flottante massimo raggiungibile con gli aumenti di capitale di chi è già quotato.</summary>
public required double SecondaryMaxFloat { get; init; }
public required int PriceHistoryMonths { get; init; }
/// <summary>Durata dell'asta degli attivi di una compagnia fallita.</summary>
public required int AuctionDays { get; init; }
/// <summary>Prezzo minimo dell'asta in quota del valore di libro degli attivi.</summary>
public required double AuctionMinBookShare { get; init; }
/// <summary>Quota di mercato oltre la quale entra un nuovo concorrente (12.1).</summary>
public required double ConcentrationThreshold { get; init; }
public required int NewCompetitorCooldownYears { get; init; }
public required int MaxCompanies { get; init; }
/// <summary>Anni di storico per compagnia conservati (Cronaca finale).</summary>
public required int HistoryYears { get; init; }
}
public sealed class IndustryMaintenanceBalance
{
public required double WearPerDay { get; init; }
public required double EfficiencyFullAbove { get; init; }
public required double EfficiencyAt20 { get; init; }
public required double EfficiencyBelow20 { get; init; }
public required double BreakdownBase { get; init; }
public required double BreakdownPivot { get; init; }
public required double BreakdownScale { get; init; }
public required int[] BreakdownDays { get; init; }
public required double BreakdownTownSatisfaction { get; init; }
public required double AccidentBelow { get; init; }
public required int AccidentDays { get; init; }
public required double AccidentPopulationLoss { get; init; }
public required Dictionary<string, IndustryBudgetParams> Budgets { get; init; }
public required double NoPartsRecoveryFactor { get; init; }
public required int OverhaulDays { get; init; }
public required int OverhaulMachineryPerLevel { get; init; }
public required double OverhaulMinStaffCoverage { get; init; }
public required int UpgradeMachineryPerLevel { get; init; }
public required int UpgradeDays { get; init; }
public required double NpcUpgradeMargin { get; init; }
public required int NpcUpgradeYears { get; init; }
public required double NpcHighMargin { get; init; }
public required double NpcOverhaulBelow { get; init; }
/// <summary>Scorta di ricambi desiderata in mesi di consumo della politica.</summary>
public required double PartsTargetMonths { get; init; }
/// <summary>Scorta iniziale di ricambi in mesi di consumo (politica Base).</summary>
public required double InitialPartsMonths { get; init; }
/// <summary>Massimo di ricambi ordinabili oltre la scorta desiderata («Ordina ricambi»).</summary>
public required int MaxOrderedParts { get; init; }
/// <summary>Raggio entro cui un fermo o un incidente colpisce la città più vicina.</summary>
public required double TownEffectRadiusKm { get; init; }
public required int StopHistoryLength { get; init; }
/// <summary>Cassa che un'industria di una compagnia trattiene; ogni mese il resto va al proprietario (o lo chiede).</summary>
public required long OwnerCashReserve { get; init; }
public required IndustryPurchaseParams Purchase { get; init; }
public IndustryBudgetParams For(Economy.IndustryBudget budget) => Budgets[budget switch
{
Economy.IndustryBudget.None => "none",
Economy.IndustryBudget.High => "high",
_ => "base",
}];
}
/// <summary>Valutazione di un'industria in vendita (BuyIndustry).</summary>
public sealed class IndustryPurchaseParams
{
/// <summary>Quota del costo di ammodernamento cumulato riconosciuta come valore degli impianti.</summary>
public required double AssetShare { get; init; }
/// <summary>Multiplo dell'utile annuo stimato.</summary>
public required double EarningsMultiple { get; init; }
/// <summary>Peso della condizione sul valore degli impianti: valore × (1 − peso + peso·c/100).</summary>
public required double ConditionWeight { get; init; }
}
public sealed class IndustryBudgetParams
{
public required double RecoveryPerDay { get; init; }
public required double CostShareOfRevenue { get; init; }
public required int SparePartsPerLevelPerMonth { get; init; }
}