Via Ferrea: fondamenta, economia, rete ferroviaria, server e client, manutenzione e pendolarismo (F0–F4) #1

Merged
Alby96 merged 11 commits from claude/funny-pasteur-jvtug9 into main 2026-10-02 09:29:19 +02:00
Alby96 commented 2026-10-01 23:50:53 +02:00 (Migrated from github.com)

Implementazione di «Via Ferrea» seguendo docs/GUIDA.md (v2), una fase alla volta con un commit F<n> per fase.

Fasi in questa PR

  • F0 Fondamenta: soluzione ViaFerrea.sln (Core e Protocol net10.0 + net8.0, Server, Tools, Tests), Directory.Build.props, script, documenti, harness di test interno.
  • F1 Economia headless: dati validati (12 file + schemi), generatore di mappa, città, industrie, hub, mercato con componente mondiale, registro a partita doppia, prestiti, salvataggi Brotli e hash di stato, simulate (ADR 0002–0006).
  • F2 Rete ferroviaria headless: pianificatore del tracciato con profilo, opere e costi; rete con agganci, stazioni, depositi, segnali e cantieri; treni con fisica, blocchi e incroci senza stallo; pacchetti, LineGraph con carichi per linea, tariffe; pendolarismo su rotaia; scenario Valdoria; bench (ADR 0007–0008).
  • F3 Server e client minimo: protocollo binario completo con round-trip; server con ciclo di gioco, sessioni WebSocket, delta, moto dei treni, /health, /metrics, /api/saves, autosave; Docker, compose e modello Unraid; client Godot 4.7 .NET con mappa, opere, treni, strumenti, pannelli e HUD; registro dei comandi e replay (ADR 0009).
  • F4 Pendolarismo e manutenzione dei treni (ADR 0010):
    • manutenzione per componente in km di servizio, rischio e guasti (lieve, grave con soccorso, deragliamento), interventi con costi e ricambi, officine con stalli e personale, politiche per flotta, linea e treno, pianificatore predittivo, treni di riserva, avvisi;
    • ricambi consegnati in treno alle officine (da fabbriche di macchinari o importati dagli hub), scorta desiderata;
    • depositi come posti di lavoro, motivi dei posti scoperti, convenzioni di pendolarismo con accettazione, canone e penale;
    • circolazione: inversione di marcia in un nodo intermedio come sosta tecnica e transito in stazione che libera l'arco d'arrivo (due stalli trovati con i viaggi verso le officine);
    • salvataggio versione 2 con migrazione; protocollo con riepilogo nei record e dettagli su richiesta (RequestDetail, MaintenanceCard, WorkshopRegister);
    • client: pannelli «Officine» (cartella di manutenzione, Registro officina, mappa di calore) e «Impieghi» (Registro degli impieghi e convenzioni).

Accettazione

  • F2: tracciato diretto rifiutato per gMax; valico con trincea e ponte accettato a circa 2,5 volte il costo in piano; con tre linee l'acciaieria passa dal 20 % a oltre l'80 %; bench --trains 2000 con tick medio sotto 1 ms.
  • F3: linea con ponte via WebSocket con anteprima identica al server e scarto del treno sotto 1 cm; smoke contro il container Docker; pilota automatico del client con schermate.
  • F4: test di 14.5 su manutenzione (rischio monotono, usura, tagliando e revisione, pianificatore sopra 30 con politica Standard e ricambi) e pendolarismo; nello scenario Valdoria con due treni per linea, senza linea dei ricambi la flotta scende sotto 40 al giorno 697 con 12 guasti (19,5 per milione di km), con la linea dal Porto di Levante resta sopra 73 con 3 guasti (3,2 per milione di km).

Officine nel client

