Document weather endpoints and remove sports API

DEPLOYMENT.md

@@ -12,14 +12,25 @@
 
 Set these in your HuggingFace Space settings (Settings → Variables and secrets):
 
-1. **WEATHER_API_KEY** (Optional)
-   - Default provided in code
+1. **WEATHER_API_KEY** (Required for weather features)
    - Get from: https://www.weatherapi.com/
 
 2. **EXPERT_MODEL_NAME** (Optional)
    - Default: `Qwen/Qwen1.5-1.8B`
    - Can override if needed
 
+3. **WEATHER_FORECAST_DAYS** (Optional)
+   - Default: `3`
+   - Controls default forecast horizon for internal weather summaries.
+
+4. **WEATHER_AQI** (Optional)
+   - Default: `yes`
+   - Set to `no` to disable air quality data in WeatherAPI responses used internally.
+
+5. **WEATHER_ALERTS** (Optional)
+   - Default: `yes`
+   - Controls whether alerts are requested from WeatherAPI in internal calls.
+
 ## Deployment Steps
 
 ### 1. Stage Files for Commit
@@ -72,8 +83,11 @@ git push origin main
    - Should return a JSON status message indicating the Aglimate backend is running.
 
 2. **Test Endpoints**:
-   - `/ask` - Test multilingual farming Q&A
-   - `/advise` - Test multimodal climate-resilient advisory (text + optional photo + GPS)
+   - `/ask` - Multilingual farming Q&A
+   - `/advise` - Multimodal climate-resilient advisory (text + optional photo + GPS)
+   - `/weather/current` - Direct realtime weather + AQI
+   - `/weather/forecast` - Forecast + alerts for a location
+   - `/weather-alerts` - Alerts-only view for climate risk UIs
 
 ### Expected Behavior
 

SYSTEM_OVERVIEW.md

@@ -132,6 +132,50 @@ Aglimate addresses these challenges by providing:
 4. **Output**
    - JSON response: `{ answer, session_id, latitude, longitude, used_image, model_used }`
 
+---
+
+### 3.3 Climate & Weather Data APIs – `/weather/*`
+
+To support climate-first decision making and give frontend engineers clear integration points, Aglimate exposes a set of WeatherAPI-backed endpoints:
+
+- **`GET /weather/current`**  
+  - **Inputs**: `q` (free query), or `state`, or `lat`+`lon`; optional `aqi`.  
+  - **Output**: Raw WeatherAPI `current.json` (realtime weather + optional air quality).
+
+- **`GET /weather/forecast`**  
+  - **Inputs**: same `q` / `state` / `lat`+`lon`; `days` (1–14), `alerts`, `aqi`.  
+  - **Output**: Raw `forecast.json` (multi-day forecast + alerts + AQI).
+
+- **`GET /weather-alerts`**  
+  - **Inputs**: `q` / `state` / `lat`+`lon`.  
+  - **Output**: `{ location, alerts }` extracted from `forecast.json` for UI alert displays.
+
+- **`GET /weather/history`**  
+  - **Inputs**: `q` / `state` / `lat`+`lon`, `dt`, optional `end_dt`, `hour`, `aqi`.  
+  - **Output**: Raw `history.json` for past climate/condition analysis.
+
+- **`GET /weather/marine`**  
+  - **Inputs**: `q` or `lat`+`lon`, `days` (1–7), `tides`.  
+  - **Output**: Raw `marine.json` (marine + tide data where available).
+
+- **`GET /weather/future`**  
+  - **Inputs**: `q` / `state` / `lat`+`lon`, `dt` (future date).  
+  - **Output**: Raw `future.json` (3-hourly forecast for future date).
+
+- **`GET /weather/timezone`**  
+  - **Inputs**: `q` / `state` / `lat`+`lon`.  
+  - **Output**: Raw `timezone.json` (time zone + local time data).
+
+- **`GET /weather/search`**  
+  - **Inputs**: `q` (partial city/zip/etc.).  
+  - **Output**: Raw `search.json` (location suggestions for UI autocompletes).
+
+- **`GET /weather/ip`**  
+  - **Inputs**: optional `ip` (falls back to `auto:ip`).  
+  - **Output**: Raw `ip.json` (IP-based location lookup).
+
+These endpoints are designed as thin pass-throughs over WeatherAPI, so frontend engineers can call them directly or use their outputs inside richer Aglimate views.
+
 ## 4. Technologies Used
 
 ### 4.1 Backend Framework & Infrastructure

app/main.py

@@ -361,20 +361,6 @@ def weather_astronomy(
         raise HTTPException(status_code=502, detail=f"WeatherAPI request failed: {e}")
 
 
-@app.get("/weather/sports")
-def weather_sports(q: str):
-    if not config.WEATHER_API_KEY:
-        raise HTTPException(status_code=500, detail="WEATHER_API_KEY is not configured")
-    url = "http://api.weatherapi.com/v1/sports.json"
-    params = {"key": config.WEATHER_API_KEY, "q": q}
-    try:
-        resp = requests.get(url, params=params, timeout=10)
-        resp.raise_for_status()
-        return resp.json()
-    except Exception as e:
-        raise HTTPException(status_code=502, detail=f"WeatherAPI request failed: {e}")
-
-
 @app.get("/weather/ip")
 def weather_ip(ip: Optional[str] = None):
     if not config.WEATHER_API_KEY: