Files
Anubis/docs/SVILUPPO.md
T
Alby96andClaude Opus 5.5 f4cd411ab6 docs: switch to C# .NET 10, restrict external components, new scale logo
The user prefers C# and asked for no SDKs or extra components without
permission. Speed is not a factor at this trading frequency and Python's
advantages were exactly the SDKs now excluded, so ADR 0003 adopts the
appendix D variant with Blazor instead of React, in-house broker clients,
ADO.NET, .csv.gz research storage, a C# task runner instead of make and an
in-house Windows installer instead of Inno Setup.

ADR 0004 lists the only packages the user authorized (Microsoft.Data.Sqlite,
ProtectedData, WebView2, MSTest, Npgsql, ML.NET with LightGBM/FastTree,
ONNX Runtime, Tokenizers) and the ask-first rule for anything else.

ADR 0005 records why the bot is called Anubis (he weighs and protects) and
replaces the two-semicircle mark with the scale of the weighing of the
heart: SVG, PNG, ICO and Unraid icon, applied to all nine screens.

CLAUDE.md, SVILUPPO, STATE, README, ROADMAP and templates follow; the 84
Gitea issues were rewritten to match and verified against the source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 13:06:39 +01:00

7.2 KiB

Come si sviluppa Anubis

Regole di lavoro per chi scrive il codice, persona o agente. Riassumono le sezioni 2, 16 e 19 della specifica e gli ADR 0003 (stack C#) e 0004 (componenti esterni), e aggiungono il flusso su Gitea. Se qualcosa qui contraddice docs/SPEC.md, vale la specifica; se una decisione cambia, si scrive un ADR.

Dove sta cosa

Cosa Dove
Specifica completa, fonte di verità docs/SPEC.md (non si modifica)
Schermate di riferimento docs/design/01…09-*.jpg (tabella in SPEC 13.1)
Piano e criteri di accettazione docs/ROADMAP.md e le issue su Gitea, una milestone per fase
Stato della sessione docs/STATE.md
Decisioni docs/adr/NNNN-titolo.md (formato in SPEC appendice B)
Stack e struttura del repository docs/adr/0003-csharp-dotnet.md (sostituisce SPEC 3, 5.1 e appendice D)
Pacchetti ammessi docs/adr/0004-componenti-esterni.md
Logo docs/design/logo/ (ADR 0005)
Fatti verificati sulle API docs/API-NOTES.md (nasce nella Fase 0)
Template Unraid deploy/unraid/anubis.xml
Lavori, milestone, pacchetti, release https://gitea.encke-hake.ts.net/BalboSoft/Anubis

Il giro di una fase

  1. Leggi CLAUDE.md, docs/STATE.md, poi le sezioni della specifica che la tabella di SPEC 17 indica per la fase, più 2, 16 e 19, e l'ADR 0003.
  2. Apri la milestone della fase su Gitea e scegli le issue in ordine di numero: sono già in ordine di dipendenza.
  3. Branch fase-N partendo da main (per esempio fase-0).
  4. Prima di scrivere codice elenca file, interfacce e test che dimostreranno che funziona; scrivilo come commento nella issue.
  5. Implementa a piccoli passi, con i test accanto al codice. Spunta i passi della issue man mano che sono veri.
  6. Commit piccoli, in inglese, stile Conventional Commits, con il riferimento alla issue: feat(oms): deterministic client order id (refs #27).
  7. Chiudi la issue quando tutti i suoi passi sono fatti e provati: commento con la prova (comando e risultato), poi chiusura.
  8. Chiusura della fase: la issue "Chiusura della fase N" elenca tutti i criteri di accettazione. Ognuno si spunta solo con la prova mostrata. Poi revisione indipendente con un subagent a contesto pulito (messaggio dell'appendice A), correzione dei difetti reali, aggiornamento di ROADMAP.md e STATE.md, pull request fase-N → main con Closes #…, merge, tag fase-N su main, riepilogo di fine fase (appendice B) come commento alla issue di chiusura.
  9. Fermati: una fase per sessione. La successiva riparte con il messaggio di ripresa dell'appendice A.

Il lavoro non resta mai solo sul disco: ogni sessione si chiude con un commit. Il push su Gitea si fa quando l'utente lo chiede o lo ha già indicato per questo repository.

Criteri "in attesa dell'utente"

Un criterio che dipende solo da qualcosa che deve dare l'utente (chiavi dei conti di prova, prove su Unraid) non tiene aperta la fase: si segna così in ROADMAP.md, si mette l'etichetta Status/In attesa utente sulla issue che lo contiene e si scrive in STATE.md cosa serve. Si chiude appena l'utente lo fornisce (messaggio dell'appendice A).

Regole che non si discutono

Sicurezza durante lo sviluppo (SPEC 2.2)

  • Mai ordini su conti reali: solo simulatore interno, paper di Alpaca, demo di OKX.
  • Mai chiavi con permesso di prelievo.
  • Mai ANUBIS_ALLOW_LIVE=1 né allow_live = true: i test falliscono se li trovano.
  • Nessun segreto nel repository, nei registri, nei commit, negli screenshot. Solo .env.example con valori finti.
  • Non scavalcare limiti di frequenza, condizioni d'uso o blocchi geografici.

Autonomia (SPEC 2.1)

  • Non chiedere conferme e non proporre alternative: scegli l'opzione più prudente e più semplice, scrivila in un ADR, prosegui. Unica eccezione: i componenti esterni (sotto, "Dipendenze").
  • Fermati solo per ciò che solo l'utente può dare (credenziali, secondo fattore, soldi veri), dopo aver fatto tutto il resto.
  • Un fatto su un'API non verificabile non si inventa: flag, nota "non verificato" in API-NOTES.md, avanti.

Prove (SPEC 2.3)

  • Una fase si chiude con tasks check passato, immagine Docker costruita e, per le schermate, fotografie di Edge senza finestra confrontate con i mockup. "Dovrebbe funzionare" non è una prova.

Codice (ADR 0003, SPEC 16, 19)

  • Denaro, prezzi e quantità sempre decimal, mai double; sul database NUMERIC(38,18) su PostgreSQL e testo su SQLite (5.4), arrotondati a 18 decimali.
  • Nullable attivo e avvisi degli analizzatori trattati come errori in tutti i progetti.
  • Tutto il tempo passa dall'orologio iniettabile; nessun test dipende dall'ora reale o dalla rete.
  • Tutto in UTC nel database; orari di borsa sempre dal calendario del broker.
  • Lo stesso schema e gli stessi test su PostgreSQL e su SQLite; niente funzioni proprie di un solo motore.
  • Nessuna strategia parla con un broker: ogni ordine passa per correttivi, rischio e OMS.
  • Calcoli pesanti in thread dedicati a bassa priorità; un solo scrittore sul database.
  • Nessuna libreria di analisi tecnica: gli indicatori si scrivono in casa e si testano contro valori calcolati a mano.
  • Le trenta trappole di SPEC 19 si rileggono a ogni fase.

Lingua (SPEC 2.6, 13.3)

  • Codice, identificatori, commenti e commit in inglese; valori interni in inglese (observation, simulation, reduced_live, live).
  • Documenti del progetto e tutto ciò che l'utente legge in italiano semplice, senza gergo; il bot parla in prima persona.
  • Numeri all'italiana, segno meno tipografico, valuta dopo il numero, tutto da src/Anubis/Core/Format.cs.

Dipendenze (ADR 0004, SPEC 2.7)

  • Nessun SDK né componente esterno senza il permesso dell'utente. Ammessi solo .NET 10 con i suoi framework e i pacchetti elencati nell'ADR 0004, con versioni fissate in Directory.Packages.props e file di blocco.
  • Per tutto il resto si scrive codice in casa: client dei broker, Telegram, TOTP, lettura RSS, grafici, migrazioni, installatore.
  • Se un componente nuovo sembra indispensabile: fermati, chiedi all'utente spiegando cos'è, a cosa serve, perché non conviene scriverlo e cosa si porta dietro; solo con il sì lo aggiungi, con un ADR.
  • Niente librerie di analisi tecnica né di backtest (SPEC 2.7): indicatori e motore si scrivono in casa.

Schermate

Per ogni schermata: implementa, apri sui dati dimostrativi (tasks seed-demo), fotografa con Edge senza finestra (msedge --headless --screenshot) a 1440 e 390 pixel, confronta zona per zona con lo screen di docs/design/, correggi, ripeti finché restano differenze trascurabili. I testi fissi si leggono dalle immagini, i dati dall'appendice F, colori e misure dall'appendice C. Guarda uno screen per volta e ritaglia la zona che ti serve: le immagini sono a doppia densità.

Pacchetti e consegne

  • Docker: immagine gitea.encke-hake.ts.net/balbosoft/anubis, pubblicata dalla CI sui tag v* nella sezione Packages del repository (ADR 0002). I tag fase-N non pubblicano nulla.
  • Windows: installatore Anubis.Setup (scritto in casa, ADR 0003) costruito con tasks desktop-win su Windows e allegato alla release v*.
  • Unraid: deploy/unraid/anubis.xml, da copiare in /boot/config/plugins/dockerMan/templates-user/.