diff --git a/docs/guida-admin.md b/docs/guida-admin.md index 415d38e..b9b4be0 100644 --- a/docs/guida-admin.md +++ b/docs/guida-admin.md @@ -52,6 +52,39 @@ hardcoded nel codice (`RoundConfig` in `app/db/models.py`: bet 10 PLM, round 10 minuti, cooldown 30s, minimo 1 PLM, fee 1 sat/vB, RBF timeout 900s) — vanno comunque rivisti e confermati dal pannello prima del primo utilizzo reale. +**Chi paga il fee-bump RBF?** Quando una bet, un payout o un prelievo resta +troppo a lungo senza conferma (oltre il "Timeout prima del fee-bump RBF"), il +sistema lo ritrasmette con una fee più alta. Il costo aggiuntivo lo assorbe +sempre **chi ha originato la transazione**, non il destinatario: per bet e +prelievi è l'utente stesso (gli torna un resto più piccolo), per i payout è +il pool (il resto che torna all'indirizzo pool si riduce) — la quota del +vincitore e quella delle fee, già fissate, non vengono mai toccate. Se non +c'è un resto abbastanza grande da assorbire l'aumento, il bump fallisce e +resta un intervento manuale (vedi "Limiti noti"). + +## Round + +La sezione "Round" mostra lo storico (`GET /admin/rounds`, ultimi 50 per +default): id, stato, orario di apertura, vincitore (username), importo del +pool, importo vinto, importo di fee, txid del payout — tutti in PLM salvo il +txid. + +## Transazioni pendenti + +`GET /admin/pending-transactions` elenca bet, payout e prelievi ancora senza +conferma: tipo, stato, txid corrente, fee rate usata, numero di tentativi +(si incrementa a ogni bump RBF) e orario dell'ultima trasmissione. Una riga +che resta qui a lungo, con `attempt_count` che sale, indica una transazione +in difficoltà — vedi "Limiti noti" sul fallback RBF. + +## Audit log + +`GET /admin/audit-log` elenca gli ultimi 200 eventi registrati dal sistema +(tipo evento, payload JSON, utente/round coinvolti, timestamp): bet +piazzate, payout inviati, round chiusi, configurazione modificata, accessi +alle chiavi private, ecc. È il primo posto da controllare per ricostruire +cosa è successo dopo un problema. + ## Alternative all'interfaccia grafica Le stesse operazioni si possono fare da terminale o da Swagger UI