A7: player area - play, wallet, movements (WEB-03, WEB-05, WEB-20..27)
Gioca: the round, the player's funds and their bet; the bet is two steps (a confirmation screen that sends nothing, then an explicit confirm) with a fresh idempotency key per screen, and the server re-checks everything. Portafoglio: spendable apart from in-confirmation, deposit address with a QR of the player's own address, copy button, simulated test deposits. Movimenti: the player's own ledger, paged, stacked as cards on a phone. GET /app/stato/ feeds the page and its polling. Every view takes the user from the session only. Checked end to end in a real browser (Playwright): status moves from pending to confirmed without a reload, a double click is one bet. Mutation checks: cross-account leak, non-idempotent POST and unrestricted test-deposit amounts are all caught. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
939c113043
commit
42e5e33371
21 files changed
+1192
-48
No files matched your search
+40
-7
@@ -37,7 +37,9 @@ backend FastAPI (vedi [architettura.md](architettura.md)).
|
||||
*Codice:* `config/settings.py`, `apps/web/views.py:csrf_failure` ·
|
||||
*Test:* `tests/django/test_accounts.py::test_the_session_cookie_is_httponly_secure_and_samesite`, `test_a_form_without_the_csrf_token_is_refused`
|
||||
- **[WEB-03]** Ogni richiesta dell'area giocatore legge o modifica soltanto i
|
||||
dati dell'utente autenticato; un identificativo di un altro utente dà 404.
|
||||
dati dell'utente autenticato; **nessuna vista prende un utente dalla richiesta**: un parametro `user` costruito a mano non cambia nulla.
|
||||
*Stato:* implementato per l'area giocatore (A7) ·
|
||||
*Test:* `tests/django/test_player.py::test_a_player_never_sees_another_players_data`, `test_user_ids_in_the_request_are_ignored`, `test_every_player_page_needs_a_session`
|
||||
- **[WEB-04]** Importi e saldi si rappresentano in unità minime intere
|
||||
([ADR-35](adr/ADR-35-aritmetica-satoshi-interi.md)); i parametri economici e
|
||||
temporali del round sono fissati alla sua apertura ([ADR-10](adr/ADR-10-parametri-round-fotografati-all-apertura.md)).
|
||||
@@ -46,7 +48,7 @@ backend FastAPI (vedi [architettura.md](architettura.md)).
|
||||
- **[WEB-05]** I dati che cambiano (stato del round, saldo, esito) si
|
||||
aggiornano con richieste periodiche mirate e si recuperano al rientro nella
|
||||
pagina; ricaricare non perde lo stato salvato.
|
||||
*Stato:* implementato per la home (A6, [WEB-14]); per l'area giocatore con l'A7.
|
||||
*Stato:* implementato per la home (A6, [WEB-14]) e per l'area giocatore (A7, [WEB-27]).
|
||||
- **[WEB-06]** Le pagine sono utilizzabili da smartphone e da desktop e
|
||||
navigabili da tastiera, con stati distinti di errore, attesa e conferma.
|
||||
*Stato:* base implementata (A5): layout fluido da 400 px, foglio di stile unico con tema chiaro/scuro, collegamento «Vai al
|
||||
@@ -105,23 +107,54 @@ backend FastAPI (vedi [architettura.md](architettura.md)).
|
||||
## 3 · Area giocatore
|
||||
|
||||
- **[WEB-20]** «Gioca», «Portafoglio» e «Movimenti» sono schermate separate;
|
||||
nel flusso principale hanno priorità quota, stato del round e puntata dell'utente.
|
||||
nel flusso principale hanno priorità quota, stato del round e puntata dell'utente. Il menu segna la sezione corrente (`aria-current`).
|
||||
*Stato:* implementato (A7) · *Codice:* `apps/web/player_views.py:play`, `apps/web/templates/web/app_home.html` ·
|
||||
*Test:* `tests/django/test_player.py::test_the_play_screen_shows_the_round_the_funds_and_the_bet_button`, `test_the_bet_button_is_hidden_without_funds_and_says_why`
|
||||
- **[WEB-21]** Saldo spendibile e fondi in conferma sono distinti. Il deposito
|
||||
mostra rete, indirizzo, QR, copia e stato delle conferme.
|
||||
Il **QR** è sempre quello dell'indirizzo del giocatore (mai un indirizzo preso dalla richiesta); «Copia» è un pulsante che compare solo con
|
||||
JavaScript, e senza di esso l'indirizzo resta un campo di sola lettura da selezionare. Il saldo mostrato include i fondi in conferma
|
||||
ma la puntata usa solo il saldo spendibile ([BET-07], [ADR-34](adr/ADR-34-saldo-spendibile-saldo-mostrato-due-numeri.md)). Il prelievo arriva con la Fase B (B9).
|
||||
*Stato:* implementato (A7; indirizzo simulato fino alla B4) ·
|
||||
*Codice:* `apps/web/player_views.py:wallet`, `wallet_qr`, `apps/web/static/web/wallet.js` ·
|
||||
*Test:* `tests/django/test_player.py::test_the_wallet_separates_spendable_funds_from_funds_in_confirmation`, `test_the_wallet_shows_network_address_qr_and_a_copy_control`, `test_the_qr_takes_no_address_from_the_request`
|
||||
- **[WEB-22]** Prima di inviare una puntata si mostrano round e importo; il
|
||||
server valida disponibilità, quota, limiti e stato del round. Dopo l'invio
|
||||
si mostra lo stato effettivo (attesa, conferma, rifiuto o esclusione).
|
||||
*Stato:* validazione e stati implementati nel ledger (A3: round, scadenza, quota del round, limiti, fondi,
|
||||
`round_closing`, `already_betting`, `round_full`, `bets_suspended`, `balance_pending_confirmation`, rifiuto ed esclusione);
|
||||
la schermata con l'A7 ·
|
||||
*Codice:* `apps/lottery/ledger.py:SimulatedLedger.place_bet` · *Test:* `tests/django/test_ledger.py`
|
||||
anche la schermata (A7): la puntata è in due passi — la schermata di conferma mostra round e importo e non invia nulla; l'invio avviene solo
|
||||
con «Conferma e punta», e il server ricontrolla tutto (una pagina rimasta aperta mentre il round cambiava è rifiutata con un messaggio chiaro).
|
||||
Dopo l'invio la pagina mostra lo stato reale e un aggiornamento della pagina, anche da un altro browser, lo ritrova ·
|
||||
*Codice:* `apps/lottery/ledger.py:SimulatedLedger.place_bet`, `apps/web/player_views.py:bet` ·
|
||||
*Test:* `tests/django/test_ledger.py`, `tests/django/test_player.py::test_the_confirmation_screen_shows_round_amount_and_funds_and_sends_nothing`, `test_a_stale_confirmation_is_refused_by_the_server_with_a_clear_message`, `test_a_page_reload_recovers_the_saved_state`
|
||||
- **[WEB-23]** Un doppio invio della stessa richiesta produce una sola
|
||||
operazione logica (chiave di idempotenza associata alla richiesta).
|
||||
*Stato:* implementato nel ledger (A3, [ARC-76]); il modulo di invio con l'A7 ·
|
||||
*Test:* `tests/django/test_ledger.py::test_the_same_bet_request_is_one_bet`
|
||||
*Stato:* implementato nel ledger (A3, [ARC-76]) e nel modulo di invio (A7): ogni schermata di conferma porta una chiave nuova, e inviarla due volte
|
||||
è una sola puntata; la stessa conferma aperta in due schede è rifiutata come «hai già una puntata» ·
|
||||
*Test:* `tests/django/test_ledger.py::test_the_same_bet_request_is_one_bet`, `tests/django/test_player.py::test_sending_the_same_confirmation_twice_makes_one_bet`, `test_the_same_confirmation_opened_in_two_tabs_makes_one_bet`
|
||||
- **[WEB-24]** Il prelievo mostra, prima della conferma, indirizzo, importo
|
||||
richiesto, commissione e importo netto previsto. Lo storico distingue lo stato
|
||||
dell'operazione dal TXID corrente e lo collega all'explorer quando disponibile.
|
||||
- **[WEB-25]** **Movimenti.** `/app/movimenti/` elenca depositi, puntate, vincite, rimborsi e prelievi del solo giocatore, dal più recente, a pagine di 25,
|
||||
con data (UTC), operazione, stato (in conferma, confermato, non riuscito), importo con segno e transazione: il TXID abbreviato, collegato all'explorer
|
||||
se `EXPLORER_TX_URL` è configurato, e marcato «simulata» sul ledger simulato. Da telefono le righe diventano schede, così l'importo non esce mai
|
||||
dallo schermo; la tabella ha didascalia e intestazioni di colonna.
|
||||
*Stato:* implementato (A7) ·
|
||||
*Codice:* `apps/web/player_views.py:movements`, `apps/web/templates/web/movements.html` ·
|
||||
*Test:* `tests/django/test_player.py::test_the_movements_are_listed_newest_first_with_sign_and_status`, `test_movements_are_paged`, `test_the_txid_links_to_the_explorer_when_one_is_configured`
|
||||
- **[WEB-26]** **Fondi di prova.** Con il ledger simulato il portafoglio offre un deposito di prova da 10, 50 o 100 PLM che arriva «in conferma» e il worker conferma
|
||||
pochi secondi dopo ([RND-42]); un importo diverso da quelli offerti non dà nulla, il doppio invio è un solo deposito, e con un ledger reale l'indirizzo non esiste (404)
|
||||
e il modulo non compare.
|
||||
*Stato:* implementato (A7) ·
|
||||
*Codice:* `apps/web/player_views.py:simulated_deposit` ·
|
||||
*Test:* `tests/django/test_player.py::test_a_test_deposit_arrives_in_confirmation_and_becomes_spendable`, `test_only_the_offered_amounts_are_accepted`, `test_test_deposits_exist_only_on_the_simulated_ledger`
|
||||
- **[WEB-27]** **Stato del giocatore.** `GET /app/stato/` (solo con sessione, mai in cache) è lo stato pubblico ([WEB-14]) più un blocco `me` con i soli dati del giocatore:
|
||||
saldo spendibile e in conferma, la sua puntata nel round (stato e testo), se può puntare e perché no, e come è finito il suo ultimo round («hai vinto 21 PLM»,
|
||||
«non hai vinto»). Una sola funzione (`player_state`) alimenta la pagina e l'endpoint; `home.js` aggiorna lo stato della puntata e i saldi senza ricaricare.
|
||||
*Stato:* implementato (A7); verificato in un browser reale: dalla conferma «In attesa» a «Confermata» in circa 9 secondi senza ricaricare ·
|
||||
*Codice:* `apps/lottery/player.py:player_state`, `apps/web/player_views.py:player_state_json`, `apps/web/static/web/home.js` ·
|
||||
*Test:* `tests/django/test_player.py::test_the_page_and_the_endpoint_tell_the_same_story`, `test_the_player_is_told_how_their_round_ended`
|
||||
|
||||
## 4 · Console operativa
|
||||
|
||||
|
||||
Reference in new issue
Block a user