Files
Anubis/docs/STATE.md
T
Alby96andClaude Opus 5.5 60d5ebbc05 Document Phase 3; fix CSV decimals and Alpaca price steps (refs #33 #31 #32 #27)
ADR 0009 records the Phase 3 choices; API-NOTES gains the verified trading
facts and what Anubis does with each; ROADMAP and STATE mark the phase done
with the live-demo conformance waiting for the user's keys.

Two defects found while writing the notes:
- The positions CSV used dot decimals; SPEC 13 asks for decimal commas.
  Trailing zeros are dropped so both engines give the same text.
- Alpaca's catalogue has no tick, so limit and stop prices were sent
  unrounded and would get 422 "sub-penny". OrderRules.TickOf applies
  Alpaca's rule (2 decimals from 1 $, 4 below) to orders, stops and the
  simulator's own check.

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

9.2 KiB

Stato del progetto

Aggiornato: 2026-11-10

Fase corrente

Fase 3 — Conti, ordini, contabilità: completata, con le prove sui conti di prova in attesa delle chiavi demo di OKX e di Alpaca. La prossima è la Fase 4 (Backtest e laboratorio), 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).
  • Fase 3 (scelte nell'ADR 0009, fatti verificati in docs/API-NOTES.md):
    • Interfaccia comune dei conti (IBrokerAccount), simulatore interno (PaperBroker) e parte conti degli adapter Alpaca (paper) e OKX (demo). Nessun conto reale viene creato; gli adapter rifiutano l'ambiente reale prima di qualsiasi richiesta.
    • Gestore degli ordini: stati che vanno solo avanti, id deterministici mai rimandati due volte, limite che insegue il prezzo, al massimo sei invii al minuto con le vendite per prime.
    • Stop sul broker per ogni posizione: permanenti sulle azioni intere, giornalieri sulle frazioni, sempre allineati alla quantità; stop già superato; residui invendibili.
    • Contabilità per strategia in sola aggiunta: esecuzioni, lotti, registro della liquidità, capitale affidato in euro diviso per quote, dividendi e frazionamenti, fotografie del patrimonio ogni 5 minuti, rendimento ponderato nel tempo.
    • Riconciliazione ogni 5 minuti con modalità prudente, scelta "allinea" o "escludi", blocco delle chiavi che permettono i prelievi.
    • Schermata Conti e posizioni come il mockup, esportazione CSV delle posizioni; in Impostazioni chiavi (verificate col broker prima di salvarle) e capitale affidato; la Panoramica indica il capitale come primo passo.
    • Batteria di conformità sul simulatore e sulle risposte d'esempio della documentazione; sui conti di prova parte da sola quando ci sono le chiavi.

In corso

Nulla.

Prossimo passo

Fase 4, backtest e laboratorio: motore di prova sullo storico, con gli stessi costi e le stesse regole d'ordine della Fase 3, e il confronto "senza bot". Con le chiavi dei conti di prova si possono chiudere i due criteri in attesa (azioni della Fase 2, conti di prova della Fase 3).

Da sapere

  • Le immagini .NET 10 sono su Ubuntu 24.04, non Debian (ADR 0006).
  • La modalità dimostrativa mostra solo le parti già costruite: strategie e notizie della Panoramica arrivano con le loro fasi. Nella demo il motore di trading è spento.
  • Le chiavi dei conti di prova si inseriscono da Impostazioni → Conti e chiavi oppure nel file .env; quelle nelle variabili d'ambiente valgono di più. Una chiave OKX che permette i prelievi viene rifiutata.
  • Il capitale affidato si decide in euro in Impostazioni → Conti e chiavi. Finché non c'è, le strategie osservano soltanto.
  • 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 4 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, senza permesso di prelievo Fase 3 (ordini sui conti di prova) Batteria di conformità su risposte d'esempio; criterio della Fase 3 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.