# jorkan2002/omniforexpairs architecture

> Architecture diagram of the GitHub repository jorkan2002/omniforexpairs, 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/jorkan2002/omniforexpairs
- Repository: https://github.com/jorkan2002/omniforexpairs

## Overview

FX Live Board combines a native Windows MT5 bridge, a container-served dashboard, and a separate FeneFX AI analysis service. The main workflow streams MT5 prices to the board; symbol analysis adds strategy levels, while account monitoring, automated trading, and Telegram signals are distinct capabilities. FeneFX AI fetches bridge data, analyzes it through a configured model provider, validates signals, and can post and track them. Some subsystem links rely on the README or SOURCE INDEX because their implementation excerpts were not shown.

Main entry points: [`windows-bridge/app.py`](https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/app.py) (Bridge API & polling), [`fenefx-engine/engine.py`](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/engine.py) (AI analysis orchestration), [`windows-bridge/signals.py`](https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/signals.py) (Signal tracking), [`fenefx-engine/market_data.py`](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/market_data.py) (Bridge data & geometry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_frontend["Web dashboard"]
end

subgraph group_bridge["MT5 bridge"]
  node_bridge_app["Bridge API &amp; polling<br/>[app.py]"]
  node_symbol_store[("Symbol registry<br/>[symbols_store.py]")]
  node_account["Account dashboard data<br/>[account.py]"]
end

subgraph group_strategy["Strategy &amp; trading"]
  node_analysis["Technical analysis<br/>[analysis.py]"]
  node_trading["Automated trading<br/>[trading.py]"]
  node_signals["Signal tracking<br/>[signals.py]"]
end

subgraph group_ai["FeneFX AI"]
  node_fenefx_api["FeneFX API<br/>[app.py]"]
  node_fenefx_engine["AI analysis orchestration<br/>[engine.py]"]
  node_market_data["Bridge data &amp; geometry<br/>[market_data.py]"]
  node_chart["Chart rendering<br/>[chart.py]"]
  node_providers["LLM provider adapters"]
  node_provider_base["Provider interface<br/>[base.py]"]
  node_engine_state[("Engine state<br/>[state.py]")]
  node_ai_telegram["AI signal posting<br/>[telegram_post.py]"]
end

node_user(("Trader"))
node_mt5["MetaTrader 5"]
node_telegram["Telegram channel"]

node_user -->|"uses"| node_frontend
node_frontend -->|"requests prices &amp; analysis"| node_bridge_app
node_bridge_app -->|"polls account data"| node_mt5
node_bridge_app -->|"manages symbols"| node_symbol_store
node_bridge_app -->|"serves analysis"| node_analysis
node_bridge_app -->|"serves account data"| node_account
node_bridge_app -->|"configures trading"| node_trading
node_bridge_app -->|"reports signal status"| node_signals
node_trading -->|"emits &amp; tracks signals"| node_signals
node_signals -->|"posts updates"| node_telegram
node_fenefx_api -->|"starts analysis"| node_fenefx_engine
node_fenefx_api -->|"lists symbols"| node_market_data
node_fenefx_engine -->|"fetches candles"| node_market_data
node_market_data -->|"fetches candles &amp; symbols"| node_bridge_app
node_fenefx_engine -->|"selects provider"| node_providers
node_providers -->|"implements interface"| node_provider_base
node_fenefx_engine -->|"renders analysis chart"| node_chart
node_fenefx_engine -->|"reads &amp; updates"| node_engine_state
node_fenefx_engine -->|"posts &amp; tracks signals"| node_ai_telegram
node_ai_telegram -->|"posts AI signals"| node_telegram

click node_frontend "https://github.com/jorkan2002/omniforexpairs/tree/main/frontend"
click node_bridge_app "https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/app.py"
click node_symbol_store "https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/symbols_store.py"
click node_analysis "https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/analysis.py"
click node_account "https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/account.py"
click node_trading "https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/trading.py"
click node_signals "https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/signals.py"
click node_fenefx_api "https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/app.py"
click node_fenefx_engine "https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/engine.py"
click node_market_data "https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/market_data.py"
click node_chart "https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/chart.py"
click node_providers "https://github.com/jorkan2002/omniforexpairs/tree/main/fenefx-engine/providers"
click node_provider_base "https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/providers/base.py"
click node_engine_state "https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/state.py"
click node_ai_telegram "https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/telegram_post.py"

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_frontend toneBlue
class node_bridge_app,node_symbol_store,node_account toneAmber
class node_analysis,node_trading,node_signals toneMint
class node_fenefx_api,node_fenefx_engine,node_market_data,node_chart,node_providers,node_provider_base,node_engine_state,node_ai_telegram toneRose
class node_user,node_mt5,node_telegram toneIndigo
```

## Components

### Dashboard

- [Web dashboard](https://github.com/jorkan2002/omniforexpairs/tree/main/frontend): `frontend`

### MT5 bridge

- [Bridge API & polling](https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/app.py): `windows-bridge/app.py`
- [Symbol registry](https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/symbols_store.py): `windows-bridge/symbols_store.py`
- [Account dashboard data](https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/account.py): `windows-bridge/account.py`

### Strategy & trading

- [Technical analysis](https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/analysis.py): `windows-bridge/analysis.py`
- [Automated trading](https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/trading.py): `windows-bridge/trading.py`
- [Signal tracking](https://github.com/jorkan2002/omniforexpairs/blob/main/windows-bridge/signals.py): `windows-bridge/signals.py`

### FeneFX AI

- [FeneFX API](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/app.py): `fenefx-engine/app.py`
- [AI analysis orchestration](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/engine.py): `fenefx-engine/engine.py`
- [Bridge data & geometry](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/market_data.py): `fenefx-engine/market_data.py`
- [Chart rendering](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/chart.py): `fenefx-engine/chart.py`
- [LLM provider adapters](https://github.com/jorkan2002/omniforexpairs/tree/main/fenefx-engine/providers): `fenefx-engine/providers`
- [Provider interface](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/providers/base.py): `fenefx-engine/providers/base.py`
- [Engine state](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/state.py): `fenefx-engine/state.py`
- [AI signal posting](https://github.com/jorkan2002/omniforexpairs/blob/main/fenefx-engine/telegram_post.py): `fenefx-engine/telegram_post.py`

### Other components

- **Trader**
- **MetaTrader 5**
- **Telegram channel**

## Connections

- Trader → Web dashboard: uses (evidence: `README.md`)
- Web dashboard → Bridge API & polling: requests prices & analysis (evidence: `README.md`)
- Bridge API & polling → MetaTrader 5: polls account data (evidence: `README.md`)
- Bridge API & polling → Symbol registry: manages symbols (evidence: `windows-bridge/app.py`)
- Bridge API & polling → Technical analysis: serves analysis (evidence: `windows-bridge/app.py`)
- Bridge API & polling → Account dashboard data: serves account data (evidence: `windows-bridge/app.py`)
- Bridge API & polling → Automated trading: configures trading (evidence: `windows-bridge/app.py`)
- Bridge API & polling → Signal tracking: reports signal status (evidence: `windows-bridge/app.py`)
- Automated trading → Signal tracking: emits & tracks signals (evidence: `windows-bridge/trading.py`)
- Signal tracking → Telegram channel: posts updates (evidence: `windows-bridge/signals.py`)
- FeneFX API → AI analysis orchestration: starts analysis (evidence: `fenefx-engine/app.py`)
- FeneFX API → Bridge data & geometry: lists symbols (evidence: `fenefx-engine/app.py`)
- AI analysis orchestration → Bridge data & geometry: fetches candles (evidence: `fenefx-engine/engine.py`)
- Bridge data & geometry → Bridge API & polling: fetches candles & symbols (evidence: `fenefx-engine/market_data.py`)
- AI analysis orchestration → LLM provider adapters: selects provider (evidence: `fenefx-engine/engine.py`)
- LLM provider adapters → Provider interface: implements interface (evidence: `fenefx-engine/providers/__init__.py`)
- AI analysis orchestration → Chart rendering: renders analysis chart (evidence: `fenefx-engine/engine.py`)
- AI analysis orchestration → Engine state: reads & updates (evidence: `fenefx-engine/engine.py`)
- AI analysis orchestration → AI signal posting: posts & tracks signals (evidence: `fenefx-engine/engine.py`)
- AI signal posting → Telegram channel: posts AI signals (evidence: `fenefx-engine/telegram_post.py`)
