🚨 CRITICAL: Missing health endpoint causes 404 on basic API calls

[alicoding]

🐛 Problem Description

Basic API health checks return 404, making it impossible to verify service is running.

# Current behavior - both return 404
curl http://localhost:8000/health
curl http://localhost:8000/

🎯 Expected Behavior

• GET /health returns 200 OK with service status
• GET / returns basic API info
• Health endpoint validates core dependencies

🔍 Root Cause Analysis

• No health endpoints defined in src/integrations/api.py despite having 34+ other endpoints
• FastAPI app has no root route handler
• Missing validation of Qdrant/Redis connectivity

📋 Definition of Ready (DoR)

• Bug reproduced and documented
• Root cause identified
• Expected behavior defined
• Research LlamaIndex native health check patterns

✅ Definition of Done (DoD)

• GET /health endpoint returns proper health status
• GET / endpoint returns API info
• Health check validates:
  • LlamaIndex Settings are initialized
  • Qdrant connection is working
  • Redis connection is working (if enabled)
• Health endpoint follows LlamaIndex native patterns
• Docker health check updated to use new endpoint
• API documentation updated
• Integration test added
• Manual testing completed

🔥 Impact

• CRITICAL - Blocks basic usage
• Docker health checks fail
• Load balancers can't verify service status
• Basic API debugging impossible

📚 References

• See PRODUCTION_READINESS_AUDIT.md - API Layer section
• FastAPI health check patterns
• LlamaIndex deployment best practices

🏷️ Labels

critical, api, production