Order Execution Gateway

Electron application that executes trading orders received from various sources through pluggable adapters. Order cards remain in the interface after an order is placed and collapse to a header with a colored status dot that reflects the position lifecycle:

• blue – order placed, waiting for fill
• yellow – position opened
• green/red – position closed in profit/loss

A lightweight event bus emits order:placed, position:opened, position:closed and order:cancelled so other parts of the app can react to changes.

Configuration

Default configuration files live in each service's config/ directory (for example app/services/orderCards/config). To customize any of them, copy the file to a config/ directory in the project root and adjust as needed. On startup the application deep‑merges local overrides onto the bundled defaults.

Example:

mkdir -p config
cp app/services/orderCards/config/order-cards.json config/order-cards.json

Notable configuration files include:

• app/services/brokerage/config/execution.json – execution providers and adapter settings.
• app/services/orderCards/config/order-cards.json – sources for incoming order cards.
• app/services/tradeRules/config/trade-rules.json – validation rules applied before orders are sent.
• app/services/dealTrackers/config/deal-trackers.json – trackers invoked when positions close.
• app/services/dealTrackers-source-tv-log/config/tv-logs.json – directories containing TradingView CSV logs.
• app/services/dealTrackers-source-mt5-log/config/mt5-logs.json – directories containing MetaTrader reports.
• app/services/dealTrackers-chartImages/config/chart-images.json – chart screenshot service settings.
• app/services/points/config/tick-sizes.json – tick size overrides for points calculations.

Services

• Execution Adapters – registry that builds and caches connectors to execution providers. Details
• Order Cards – loads cards from sources like webhooks or files. Details
• Trade Rules – validates orders before execution. Details
• Deal Trackers – persist closed trades or forward them elsewhere. Details
• Deal Trackers: Chart Images – queues chart screenshots for use in notes. Details
• Deal Trackers: TradingView Log Source – turns TradingView order logs into closed trade events. Details
• Deal Trackers: MT5 Log Source – parses MetaTrader 5 reports for closed trades. Details
• Webhooks – converts raw webhook payloads into order card rows. Details
• Command Line – text interface for quick actions. Details
• Points – converts price differences into point values using tick sizes. Details
• Order Calculator – shared stop-loss, take-profit and position sizing math. Details
• Event Bus – broadcasts order lifecycle events. Details
• Actions Bus – routes service events to command runners for automation. Details
• TV Listener – watches TradingView messages and surfaces automation hooks. Details

Documentation

See docs/ for an overview of the codebase and additional documentation.