Files
Encelado/TradingBot/README.md
Alberto Balbo 64f3511695 Nuove: multi-strategy, indicatori avanzati, posizioni
- Sidebar portfolio con metriche dettagliate (Totale, Investito, Disponibile, P&L, ROI) e aggiornamento real-time
- Sistema multi-strategia: 8 strategie assegnabili per asset, voting decisionale, pagina Trading Control
- Nuova pagina Posizioni: gestione, chiusura manuale, P&L non realizzato, notifiche
- Sistema indicatori tecnici: 7+ indicatori configurabili, segnali real-time, raccomandazioni, storico segnali
- Refactoring TradingBotService per capitale, P&L, ROI, eventi
- Nuovi modelli e servizi per strategie/indicatori, persistenza configurazioni
- UI/UX: navigazione aggiornata, widget, modali, responsive
- Aggiornamento README e CHANGELOG con tutte le novità
2026-01-06 17:49:07 +01:00

164 lines
4.4 KiB
Markdown

# ?? TradingBot
**Automated Crypto Trading Bot** con interfaccia Blazor Server per trading algoritmico simulato.
[![.NET 10](https://img.shields.io/badge/.NET-10.0-512BD4)](https://dotnet.microsoft.com/)
[![Blazor](https://img.shields.io/badge/Blazor-Server-512BD4)](https://blazor.net/)
[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED)](https://www.docker.com/)
[![Version](https://img.shields.io/badge/version-1.5.2-blue)](https://gitea.encke-hake.ts.net/Alby96/Encelado/-/packages)
---
## ? Caratteristiche
- **Multi-Strategy Trading**: 8 strategie professionali assegnabili a ogni asset
- **Positions Management**: Visualizza e chiudi manualmente posizioni aperte
- **Detailed Portfolio Metrics**: Capitale totale, investito, disponibile, P&L, ROI
- **Trading Control**: Gestione visuale strategie con voting system
- **Dashboard Blazor**: Real-time updates ogni 3 secondi
- **15 Criptovalute**: BTC, ETH, BNB, ADA, SOL, XRP, DOT, DOGE, AVAX, MATIC, LINK, LTC, UNI, ATOM, XLM
- **Analisi Tecnica**: SMA, EMA, RSI, MACD, Bollinger Bands, Stochastic
- **Indicators System**: 7+ indicatori tecnici configurabili con segnali real-time
- **Portfolio Management**: Gestione automatizzata posizioni
- **Trade Persistence**: Salvataggio automatico trade e posizioni attive
- **Comprehensive Logs**: Sistema di logging real-time con filtri avanzati
- **Docker Ready**: Container ottimizzato con health checks
---
## ?? Trading Strategies
### **8 Strategie Professionali**
1. **RSI Strategy** - Oscillator (Medium Risk)
2. **MACD Strategy** - Momentum (Medium Risk)
3. **Bollinger Bands** - Volatility (Low Risk)
4. **Mean Reversion** - Contrarian (High Risk)
5. **Momentum** - Trend Following (Medium Risk)
6. **EMA Crossover** - Golden/Death Cross (Low Risk)
7. **Scalping** - Short-term (Very High Risk)
8. **Breakout** - Volatility Breakout (High Risk)
### **Multi-Strategy System**
- Assegna multiple strategie per asset
- Sistema di voting per decisioni aggregate
- Confidence-based trading
- Parametri configurabili per strategia
---
## ?? Quick Start
### Locale (Development)
```bash
git clone https://gitea.encke-hake.ts.net/Alby96/Encelado
cd Encelado/TradingBot
dotnet run
```
Accedi a: `http://localhost:5243`
### Docker
```bash
docker pull gitea.encke-hake.ts.net/alby96/encelado/tradingbot:latest
docker run -d -p 8888:8080 \
-v tradingbot-data:/app/data \
gitea.encke-hake.ts.net/alby96/encelado/tradingbot:latest
```
Accedi a: `http://localhost:8888`
### Unraid
Guida completa: [deployment/UNRAID_INSTALL.md](deployment/UNRAID_INSTALL.md)
```bash
# 1. Login Gitea Registry
docker login gitea.encke-hake.ts.net
# 2. Download template
wget -O /boot/config/plugins/dockerMan/templates-user/TradingBot.xml \
https://gitea.encke-hake.ts.net/Alby96/Encelado/raw/branch/main/TradingBot/deployment/unraid-template.xml
# 3. Install via Unraid Docker UI
```
---
## ?? Versioning
### Current Version: `1.5.2`
**Latest**: Metriche dettagliate capitale in sidebar (Totale, Investito, Disponibile, P&L, ROI)
```powershell
# Bug fix (1.5.2 ? 1.5.3)
.\bump-version.ps1 patch -Message "Fix calculation bug"
# New feature (1.5.2 ? 1.6.0)
.\bump-version.ps1 minor -Message "Add new strategy"
# Breaking change (1.5.2 ? 2.0.0)
.\bump-version.ps1 major -Message "New API"
```
Vedi [CHANGELOG.md](CHANGELOG.md) per release notes complete.
---
## ?? Publishing
### Da Visual Studio
1. **Build** ? **Configuration Manager** ? **Release**
2. **Build** ? **Publish TradingBot** ? Profilo **Docker**
3. Click **Publish**
Il sistema automaticamente:
- ? Build Docker image
- ? Tag: `latest`, `1.5.1`, `1.5.1-20241222`
- ? Push su Gitea Registry
### Deploy su Unraid
```bash
# Docker tab ? TradingBot ? Stop ? Force Update ? Start
```
---
## ?? Documentazione
- **[UNRAID_INSTALL.md](deployment/UNRAID_INSTALL.md)** - Installazione completa su Unraid
- **[CHANGELOG.md](CHANGELOG.md)** - Release notes e versioni
- **[Dockerfile](Dockerfile)** - Docker multi-stage build
- **[docker-compose.yml](deployment/docker-compose.yml)** - Deploy con Compose
---
## ??? Tecnologie
- **.NET 10** | **Blazor Server** | **C# 14**
- **Bootstrap 5.3** | **Docker** | **Gitea Registry**
---
## ?? License
MIT License - Copyright © 2024 Alby96
---
## ?? Autore
**Alberto** (Alby96)
- Gitea: [@Alby96](https://gitea.encke-hake.ts.net/Alby96)
- Repository: [Encelado/TradingBot](https://gitea.encke-hake.ts.net/Alby96/Encelado)
---
**?? Happy Trading!**