Files
Anubis/docs/ROADMAP.md
T
Alby96andClaude Opus 5.5 2185a0b36b Fix the defects found by the Phase 6 review (refs #47 #48 #49 #51 #52 #54)
An independent review of the phase found nine defects. The ones that
could lose money or orders:

- Exits at the close of equity_meanrev are now planned orders written in
  the same transaction that claims the decision, so a restart can neither
  lose them nor send them twice. A sell with a deadline starts aggressive.
- Resume also finds a planned order not yet linked to its execution
  (restart between sending and linking) and closes it before re-planning.
- An account is "ready" only after adopting the guard's stops, checking
  the key, reconciling, resuming and aligning stops. Until then nothing is
  decided on it or sent to it, and the loop retries its startup each
  minute. The guard's note is deleted only when every stop it placed is in
  the ledger.
- Each account's turn is cut after 45 s (60 s for a retried startup), so a
  slow broker no longer silences the heartbeat until the guard kills a
  healthy engine; the beat is also withheld when the scheduler has been
  silent for 30 minutes.

Smaller ones: a stock decision made after the open is marked late; the
Telegram loops survive unexpected errors; a long absence is shown on the
Panoramica until "Ho visto" (SPEC 5.6); plain-http heartbeats are only
accepted to home-network addresses; the soak report gives a daily close
30 minutes to be decided before expecting it.

ADR 0012 point 12 records these choices; #51 and the two screen criteria
are ticked in the roadmap.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 21:10:28 +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)
  • 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