# venkatasaieeshreddy005/stocks_trading_platform architecture

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

- Interactive diagram: https://gitdiagram.com/venkatasaieeshreddy005/stocks_trading_platform
- Repository: https://github.com/venkatasaieeshreddy005/stocks_trading_platform

## Overview

TradeZen is a paper-trading application: users create or verify an account, explore live market data, place simulated orders, and review holdings, performance, and alerts. The client’s routed pages and shared auth/socket contexts form the user-facing workflow; backend routes dispatch requests to controllers, while the simulation engine maintains market state and processes market activity. Persistent user, order, holding, and alert models support account and trading state. The excerpts establish key route, model, simulation, and socket links; unsampled page and controller internals are not assumed.

Main entry points: [`backend/engine/simulation.js`](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/engine/simulation.js) (Price Simulation), [`client/src/App.jsx`](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/App.jsx) (Application Routes), [`backend/server.js`](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/server.js) (HTTP and Socket Server), [`backend/controllers/tradeController.js`](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/tradeController.js) (Trade Controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Trading Client"]
  node_app["Application Routes<br/>[App.jsx]"]
  node_authctx["Auth Context<br/>[AuthContext.jsx]"]
  node_socketctx["Live Data Context<br/>[SocketContext.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_marketsui["Markets<br/>[Markets.jsx]"]
  node_instrument["Instrument Detail"]
  node_portfolio["Portfolio View<br/>[Portfolio.jsx]"]
  node_ordersui["Orders View<br/>[Orders.jsx]"]
  node_watchlistui["Watchlist View<br/>[Watchlist.jsx]"]
end

subgraph group_api["API and Accounts"]
  node_server["HTTP and Socket Server<br/>[server.js]"]
  node_authroutes["Auth Routes<br/>[auth.js]"]
  node_authcontroller["Account Controller<br/>[authController.js]"]
  node_authmw["Session Middleware<br/>[auth.js]"]
end

subgraph group_markets["Market Simulation"]
  node_marketcontroller["Market Controller"]
  node_simulation["Price Simulation<br/>[simulation.js]"]
  node_instruments["Instrument Catalog<br/>[instruments.js]"]
end

subgraph group_trading["Trading and Portfolio"]
  node_tradecontroller["Trade Controller<br/>[tradeController.js]"]
  node_portcontroller["Portfolio Controller"]
  node_watchcontroller["Watchlist Controller"]
end

subgraph group_state["Persistent State"]
  node_user[("User Records<br/>[User.js]")]
  node_order[("Order Records<br/>[Order.js]")]
  node_holding[("Holding Records<br/>[Holding.js]")]
  node_alert[("Alert Records<br/>[Alert.js]")]
end

node_trader(("Trader"))

node_trader -->|"uses"| node_app
node_app -->|"provides"| node_authctx
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_marketsui
node_app -->|"routes to"| node_instrument
node_app -->|"routes to"| node_portfolio
node_app -->|"routes to"| node_ordersui
node_app -->|"routes to"| node_watchlistui
node_authctx -->|"calls auth API"| node_authroutes
node_server -->|"mounts"| node_authroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"checks session"| node_authmw
node_authcontroller -->|"signs sessions"| node_authmw
node_authcontroller -->|"reads and writes"| node_user
node_server -->|"mounts market routes"| node_marketcontroller
node_marketcontroller -->|"reads market state"| node_simulation
node_simulation -->|"initializes from"| node_instruments
node_server -->|"starts and broadcasts"| node_simulation
node_server -->|"streams market events"| node_socketctx
node_trader -->|"receives live updates"| node_socketctx
node_server -->|"mounts trade routes"| node_tradecontroller
node_tradecontroller -->|"gets prices; records trades"| node_simulation
node_tradecontroller -->|"updates balance"| node_user
node_tradecontroller -->|"creates and updates"| node_order
node_tradecontroller -->|"updates positions"| node_holding
node_server -->|"mounts portfolio routes"| node_portcontroller
node_portcontroller -->|"reads metrics and cash"| node_user
node_portcontroller -->|"reads positions"| node_holding
node_portcontroller -->|"reads executed sales"| node_order
node_portcontroller -->|"gets instrument prices"| node_simulation
node_server -->|"mounts watchlist routes"| node_watchcontroller
node_watchcontroller -->|"reads and updates list"| node_user
node_watchcontroller -->|"uses alert records"| node_alert
node_watchcontroller -->|"reads market state"| node_simulation
node_simulation -->|"processes pending orders"| node_order
node_simulation -->|"triggers stop losses"| node_holding
node_simulation -->|"updates trade state"| node_user
node_simulation -->|"persists alerts"| node_alert

click node_app "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/App.jsx"
click node_authctx "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/context/AuthContext.jsx"
click node_socketctx "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/context/SocketContext.jsx"
click node_dashboard "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Dashboard.jsx"
click node_marketsui "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Markets.jsx"
click node_instrument "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/InstrumentDetail.jsx"
click node_portfolio "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Portfolio.jsx"
click node_ordersui "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Orders.jsx"
click node_watchlistui "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Watchlist.jsx"
click node_server "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/server.js"
click node_authroutes "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/routes/auth.js"
click node_authcontroller "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/authController.js"
click node_authmw "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/middleware/auth.js"
click node_marketcontroller "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/marketController.js"
click node_simulation "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/engine/simulation.js"
click node_instruments "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/data/instruments.js"
click node_tradecontroller "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/tradeController.js"
click node_portcontroller "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/portfolioController.js"
click node_watchcontroller "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/watchlistController.js"
click node_user "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/models/User.js"
click node_order "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/models/Order.js"
click node_holding "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/models/Holding.js"
click node_alert "https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/models/Alert.js"

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_authctx,node_socketctx,node_dashboard,node_marketsui,node_instrument,node_portfolio,node_ordersui,node_watchlistui toneBlue
class node_server,node_authroutes,node_authcontroller,node_authmw toneAmber
class node_marketcontroller,node_simulation,node_instruments toneMint
class node_tradecontroller,node_portcontroller,node_watchcontroller toneRose
class node_user,node_order,node_holding,node_alert,node_trader toneIndigo
```

## Components

### Trading Client

- [Application Routes](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Auth Context](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Live Data Context](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/context/SocketContext.jsx): `client/src/context/SocketContext.jsx`
- [Dashboard](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Markets](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Markets.jsx): `client/src/pages/Markets.jsx`
- [Instrument Detail](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/InstrumentDetail.jsx): `client/src/pages/InstrumentDetail.jsx`
- [Portfolio View](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Portfolio.jsx): `client/src/pages/Portfolio.jsx`
- [Orders View](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Orders.jsx): `client/src/pages/Orders.jsx`
- [Watchlist View](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/client/src/pages/Watchlist.jsx): `client/src/pages/Watchlist.jsx`

### API and Accounts

- [HTTP and Socket Server](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/server.js): `backend/server.js`
- [Auth Routes](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/routes/auth.js): `backend/routes/auth.js`
- [Account Controller](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Session Middleware](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`

### Market Simulation

- [Market Controller](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/marketController.js): `backend/controllers/marketController.js`
- [Price Simulation](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/engine/simulation.js): `backend/engine/simulation.js`
- [Instrument Catalog](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/data/instruments.js): `backend/data/instruments.js`

### Trading and Portfolio

- [Trade Controller](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/tradeController.js): `backend/controllers/tradeController.js`
- [Portfolio Controller](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/portfolioController.js): `backend/controllers/portfolioController.js`
- [Watchlist Controller](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/controllers/watchlistController.js): `backend/controllers/watchlistController.js`

### Persistent State

- [User Records](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/models/User.js): `backend/models/User.js`
- [Order Records](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/models/Order.js): `backend/models/Order.js`
- [Holding Records](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/models/Holding.js): `backend/models/Holding.js`
- [Alert Records](https://github.com/venkatasaieeshreddy005/stocks_trading_platform/blob/main/backend/models/Alert.js): `backend/models/Alert.js`

### Other components

- **Trader**

## Connections

- Trader → Application Routes: uses (evidence: `client/src/App.jsx`)
- Application Routes → Auth Context: provides (evidence: `client/src/App.jsx`)
- Application Routes → Dashboard: routes to (evidence: `client/src/App.jsx`)
- Application Routes → Markets: routes to (evidence: `client/src/App.jsx`)
- Application Routes → Instrument Detail: routes to (evidence: `client/src/App.jsx`)
- Application Routes → Portfolio View: routes to (evidence: `client/src/App.jsx`)
- Application Routes → Orders View: routes to (evidence: `client/src/App.jsx`)
- Application Routes → Watchlist View: routes to (evidence: `client/src/App.jsx`)
- Auth Context → Auth Routes: calls auth API (evidence: `client/src/context/AuthContext.jsx`)
- HTTP and Socket Server → Auth Routes: mounts (evidence: `backend/server.js`)
- Auth Routes → Account Controller: dispatches (evidence: `backend/routes/auth.js`)
- Auth Routes → Session Middleware: checks session (evidence: `backend/routes/auth.js`)
- Account Controller → Session Middleware: signs sessions (evidence: `backend/controllers/authController.js`)
- Account Controller → User Records: reads and writes (evidence: `backend/controllers/authController.js`)
- HTTP and Socket Server → Market Controller: mounts market routes (evidence: `backend/server.js`)
- Market Controller → Price Simulation: reads market state (evidence: `backend/controllers/marketController.js`)
- Price Simulation → Instrument Catalog: initializes from (evidence: `backend/engine/simulation.js`)
- HTTP and Socket Server → Price Simulation: starts and broadcasts (evidence: `backend/server.js`)
- HTTP and Socket Server → Live Data Context: streams market events (evidence: `backend/server.js`)
- Trader → Live Data Context: receives live updates (evidence: `client/src/context/SocketContext.jsx`)
- HTTP and Socket Server → Trade Controller: mounts trade routes (evidence: `backend/server.js`)
- Trade Controller → Price Simulation: gets prices; records trades (evidence: `backend/controllers/tradeController.js`)
- Trade Controller → User Records: updates balance (evidence: `backend/controllers/tradeController.js`)
- Trade Controller → Order Records: creates and updates (evidence: `backend/controllers/tradeController.js`)
- Trade Controller → Holding Records: updates positions (evidence: `backend/controllers/tradeController.js`)
- HTTP and Socket Server → Portfolio Controller: mounts portfolio routes (evidence: `backend/server.js`)
- Portfolio Controller → User Records: reads metrics and cash (evidence: `backend/controllers/portfolioController.js`)
- Portfolio Controller → Holding Records: reads positions (evidence: `backend/controllers/portfolioController.js`)
- Portfolio Controller → Order Records: reads executed sales (evidence: `backend/controllers/portfolioController.js`)
- Portfolio Controller → Price Simulation: gets instrument prices (evidence: `backend/controllers/portfolioController.js`)
- HTTP and Socket Server → Watchlist Controller: mounts watchlist routes (evidence: `backend/server.js`)
- Watchlist Controller → User Records: reads and updates list (evidence: `backend/controllers/watchlistController.js`)
- Watchlist Controller → Alert Records: uses alert records (evidence: `backend/controllers/watchlistController.js`)
- Watchlist Controller → Price Simulation: reads market state (evidence: `backend/controllers/watchlistController.js`)
- Price Simulation → Order Records: processes pending orders (evidence: `backend/engine/simulation.js`)
- Price Simulation → Holding Records: triggers stop losses (evidence: `backend/engine/simulation.js`)
- Price Simulation → User Records: updates trade state (evidence: `backend/engine/simulation.js`)
- Price Simulation → Alert Records: persists alerts (evidence: `backend/engine/simulation.js`)
