Files
plm-lottery/docs/adr/ADR-59-motore-plm-pacchetto-senza-framework-ledger-simulato.md
T

40 lines
2.0 KiB
Markdown
Raw Normal View History

# 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.
*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