ADR 0008 collects the market data decisions the spec leaves open: research history in csv.gz instead of Parquet (no extra package), the immediate second reading of suspect data, EUR pairs only, Alpaca only with the paper keys, name-based fund exclusion and the background worker. API-NOTES gets the facts checked while writing the adapters and the biases that remain in past universes. ROADMAP and STATE mark the phase done, with the stock history still waiting for the user's Alpaca keys. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
23 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 | 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 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
- 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 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