JLツTrade – Hybrid Trading System
  • Python 44.6%
  • TypeScript 34.9%
  • Go 17.2%
  • Shell 1.2%
  • CSS 1.2%
  • Other 0.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
JL-Spark a25ccf2ad8 docs: Projektstruktur konsistent zu code
- AGENTS.md: Projekt-Map auf aktuelle Struktur (archive/, bot_base.py,
  prompts.py; user_bot aus bots/ entfernt)
- README.md: Struktur-Diagramm aktualisiert (handler split in
  handlers_auth/handlers_users, jltrade-Module, archive/), Verweise
  auf user_bot angepasst
2026-07-31 19:59:01 +02:00
api security: H3 JWT-Secret-Warnung statt stillem Fallback 2026-07-31 19:44:43 +02:00
archive refactor: K5 starting_cash-Default zentralisieren + K2 vervollständigt 2026-07-31 19:09:01 +02:00
bots refactor: K6 KI-Prompts nach jltrade/prompts.py ausgelagert 2026-07-31 19:29:53 +02:00
config jltrade v0.2 — laufende Konfig + systemd-Units 2026-07-18 19:18:09 +02:00
deploy Per-User Konfiguration: Portfolio in DB + Admin-Panel 2026-07-18 20:43:30 +02:00
ui fix(ui): equity from backend, fix blocking TS errors 2026-07-31 17:53:25 +02:00
.dockerignore Phase 5.4: Docker-Compose für lokale Entwicklung 2026-07-25 11:43:24 +02:00
.env.example Schema, Architektur, .env.example, requirements, README 2026-07-18 19:30:13 +02:00
.gitignore refactor(bots): DRY - bot_base.py für get_conn/db_heartbeat/risk_limits/LLM 2026-07-31 18:14:45 +02:00
AGENTS.md docs: Projektstruktur konsistent zu code 2026-07-31 19:59:01 +02:00
AI-INTEGRATION.md fix: Bot-Robustheit — Heartbeat-Task, Start/Stop via Event, Config-Update-Listener, DB-Auto-Reconnect 2026-07-26 16:09:31 +02:00
ARCHITECTURE.md Docs: ARCHITECTURE.md komplett überarbeitet (aktueller Stand), Session-Docs + JL-SPARK finalisiert 2026-07-26 21:25:19 +02:00
check_login.py debug: add logging to GetWatchlist handler 2026-07-25 14:36:50 +02:00
check_nan.sh fix: sanitize NaN values in GetWatchlist response (Go json cannot marshal NaN) 2026-07-25 14:41:58 +02:00
check_watchlist.py debug: add logging to GetWatchlist handler 2026-07-25 14:36:50 +02:00
CODE_QUALITY.md docs: K6/K3/H3 Fortschritt dokumentiert 2026-07-31 19:47:27 +02:00
CODE_REVIEW.md Code Review: 114 Issues (Go API, Python Bots, React UI) 2026-07-26 21:47:56 +02:00
CODE_REVIEW_FINAL.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
CODE_REVIEW_NOTES.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
CODE_REVIEW_V2.md Code Review V2: Korrektur mit 44 herabgestuften Issues, 70 final, Top-10 priorisiert 2026-07-26 21:52:14 +02:00
CODE_REVIEW_V3.md fix(ui): equity from backend, fix blocking TS errors 2026-07-31 17:53:25 +02:00
docker-compose.yml feat: Zeitzone Europe/Berlin für alle Container + Log-Timestamps lokal 2026-07-26 17:28:22 +02:00
Dockerfile.api Fix Dockerfile: vite build direkt (ohne tsc -b) wie alte Build-Pipeline 2026-07-25 12:38:54 +02:00
Dockerfile.bots Phase 5.4: Docker-Compose für lokale Entwicklung 2026-07-25 11:43:24 +02:00
drop_user.sh debug: add logging to GetWatchlist handler 2026-07-25 14:36:50 +02:00
fix_password.py debug: add logging to GetWatchlist handler 2026-07-25 14:36:50 +02:00
fix_password.sh debug: add logging to GetWatchlist handler 2026-07-25 14:36:50 +02:00
FIX_PLAN.md Phase 1.1: Login auf JSON-Body umgestellt 2026-07-25 11:07:45 +02:00
JL-SPARK.md refactor: K5 starting_cash-Default zentralisieren + K2 vervollständigt 2026-07-31 19:09:01 +02:00
Makefile fix: TS type errors, typed arrays, docker restart policy, empty catch blocks 2026-07-26 10:50:57 +02:00
README.md docs: Projektstruktur konsistent zu code 2026-07-31 19:59:01 +02:00
reset_user.sh debug: add logging to GetWatchlist handler 2026-07-25 14:36:50 +02:00
REVIEW_PYTHON_01.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
REVIEW_PYTHON_02.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
REVIEW_PYTHON_03.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
REVIEW_PYTHON_04.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
REVIEW_PYTHON_05.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
REVIEW_UI_01.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
REVIEW_UI_02.md Code Review FINAL: 87 Issues (0 CRITICAL, 5 HIGH, 47 MEDIUM, 35 LOW) – alle Einzelfälle geprüft 2026-07-26 22:04:06 +02:00
SESSION_SUMMARY.md docs: K6/K3/H3 Fortschritt dokumentiert 2026-07-31 19:47:27 +02:00
test_wl.sh fix: sanitize NaN values in GetWatchlist response (Go json cannot marshal NaN) 2026-07-25 14:41:58 +02:00

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