work on market-data-gateway

docs/core-services/README.md

@@ -0,0 +1,27 @@
+# Core Services
+
+Core services provide fundamental infrastructure and foundational capabilities for the stock trading platform.
+
+## Services
+
+### Market Data Gateway
+- **Purpose**: Real-time market data processing and distribution
+- **Key Functions**:
+  - WebSocket streaming for live market data
+  - Multi-source data aggregation (Alpaca, Yahoo Finance, etc.)
+  - Data caching and normalization
+  - Rate limiting and connection management
+  - Error handling and reconnection logic
+
+### Risk Guardian
+- **Purpose**: Real-time risk monitoring and controls
+- **Key Functions**:
+  - Position monitoring and risk threshold enforcement
+  - Portfolio risk assessment and alerting
+  - Real-time risk metric calculations
+  - Automated risk controls and circuit breakers
+  - Risk reporting and compliance monitoring
+
+## Architecture
+
+Core services form the backbone of the trading platform, providing essential data flow and risk management capabilities that all other services depend upon. They handle the most critical and time-sensitive operations requiring high reliability and performance.