davideandClaude Sonnet 5
4b510f312f
CLAUDE.md's DRAW architecture bullet now explains draw_animation_seconds and its decoupling from the real block-wait timing. guida-utente.md gets a new "Estrazione del vincitore" section describing what a player sees and when. guida-admin.md's Parametri table and hardcoded-defaults note include the new field. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3.5 KiB
Guida utente
Come usare PLM Lottery dall'interfaccia web (https://<host>/ — vedi
running-the-server.md per come avviare il server).
Registrazione e accesso
Nella schermata iniziale trovi due tab: Registrati e Login.
- Registrati: scegli username e password. Al termine ti viene assegnato automaticamente un indirizzo di deposito personale (derivato server-side) — è per sempre tuo, e riceverai anche eventuali vincite su quello stesso indirizzo.
- Login: se hai già un account, accedi con username e password.
La sessione resta salvata nel browser (fino al logout): non serve rifare login ogni volta che riapri la pagina.
La dashboard
Dopo l'accesso vedi, in ordine:
- Barra account — il tuo username e il bottone "Esci" (logout)
- Card del round corrente — sempre visibile, indipendentemente dalla
sezione che stai guardando:
- numero del round e stato (aperto, in chiusura, estrazione in corso, pagamento in corso)
- timer che conta alla rovescia il tempo rimanente prima della chiusura del round
- giocatori: quanti hanno già piazzato una bet in questo round
- jackpot: il totale in PLM che verrà distribuito (70% al vincitore, 30% in fee)
- Menu di navigazione con tre sezioni:
Estrazione del vincitore
Quando il round chiude, le bet non sono più accettate e la card del round mostra un'animazione ("Estrazione del vincitore in corso…") al posto del timer — la stessa cosa compare nella dashboard di ogni giocatore, non solo la tua. L'animazione resta visibile per almeno un tempo minimo configurabile dall'admin (default 20s), ma può durare più a lungo: il vincitore viene scelto usando l'hash del primo blocco confermato dopo la chiusura, quindi il tempo reale dipende dalla rete (mediamente ~2 minuti, il block time di PLM).
Appena il vincitore è determinato, l'animazione lascia spazio a un messaggio:
- "🎉 Hai vinto! +N PLM" se sei tu il vincitore — l'importo ti verrà accreditato non appena la transazione di payout viene confermata (il round successivo non si apre finché questo non accade)
- "Non hai vinto questa volta." altrimenti
Il messaggio resta visibile fino all'apertura del round successivo.
Deposito
- Il tuo saldo interno (accreditato dopo 1 conferma di rete) con bottone "Aggiorna" per ricontrollarlo
- Il tuo indirizzo di deposito, con bottone per copiarlo negli appunti
- Il QR code dello stesso indirizzo, comodo per inviare PLM da un altro wallet scansionandolo invece di copiare l'indirizzo a mano
Per depositare, invia PLM (mainnet reale) a quell'indirizzo da un wallet esterno. Il saldo si aggiorna da solo dopo la prima conferma; premi "Aggiorna" per vederlo comparire.
Bet
Un bottone unico: piazza l'ingresso a costo fisso (mostrato in PLM) nel round corrente. Puoi avere al massimo una bet attiva alla volta. Il costo viene scalato dal tuo saldo interno.
Prelievo
Form con due campi:
- Indirizzo esterno: dove vuoi ricevere i PLM
- Importo (PLM): quanto prelevare
Il prelievo viene costruito e trasmesso sulla rete; la fee di rete viene scalata dall'importo richiesto (non si aggiunge separatamente).
Notifiche
Ogni azione (registrazione, login, bet, prelievo, ecc.) mostra un breve
messaggio (toast) verde in caso di successo o rosso in caso di errore, in
basso nella pagina. Se qualcosa non va e il messaggio non basta a capire il
motivo, il dettaglio tecnico è nei log del server (logs/app.log o
data/logs/app.log con Docker) — non nell'interfaccia.