Files

T

davideandClaude Sonnet 5 784f30ddd7 Add docs/ with separate setup, run, user and admin guides

Four standalone Markdown docs instead of growing CLAUDE.md further:
setup.md (one-time secrets/master-key/migrations), running-the-server.md
(local venv vs Docker+Caddy, dev self-signed vs production domain),
guida-utente.md (dashboard: deposit+QR, bet, withdrawal, round timer/
jackpot) and guida-admin.md (the /admin panel and its API equivalent).
Written in Italian per explicit request, unlike the rest of the
repository's English-only docs.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-07-21 11:22:03 +02:00

2.6 KiB

Raw Blame History

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:

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.

2.6 KiB Raw Blame History