Files
plm-lottery/docs/adr/ADR-59-motore-plm-pacchetto-senza-framework-ledger-simulato.md
T
davideandClaude Sonnet 5.5 6441733160 Spec the Django migration: ADR-54..60 and docs/sito-e-app.md (WEB-01..WEB-44)
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>
2026-11-16 11:46:05 +01:00

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: ARC da aggiornare con l'implementazione.

Codice: da implementare · Test: da implementare