tests/README.md

# Atlas Analytics Test Suite

This folder contains test scripts for validating the Atlas analytics system functionality.

## Test Files

### Core Tests

- **`test_mongo_connection.py`** - Test MongoDB connection (both sync and async)
- **`test_analytics.py`** - Basic analytics functions test
- **`debug_analytics.py`** - Comprehensive analytics debugging tool

### Integration Tests

- **`test_chat_analytics.py`** - Test end-to-end chat analytics collection
- **`validate_mongodb_data.py`** - Validate data collection and dashboard accuracy

### Deployment Tests

- **`deployment_check.py`** - Complete deployment readiness check

## Usage

### Quick MongoDB Test
```bash
cd tests
python test_mongo_connection.py
```

### Debug Analytics Issues
```bash
cd tests
python debug_analytics.py
```

### Validate Data Collection
```bash
cd tests
python validate_mongodb_data.py
```

### Test Chat Analytics (requires server running)
```bash
cd tests
python test_chat_analytics.py
```

### Deployment Readiness Check
```bash
cd tests
python deployment_check.py
```

## Prerequisites

- Atlas server environment activated
- `.env` file configured with MongoDB, Google, and Brave API keys
- MongoDB Atlas connection working

## Test Scenarios

### 1. Fresh Installation
```bash
python deployment_check.py
```

### 2. Analytics Not Working
```bash
python debug_analytics.py
```

### 3. Data Collection Issues
```bash
python validate_mongodb_data.py
```

### 4. End-to-End Testing
```bash
# Start server first
./start.sh

# Then test
python test_chat_analytics.py
```

## Expected Results

All tests should pass with ✅ indicators when the system is working correctly. Any ❌ indicators suggest issues that need to be resolved.