Merge pull request #128 from rudra3007-pro/feat/health-check-endpoint

feat: add /health endpoint for server status check

Author: komalharshita

routes/main_routes.py

@@ -8,6 +8,7 @@
 from utils.recommender import get_recommendations, validate_recommendation_inputs
 from utils.data_loader import find_project_by_id, get_project_stats
 from utils.file_server import read_starter_code, resolve_starter_file, get_starter_code_dir
+import os
 
 # Create the Blueprint that app.py will register
 main = Blueprint("main", __name__)
@@ -19,6 +20,16 @@ def index():
     stats = get_project_stats()
     return render_template("index.html", stats=stats)
 
+@main.route("/health")
+def health_check():
+    """
+    Returns server status. Useful for uptime monitors and Docker health checks.
+    """
+    return jsonify({
+        "status": "ok",
+        "version": os.getenv("APP_VERSION", "1.0.0")
+    }), 200
+
 
 @main.route("/api/recommend", methods=["POST"])
 def recommend():

tests/test_basic.py

@@ -279,6 +279,14 @@ def test_download_code_found():
     client = get_client()
     response = client.get("/project/1/download")
     assert response.status_code == 200
+    
+def test_health_check(client):
+    response = client.get("/health")
+    assert response.status_code == 200
+    data = response.get_json()
+    assert "status" in data
+    assert "version" in data
+    assert data["status"] == "ok"
 
 
 from utils.recommender import SCORING_WEIGHTS