# jan-soh/ta4j-showcase architecture

> Architecture diagram of the GitHub repository jan-soh/ta4j-showcase, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jan-soh/ta4j-showcase
- Repository: https://github.com/jan-soh/ta4j-showcase

## Overview

TA4J Showcase is an educational Binance USDM futures strategy runner. Configured strategies receive historical and live klines, evaluate entry/exit conditions, and delegate position execution and tracking; closed positions are persisted and position events are reported through the configured messaging service. The graph preserves the documented workflow and major strategy, feed, execution, persistence, and notification capabilities. Some connections are supported only by the README or SOURCE INDEX; unsampled implementations are not assumed to expose additional behavior.

Main entry points: [`src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java`](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java) (Position service), [`src/main/java/de/jansoh/rsistrategy/service/strategy/StrategyService.java`](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/strategy/StrategyService.java) (Strategy service), [`src/main/java/de/jansoh/rsistrategy/service/broker/binance/BinanceApiService.java`](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/broker/binance/BinanceApiService.java) (Binance API client), [`src/main/java/de/jansoh/rsistrategy/service/kline/BinanceKlinesProvider.java`](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/kline/BinanceKlinesProvider.java) (Klines provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market_data["Market data"]
  node_klines["Klines provider"]
  node_binance_api["Binance API client"]
end

subgraph group_strategy["Strategy evaluation"]
  node_app["Application startup<br/>[TA4JApp.java]"]
  node_strategy_service["Strategy service"]
  node_conditional["Conditional strategy"]
  node_ema_strategy["EMA cross strategy"]
  node_indicators["Indicator factories"]
end

subgraph group_trading["Position execution"]
  node_position_service["Position service"]
  node_open_registry["Open position registry"]
  node_order_events["Order event provider"]
  node_position_model["Position model<br/>[Position.java]"]
end

subgraph group_persistence["Persistence"]
  node_position_repository["Position repository"]
  node_order_repository["Order repository"]
  node_mysql[("MySQL database")]
end

subgraph group_messaging["Notifications"]
  node_message_service["Message service"]
  node_telegram_service["Telegram messaging"]
  node_console_messaging["Console messaging"]
end

node_operator(("Operator"))
node_binance["Binance futures"]
node_telegram["Telegram"]

node_operator -->|"starts"| node_app
node_app -->|"loads strategies"| node_strategy_service
node_strategy_service -->|"creates providers"| node_klines
node_klines -->|"loads history"| node_binance_api
node_binance_api -->|"requests market data"| node_binance
node_binance -->|"streams klines"| node_klines
node_klines -->|"publishes updates"| node_strategy_service
node_strategy_service -->|"evaluates signals"| node_conditional
node_conditional -.->|"uses implementation"| node_ema_strategy
node_ema_strategy -.->|"uses indicators"| node_indicators
node_strategy_service -->|"requests position actions"| node_position_service
node_position_service -->|"places orders"| node_binance_api
node_binance_api -->|"submits orders"| node_binance
node_position_service -->|"tracks positions"| node_open_registry
node_position_service -->|"starts event feed"| node_order_events
node_order_events -->|"manages user stream"| node_binance_api
node_order_events -.->|"updates position state"| node_open_registry
node_position_service -->|"persists closed positions"| node_position_repository
node_position_service -->|"stores orders"| node_order_repository
node_position_repository -->|"reads and writes"| node_mysql
node_order_repository -.->|"reads and writes"| node_mysql
node_position_service -->|"broadcasts alerts"| node_message_service
node_message_service -.->|"implemented by"| node_telegram_service
node_message_service -.->|"implemented by"| node_console_messaging
node_telegram_service -->|"sends notifications"| node_telegram
node_telegram_service -->|"queries positions"| node_position_repository
node_position_repository -->|"stores entities"| node_position_model

click node_app "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/TA4JApp.java"
click node_strategy_service "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/strategy/StrategyService.java"
click node_conditional "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/strategy/conditional/ConditionalStrategy.java"
click node_ema_strategy "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/strategy/implementation/conditional/emacrossstrategy/FastEmaCrossingSlowEmaStrategy.java"
click node_indicators "https://github.com/jan-soh/ta4j-showcase/tree/main/src/main/java/de/jansoh/rsistrategy/service/indicator"
click node_klines "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/kline/BinanceKlinesProvider.java"
click node_binance_api "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/broker/binance/BinanceApiService.java"
click node_position_service "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java"
click node_open_registry "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/position/OpenPositionRegistry.java"
click node_order_events "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/order/BinanceOrderEventProvider.java"
click node_position_model "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/model/Position.java"
click node_position_repository "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/repository/PositionRepository.java"
click node_order_repository "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/repository/OrderRepository.java"
click node_message_service "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/MessageService.java"
click node_telegram_service "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/TelegramMessagingService.java"
click node_console_messaging "https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/TestMessageService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_klines,node_binance_api toneBlue
class node_app,node_strategy_service,node_conditional,node_ema_strategy,node_indicators toneAmber
class node_position_service,node_open_registry,node_order_events,node_position_model toneMint
class node_position_repository,node_order_repository,node_mysql toneRose
class node_message_service,node_telegram_service,node_console_messaging,node_operator,node_binance,node_telegram toneIndigo
```

## Components

### Market data

- [Klines provider](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/kline/BinanceKlinesProvider.java): `src/main/java/de/jansoh/rsistrategy/service/kline/BinanceKlinesProvider.java`
- [Binance API client](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/broker/binance/BinanceApiService.java): `src/main/java/de/jansoh/rsistrategy/service/broker/binance/BinanceApiService.java`

### Strategy evaluation

- [Application startup](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/TA4JApp.java): `src/main/java/de/jansoh/rsistrategy/TA4JApp.java`
- [Strategy service](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/strategy/StrategyService.java): `src/main/java/de/jansoh/rsistrategy/service/strategy/StrategyService.java`
- [Conditional strategy](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/strategy/conditional/ConditionalStrategy.java): `src/main/java/de/jansoh/rsistrategy/service/strategy/conditional/ConditionalStrategy.java`
- [EMA cross strategy](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/strategy/implementation/conditional/emacrossstrategy/FastEmaCrossingSlowEmaStrategy.java): `src/main/java/de/jansoh/rsistrategy/service/strategy/implementation/conditional/emacrossstrategy/FastEmaCrossingSlowEmaStrategy.java`
- [Indicator factories](https://github.com/jan-soh/ta4j-showcase/tree/main/src/main/java/de/jansoh/rsistrategy/service/indicator): `src/main/java/de/jansoh/rsistrategy/service/indicator`

### Position execution

- [Position service](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java): `src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java`
- [Open position registry](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/position/OpenPositionRegistry.java): `src/main/java/de/jansoh/rsistrategy/service/position/OpenPositionRegistry.java`
- [Order event provider](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/order/BinanceOrderEventProvider.java): `src/main/java/de/jansoh/rsistrategy/service/order/BinanceOrderEventProvider.java`
- [Position model](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/model/Position.java): `src/main/java/de/jansoh/rsistrategy/model/Position.java`

### Persistence

- [Position repository](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/repository/PositionRepository.java): `src/main/java/de/jansoh/rsistrategy/repository/PositionRepository.java`
- [Order repository](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/repository/OrderRepository.java): `src/main/java/de/jansoh/rsistrategy/repository/OrderRepository.java`
- **MySQL database**

### Notifications

- [Message service](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/MessageService.java): `src/main/java/de/jansoh/rsistrategy/service/MessageService.java`
- [Telegram messaging](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/TelegramMessagingService.java): `src/main/java/de/jansoh/rsistrategy/service/TelegramMessagingService.java`
- [Console messaging](https://github.com/jan-soh/ta4j-showcase/blob/main/src/main/java/de/jansoh/rsistrategy/service/TestMessageService.java): `src/main/java/de/jansoh/rsistrategy/service/TestMessageService.java`

### Other components

- **Operator**
- **Binance futures**
- **Telegram**

## Connections

- Operator → Application startup: starts
- Application startup → Strategy service: loads strategies (evidence: `src/main/java/de/jansoh/rsistrategy/TA4JApp.java`)
- Strategy service → Klines provider: creates providers (evidence: `src/main/java/de/jansoh/rsistrategy/service/strategy/StrategyService.java`)
- Klines provider → Binance API client: loads history (evidence: `src/main/java/de/jansoh/rsistrategy/service/kline/BinanceKlinesProvider.java`)
- Binance API client → Binance futures: requests market data (evidence: `src/main/java/de/jansoh/rsistrategy/service/broker/binance/BinanceApiService.java`)
- Binance futures → Klines provider: streams klines (evidence: `src/main/java/de/jansoh/rsistrategy/service/kline/BinanceKlinesProvider.java`)
- Klines provider → Strategy service: publishes updates (evidence: `src/main/java/de/jansoh/rsistrategy/service/kline/BinanceKlinesProvider.java`)
- Strategy service → Conditional strategy: evaluates signals (evidence: `src/main/java/de/jansoh/rsistrategy/service/strategy/StrategyService.java`)
- Conditional strategy → EMA cross strategy: uses implementation
- EMA cross strategy → Indicator factories: uses indicators
- Strategy service → Position service: requests position actions (evidence: `src/main/java/de/jansoh/rsistrategy/service/strategy/StrategyService.java`)
- Position service → Binance API client: places orders (evidence: `src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java`)
- Binance API client → Binance futures: submits orders (evidence: `src/main/java/de/jansoh/rsistrategy/service/broker/binance/BinanceApiService.java`)
- Position service → Open position registry: tracks positions (evidence: `src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java`)
- Position service → Order event provider: starts event feed (evidence: `src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java`)
- Order event provider → Binance API client: manages user stream (evidence: `src/main/java/de/jansoh/rsistrategy/service/order/BinanceOrderEventProvider.java`)
- Order event provider → Open position registry: updates position state
- Position service → Position repository: persists closed positions (evidence: `src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java`)
- Position service → Order repository: stores orders (evidence: `src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java`)
- Position repository → MySQL database: reads and writes
- Order repository → MySQL database: reads and writes
- Position service → Message service: broadcasts alerts (evidence: `src/main/java/de/jansoh/rsistrategy/service/position/PositionService.java`)
- Message service → Telegram messaging: implemented by (evidence: `src/main/java/de/jansoh/rsistrategy/service/TelegramMessagingService.java`)
- Message service → Console messaging: implemented by (evidence: `src/main/java/de/jansoh/rsistrategy/service/TestMessageService.java`)
- Telegram messaging → Telegram: sends notifications (evidence: `src/main/java/de/jansoh/rsistrategy/service/TelegramMessagingService.java`)
- Telegram messaging → Position repository: queries positions (evidence: `src/main/java/de/jansoh/rsistrategy/service/TelegramMessagingService.java`)
- Position repository → Position model: stores entities (evidence: `src/main/java/de/jansoh/rsistrategy/repository/PositionRepository.java`)
