Files
Anubis/docs/STATE.md
T
Alby96andClaude Opus 5.5 5f0ce6b172
ci / test (postgres) (pull_request) Successful in 9m37s
ci / test (sqlite) (pull_request) Successful in 4m20s
ci / image (pull_request) Successful in 2m32s
ci / test (sqlite) (push) Successful in 4m24s
ci / test (postgres) (push) Failing after 9m18s
ci / image (push) Skipped
Record the news collection and the first judgement in the project state (refs #56 #57)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 18:57:49 +01:00

18 KiB

Stato del progetto

Aggiornato: 2026-11-14

Fase corrente

Fase 7 — Notizie: in corso. La Fase 6 è completata. La sua prova di durata di 48 ore in casa è stata interrotta più volte dal computer, mai da Anubis, e il 14 novembre l'utente ha scelto un'altra strada (ADR 0013). Ora il bot raccoglie da solo i dati per l'analisi (issue #95). L'utente fa girare la release di prova v0.7.0 pubblicata su Gitea per il tempo che vuole, poi incolla in chat il rapporto. Il controllo della prova (#55) si fa su quel rapporto. Nessuna strategia manda ordini: crypto_trend non ha superato il backtest e decide solo in osservazione, le due azionarie aspettano le chiavi di Alpaca.

Fatto

  • Specifica in docs/SPEC.md, con il nome Anubis (ADR 0001).
  • Stack:
    • C# su .NET 10 con interfaccia Blazor (ADR 0003);
    • solo i componenti autorizzati dall'utente (ADR 0004);
    • precisazioni della Fase 0 nell'ADR 0006.
  • Logo: la bilancia della pesatura del cuore (ADR 0005).
  • Lavori su Gitea, una milestone per fase (ADR 0002), elencati in docs/ROADMAP.md.
  • Fase 0:
    • Fatti della sezione 4 ricontrollati il 10/11/2026 in docs/API-NOTES.md, insieme alle versioni dei pacchetti e alle dipendenze indirette.
    • Soluzione Anubis.slnx con sette progetti:
      • src/: Anubis, Server, Guard, Desktop, Setup;
      • tests/: Anubis.Tests;
      • tools/: Anubis.Tasks.
    • Toolchain:
      • analizzatori con avvisi trattati come errori;
      • formattazione controllata;
      • versioni centralizzate, file di blocco.
    • Comandi tasks (vedi CLAUDE.md) e hook pre-commit, attivo in questa copia.
    • Test sempre attivi:
      • generatore casuale a seme fisso per i test di proprietà;
      • pacchetti ammessi;
      • nessun ANUBIS_ALLOW_LIVE=1;
      • nessun segreto nei file;
      • /health.
    • Applicazione minima con GET /health, Dockerfile e docker-compose.yml con PostgreSQL 18.
    • CI in .gitea/workflows/ci.yml: test su SQLite e PostgreSQL, poi l'immagine. Solo passi run:.
  • Fase 1 (scelte nell'ADR 0007):
    • Piattaforma: configurazione d'avvio Docker (variabili) e desktop (config.toml), cartella dei dati, identità dell'installazione con impronta del database, custodia della chiave dei segreti (DPAPI su Windows).
    • Database portabile su PostgreSQL e SQLite con ADO.NET: un solo schema con tipi per motore, migrazioni SQL numerate con salvataggio prima, esportazione e importazione tra motori con controllo di conteggi e totali (Anubis.Server db export|import), salvataggi notturni (ne tiene 14).
    • Nucleo: orologio iniettabile, bus degli eventi, pianificatore, impostazioni con registro delle modifiche, segreti cifrati AES-GCM, registri JSON con i segreti oscurati, formati italiani.
    • Accesso: password PBKDF2, sessioni, CSRF, limite ai tentativi, secondo fattore TOTP facoltativo.
    • Server: avvio a stati (configurazione, primo avvio, database assente, schema, identità, pronto), pagina d'errore con riprova automatica, API REST e WebSocket dello stato.
    • Interfaccia: guscio di menu, barra superiore e barra in basso come nei mockup, temi chiaro e scuro, Panoramica, Diario, Rischio, Impostazioni (aspetto, sicurezza, sistema); le altre voci arrivano con le loro fasi.
    • Modalità dimostrativa (tasks seed-demo) con i dati dell'appendice F, in un database a parte.
    • Immagine Docker definitiva: PUID/PGID, controllo di salute, l'applicazione non gira come root. Provata con SQLite, PostgreSQL, configurazione sbagliata e database staccato.
    • tasks screenshots per confrontare le schermate con i mockup.
    • Dopo la chiusura, con il permesso dell'utente: carattere Instrument Sans incluso nell'applicazione (ADR 0007, punto 5).
  • Fase 2 (scelte nell'ADR 0008, fatti verificati in docs/API-NOTES.md):
    • Catalogo degli strumenti e parte dati degli adapter OKX Europe (coppie in EUR, candele, prezzi, libro, WebSocket) e Alpaca (barre consolidate reali e rettificate, minuti, calendario, orologio, azioni societarie, flusso IEX).
    • Collector storico e dal vivo dentro il server: recupero dei buchi, controlli di qualità con seconda lettura immediata, freschezza dei dati, ripresa con attese crescenti.
    • Storico di ricerca in file csv.gz per anno; importatori degli archivi Binance (con controllo SHA-256) e dei CSV dell'utente (anubis data binance, anubis data csv).
    • Fonti gratuite: cambi BCE, calendario economico, date FRED e trimestrali Finnhub (con chiave facoltativa), riunioni di Fed e BCE modificabili, umore (Fear & Greed, VIX, finanziamento e open interest di OKX).
    • Azioni societarie e serie rettificate ancorate al giorno della decisione.
    • Universi azionario e crypto "a una certa data", senza ETF né fondi.
    • Rapporto di qualità dei dati (anubis data report, /api/data/quality) e sezione Dati in Impostazioni con lo stato di ogni fonte.
    • Prova sui dati reali: BTC, ETH e SOL in EUR dal 21/11/2023 (1.085 giorni ciascuna, nessun buco) e BTCUSDT di Binance dal 17/08/2017 (3.363 giorni).
  • Fase 3 (scelte nell'ADR 0009, fatti verificati in docs/API-NOTES.md):
    • Interfaccia comune dei conti (IBrokerAccount), simulatore interno (PaperBroker) e parte conti degli adapter Alpaca (paper) e OKX (demo). Nessun conto reale viene creato; gli adapter rifiutano l'ambiente reale prima di qualsiasi richiesta.
    • Gestore degli ordini: stati che vanno solo avanti, id deterministici mai rimandati due volte, limite che insegue il prezzo, al massimo sei invii al minuto con le vendite per prime.
    • Stop sul broker per ogni posizione: permanenti sulle azioni intere, giornalieri sulle frazioni, sempre allineati alla quantità; stop già superato; residui invendibili.
    • Contabilità per strategia in sola aggiunta: esecuzioni, lotti, registro della liquidità, capitale affidato in euro diviso per quote, dividendi e frazionamenti, fotografie del patrimonio ogni 5 minuti, rendimento ponderato nel tempo.
    • Riconciliazione ogni 5 minuti con modalità prudente, scelta "allinea" o "escludi", blocco delle chiavi che permettono i prelievi.
    • Schermata Conti e posizioni come il mockup, esportazione CSV delle posizioni; in Impostazioni chiavi (verificate col broker prima di salvarle) e capitale affidato; la Panoramica indica il capitale come primo passo.
    • Batteria di conformità sul simulatore e sulle risposte d'esempio della documentazione; sui conti di prova parte da sola quando ci sono le chiavi.
  • Fase 4 (scelte nell'ADR 0010):
    • Motore di backtest a eventi, una seduta alla volta: si decide sulla chiusura e si esegue all'apertura dopo, con gli stessi costi del simulatore (moltiplicabili per 2 e 3), stop, frazionamenti e dividendi, nessun prestito. Le strategie sono le stesse classi che girano dal vivo; correttivi e rischio hanno già il loro posto e fino alla Fase 5 lasciano passare tutto.
    • Metriche del rapporto (rendimento, volatilità, Sharpe, calo massimo, operazioni, esposizione, risultati per anno) e confronto con "comprare e tenere".
    • Convalide scritte in casa: finestre che avanzano, K-fold purgato combinatorio, Deflated Sharpe Ratio, PBO, regola dell'altopiano, test contro lo sguardo in avanti. DSR e PBO riproducono i casi noti.
    • Registro delle prove: il piano (con le soglie) e la sua impronta si scrivono prima dei risultati e non cambiano; il numero di prove del DSR conta tutti i tentativi della stessa strategia.
    • Laboratorio su un thread a priorità bassa, una prova alla volta, con ripresa dopo un riavvio; dati dalle barre raccolte o dallo storico di ricerca Binance.
    • Schermata Laboratorio: elenco delle prove, modulo per un nuovo test, rapporto completo, confronto tra due prove. Le sezioni "Migliorie in osservazione" e "Stime di costo da confermare" aspettano le Fasi 9 e 8.
    • Strategia d'esempio sma_cross (incrocio di medie) per provare il laboratorio; le strategie di base arrivano con la Fase 5.
  • Fase 5 (scelte nell'ADR 0011):
    • Le tre strategie di base: crypto_trend (rottura su nove periodi, stop a metà del canale, pesi a volatilità obiettivo, universo dei primi dieci del mese), equity_momentum (revisione settimanale con il filtro di SPY, pesi a volatilità inversa, stop che segue il prezzo) e equity_meanrev (RSI a 2 sopra la media a 200 sedute, rischio fisso, uscita alla chiusura). Le stesse classi girano in prova e dal vivo e passano il test contro lo sguardo in avanti.
    • Correttivi comuni (regime crypto, calendario economico), dimensionamento sulla quota del bot e motore del rischio completo: limiti di perdita per mondo, calo dal massimo con dimezzamento e interruttore, limiti di dimensione, controlli tecnici, niente vendite allo scoperto né leva. Toglie o riduce, mai aggiunge. Gira anche dentro i backtest.
    • Ogni passo di una decisione resta scritto con i suoi codici motivo (tabella decisions).
    • Stadi verso i soldi veri: osservazione, simulazione, reale ridotto, reale. Senza la procedura di 12.4 nessun ordine raggiunge un conto reale; una strategia retrocessa gestisce le uscite delle posizioni reali fino a zero; il gemello simulato resta fuori dai totali. In simulazione entra solo una strategia che ha superato il backtest.
    • Backtest onesti in docs/backtests/ con anubis backtest base: storico Binance convertito in euro con il cambio BCE, monete tolte dal listino comprese, due universi, costi doppi e tripli, comprare e tenere accanto. crypto_trend non supera (calo massimo del 32,8% contro il 25% ammesso; probabilità di sovra-adattamento 0,84 su BTC, ETH e SOL) e resta in osservazione. Le due azionarie aspettano le chiavi di Alpaca. Gli esiti sono inclusi nell'applicazione e letti a ogni avvio.
    • Schermate Operazioni (con la scheda "perché" e l'esportazione CSV), Strategie e Rischio come i mockup 03, 04 e 07; in Impostazioni limiti, protezione per le operazioni in giornata e scenari. Fermare, chiudere e ripartire passano dal motore del rischio; alzare un limite mentre una strategia usa soldi veri chiede frase e password.
  • Fase 6 (scelte nell'ADR 0012):
    • Motore dal vivo: ogni decisione passa dalla stessa chiamata del backtest (DecideOnce), agli orari di 5.5. Ogni decisione ha una chiave scritta nella stessa transazione dei suoi ordini pianificati e delle righe del diario, quindi una ripartenza non decide né manda niente due volte. Parità con il backtest provata su 40 giorni di crypto_trend e 6 settimane di equity_meanrev; 14 giorni con guasti iniettati finiscono riconciliati e senza ordini doppi.
    • Recupero dopo un'assenza (5.6): l'assenza si misura dall'ultimo lavoro finito. I lavori persi si rifanno una volta o si saltano con il motivo. Le decisioni in ritardo aggiornano solo le uscite. Un'assenza di più di un giorno resta in Panoramica finché non la vedi.
    • Processo di guardia: in Docker è il processo principale e il genitore del motore. Interviene dopo due minuti di silenzio, un avvio fermo dieci minuti o un'uscita senza preavviso. Annulla gli ordini a metà, rimette gli stop, avvisa e fa ripartire il motore. La terza ripartenza forzata in un'ora scrive il file STOP. La prova (drill) gira anche dentro l'immagine, in tasks ci e nella CI.
    • Diario con le frasi fisse dell'appendice B e confronto "senza bot" (40% BTC, 60% SPY, ogni versamento investito nel suo giorno).
    • Telegram: coda con stato, nuovi tentativi e abbandono dopo un giorno; comandi dal telefono solo dalla chat configurata e solo se recenti, /ferma con /conferma; riepilogo del mattino, stato facoltativo, segnale di vita ogni minuto. Sezione in Impostazioni.
    • Schermate Panoramica e Diario e sistema come i mockup 01, 08 e 09.
    • anubis soak: il rapporto di una prova di durata, letto dai registri del bot mentre lavora.
  • Fase 7, in corso (ADR 0013):
    • Raccolta dei dati per l'analisi (#95). Ogni 5 minuti, e a ogni avvio, il bot scrive una fotografia del processo in diagnostic_samples: memoria, GC, thread, handle, CPU, eccezioni, dimensione del database, avvisi ed errori dei registri, chiamate HTTP in uscita per destinazione con le durate. Ogni esecuzione di ogni lavoro va in job_runs. Si tiene tutto per 30 giorni.
    • Il rapporto da incollare, in Markdown fino a 60 KB e senza segreti, si ottiene in tre modi: dal pulsante «Scarica i dati per l'analisi» in Diario e sistema, da /api/diagnostica.md e da anubis diagnostics.
    • Release di prova per Windows con tasks release-win: uno zip con il server, Avvia Anubis.cmd, Prepara i dati da incollare.cmd e un LEGGIMI.txt.
    • Raccolta delle notizie (#56, ADR 0014, branch fase-7). Il lavoro "notizie" legge ogni 2 minuti le 14 fonti di SPEC 4.4. Le richieste sono condizionate e una fonte che sbaglia aspetta sempre di più, fino a un'ora. Poi:
      • i feed si leggono senza DTD né entità;
      • gli articoli doppi si tolgono per indirizzo e le riprese dello stesso fatto si raggruppano in una storia, contando le fonti indipendenti;
      • ogni storia si collega a strumenti, classi o mercato: simboli, ticker, nomi delle società e delle monete, temi.
    • Primo giudizio locale (#57, in parte): casi gravi trovati con parole chiave in inglese e in italiano, tono in cinque gradi, importanza da 1 a 4. Ogni articolo e ogni storia lo conservano. Il classificatore ONNX si aggancia dietro un'interfaccia: finché manca, il tono resta sconosciuto e il resto funziona.

In corso

Nulla.

Prossimo passo

  1. L'utente scarica lo zip della release v0.7.0 da Gitea (Release), lo fa girare e poi incolla il rapporto: doppio clic su Prepara i dati da incollare.cmd, oppure il pulsante in Diario e sistema. Il rapporto si analizza e si salva in docs/diagnostica/; da lì si chiude #55.
  2. Intanto la Fase 7 va avanti sul branch fase-7. Raccolta (#56) e parole chiave (#57) sono fatte. Restano:
    • il modello ONNX di #57: pacchetti Microsoft.ML.OnnxRuntime e Microsoft.ML.Tokenizers, modello Xenova con revisione e hash fissati;
    • l'analista facoltativo (#58);
    • lo stato per strumento (#59);
    • la schermata (#60).
  3. Con le chiavi del conto paper di Alpaca si possono anche fare i backtest azionari (anubis backtest base) e chiudere i criteri delle Fasi 2 e 3 in attesa.

Da sapere

  • Le immagini .NET 10 sono su Ubuntu 24.04, non Debian (ADR 0006).
  • La prova nel container anubis-prova è chiusa (ADR 0013). I compiti programmati che la sorvegliavano sono spenti; il container si può fermare con docker stop anubis-prova.
  • La modalità dimostrativa mostra le schermate costruite fin qui. Notizie e apprendimento appaiono solo con i dati dell'appendice F: fuori dalla demo arrivano con le Fasi 7 e 8. Nella demo il motore di trading e Telegram sono spenti.
  • In Docker il processo principale è la guardia; fuori da Docker (tasks dev, VS Code) il server gira da solo.
  • La guardia oggi apre solo i conti di prova: avrà i conti reali con la fase dei soldi veri (ADR 0012, punto 4).
  • Le chiavi dei conti di prova si inseriscono da Impostazioni → Conti e chiavi oppure nel file .env; quelle nelle variabili d'ambiente valgono di più. Una chiave OKX che permette i prelievi viene rifiutata.
  • Il capitale affidato si decide in euro in Impostazioni → Conti e chiavi. Finché non c'è, le strategie osservano soltanto.
  • tasks dev fuori da Docker usa la cartella dei dati vera dell'utente: per prove usa tasks seed-demo.
  • Alpaca non ha più conti senza margine: il divieto di leva lo impone Anubis (API-NOTES A14).
  • OKX: WebSocket sulla porta 443, la 8443 è chiusa (API-NOTES O3).
  • Le coppie in EUR di OKX esistono da novembre 2023: prima di allora la storia crypto viene dagli archivi Binance in USDT. Il Laboratorio li usa nella loro valuta (ADR 0010, punto 13); i backtest delle strategie di base li convertono in euro con il cambio BCE del giorno (ADR 0011, punto 10).
  • crypto_trend resta in osservazione perché il suo backtest non è superato. Non ho ritoccato regole o soglie dopo aver visto il risultato: una nuova versione della strategia è una nuova prova, che il DSR conterà insieme alle precedenti.
  • Il motore dal vivo fa girare ogni strategia con i parametri scritti nel suo file dell'esito (parameters), non con quelli predefiniti: sono quelli che si sono qualificati.
  • Per rifare i backtest di base: anubis backtest base --to AAAA-MM-GG --out docs/backtests (con --offline usa gli archivi già scaricati).
  • Nella modalità dimostrativa il Laboratorio è spento: mostra l'elenco ma non esegue prove.
  • I dati di mercato si spengono con ANUBIS_MARKET_DATA=off; nella modalità dimostrativa sono sempre spenti.
  • Gli universi passati usano i flag ETF e "frazionabile" di oggi: è un limite delle fonti gratuite (API-NOTES, Fase 2).
  • Gitea ha un esecutore delle Actions attivo: la CI gira a ogni push (prima esecuzione: run 169 del branch fase-0, test verdi su SQLite e PostgreSQL). tasks ci resta per provarla in locale.
  • Su questo PC Docker Desktop non partiva: erano rimasti due file di comunicazione di una sessione di ottobre, che Windows non riusciva a cancellare. Le cartelle che li contengono sono state rinominate, non cancellate: %LOCALAPPDATA%\Docker\run.stale* e %LOCALAPPDATA%\docker-secrets-engine.stale*. Si possono eliminare dopo un riavvio.

Serve dall'utente

Cosa Da quando serve Senza
Far girare la release v0.7.0 e incollare il rapporto in chat Ora, per il tempo che vuoi La prova di durata (#55) resta aperta
Chiavi del conto paper di Alpaca (ALPACA_API_KEY_DEMO, ALPACA_API_SECRET_DEMO) Già dalla Fase 2 (dati azionari) Parte azionaria spenta; storico azionario dal 2016 e backtest delle due strategie azionarie in attesa
Chiavi demo di OKX Europe, senza permesso di prelievo Fase 3 (ordini sui conti di prova) Batteria di conformità su risposte d'esempio; criterio della Fase 3 in attesa
Un token Gitea con permesso write:package come segreto REGISTRY_TOKEN Fase 9 (pubblicazione dell'immagine) Pubblicazione a mano
Token del bot Telegram e chat autorizzata (facoltativi), da Impostazioni → Telegram Fase 6 Nessun avviso sul telefono; comandi provati con un finto server
Un indirizzo per il segnale di vita (facoltativo, per esempio un controllo gratuito di Healthchecks.io) Fase 6 Nessuno avvisa se bot e guardia si spengono insieme
Chiavi FRED e Finnhub (facoltative, gratuite) Già dalla Fase 2 Calendario limitato alla settimana corrente; filtro trimestrali spento
Chiave di un modello linguistico (facoltativa) Fase 7 Solo classificatore locale
Prova del template su Unraid Fase 9 Criterio in attesa
Permesso per ogni componente esterno non elencato nell'ADR 0004 Quando serve Si scrive in casa

Le chiavi non vanno mai scritte nel repository: si mettono nel file .env locale (modello in .env.example) oppure, più avanti, dall'interfaccia.