Files
Anubis/docs/ROADMAP.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

27 KiB
Raw Blame History

Roadmap

Le fasi della sezione 17 di docs/SPEC.md, con i lavori su Gitea e i criteri di accettazione. Ogni fase è una milestone e ha una issue di chiusura con l'elenco dei criteri.

Come si aggiorna: quando un lavoro è chiuso su Gitea si spunta qui; un criterio si spunta solo con la prova mostrata (SPEC 2.3). Un criterio che dipende solo dall'utente si segna in attesa dell'utente e non tiene aperta la fase. Se questo file e Gitea divergono, vale Gitea e si corregge questo file (ADR 0002).

Fase Titolo Stato
0 Preparazione Completata
1 Fondamenta Completata
2 Dati di mercato Completata (azioni in attesa delle chiavi Alpaca)
3 Conti, ordini, contabilità Completata (conti di prova in attesa delle chiavi)
4 Backtest e laboratorio Completata
5 Strategie, portafoglio, rischio Completata (crypto_trend non superato, azionarie in attesa delle chiavi Alpaca)
6 Motore dal vivo in simulazione Completata (prova di 48 ore in corso)
7 Notizie Da fare
8 Apprendimento Da fare
9 Rifinitura e consegna in Docker Da fare
10 Applicazione desktop Da fare

Sezioni da leggere in ogni fase, oltre a 2, 16 e 19 e all'ADR 0003 (stack C#), che valgono sempre: indicate sotto il titolo.

Fase 0 — Preparazione

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/27 · Sezioni: 1, 4, 5.1, 15.5

Un progetto vuoto ma completo di toolchain, con i fatti sulle API ricontrollati.

Lavori

  • #1 Ricontrollare i fatti sulle API e scrivere API-NOTES.md
  • #2 Struttura del repository e file di memoria del progetto
  • #3 Toolchain .NET: analizzatori, MSTest, controllo dei pacchetti, comandi tasks
  • #4 Applicazione minima con /health, Dockerfile minimo e docker-compose con PostgreSQL
  • #5 Scheletro della CI su Gitea Actions (backend su SQLite e PostgreSQL)
  • #6 Chiusura della fase, revisione indipendente e tag fase-0

Criteri di accettazione

  • tasks check passa su una soluzione vuota ma completa di toolchain
  • docker compose up avvia l'applicazione minima, che risponde su /health
  • docs/API-NOTES.md elenca per ogni fatto della sezione 4 "confermato", "cambiato" o "non verificabile"
  • docs/STATE.md dice quali chiavi serviranno e da quale fase (paper Alpaca dalla Fase 2, demo OKX dalla Fase 3)

Fase 1 — Fondamenta

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/28 · Sezioni: 5, 13.1–13.5, 15.1, 15.2, 15.4, 15.6, appendici C e F

Le basi su cui si appoggia tutto: piattaforma, database, sicurezza, guscio dell'interfaccia.

Lavori

  • #7 Strato di piattaforma: configurazione d'avvio Docker e desktop, cartella dei dati, identità dell'installazione
  • #8 Database portabile PostgreSQL/SQLite: tipi, accesso ADO.NET, migrazioni SQL
  • #9 Esportazione e importazione indipendenti dal motore; salvataggi notturni e prima delle migrazioni
  • #10 Nucleo: orologio iniettabile, bus degli eventi, pianificatore, impostazioni, segreti, registri strutturati
  • #11 Accesso e sicurezza: PBKDF2, sessioni, CSRF, limite tentativi, TOTP
  • #12 Scheletro delle API REST e del WebSocket
  • #13 Guscio dell'interfaccia: menu, barra superiore, temi, token grafici, formati italiani
  • #14 Schermate di servizio: accesso, primo avvio (Docker e desktop), pagina d'errore del database, prima parte di Impostazioni
  • #15 Modalità dimostrativa con i dati dell'appendice F (tasks seed-demo)
  • #16 Dockerfile definitivo con entrypoint (PUID/PGID, cartella dati, healthcheck)
  • #17 Chiusura della fase, revisione indipendente e tag fase-1

