• v5.1.0 b033896ebb

    Alby96 released this 2026-10-01 19:11:33 +02:00 | 1 commits to main since this release

    Le richieste dell'utente (Modifiche.txt del 2026-09-30), poi una revisione completa del codice con le correzioni. Versione di sviluppo 5.1.0 (Directory.Build.props, D-50); 561 test verdi, compilazione senza avvisi. Le scelte fatte senza risposta sono in docs/QUESTIONS.md (D-38…D-58, in attesa di conferma); le decisioni in ADR-0010…ADR-0014.

    Le richieste

    • Solo la password nel container (ADR-0010): l'unica variabile è ENCELADO_PASSWORD («Password interfaccia» nel template Unraid; ENCELADO_WEB_TOKEN resta come alias deprecato). Conto, chiavi eToro dei due conti, Telegram, valuta, log, avvio automatico e strategia si impostano dalla pagina. Le chiavi e il token Telegram vivono in /config/secrets.enc, cifrati con la password (AES-256-GCM, PBKDF2 600 000 iterazioni); se la password cambia, i segreti si sbloccano con quella precedente o si ricomincia. Il cookie di sessione è un HMAC della password e di un segreto del server (/config/session.key), mai la password; POST /logout. Al primo avvio le variabili di un container 5.0 vengono importate una volta (import-5.1.json) e poi ignorate ed elencate; il caricatore non legge più l'ambiente. run.autostart al posto di ENCELADO_AUTOSTART; template, compose e Dockerfile senza PUID/PGID/TZ.
    • Paper eliminata: il conto demo di eToro è il simulatore. Le modalità sono Demo e Live e scelgono anche il conto (etoro.environment non esiste più): chiuso il buco per cui Demo + ambiente real mandava ordini sul conto reale senza il cancello del Live. Il Live chiede run.allowLive e la frase CONFERMO LIVE scritta nell'interfaccia a ogni avvio, non parte mai da solo (allarme e avviso Telegram) e non ha più ENCELADO_CONFIRM_LIVE né --confirm-live. Il cambio Demo ↔ Live è rifiutato finché il conto non è piatto.
    • Orologi con le bandiere (D-49): uno per fuso delle valute trattate (Nuova Zelanda, Australia, Europa centrale/Svizzera, USA/Canada), più quello del computer solo se diverso; UTC nei tooltip.
    • Log: il livello è un'etichetta colorata e ogni messaggio sta su una riga (gli a capo diventano « ⏎ »); le parole del ledger sono in italiano (labels.js), il codice nel tooltip.
    • Pagina Apprendimento (/api/learning): dataset, criteri di attivazione, pesi imparati e contributi, bandit 3×3 con gli intervalli di credibilità, ultimo ciclo con la valutazione completa, AUC mobile, calibrazione, proposte, registro, file, intuizioni. «Esegui ciclo» in ogni stato: il ciclo gira in background con un solo scrittore dei file (ADR-0014; nella 5.0 il ciclo dalla pagina era un secondo scrittore dei modelli e il settimanale fermava il thread di decisione).
    • Nuova interfaccia in stile Mimante (ADR-0013): dashboard compatta che riassume tutto in una schermata (9 tessere, basket, eventi, quotazioni, registro) e nove pagine di dettaglio (Basket, Posizioni, Mercato, Storico, Apprendimento, Log, Sistema, Impostazioni); lo stato di Telegram e il dettaglio del collegamento eToro passano in Sistema. Moduli ES vanilla, nessuna libreria, tema scuro e chiaro.
    • Layout fluido: niente larghezza massima, niente fascia grigia a destra; tabelle che cedono colonne e scorrono nel loro pannello, mai la pagina; provata da 420 a 2560 px.
    • Controlli allineati: barre strumenti su una riga, tutti i controlli alti 30 px (anche «Segui» del Log, ora una levetta allineata al filtro e alla ricerca).
    • Niente valuta nella barra in alto: si sceglie in Impostazioni ▸ Interfaccia.
    • Impostazioni applicate a caldo: ogni campo dice quando vale (⚡ subito, ⚙ nel motore in esecuzione, ↻ con un riavvio automatico del motore che non chiude i basket) e la risposta lo dice campo per campo; tutta la strategia, il rischio, il recupero e l'apprendimento sono nel form (Avanzate chiuso).
    • Preset fisso: si sceglie in Impostazioni ▸ Strategia ed è parte della strategia; il comando per cambiarlo a caldo è tolto ovunque (web, console, Telegram). Un cambio vale per i basket nuovi: quelli aperti tengono z di stop, aggiunte, TP, perdita massima e preset con cui sono entrati.
    • Stato fuori dal menu: le scritte «in esecuzione» e «demo» in fondo al menu diventano la pill del motore nella barra in alto (pallino colorato per lo stato, DEMO/LIVE per il conto).
    • «P&L oggi» corretto (ADR-0011): il vecchio numero (circa 47 000 USD su 139 000 di equity) sommava i proceeds delle chiusure, cioè margine restituito più profitto. Sul conto demo, dal 23 al 30 settembre, il bot ha chiuso 102 posizioni con un risultato netto di −269,42 USD, mentre la somma registrata superava i 903 000 USD; il 24/9 sei chiusure da +48,34 USD di netto contavano come circa 53 900. Ora il realizzato di ogni posizione è quello dello storico di eToro (netProfit − fees, per positionId), lo stesso della pagina Storico; «P&L oggi» è il realizzato delle posizioni del bot chiuse oggi (UTC), con le stime provvisorie segnate «stima» e «—» quando non è noto; accanto c'è la variazione dell'equity netta da mezzanotte. Le righe di baskets.csv aspettano lo storico in una coda persistente (dopo 30 minuti la stima, che non addestra). La perdita giornaliera, che con i proceeds non scattava mai dopo la prima chiusura del giorno, guarda l'equity netta dalla mezzanotte. Il passato è corretto con righe nuove: all'avvio una verifica idempotente scrive righe correzione (pnl_realizzato) per le righe della 4.0.0-5.0.0, lastNOutcomes è neutralizzata prima della correzione, i modelli addestrati sui proceeds vengono messi da parte e la logistica riaddestrata, il bandit riparte dal prior.
    • Interfaccia leggera (ADR-0012): il motore pubblica viste immutabili e il server costruisce un solo tick al secondo per tutti i browser (niente se nessuno guarda), con le righe di log nuove e le versioni delle sezioni; le parti pesanti si leggono a richiesta con ETag; il browser aggiorna cella per cella solo la pagina visibile. Circa 64 ms di lavoro ogni 10 s sulla dashboard, tick da ~40 KB a pochi KB. Calendario e notizie si scaricano in background, anche a motore fermo.
    • --sample serve dati d'esempio coerenti per ogni rotta; /api/info diventa un alias di /api/system, /api/research è assorbita da /api/learning; screenshot rifatti (docs/img/, 11 pagine più il tema chiaro e il telefono).

    Correzioni della revisione

    Una revisione del codice della 5.1 ha trovato 51 problemi; quelli confermati sono corretti, ciascuno con un test che fallisce senza la correzione.

    • Ciclo di vita del motore: un solo lucchetto per avvio, arresto, riavvii automatici e ciclo di apprendimento a motore fermo; FERMA durante un avvio aspetta il motore e lo ferma (prima restava un motore che operava irraggiungibile); un riavvio automatico non annulla più un FERMA arrivato prima; AVVIA subito dopo FERMA aspetta che il motore precedente lasci la cartella dati. Un kill-switch, una chiusura o la chiusura dei residui in corso non vengono mai interrotti da FERMA o da un salvataggio (409); solo docker stop li interrompe dopo 30 s, registrando il residuo. Ogni comando riceve una risposta («comando interrotto: il motore si è fermato», 504 con un messaggio per un'attesa scaduta, mai 500). La chiusura all'arresto (closeOnShutdown) è un comando sul thread di decisione, che prima blocca le entrate. «Esegui ciclo» risponde 409 finché il ciclo di decisione non è partito. Lo stream non tiene più un iscritto il cui primo tick fallisce. L'heartbeat pubblica il suo intervallo e /api/health usa 3 × intervallo + 15 s.
    • Conti: lo stato del motore è per conto (baskets_state.demo.json, baskets_state.live.json, D-53): passare da un conto all'altro non sovrascrive più chiusure in attesa del P&L, equity stop, kill-switch, residuo, pausa e picco dell'altro. Il registro degli ordini resta unico ma ogni motore tocca solo i suoi. La guardia del cambio di conto è un comando sul thread di decisione (prima leggeva la vista, piatta a metà di un ingresso), con un nuovo controllo dopo l'arresto e l'annullamento del salvataggio se il conto non è piatto. All'avvio il saldo si giudica solo quando lo storico mostra ogni chiusura: una perdita non ancora nello storico non diventa più un prelievo.
    • Soldi: la perdita giornaliera, raggiunta, blocca fino alle 00:00 UTC anche se l'equity recupera (D-52), nel motore e nel backtest, anche dopo un riavvio (prima il blocco cadeva appena l'equity risaliva, mentre l'interfaccia prometteva «fino a domani»); un calo del saldo che lo storico non spiega ancora sospende senza bloccare la giornata (D-54). Una posizione finisce in baskets.csv una volta sola (prima una chiusura vista da due percorsi poteva raddoppiare il P&L dei riepiloghi). La verifica del realizzato ha una soglia per conto (prima le righe Live restavano con i proceeds e li insegnavano ai modelli). Le gambe singole della 4.0-5.0 si abbinano alla loro nota senza indovinare. La riga di un'aggiunta richiusa non trasforma più le gambe del basket in orfane. La cache dello Storico rispetta il periodo chiesto («anno» e «tutto» non escono più calcolati su 90 giorni). La riga di baskets.csv e il premio del bandit nominano il preset con cui il basket è entrato. Il kill-switch fa ciò che sceglie l'operatore nel dialogo (prima chiudeva le esterne anche con la casella spenta, se l'impostazione era accesa) (D-55).
    • Segreti e web: un file 5.0 con Live e ambiente demo resta sul conto demo dopo un salvataggio qualsiasi (prima diventava Live, scavalcando guardia, chiavi e frase). Una password errata costa un'attesa anche via Bearer, per indirizzo e fino a 30 s, e durante l'attesa non si controlla niente (D-56). Le richieste da altri siti sono rifiutate (Content-Type: application/json obbligatorio sotto /api/, controllo di Origin e Sec-Fetch-Site, Host locale senza password). --sample lavora in cartelle temporanee e non tocca più segreti, configurazione o il bot Telegram dell'operatore. La rete si apre solo nel container o con --listen-all (D-57). Il tick porta statusLines (le righe della striscia della dashboard, prima salvate e mai lette). L'importazione segue l'ordine delle chiavi della 5.0; un secrets.enc con un numero di iterazioni assurdo è danneggiato, non un avvio fermo per minuti; run-docker non stampa più la password; la pagina Apprendimento a motore fermo segue subito le modifiche di strategy.json.
    • Apprendimento: i contributi mostrati spiegano sempre la p_ML accanto (vengono dal modello che l'ha data, salvati con l'ingresso; dopo un riavvio un basket aperto riprende la sua p); il ritiro dei modelli è tutto o niente e non si ripete; dopo la verifica del realizzato la sessione rilegge esiti e conteggio dal ledger corretto; i basket etichettati sono contati come li conta il dataset ovunque; a motore fermo la pagina segue subito le correzioni e tiene l'ultima lettura buona di un file illeggibile; un braccio del bandit mai provato non è mai «il migliore».
    • Interfaccia: impostazioni salvabili dopo due modifiche allo stesso campo; gli stati di un basket spento non sono più nascosti; filtri ricordati sempre visibili; quotazioni del Mercato che seguono il tick; «—» invece di 0 per i valori sconosciuti; fuoco su «Annulla» nelle conferme distruttive (un Invio tenuto premuto non esegue più un kill-switch); Content-Type: application/json su ogni POST e DELETE.
    • Ledger: la rotazione mensile delle decisioni va solo in avanti e non sovrascrive mai un file già ruotato (l'ultima barra del mese valutata dopo la mezzanotte faceva ruotare all'indietro e perdeva una riga).

    Correzioni della seconda revisione (2026-10-01)

    Una seconda verifica indipendente delle correzioni ha trovato nove punti rimasti aperti; ciascuno ha un test che lo riproduce.

    • Stato della 5.0 al conto giusto: il mode di baskets_state.json della 5.0 era la modalità, non il conto. Un file Live scritto con etoro.environment demo finiva nel file del conto reale, e al primo Live il saldo del demo diventava un «prelievo» di oltre 100 000 USD, con equity stop e perdita giornaliera misurati sulla cifra sbagliata; un file Paper riprendeva basket simulati sul conto demo. Ora l'importazione registra su che conto operava la 5.0 (legacyState in import-5.1.json) e il file va lì; Paper, o una modalità diversa, non vengono ripresi.
    • Comandi critici fino alla fine: un kill-switch, una chiusura o la chiusura dei residui tengono fermi FERMA e i riavvii finché il motore li ha in mano, non finché chi li ha chiesti aspetta: chiudere la scheda, una risposta 504 dopo 120 s o Telegram spento a metà /kill non liberano più FERMA a metà kill-switch.
    • Chiavi salvate mentre il conto cambia: dopo la verifica (fino a 25 s) si rilegge il conto in uso; chiavi che non sono più del conto del motore non lo riavviano, e un motore Live non viene mai riavviato senza la frase (prima restava fermo, con i basket reali sui soli stop nativi).
    • Guardia del cambio di conto: il motore riconcilia con il conto prima di contare, così una gamba rimasta sola (richiusura rifiutata) conta come orfana invece di restare sul conto lasciato; posizioni non lette: cambio rifiutato.
    • Perdita giornaliera con lo storico in ritardo: un calo del saldo non ancora spiegato sospende le entrate fino alla spiegazione anche se l'equity recupera (prima tornavano permesse), e la lettura che lo spiega blocca la giornata se, al minimo toccato nel frattempo, la perdita di trading superava la soglia (prima non la bloccava mai); un movimento di cassa non la blocca. Il cruscotto mostra la sospensione per tutto il tempo.
    • Apprendimento, il secondo conto: le righe della 4.0-5.0 dell'altro conto si correggono quando quel conto gira; quell'avvio ora neutralizza di nuovo lastNOutcomes fino ad allora e rifà la logistica sulle etichette corrette (prima restavano l'etichetta sbagliata nel modello e una feature sbagliata, non mascherata, nelle righe della sessione intermedia).
    • Pagina Apprendimento a motore fermo: un file mai letto bene resta «valori iniziali» anche alle letture successive (prima diventava «l'ultima lettura buona» mostrando il prior); lo stesso per last_cycle.json.
    • Accesso: il cookie di sessione contiene un segreto del server (/config/session.key, D-56 aggiornata), quindi non è più un tentativo di password: una scheda rimasta aperta dopo un cambio di password non tiene più fuori la password giusta (prima 429 finché restava aperta), una pagina già entrata non viene fermata da chi tenta password dallo stesso indirizzo né gli azzera il conto, e l'interfaccia torna alla pagina di accesso a un 401 o 429. Serve un nuovo accesso dopo l'aggiornamento. La risposta a una password errata arriva solo a attesa davvero finita (un nuovo tentativo immediato riceveva ancora 429).
    • Test: il preset d'ingresso è verificato dall'esecutore alla posizione e nello stato salvato (togliere una delle due righe non faceva fallire nessun test).

    Da sapere (aggiornamento dalla 5.0)

    1. Al primo avvio della 5.1 tieni le variabili della 5.0 (anche ENCELADO_KEY_PASSPHRASE se le chiavi erano in etoro.keys.enc): vengono importate una volta. Rinomina ENCELADO_WEB_TOKEN in ENCELADO_PASSWORD con lo stesso valore, così i segreti restano leggibili. Poi togli dal container tutte le altre variabili (la striscia degli allarmi e Sistema ▸ Segreti le elencano). Passo per passo in deploy/unraid/README.md.
    2. Con una password diversa i segreti risultano bloccati: Impostazioni ▸ Conto ▸ «Sblocca con la password precedente», o «Ricomincia» e reinserisci chiavi e token.
    3. Il primo avvio sposta lo stato nel file del conto su cui operava la 5.0 (baskets_state.json resta come .migrato; lo stato di Paper non viene ripreso), corregge il realizzato della 4.0.0-5.0.0 con righe nuove e ritira una volta i modelli addestrati sui proceeds: poi premi Esegui ciclo e segna respinta in knowledge/proposals.csv le proposte nate dalle etichette sbagliate.
    4. I messaggi Telegram e i log già inviati dalla 4.0.0 alla 5.0.0 con il «netto» e il «P&L oggi» sbagliati restano come sono: il ledger è corretto, la cronologia no.
    5. In Live il motore non riparte più da solo dopo un riavvio: AVVIA e CONFERMO LIVE, ogni volta.
    6. Gli script che chiamano l'API devono mandare Content-Type: application/json su ogni POST e DELETE; dietro un reverse proxy il proxy deve passare l'Host originale (docs/DOCKER.md).
    7. Il preset si cambia solo da Impostazioni ▸ Strategia; il comando preset (console, web) non esiste più.
    8. Dopo l'aggiornamento serve un nuovo accesso alla pagina (il cookie contiene ora un segreto del server, /config/session.key; cancellarlo chiude tutte le sessioni).

    Immagine: 192.168.30.23:3000/alby96/encelado:5.1.0 (anche :latest). Template Unraid allegato.

    Downloads