Files
plm-lottery/docs/adr/ADR-55-sqlite-wal-web-worker-processi-separati.md
T
davideandClaude Sonnet 5.5 6441733160 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>
2026-11-16 11:46:05 +01:00

2.2 KiB

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

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), su transazioni brevi e sulla prenotazione degli UTXO nel database. Gli importi restano interi in unità minime (ADR-35).

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), da scrivere con l'implementazione.

Codice: da implementare · Test: da implementare