Criteri di accettazione

  • Accesso funzionante
  • Il guscio corrisponde ai mockup per menu e barra superiore a 1440 px e per barra superiore e barra in basso a 390 px (screenshot allegati)
  • I formati numerici superano i test
  • L'immagine si costruisce e parte con ANUBIS_DB_ENGINE=sqlite e con postgres
  • Con una configurazione mancante o sbagliata compare la pagina d'errore e non nasce alcun altro database
  • Staccando il database compare la pagina d'errore e al ritorno l'applicazione riprende da sola
  • La stessa batteria di test passa su entrambi i motori
  • Un archivio esportato da un motore e importato nell'altro dà gli stessi conteggi
  • Con la configurazione desktop il server parte da una cartella dei dati vuota e la chiave dei segreti non finisce in config.toml
  • La modalità dimostrativa non tocca il database configurato (test)

Fase 2 — Dati di mercato

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/29 · Sezioni: 4, 5.3, 6, 10.4

Storico e dati dal vivo affidabili, controllati e senza sguardi in avanti.

Lavori

  • #18 Catalogo degli strumenti e parte dati dell'adapter OKX Europe
  • #19 Parte dati dell'adapter Alpaca (piano gratuito)
  • #20 Collector storico e dal vivo, recupero dei buchi, controlli di qualità, freschezza
  • #21 Importatori: archivi Binance e CSV dell'utente verso lo storico di ricerca
  • #22 Calendari e cambi: calendario di borsa, EUR/USD BCE, calendario economico, trimestrali, umore
  • #23 Azioni societarie e serie rettificate ancorate al giorno della decisione
  • #24 Universi "a una certa data" con esclusione degli ETF
  • #25 Chiusura della fase, revisione indipendente e tag fase-2

Criteri di accettazione

  • Storico giornaliero delle crypto dall'inizio disponibile (coppie in EUR di OKX, più gli archivi Binance dal 2017) e delle azioni dal 2016 — crypto fatto (BTC, ETH e SOL in EUR dal 21/11/2023, BTCUSDT dal 17/08/2017); azioni in attesa dell'utente (chiavi del conto di prova Alpaca)
  • Senza chiavi Alpaca la parte azionaria si prova su dati sintetici e risposte d'esempio, e il criterio resta in attesa dell'utente
  • Un test stacca il flusso per 10 minuti e verifica che il buco venga recuperato
  • Rapporto di qualità dei dati
  • L'elenco dell'universo azionario a tre date passate non contiene ETF

Fase 3 — Conti, ordini, contabilità

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/30 · Sezioni: 4.1, 4.2, 5.3, 6, 7, 13.1–13.6

Ordini sicuri e ogni euro tracciato.

Lavori

  • #26 Conti e ordini nell'interfaccia BrokerAdapter e simulatore interno (PaperBroker)
  • #27 OMS: macchina a stati, identificativi deterministici, limite che insegue, ritmo degli invii
  • #28 Stop di protezione: stop sul broker, stop che seguono la quantità, stop già superato, residui invendibili
  • #29 Ambienti, capitale affidato e contabilità: registro, lotti, patrimonio, rendimento corretto
  • #30 Riconciliazione con i conti e modalità prudente
  • #31 Adapter Alpaca (paper) e OKX (demo) e batteria di conformità live_demo
  • #32 Schermata Conti e posizioni; conti in Impostazioni e nel primo avvio
  • #33 Chiusura della fase, revisione indipendente e tag fase-3

Criteri di accettazione

  • I test di proprietà contabili passano (RandomFillsNeverBreakTheBooks: esecuzioni casuali a seme fisso, registro, lotti e liquidità sempre in pari)
  • La batteria di conformità passa sul simulatore e, se le chiavi demo ci sono, sui due conti di prova (altrimenti su risposte d'esempio, criterio in attesa dell'utente) — simulatore e risposte d'esempio fatti (PaperBrokerConformance, AlpacaDocConformance, OkxDocConformance); conti di prova in attesa dell'utente (AlpacaPaperConformance, OkxDemoConformance)
  • I test con guasti di questa parte passano (risposta persa e mai rimandata, esecuzioni doppie, broker che non risponde, stop scattato senza avviso, differenze non spiegate: OrderManagerTests, ReconcilerTests)
  • Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop (RealAccountsAreRefusedWithoutTheStartupConsent, BrokerAdaptersRefuseARealAccountBeforeAnyRequest)
  • La schermata Conti e posizioni corrisponde al mockup (TheDemoShowsTheFiguresOfTheMockup e screenshot a 1440 e 390 px, chiaro e scuro)

Fase 4 — Backtest e laboratorio

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/31 · Sezioni: 5.3, 8.7, 12.1, 12.2, 13.1–13.4

Un motore di prova onesto, riproducibile e protetto dall'auto-inganno.

