Files
Anubis/docs/STATE.md
T
Alby96andClaude Opus 5.5 68fdd0baee Record the Phase 2 choices, verified facts and state (refs #25)
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>
2026-11-10 15:55:01 +01:00

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.slnx con 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 (vedi CLAUDE.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, Dockerfile e docker-compose.yml con PostgreSQL 18.
    • CI in .gitea/workflows/ci.yml: test su SQLite e PostgreSQL, poi l'immagine. Solo passi run:.
  • 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 screenshots per confrontare le schermate con i mockup.
    • Dopo la chiusura, con il permesso dell'utente: carattere Instrument Sans incluso nell'applicazione (ADR 0007, punto 5).
  • 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.gz per 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 dev fuori da Docker usa la cartella dei dati vera dell'utente: per prove usa tasks 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 ci resta 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.