foxhunt/INTEGRATION_TEST_QUICKSTART.md

# Multi-Service Integration Test - Quick Start

**Status**: Ready to Execute
**Estimated Time**: 30-45 minutes
**Agent**: Wave 105 Agent 4

---

## TL;DR

All configuration complete. Execute this command to run full integration test:

```bash
cd /home/jgrusewski/Work/foxhunt
./scripts/test_service_integration.sh
```

---

## What Was Done

✅ Added 4 gRPC services to docker-compose.yml:
- api_gateway (port 50051)
- trading_service (port 50052)
- backtesting_service (port 50053)
- ml_training_service (port 50054)

✅ Fixed docker-compose.override.yml service naming conflicts

✅ Created automated test script with 9 phases and 30+ checks

✅ Validated docker-compose configuration

---

## Quick Commands

### Start All Services
```bash
docker-compose up -d
```

### Check Service Status
```bash
docker-compose ps
```

### View Logs
```bash
# All services
docker-compose logs -f

# Specific service
docker-compose logs -f api_gateway
docker-compose logs -f trading_service
```

### Health Checks
```bash
# API Gateway
grpcurl -plaintext localhost:50051 grpc.health.v1.Health/Check

# Trading Service
grpcurl -plaintext localhost:50052 grpc.health.v1.Health/Check

# Backtesting Service
grpcurl -plaintext localhost:50053 grpc.health.v1.Health/Check

# ML Training Service
grpcurl -plaintext localhost:50054 grpc.health.v1.Health/Check
```

### Stop All Services
```bash
docker-compose down
```

### Stop and Remove Volumes
```bash
docker-compose down -v
```

---

## Service Ports

| Service | gRPC Port | Metrics Port |
|---------|-----------|--------------|
| api_gateway | 50051 | 9091 |
| trading_service | 50052 | 9092 |
| backtesting_service | 50053 | 9093 |
| ml_training_service | 50054 | 9094 |

---

## Expected Build Time

- trading_service: 5-10 minutes
- backtesting_service: 3-5 minutes
- ml_training_service: 5-10 minutes
- api_gateway: 3-5 minutes

**Total**: 15-30 minutes (first build)

---

## Troubleshooting

### Build Failures
```bash
# Check build logs
docker-compose build api_gateway 2>&1 | tee build.log

# Clean and rebuild
docker-compose down -v
docker-compose build --no-cache SERVICE_NAME
```

### Service Won't Start
```bash
# Check logs
docker-compose logs SERVICE_NAME

# Check dependencies
docker-compose ps postgres redis vault

# Restart service
docker-compose restart SERVICE_NAME
```

### Health Check Failing
```bash
# Check if service is listening
docker-compose exec SERVICE_NAME netstat -tlnp

# Check service logs
docker-compose logs --tail=50 SERVICE_NAME

# Manual health probe
docker-compose exec SERVICE_NAME /usr/local/bin/grpc_health_probe -addr=localhost:PORT
```

---

## Success Criteria

All these should pass:

- [ ] All 4 services start (docker-compose ps shows "Up")
- [ ] All health checks return {"status": "SERVING"}
- [ ] No errors in logs (docker-compose logs | grep -i error)
- [ ] API Gateway can reach backend services
- [ ] All metrics endpoints respond (ports 9091-9094)

---

## Full Documentation

See: **WAVE105_AGENT4_SERVICE_INTEGRATION.md**

---

**Ready to test!** Run: `./scripts/test_service_integration.sh`