Files
Anubis/docs/ROADMAP.md
T
Alby96andClaude Opus 5.5 52550ee6d1
ci / test (postgres) (push) Successful in 1m24s
ci / test (sqlite) (push) Successful in 1m35s
ci / image (push) Successful in 16s
ci / test (postgres) (pull_request) Successful in 1m11s
ci / test (sqlite) (pull_request) Successful in 1m24s
ci / image (pull_request) Successful in 14s
Close phase 0 review findings: stricter policy scans, property generator, hook
The independent review found that the policy tests could be bypassed:
Microsoft-named direct packages and GlobalPackageReference slipped past
the dependency check, the live-money scan missed the JSON, Dockerfile
and Unraid template forms, the secret scan missed short project
secrets but would have failed on the user's own ignored .env. The
scans now read only the files git would commit and cover those cases.

Also adds the fixed-seed generator for property tests, the REGISTRY
variables reserved for phase 9 in the CI, a git pre-commit hook in
place of the pre-commit tool (tasks hooks), the missing SPEC 4 facts
in API-NOTES (Fed/ECB/BLS times, USDC depth on OKX) and the full list
of today's indirect packages.

refs #3 refs #5 refs #6

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 10:05:10 +01:00

23 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 Da fare
2 Dati di mercato Da fare
3 Conti, ordini, contabilità Da fare
4 Backtest e laboratorio Da fare
5 Strategie, portafoglio, rischio Da fare
6 Motore dal vivo in simulazione Da fare
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
  • 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
  • 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)
  • I test con guasti di questa parte passano
  • Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop
  • La schermata Conti e posizioni corrisponde al mockup

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
  • Il test anti-sguardo-avanti esiste e fallisce su una strategia volutamente scorretta
  • DSR e PBO riproducono i casi noti di 12.2
  • Il rapporto si apre dall'interfaccia

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
  • Un test dimostra che senza la procedura di 12.4 nessun ordine raggiunge un conto reale
  • Un test dimostra che una strategia retrocessa continua a gestire uscite e stop delle sue posizioni reali fino a zero
  • 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
  • Senza chiavi Alpaca i backtest azionari restano in attesa dell'utente e le due strategie azionarie restano in osservazione
  • I test anti-sguardo-avanti passano
  • Le schermate Strategie, Rischio e Operazioni corrispondono ai mockup

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
  • 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
  • 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
  • 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
  • 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)
  • Il Diario corrisponde allo screen 08 a 1440 px e a 390 px non scorre in orizzontale
  • I comandi Telegram funzionano (o, senza token, superano i test con un finto server)

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