F6: tutorial, correzioni della revisione
CI / Build e test (pull_request) Successful in 1m29s
CI / Immagine Docker (pull_request) Successful in 30s

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>
This commit is contained in:
Alby96andClaude Opus 5.5 committed 2026-11-08 14:51:31 +01:00
commit 64209afd5f
75 files changed
+7612 -571

No files matched your search

@@ -17,7 +17,7 @@ public sealed class TutorialScript
public List<TutorialStep> Steps { get; init; } = [];
/// <summary>Indice del passo con l'id indicato, -1 se non c'è.</summary>
public int IndexOf(string? id) => id is null ? -1 : Steps.FindIndex(s => s.Id == id);
public int IndexOf(string? id) => id is null ? -1 : Steps.FindIndex(s => s?.Id == id);
/// <summary>Legge il copione dal testo JSON (commenti e virgole finali ammessi, campi sconosciuti rifiutati).</summary>
public static TutorialScript Parse(string json) =>
@@ -41,15 +41,29 @@ public sealed class TutorialScript
return list;
}
/// <summary>Controlla il copione: id unici, testi presenti, elementi, contatori e pannelli noti. Restituisce gli errori in italiano.</summary>
/// <summary>
/// Controlla il copione: elenco e passi presenti (il JSON ammette <c>null</c>), id unici, testi presenti,
/// elementi, contatori e pannelli noti. Restituisce gli errori in italiano.
/// </summary>
public List<string> Validate()
{
var errors = new List<string>();
if (Version != 1) errors.Add($"versione {Version} non supportata");
if (Steps is null)
{
errors.Add("elenco dei passi mancante");
return errors;
}
if (Steps.Count == 0) errors.Add("nessun passo");
var ids = new HashSet<string>(StringComparer.Ordinal);
foreach (var step in Steps)
for (int i = 0; i < Steps.Count; i++)
{
var step = Steps[i];
if (step is null)
{
errors.Add($"passo n. {i + 1} nullo");
continue;
}
string where = $"passo «{step.Id}»";
if (string.IsNullOrWhiteSpace(step.Id)) errors.Add("passo senza id");
else if (!ids.Add(step.Id)) errors.Add($"{where}: id ripetuto");
@@ -140,7 +154,11 @@ public sealed class TutorialCondition
{
if (list is null) continue;
if (list.Count == 0) errors.Add($"{where}: elenco di condizioni vuoto");
foreach (var c in list) c.Validate(where, errors);
foreach (var c in list)
{
if (c is null) errors.Add($"{where}: condizione nulla");
else c.Validate(where, errors);
}
}
}
}