TIGOTAN

Obiettivo

Il giocatore deve trovare i corretti accoppiamenti tra le Carte Dati delle singole stelle e le corrispondenti Carte Curva di Luce. Dopo aver scelto due carte di tipo diverso, il gioco chiede se la stella della Carta Dati ha una curva di luce corrispondente alla Carta Curva scelta.

Mazzo

La versione web contiene 52 carte di gioco: 26 Carte Dati e 26 Carte Curva di Luce. Ogni stella ha un solo abbinamento corretto.

Come si gioca

Le 52 carte sono mescolate con un algoritmo casuale a ogni nuova partita: la posizione non resta fissa.

1. Il giocatore scopre la prima carta. In un riquadro compare soltanto il nome della stella (Carta Dati) oppure la prima riga della Carta Curva di Luce (tipo spettrale, quando disponibile). Il tabellone resta visibile.
2. Il giocatore sceglie una seconda carta.
3. Solo dopo la seconda scelta, le due carte vengono ingrandite in primo piano per permettere la lettura.
4. Se le carte sono di tipo diverso, cioè una Carta Dati e una Carta Curva di Luce, il gioco chiede: la stella ha una curva di luce corrispondente alla carta prescelta?
5. Il giocatore risponde scegliendo Sì, sono abbinate oppure No, non sono abbinate.
6. Dopo la risposta compare il risultato. Il giocatore può rileggere le carte e poi premere Avanti per tornare al tabellone.

Punteggio base

• Risposta corretta alla domanda di abbinamento, su una combinazione di due carte mai valutata: +1 punto.
• Risposta errata alla domanda di abbinamento: -1 punto.
• Scelta di due carte con lo stesso dorso, quindi due Carte Dati o due Carte Curva: -2 punti.

Un abbinamento viene considerato completato solo quando il giocatore sceglie una Carta Dati e la Carta Curva corrispondente, e risponde correttamente che sono abbinate.

Combinazioni già provate

Il gioco registra le combinazioni di due carte già valutate, indipendentemente dall'ordine. Se la stessa combinazione viene scelta una seconda volta, il sistema avverte il giocatore e assegna 0 punti, senza riproporre la domanda. Dalla terza volta in poi assegna -1 punto ogni volta, sempre con avviso. Il conteggio si azzera all'inizio di ogni nuova partita. Le coppie correttamente abbinate sono bloccate e non si possono più riutilizzare.

Prima carta e lettura su smartphone

Dopo la prima selezione appare un riepilogo sintetico senza suggerire la coppia: nome della stella per le Carte Dati e prima riga della descrizione per le Carte Curva di Luce. Per supernovae e pulsar, quando il tipo spettrale non compare nella carta, è mostrata la prima informazione effettivamente presente (per esempio la magnitudine). Solo dopo la seconda selezione appaiono entrambe le carte complete. Su telefono le carte sono disposte senza sovrapposizione nel pannello scorrevole; toccandole è possibile ingrandirle.

Raddoppia o rischia

Quando il punteggio arriva almeno a 4, si può aprire una domanda bonus. Dalla v009 le domande bonus non sono più a testo libero: ogni domanda mostra due risposte possibili, una corretta e una sbagliata, ricavate dalla tabella data/bonus_questions.json.

Il gioco mescola automaticamente la posizione delle due risposte a ogni domanda, quindi la risposta corretta può comparire a sinistra o a destra in modo casuale. Non serve più un docente esterno per convalidare la risposta: il punteggio viene aggiornato automaticamente quando il giocatore seleziona una delle due opzioni.

• Senza aiuto: se la risposta scelta è corretta il punteggio raddoppia; se è errata si perdono 2 punti.
• Con carta informazione: prima viene mostrata una Carta Informazione casuale. Le carte informazione restano quelle orizzontali, con immagine a sinistra e testo completo a destra. Se la risposta scelta è corretta si aggiunge metà del punteggio corrente; se è errata si perdono 2 punti.

In caso di risposta errata, il gioco mostra anche la risposta corretta prima di chiudere la finestra bonus.

High score e uscita

Prima di iniziare, la pagina iniziale TIGOTAN permette di vedere la classifica. Il pulsante Esci / salva durante la partita apre la schermata di salvataggio. Dopo il salvataggio compare una pagina di saluto con la grafica TIGOTAN e le possibilità di una nuova partita, consultare la classifica o tornare all'inizio. È anche possibile uscire senza salvare.

Il pulsante High score mostra la classifica salvata. La classifica conserva nickname, punteggio, mosse e abbinamenti. I dati sono salvati in data/high_scores.json.

Sicurezza e accesso alle cartelle

Le cartelle interne del progetto, come data/, templates/ e scripts/, non sono pubblicate come directory web. L’app espone solo le rotte Flask previste, come /, /manual e /api/....

La cartella static/ è pubblica perché contiene immagini, CSS e JavaScript necessari al funzionamento del gioco. Un utente può quindi aprire direttamente una singola immagine statica se conosce l’indirizzo, ma non deve poter navigare le directory interne del programma. La v008 aggiunge anche intestazioni di sicurezza HTTP di base.

Lingua del gioco

In alto si può selezionare IT o DE. La scelta viene ricordata dal browser. Il cambio lingua non riavvia la partita e non modifica il punteggio, le posizioni o gli abbinamenti delle carte.

Backup totale

Il progetto include lo script scripts/backup_total.sh. Su PythonAnywhere si può eseguire:

cd /home/Bolzanello/AstroMemory
bash scripts/backup_total.sh

Lo script crea uno ZIP completo in /home/Bolzanello/backups/, includendo codice, dati, immagini, high score e manuale.

File principali

Le immagini delle carte sono in static/img/cards/. Gli abbinamenti sono in data/cards.json. Le domande bonus a risposta multipla sono in data/bonus_questions.json, con i campi correct_answer e wrong_answer. Le carte informazione sono in data/info_cards.json.