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>
41 lines
2.0 KiB
Markdown
41 lines
2.0 KiB
Markdown
# 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
|