The run started on 11 November 2026 at 21:44 Italian time in the anubis-prova container, from the image of this branch. STATE says when and how to make the report so that it spans both US sessions; its check is the first step of Phase 7 (#55). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
27 KiB
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 checkpassa su una soluzione vuota ma completa di toolchaindocker compose upavvia l'applicazione minima, che risponde su/healthdocs/API-NOTES.mdelenca per ogni fatto della sezione 4 "confermato", "cambiato" o "non verificabile"docs/STATE.mddice 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=sqlitee conpostgres - 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 (
TheDemoShowsTheFiguresOfTheMockupe 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 (
RiskTestseRiskEngineTests: 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ùNoRuleEverEnlargesWhatTheStrategyAskedeAfterALossNoPurchaseIsLargercome 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_trendnon 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 (
TheDemoShowsTradesStrategiesAndRiskAsInTheMockupse 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 (
TheLiveEngineMakesTheSameTradesAsTheBacktestsu 40 giorni dicrypto_trend,TheStockSideMakesTheSameTradesAsTheBacktestsu 6 settimane diequity_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> drillintasks cie 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 l'11/11/2026 alle 21:44 nel container
anubis-prova; 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 ditasks 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 pxscrollWidthuguale alla larghezza su/,/diarioe/diario?cerca=…) - I comandi Telegram funzionano (o, senza token, superano i test con un finto server) — senza token, con un finto server:
TheCommandsWorkFromThePhoneThroughTheRealServer,FermaWantsAConfirmationWithinTwoMinutes,OnlyTheChatOfTheSettingsIsObeyedAndOldMessagesAreNote gli altri diTelegramTests
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 runseguendo 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 checketasks cipassano, e la CI remota se esisteSTATE.mdelenca 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-winproduce l'installatore (sessione su Windows), altrimenti il comando è pronto e la mancanza è scritta inSTATE.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