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

94 lines
7.4 KiB
Markdown

# 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.