How mansijoon/test_tradesphere works
TradeSphere Terminal is a real-time trading simulator. A trader submits an order through the dashboard; the API routes it through order services and the matching engine, then event handlers update trade and portfolio state and WebSockets synchronize the UI. The graph also includes market streaming, portfolio views, authentication, and trade/event-log capabilities documented or routed by the repository. Some service and socket internals were not excerpted, so their links rely on README statements or indexed references rather than inspected implementations.
Main entry points: Dashboard.jsx Dashboard · handlers Trade handlers · OrderService.js Order service · matchEngine.js Match engine
Components 28
Trading interface
- Dashboard
frontend/src/pages/Dashboard.jsx - Order panel
frontend/src/components/panels/OrderPanel.jsx - Price grid
frontend/src/components/PriceGrid.jsx - Watchlist
frontend/src/components/panels/Watchlist.jsx - Chart panel
frontend/src/components/charts/ChartPanel.jsx - Holdings table
frontend/src/components/HoldingsTable.jsx - Portfolio KPIs
frontend/src/components/PortfolioKPI.jsx
API and execution
- Express app
backend-v2/src/app.js - Order routes
backend-v2/src/routes/orderRoutes.js - Authentication
backend-v2/src/middleware/authMiddleware.js - Order controller
backend-v2/src/controllers/OrderController.js - Order service
backend-v2/src/services/OrderService.js - Match engine
backend-v2/src/orderbook/matchEngine.js - Order book
backend-v2/src/orderbook/orderBook.js
Events and portfolio
- Event bus
backend-v2/src/events/eventBus.js - Trade handlers
backend-v2/src/events/handlers - Holding service
backend-v2/src/services/HoldingService.js - Position engine
backend-v2/src/services/PositionEngine.js - Portfolio summary
backend-v2/src/services/PortfolioSummaryService.js - Market socket
backend-v2/src/websocket/marketSocket.js - Event log service
backend-v2/src/services/EventLogService.js - Trade statistics
backend-v2/src/services/TradeStatsService.js
Persistence and streams
- Order repository
backend-v2/src/repositories/OrderRepository.js - Holding repository
backend-v2/src/repositories/HoldingRepository.js - Portfolio repository
backend-v2/src/repositories/PortfolioRepository.js - Market price repository
backend-v2/src/repositories/MarketPriceRepository.js - MongoDB
Other components
- Trader
Connections 32
- Trader → Dashboard: uses
- Dashboard → Order panel: renders
frontend/src/pages/Dashboard.jsx - Dashboard → Price grid: renders
frontend/src/pages/Dashboard.jsx - Dashboard → Watchlist: renders
frontend/src/pages/Dashboard.jsx - Dashboard → Chart panel: renders
frontend/src/pages/Dashboard.jsx - Dashboard → Holdings table: renders
frontend/src/pages/Dashboard.jsx - Dashboard → Portfolio KPIs: renders
frontend/src/pages/Dashboard.jsx - Order panel → Order routes: submits orders
- Dashboard → Express app: fetches summary
frontend/src/pages/Dashboard.jsx - Express app → Order routes: mounts routes
backend-v2/src/app.js - Order routes → Order controller: dispatches
backend-v2/src/routes/orderRoutes.js - Order controller → Order service: calls
backend-v2/src/controllers/OrderController.js - Order service → Match engine: routes orders
backend-v2/src/services/OrderService.js - Match engine → Order book: adds and matches
backend-v2/src/orderbook/matchEngine.js - Match engine → Event bus: emits trades
backend-v2/src/orderbook/matchEngine.js - Event bus → Trade handlers: dispatches events
backend-v2/src/events/handlers/tradeHandler.js - Trade handlers → Holding service: updates holdings
backend-v2/src/events/handlers/tradeHandler.js - Trade handlers → Trade statistics: updates statistics
backend-v2/src/events/handlers/tradeHandler.js - Trade handlers → Event log service: records trades
backend-v2/src/events/handlers/buyHandler.js - Holding service → Position engine: applies trades · Inferred; not shown in the code that was read.
- Position engine → Holding repository: reads and writes
backend-v2/src/services/PositionEngine.js - Order service → Order repository: persists orders
backend-v2/src/services/OrderService.js - Order service → Portfolio repository: accesses portfolio
backend-v2/src/services/OrderService.js - Trade handlers → Portfolio repository: syncs portfolio
backend-v2/src/events/handlers/portfolioSyncHandler.js - Trade handlers → Holding repository: loads holdings
backend-v2/src/events/handlers/portfolioSyncHandler.js - Trade handlers → Market price repository: loads prices
backend-v2/src/events/handlers/portfolioSyncHandler.js - Dashboard → Market socket: subscribes
frontend/src/pages/Dashboard.jsx - Market socket → Dashboard: pushes updates
- Order repository → MongoDB: stores orders
- Holding repository → MongoDB: stores holdings
- Portfolio repository → MongoDB: stores portfolio
- Dashboard → Portfolio summary: requests snapshot