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>
7.4 KiB
7.4 KiB
Stato del progetto
Aggiornato: 2026-11-10
Fase corrente
Fase 2 — Dati di mercato: completata, con la parte azionaria in attesa delle chiavi del conto di prova Alpaca. La prossima è la Fase 3 (Conti, ordini, contabilità), da iniziare con il via dell'utente.
Fatto
- Specifica in
docs/SPEC.md, con il nome Anubis (ADR 0001). - Stack:
- C# su .NET 10 con interfaccia Blazor (ADR 0003);
- solo i componenti autorizzati dall'utente (ADR 0004);
- precisazioni della Fase 0 nell'ADR 0006.
- Logo: la bilancia della pesatura del cuore (ADR 0005).
- Lavori su Gitea, una milestone per fase (ADR 0002), elencati in
docs/ROADMAP.md. - Fase 0:
- Fatti della sezione 4 ricontrollati il 10/11/2026 in
docs/API-NOTES.md, insieme alle versioni dei pacchetti e alle dipendenze indirette. - Soluzione
Anubis.slnxcon sette progetti:src/: Anubis, Server, Guard, Desktop, Setup;tests/: Anubis.Tests;tools/: Anubis.Tasks.
- Toolchain:
- analizzatori con avvisi trattati come errori;
- formattazione controllata;
- versioni centralizzate, file di blocco.
- Comandi
tasks(vediCLAUDE.md) e hook pre-commit, attivo in questa copia. - Test sempre attivi:
- generatore casuale a seme fisso per i test di proprietà;
- pacchetti ammessi;
- nessun
ANUBIS_ALLOW_LIVE=1; - nessun segreto nei file;
/health.
- Applicazione minima con
GET /health,Dockerfileedocker-compose.ymlcon PostgreSQL 18. - CI in
.gitea/workflows/ci.yml: test su SQLite e PostgreSQL, poi l'immagine. Solo passirun:.
- Fatti della sezione 4 ricontrollati il 10/11/2026 in
- Fase 1 (scelte nell'ADR 0007):
- Piattaforma: configurazione d'avvio Docker (variabili) e desktop (
config.toml), cartella dei dati, identità dell'installazione con impronta del database, custodia della chiave dei segreti (DPAPI su Windows). - Database portabile su PostgreSQL e SQLite con ADO.NET: un solo schema con tipi per motore, migrazioni SQL numerate con salvataggio prima, esportazione e importazione tra motori con controllo di conteggi e totali (
Anubis.Server db export|import), salvataggi notturni (ne tiene 14). - Nucleo: orologio iniettabile, bus degli eventi, pianificatore, impostazioni con registro delle modifiche, segreti cifrati AES-GCM, registri JSON con i segreti oscurati, formati italiani.
- Accesso: password PBKDF2, sessioni, CSRF, limite ai tentativi, secondo fattore TOTP facoltativo.
- Server: avvio a stati (configurazione, primo avvio, database assente, schema, identità, pronto), pagina d'errore con riprova automatica, API REST e WebSocket dello stato.
- Interfaccia: guscio di menu, barra superiore e barra in basso come nei mockup, temi chiaro e scuro, Panoramica, Diario, Rischio, Impostazioni (aspetto, sicurezza, sistema); le altre voci arrivano con le loro fasi.
- Modalità dimostrativa (
tasks seed-demo) con i dati dell'appendice F, in un database a parte. - Immagine Docker definitiva:
PUID/PGID, controllo di salute, l'applicazione non gira come root. Provata con SQLite, PostgreSQL, configurazione sbagliata e database staccato. tasks screenshotsper confrontare le schermate con i mockup.- Dopo la chiusura, con il permesso dell'utente: carattere Instrument Sans incluso nell'applicazione (ADR 0007, punto 5).
- Piattaforma: configurazione d'avvio Docker (variabili) e desktop (
- Fase 2 (scelte nell'ADR 0008, fatti verificati in
docs/API-NOTES.md):- Catalogo degli strumenti e parte dati degli adapter OKX Europe (coppie in EUR, candele, prezzi, libro, WebSocket) e Alpaca (barre consolidate reali e rettificate, minuti, calendario, orologio, azioni societarie, flusso IEX).
- Collector storico e dal vivo dentro il server: recupero dei buchi, controlli di qualità con seconda lettura immediata, freschezza dei dati, ripresa con attese crescenti.
- Storico di ricerca in file
csv.gzper anno; importatori degli archivi Binance (con controllo SHA-256) e dei CSV dell'utente (anubis data binance,anubis data csv). - Fonti gratuite: cambi BCE, calendario economico, date FRED e trimestrali Finnhub (con chiave facoltativa), riunioni di Fed e BCE modificabili, umore (Fear & Greed, VIX, finanziamento e open interest di OKX).
- Azioni societarie e serie rettificate ancorate al giorno della decisione.
- Universi azionario e crypto "a una certa data", senza ETF né fondi.
- Rapporto di qualità dei dati (
anubis data report,/api/data/quality) e sezione Dati in Impostazioni con lo stato di ogni fonte. - Prova sui dati reali: BTC, ETH e SOL in EUR dal 21/11/2023 (1.085 giorni ciascuna, nessun buco) e BTCUSDT di Binance dal 17/08/2017 (3.363 giorni).
In corso
Nulla.
Prossimo passo
Fase 3, conti, ordini e contabilità: simulatore interno, gestione degli ordini, stop di protezione, contabilità, riconciliazione. Servono le chiavi demo di OKX Europe e quelle del conto di prova Alpaca (vedi sotto); senza, la batteria di conformità gira su risposte d'esempio.
Da sapere
- Le immagini .NET 10 sono su Ubuntu 24.04, non Debian (ADR 0006).
- La modalità dimostrativa mostra solo le parti già costruite: conti, posizioni, strategie e notizie della Panoramica arrivano con le loro fasi.
tasks devfuori da Docker usa la cartella dei dati vera dell'utente: per prove usatasks seed-demo.- Alpaca non ha più conti senza margine: il divieto di leva lo impone Anubis (API-NOTES A14).
- OKX: WebSocket sulla porta 443, la 8443 è chiusa (API-NOTES O3).
- Le coppie in EUR di OKX esistono da novembre 2023: prima di allora la storia crypto viene dagli archivi Binance in USDT, da convertire in euro nella Fase 4.
- I dati di mercato si spengono con
ANUBIS_MARKET_DATA=off; nella modalità dimostrativa sono sempre spenti. - Gli universi passati usano i flag ETF e "frazionabile" di oggi: è un limite delle fonti gratuite (API-NOTES, Fase 2).
- Gitea ha un esecutore delle Actions attivo: la CI gira a ogni push (prima esecuzione: run 169 del branch
fase-0, test verdi su SQLite e PostgreSQL).tasks ciresta per provarla in locale. - Su questo PC Docker Desktop non partiva: erano rimasti due file di comunicazione di una sessione di ottobre, che Windows non riusciva a cancellare. Le cartelle che li contengono sono state rinominate, non cancellate:
%LOCALAPPDATA%\Docker\run.stale*e%LOCALAPPDATA%\docker-secrets-engine.stale*. Si possono eliminare dopo un riavvio.
Serve dall'utente
| Cosa | Da quando serve | Senza |
|---|---|---|
| Via libera per la Fase 3 | Subito | Non si parte |
Chiavi del conto paper di Alpaca (ALPACA_API_KEY_DEMO, ALPACA_API_SECRET_DEMO) |
Già dalla Fase 2 (dati azionari) | Parte azionaria spenta; storico azionario dal 2016 in attesa |
| Chiavi demo di OKX Europe | Fase 3 (ordini sui conti di prova) | Batteria di conformità su risposte d'esempio; criteri in attesa |
Un token Gitea con permesso write:package come segreto REGISTRY_TOKEN |
Fase 9 (pubblicazione dell'immagine) | Pubblicazione a mano |
| Token del bot Telegram e chat autorizzata (facoltativi) | Fase 6 | Test con un finto server |
| Chiavi FRED e Finnhub (facoltative, gratuite) | Già dalla Fase 2 | Calendario limitato alla settimana corrente; filtro trimestrali spento |
| Chiave di un modello linguistico (facoltativa) | Fase 7 | Solo classificatore locale |
| Prova del template su Unraid | Fase 9 | Criterio in attesa |
| Permesso per ogni componente esterno non elencato nell'ADR 0004 | Quando serve | Si scrive in casa |
Le chiavi non vanno mai scritte nel repository: si mettono nel file .env locale (modello in .env.example) oppure, più avanti, dall'interfaccia.