Verifica

  • scripts/build.sh e scripts/test.sh verdi: 102 test superati.
  • scripts/check-nuget.sh: nessun PackageReference (l'unico SDK esterno è Godot.NET.Sdk nel client).
  • bench --trains 2000: tick medio ~1 ms, cambio di giorno ~19 ms.
  • Pilota automatico del client Godot (Xvfb + Mesa) con i pannelli F4: schermate in docs/screenshots/.

Note

  • Scala dei km di servizio (30 km per km simulato) e altre interpretazioni della guida in docs/adr/0010-manutenzione-flotta-e-pendolarismo.md.
  • Godot 4.7.2 .NET scaricato dal mirror SourceForge; il client non è stato provato su Windows né esportato.
  • Le immagini di riferimento 06–09 non sono state fornite.
  • Il bilanciamento economico è provvisorio (F6); limiti noti in docs/STATE.md.

🤖 Generated with Claude Code

https://claude.ai/code/session_0191R7vXgtbAvSV4V8tj8uzL

Implementazione di «Via Ferrea» seguendo `docs/GUIDA.md` (v2), una fase alla volta con un commit `F<n>` per fase. ## Fasi in questa PR - [x] **F0 Fondamenta**: soluzione `ViaFerrea.sln` (Core e Protocol net10.0 + net8.0, Server, Tools, Tests), `Directory.Build.props`, script, documenti, harness di test interno. - [x] **F1 Economia headless**: dati validati (12 file + schemi), generatore di mappa, città, industrie, hub, mercato con componente mondiale, registro a partita doppia, prestiti, salvataggi Brotli e hash di stato, `simulate` (ADR 0002–0006). - [x] **F2 Rete ferroviaria headless**: pianificatore del tracciato con profilo, opere e costi; rete con agganci, stazioni, depositi, segnali e cantieri; treni con fisica, blocchi e incroci senza stallo; pacchetti, `LineGraph` con carichi per linea, tariffe; pendolarismo su rotaia; scenario Valdoria; `bench` (ADR 0007–0008). - [x] **F3 Server e client minimo**: protocollo binario completo con round-trip; server con ciclo di gioco, sessioni WebSocket, delta, moto dei treni, `/health`, `/metrics`, `/api/saves`, autosave; Docker, compose e modello Unraid; client Godot 4.7 .NET con mappa, opere, treni, strumenti, pannelli e HUD; registro dei comandi e `replay` (ADR 0009). - [x] **F4 Pendolarismo e manutenzione dei treni** (ADR 0010): - manutenzione per componente in km di servizio, rischio e guasti (lieve, grave con soccorso, deragliamento), interventi con costi e ricambi, officine con stalli e personale, politiche per flotta, linea e treno, pianificatore predittivo, treni di riserva, avvisi; - ricambi consegnati in treno alle officine (da fabbriche di macchinari o importati dagli hub), scorta desiderata; - depositi come posti di lavoro, motivi dei posti scoperti, convenzioni di pendolarismo con accettazione, canone e penale; - circolazione: inversione di marcia in un nodo intermedio come sosta tecnica e transito in stazione che libera l'arco d'arrivo (due stalli trovati con i viaggi verso le officine); - salvataggio versione 2 con migrazione; protocollo con riepilogo nei record e dettagli su richiesta (`RequestDetail`, `MaintenanceCard`, `WorkshopRegister`); - client: pannelli «Officine» (cartella di manutenzione, Registro officina, mappa di calore) e «Impieghi» (Registro degli impieghi e convenzioni). ## Accettazione - **F2**: tracciato diretto rifiutato per `gMax`; valico con trincea e ponte accettato a circa 2,5 volte il costo in piano; con tre linee l'acciaieria passa dal 20 % a oltre l'80 %; `bench --trains 2000` con tick medio sotto 1 ms. - **F3**: linea con ponte via WebSocket con anteprima identica al server e scarto del treno sotto 1 cm; `smoke` contro il container Docker; pilota automatico del client con schermate. - **F4**: test di 14.5 su manutenzione (rischio monotono, usura, tagliando e revisione, pianificatore sopra 30 con politica Standard e ricambi) e pendolarismo; nello scenario Valdoria con due treni per linea, senza linea dei ricambi la flotta scende sotto 40 al giorno 697 con 12 guasti (19,5 per milione di km), con la linea dal Porto di Levante resta sopra 73 con 3 guasti (3,2 per milione di km). ![Officine nel client](https://github.com/Alby96/TrainGame/blob/claude/funny-pasteur-jvtug9/docs/screenshots/f4-registro-officina.jpg?raw=true) ## Verifica - `scripts/build.sh` e `scripts/test.sh` verdi: 102 test superati. - `scripts/check-nuget.sh`: nessun `PackageReference` (l'unico SDK esterno è `Godot.NET.Sdk` nel client). - `bench --trains 2000`: tick medio ~1 ms, cambio di giorno ~19 ms. - Pilota automatico del client Godot (Xvfb + Mesa) con i pannelli F4: schermate in `docs/screenshots/`. ## Note - Scala dei km di servizio (30 km per km simulato) e altre interpretazioni della guida in `docs/adr/0010-manutenzione-flotta-e-pendolarismo.md`. - Godot 4.7.2 .NET scaricato dal mirror SourceForge; il client non è stato provato su Windows né esportato. - Le immagini di riferimento 06–09 non sono state fornite. - Il bilanciamento economico è provvisorio (F6); limiti noti in `docs/STATE.md`. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_0191R7vXgtbAvSV4V8tj8uzL
Sign in to join this conversation.