Files
plm-lottery/docs/adr/ADR-59-motore-plm-pacchetto-senza-framework-ledger-simulato.md
T
davideandClaude Sonnet 5.5 3ee60a23da B1: plm_engine takes the modules without a database (ADR-59)
HD derivation (pure part), PSBT builder, Electrum client/merkle/quorum/scripthash, network
profile, addresses and header checks move to plm_engine; the old stack imports them from
there. A test forbids framework imports in the package.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-16 15:31:47 +01:00

2.0 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: 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