Aggiorna e riorganizza la documentazione del progetto

- Sostituito README.md con versione avanzata e strutturata (indice, badge, quick start, deployment, troubleshooting, roadmap, credits)
- Aggiunto .gitignore completo per .NET, Docker, VSCode, log, dati locali e secrets
- Creato .env.example con tutte le variabili d’ambiente documentate per Docker/Unraid
- Aggiunti script organize-docs.ps1/.sh per strutturare e spostare la documentazione in docs/
- Aggiornate e migliorate tutte le guide tecniche (Docker, Unraid, Git workflow, troubleshooting, verifica finale)
- Documentazione ora pronta per ambienti di produzione, collaborazione e manutenzione
This commit is contained in:
2025-12-13 00:24:58 +01:00
parent b2f04b6600
commit e414123cd0
12 changed files with 1171 additions and 2302 deletions

107
TradingBot/.env.example Normal file
View File

@@ -0,0 +1,107 @@
# TradingBot - Environment Variables Example
# Copia questo file come .env e personalizza i valori
# ==============================================
# DOCKER CONFIGURATION
# ==============================================
# Timezone (importante per trading!)
TZ=Europe/Rome
# ASP.NET Core Environment
ASPNETCORE_ENVIRONMENT=Production
# Logging Level
# Options: Trace, Debug, Information, Warning, Error, Critical
Logging__LogLevel__Default=Information
# ==============================================
# APPLICATION SETTINGS
# ==============================================
# Modalità Simulazione (true = dati simulati, false = dati reali)
TRADINGBOT__SimulationMode=true
# Auto-start bot all'avvio
TRADINGBOT__AutoStartBot=true
# Intervallo aggiornamento dati (secondi)
# Min: 2, Max: 10, Consigliato: 3
TRADINGBOT__UpdateIntervalSeconds=3
# Notifiche Desktop (true/false)
TRADINGBOT__DesktopNotifications=false
# Conferma operazioni manuali (true/false)
TRADINGBOT__ConfirmManualTrades=false
# Log Level applicazione
# Options: Error, Warning, Info, Debug
TRADINGBOT__LogLevel=Info
# ==============================================
# DOCKER COMPOSE OVERRIDES
# ==============================================
# Porta esterna (modifica se 8080 è già in uso)
EXTERNAL_PORT=8080
# Resource Limits
MEMORY_LIMIT=1G
MEMORY_RESERVATION=256M
CPU_LIMIT=2.0
CPU_RESERVATION=0.5
# ==============================================
# REGISTRY (opzionale - per push immagini)
# ==============================================
# Docker Registry URL (lascia vuoto se non usi registry privato)
DOCKER_REGISTRY=
# Registry username
REGISTRY_USER=
# Registry password (usa Docker secrets in produzione!)
REGISTRY_PASSWORD=
# ==============================================
# BACKUP (opzionale)
# ==============================================
# Directory backup su host
BACKUP_DIR=/mnt/user/backups/tradingbot
# Retention giorni backup
BACKUP_RETENTION_DAYS=7
# ==============================================
# MONITORING (opzionale)
# ==============================================
# Prometheus metrics endpoint (true/false)
ENABLE_METRICS=false
# Health check interval (seconds)
HEALTHCHECK_INTERVAL=30
# ==============================================
# ADVANCED
# ==============================================
# HTTPS Redirection (true/false)
# Disabilita se usi reverse proxy
ASPNETCORE_HTTPS_PORT=
# Kestrel limits
KESTREL_LIMITS_MAXREQUESTBODYSIZE=10485760
# ==============================================
# NOTES
# ==============================================
#
# 1. Non committare questo file con credenziali reali!
# 2. Aggiungi .env al .gitignore
# 3. Usa Docker secrets per password in produzione
# 4. Restart container dopo modifiche: docker-compose restart
#