# serdarkocak/fjorterminal architecture

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

## Overview

FjorTerminal is a full-stack crypto trading dashboard: users authenticate, configure exchange credentials and preferences, monitor prices/news and portfolio state, then submit trades and manage positions. Its backend authenticates requests, accesses Binance Futures and persists application data; the frontend also uses market-data and news integrations. The graph reflects sampled calls and README-described capabilities; unsampled controller and integration details are not inferred as direct calls.

Main entry points: [`src/App.jsx`](https://github.com/serdarkocak/fjorterminal/blob/main/src/App.jsx) (Dashboard app), [`src/services/binanceBackendService.js`](https://github.com/serdarkocak/fjorterminal/blob/main/src/services/binanceBackendService.js) (Trading API client), [`FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Data/ApplicationDbContext.cs`](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Data/ApplicationDbContext.cs) (Application database), [`FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/TradingService.cs`](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/TradingService.cs) (Trade execution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard UI"]
  node_app["Dashboard app<br/>[App.jsx]"]
  node_login["Sign-in UI<br/>[LoginPage.jsx]"]
  node_tickers["Market tickers<br/>[TickerSection.jsx]"]
  node_chart["Analysis charts<br/>[ChartSection.jsx]"]
  node_positions["Positions UI<br/>[PositionsTable.jsx]"]
  node_settings["User settings<br/>[SettingsModal.jsx]"]
  node_news["News feed<br/>[NewsFeed.jsx]"]
  node_authclient["Auth client<br/>[authService.js]"]
  node_tradeclient["Trading API client"]
  node_pricehook["Price hook<br/>[useCryptoPrices.js]"]
  node_newsclient["News client<br/>[newsApi.js]"]
end

subgraph group_api["API workflows"]
  node_authapi["Auth endpoints<br/>[AuthController.cs]"]
  node_exchangeapi["Exchange endpoints"]
  node_tradingapi["Trading endpoints"]
  node_settingsapi["Settings endpoints"]
  node_newsapi["News endpoints<br/>[NewsController.cs]"]
  node_priceupdates["Price updates"]
  node_hub["Live update hub<br/>[TradingHub.cs]"]
end

subgraph group_services["Trading services"]
  node_authsvc["Authentication<br/>[AuthService.cs]"]
  node_tradingsvc["Trade execution<br/>[TradingService.cs]"]
  node_binance["Binance integration<br/>[BinanceService.cs]"]
  node_portfoliosvc["Portfolio service"]
end

subgraph group_data["Persistence"]
  node_domain["Trading and user records<br/>[Entities]"]
  node_db[("Application database")]
end

node_user(("Trader"))
node_binanceexternal{{"Binance Futures"}}
node_marketexternal{{"Market data providers"}}
node_rss{{"RSS sources"}}

node_user -->|"uses"| node_app
node_app -->|"renders"| node_login
node_app -->|"submits orders"| node_tradeclient
node_app -->|"renders"| node_news
node_app -->|"renders"| node_tickers
node_app -->|"renders"| node_chart
node_app -->|"renders"| node_positions
node_app -.->|"renders"| node_settings
node_login -.->|"authenticates through"| node_authclient
node_authclient -->|"calls"| node_authapi
node_tradeclient -->|"gets auth headers"| node_authclient
node_tradeclient -.->|"requests trading"| node_tradingapi
node_tradeclient -.->|"requests exchange data"| node_exchangeapi
node_positions -->|"loads positions"| node_tradeclient
node_settings -->|"configures exchange"| node_tradeclient
node_settings -->|"uses account"| node_authclient
node_tickers -.->|"reads prices"| node_pricehook
node_pricehook -->|"fetches prices"| node_marketexternal
node_news -.->|"loads stories"| node_newsclient
node_newsclient -.->|"requests news"| node_newsapi
node_newsapi -->|"aggregates feeds"| node_rss
node_authapi -.->|"delegates to"| node_authsvc
node_authsvc -->|"reads and writes"| node_db
node_exchangeapi -->|"validates credentials"| node_binance
node_exchangeapi -->|"reads and writes"| node_db
node_tradingapi -->|"delegates to"| node_tradingsvc
node_tradingsvc -->|"sends signed orders"| node_binanceexternal
node_tradingsvc -->|"reads and writes trades"| node_db
node_tradingsvc -.->|"uses exchange credentials"| node_binance
node_settingsapi -->|"reads and writes"| node_db
node_priceupdates -->|"reads settings"| node_db
node_priceupdates -->|"fetches prices"| node_binance
node_priceupdates -->|"broadcasts updates"| node_hub
node_db -->|"maps records"| node_domain

click node_app "https://github.com/serdarkocak/fjorterminal/blob/main/src/App.jsx"
click node_login "https://github.com/serdarkocak/fjorterminal/blob/main/src/components/LoginPage.jsx"
click node_tickers "https://github.com/serdarkocak/fjorterminal/blob/main/src/components/TickerSection.jsx"
click node_chart "https://github.com/serdarkocak/fjorterminal/blob/main/src/components/ChartSection.jsx"
click node_positions "https://github.com/serdarkocak/fjorterminal/blob/main/src/components/PositionsTable.jsx"
click node_settings "https://github.com/serdarkocak/fjorterminal/blob/main/src/components/SettingsModal.jsx"
click node_news "https://github.com/serdarkocak/fjorterminal/blob/main/src/components/NewsFeed.jsx"
click node_authclient "https://github.com/serdarkocak/fjorterminal/blob/main/src/services/authService.js"
click node_tradeclient "https://github.com/serdarkocak/fjorterminal/blob/main/src/services/binanceBackendService.js"
click node_pricehook "https://github.com/serdarkocak/fjorterminal/blob/main/src/hooks/useCryptoPrices.js"
click node_newsclient "https://github.com/serdarkocak/fjorterminal/blob/main/src/services/newsApi.js"
click node_authapi "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/AuthController.cs"
click node_exchangeapi "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/ExchangesController.cs"
click node_tradingapi "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/TradingController.cs"
click node_settingsapi "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/UserSettingsController.cs"
click node_newsapi "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/NewsController.cs"
click node_priceupdates "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Services/PriceUpdateService.cs"
click node_hub "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Hubs/TradingHub.cs"
click node_authsvc "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/AuthService.cs"
click node_tradingsvc "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/TradingService.cs"
click node_binance "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/BinanceService.cs"
click node_portfoliosvc "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/PortfolioService.cs"
click node_domain "https://github.com/serdarkocak/fjorterminal/tree/main/FjorTerminal.Backend/src/FjorTerminal.Domain/Entities"
click node_db "https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Data/ApplicationDbContext.cs"

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_app,node_login,node_tickers,node_chart,node_positions,node_settings,node_news,node_authclient,node_tradeclient,node_pricehook,node_newsclient toneBlue
class node_authapi,node_exchangeapi,node_tradingapi,node_settingsapi,node_newsapi,node_priceupdates,node_hub toneAmber
class node_authsvc,node_tradingsvc,node_binance,node_portfoliosvc toneMint
class node_domain,node_db toneRose
class node_user,node_binanceexternal,node_marketexternal,node_rss toneIndigo
```

## Components

### Dashboard UI

- [Dashboard app](https://github.com/serdarkocak/fjorterminal/blob/main/src/App.jsx): `src/App.jsx`
- [Sign-in UI](https://github.com/serdarkocak/fjorterminal/blob/main/src/components/LoginPage.jsx): `src/components/LoginPage.jsx`
- [Market tickers](https://github.com/serdarkocak/fjorterminal/blob/main/src/components/TickerSection.jsx): `src/components/TickerSection.jsx`
- [Analysis charts](https://github.com/serdarkocak/fjorterminal/blob/main/src/components/ChartSection.jsx): `src/components/ChartSection.jsx`
- [Positions UI](https://github.com/serdarkocak/fjorterminal/blob/main/src/components/PositionsTable.jsx): `src/components/PositionsTable.jsx`
- [User settings](https://github.com/serdarkocak/fjorterminal/blob/main/src/components/SettingsModal.jsx): `src/components/SettingsModal.jsx`
- [News feed](https://github.com/serdarkocak/fjorterminal/blob/main/src/components/NewsFeed.jsx): `src/components/NewsFeed.jsx`
- [Auth client](https://github.com/serdarkocak/fjorterminal/blob/main/src/services/authService.js): `src/services/authService.js`
- [Trading API client](https://github.com/serdarkocak/fjorterminal/blob/main/src/services/binanceBackendService.js): `src/services/binanceBackendService.js`
- [Price hook](https://github.com/serdarkocak/fjorterminal/blob/main/src/hooks/useCryptoPrices.js): `src/hooks/useCryptoPrices.js`
- [News client](https://github.com/serdarkocak/fjorterminal/blob/main/src/services/newsApi.js): `src/services/newsApi.js`

### API workflows

- [Auth endpoints](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/AuthController.cs): `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/AuthController.cs`
- [Exchange endpoints](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/ExchangesController.cs): `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/ExchangesController.cs`
- [Trading endpoints](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/TradingController.cs): `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/TradingController.cs`
- [Settings endpoints](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/UserSettingsController.cs): `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/UserSettingsController.cs`
- [News endpoints](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Controllers/NewsController.cs): `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/NewsController.cs`
- [Price updates](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Services/PriceUpdateService.cs): `FjorTerminal.Backend/src/FjorTerminal.API/Services/PriceUpdateService.cs`
- [Live update hub](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.API/Hubs/TradingHub.cs): `FjorTerminal.Backend/src/FjorTerminal.API/Hubs/TradingHub.cs`

### Trading services

- [Authentication](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/AuthService.cs): `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/AuthService.cs`
- [Trade execution](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/TradingService.cs): `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/TradingService.cs`
- [Binance integration](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/BinanceService.cs): `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/BinanceService.cs`
- [Portfolio service](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/PortfolioService.cs): `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/PortfolioService.cs`

### Persistence

- [Trading and user records](https://github.com/serdarkocak/fjorterminal/tree/main/FjorTerminal.Backend/src/FjorTerminal.Domain/Entities): `FjorTerminal.Backend/src/FjorTerminal.Domain/Entities`
- [Application database](https://github.com/serdarkocak/fjorterminal/blob/main/FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Data/ApplicationDbContext.cs): `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Data/ApplicationDbContext.cs`

### Other components

- **Trader**
- **Binance Futures**
- **Market data providers**
- **RSS sources**

## Connections

- Trader → Dashboard app: uses (evidence: `README.md`)
- Dashboard app → Sign-in UI: renders (evidence: `src/App.jsx`)
- Dashboard app → Trading API client: submits orders (evidence: `src/App.jsx`)
- Dashboard app → News feed: renders (evidence: `src/App.jsx`)
- Dashboard app → Market tickers: renders (evidence: `src/App.jsx`)
- Dashboard app → Analysis charts: renders (evidence: `src/App.jsx`)
- Dashboard app → Positions UI: renders (evidence: `src/App.jsx`)
- Dashboard app → User settings: renders
- Sign-in UI → Auth client: authenticates through
- Auth client → Auth endpoints: calls (evidence: `src/services/authService.js`)
- Trading API client → Auth client: gets auth headers (evidence: `src/services/binanceBackendService.js`)
- Trading API client → Trading endpoints: requests trading
- Trading API client → Exchange endpoints: requests exchange data
- Positions UI → Trading API client: loads positions (evidence: `src/components/PositionsTable.jsx`)
- User settings → Trading API client: configures exchange (evidence: `src/components/SettingsModal.jsx`)
- User settings → Auth client: uses account (evidence: `src/components/SettingsModal.jsx`)
- Market tickers → Price hook: reads prices
- Price hook → Market data providers: fetches prices (evidence: `src/hooks/useCryptoPrices.js`)
- News feed → News client: loads stories
- News client → News endpoints: requests news
- News endpoints → RSS sources: aggregates feeds (evidence: `README.md`)
- Auth endpoints → Authentication: delegates to
- Authentication → Application database: reads and writes (evidence: `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/AuthService.cs`)
- Exchange endpoints → Binance integration: validates credentials (evidence: `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/ExchangesController.cs`)
- Exchange endpoints → Application database: reads and writes (evidence: `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/ExchangesController.cs`)
- Trading endpoints → Trade execution: delegates to (evidence: `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/TradingController.cs`)
- Trade execution → Binance Futures: sends signed orders (evidence: `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/TradingService.cs`)
- Trade execution → Application database: reads and writes trades (evidence: `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Services/TradingService.cs`)
- Trade execution → Binance integration: uses exchange credentials
- Settings endpoints → Application database: reads and writes (evidence: `FjorTerminal.Backend/src/FjorTerminal.API/Controllers/UserSettingsController.cs`)
- Price updates → Application database: reads settings (evidence: `FjorTerminal.Backend/src/FjorTerminal.API/Services/PriceUpdateService.cs`)
- Price updates → Binance integration: fetches prices (evidence: `FjorTerminal.Backend/src/FjorTerminal.API/Services/PriceUpdateService.cs`)
- Price updates → Live update hub: broadcasts updates (evidence: `FjorTerminal.Backend/src/FjorTerminal.API/Services/PriceUpdateService.cs`)
- Application database → Trading and user records: maps records (evidence: `FjorTerminal.Backend/src/FjorTerminal.Infrastructure/Data/ApplicationDbContext.cs`)
