Files
Rail_Enterprise/docs/STATE.md
T
Claude 7cb98fa206 F1: economia headless, dati validati, generatore di mappa e salvataggi
- Base deterministica: Money, id tipizzati, DMath, XxHash64, calendario
- 12 file dati con schemi, validatore di schema interno, validazione semantica
  e hash dei dati; viaferrea-tools validate-data
- Generatore di mappa (rilievo, mare, priority-flood, fiumi, laghi, copertura,
  giacimenti, città, hub, industrie) e viaferrea-tools genmap
- Economia: città, industrie, hub, mercato con componente mondiale, prezzi
  locali, tariffe, lavoro in sede e a piedi, trasporto locale, registro a
  partita doppia, prestiti, rating, difficoltà
- Salvataggi Brotli con rimappatura per id e hash di stato giornaliero
- viaferrea-tools simulate con KPI CSV; 45 test verdi; ADR 0002-0006

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0191R7vXgtbAvSV4V8tj8uzL
2026-10-01 22:38:17 +00:00

4.3 KiB
Raw Blame History

Via Ferrea — Stato dei lavori

Aggiornato alla fine di ogni fase (guida, sezione 18).

Versioni degli strumenti

Strumento Versione Note
.NET SDK 10.0.112 da apt (Ubuntu 24.04, dotnet-sdk-10.0)
Runtime .NET / ASP.NET Core 10.0.12
Targeting pack net8.0 8.0.31 dotnet-targeting-pack-8.0, per Core e Protocol
Godot .NET non installato github.com non raggiungibile dall'ambiente cloud; Godot.NET.Sdk 4.7.2 è su NuGet
Docker CLI 29.6.2 demone non attivo nell'ambiente cloud
Sistema Ubuntu 24.04.4 LTS x86_64, 4 core, 15 GB

Fatto

F0 — Fondamenta

  • Soluzione ViaFerrea.sln con Core, Protocol (net10.0 + net8.0), Server (Web SDK), Tools (viaferrea-tools), Tests.
  • Directory.Build.props con Nullable, ImplicitUsings, LangVersion latest, warning come errori, globalizzazione invariante, build deterministica, versione unica (0.1.0).
  • Script: build.sh, build.ps1, test.sh, check-nuget.sh, publish-image.sh.
  • Documenti: GUIDA, GDD, ARCHITECTURE, PROTOCOL (bozza), STATE, ADR 0001.
  • Harness di test interno ([Test], Assert, esecuzione parallela, filtri, --skip-slow).

F1 — Economia headless

  • Base: Rng (xoshiro256** con Fork), Money (centesimi, formati italiani), 20 identità tipizzate, DMath deterministica (ADR 0003), XxHash64, Vec2, Calendar/GameClock/GameDate.
  • Dati: 12 file data/*.json (16 beni con ricambi e macchinari, 14 industrie, 13 veicoli, 4 ere, 5 livelli, 4 difficoltà; costruzione, manutenzione, IA, contratti, regioni) con 12 schemi in data/schema/; caricamento con source generator, validatore di schema interno, deserializzazione rigorosa, validazione semantica, hash dei dati (ADR 0002). viaferrea-tools validate-data.
  • Mappa: generatore deterministico (rilievo con domain warping, mare, priority-flood, fiumi larghi 1–4 celle, laghi, copertura, giacimenti con riserva, città, porto e valico, 14 tipi di industria) e viaferrea-tools genmap con BMP di controllo (ADR 0005).
  • Economia: città (domanda con elasticità, soddisfazione per categoria, servizi, crescita, migrazione, espansione), industrie (efficienza dalle coperture, fattore di profitto, condizione, esaurimento giacimenti, salari, crescita trimestrale delle industrie servite, chiusure, nascita per capacità mancante), hub, mercato con componente mondiale e shock, prezzi locali, tariffe, lavoratori in sede e a piedi, trasporto locale su strada, registro a partita doppia, prestiti e rating, difficoltà applicata (ADR 0004).
  • Comandi: TakeLoan, RepayLoan, SetIndustryPolicy; gli altri tipi esistono e rispondono NotImplemented.
  • Persistenza: SaveFile (intestazione + Brotli), WorldSerializer con rimappatura per id, StateHasher giornaliero (ADR 0006).
  • viaferrea-tools simulate con KPI annuali in CSV (separatore ;).
  • 45 test: dati, determinismo, round-trip dei salvataggi, invarianti di merci e denaro, limiti dei prezzi, crescita e chiusura delle industrie, città, prestiti, collocazione e distanze della mappa, tempi di generazione.

In corso

  • F2 — Rete ferroviaria realistica headless.

Prossimo passo

  • F2.5: TrackPlanner (profilo a 25 m, due passate di pendenza, smussatura, classificazione delle opere, costi e tempi, vincoli per era), cantieri con squadre, classi di binario, usura del binario, ponti e gallerie con condizione; viaferrea-tools profile.

Limiti noti

  • Le immagini di riferimento 06–09 (pannelli a tutto schermo e schermata di connessione) non sono state fornite: i pannelli seguiranno palette e componenti dell'immagine 05 finché non arrivano.
  • Godot non è eseguibile nell'ambiente cloud: il client potrà essere compilato con Godot.NET.Sdk ma non avviato né esportato qui.
  • Senza vettori (F2) il mondo è in lento declino: le città perdono circa l'1 % di abitanti l'anno e le industrie lavorano a circa il 15–30 % (voluto, ADR 0004).
  • La manutenzione degli impianti (sezione 11) arriva in F5: fino ad allora la condizione delle industrie resta 100.

Misure di prestazione

Misura Valore Fase
Build Release da pulito ~15 s F0
Generazione mappa 64 / 128 / 256 km 0,8 / 1,4 / 5,6 s F1
simulate --years 20 su 128 km (110 industrie, 26 città) 1,7 s (+1,4 s di creazione) F1
Suite di test (45, parallela su 4 core) ~10 s F1