Files
Anubis/CLAUDE.md
T
Alby96andClaude Opus 5.5 4c4f848d80 Add the Conti screen, account keys and entrusted capital (refs #32 #29 #31)
The Conti e posizioni screen follows mockup 02: totals split by strategy,
one card per account with key permissions and the last reconciliation,
positions with a per-account filter and CSV export, pending stops (Alpaca
grouped into permanent and day stops), residues, and exposure by currency.
It shows one world only, real accounts when there are any, so simulated
and real money never add up. Position values are rounded to the cent per
row, as the table shows them, so the figures add up on screen.

Settings gain "Conti e chiavi": practice keys are asked to the broker
before they are saved and refused when they may withdraw or cannot trade;
they are never shown again and the engine restarts to use them. The
capital entrusted to each broker is set there in euro. Until any capital
is set, the overview points to that section as the first step.

The overview now reads one world, nets capital flows out of its results
and uses the time-weighted index; open orders exclude protective stops.

The demo seed gains cash rows, closed trades, stops, the ECB rate and the
reconciliation state, so the ledger itself computes the mockup's figures.
Screenshots now capture the whole page and include Conti.

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

4.4 KiB

Anubis

Bot di trading personale: azioni USA su Alpaca, crypto spot su OKX Europe, senza leva. C# su .NET 10: ASP.NET Core, interfaccia Blazor, PostgreSQL o SQLite (ADR 0003). Gira in Docker (Unraid) e come applicazione desktop Windows.

A inizio sessione

  1. Leggi docs/STATE.md (fase corrente, prossimo passo, blocchi).
  2. Leggi in docs/SPEC.md solo le sezioni che la tabella di SPEC 17 indica per la fase, più 2, 16 e 19, e l'ADR 0003 (che sostituisce la sezione 3 e l'appendice D).
  3. Apri le issue della milestone della fase su Gitea (owner BalboSoft, repo Anubis, strumenti mcp__gitea__*).
  4. Segui docs/SVILUPPO.md: branch fase-N, commit con refs #N, chiusura con prove, tag fase-N.

Comandi

Dalla radice del repository: ./tasks.ps1 <comando> (Windows) o sh ./tasks.sh <comando> (Linux); il codice sta in tools/Anubis.Tasks. Niente make.

  • check: ripristino con --locked-mode, dotnet format --verify-no-changes, build Release con gli analizzatori, test. Va verde prima di ogni commit.
  • test: solo i test; il motore viene da ANUBIS_TEST_DB (sqlite o postgres). Esclude la categoria LiveDemo.
  • dev: il server con dotnet watch su http://localhost:8787 (o --urls). Fuori da Docker usa la configurazione desktop e la cartella dei dati dell'utente (%APPDATA%\Anubis): per provare senza toccarla c'è seed-demo.
  • build: l'immagine Docker gitea.encke-hake.ts.net/balbosoft/anubis:dev.
  • ci: come la CI. Esegue check, poi i test su PostgreSQL (avvia docker compose up -d --wait postgres, porta 55432) e infine l'immagine. Richiede Docker.
  • hooks: attiva .githooks/pre-commit, che esegue check prima di ogni commit. Si fa una volta per copia del repository.
  • seed-demo: la modalità dimostrativa con i dati dell'appendice F, in una cartella e un database a parte, solo dal computer stesso.
  • screenshots: fotografa Panoramica, Conti, Diario e Impostazioni a 1440 px (chiaro e scuro) e a 390 px in artifacts/screenshots/. Usa Edge o Chrome già installati.
  • desktop-win (Fase 10): non ancora disponibile.
  • docker compose up --build: l'applicazione su http://localhost:8787 con PostgreSQL, /health risponde ok. Primo accesso con ANUBIS_ADMIN_PASSWORD del compose.

Un pacchetto nuovo rompe DependencyPolicyTests finché non è autorizzato (ADR 0004) e presente in Directory.Packages.props e nel file di blocco. Una sua dipendenza di terze parti va aggiunta all'elenco del test e a docs/API-NOTES.md (ADR 0006).

Regole che, se dimenticate, fanno sbagliare

  • Mai ordini su conti reali, mai chiavi con prelievo, mai ANUBIS_ALLOW_LIVE=1 o allow_live = true (SPEC 2.2).
  • Nessun pacchetto NuGet, npm o strumento esterno fuori dall'elenco dell'ADR 0004. Se serve qualcosa di nuovo: fermati e chiedi all'utente cosa aggiungi e perché, prima di aggiungerlo. È l'unica eccezione alla regola sotto.
  • Per tutto il resto non chiedere conferme: decidi la via più prudente, scrivi un ADR, prosegui. Fermati solo per ciò che solo l'utente può dare (SPEC 2.1).
  • docs/SPEC.md non si modifica: i cambi di decisione vanno in docs/adr/.
  • Denaro sempre decimal; tempo sempre dall'orologio iniettabile; UTC nel database.
  • Stesso schema e stessi test su PostgreSQL e SQLite.
  • Nomi: progetti e namespace Anubis.*, variabili ANUBIS_*, prefisso ordini ANU (ADR 0001).
  • Logo: solo i file di docs/design/logo/ (ADR 0005).
  • Codice e commit in inglese; tutto ciò che l'utente legge in italiano semplice.
  • Una fase per sessione; a fine fase aggiorna docs/ROADMAP.md e docs/STATE.md, chiudi le issue con la prova, commit.
  • Il push su Gitea solo quando l'utente lo chiede o lo ha già indicato.

Puntatori

  • docs/SPEC.md — specifica completa
  • docs/adr/0003-csharp-dotnet.md — stack, struttura del repository, strumenti
  • docs/adr/0004-componenti-esterni.md — pacchetti ammessi e come chiederne altri
  • docs/adr/0007-scelte-fase-1.md — schema per i due motori, interfaccia statica, immagine Docker
  • docs/design/ — screen di riferimento (SPEC 13.1); docs/design/logo/ — logo
  • docs/ROADMAP.md — fasi, issue, criteri di accettazione
  • docs/STATE.md — stato corrente
  • docs/SVILUPPO.md — flusso di lavoro e regole
  • deploy/unraid/anubis.xml — template Unraid
  • Gitea: https://gitea.encke-hake.ts.net/BalboSoft/Anubis (in rete locale http://192.168.30.23:3000)
  • Immagine Docker: gitea.encke-hake.ts.net/balbosoft/anubis