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>
1.7 KiB
ADR-59 — Il motore PLM è un pacchetto senza framework; la Fase A usa un ledger simulato
- Stato: Accettata — implementazione da completare
- Area: Architettura
- Funzionalità: ARC, TX, RND
- Collegata a: ADR-54, ADR-55
Contesto
Derivazione degli indirizzi, costruzione e firma delle transazioni, client Electrum, validazione degli header e calcolo dell'estrazione non dipendono dal database né da FastAPI. I servizi di puntata, prelievo, deposito, scheduler e riconciliazione sì (SQLAlchemy). Il TODO vuole un round completo verificabile dal browser prima di integrare il motore.
Decisione
I moduli senza database passano così come sono in un pacchetto separato
(plm_engine), senza dipendere da Django; i servizi che toccano il database
vengono riscritti sull'ORM Django con la stessa logica. I 758 test del
motore puro restano e sono la prova di equivalenza (stessi indirizzi, importi,
output e risultato a parità di input).
Nella Fase A i movimenti di denaro passano da un ledger simulato dietro la stessa interfaccia dei servizi (deposito, puntata, pagamento). Nella Fase B l'implementazione simulata si sostituisce con quella che usa Electrum, senza cambiare viste né modelli.
Alternative scartate
- Riscrivere tutto da zero — perde 758 test e anni di correzioni (B-nn).
- Integrare subito il motore — il sito sarebbe verificabile solo con la catena disponibile; il ledger simulato isola i problemi.
Conseguenze
- Il ledger simulato non esiste in produzione: è escluso dal profilo
mainnet. - Requisiti:
ARCda aggiornare con l'implementazione.
Codice: da implementare · Test: da implementare