Lavori

  • #34 Motore di backtest a eventi, modelli di costo e metriche
  • #35 Convalide: finestre che avanzano, K-fold purgato combinatorio, DSR, PBO; registro delle prove
  • #36 Rapporto di backtest e schermata Laboratorio
  • #37 Chiusura della fase, revisione indipendente e tag fase-4

Criteri di accettazione

  • Una strategia giocattolo con risultato noto dà esattamente il risultato atteso (AToyStrategyGivesExactlyTheResultComputedByHand, TheMetricsOfTheToyRunAreThoseComputedByHand: patrimonio, commissioni ed esecuzioni calcolati a mano, al centesimo)
  • Il test anti-sguardo-avanti esiste e fallisce su una strategia volutamente scorretta (TheLookAheadTestCatchesAStrategyThatReadsTomorrow)
  • DSR e PBO riproducono i casi noti di 12.2 (TheDeflatedSharpeRatioReproducesTheExampleOfTheArticle: DSR 0,9004 dell'articolo; PBO circa 0,5 sul rumore, 0 con una variante dominante, 1 quando la migliore perde sempre fuori campione)
  • Il rapporto si apre dall'interfaccia (TheReportOpensFromTheLaboratory: test pianificato dal modulo, eseguito, rapporto e confronto aperti)

Fase 5 — Strategie, portafoglio, rischio

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/32 · Sezioni: 7.1, 7.5, 8, 9, 12, 13.1–13.6

Le tre strategie di base dentro un motore del rischio che nessuno può aggirare.

Lavori

  • #38 Strategia crypto_trend
  • #39 Strategia equity_momentum
  • #40 Strategia equity_meanrev
  • #41 Correttivi comuni, ripartizione del capitale e dimensionamento
  • #42 Motore del rischio completo con interruttore d'emergenza
  • #43 Stadi delle strategie, requisiti, gemello simulato, sola uscita e conferma per i soldi veri
  • #44 Backtest onesti delle tre strategie in docs/backtests/
  • #45 Schermate Strategie, Rischio e Operazioni con la scheda "perché"; Impostazioni su strategie, limiti e scenari
  • #46 Chiusura della fase, revisione indipendente e tag fase-5

Criteri di accettazione

  • Ogni regola di 9.1 e 9.2 ha il suo test (RiskTests e RiskEngineTests: perdita del giorno, della settimana, calo dal massimo a 10 e 15%, capitale investito, posizione singola, quota crypto, rischio della singola operazione, controlli tecnici, niente vendite allo scoperto, protezione per le operazioni in giornata, avviso all'80%, ordini al minuto, file STOP; più NoRuleEverEnlargesWhatTheStrategyAsked e AfterALossNoPurchaseIsLarger come test di proprietà)
  • Un test dimostra che senza la procedura di 12.4 nessun ordine raggiunge un conto reale (NoOrderReachesARealAccountWithoutTheProcedure)
  • Un test dimostra che una strategia retrocessa continua a gestire uscite e stop delle sue posizioni reali fino a zero (ADemotedStrategyKeepsManagingItsRealPositionsDownToZero)
  • Per ciascuna strategia un rapporto di backtest onesto in docs/backtests/ (costi doppi e tripli, confronto con comprare e tenere), qualunque sia l'esito, più il file versionato con l'esito per il primo avvio — crypto_trend non superato (calo del 32,8% sull'universo largo, PBO 0,84 su BTC, ETH e SOL): resta in osservazione (ADR 0011, punto 13). EveryBaseStrategyHasItsOutcomeFileBuiltIn, TheProtocolRunsBothUniversesAndWritesTheReportWhateverTheOutcome
  • Senza chiavi Alpaca i backtest azionari restano in attesa dell'utente e le due strategie azionarie restano in osservazione (AtTheFirstStartTheStockStrategiesWaitInObservationAndCryptoFollowsItsOutcome; i due rapporti azionari dicono cosa manca)
  • I test anti-sguardo-avanti passano (CryptoTrendDoesNotLookAhead, EquityMomentumDoesNotLookAhead, EquityMeanrevDoesNotLookAhead)
  • Le schermate Strategie, Rischio e Operazioni corrispondono ai mockup (TheDemoShowsTradesStrategiesAndRiskAsInTheMockups e confronto a 1440 e 375 px con i mockup 03, 04 e 07)

Fase 6 — Motore dal vivo in simulazione

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/33 · Sezioni: 5.5, 5.6, 7.4, 9.3, 9.4, 13, 14

Il bot che lavora da solo, in simulazione, giorno e notte, e lo racconta.

Lavori

  • #47 Orchestrazione della giornata (5.5) e motore dal vivo in simulazione
  • #48 Processo di guardia, avvio e ripartenza sicuri
  • #49 Recupero dopo un'assenza (5.6)
  • #50 Diario con frasi in italiano dai codici motivo e confronto "senza bot"
  • #51 Schermate Panoramica e Diario e sistema
  • #52 Telegram e segnale di vita
  • #53 Prova di durata di 48 ore in tempo reale
  • #54 Chiusura della fase, revisione indipendente e tag fase-6

Criteri di accettazione

  • Il test di parità tra backtest e motore in simulazione passa, con correttivi e rischio attivi (TheLiveEngineMakesTheSameTradesAsTheBacktest su 40 giorni di crypto_trend, TheStockSideMakesTheSameTradesAsTheBacktest su 6 settimane di equity_meanrev)
  • Una prova accelerata con orologio simulato copre almeno 10 giorni di mercato con guasti iniettati e termina con registro e conti riconciliati e senza ordini duplicati (TenDaysWithFaultsEndReconciledWithoutDuplicateOrders: 14 giorni con rete giù, risposta persa, ripartenza con un ordine a metà e database irraggiungibile, su SQLite e PostgreSQL)
  • Un test blocca il ciclo principale con una vendita a metà e verifica che dopo la guardia la posizione abbia di nuovo i suoi stop e il motore sia ripartito; la stessa prova passa dentro l'immagine Docker (ALoopBlockedWithASaleHalfwayGetsItsStopBackAndTheEngineRestarts, TheGuardDrillPassesWithTheRealEngineAsChildProcess; docker run --rm <immagine> drill in tasks ci e nella CI: 7 controlli su 7)
  • Un test con orologio simulato spegne il bot per 3 ore, 20 ore e 3 giorni e verifica le righe di 5.6 i cui lavori esistono (ThreeHoursOffRecoverTheCryptoDecisionAndDropAnEntryThatMovedTooFar, TwentyHoursOffLetTheLateDecisionsUpdateOnlyExitsAndDropExpiredEntries, ThreeDaysOffAreDeclaredUntilSeenAndMissedRunsAreMadeOnce)
  • A fine fase parte una prova di durata in tempo reale di almeno 48 ore a cavallo di due sedute USA (solo crypto senza chiavi Alpaca) — partita nel container anubis-prova, ripartita da zero il 12/11/2026 alle 21:02 dopo uno spegnimento improvviso del PC; il rapporto si verifica in Fase 7 (#55)
  • In modalità dimostrativa la Panoramica corrisponde agli screen 01 (1440 px) e 09 (390 px) (TheDemoPanoramicaShowsAccountsPositionsAndLimits; fotografie di tasks screenshots, confronto nella prova di #51)
  • Il Diario corrisponde allo screen 08 a 1440 px e a 390 px non scorre in orizzontale (TheDiaryFiltersAndSearches; a 390 px scrollWidth uguale alla larghezza su /, /diario e /diario?cerca=…)
  • I comandi Telegram funzionano (o, senza token, superano i test con un finto server) — senza token, con un finto server: TheCommandsWorkFromThePhoneThroughTheRealServer, FermaWantsAConfirmationWithinTwoMinutes, OnlyTheChatOfTheSettingsIsObeyedAndOldMessagesAreNot e gli altri di TelegramTests

Fase 7 — Notizie

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/34 · Sezioni: 4.4, 4.5, 5.6, 10, 13.1–13.6

Le notizie usate per evitare guai, mai per comprare.

Lavori

  • #55 Verifica del rapporto della prova di durata
  • #56 Raccolta, deduplica e collegamento delle notizie agli strumenti
  • #57 Classificatore locale ONNX e regole sulle parole chiave
  • #58 Analista con modello linguistico facoltativo, sicurezza e tetto di spesa
  • #59 Stato per strumento, regole di 10.5, umore del mercato e recupero dopo un'assenza
  • #60 Schermata Notizie e mercato; Impostazioni su notizie e calendario
  • #61 Chiusura della fase, revisione indipendente e tag fase-7

Criteri di accettazione

  • Il rapporto della prova di durata è in docs/ e non riporta ordini duplicati né differenze non spiegate
  • Su un archivio di notizie registrate la deduplica e il collegamento superano i test
  • Un testo con istruzioni malevole non produce alcun effetto fuori dallo schema (test dedicato)
  • Senza chiave del modello linguistico tutto funziona
  • Il tetto di spesa viene rispettato
  • Ogni restrizione generata da una notizia compare nel diario con il suo motivo
  • La schermata Notizie e mercato corrisponde al mockup

Fase 8 — Apprendimento

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/35 · Sezioni: 5.6, 11, 13.1–13.6

Un modello che impara dall'esito dei segnali e può solo rimpicciolire le operazioni.

Lavori

  • #62 Archivio degli indizi "a una certa data" ed etichette
  • #63 Addestramento, convalida, calibrazione e registro dei modelli
  • #64 Ciclo continuo: modello in carica e sfidante, ombra, deriva, messa da parte
  • #65 Altri apprendimenti semplici: scostamento, impatto delle notizie, scoperte in chiaro
  • #66 Schermata Apprendimento; Impostazioni sul modello
  • #67 Chiusura della fase, revisione indipendente e tag fase-8

Criteri di accettazione

  • Un test dimostra che nessun indizio usa dati successivi alla decisione
  • Il primo modello è addestrato sugli esempi storici con rapporto di convalida
  • Il moltiplicatore non può superare 1 (test di proprietà)
  • Promozione, scarto e messa da parte sono coperti da test con dati sintetici
  • La schermata Apprendimento corrisponde al mockup

Fase 9 — Rifinitura e consegna in Docker

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/36 · Sezioni: 4.6, 5.4, 8.4, 8.7, 10.5, 12.2–12.4, 15.1–15.5, 18, appendice E

Un pacchetto Docker installabile da zero seguendo solo il manuale.

Lavori

  • #68 Revisione della sicurezza
  • #69 Salvataggi, ripristino, impronta del database e ripartenza protetta
  • #70 CI completa e pubblicazione del pacchetto Docker nel registry di Gitea
  • #71 Template Unraid definitivo con icona e test
  • #72 Manuali: MANUALE.md, RUNBOOK.md, GO-LIVE.md
  • #73 Esportazione per la dichiarazione dei redditi
  • #74 Strategie candidate, migliorie in osservazione e revisione trimestrale
  • #75 Chiusura della fase, revisione indipendente e tag fase-9

Criteri di accettazione

  • Installazione da zero con docker run seguendo solo il manuale, una volta con SQLite e una con PostgreSQL
  • Il template Unraid supera il test di 15.3 (la prova su Unraid la fa l'utente)
  • Ripristino da un salvataggio verificato, con la ripartenza protetta di 15.1
  • Un database vecchio, riavviato dopo un'importazione, porta alla pagina d'errore (test)
  • tasks check e tasks ci passano, e la CI remota se esiste
  • STATE.md elenca con franchezza ciò che resta debole

Fase 10 — Applicazione desktop

Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/37 · Sezioni: 5.4, 5.6, 9.3, 13.1, 13.5, 15.1, 15.4, 15.6

Lo stesso bot in un'applicazione Windows con installatore.

Lavori

  • #76 Avviatore desktop: finestra, area di notifica, istanza unica, processo di guardia
  • #77 Opzioni desktop: accesso dalla rete, computer sveglio, avvio automatico, primo avvio desktop
  • #78 Spostamento su un altro database
  • #79 Installatore Windows scritto in casa (Anubis.Setup) e release su Gitea
  • #80 Capitolo desktop del manuale e revisione finale a contesto pulito
  • #81 Chiusura della fase, revisione indipendente e tag fase-10

Criteri di accettazione

  • In una cartella dei dati vuota l'applicazione parte, la procedura guidata crea il database SQLite e l'interfaccia risponde solo dal computer stesso (test)
  • La stessa procedura con PostgreSQL passa contro il Postgres di sviluppo
  • Le voci dell'area di notifica producono gli stessi effetti dei pulsanti dell'interfaccia (test sulle API)
  • Il recupero dopo un'assenza passa con la configurazione desktop
  • La prova del processo di guardia della Fase 6 passa anche con l'avviatore al posto della guardia
  • Lo spostamento da SQLite a PostgreSQL conserva conteggi e totali
  • tasks desktop-win produce l'installatore (sessione su Windows), altrimenti il comando è pronto e la mancanza è scritta in STATE.md
  • Ogni sezione della specifica ha un riscontro nel codice o un ADR che spiega lo scostamento

Fasi opzionali

Solo se l'utente le chiede. Milestone: https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/38

  • #82 Opzionale A — Adapter eToro
  • #83 Opzionale B — Adapter Interactive Brokers con ETF europei armonizzati
  • #84 Opzionale C — Bitvavo o Kraken come secondo exchange crypto