docs: add Anubis specification, design screens and development plan
Load the full project specification renamed from the provisional "Giano" to "Anubis" (ADR 0001), the nine reference screens with the new name, the Unraid template draft pointing at the Gitea container registry, and the working documents the development phases rely on: CLAUDE.md, ROADMAP (linked to the 84 Gitea issues and 12 milestones), STATE, development rules (SVILUPPO), ADR 0002 on Gitea issues, packages and installer, and Gitea issue/PR templates. No application code yet. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
No files matched your search
@@ -0,0 +1,18 @@
|
||||
---
|
||||
name: Difetto
|
||||
about: Qualcosa non funziona come dice la specifica
|
||||
title: ""
|
||||
labels: ["Kind/Bug"]
|
||||
---
|
||||
|
||||
### Cosa succede
|
||||
|
||||
|
||||
### Cosa dovrebbe succedere (sezione della specifica)
|
||||
|
||||
|
||||
### Come riprodurlo
|
||||
1.
|
||||
|
||||
### Registri e screenshot
|
||||
<!-- Togli chiavi, firme e intestazioni di autenticazione prima di incollare. -->
|
||||
@@ -0,0 +1,20 @@
|
||||
---
|
||||
name: Lavoro
|
||||
about: Un lavoro di una fase, con passi e criteri di accettazione
|
||||
title: "FN · "
|
||||
labels: ["Kind/Feature"]
|
||||
---
|
||||
|
||||
**Fase N — Titolo** · Specifica: `docs/SPEC.md` §
|
||||
|
||||
### Obiettivo
|
||||
|
||||
|
||||
### Passi
|
||||
- [ ]
|
||||
|
||||
### Criteri di accettazione della fase a cui contribuisce
|
||||
-
|
||||
|
||||
---
|
||||
Valgono sempre le sezioni 2, 3, 16 e 19 della specifica e le regole di `docs/SVILUPPO.md`.
|
||||
@@ -0,0 +1,18 @@
|
||||
## Cosa cambia e perché
|
||||
|
||||
<!-- Due o tre frasi. -->
|
||||
|
||||
Closes #
|
||||
|
||||
## Prove
|
||||
|
||||
<!-- Comandi eseguiti e risultato: make check, build dell'immagine, screenshot confrontati con docs/design/. -->
|
||||
|
||||
## Controlli
|
||||
|
||||
- [ ] `make check` passa
|
||||
- [ ] Test su SQLite e su PostgreSQL
|
||||
- [ ] Nessun segreto nel diff, nei registri o negli screenshot
|
||||
- [ ] `ANUBIS_ALLOW_LIVE` e `allow_live` non attivati
|
||||
- [ ] Decisioni nuove scritte in `docs/adr/`
|
||||
- [ ] `docs/ROADMAP.md` e `docs/STATE.md` aggiornati (se chiude una fase)
|
||||
@@ -414,3 +414,35 @@ FodyWeavers.xsd
|
||||
# Built Visual Studio Code Extensions
|
||||
*.vsix
|
||||
|
||||
|
||||
# ---> Anubis
|
||||
# Segreti e configurazione locale: mai nel repository (SPEC 2.2)
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
config.toml
|
||||
# Cartella dei dati e file prodotti dal bot
|
||||
/data/
|
||||
*.sqlite3
|
||||
*.sqlite3-*
|
||||
*.parquet
|
||||
# Python
|
||||
__pycache__/
|
||||
*.py[cod]
|
||||
.venv/
|
||||
.mypy_cache/
|
||||
.ruff_cache/
|
||||
.pytest_cache/
|
||||
.coverage
|
||||
htmlcov/
|
||||
# Frontend
|
||||
node_modules/
|
||||
frontend/dist/
|
||||
playwright-report/
|
||||
test-results/
|
||||
# Confezione desktop
|
||||
desktop/build/
|
||||
desktop/dist/
|
||||
# Sessioni locali di Claude Code
|
||||
.claude/worktrees/
|
||||
.claude/settings.local.json
|
||||
@@ -0,0 +1,38 @@
|
||||
# Anubis
|
||||
|
||||
Bot di trading personale: azioni USA su Alpaca, crypto spot su OKX Europe, senza leva. Python 3.13 + FastAPI, React + Vite, PostgreSQL o SQLite. 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, 3, 16 e 19.
|
||||
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
|
||||
|
||||
Nessuno ancora: nascono nella Fase 0 (issue F0 · Toolchain). Previsti: `make check` (lint, tipi, test), `make dev`, `make test`, `make build`, `make ci`, `make seed-demo`, `make desktop-win`. Aggiorna questa sezione appena esistono.
|
||||
|
||||
## 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).
|
||||
- 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: pacchetto `anubis`, variabili `ANUBIS_*`, prefisso ordini `ANU` (ADR 0001).
|
||||
- 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/design/` — screen di riferimento (SPEC 13.1)
|
||||
- `docs/ROADMAP.md` — fasi, issue, criteri di accettazione
|
||||
- `docs/STATE.md` — stato corrente
|
||||
- `docs/SVILUPPO.md` — flusso di lavoro e regole
|
||||
- `docs/adr/` — decisioni
|
||||
- `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`
|
||||
@@ -1,3 +1,42 @@
|
||||
# Anubis
|
||||
|
||||
Bot di trading avanzato
|
||||
Bot di trading personale: azioni USA su **Alpaca** e crypto spot su **OKX Europe**, senza leva e senza vendite allo scoperto. Parte in simulazione e passa ai soldi veri solo quando ogni strategia ha superato requisiti misurati e l'utente lo conferma di persona. Mostra in un'interfaccia web in italiano cosa sta facendo, come stanno i conti e se sta guadagnando o perdendo.
|
||||
|
||||
Si installa in due modi, dallo stesso codice:
|
||||
|
||||
- **Docker**, un solo container pensato per un server Unraid sempre acceso. Immagine: `gitea.encke-hake.ts.net/balbosoft/anubis` (sezione Packages del repository).
|
||||
- **Applicazione desktop** per Windows, con installatore (sezione Release).
|
||||
|
||||
Database a scelta: PostgreSQL oppure SQLite.
|
||||
|
||||
> Stato: **progettazione completata, sviluppo non ancora iniziato.** Il piano è nelle [milestone](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestones) del repository.
|
||||
|
||||

|
||||
|
||||
## Documentazione
|
||||
|
||||
| Documento | Contenuto |
|
||||
|---|---|
|
||||
| [docs/SPEC.md](docs/SPEC.md) | Specifica completa: architettura, strategie, rischio, interfaccia, piano a fasi |
|
||||
| [docs/ROADMAP.md](docs/ROADMAP.md) | Le fasi con i lavori su Gitea e i criteri di accettazione |
|
||||
| [docs/STATE.md](docs/STATE.md) | A che punto siamo e cosa serve dall'utente |
|
||||
| [docs/SVILUPPO.md](docs/SVILUPPO.md) | Come si lavora: flusso su Gitea, regole, prove |
|
||||
| [docs/adr/](docs/adr/) | Decisioni prese |
|
||||
| [docs/design/](docs/design/) | Schermate di riferimento |
|
||||
| [deploy/unraid/anubis.xml](deploy/unraid/anubis.xml) | Template Docker per Unraid (bozza) |
|
||||
|
||||
## Schermate di riferimento
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
| [Panoramica](docs/design/01-panoramica.jpg) | [Conti e posizioni](docs/design/02-conti-e-posizioni.jpg) |
|
||||
| [Operazioni](docs/design/03-operazioni.jpg) | [Strategie](docs/design/04-strategie.jpg) |
|
||||
| [Notizie e mercato](docs/design/05-notizie-e-mercato.jpg) | [Apprendimento](docs/design/06-apprendimento.jpg) |
|
||||
| [Rischio](docs/design/07-rischio.jpg) | [Diario e sistema](docs/design/08-diario-e-sistema.jpg) |
|
||||
| [Panoramica su telefono](docs/design/09-panoramica-telefono.jpg) | |
|
||||
|
||||
I numeri e le notizie negli screen sono dati di esempio (SPEC appendice F).
|
||||
|
||||
## Avvertenza
|
||||
|
||||
Nessun sistema garantisce un profitto e la maggior parte dei trader privati perde denaro. Anubis punta sulla disciplina: regole semplici con evidenza pubblicata, costi realistici, limiti di rischio rigidi, nessun passaggio ai soldi veri senza prove.
|
||||
@@ -0,0 +1,46 @@
|
||||
<?xml version="1.0"?>
|
||||
<!--
|
||||
Anubis: bozza del template Docker per Unraid (si completa nella Fase 9).
|
||||
L'immagine e' pubblicata nel registry dei pacchetti di Gitea, sotto l'organizzazione BalboSoft.
|
||||
Copia il file in /boot/config/plugins/dockerMan/templates-user/ e scegli
|
||||
"anubis" tra i template nella scheda Docker di Unraid.
|
||||
-->
|
||||
<Container version="2">
|
||||
<Name>anubis</Name>
|
||||
<Repository>gitea.encke-hake.ts.net/balbosoft/anubis:latest</Repository>
|
||||
<Registry>https://gitea.encke-hake.ts.net/BalboSoft/-/packages/container/anubis/latest</Registry>
|
||||
<Network>bridge</Network>
|
||||
<Shell>sh</Shell>
|
||||
<Privileged>false</Privileged>
|
||||
<Support>https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues</Support>
|
||||
<Project>https://gitea.encke-hake.ts.net/BalboSoft/Anubis</Project>
|
||||
<Overview>Anubis è un bot di trading personale: azioni USA su Alpaca e crypto spot su OKX Europe, senza leva. Parte in simulazione e passa ai soldi veri solo con requisiti misurati e la conferma dell'utente. Il database si sceglie qui: PostgreSQL (un database vuoto, già creato, con un utente dedicato) oppure SQLite (un file nella cartella dei dati).</Overview>
|
||||
<Category>Tools:Utilities Status:Beta</Category>
|
||||
<WebUI>http://[IP]:[PORT:8787]/</WebUI>
|
||||
<TemplateURL/>
|
||||
<Icon>https://gitea.encke-hake.ts.net/BalboSoft/Anubis/raw/branch/main/deploy/unraid/anubis-icon.png</Icon>
|
||||
<ExtraParams>--restart unless-stopped --memory=4g --stop-timeout 60</ExtraParams>
|
||||
<Requires>Con PostgreSQL: un database vuoto e un utente dedicato, raggiungibili dal container.</Requires>
|
||||
|
||||
<Config Name="Porta dell'interfaccia" Target="8787" Default="8787" Mode="tcp" Description="Porta su cui si apre l'interfaccia web." Type="Port" Display="always" Required="true" Mask="false">8787</Config>
|
||||
<Config Name="Cartella dei dati" Target="/data" Default="/mnt/user/appdata/anubis" Mode="rw" Description="Modelli, salvataggi, storico per la ricerca e registri tecnici. Con SQLite contiene anche il database." Type="Path" Display="always" Required="true" Mask="false">/mnt/user/appdata/anubis</Config>
|
||||
|
||||
<Config Name="Database" Target="ANUBIS_DB_ENGINE" Default="postgres|sqlite" Mode="" Description="postgres: usa il server PostgreSQL indicato nei campi qui sotto. sqlite: un file nella cartella dei dati, senza altri campi da compilare. La scelta si fa qui e non si cambia dall'interfaccia." Type="Variable" Display="always" Required="true" Mask="false">postgres</Config>
|
||||
<Config Name="PostgreSQL: indirizzo" Target="ANUBIS_DB_HOST" Default="" Mode="" Description="Solo con postgres. Di solito l'indirizzo IP di Unraid; il nome del container PostgreSQL se i due stanno sulla stessa rete Docker personalizzata." Type="Variable" Display="always" Required="false" Mask="false"></Config>
|
||||
<Config Name="PostgreSQL: porta" Target="ANUBIS_DB_PORT" Default="5432" Mode="" Description="Solo con postgres." Type="Variable" Display="always" Required="false" Mask="false">5432</Config>
|
||||
<Config Name="PostgreSQL: nome del database" Target="ANUBIS_DB_NAME" Default="anubis" Mode="" Description="Solo con postgres. Deve esistere già ed essere dedicato a Anubis." Type="Variable" Display="always" Required="false" Mask="false">anubis</Config>
|
||||
<Config Name="PostgreSQL: utente" Target="ANUBIS_DB_USER" Default="anubis" Mode="" Description="Solo con postgres." Type="Variable" Display="always" Required="false" Mask="false">anubis</Config>
|
||||
<Config Name="PostgreSQL: password" Target="ANUBIS_DB_PASSWORD" Default="" Mode="" Description="Solo con postgres." Type="Variable" Display="always" Required="false" Mask="true"></Config>
|
||||
|
||||
<Config Name="Chiave dei segreti" Target="ANUBIS_SECRET_KEY" Default="" Mode="" Description="Stringa lunga e casuale, almeno 32 caratteri: cifra nel database le chiavi dei conti. Conservala: se cambia, le chiavi vanno reinserite." Type="Variable" Display="always" Required="true" Mask="true"></Config>
|
||||
<Config Name="Password iniziale" Target="ANUBIS_ADMIN_PASSWORD" Default="" Mode="" Description="Password per il primo accesso all'interfaccia, dove se ne sceglie subito una nuova. Resta la chiave per le scelte della pagina d'errore del database." Type="Variable" Display="always" Required="true" Mask="true"></Config>
|
||||
<Config Name="Fuso orario" Target="TZ" Default="Europe/Rome" Mode="" Description="Il tuo fuso orario: decide gli orari mostrati, il giorno dei limiti di rischio e i lavori notturni." Type="Variable" Display="always" Required="false" Mask="false">Europe/Rome</Config>
|
||||
|
||||
<Config Name="Soldi veri consentiti" Target="ANUBIS_ALLOW_LIVE" Default="0|1" Mode="" Description="0: il bot non può collegarsi a conti reali, qualunque cosa si faccia dall'interfaccia. 1: la procedura di conferma per i soldi veri diventa disponibile." Type="Variable" Display="advanced" Required="false" Mask="false">0</Config>
|
||||
<Config Name="Telegram: token del bot" Target="TELEGRAM_BOT_TOKEN" Default="" Mode="" Description="Facoltativo: si può inserire anche dall'interfaccia. Se lo compili qui, l'interfaccia lo mostra in sola lettura." Type="Variable" Display="advanced" Required="false" Mask="true"></Config>
|
||||
<Config Name="Telegram: chat autorizzata" Target="TELEGRAM_CHAT_ID" Default="" Mode="" Description="Facoltativo: identificativo della chat che riceve gli avvisi e può dare comandi." Type="Variable" Display="advanced" Required="false" Mask="false"></Config>
|
||||
<Config Name="Segnale di vita" Target="ANUBIS_HEARTBEAT_URL" Default="" Mode="" Description="Facoltativo: indirizzo di un servizio esterno da chiamare ogni minuto, che avvisa quando il bot smette di rispondere." Type="Variable" Display="advanced" Required="false" Mask="false"></Config>
|
||||
<Config Name="Utente (PUID)" Target="PUID" Default="99" Mode="" Description="Utente a cui va la cartella dei dati e con cui gira l'applicazione. 99 è il valore normale su Unraid." Type="Variable" Display="advanced" Required="false" Mask="false">99</Config>
|
||||
<Config Name="Gruppo (PGID)" Target="PGID" Default="100" Mode="" Description="Gruppo a cui va la cartella dei dati. 100 è il valore normale su Unraid." Type="Variable" Display="advanced" Required="false" Mask="false">100</Config>
|
||||
<Config Name="Database: indirizzo completo" Target="ANUBIS_DB_URL" Default="" Mode="" Description="Facoltativo, per casi particolari: sostituisce i campi PostgreSQL separati." Type="Variable" Display="advanced" Required="false" Mask="true"></Config>
|
||||
</Container>
|
||||
@@ -0,0 +1,314 @@
|
||||
# Roadmap
|
||||
|
||||
Le fasi della sezione 17 di `docs/SPEC.md`, con i lavori su Gitea e i criteri di accettazione.
|
||||
Ogni fase è una [milestone](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestones) e ha una issue di chiusura con l'elenco dei criteri.
|
||||
|
||||
Come si aggiorna: quando un lavoro è chiuso su Gitea si spunta qui; un criterio si spunta solo con la prova
|
||||
mostrata (SPEC 2.3). Un criterio che dipende solo dall'utente si segna *in attesa dell'utente* e non tiene
|
||||
aperta la fase. Se questo file e Gitea divergono, vale Gitea e si corregge questo file (ADR 0002).
|
||||
|
||||
| Fase | Titolo | Stato |
|
||||
|---|---|---|
|
||||
| 0 | [Preparazione](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/27) | Da fare |
|
||||
| 1 | [Fondamenta](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/28) | Da fare |
|
||||
| 2 | [Dati di mercato](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/29) | Da fare |
|
||||
| 3 | [Conti, ordini, contabilità](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/30) | Da fare |
|
||||
| 4 | [Backtest e laboratorio](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/31) | Da fare |
|
||||
| 5 | [Strategie, portafoglio, rischio](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/32) | Da fare |
|
||||
| 6 | [Motore dal vivo in simulazione](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/33) | Da fare |
|
||||
| 7 | [Notizie](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/34) | Da fare |
|
||||
| 8 | [Apprendimento](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/35) | Da fare |
|
||||
| 9 | [Rifinitura e consegna in Docker](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/36) | Da fare |
|
||||
| 10 | [Applicazione desktop](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/37) | Da fare |
|
||||
|
||||
Sezioni da leggere in ogni fase, oltre a 2, 3, 16 e 19 che valgono sempre: indicate sotto il titolo.
|
||||
|
||||
## Fase 0 — Preparazione
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/27](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/27) · Sezioni: 1, 4, 5.1, 15.5
|
||||
|
||||
Un progetto vuoto ma completo di toolchain, con i fatti sulle API ricontrollati.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#1](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/1) Ricontrollare i fatti sulle API e scrivere API-NOTES.md
|
||||
- [ ] [#2](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/2) Struttura del repository e file di memoria del progetto
|
||||
- [ ] [#3](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/3) Toolchain backend e frontend: uv, ruff, mypy, pytest, vitest, Playwright, Makefile
|
||||
- [ ] [#4](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/4) Applicazione minima con /health, Dockerfile minimo e docker-compose con PostgreSQL
|
||||
- [ ] [#5](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/5) Scheletro della CI su Gitea Actions (backend su SQLite e PostgreSQL)
|
||||
- [ ] [#6](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/6) Chiusura della fase, revisione indipendente e tag `fase-0`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] `make check` passa su un progetto vuoto ma completo di toolchain
|
||||
- [ ] `docker compose up` avvia l'applicazione minima, che risponde su `/health`
|
||||
- [ ] `docs/API-NOTES.md` elenca per ogni fatto della sezione 4 "confermato", "cambiato" o "non verificabile"
|
||||
- [ ] `docs/STATE.md` dice quali chiavi serviranno e da quale fase (paper Alpaca dalla Fase 2, demo OKX dalla Fase 3)
|
||||
|
||||
## Fase 1 — Fondamenta
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/28](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/28) · Sezioni: 5, 13.1–13.5, 15.1, 15.2, 15.4, 15.6, appendici C e F
|
||||
|
||||
Le basi su cui si appoggia tutto: piattaforma, database, sicurezza, guscio dell'interfaccia.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#7](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/7) Strato di piattaforma: configurazione d'avvio Docker e desktop, cartella dei dati, identità dell'installazione
|
||||
- [ ] [#8](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/8) Database portabile PostgreSQL/SQLite: tipi, modelli, migrazioni Alembic
|
||||
- [ ] [#9](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/9) Esportazione e importazione indipendenti dal motore; salvataggi notturni e prima delle migrazioni
|
||||
- [ ] [#10](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/10) Nucleo: orologio iniettabile, bus degli eventi, pianificatore, impostazioni, segreti, registri strutturati
|
||||
- [ ] [#11](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/11) Accesso e sicurezza: Argon2id, sessioni, CSRF, limite tentativi, TOTP
|
||||
- [ ] [#12](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/12) Scheletro delle API REST e del WebSocket
|
||||
- [ ] [#13](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/13) Guscio dell'interfaccia: menu, barra superiore, temi, token grafici, formati italiani
|
||||
- [ ] [#14](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/14) Schermate di servizio: accesso, primo avvio (Docker e desktop), pagina d'errore del database, prima parte di Impostazioni
|
||||
- [ ] [#15](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/15) Modalità dimostrativa con i dati dell'appendice F (`make seed-demo`)
|
||||
- [ ] [#16](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/16) Dockerfile definitivo con entrypoint (PUID/PGID, cartella dati, healthcheck)
|
||||
- [ ] [#17](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/17) Chiusura della fase, revisione indipendente e tag `fase-1`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] Accesso funzionante
|
||||
- [ ] Il guscio corrisponde ai mockup per menu e barra superiore a 1440 px e per barra superiore e barra in basso a 390 px (screenshot allegati)
|
||||
- [ ] I formati numerici superano i test
|
||||
- [ ] L'immagine si costruisce e parte con `ANUBIS_DB_ENGINE=sqlite` e con `postgres`
|
||||
- [ ] Con una configurazione mancante o sbagliata compare la pagina d'errore e non nasce alcun altro database
|
||||
- [ ] Staccando il database compare la pagina d'errore e al ritorno l'applicazione riprende da sola
|
||||
- [ ] La stessa batteria di test passa su entrambi i motori
|
||||
- [ ] Un archivio esportato da un motore e importato nell'altro dà gli stessi conteggi
|
||||
- [ ] Con la configurazione desktop il server parte da una cartella dei dati vuota e la chiave dei segreti non finisce in `config.toml`
|
||||
- [ ] La modalità dimostrativa non tocca il database configurato (test)
|
||||
|
||||
## Fase 2 — Dati di mercato
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/29](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/29) · Sezioni: 4, 5.3, 6, 10.4
|
||||
|
||||
Storico e dati dal vivo affidabili, controllati e senza sguardi in avanti.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#18](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/18) Catalogo degli strumenti e parte dati dell'adapter OKX Europe
|
||||
- [ ] [#19](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/19) Parte dati dell'adapter Alpaca (piano gratuito)
|
||||
- [ ] [#20](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/20) Collector storico e dal vivo, recupero dei buchi, controlli di qualità, freschezza
|
||||
- [ ] [#21](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/21) Importatori: archivi Binance e CSV dell'utente verso Parquet
|
||||
- [ ] [#22](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/22) Calendari e cambi: calendario di borsa, EUR/USD BCE, calendario economico, trimestrali, umore
|
||||
- [ ] [#23](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/23) Azioni societarie e serie rettificate ancorate al giorno della decisione
|
||||
- [ ] [#24](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/24) Universi "a una certa data" con esclusione degli ETF
|
||||
- [ ] [#25](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/25) Chiusura della fase, revisione indipendente e tag `fase-2`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] Storico giornaliero delle crypto dall'inizio disponibile (coppie in EUR di OKX, più gli archivi Binance dal 2017) e delle azioni dal 2016
|
||||
- [ ] Senza chiavi Alpaca la parte azionaria si prova su dati sintetici e risposte d'esempio, e il criterio resta in attesa dell'utente
|
||||
- [ ] Un test stacca il flusso per 10 minuti e verifica che il buco venga recuperato
|
||||
- [ ] Rapporto di qualità dei dati
|
||||
- [ ] L'elenco dell'universo azionario a tre date passate non contiene ETF
|
||||
|
||||
## Fase 3 — Conti, ordini, contabilità
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/30](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/30) · Sezioni: 4.1, 4.2, 5.3, 6, 7, 13.1–13.6
|
||||
|
||||
Ordini sicuri e ogni euro tracciato.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#26](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/26) Conti e ordini nell'interfaccia BrokerAdapter e simulatore interno (PaperBroker)
|
||||
- [ ] [#27](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/27) OMS: macchina a stati, identificativi deterministici, limite che insegue, ritmo degli invii
|
||||
- [ ] [#28](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/28) Stop di protezione: stop sul broker, stop che seguono la quantità, stop già superato, residui invendibili
|
||||
- [ ] [#29](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/29) Ambienti, capitale affidato e contabilità: registro, lotti, patrimonio, rendimento corretto
|
||||
- [ ] [#30](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/30) Riconciliazione con i conti e modalità prudente
|
||||
- [ ] [#31](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/31) Adapter Alpaca (paper) e OKX (demo) e batteria di conformità `live_demo`
|
||||
- [ ] [#32](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/32) Schermata Conti e posizioni; conti in Impostazioni e nel primo avvio
|
||||
- [ ] [#33](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/33) Chiusura della fase, revisione indipendente e tag `fase-3`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] I test di proprietà contabili passano
|
||||
- [ ] La batteria di conformità passa sul simulatore e, se le chiavi demo ci sono, sui due conti di prova (altrimenti su risposte d'esempio, criterio in attesa dell'utente)
|
||||
- [ ] I test con guasti di questa parte passano
|
||||
- [ ] Un test dimostra che gli adapter rifiutano un ambiente reale senza il consenso della configurazione d'avvio, in Docker e su desktop
|
||||
- [ ] La schermata Conti e posizioni corrisponde al mockup
|
||||
|
||||
## Fase 4 — Backtest e laboratorio
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/31](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/31) · Sezioni: 5.3, 8.7, 12.1, 12.2, 13.1–13.4
|
||||
|
||||
Un motore di prova onesto, riproducibile e protetto dall'auto-inganno.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#34](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/34) Motore di backtest a eventi, modelli di costo e metriche
|
||||
- [ ] [#35](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/35) Convalide: finestre che avanzano, K-fold purgato combinatorio, DSR, PBO; registro delle prove
|
||||
- [ ] [#36](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/36) Rapporto di backtest e schermata Laboratorio
|
||||
- [ ] [#37](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/37) Chiusura della fase, revisione indipendente e tag `fase-4`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] Una strategia giocattolo con risultato noto dà esattamente il risultato atteso
|
||||
- [ ] Il test anti-sguardo-avanti esiste e fallisce su una strategia volutamente scorretta
|
||||
- [ ] DSR e PBO riproducono i casi noti di 12.2
|
||||
- [ ] Il rapporto si apre dall'interfaccia
|
||||
|
||||
## Fase 5 — Strategie, portafoglio, rischio
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/32](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/32) · Sezioni: 7.1, 7.5, 8, 9, 12, 13.1–13.6
|
||||
|
||||
Le tre strategie di base dentro un motore del rischio che nessuno può aggirare.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#38](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/38) Strategia `crypto_trend`
|
||||
- [ ] [#39](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/39) Strategia `equity_momentum`
|
||||
- [ ] [#40](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/40) Strategia `equity_meanrev`
|
||||
- [ ] [#41](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/41) Correttivi comuni, ripartizione del capitale e dimensionamento
|
||||
- [ ] [#42](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/42) Motore del rischio completo con interruttore d'emergenza
|
||||
- [ ] [#43](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/43) Stadi delle strategie, requisiti, gemello simulato, sola uscita e conferma per i soldi veri
|
||||
- [ ] [#44](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/44) Backtest onesti delle tre strategie in docs/backtests/
|
||||
- [ ] [#45](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/45) Schermate Strategie, Rischio e Operazioni con la scheda "perché"; Impostazioni su strategie, limiti e scenari
|
||||
- [ ] [#46](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/46) Chiusura della fase, revisione indipendente e tag `fase-5`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] Ogni regola di 9.1 e 9.2 ha il suo test
|
||||
- [ ] Un test dimostra che senza la procedura di 12.4 nessun ordine raggiunge un conto reale
|
||||
- [ ] Un test dimostra che una strategia retrocessa continua a gestire uscite e stop delle sue posizioni reali fino a zero
|
||||
- [ ] Per ciascuna strategia un rapporto di backtest onesto in `docs/backtests/` (costi doppi e tripli, confronto con comprare e tenere), qualunque sia l'esito, più il file versionato con l'esito per il primo avvio
|
||||
- [ ] Senza chiavi Alpaca i backtest azionari restano in attesa dell'utente e le due strategie azionarie restano in osservazione
|
||||
- [ ] I test anti-sguardo-avanti passano
|
||||
- [ ] Le schermate Strategie, Rischio e Operazioni corrispondono ai mockup
|
||||
|
||||
## Fase 6 — Motore dal vivo in simulazione
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/33](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/33) · Sezioni: 5.5, 5.6, 7.4, 9.3, 9.4, 13, 14
|
||||
|
||||
Il bot che lavora da solo, in simulazione, giorno e notte, e lo racconta.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#47](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/47) Orchestrazione della giornata (5.5) e motore dal vivo in simulazione
|
||||
- [ ] [#48](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/48) Processo di guardia, avvio e ripartenza sicuri
|
||||
- [ ] [#49](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/49) Recupero dopo un'assenza (5.6)
|
||||
- [ ] [#50](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/50) Diario con frasi in italiano dai codici motivo e confronto "senza bot"
|
||||
- [ ] [#51](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/51) Schermate Panoramica e Diario e sistema
|
||||
- [ ] [#52](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/52) Telegram e segnale di vita
|
||||
- [ ] [#53](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/53) Prova di durata di 48 ore in tempo reale
|
||||
- [ ] [#54](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/54) Chiusura della fase, revisione indipendente e tag `fase-6`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] Il test di parità tra backtest e motore in simulazione passa, con correttivi e rischio attivi
|
||||
- [ ] Una prova accelerata con orologio simulato copre almeno 10 giorni di mercato con guasti iniettati e termina con registro e conti riconciliati e senza ordini duplicati
|
||||
- [ ] Un test blocca il ciclo principale con una vendita a metà e verifica che dopo la guardia la posizione abbia di nuovo i suoi stop e il motore sia ripartito; la stessa prova passa dentro l'immagine Docker
|
||||
- [ ] Un test con orologio simulato spegne il bot per 3 ore, 20 ore e 3 giorni e verifica le righe di 5.6 i cui lavori esistono
|
||||
- [ ] A fine fase parte una prova di durata in tempo reale di almeno 48 ore a cavallo di due sedute USA (solo crypto senza chiavi Alpaca)
|
||||
- [ ] In modalità dimostrativa la Panoramica corrisponde agli screen 01 (1440 px) e 09 (390 px)
|
||||
- [ ] Il Diario corrisponde allo screen 08 a 1440 px e a 390 px non scorre in orizzontale
|
||||
- [ ] I comandi Telegram funzionano (o, senza token, superano i test con un finto server)
|
||||
|
||||
## Fase 7 — Notizie
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/34](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/34) · Sezioni: 4.4, 4.5, 5.6, 10, 13.1–13.6
|
||||
|
||||
Le notizie usate per evitare guai, mai per comprare.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#55](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/55) Verifica del rapporto della prova di durata
|
||||
- [ ] [#56](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/56) Raccolta, deduplica e collegamento delle notizie agli strumenti
|
||||
- [ ] [#57](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/57) Classificatore locale ONNX e regole sulle parole chiave
|
||||
- [ ] [#58](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/58) Analista con modello linguistico facoltativo, sicurezza e tetto di spesa
|
||||
- [ ] [#59](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/59) Stato per strumento, regole di 10.5, umore del mercato e recupero dopo un'assenza
|
||||
- [ ] [#60](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/60) Schermata Notizie e mercato; Impostazioni su notizie e calendario
|
||||
- [ ] [#61](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/61) Chiusura della fase, revisione indipendente e tag `fase-7`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] Il rapporto della prova di durata è in `docs/` e non riporta ordini duplicati né differenze non spiegate
|
||||
- [ ] Su un archivio di notizie registrate la deduplica e il collegamento superano i test
|
||||
- [ ] Un testo con istruzioni malevole non produce alcun effetto fuori dallo schema (test dedicato)
|
||||
- [ ] Senza chiave del modello linguistico tutto funziona
|
||||
- [ ] Il tetto di spesa viene rispettato
|
||||
- [ ] Ogni restrizione generata da una notizia compare nel diario con il suo motivo
|
||||
- [ ] La schermata Notizie e mercato corrisponde al mockup
|
||||
|
||||
## Fase 8 — Apprendimento
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/35](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/35) · Sezioni: 5.6, 11, 13.1–13.6
|
||||
|
||||
Un modello che impara dall'esito dei segnali e può solo rimpicciolire le operazioni.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#62](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/62) Archivio degli indizi "a una certa data" ed etichette
|
||||
- [ ] [#63](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/63) Addestramento, convalida, calibrazione e registro dei modelli
|
||||
- [ ] [#64](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/64) Ciclo continuo: modello in carica e sfidante, ombra, deriva, messa da parte
|
||||
- [ ] [#65](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/65) Altri apprendimenti semplici: scostamento, impatto delle notizie, scoperte in chiaro
|
||||
- [ ] [#66](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/66) Schermata Apprendimento; Impostazioni sul modello
|
||||
- [ ] [#67](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/67) Chiusura della fase, revisione indipendente e tag `fase-8`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] Un test dimostra che nessun indizio usa dati successivi alla decisione
|
||||
- [ ] Il primo modello è addestrato sugli esempi storici con rapporto di convalida
|
||||
- [ ] Il moltiplicatore non può superare 1 (test di proprietà)
|
||||
- [ ] Promozione, scarto e messa da parte sono coperti da test con dati sintetici
|
||||
- [ ] La schermata Apprendimento corrisponde al mockup
|
||||
|
||||
## Fase 9 — Rifinitura e consegna in Docker
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/36](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/36) · Sezioni: 4.6, 5.4, 8.4, 8.7, 10.5, 12.2–12.4, 15.1–15.5, 18, appendice E
|
||||
|
||||
Un pacchetto Docker installabile da zero seguendo solo il manuale.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#68](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/68) Revisione della sicurezza
|
||||
- [ ] [#69](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/69) Salvataggi, ripristino, impronta del database e ripartenza protetta
|
||||
- [ ] [#70](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/70) CI completa e pubblicazione del pacchetto Docker nel registry di Gitea
|
||||
- [ ] [#71](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/71) Template Unraid definitivo con icona e test
|
||||
- [ ] [#72](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/72) Manuali: MANUALE.md, RUNBOOK.md, GO-LIVE.md
|
||||
- [ ] [#73](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/73) Esportazione per la dichiarazione dei redditi
|
||||
- [ ] [#74](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/74) Strategie candidate, migliorie in osservazione e revisione trimestrale
|
||||
- [ ] [#75](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/75) Chiusura della fase, revisione indipendente e tag `fase-9`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] Installazione da zero con `docker run` seguendo solo il manuale, una volta con SQLite e una con PostgreSQL
|
||||
- [ ] Il template Unraid supera il test di 15.3 (la prova su Unraid la fa l'utente)
|
||||
- [ ] Ripristino da un salvataggio verificato, con la ripartenza protetta di 15.1
|
||||
- [ ] Un database vecchio, riavviato dopo un'importazione, porta alla pagina d'errore (test)
|
||||
- [ ] `make check` e `make ci` passano, e la CI remota se esiste
|
||||
- [ ] `STATE.md` elenca con franchezza ciò che resta debole
|
||||
|
||||
## Fase 10 — Applicazione desktop
|
||||
|
||||
Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/37](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/37) · Sezioni: 5.4, 5.6, 9.3, 13.1, 13.5, 15.1, 15.4, 15.6
|
||||
|
||||
Lo stesso bot in un'applicazione Windows con installatore.
|
||||
|
||||
**Lavori**
|
||||
|
||||
- [ ] [#76](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/76) Avviatore desktop: finestra, area di notifica, istanza unica, processo di guardia
|
||||
- [ ] [#77](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/77) Opzioni desktop: accesso dalla rete, computer sveglio, avvio automatico, primo avvio desktop
|
||||
- [ ] [#78](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/78) Spostamento su un altro database
|
||||
- [ ] [#79](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/79) Installatore Windows (PyInstaller + Inno Setup) e release su Gitea
|
||||
- [ ] [#80](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/80) Capitolo desktop del manuale e revisione finale a contesto pulito
|
||||
- [ ] [#81](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/81) Chiusura della fase, revisione indipendente e tag `fase-10`
|
||||
|
||||
**Criteri di accettazione**
|
||||
|
||||
- [ ] In una cartella dei dati vuota l'applicazione parte, la procedura guidata crea il database SQLite e l'interfaccia risponde solo dal computer stesso (test)
|
||||
- [ ] La stessa procedura con PostgreSQL passa contro il Postgres di sviluppo
|
||||
- [ ] Le voci dell'area di notifica producono gli stessi effetti dei pulsanti dell'interfaccia (test sulle API)
|
||||
- [ ] Il recupero dopo un'assenza passa con la configurazione desktop
|
||||
- [ ] La prova del processo di guardia della Fase 6 passa anche con l'avviatore al posto della guardia
|
||||
- [ ] Lo spostamento da SQLite a PostgreSQL conserva conteggi e totali
|
||||
- [ ] `make desktop-win` produce l'installatore (sessione su Windows), altrimenti lo script è pronto e la mancanza è scritta in `STATE.md`
|
||||
- [ ] Ogni sezione della specifica ha un riscontro nel codice o un ADR che spiega lo scostamento
|
||||
|
||||
## Fasi opzionali
|
||||
|
||||
Solo se l'utente le chiede. Milestone: [https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/38](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/milestone/38)
|
||||
|
||||
- [ ] [#82](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/82) Opzionale A — Adapter eToro
|
||||
- [ ] [#83](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/83) Opzionale B — Adapter Interactive Brokers con ETF europei armonizzati
|
||||
- [ ] [#84](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/issues/84) Opzionale C — Bitvavo o Kraken come secondo exchange crypto
|
||||
@@ -0,0 +1,39 @@
|
||||
# Stato del progetto
|
||||
|
||||
Aggiornato: 2026-11-09
|
||||
|
||||
## Fase corrente
|
||||
|
||||
**Fase 0 — Preparazione: non iniziata.** Lo sviluppo parte solo con il via dell'utente.
|
||||
|
||||
## Fatto
|
||||
|
||||
- Specifica caricata in `docs/SPEC.md`, con il nome Anubis al posto di Giano (ADR 0001).
|
||||
- Screen di riferimento in `docs/design/`, aggiornati al nuovo nome.
|
||||
- Bozza del template Unraid in `deploy/unraid/anubis.xml`, già con il registry di Gitea.
|
||||
- Lavori creati su Gitea: una milestone per fase, una issue per lavoro, una issue di chiusura per fase (ADR 0002). Elenco in `docs/ROADMAP.md`.
|
||||
- Regole di lavoro in `docs/SVILUPPO.md` e `CLAUDE.md`.
|
||||
|
||||
## In corso
|
||||
|
||||
Nulla.
|
||||
|
||||
## Prossimo passo
|
||||
|
||||
Fase 0, a partire dalla issue #1 (verifica dei fatti sulle API), poi #2–#5 e la chiusura #6.
|
||||
|
||||
## Serve dall'utente
|
||||
|
||||
| Cosa | Da quando serve | Senza |
|
||||
|---|---|---|
|
||||
| Via libera per iniziare lo sviluppo | Subito | Non si parte |
|
||||
| Chiavi del conto paper di Alpaca | Fase 2 (dati azionari) | La parte azionaria si prova su dati sintetici; criteri 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 esecutore di Gitea Actions (runner), se si vuole la CI remota | Fase 0 | `make ci` in locale |
|
||||
| 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) | 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 |
|
||||
|
||||
Le chiavi non vanno mai scritte nel repository: si mettono nel file `.env` locale (Fase 0 crea `.env.example`) oppure, più avanti, dall'interfaccia.
|
||||
@@ -0,0 +1,80 @@
|
||||
# Come si sviluppa Anubis
|
||||
|
||||
Regole di lavoro per chi scrive il codice, persona o agente. Riassumono le sezioni 2, 3, 16 e 19 della specifica 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) |
|
||||
| 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, 3, 16 e 19.
|
||||
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.
|
||||
- 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 `make check` passato, immagine Docker costruita e, per le schermate, screenshot Playwright confrontati con i mockup. "Dovrebbe funzionare" non è una prova.
|
||||
|
||||
**Codice (SPEC 3, 16, 19)**
|
||||
- Denaro, prezzi e quantità sempre `Decimal`, mai `float`; sul database il tipo decimale personalizzato di 5.4.
|
||||
- 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 nel process pool, mai nell'event loop.
|
||||
- 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 `frontend/src/lib/format.ts`.
|
||||
|
||||
**Dipendenze (SPEC 2.7)**
|
||||
- Ultime versioni stabili, fissate con lockfile; prima di aggiungere una libreria controlla ultimo rilascio e licenza.
|
||||
- Vietate: `pandas-ta`, `backtrader`, `ib_insync`, `mlfinlab`, `timeseriescv`.
|
||||
|
||||
## Schermate
|
||||
|
||||
Per ogni schermata: implementa, apri con Playwright sui dati dimostrativi (`make seed-demo`) a 1440 e 390 pixel, fotografa, 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 costruito con `make desktop-win` su Windows e allegato alla release `v*`.
|
||||
- **Unraid**: `deploy/unraid/anubis.xml`, da copiare in `/boot/config/plugins/dockerMan/templates-user/`.
|
||||
@@ -0,0 +1,40 @@
|
||||
# 0001 — Il bot si chiama Anubis
|
||||
|
||||
Data: 2026-11-09 · Stato: accettata
|
||||
|
||||
## Contesto
|
||||
|
||||
La specifica è nata con il nome provvisorio "Giano" e prevede che, se l'utente ne sceglie un altro, il nome nuovo si applichi ovunque prima di cominciare e si registri nel primo ADR. L'utente ha scelto **Anubis**, e il repository su Gitea ha già questo nome (`BalboSoft/Anubis`).
|
||||
|
||||
## Decisione
|
||||
|
||||
Il nome è Anubis in ogni punto in cui la specifica diceva Giano:
|
||||
|
||||
| Dove | Prima | Adesso |
|
||||
|---|---|---|
|
||||
| Nome mostrato (interfaccia, Telegram, diario, manuali) | Giano | Anubis |
|
||||
| Pacchetto Python e cartella del backend | `giano` | `anubis` |
|
||||
| Prefisso delle variabili d'ambiente | `GIANO_` | `ANUBIS_` |
|
||||
| Prefisso di tre lettere del `client_order_id` | `GIA` | `ANU` |
|
||||
| Comando desktop | `giano-desktop` | `anubis-desktop` |
|
||||
| Database e utente PostgreSQL predefiniti | `giano` | `anubis` |
|
||||
| File SQLite | `giano.sqlite3` | `anubis.sqlite3` |
|
||||
| Cartella dati su desktop | `%APPDATA%\Giano` | `%APPDATA%\Anubis` |
|
||||
| Template e icona Unraid | `giano.xml`, `giano-icon.png` | `anubis.xml`, `anubis-icon.png` |
|
||||
| Immagine Docker | `…/giano` | `gitea.encke-hake.ts.net/balbosoft/anubis` |
|
||||
|
||||
`docs/SPEC.md` è la specifica originale con questa sola sostituzione: il paragrafo iniziale e una frase dell'appendice A, che parlavano del nome provvisorio, sono stati riscritti per dire che il nome è fissato qui. Nient'altro è cambiato.
|
||||
|
||||
Gli screen di `docs/design/` sono stati aggiornati nei soli punti in cui compariva il nome: il logo del menu in tutte le schermate, la legenda "Con Anubis" della Panoramica (computer e telefono) e la riga "Anubis 0.9.2 in Docker" del Diario. Il testo nuovo usa lo stesso carattere (Instrument Sans), lo stesso peso e la stessa linea di base; il testo che seguiva è stato spostato a destra della differenza di larghezza.
|
||||
|
||||
Il segno dei due semicerchi resta come logo, anche se nasceva dall'immagine dei due volti di Giano: è semplice, si legge bene a 20 pixel e la specifica lo usa per l'icona di Unraid. Se in futuro si vuole un segno più legato ad Anubis, si cambia con un nuovo ADR.
|
||||
|
||||
## Alternative scartate
|
||||
|
||||
- Tenere "Giano" nei nomi interni e cambiare solo quello mostrato: due nomi per la stessa cosa confondono nei registri, nelle variabili e nel template Unraid.
|
||||
- Cambiare anche il logo adesso: nessuna indicazione dall'utente, e il segno attuale funziona.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- A progetto avviato il nome mostrato si cambia in una sola costante; i nomi interni (variabili, prefisso degli ordini, pacchetto) restano questi, perché il prefisso `ANU` è dentro gli identificativi degli ordini già inviati.
|
||||
- Chi legge la specifica trova già i nomi giusti: non serve tradurre mentalmente `GIANO_` in `ANUBIS_`.
|
||||
@@ -0,0 +1,27 @@
|
||||
# 0002 — Gitea per lavori, pacchetto Docker e installatore
|
||||
|
||||
Data: 2026-11-09 · Stato: accettata
|
||||
|
||||
## Contesto
|
||||
|
||||
Il codice sta su un Gitea personale (`https://gitea.encke-hake.ts.net/BalboSoft/Anubis`, in rete locale anche `http://192.168.30.23:3000`). L'utente vuole seguire lo sviluppo da lì: lavori con i loro passi, pacchetto Docker nella sezione Packages del repository, installatore per Windows. La specifica (2.4) tiene la memoria del progetto in file del repository: `ROADMAP.md` e `STATE.md`.
|
||||
|
||||
## Decisione
|
||||
|
||||
- **Lavori**: una milestone per fase (Fase 0 … Fase 10, più "Fasi opzionali") e una issue per ogni lavoro della fase, con passi da spuntare e i criteri di accettazione a cui contribuisce. Ogni fase ha in più una issue "Chiusura della fase N" con l'elenco completo dei criteri, la revisione indipendente e il tag `fase-N`.
|
||||
- **Etichette**: quelle standard di Gitea già presenti (`Kind/*`, `Priority/*`, `Status/*`) più `Area/*` per la parte del sistema, `Kind/Chiusura fase` e `Status/In attesa utente` per i criteri che dipendono da chiavi o conferme dell'utente (SPEC 2.3).
|
||||
- **Fonte di verità**: la specifica resta `docs/SPEC.md`. Le issue sono il piano operativo; `docs/ROADMAP.md` le rispecchia con i numeri e i criteri, e si aggiorna insieme a loro. Se le due cose divergono, vale lo stato delle issue e si corregge `ROADMAP.md`.
|
||||
- **Pacchetto Docker**: immagine `gitea.encke-hake.ts.net/balbosoft/anubis`, pubblicata nel registry dei pacchetti di Gitea (tipo container) dalla CI sui soli tag `v*`, con `REGISTRY=gitea.encke-hake.ts.net`, `REGISTRY_USER` e `REGISTRY_TOKEN` (un token con permesso `write:package`) come segreti delle Actions. Il template Unraid `deploy/unraid/anubis.xml` punta già a questa immagine.
|
||||
- **Installatore Windows**: costruito con `make desktop-win` su Windows e allegato alla release `v*` del repository.
|
||||
|
||||
## Alternative scartate
|
||||
|
||||
- Una sola issue per fase con tutti i passi: troppo lunga da seguire, non permette di chiudere i lavori uno per volta.
|
||||
- Una issue per ogni singolo passo: centinaia di issue, rumore senza valore.
|
||||
- Pubblicare l'immagine su Docker Hub o GHCR: il codice e i lavori stanno su Gitea, il pacchetto deve stare accanto.
|
||||
|
||||
## Conseguenze
|
||||
|
||||
- Da verificare nella Fase 0: se l'istanza ha un esecutore di Gitea Actions attivo. Senza, la CI gira in locale con `make ci` e la pubblicazione si fa a mano (`docker login gitea.encke-hake.ts.net`, `docker push`), come prevede la SPEC 15.5.
|
||||
- Da verificare nella Fase 9: che il server Unraid raggiunga il registry. `gitea.encke-hake.ts.net` è un nome Tailscale con HTTPS: funziona se Unraid è nella stessa rete Tailscale. In alternativa l'indirizzo locale `192.168.30.23:3000` è in HTTP e richiede di dichiararlo tra gli `insecure-registries` del Docker di Unraid. Il manuale spiega entrambe le strade.
|
||||
- I nomi dei pacchetti container su Gitea sono in minuscolo: `balbosoft/anubis`, anche se l'organizzazione si chiama `BalboSoft`.
|
||||
|
After Width: | Height: | Size: 1.3 MiB |
|
After Width: | Height: | Size: 1.1 MiB |
|
After Width: | Height: | Size: 837 KiB |
|
After Width: | Height: | Size: 1.0 MiB |
|
After Width: | Height: | Size: 819 KiB |
|
After Width: | Height: | Size: 1.1 MiB |
|
After Width: | Height: | Size: 1.0 MiB |
|
After Width: | Height: | Size: 833 KiB |
|
After Width: | Height: | Size: 360 KiB |