How abdelrahmanhanyy2003-cmyk/egx-flow works
EGX Flow is a read-only EGX order-flow and market-intelligence terminal. Users explore live or simulated market data, inspect derived signals and portfolio analytics, configure alerts, and replay recorded sessions. The backend normalizes provider events into symbol state, computes market views and distributes updates; persistence supports history and replay. The README documents additional product screens and analytics that are not all represented by sampled source. Some frontend-to-backend wiring and unsampled subsystem internals are therefore left unconnected.
Main entry points: market_service.py Market hub · container.py Runtime composition · page.tsx Market terminal · symbol_state.py Symbol state
Components 24
Terminal experience
- Market terminal
frontend/src/app/page.tsx - Stock explorer
frontend/src/app/explorer/page.tsx - Market overview
frontend/src/app/market/page.tsx - Whale Radar
frontend/src/app/whales/page.tsx - Portfolio screens
frontend/src/app/portfolio/page.tsx - Alert screens
frontend/src/app/alerts/page.tsx - Replay screen
frontend/src/app/replay/page.tsx - Heatmap renderer
frontend/src/components/terminal/engine/HeatmapEngine.ts
Market runtime
- FastAPI application
backend/app/main.py - Market hub
backend/app/services/market_service.py - Symbol state
backend/app/market_data/symbol_state.py - Order book
backend/app/market_data/orderbook_engine.py - WebSocket fan-out
backend/app/services/websocket_manager.py
Analytics and alerts
- Market analytics
backend/app/analytics - Alert engine
backend/app/alerts/engine.py
Portfolio and replay
- Portfolio analytics
backend/app/services/portfolio_service.py - Session replay
backend/app/services/replay_service.py - Session recorder
backend/app/replay/recorder.py
Providers and persistence
- Provider interface
backend/app/providers/base.py - EFG Hermes integration
backend/app/integrations/efg_hermes - Market database
backend/app/database/models/__init__.py - Market repository
backend/app/database/repositories/market_repo.py - Runtime composition
backend/app/services/container.py
Other components
- Terminal user
Connections 25
- Terminal user → Market terminal: explores markets
- Terminal user → Stock explorer: screens stocks
- Terminal user → Market overview: views overview
- Terminal user → Whale Radar: inspects signals
- Terminal user → Portfolio screens: reviews portfolio
- Terminal user → Alert screens: configures alerts
- Terminal user → Replay screen: replays sessions
- Market terminal → Heatmap renderer: renders heatmap
- FastAPI application → Runtime composition: builds runtime
backend/app/main.py - Runtime composition → Market hub: constructs
backend/app/services/container.py - Runtime composition → Portfolio analytics: constructs
backend/app/services/container.py - Runtime composition → Session replay: constructs
backend/app/services/container.py - Runtime composition → Provider interface: selects provider
backend/app/services/container.py - Runtime composition → EFG Hermes integration: configures live
backend/app/services/container.py - Market hub → Symbol state: updates state
backend/app/services/market_service.py - Market hub → Session recorder: records events
backend/app/services/market_service.py - Market hub → Alert engine: checks signals
backend/app/services/market_service.py - Market hub → WebSocket fan-out: publishes updates
backend/app/services/market_service.py - Symbol state → Order book: maintains book
- Market hub → Market analytics: computes views
backend/app/services/market_service.py - Portfolio analytics → Market hub: reads live prices
backend/app/services/portfolio_service.py - Session replay → Market hub: replays events
backend/app/services/replay_service.py - Session recorder → Market repository: persists history
backend/app/replay/recorder.py - Market repository → Market database: reads and writes
backend/app/database/repositories/market_repo.py - Provider interface → EFG Hermes integration: implements interface