Add core infrastructure: config, Binance adapter, docs, and auto-setup

- Add Pydantic settings with trading mode validation (paper/testnet/live)
- Implement Binance USDⓈ-M Futures adapter with hedge mode, isolated margin
- Add type definitions for orders, positions, and market data
- Create documentation (PLAN.md, ARCHITECTURE.md, SECURITY.md)
- Add setup.sh with uv/pip auto-detection for consistent dev environments
- Configure Docker multi-stage build and docker-compose services
- Add pyproject.toml with all dependencies and tool configs

.env.example

@@ -0,0 +1,73 @@
+# TradeFinder Environment Configuration
+# Copy this file to .env and fill in your values
+# NEVER commit .env to version control
+
+# =============================================================================
+# BINANCE CONFIGURATION
+# =============================================================================
+# For testnet, get keys from: https://testnet.binancefuture.com/
+# For production (later), get from: https://www.binance.com/en/my/settings/api-management
+
+# Testnet API keys (safe for paper trading)
+BINANCE_TESTNET_API_KEY=your_testnet_api_key_here
+BINANCE_TESTNET_SECRET=your_testnet_secret_here
+
+# Production API keys (ONLY for live trading - leave empty initially)
+# BINANCE_API_KEY=
+# BINANCE_SECRET=
+
+# =============================================================================
+# TRADING CONFIGURATION
+# =============================================================================
+# Paper trading equity (in USDT)
+PAPER_EQUITY_USDT=3000.0
+
+# Risk parameters
+RISK_PER_TRADE_PCT=2.0          # 1-3% risk per trade
+MAX_EQUITY_PER_STRATEGY_PCT=25.0 # Max 25% per strategy
+MAX_LEVERAGE=2                   # Fixed leverage initially
+
+# Symbols to trade (comma-separated)
+SYMBOLS=BTCUSDT,ETHUSDT
+
+# Timeframes
+SIGNAL_TIMEFRAME=4h
+EXECUTION_TIMEFRAME=1m
+
+# =============================================================================
+# DATABASE CONFIGURATION
+# =============================================================================
+# DuckDB file path (relative to data mount)
+DUCKDB_PATH=/data/tradefinder.duckdb
+
+# =============================================================================
+# FX RATES (for CHF/EUR conversion)
+# =============================================================================
+# You can use a free API like exchangerate-api.com
+# FX_API_KEY=your_fx_api_key_here
+
+# =============================================================================
+# EMAIL REPORTS (optional, later feature)
+# =============================================================================
+# SMTP_HOST=smtp.gmail.com
+# SMTP_PORT=587
+# SMTP_USER=your_email@gmail.com
+# SMTP_PASSWORD=your_app_password
+# REPORT_RECIPIENT=your_email@example.com
+
+# =============================================================================
+# STREAMLIT UI
+# =============================================================================
+STREAMLIT_PORT=8501
+
+# =============================================================================
+# LOGGING
+# =============================================================================
+LOG_LEVEL=INFO
+LOG_FORMAT=json  # json or console
+
+# =============================================================================
+# MODE
+# =============================================================================
+# Options: paper, testnet, live
+TRADING_MODE=testnet