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>
This commit is contained in:
1 parent
6683f197eb
commit
784f30ddd7
4 files changed
+275
No files matched your search
@@ -0,0 +1,68 @@
|
||||
# Guida utente
|
||||
|
||||
Come usare PLM Lottery dall'interfaccia web (`https://<host>/` — vedi
|
||||
[running-the-server.md](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:
|
||||
|
||||
1. **Barra account** — il tuo username e il bottone "Esci" (logout)
|
||||
2. **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)
|
||||
3. **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.
|
||||
Reference in new issue
Block a user