F6: tutorial guidato della prima partita #51

Merged
Alby96 merged 2 commits from claude/f6-tutorial into main 2026-11-08 14:57:43 +01:00
Owner

Cosa cambia e perché

Tutorial guidato e facoltativo della prima partita (ADR 0023). Riguarda solo il client: Core, protocollo, server e formato dei salvataggi non cambiano.

I passi

  • 19 passi in assets/tutorial/tutorial.json: mappa e zoom, velocità, due stazioni, deposito, binario con profilo e opere, costruzione, locomotiva e carri, treno, linea e assegnazione, Mercato globale, Finanze, La tua scalata, consigli finali.
  • I passi avanzano su ciò che il client riceve: esiti dei comandi della propria compagnia, entità nella copia locale e pannelli aperti.

Interfaccia

  • Riquadro in basso a sinistra, che si può comprimere, con Avanti, Salta passo e Chiudi; F1 lo nasconde o lo riapre.
  • Il contorno animato segue gli scorrimenti dei pannelli.
  • Nella schermata di connessione ci sono la casella «Mostra il tutorial» e il pulsante «Tutorial», che apre una partita di prova nuova senza toccare quella del giocatore.

Avanzamento: si salva per partita in user://settings.cfg (origine, seme, mappa, anno, regione, compagnia) e riprende dopo un caricamento.

Logica e test: la logica pura (copione, condizioni, macchina a stati) non dipende da Godot e ha 10 test nel harness, compresa una prima partita simulata che percorre il copione vero.

Pilota automatico: non crea il tutorial, quindi le schermate di gioco non cambiano.

Due revisori hanno trovato 12 rilievi, tutti corretti; il ramo è già allineato con main.

Closes #45

Fase

F6

Verifica

  • scripts/build.sh verde
  • scripts/test.sh --skip-slow verde: 208 su 208
  • Client: 0 avvisi, 0 errori
  • strings.csv: solo righe aggiunte (51)
  • docs/STATE.md, ARCHITECTURE.md aggiornati, ADR 0023
  • Prova in Godot: non possibile qui

🤖 Generated with Claude Code

## Cosa cambia e perché Tutorial guidato e facoltativo della prima partita (ADR 0023). Riguarda solo il client: Core, protocollo, server e formato dei salvataggi non cambiano. **I passi** - 19 passi in `assets/tutorial/tutorial.json`: mappa e zoom, velocità, due stazioni, deposito, binario con profilo e opere, costruzione, locomotiva e carri, treno, linea e assegnazione, Mercato globale, Finanze, La tua scalata, consigli finali. - I passi avanzano su ciò che il client riceve: esiti dei comandi della propria compagnia, entità nella copia locale e pannelli aperti. **Interfaccia** - Riquadro in basso a sinistra, che si può comprimere, con Avanti, Salta passo e Chiudi; F1 lo nasconde o lo riapre. - Il contorno animato segue gli scorrimenti dei pannelli. - Nella schermata di connessione ci sono la casella «Mostra il tutorial» e il pulsante «Tutorial», che apre una partita di prova nuova senza toccare quella del giocatore. **Avanzamento:** si salva per partita in `user://settings.cfg` (origine, seme, mappa, anno, regione, compagnia) e riprende dopo un caricamento. **Logica e test:** la logica pura (copione, condizioni, macchina a stati) non dipende da Godot e ha 10 test nel harness, compresa una prima partita simulata che percorre il copione vero. **Pilota automatico:** non crea il tutorial, quindi le schermate di gioco non cambiano. Due revisori hanno trovato 12 rilievi, tutti corretti; il ramo è già allineato con main. Closes #45 ## Fase F6 ## Verifica - [x] `scripts/build.sh` verde - [x] `scripts/test.sh --skip-slow` verde: 208 su 208 - [x] Client: 0 avvisi, 0 errori - [x] `strings.csv`: solo righe aggiunte (51) - [x] `docs/STATE.md`, `ARCHITECTURE.md` aggiornati, ADR 0023 - [ ] Prova in Godot: non possibile qui 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Alby96 added 2 commits 2026-11-08 14:52:32 +01:00
Tutorial facoltativo che accompagna il giocatore dalla mappa alla prima
linea in servizio e poi a Mercato globale, Finanze e La tua scalata. È
un'esperienza del solo client: osserva ciò che il client già riceve
(entità della compagnia in ClientWorld, esiti riusciti dei comandi,
pannello aperto, camera, velocità, anteprime del tracciato), non invia
comandi e non decide regole; Core, Protocol, Server e salvataggi non
cambiano (ADR 0023).

- Copione in assets/tutorial/tutorial.json (19 passi, chiavi di testo
  per T(), elemento da evidenziare con ripiego, condizione osservabile),
  esportato con il gioco; testi italiani e inglesi in strings.csv.
- Logica pura senza Godot in scripts/Tutorial/Logic: copione con
  validazione, fatti, condizioni counter/panel/all/any, macchina a stati,
  avanzamento salvato; compilata anche dal progetto dei test (8 test).
- Riquadro non modale in basso a sinistra della mappa, contorno ambra
  animato, Avanti / Salta passo / Chiudi tutorial, F1 per nasconderlo o
  riaprirlo; nel menu la casella «Mostra il tutorial» (attiva alla prima
  partita) e l'opzione «Tutorial».
- Avanzamento per partita in user://settings.cfg, ripreso dopo il
  caricamento; il pilota automatico non crea il tutorial.

Refs #45.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
F6: tutorial, correzioni della revisione
CI / Build e test (pull_request) Successful in 1m29s
CI / Immagine Docker (pull_request) Successful in 30s
64209afd5f
Unisce origin/main (audio, ere e obsolescenza, scheda dell'industria e
schermata di connessione) e corregge i rilievi della revisione del
tutorial (ADR 0023 aggiornato).

- Chiave dell'avanzamento senza l'impronta del terreno, che il server
  ricalcola e che cambia giocando (città, industrie): origine della
  partita, seme, lato, anno d'inizio, regione e compagnia. Un tutorial
  ripreso dopo un anno di gioco ritrova la sua voce.
- «Tutorial» apre una partita locale di prova sempre nuova in
  user://tutorial-server invece di riprendere l'autosalvataggio del
  giocatore e rifare il tutorial lì dentro; con salvataggi locali già
  presenti la casella «Mostra il tutorial» parte spenta. Casella e
  pulsante passano nella nuova ConnectScreen (MenuScreen non c'è più).
- La casella spuntata vale anche su una voce chiusa o completata (stesso
  seme di una partita vecchia).
- Contorno ritagliato dai contenitori a scorrimento, con l'elemento
  portato in vista; del tutto nascosto si usa il ripiego.
- Pulsanti del riquadro senza fuoco: Invio e spazio restano alla
  partita (Costruisci, pausa) e non saltano il passo.
- La base di «increase» è presa al completamento del passo precedente e
  gli esiti dei comandi si valutano subito: un binario costruito appena
  dopo conta per il passo nuovo.
- Velocità contata solo dalle richieste di questo client.
- Copione mancante o non valido segnalato nella partita; validazione
  dei null ammessi dal JSON.
- Test: chiave stabile con impronta diversa, base al completamento,
  piano con la casella, null nel copione. 228 test (208 senza i lenti).

Refs #45.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alby96 merged commit 1579f63287 into main 2026-11-08 14:57:43 +01:00
Alby96 deleted branch claude/f6-tutorial 2026-11-08 14:57:44 +01:00
Sign in to join this conversation.