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>
41 lines
1.7 KiB
Markdown
41 lines
1.7 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:* da implementare · *Test:* da implementare
|