Spec the Django migration: ADR-54..60 and docs/sito-e-app.md (WEB-01..WEB-44)
Docs-first step for the move to Django per TODO.md: framework and areas (ADR-54, WEB-01..07), SQLite WAL with separate web/worker processes (ADR-55), individual staff accounts with MFA deferred to phase C (ADR-56), distinct pause commands (ADR-57), regtest alpha with a network profile (ADR-58), framework-free PLM engine with a simulated ledger in phase A (ADR-59), Italian-only pilot (ADR-60). The site must be browsable on localhost before a domain exists (WEB-07). Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
9b8a331bba
commit
6441733160
11 files changed
+489
-1
No files matched your search
@@ -0,0 +1,46 @@
|
||||
# ADR-55 — SQLite in WAL condiviso da due processi: web e worker
|
||||
|
||||
- **Stato:** Accettata — implementazione da completare
|
||||
- **Area:** Configurazione e ambiente
|
||||
- **Funzionalità:** ARC, DAT
|
||||
- **Sostituisce (quando implementata):** [ADR-13](ADR-13-processo-file-sqlite.md)
|
||||
|
||||
## Contesto
|
||||
|
||||
I compiti di fondo (listener Electrum, conferme, avanzamento dei round,
|
||||
invio, riconciliazione, RBF) devono continuare anche se il processo web si
|
||||
riavvia o si blocca. Oggi vivono nello stesso processo del web, e i blocchi
|
||||
per-utente e il canale SSE sono in memoria: non funzionano fra due processi.
|
||||
|
||||
## Decisione
|
||||
|
||||
**Il web e il worker sono due processi separati che scrivono nello stesso
|
||||
file SQLite in modalità WAL**, con `synchronous=FULL` e transazioni di
|
||||
scrittura aperte in modo `IMMEDIATE` (opzione `transaction_mode` del backend
|
||||
SQLite di Django). Il worker è un management command (`manage.py run_worker`)
|
||||
con un servizio dedicato in `docker-compose.yml`. La coordinazione non usa
|
||||
memoria condivisa: si basa su vincoli e indici del database ([ADR-22](ADR-22-piu-round-attivo-come-invariante-database.md)),
|
||||
su transazioni brevi e sulla prenotazione degli UTXO nel database. Gli importi
|
||||
restano interi in unità minime ([ADR-35](ADR-35-aritmetica-satoshi-interi.md)).
|
||||
|
||||
**PostgreSQL è rinviato** a dopo il pilota: si introduce quando la
|
||||
concorrenza lo richiede. L'accesso passa dall'ORM e da una sola funzione per
|
||||
le transazioni di scrittura, così il passaggio tocca pochi punti.
|
||||
|
||||
## Alternative scartate
|
||||
|
||||
- PostgreSQL subito — per un pilota con un solo operatore e pochi
|
||||
giocatori aggiunge un servizio da gestire senza risolvere un problema
|
||||
presente.
|
||||
- Un solo processo con thread di fondo — un riavvio del web interrompe i
|
||||
round, e con più worker del server web i compiti di fondo si duplicano.
|
||||
- Redis per i blocchi — dipendenza in più; i vincoli del database bastano.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- I blocchi per-utente in memoria (`tx/locks.py`) e il limitatore in memoria
|
||||
vanno sostituiti da garanzie nel database ([LIM-18] cade per la parte web/worker).
|
||||
- Un solo scrittore alla volta: accettato per la scala del pilota.
|
||||
- Requisiti: `ARC-70` … `ARC-72` ([architettura.md](../architettura.md)), da scrivere con l'implementazione.
|
||||
|
||||
*Codice:* da implementare · *Test:* da implementare
|
||||
Reference in new issue
Block a user