2026-11-16 11:46:05 +01:00
# 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-54-django-unico-framework-web-tre-aree.md ), [ADR-55 ](ADR-55-sqlite-wal-web-worker-processi-separati.md )
## 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: `ARC` da aggiornare con l'implementazione.
2026-11-16 15:31:47 +01:00
*Codice:* `plm_engine/` (`draw.py` , `headers.py` , `network.py` , `address.py` , `hd.py` , `psbt_builder.py` , `electrum/` ); il caricamento della chiave cifrata resta in `app/wallet/hd.py` (stack vecchio) · *Test:* `tests/django/test_engine_package.py` (nessun import di framework), i test del motore sotto `tests/unit/` invariati