# TLI Integration Tests - Quick Start Guide

## Quick Test Execution

### Run All Integration Tests
```bash
cd /home/jgrusewski/Work/foxhunt/tli
cargo test --test integration
```

### Run Specific Test Categories
```bash
# Service communication tests
cargo test --test integration service_integration

# Database operation tests
cargo test --test integration database_integration

# End-to-end workflow tests
cargo test --test integration end_to_end

# Error handling and resilience tests
cargo test --test integration error_handling

# Performance and load tests
cargo test --test integration performance
```

### Run with Detailed Output
```bash
# See test output and logs
RUST_LOG=info cargo test --test integration -- --nocapture

# Debug mode with full logging
RUST_LOG=debug cargo test --test integration -- --nocapture
```

## Test Structure Summary

| Test File | Purpose | Key Test Areas |
|-----------|---------|----------------|
| `service_integration_tests.rs` | Service-to-service communication | Trading orders, backtesting, config management, event streaming |
| `database_integration_tests.rs` | Database operations | SQLite config, PostgreSQL events, InfluxDB metrics, transactions |
| `end_to_end_tests.rs` | Complete business workflows | Order lifecycle, backtest workflow, auth flow, event storage |
| `error_handling_tests.rs` | System resilience | Service failures, network issues, invalid data, circuit breakers |
| `performance_tests.rs` | Load and performance | Concurrent requests, HFT simulation, stress testing |

## Environment Variables (Optional)

```bash
# PostgreSQL testing (if available)
export TEST_POSTGRES_URL="postgresql://user:password@localhost:5432/test_db"

# InfluxDB testing (if available)
export TEST_INFLUX_URL="http://localhost:8086"
export TEST_INFLUX_TOKEN="your_token"
export TEST_INFLUX_ORG="test_org"

# Enable real-time tests
export TLI_ENABLE_RT_TESTS="true"

# Logging
export RUST_LOG="info"
```

## Test Results Interpretation

### Success Indicators
- ✅ All tests pass
- ✅ Performance targets met
- ✅ Error handling validates correctly
- ✅ No memory leaks or resource issues

### Common Issues
- **Port conflicts**: Change mock server ports in test config
- **Database unavailable**: Tests will skip PostgreSQL/InfluxDB if not configured
- **Timeouts**: May indicate performance issues or resource constraints

## Performance Benchmarks

### Expected Results
- **Order Submission**: < 10ms P99 latency, > 1000 RPS throughput
- **Market Data**: > 10,000 updates/second processing
- **Database Operations**: < 5ms P99 for configuration queries
- **Memory Usage**: < 512MB under load

## Full Documentation

See `INTEGRATION_TEST_GUIDE.md` for comprehensive documentation including:
- Detailed test descriptions
- Setup requirements
- Troubleshooting guide
- Contributing guidelines
- CI/CD integration

## Support

For issues or questions:
1. Check the troubleshooting section in `INTEGRATION_TEST_GUIDE.md`
2. Review test logs with `RUST_LOG=debug`
3. Verify environment setup and dependencies