Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.slnxcon 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(vediCLAUDE.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,Dockerfileedocker-compose.ymlcon PostgreSQL 18. - CI in
.gitea/workflows/ci.yml: test su SQLite e PostgreSQL, poi l'immagine. Solo passirun:.
- Fatti della sezione 4 ricontrollati il 10/11/2026 in
- 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 screenshotsper confrontare le schermate con i mockup.- Dopo la chiusura, con il permesso dell'utente: carattere Instrument Sans incluso nell'applicazione (ADR 0007, punto 5).
- Piattaforma: configurazione d'avvio Docker (variabili) e desktop (
- 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.gzper 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.
- Interfaccia comune dei conti (
- 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) eequity_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/conanubis 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_trendnon 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.
- Le tre strategie di base:
- 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 dicrypto_trende 6 settimane diequity_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, intasks cie 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,
/fermacon/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.
- Motore dal vivo: ogni decisione passa dalla stessa chiamata del backtest (
- 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 injob_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.mde daanubis diagnostics. - Release di prova per Windows con
tasks release-win: uno zip con il server,Avvia Anubis.cmd,Prepara i dati da incollare.cmde unLEGGIMI.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.
- Raccolta dei dati per l'analisi (#95). Ogni 5 minuti, e a ogni avvio, il bot scrive una fotografia del processo in
In corso
Nulla.
Prossimo passo
- L'utente scarica lo zip della release
v0.7.0da Gitea (Release), lo fa girare e poi incolla il rapporto: doppio clic suPrepara i dati da incollare.cmd, oppure il pulsante in Diario e sistema. Il rapporto si analizza e si salva indocs/diagnostica/; da lì si chiude #55. - 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.OnnxRuntimeeMicrosoft.ML.Tokenizers, modello Xenova con revisione e hash fissati; - l'analista facoltativo (#58);
- lo stato per strumento (#59);
- la schermata (#60).
- il modello ONNX di #57: pacchetti
- 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 condocker 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 devfuori da Docker usa la cartella dei dati vera dell'utente: per prove usatasks 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_trendresta 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--offlineusa 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 ciresta 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.