# 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