.. -*- coding: utf-8 -*-
.. :Project:   SoL
.. :Created:   mer 25 dic 2013 12:20:17 CET
.. :Author:    Lele Gaifax <lele@metapensiero.it>
.. :License:   GNU General Public License version 3 or later
.. :Copyright: © 2013, 2014, 2016, 2026 Lele Gaifax
..

Altre finestre
==============

.. _countdown:

.. figure:: countdown.png

   Conto alla rovescia.

Conto alla rovescia
-------------------

Questa pagina mostra un semplice *conto alla rovescia* che emette degli *allarmi* in
determinati momenti (utilizzando SoundManager_): la durata è determinata dai valori impostati
in :guilabel:`durata` e :guilabel:`preavviso` sul :ref:`torneo <gestione tornei>`.

Il *conto alla rovescia* può essere attivato usando il primo pulsante in basso; un altro modo
di farlo è usando il secondo pulsante che farà partire il tempo dopo 15 secondi, dando così
modo all'operatore di raggiungere il proprio tavolo di gioco.

Chiudere la finestra con il conto alla rovescia (o usa il terzo pulsante in basso) per
annullare l'allarme: per prevenire chiusure accidentali, viene richiesta una conferma
esplicita.

.. hint:: Dal momento che l'istante di attivazione del conto alla rovescia viene inviato a ``SoL``
          e memorizzato nel database, se per qualsiasi ragione il computer dovesse essere fatto
          ripartire il conto alla rovescia verrà ripristinato dal medesimo istante.

          Questo consente inoltre di mostrare più pagine con il conteggio, anche su computer
          diversi, ad esempio quando si desideri mostrare lo stesso conto alla rovescia in
          stanze diverse.  Ovviamente in questo caso il conto alla rovescia deve essere fatto
          partire da una sola postazione, mentre sulle altre basterà richiedere la nuova
          visualizzazione **dopo** aver fatto partire il conto alla rovescia.

.. _soundmanager: http://schillmania.com/projects/soundmanager2/

.. _dashboard:

.. figure:: dashboard.png

   Dashboard.

Dashboard
---------

Questa pagina è pensata per essere visualizzata su un grande schermo presso la sede
dell'evento, ad esempio su un proiettore o su un televisore nel corridoio: mostra il *conto
alla rovescia* del turno in corso, gli incontri in corso con i relativi punteggi, aggiornati
non appena vengono inseriti (anche con i cartellini *digitali*, durante lo svolgimento delle
partite), e la classifica. Durante lo svolgimento delle finali, mostra le partite di ciascuna
di esse e, una volta concluso il torneo, i risultati finali.

Si apre con l'azione :guilabel:`Dashboard in tempo reale` della :ref:`gestione dei tornei
<ulteriori azioni tornei>`, oppure dalla finestra :guilabel:`Dashboard` nel :ref:`pannello
delle partite <pannello incontri>`, e non richiede alcun accesso, quindi può essere
visualizzata su qualsiasi computer.

I suoi contenuti sono determinati dal torneo: il conto alla rovescia dalla sua
:guilabel:`durata` e dal suo :guilabel:`preallarme`, la dicitura "*Turno 3 / 8*"
nell'intestazione dal suo :guilabel:`numero massimo di turni` (quando non è impostato, il
numero di turni è noto solo per i tornei *a eliminazione diretta* e *all'italiana*) e l'inizio
stimato del turno successivo dalla sua :guilabel:`durata dell'intervallo`. Il *messaggio ai
giocatori*, mostrato sotto l'intestazione, e un orario di inizio esplicito per il turno
successivo sono impostati nella finestra :guilabel:`Dashboard` del :ref:`pannello delle partite
<pannello incontri>`.

Durante i primi due turni, nell'angolo in basso a destra viene visualizzato un codice QR che
rimanda alla pagina ``Lit`` del torneo: cliccaci sopra per nasconderlo.

