# ga5e8je99/fxengin architecture

> Architecture diagram of the GitHub repository ga5e8je99/fxengin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ga5e8je99/fxengin
- Repository: https://github.com/ga5e8je99/fxengin

## Overview

FXEngin is a multi-part trading and financial-education platform: a public website, an administrative dashboard, a core NestJS API, and a separate trading application with its own Express API. The user-facing domain includes account access, market information, analyses, courses, live sessions, offers, and checkout; the admin dashboard manages platform content and users. Evidence is strongest for the sampled API, storage, and trading entry points; many listed product areas are represented by their exact source directories, but their internal links are not inferred from names alone.

Main entry points: [`backend/src/main.ts`](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/main.ts) (Core API), [`trading/src/App.tsx`](https://github.com/ga5e8je99/fxengin/blob/main/trading/src/App.tsx) (Trading App), [`trading/server/index.ts`](https://github.com/ga5e8je99/fxengin/blob/main/trading/server/index.ts) (Trading API Server), [`frontend/app`](https://github.com/ga5e8je99/fxengin/tree/main/frontend/app) (Public Site)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public Website"]
  node_public_site["Public Site"]
  node_market_rates["Market Rates<br/>[ratesService.js]"]
  node_market_chart["Market Chart<br/>[FXEngineChart.js]"]
  node_education["Courses and Live"]
  node_content["Articles and Analyses"]
end

subgraph group_admin["Admin Dashboard"]
  node_admin_dashboard["Admin Dashboard"]
  node_admin_services["Admin API Services"]
  node_admin_storage["Admin Storage Client<br/>[storageService.js]"]
end

subgraph group_core["Core Platform API"]
  node_backend_api["Core API<br/>[main.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_health["Health and Telemetry<br/>[app.controller.ts]"]
  node_platform_data[("Platform Database<br/>[prisma.service.ts]")]
  node_courses_api["Courses<br/>[courses.service.ts]"]
  node_orders_payments["Orders and Payments<br/>[orders.service.ts]"]
  node_subscriptions["Subscriptions"]
  node_content_api["Content and CMS"]
  node_storage_controller["Admin Storage API"]
  node_storage_service["Cloud Storage Service<br/>[storage.service.ts]"]
end

subgraph group_trade["Trading Application"]
  node_trading_app["Trading App<br/>[App.tsx]"]
  node_trading_page["Trading Workspace<br/>[TradingPage.tsx]"]
  node_market_bridge["Market Data Bridge"]
  node_drawing_manager["Chart Drawings<br/>[manager.ts]"]
end

subgraph group_tradeapi["Trading API"]
  node_trade_server["Trading API Server<br/>[index.ts]"]
  node_market_api["Market Data API<br/>[market.ts]"]
  node_account_api["User and Deposit API<br/>[user.ts]"]
  node_trading_database[("Trading Database<br/>[db.ts]")]
end

node_visitor(("Visitor or Trader"))
node_admin_user(("Administrator"))

node_visitor -->|"visits"| node_public_site
node_public_site -->|"renders"| node_market_chart
node_market_chart -->|"fetches rates"| node_market_rates
node_visitor -->|"opens"| node_trading_app
node_trading_app -->|"routes to"| node_trading_page
node_trading_app -->|"renders"| node_market_bridge
node_trading_app -->|"uses auth"| node_auth
node_trading_page -.->|"uses drawings"| node_drawing_manager
node_admin_user -->|"manages"| node_admin_dashboard
node_admin_dashboard -.->|"uses services"| node_admin_services
node_admin_storage -->|"requests URLs"| node_storage_controller
node_backend_api -.->|"routes requests"| node_health
node_health -->|"probes database"| node_platform_data
node_auth -->|"reads and writes"| node_platform_data
node_backend_api -.->|"serves courses"| node_courses_api
node_backend_api -.->|"serves checkout"| node_orders_payments
node_backend_api -.->|"serves plans"| node_subscriptions
node_backend_api -.->|"serves content"| node_content_api
node_storage_controller -->|"delegates"| node_storage_service
node_trade_server -->|"mounts routes"| node_market_api
node_trade_server -->|"mounts routes"| node_account_api
node_trade_server -->|"initializes"| node_trading_database

click node_public_site "https://github.com/ga5e8je99/fxengin/tree/main/frontend/app"
click node_market_rates "https://github.com/ga5e8je99/fxengin/blob/main/frontend/app/services/ratesService.js"
click node_market_chart "https://github.com/ga5e8je99/fxengin/blob/main/frontend/app/components/FXEngineChart.js"
click node_education "https://github.com/ga5e8je99/fxengin/tree/main/frontend/app/%5Bid%5D/courses"
click node_content "https://github.com/ga5e8je99/fxengin/tree/main/frontend/app/%5Bid%5D/blog"
click node_admin_dashboard "https://github.com/ga5e8je99/fxengin/tree/main/admin/app/dashboard"
click node_admin_services "https://github.com/ga5e8je99/fxengin/tree/main/admin/app/services"
click node_admin_storage "https://github.com/ga5e8je99/fxengin/blob/main/admin/app/services/storageService.js"
click node_backend_api "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/main.ts"
click node_auth "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/auth/auth.service.ts"
click node_health "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/app.controller.ts"
click node_platform_data "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/prisma/prisma.service.ts"
click node_courses_api "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/courses/courses.service.ts"
click node_orders_payments "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/orders/orders.service.ts"
click node_subscriptions "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/subscriptions/subscriptions.service.ts"
click node_content_api "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/articles/articles.service.ts"
click node_storage_controller "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/admin/storage/storage.controller.ts"
click node_storage_service "https://github.com/ga5e8je99/fxengin/blob/main/backend/src/admin/storage/storage.service.ts"
click node_trading_app "https://github.com/ga5e8je99/fxengin/blob/main/trading/src/App.tsx"
click node_trading_page "https://github.com/ga5e8je99/fxengin/blob/main/trading/src/pages/TradingPage.tsx"
click node_market_bridge "https://github.com/ga5e8je99/fxengin/blob/main/trading/src/components/MarketDataBridge.tsx"
click node_drawing_manager "https://github.com/ga5e8je99/fxengin/blob/main/trading/src/lib/chart-plugins/drawing-tools/manager.ts"
click node_trade_server "https://github.com/ga5e8je99/fxengin/blob/main/trading/server/index.ts"
click node_market_api "https://github.com/ga5e8je99/fxengin/blob/main/trading/server/routes/market.ts"
click node_account_api "https://github.com/ga5e8je99/fxengin/blob/main/trading/server/routes/user.ts"
click node_trading_database "https://github.com/ga5e8je99/fxengin/blob/main/trading/server/db.ts"

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_public_site,node_market_rates,node_market_chart,node_education,node_content toneBlue
class node_admin_dashboard,node_admin_services,node_admin_storage toneAmber
class node_backend_api,node_auth,node_health,node_platform_data,node_courses_api,node_orders_payments,node_subscriptions,node_content_api,node_storage_controller,node_storage_service toneMint
class node_trading_app,node_trading_page,node_market_bridge,node_drawing_manager toneRose
class node_trade_server,node_market_api,node_account_api,node_trading_database,node_visitor,node_admin_user toneIndigo
```

## Components

### Public Website

- [Public Site](https://github.com/ga5e8je99/fxengin/tree/main/frontend/app): `frontend/app`
- [Market Rates](https://github.com/ga5e8je99/fxengin/blob/main/frontend/app/services/ratesService.js): `frontend/app/services/ratesService.js`
- [Market Chart](https://github.com/ga5e8je99/fxengin/blob/main/frontend/app/components/FXEngineChart.js): `frontend/app/components/FXEngineChart.js`
- [Courses and Live](https://github.com/ga5e8je99/fxengin/tree/main/frontend/app/%5Bid%5D/courses): `frontend/app/[id]/courses`
- [Articles and Analyses](https://github.com/ga5e8je99/fxengin/tree/main/frontend/app/%5Bid%5D/blog): `frontend/app/[id]/blog`

### Admin Dashboard

- [Admin Dashboard](https://github.com/ga5e8je99/fxengin/tree/main/admin/app/dashboard): `admin/app/dashboard`
- [Admin API Services](https://github.com/ga5e8je99/fxengin/tree/main/admin/app/services): `admin/app/services`
- [Admin Storage Client](https://github.com/ga5e8je99/fxengin/blob/main/admin/app/services/storageService.js): `admin/app/services/storageService.js`

### Core Platform API

- [Core API](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/main.ts): `backend/src/main.ts`
- [Authentication](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/auth/auth.service.ts): `backend/src/auth/auth.service.ts`
- [Health and Telemetry](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/app.controller.ts): `backend/src/app.controller.ts`
- [Platform Database](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/prisma/prisma.service.ts): `backend/src/prisma/prisma.service.ts`
- [Courses](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/courses/courses.service.ts): `backend/src/courses/courses.service.ts`
- [Orders and Payments](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/orders/orders.service.ts): `backend/src/orders/orders.service.ts`
- [Subscriptions](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/subscriptions/subscriptions.service.ts): `backend/src/subscriptions/subscriptions.service.ts`
- [Content and CMS](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/articles/articles.service.ts): `backend/src/articles/articles.service.ts`
- [Admin Storage API](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/admin/storage/storage.controller.ts): `backend/src/admin/storage/storage.controller.ts`
- [Cloud Storage Service](https://github.com/ga5e8je99/fxengin/blob/main/backend/src/admin/storage/storage.service.ts): `backend/src/admin/storage/storage.service.ts`

### Trading Application

- [Trading App](https://github.com/ga5e8je99/fxengin/blob/main/trading/src/App.tsx): `trading/src/App.tsx`
- [Trading Workspace](https://github.com/ga5e8je99/fxengin/blob/main/trading/src/pages/TradingPage.tsx): `trading/src/pages/TradingPage.tsx`
- [Market Data Bridge](https://github.com/ga5e8je99/fxengin/blob/main/trading/src/components/MarketDataBridge.tsx): `trading/src/components/MarketDataBridge.tsx`
- [Chart Drawings](https://github.com/ga5e8je99/fxengin/blob/main/trading/src/lib/chart-plugins/drawing-tools/manager.ts): `trading/src/lib/chart-plugins/drawing-tools/manager.ts`

### Trading API

- [Trading API Server](https://github.com/ga5e8je99/fxengin/blob/main/trading/server/index.ts): `trading/server/index.ts`
- [Market Data API](https://github.com/ga5e8je99/fxengin/blob/main/trading/server/routes/market.ts): `trading/server/routes/market.ts`
- [User and Deposit API](https://github.com/ga5e8je99/fxengin/blob/main/trading/server/routes/user.ts): `trading/server/routes/user.ts`
- [Trading Database](https://github.com/ga5e8je99/fxengin/blob/main/trading/server/db.ts): `trading/server/db.ts`

### Other components

- **Visitor or Trader**
- **Administrator**

## Connections

- Visitor or Trader → Public Site: visits
- Public Site → Market Chart: renders (evidence: `frontend/app/components/FXEngineChart.js`)
- Market Chart → Market Rates: fetches rates (evidence: `frontend/app/components/FXEngineChart.js`)
- Visitor or Trader → Trading App: opens
- Trading App → Trading Workspace: routes to (evidence: `trading/src/App.tsx`)
- Trading App → Market Data Bridge: renders (evidence: `trading/src/main.tsx`)
- Trading App → Authentication: uses auth (evidence: `trading/src/App.tsx`)
- Trading Workspace → Chart Drawings: uses drawings
- Administrator → Admin Dashboard: manages
- Admin Dashboard → Admin API Services: uses services
- Admin Storage Client → Admin Storage API: requests URLs (evidence: `admin/app/services/storageService.js`)
- Core API → Health and Telemetry: routes requests
- Health and Telemetry → Platform Database: probes database
- Authentication → Platform Database: reads and writes (evidence: `backend/src/auth/auth.service.ts`)
- Core API → Courses: serves courses
- Core API → Orders and Payments: serves checkout
- Core API → Subscriptions: serves plans
- Core API → Content and CMS: serves content
- Admin Storage API → Cloud Storage Service: delegates (evidence: `backend/src/admin/storage/storage.controller.ts`)
- Trading API Server → Market Data API: mounts routes (evidence: `trading/server/index.ts`)
- Trading API Server → User and Deposit API: mounts routes (evidence: `trading/server/index.ts`)
- Trading API Server → Trading Database: initializes (evidence: `trading/server/index.ts`)
