jltrade — Multi-User Paper Trading Platform
jltrade ist eine vollständige Paper-Trading-Plattform mit Echtzeit-Marktdaten, KI-gestützten Handelsstrategien (BUY/SELL/HOLD), zwei spezialisierten Bot-Prozessen und einem browserbasierten Dashboard mit Live-Log-Fenster. Läuft als Docker-Compose-Cluster auf einem lokalen Server.
Live: http://192.168.99.75:8080 (nofx)
Repo: https://git.ki-tools.business/lewald/jltrade
Architektur
┌──────────────────────────────────────┐
│ PostgreSQL (DB) │
│ user_configs, market_data, │
│ symbol_factors, portfolios, │
│ signals, heartbeat, users │
└──────┬────────────────────▲───────────┘
│ │
┌──────────────▼──────┐ ┌────────┴───────────┐
│ Data Bot (Py) │ │ Watchlist Bot (Py) │
│ Marktdaten holen │ │ BUY-Signale (KI) │
│ Indikatoren (RSI, │ │ Quant-Strategien │
│ MACD, SMA, etc.) │ │ AI VETO │
│ Faktor-Scores │ └───────▲─────────────┘
└──────────┬─────────┘ │
│ NATS │ NATS
┌──────────▼──────────────────────┴──────────────┐
│ Go API (jltrade-api) │
│ HTTP REST (8080) + WebSocket + NATS-Client │
│ Embedded UI (//go:embed ui/dist/) │
│ API = Source of Truth für Portfolio-Daten │
└──────────┬─────────────────────────────────────┘
│ WebSocket
┌──────────▼──────────────────────────────────────┐
│ Browser (React SPA) │
│ Dashboard + Live Log (eigenes Fenster) │
│ Bot-Status (📊👁💼) + Start/Stop │
│ Settings (6 Tabs) │
└─────────────────────────────────────────────────┘
Bot-Architektur (zwei spezialisierte Bots)
| Bot |
Aufgabe |
KI-Frage |
Zyklus |
Output |
| Data Bot |
Marktdaten holen + Indikatoren |
— |
120s |
market_data, symbol_factors in DB + NATS |
| Watchlist Bot |
BUY-Signale generieren |
"BUY oder NOT?" |
60s |
signals-Tabelle + NATS user.{id}.signal |
| Portfolio Bot |
Trades ausführen + Positionen managen |
"SELL oder HOLD?" |
10s |
Portfolio-DB + NATS user.{id}.trade |
Die KI hat VETO-Recht – wenn sie NOT sagt, werden Quant-BUY-Signale verworfen.
Komponenten & Verantwortlichkeiten
1. Python: Data Bot (bots/data_bot.py)
| Aufgabe |
Beschreibung |
| Symbol-Ladung |
Lädt alle Symbole aus allen User-Watchlists |
| Quote-Fetch |
Finnhub (Priority 10) → Yahoo (Priority 20) |
| History-Fetch |
90 Tage für Indikatoren |
| Indikatoren |
RSI(14), MACD(12,26,9), SMA(20), SMA(50), Bollinger(20,2), ATR(14) |
| Faktor-Scores |
Momentum, Volatility, Quality, Composite (0-1) |
| Batch-DB |
execute_values() — 1 SQL für alle Symbole |
| Reihenfolge |
DB zuerst, dann NATS (Konsistenz) |
| Heartbeat |
data_bot in heartbeat-Tabelle |
2. Python: Watchlist Bot (bots/watchlist_bot.py) — NEU
| Aufgabe |
Beschreibung |
| Signal-Generierung |
Nur BUY-Signale für Symbole nicht im Portfolio |
| Quant-Strategien |
Multi-Factor Momentum/Quality/Volatility |
| KI-Strategie |
ai_call_buy() – LLM entscheidet BUY oder NOT |
| AI VETO |
KI überschreibt Quant-BUY wenn sie NOT sagt |
| Risk-Limits |
max_position_pct, max_open_positions werden erzwungen |
| DB |
Speichert Signale in signals-Tabelle (PENDING) |
| NATS |
user.{id}.signal + user.{id}.log (inkl. AI-Prompt/Response) |
| Config |
Per-User aus strategy_json.llm (Settings → AI Tab) |
| Heartbeat |
watchlist_bot |
3. Python: Portfolio Bot (bots/portfolio_bot.py) — NEU
| Aufgabe |
Beschreibung |
| Trade-Execution |
Liest PENDING BUY-Signale aus signals-Tabelle |
| Positionen-Managen |
Analysiert Positionen → KI "SELL oder HOLD?" |
| SimBroker |
Eigenes Cash + Positionen pro User |
| DB-Save |
save_portfolio() mit Positions + __CASH__ |
| Reihenfolge |
Erst DB speichern, dann NATS publish (kein Race-Condition) |
| NATS |
user.{id}.trade (nur Trade-Events, kein volles Portfolio) |
| Heartbeat |
portfolio_bot |
4. Go API (api/)
| Bereich |
Beschreibung |
| REST API |
http.ServeMux mit Method-Patterns (Go 1.25) |
| Auth |
JWT HS256, 24h, bcrypt |
| DB |
pgx/v5, Auto-Migration (6 Versionen) |
| NATS |
Subscribe auf market.data.> + user.*.trade + user.*.log |
| WebSocket |
Per-User-Routing, Token im Query-String |
| Bot-Status |
GET /api/bot/status → per Bot (data/watchlist/portfolio) |
| Bot-Start/Stop |
POST /api/bot/start?name=X + POST /api/bot/stop?name=X |
| Symbol-Suche |
Yahoo Finance Proxy, filtert: EQUITY+ETF, US+DE-Börsen |
| Portfolio |
API = Source of Truth (Bot schreibt kein Portfolio mehr via NATS) |
| Reset |
POST /api/portfolio/reset → löscht + legt sofort neu an |
5. Frontend: React SPA (ui/)
| Seite |
Pfad |
Beschreibung |
| Dashboard |
/#/ |
Watchlist + Positionen + Bot-Status + Stats |
| Live Log |
/#/live-log |
Eigenes Fenster (📋 Log Button), AI Split-View |
| Admin |
/#/admin |
User-Verwaltung |
| Login |
/#/login |
Login-Formular |
Dashboard-Features:
- 🟢🔴 Bot-Status-Icons (📊 Data Bot, 👁 Watchlist Bot, 💼 Portfolio Bot)
- Start/Stop-Buttons pro Bot (Admin)
- 3s Polling für Portfolio + Bot-Status
- Market-WebSocket aktualisiert Positionen + Equity live
- Trade-Event → sofort Portfolio von API laden
- ⟳ Reset mit Bestätigungsdialog
Datenbank-Tabellen
| Tabelle |
Zweck |
users |
User-Accounts |
user_configs |
User-Konfiguration (watchlist, strategy_json, risk_json, ...) |
market_data |
OHLC + Indikatoren |
symbol_factors |
Faktor-Scores (Momentum, Volatility, Quality) |
portfolios |
Positionen + Cash (__CASH__-Row) |
signals |
Trading-Signale (PENDING → EXECUTED/EXPIRED) |
symbol_info |
Firmennamen |
heartbeat |
Bot-Health (180s Fenster) |
orders |
Order-Historie |
schema_version |
DB-Migrationen |
NATS Subjects
| Subject |
Richtung |
Payload |
market.data.{symbol} |
Data Bot → WS |
MarketSnapshot (price, rsi_14, macd, ...) |
user.{id}.trade |
Portfolio Bot → WS |
TradeEvent (action, symbol, qty, price) |
user.{id}.log |
Beide Bots → WS |
LogEntry (level, message, ai-prompt/response) |
cmd.start / cmd.stop |
API → Bots |
{"target":"bot_name"} |
cmd.{id}.reset |
API → Portfolio Bot |
Cache leeren nach Reset |
Konfiguration (Settings UI)
| Tab |
Felder |
DB-Spalte |
| General |
Startkapital, Bot Enabled |
starting_cash, bot_enabled |
| Data Sources |
Finnhub Key, Search Provider |
finnhub_key, data_json |
| Strategy |
Aktive Strategie + Parameter |
strategy_json |
| AI |
Endpoint, Model, API-Key, Confidence, Temperature, Cache |
strategy_json.llm |
| Risk |
Max Position%, Daily Loss%, Open Positions |
risk_json |
| Hours |
Trading Hours, Always On |
risk_json |
Entwicklung
Schnellstart
# 1. DB + NATS
docker compose up -d postgres nats
# 2. UI bauen
cd ui && npm install --no-bin-links --include=dev
node node_modules/vite/dist/node/cli.js build
# 3. API bauen + starten
cd ../api
go build -o jltrade-api.exe .
JTRADE_PG_DSN="postgres://jltrade:jltrade-pg-2026@localhost:5432/jltrade?sslmode=disable" \
JTRADE_NATS_URL="nats://localhost:4222" \
JTRADE_JWT_SECRET="dev-secret" \
JTRADE_PORT="8080" \
./jltrade-api.exe
Deployment
git push
ssh root@192.168.99.75 "cd /opt/jltrade-api && git pull && \
docker compose build --no-cache && \
docker compose up -d --force-recreate --remove-orphans"
Projekt-Struktur
jltrade/
├── api/ # Go API
│ ├── main.go # Entrypoint, Routing
│ └── internal/
│ ├── auth/auth.go # JWT
│ ├── db/db.go # Migrationen + Queries
│ ├── handlers/ # HTTP-Handler (nach Domäne aufgeteilt)
│ │ ├── handlers.go # Config/Watchlist/Portfolio/Bots/Factors/AI
│ │ ├── handlers_auth.go # Login, Me, getUser/requireUser
│ │ └── handlers_users.go # User-CRUD
│ ├── nats/ # NATS-Client + Subject-Defs
│ └── ws/ws.go # WebSocket Hub
├── bots/ # Python Bots
│ ├── data_bot.py # Marktdaten
│ ├── watchlist_bot.py # BUY-Signale (KI + Quant)
│ ├── portfolio_bot.py # Trades ausführen (SELL/HOLD)
│ ├── backtest_runner.py # [DEPRECATED]
│ └── jltrade/ # Shared Package
│ ├── bot_base.py # get_conn/db_heartbeat/risk_limits/LLM/Env (DRY)
│ ├── prompts.py # KI-System-Prompts (BUY/SELL)
│ ├── market_hours.py # Börsenzeiten
│ ├── providers/ # Finnhub, Yahoo
│ ├── factors/ # Indikatoren, Scores
│ ├── strategies/ # Multi-Factor, Momentum, Quality
│ └── backtest/ # [DEPRECATED]
├── ui/ # React SPA
│ └── src/
│ ├── pages/ # Login, Dashboard, LiveLog, Admin, Debug
│ ├── components/ # Settings (6 Tabs), HelpIcon
│ ├── api.ts # REST-Client
│ ├── useWebSocket.ts # WebSocket
│ └── types.ts # Interfaces
├── config/ # settings.yaml
├── archive/ # [LEGACY] ausgemusterte Bots
│ ├── api_bots_legacy/ # data_bot.py, user_bot.py (aus api/bots/)
│ └── root_bots_legacy/ # user_bot.py (alter kombinierter Bot)
├── docker-compose.yml # 6 Services
├── Dockerfile.api / .bots
├── AGENTS.md # Agent Guide
├── ARCHITECTURE.md # Architektur
├── AI-INTEGRATION.md # KI-Integration
├── CODE_QUALITY.md # Code-Qualitäts-Audit
└── JL-SPARK.md # Learning Log & Error Patterns
Wichtige Notes
- Default Admin:
blau34 / admin
- Hard Refresh (Strg+F5) nach UI-Deployment
- LLM-Endpoint:
http://192.168.99.36:8888/v1 (OpenAI-kompatibel)
- 6 Docker-Services: postgres, nats, api, data-bot, watchlist-bot, portfolio-bot
- Bot-Status-Fenster: 180s (Herausfall bei längerer Inaktivität)
- Kein
npx (SMB/CIFS) → node node_modules/vite/dist/node/cli.js build