📊 Add comprehensive analytics endpoints documentation

- Added detailed documentation for all analytics endpoints
- Included exact URLs for deployed Atlas app (findethics-atlas.hf.space)
- Added API usage examples with cURL and JavaScript
- Documented dashboard features and data export capabilities
- Added parameter descriptions and response format examples

DEPLOYMENT.md

@@ -115,27 +115,87 @@ Once deployed, test these endpoints:
 - **Chat API**: `https://your-space-name.hf.space/chat` (POST request)
 - **Search API**: `https://your-space-name.hf.space/search` (POST request)
 
-**Analytics Features:**
+**Analytics Endpoints:**
 - **Interactive Dashboard**: `https://your-space-name.hf.space/analytics/dashboard`
-- **Stats API**: `https://your-space-name.hf.space/analytics/stats`
+- **Basic Stats API**: `https://your-space-name.hf.space/analytics/stats`
 - **Data Export (JSON)**: `https://your-space-name.hf.space/analytics/export?format=json&days=7`
 - **Data Export (CSV)**: `https://your-space-name.hf.space/analytics/export?format=csv&days=7`
 
+**For your deployed Atlas app, the actual URLs are:**
+- **Interactive Dashboard**: `https://findethics-atlas.hf.space/analytics/dashboard`
+- **Basic Stats API**: `https://findethics-atlas.hf.space/analytics/stats`
+- **Data Export (JSON)**: `https://findethics-atlas.hf.space/analytics/export?format=json&days=7`
+- **Data Export (CSV)**: `https://findethics-atlas.hf.space/analytics/export?format=csv&days=7`
+
 **Testing Commands:**
 ```bash
 # Test health endpoint
-curl https://your-space-name.hf.space/
+curl https://findethics-atlas.hf.space/
 
 # Test chat functionality
-curl -X POST https://your-space-name.hf.space/chat \
+curl -X POST https://findethics-atlas.hf.space/chat \
   -H "Content-Type: application/json" \
   -d '{"prompt": "Hello, how are you?", "use_search": true}'
 
-# Test analytics
-curl https://your-space-name.hf.space/analytics/stats
+# Test analytics endpoints
+curl https://findethics-atlas.hf.space/analytics/stats
+curl https://findethics-atlas.hf.space/analytics/export?format=json&days=1
 ```
 
-## 📊 Analytics Features Available
+## 📊 Analytics System Overview
+
+Your Atlas application includes a comprehensive analytics system with multiple endpoints and features:
+
+### 🔗 Analytics Endpoints
+
+#### 1. Interactive Dashboard
+- **URL**: (Analytics Dashbaord)[https://findethics-atlas.hf.space/analytics/dashboard]
+- **Method**: GET
+- **Description**: Full HTML dashboard with interactive charts and real-time metrics
+- **Features**:
+  - Real-time statistics cards (total messages, sessions, active users)
+  - Hourly message activity charts (last 24 hours)
+  - Performance metrics visualization (P50, P90, P95 response times)
+  - Search usage analytics
+  - Auto-refresh functionality
+  - Responsive design for mobile/desktop
+
+#### 2. Basic Statistics API
+- **URL**: `https://findethics-atlas.hf.space/analytics/stats`
+- **Method**: GET
+- **Response**: JSON
+- **Description**: Core analytics metrics in JSON format
+- **Data Includes**:
+  ```json
+  {
+    "total_sessions": 150,
+    "total_messages": 1250,
+    "messages_today": 45,
+    "messages_week": 320,
+    "active_sessions": 12,
+    "search_usage_percentage": 78.5,
+    "average_response_time_ms": 1250,
+    "last_updated": "2024-01-15T10:30:00Z"
+  }
+  ```
+
+#### 3. Data Export (JSON Format)
+- **URL**: `https://findethics-atlas.hf.space/analytics/export?format=json&days=7`
+- **Method**: GET
+- **Parameters**:
+  - `format`: "json" (required)
+  - `days`: Number of days to export (default: 7)
+- **Description**: Export raw analytics data in JSON format
+- **Use Cases**: Data analysis, backup, integration with external tools
+
+#### 4. Data Export (CSV Format)
+- **URL**: `https://findethics-atlas.hf.space/analytics/export?format=csv&days=7`
+- **Method**: GET
+- **Parameters**:
+  - `format`: "csv" (required)
+  - `days`: Number of days to export (default: 7)
+- **Description**: Export analytics data in CSV format for spreadsheet analysis
+- **Use Cases**: Excel analysis, reporting, data visualization tools
 
 ### 🎯 Dashboard Features
 - **Real-time Statistics**: Total messages, sessions, active users
@@ -159,6 +219,36 @@ curl https://your-space-name.hf.space/analytics/stats
 - **Performance Data**: Response times, error rates, search engine performance
 - **Search Analytics**: Query terms, result counts, engine fallback usage
 
+### 🛠️ API Usage Examples
+
+#### Testing Basic Stats
+```bash
+curl https://findethics-atlas.hf.space/analytics/stats
+```
+
+#### Exporting Last 30 Days (JSON)
+```bash
+curl "https://findethics-atlas.hf.space/analytics/export?format=json&days=30" > analytics_data.json
+```
+
+#### Exporting Last Week (CSV)
+```bash
+curl "https://findethics-atlas.hf.space/analytics/export?format=csv&days=7" > analytics_data.csv
+```
+
+#### JavaScript Integration
+```javascript
+// Fetch basic stats
+fetch('https://findethics-atlas.hf.space/analytics/stats')
+  .then(response => response.json())
+  .then(data => console.log('Analytics:', data));
+
+// Export data
+fetch('https://findethics-atlas.hf.space/analytics/export?format=json&days=7')
+  .then(response => response.json())
+  .then(data => console.log('Export data:', data));
+```
+
 ## 🛠️ Troubleshooting
 
 ### Common Issues: