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>
87 lines
7.2 KiB
Markdown
87 lines
7.2 KiB
Markdown
# 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/`.
|