Files
Anubis/docs/STATE.md
T
Alby96andClaude Opus 5.5 f59eee8632
ci / test (postgres) (pull_request) Successful in 8m29s
ci / test (sqlite) (pull_request) Successful in 4m18s
ci / image (pull_request) Successful in 1m25s
ci / test (postgres) (push) Successful in 7m25s
ci / test (sqlite) (push) Successful in 4m6s
ci / image (push) Successful in 1m32s
Restart the 48-hour run after the PC switched off (refs #53 #55)
The first attempt ran 22 hours: on 12 November at 19:49 the PC switched
off without a clean shutdown (power or a machine hang, no bug check).
When it came back the bot resumed by itself and wrote the absence in
the diary, but a 48-hour run needs no gaps, so it started again from
zero at 21:02. STATE gives the new window and command; the first
attempt's report and database are kept under artifacts/prova-48h.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 21:03:56 +01:00

17 KiB

Stato del progetto

Aggiornato: 2026-11-11

Fase corrente

Fase 6 — Motore dal vivo in simulazione: completata. La prova di durata di 48 ore è partita a fine fase sull'immagine Docker di questo PC (solo crypto, senza chiavi). Il primo tentativo, partito l'11 novembre alle 21:44, si è interrotto dopo 22 ore: il PC si è spento di colpo il 12 alle 19:49 (corrente o blocco della macchina, non Anubis). Alla riaccensione il bot ha ripreso da solo e ha scritto l'assenza nel diario. La prova è ripartita da zero il 12 novembre 2026 alle 21:02 (ora italiana); il suo rapporto si controlla come primo passo della Fase 7 (Notizie), da iniziare con il via dell'utente. 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.

In corso

Nulla.

Prossimo passo

  1. Controllare il rapporto della prova di durata, da sabato 14 novembre dopo le 21:05 (ora italiana). La finestra comprende la chiusura della seduta USA di giovedì e quella intera di venerdì. Il container è anubis-prova, l'ora di partenza è in artifacts/prova-48h/inizio.txt; il rapporto del primo tentativo, con il suo database, è in artifacts/prova-48h/primo-tratto/: docker exec -u 99:100 -e HOME=/tmp anubis-prova dotnet /app/Anubis.Server.dll soak --from 2026-11-12T20:02:55Z --hours 48 --platform docker --out /tmp/prova.md poi docker cp anubis-prova:/tmp/prova.md docs/prova-di-durata-fase-6.md (issue #55).
  2. Poi la Fase 7, notizie. 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 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
Via libera per la Fase 7 Subito Non si parte
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.