Cliccando sul logo nell'angolo in alto a sinistra o premendo il tasto :kbd:`Spazio` si aprono
le *impostazioni* della schermata, che riguardano solo la schermata stessa e vengono
memorizzate dal browser: lo zoom, il numero di colonne, il codice QR e quale logo viene
visualizzato nell'intestazione. Lo stesso si può fare con alcuni tasti:

:kbd:`+` e :kbd:`-`
  Ingrandisci e rimpicciolisci, :kbd:`0` ripristina lo zoom.

:kbd:`[` e :kbd:`]`
  Riduci e aumenta il numero di colonne utilizzate per i tabelloni e i giocatori; :kbd:`\\` lo
  reimposta su automatico.

:kbd:`Esc`
  Chiude le impostazioni.

Lo zoom può essere regolato anche con i pulsanti che compaiono al centro della barra inferiore
quando il mouse vi si trova sopra: cliccando sulla percentuale si ripristina il valore
predefinito.

È possibile specificare qualche altra opzione nell'indirizzo della pagina, ad esempio
``…/dashboard?qr=0&poll=5``:

``qr``
  ``1`` mostra sempre il codice QR, ``0`` non lo mostra mai.

``poll``
  Frequenza con cui la pagina verifica la presenza di modifiche, espressa in secondi: per
  impostazione predefinita ogni 10 secondi, almeno ogni 5.

``logo``
  L'indirizzo di un'immagine visualizzata nell'intestazione al posto dello stemma del club, ad
  esempio il logo dell'associazione che organizza l'evento.

.. hint:: Tutto ciò che viene visualizzato proviene dal database e la pagina verifica la
          presenza di modifiche ogni pochi secondi, quindi è possibile aprire la dashboard su
          più schermi, eventualmente in stanze diverse, tutti con la stessa visualizzazione: se
          uno schermo dovesse essere riavviato per qualsiasi motivo, è sufficiente aprire
          nuovamente la pagina.

.. _caricamento:

.. figure:: caricamento.png
   :figclass: float-right

   Caricamento dati torneo.

Caricamento
-----------

Con questa semplice finestra è possibile caricare i dati di un intero torneo, provenienti da
un'altra istanza di ``SoL``. I nuovi dati non sovrascriveranno quelli esistenti, delle entità
preesistenti verranno aggiornati solo i dati mancanti.

Chiunque può caricare archivi ``.sol`` (o la versione compressa ``.sol.gz``). Gli utenti
autenticati, tranne l'utente `guest`, possono caricare anche archivi ``.zip`` con i dati dei
tornei insieme ai ritratti dei giocatori e agli stemmi dei club.

.. topic:: Esportazione dei dati

   I dati dei tornei possono essere estratti con il pulsante :guilabel:`Scarica` nelle gestioni
   dei :ref:`tornei <gestione tornei>` e dei :ref:`campionati <gestione campionati>`: si tratta
   di file di testo, in formato YAML__ (eventualmente compresso), che possono essere ricaricati
   in un'altra istanza di ``SoL``, piuttosto che archiviati per sicurezza. L'archivio creato in
   questo modo contiene tutti i tornei specificati così come i dati relativi a tutti i
   giocatori, club e campionati coinvolti. **Non** contiene nessuna immagine, né ritratti né
   stemmi.

   Un altro modo consente di esportare l'intero database, cioè *tutti* i tornei e *tutti* i
   giocatori (indipendentemente se abbiano partecipato a un torneo o meno) **e tutte** le
   immagini associate. Visitando l'indirizzo::

     http://localhost:6996/bio/backup

   si otterrà un archivio ``ZIP`` contenente tutto quanto, che potrà essere caricato in
   un'altra installazione di ``SoL``, copiando/aggiornando così praticamente tutte le informazioni
   memorizzate e le relative immagini. Chiaramente l'archivio prodotto in questo modo avrà
   dimensioni molto maggiori del precedente: questo metodo è raccomandato solo per migrare
   l'intero database a una nuova versione di ``SoL``, oppure qualora si desideri copiare tutte le
   immagini in un colpo solo.

__ http://www.yaml.org/
