Encelado/Encelado/docs/GLOSSARY.md

Glossario

Termine	Significato in Encelado
Basket	Due posizioni (una per coppia forex) aperte insieme e chiuse insieme, trattate come una sola scommessa sul cross sintetico.
Cross sintetico	La coppia implicita nelle due gambe: X = ln A + s·ln B, con s = +1 se la valuta comune ha ruoli opposti (EURUSD/USDCHF → EURCHF) e −1 se uguali. Tutti e cinque i basket della specifica hanno s = +1.
Gamba	Una delle due posizioni del basket.
z-score	(X − media_W) / σ_W del cross sintetico su una finestra di W barre M15. Ingresso a `
ρ_W, ρ_20	Correlazione rolling dei rendimenti delle due gambe su W e su 20 barre. Attesa negativa per i basket della specifica (rho_min −0,6).
Half-life (HL)	Semiperiodo di mean reversion del cross, in barre, da un OLS di Δx su x(t−1). Ammesso fra halfLifeMinBars e halfLifeMaxBars.
Preset	Conservative / Moderate / Aggressive: z_in, rischio per basket, numero massimo di basket, TP in pip, aggiunte, z_stop.
TP di basket	Take-profit in pip, somma dei pip delle due gambe (come nell'interfaccia di riferimento).
Cost gate	Il rifiuto di un ingresso se il TP non copre almeno costMultiple volte il costo stimato (spread reale + markup + commissioni + overnight atteso), o se lo spread è più del doppio della mediana delle ultime 24 ore.
Break-even	Il costo in pip oltre il quale il P&L medio lordo di un basket diventa negativo: se è vicino a zero, il segnale non ha contenuto.
Vol-parity sizing	Le unità di ogni gamba sono inversamente proporzionali alla sua volatilità (ATR), così le due gambe contribuiscono allo stesso rischio; il rischio totale è riskPerBasketPct dell'equity alla distanza dello stop.
Leg-risk	Il rischio di restare con una sola gamba: se la seconda viene rifiutata, la prima viene chiusa subito (leg_risk_unwind); se la seconda è senza esito, il basket aspetta (PendingB) finché il registro degli ordini non sa.
Registro degli ordini	OrderTracker e il file data/state/pending_orders.json: ogni ordine inviato, scritto prima della chiamata e seguito finché il server non dice eseguito, rifiutato o annullato, o finché la posizione non compare sul conto.
PendingA / PendingB	Stati del basket con una gamba senza esito: nessun nuovo ordine, valutazione sospesa, ripresa alla risoluzione.
Orfana-bot	Una posizione sul conto aperta dal bot (registro o firma nel ledger) che non appartiene a nessun basket: adottata e chiusa.
Esterna	Una posizione sul conto senza la firma del bot: segnalata, contata, mai toccata.
Movimento di cassa	Deposito, prelievo o accredito virtuale: un salto del saldo che nessuna chiusura spiega. Escluso dal P&L, dal picco e dal drawdown.
Bonifica	La pulizia una tantum delle orfane con conferma per posizione (--bonifica).
Halted-Residuo	Lo stato del motore dopo un kill-switch che non è riuscito ad appiattire le posizioni del bot: banner con l'elenco, reset rifiutato finché restano.
Verifica di piattezza	La rilettura del conto dopo il kill-switch finché le posizioni del bot non sono sparite; niente è «chiuso» prima.
Margin guard	Sotto equity / margine usato = 1,5 niente entrate; sotto 1,2 si chiude il basket con il P&L peggiore.
sizing_bound	Quale vincolo ha deciso la size di un basket: risk, margin, leverage, units; min_exposure quando nessuna size è ammessa.
Heartbeat	data/state/heartbeat.json, scritto ogni 30 s: misura l'inattività che fa scattare il recupero.
Recupero	La procedura dopo un'inattività oltre la soglia: ordini pendenti, riconciliazione, barre perse, ogni basket aperto rivalutato (chiudi/tieni), rapporto, riscaldamento.
Lock di istanza	data/state/instance.lock, tenuto in esclusiva: un solo bot per cartella dati.
Equity stop	Chiusura di tutto e blocco a un drawdown del 9 % dal picco; riparte solo con un reset motivato.
Kill-switch	Chiusura immediata di tutto e blocco delle nuove entrate: pulsante, comando o file STOP.
Paper / Demo / Live	Simulatore locale / conto demo eToro / conto reale. Il bot opera da solo in tutte e tre (D-20).
Ledger	decisions.jsonl (ogni decisione con le sue feature) e baskets.csv (ogni basket chiuso). Append-only: le correzioni sono righe nuove.
Meta-modello	La regressione logistica (livello 1) che stima la probabilità che un basket finisca in utile. In ombra finché non supera i cancelli di attivazione.
Challenger	L'MLP (livello 2) valutato accanto al campione.
Bandit	Il campionamento di Thompson (livello 3) che propone il preset per terzile di volatilità.
Walk-forward	Valutazione in cui ogni previsione usa solo dati precedenti; per la griglia del backtest: scegli il migliore dei 6 mesi passati, applicalo al mese successivo.
PSR / DSR	Probabilistic e Deflated Sharpe Ratio: la probabilità che lo Sharpe osservato sia sopra zero, tenendo conto di asimmetria, curtosi, lunghezza e (DSR) del numero di configurazioni provate.
PBO	Probabilità di overfitting del backtest (CSCV, 16 blocchi): quante volte la configurazione migliore in-sample finisce sotto la mediana out-of-sample.
Falsificazione	I test di §9.2: ZScore contro PipDivergence, averaging on/off, con e senza stop, cost gate a 2×/3×/4×, segnale invertito. Servono a rompere il risultato, non a confermarlo.
Forward test	Il periodo in Demo con metrica, soglia e durata scritte prima (knowledge/preregistrazione.csv).
Blackout	Niente entrate 45 minuti prima e 30 dopo un evento ad alto impatto sulle valute del basket.
PSI	Population Stability Index: misura la deriva della distribuzione di una feature rispetto all'addestramento.
HAR-RV	Modello eterogeneo autoregressivo della varianza realizzata (medie a 1, 5, 22 giorni).
Run id	Identificatore della sessione del bot, scritto in ogni riga del ledger con l'hash di strategy.json.
Snapshot	La fotografia immutabile dello stato del motore (conto, basket, contatori, contesto) che il server serializza in JSON e manda alla pagina una volta al secondo. La UI non ha altro.
SSE	Server-Sent Events: la rotta /api/stream che spinge uno snapshot al secondo al browser.
Token web	ENCELADO_WEB_TOKEN: la stringa che apre l'interfaccia; senza, il server ascolta solo su localhost.
Valuta di visualizzazione	La valuta con cui la pagina mostra gli importi (ui.displayCurrency); conversione solo in presentazione con il tasso delle quotazioni, ledger sempre in USD.
Modalità campione	--sample: il server serve uno snapshot finto e non avvia il motore; per lavorare sulle pagine e fotografarle.
Navigation rail	La colonna di navigazione a sinistra (Dashboard, Storico ordini, Log, Impostazioni), 80 o 256 px.