Resume a round in drawing from the database after an exception or a restart (B-81, RND-01, RND-15, RND-36, ARC-27, OPS-09, OPS-13, LIM-01)
`_tick` skipped `drawing`: the wait for the draw block lived only inside the `_close_and_draw` call that entered it, so any exception (a locked database writing an audit row, a malformed header) or a restart left the round in `drawing` for ever with the pool inside and no new round able to open. Since B-73 everything the draw needs is committed on entering `drawing` (encrypted secret, ordered list with `draw_position`, `participants_hash`, `draw_height`, `draw_confirmations`), so `_tick` now calls `_complete_draw` for a round in `drawing`. `_complete_draw` rereads that state, is idempotent (a round no longer `drawing`, or with a winner, is left alone; the winner write is re-checked under BEGIN IMMEDIATE) and runs inside the single scheduler loop, so the inline call from `_close_and_draw` and the tick can never run concurrently. Tests (test_draw_proof.py): an exception in the quorum query, then a tick, completes with the same height, list, fingerprint and the winner the public proof recomputes; a brand-new scheduler (restart) resumes and a second tick draws and triggers nothing again; a failure in the very transaction that stores the winner leaves no winner and no revealed secret, and the next tick completes. Mutation-checked: without the `_tick` branch all three fail. Docs: the B-81 `*Stato:*`/`*Oggi:*` lines are gone (RND-01, RND-15, RND-36, ARC-27, OPS-09, ADR-12, ADR-25), OPS-13 no longer prescribes the manual `closing` workaround, LIM-01 is struck, storico-bug.md and BUGS.md updated. No existing test changed. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
db24287ea5
commit
473d541ab5
12 files changed
+230
-126
No files matched your search
+21
-50
@@ -200,8 +200,8 @@ denaro di oggi.
|
||||
*dopo* il backup non sono tra i partecipanti, ma i loro soldi sono nel
|
||||
montepremi: annotarli per un rimborso manuale (nessuna procedura
|
||||
supportata, vedi [OPS-24]);
|
||||
- un round in `drawing` **non va mai sbloccato con [OPS-13]** prima di
|
||||
questo controllo: se è già stato pagato, va chiuso come sopra.
|
||||
- un round in `drawing` va controllato allo stesso modo prima di far
|
||||
ripartire l'app: se è già stato pagato, va chiuso come sopra.
|
||||
Annotare ogni modifica (data, id, motivo): nessuna lascia una riga di
|
||||
audit.
|
||||
7. **Controllare gli indirizzi riassegnabili** con [OPS-28], sempre ad app
|
||||
@@ -320,10 +320,7 @@ modifica di `.env` e da solo dopo un crash (`restart: unless-stopped`).
|
||||
*Codice:* `app/rounds/scheduler.py:RoundScheduler._tick`,
|
||||
`app/rounds/scheduler.py:RoundScheduler._retry_payout_if_due`,
|
||||
`app/tx/reconcile.py:reconcile_once` ·
|
||||
*Test:* `tests/unit/test_scheduler.py`, `tests/unit/test_reconcile.py`
|
||||
*Stato:* da implementare (B-81) · *Oggi:* un round in `drawing`
|
||||
**non riprende**: resta in `drawing` per sempre e nessun nuovo round si apre
|
||||
(serve [OPS-13]).
|
||||
*Test:* `tests/unit/test_scheduler.py`, `tests/unit/test_reconcile.py`, `tests/unit/test_draw_proof.py`
|
||||
|
||||
- **[OPS-10]** **Riavvio sicuro e deploy** (nuova versione, modifica di
|
||||
`.env`, rotazione di un segreto):
|
||||
@@ -353,7 +350,7 @@ modifica di `.env` e da solo dopo un crash (`restart: unless-stopped`).
|
||||
deploy è quindi, per il codice, un crash: durante `drawing` blocca il round
|
||||
([OPS-13]), durante un invio lascia una riga `building`. Dopo B-93 l'arresto
|
||||
chiude gli stream e le attività entro 30 secondi; il riavvio
|
||||
durante `drawing` diventa sicuro con B-81 ([OPS-09]).
|
||||
durante `drawing` è sicuro dopo B-81 ([OPS-09]).
|
||||
|
||||
La pausa non blocca scommesse e prelievi sul round in corso, né
|
||||
registrazioni e depositi.
|
||||
@@ -444,8 +441,7 @@ con `docker compose logs app` ([architettura.md](architettura.md) ARC-09).
|
||||
4. Se i server configurati sono davvero tutti inutilizzabili, aggiungerne
|
||||
altri in `ELECTRUM_FALLBACK_SERVERS` (elenco di riferimento:
|
||||
`ChainProfiles.Mainnet.BootstrapServers` del repository PalladiumWallet) e
|
||||
riavviare. **Se un round è in `drawing`, oggi il riavvio lo blocca**:
|
||||
seguire poi [OPS-13].
|
||||
riavviare. Un round in `drawing` riprende da solo dopo il riavvio ([OPS-13]).
|
||||
*Codice:* `app/electrum/listener.py:ElectrumListener.run`,
|
||||
`app/electrum/listener.py:ElectrumListener._keepalive`,
|
||||
`app/api/routes/bets.py`, `app/api/routes/withdrawals.py` ·
|
||||
@@ -477,50 +473,25 @@ con `docker compose logs app` ([architettura.md](architettura.md) ARC-09).
|
||||
sale (Electrum, vedi [OPS-11]);
|
||||
- righe `draw_header_corroboration_failed`, una per blocco: i blocchi
|
||||
arrivano ma gli altri server non li confermano (vedi [OPS-12]);
|
||||
- **nessuna riga nuova e nessun messaggio `still waiting for a block` nel
|
||||
log**: l'attesa non è più in corso. Succede dopo un riavvio del processo,
|
||||
oppure dopo un'eccezione durante l'attesa (messaggio
|
||||
`round scheduler tick failed`, per esempio un database bloccato mentre si
|
||||
scriveva `draw_stalled`). In questo caso il round non si sbloccherà mai da
|
||||
solo.
|
||||
- nessuna riga nuova per più di qualche minuto, con `round scheduler tick
|
||||
failed` nel log: un'eccezione durante l'attesa (per esempio un database
|
||||
bloccato mentre si scriveva `draw_stalled`) ha interrotto il passo. Non
|
||||
richiede un intervento: dal passo successivo (5 secondi) lo scheduler
|
||||
riprende l'estrazione dello stesso blocco ([RND-36]); se l'eccezione si
|
||||
ripete, la causa è nella riga di log che la accompagna.
|
||||
|
||||
**Causa.** L'attesa del blocco di estrazione vive solo dentro la chiamata
|
||||
dello scheduler che ha portato il round in `drawing`; a ogni ciclo successivo
|
||||
lo scheduler vede `drawing` e non fa nulla. Nessun codice riprende l'attesa.
|
||||
Dopo B-81 lo scheduler riprende da solo un round in `drawing` e il terzo
|
||||
caso scompare.
|
||||
**Causa.** L'attesa del blocco di estrazione è un passo dello scheduler che
|
||||
rilegge tutto dal database. Dopo un riavvio o un'eccezione riparte da sola:
|
||||
`draw_height`, elenco, `participants_hash` e segreto sono già salvati dal
|
||||
passaggio in `drawing`, quindi l'estrazione ripresa dà lo stesso vincitore
|
||||
(B-81).
|
||||
|
||||
**Cosa fare.** Nei primi due casi basta risolvere la causa (Electrum,
|
||||
server di riserva): l'estrazione avviene da sola al primo blocco valido.
|
||||
Nel terzo caso **non esiste una procedura supportata dal codice**. L'unico
|
||||
intervento possibile è una modifica manuale del database che riporti il round
|
||||
a `closing`, lo stato da cui lo scheduler rifà l'estrazione da capo.
|
||||
**Vale solo per un round bloccato nell'istanza in esercizio: un round in
|
||||
`drawing` arrivato da un backup ripristinato si tratta con [OPS-07],
|
||||
passo 6**, perché potrebbe essere già stato pagato.
|
||||
|
||||
1. Annotare l'id del round (dal pannello, sezione Round) e controllare che
|
||||
sia davvero in `drawing` e che `winner_user_id` sia vuoto.
|
||||
2. `docker compose stop app`.
|
||||
3. Aggiornare lo stato:
|
||||
```bash
|
||||
docker compose run --rm --no-deps app python -c "import sqlite3; c=sqlite3.connect('/app/db_data/plm_lottery.db'); n=c.execute(\"UPDATE rounds SET status='closing' WHERE id=<ID> AND status='drawing' AND winner_user_id IS NULL\").rowcount; c.commit(); print(n, 'riga aggiornata')"
|
||||
```
|
||||
Deve stampare `1 riga aggiornata`.
|
||||
4. `docker compose start app`.
|
||||
5. Al primo ciclo lo scheduler rilegge i partecipanti confermati, riporta il
|
||||
round in `drawing` con un nuovo `drawing_started_at` e aspetta un blocco
|
||||
successivo all'altezza *attuale*; poi estrae e paga normalmente
|
||||
(`winner_drawn`, `payout_sent`).
|
||||
|
||||
Conseguenze da sapere: l'estrazione usa un blocco successivo al momento
|
||||
dello sblocco invece del primo blocco dopo la chiusura, quindi quale blocco
|
||||
decide il vincitore dipende da quando l'operatore interviene; la modifica non
|
||||
lascia alcuna riga nel registro di audit, quindi va annotata altrove, con
|
||||
data, id del round e motivo. I partecipanti non cambiano: il round è fuori da
|
||||
`open`, quindi nessuna scommessa nuova può entrare.
|
||||
**Cosa fare.** Risolvere la causa visibile (Electrum, server di riserva):
|
||||
l'estrazione avviene da sola al primo blocco valido. **Non** riportare il
|
||||
round a `closing` a mano: cambierebbe il blocco che decide il vincitore, e
|
||||
non serve più.
|
||||
*Codice:* `app/rounds/scheduler.py:RoundScheduler._tick`,
|
||||
`app/rounds/scheduler.py:RoundScheduler._close_and_draw`,
|
||||
`app/rounds/scheduler.py:RoundScheduler._complete_draw`,
|
||||
`app/rounds/scheduler.py:RoundScheduler._wait_for_draw_block`
|
||||
|
||||
### Round bloccato in `closing`
|
||||
|
||||
Reference in new issue
Block a user