agroplan-ai-cli 1.0.35 → 1.0.36

package/backend-template/VERSION.json

@@ -1,6 +1,6 @@
 {
-  "cli_version": "1.0.35",
-  "backend_template_version": "1.0.35",
+  "cli_version": "1.0.36",
+  "backend_template_version": "1.0.36",
   "zarc_index_version": "2025-2026-fast-index-v2",
   "price_index_version": "2025-05-reference-v1",
   "features": [
@@ -24,7 +24,8 @@
     "expanded_crop_calendar_10_cultures",
     "calendar_date_safety",
     "calendar_weather_integration",
-    "calendar_weather_dependency_fix"
+    "calendar_weather_dependency_fix",
+    "nasa_power_climatology"
   ],
-  "generated_at": "2026-05-10T22:00:00Z"
+  "generated_at": "2026-05-10T23:00:00Z"
 }

package/backend-template/api.py

@@ -372,6 +372,49 @@ def get_clima(
     except Exception as e:
         raise HTTPException(status_code=500, detail=str(e))
 
+@app.get("/dados/clima/nasa-power")
+def get_clima_nasa_power(
+    lat: Optional[float] = Query(None, description="Latitude"),
+    lon: Optional[float] = Query(None, description="Longitude"),
+    month: int = Query(None, description="Mês (1-12)")
+):
+    """Obtém climatologia NASA POWER para um mês específico"""
+    try:
+        from providers.nasa_power_provider import buscar_climatologia_nasa_power, get_nasa_power_status
+        
+        # Se lat ou lon não foram fornecidos, retornar informações
+        if lat is None or lon is None or month is None:
+            return {
+                "message": "Informe latitude, longitude e mês para consultar climatologia NASA POWER.",
+                "exemplo": "/dados/clima/nasa-power?lat=-21.56&lon=-50.45&month=5",
+                "parametros": {
+                    "lat": "Latitude da localização",
+                    "lon": "Longitude da localização",
+                    "month": "Mês (1-12)"
+                },
+                "provider_info": get_nasa_power_status()
+            }
+        
+        if month < 1 or month > 12:
+            raise HTTPException(status_code=400, detail="Month deve estar entre 1 e 12")
+        
+        # Buscar climatologia
+        climatology = buscar_climatologia_nasa_power(lat, lon, month)
+        
+        if climatology:
+            return climatology
+        else:
+            return {
+                "message": "Não foi possível obter dados NASA POWER para esta localização.",
+                "lat": lat,
+                "lon": lon,
+                "month": month,
+                "note": "NASA POWER pode estar temporariamente indisponível ou a localização pode estar fora da cobertura."
+            }
+        
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
 @app.get("/dados/zarc")
 def get_zarc(
     cultura: Optional[str] = Query(None, description="Nome da cultura"),

package/backend-template/core/calendar_weather_adapter.py

@@ -121,8 +121,12 @@ def enriquecer_calendario_com_clima(
             
             # Gerar resumo
             forecast_type = weather_data.get("forecast_type", "climatology")
+            source = weather_data.get("source", "unknown")
+            
             if forecast_type == "forecast":
                 summary = f"Previsão: {weather_data.get('precipitation_sum', 0):.1f}mm de chuva, {weather_data.get('temperature_min', 0):.0f}°C a {weather_data.get('temperature_max', 0):.0f}°C"
+            elif source == "nasa-power":
+                summary = f"Climatologia NASA POWER: temperatura média {weather_data.get('temperature_avg', 0):.0f}°C, {weather_data.get('precipitation_expected', 'condições típicas')}"
             else:
                 summary = f"Climatologia: {weather_data.get('precipitation_expected', 'Condições típicas')}"
             

package/backend-template/providers/calendar_weather_provider.py

@@ -99,8 +99,7 @@ def buscar_climatologia_longo_prazo(
     """
     Busca climatologia/histórico para períodos longos (17+ dias).
     
-    Inicialmente usa fallback local mensal.
-    Futuramente pode integrar NASA POWER.
+    Tenta usar NASA POWER primeiro, fallback local se falhar.
     
     Args:
         lat: Latitude
@@ -112,28 +111,52 @@ def buscar_climatologia_longo_prazo(
         Lista de dicionários com climatologia por data/mês
     """
     
-    # Por enquanto, usar fallback local baseado em médias mensais
-    # Futuramente: integrar NASA POWER Climatology API
+    from .nasa_power_provider import buscar_climatologia_nasa_power
     
     result = []
     current = start_date
     
+    # Cache de dados NASA POWER por mês
+    nasa_cache = {}
+    
     while current <= end_date:
         month = current.month
         
-        # Climatologia simplificada por mês (Brasil)
-        climatology = _get_monthly_climatology(month, lat, lon)
+        # Tentar NASA POWER primeiro
+        if month not in nasa_cache:
+            nasa_data = buscar_climatologia_nasa_power(lat, lon, month)
+            nasa_cache[month] = nasa_data
+        
+        nasa_data = nasa_cache[month]
         
-        result.append({
-            "date": current.isoformat(),
-            "source": "climate-fallback",
-            "forecast_type": "climatology",
-            "temperature_max": climatology["temp_max"],
-            "temperature_min": climatology["temp_min"],
-            "precipitation_expected": climatology["precip_desc"],
-            "precipitation_mm_avg": climatology["precip_mm"],
-            "confidence": "media"
-        })
+        if nasa_data:
+            # Usar dados NASA POWER
+            result.append({
+                "date": current.isoformat(),
+                "source": "nasa-power",
+                "forecast_type": "climatology",
+                "temperature_max": nasa_data["temperature_max"],
+                "temperature_min": nasa_data["temperature_min"],
+                "temperature_avg": nasa_data["temperature_avg"],
+                "precipitation_expected": nasa_data["precipitation_expected"],
+                "precipitation_mm_avg": nasa_data["precipitation_mm_avg"],
+                "confidence": "media",
+                "note": "Climatologia NASA POWER, não previsão exata"
+            })
+        else:
+            # Fallback local se NASA POWER falhar
+            climatology = _get_monthly_climatology(month, lat, lon)
+            result.append({
+                "date": current.isoformat(),
+                "source": "climate-fallback",
+                "forecast_type": "climatology",
+                "temperature_max": climatology["temp_max"],
+                "temperature_min": climatology["temp_min"],
+                "precipitation_expected": climatology["precip_desc"],
+                "precipitation_mm_avg": climatology["precip_mm"],
+                "confidence": "baixa",
+                "note": "Climatologia simplificada, NASA POWER indisponível"
+            })
         
         current += timedelta(days=1)
     

package/backend-template/providers/nasa_power_provider.py

@@ -0,0 +1,136 @@
+"""
+Provider NASA POWER para Climatologia
+
+Usa NASA POWER Climatology API para obter dados históricos/climatológicos
+para períodos além da janela de previsão meteorológica (17+ dias).
+
+NASA POWER não é previsão exata, é climatologia/histórico.
+"""
+
+from typing import Dict, Optional
+import requests
+from .cache import get_cache, set_cache
+
+
+def buscar_climatologia_nasa_power(
+    lat: float,
+    lon: float,
+    month: int
+) -> Optional[Dict]:
+    """
+    Busca climatologia NASA POWER para um mês específico.
+    
+    Args:
+        lat: Latitude
+        lon: Longitude
+        month: Mês (1-12)
+    
+    Returns:
+        Dicionário com dados climatológicos ou None se falhar
+    """
+    
+    # Cache key
+    cache_key = f"nasa_power:{lat}:{lon}:{month}"
+    cached = get_cache(cache_key)
+    if cached:
+        return cached
+    
+    try:
+        # NASA POWER Climatology API
+        # Documentação: https://power.larc.nasa.gov/docs/services/api/
+        
+        # Parâmetros climatológicos
+        parameters = [
+            "T2M",           # Temperatura média a 2m
+            "T2M_MAX",       # Temperatura máxima a 2m
+            "T2M_MIN",       # Temperatura mínima a 2m
+            "PRECTOTCORR",   # Precipitação total corrigida
+        ]
+        
+        # Endpoint NASA POWER Climatology
+        url = "https://power.larc.nasa.gov/api/temporal/climatology/point"
+        
+        params = {
+            "parameters": ",".join(parameters),
+            "community": "AG",  # Agricultural community
+            "longitude": lon,
+            "latitude": lat,
+            "format": "JSON"
+        }
+        
+        response = requests.get(url, params=params, timeout=15)
+        response.raise_for_status()
+        data = response.json()
+        
+        # Extrair dados do mês específico
+        properties = data.get("properties", {}).get("parameter", {})
+        
+        # NASA POWER retorna dados mensais (1-12)
+        month_str = str(month)
+        
+        temp_avg = properties.get("T2M", {}).get(month_str)
+        temp_max = properties.get("T2M_MAX", {}).get(month_str)
+        temp_min = properties.get("T2M_MIN", {}).get(month_str)
+        precip = properties.get("PRECTOTCORR", {}).get(month_str)
+        
+        # Validar dados
+        if temp_avg is None or precip is None:
+            return None
+        
+        # Classificar precipitação
+        if precip < 50:
+            precip_desc = "Período seco"
+        elif precip < 100:
+            precip_desc = "Chuvas ocasionais"
+        elif precip < 150:
+            precip_desc = "Chuvas moderadas"
+        elif precip < 200:
+            precip_desc = "Chuvas frequentes"
+        else:
+            precip_desc = "Estação chuvosa"
+        
+        result = {
+            "source": "nasa-power",
+            "forecast_type": "climatology",
+            "month": month,
+            "temperature_avg": round(temp_avg, 1),
+            "temperature_max": round(temp_max, 1) if temp_max else None,
+            "temperature_min": round(temp_min, 1) if temp_min else None,
+            "precipitation_expected": precip_desc,
+            "precipitation_mm_avg": round(precip, 1),
+            "confidence": "media",
+            "note": "Dados climatológicos/históricos NASA POWER, não previsão exata."
+        }
+        
+        # Cache por 7 dias (climatologia muda pouco)
+        set_cache(cache_key, result, ttl_seconds=604800)
+        
+        return result
+        
+    except requests.exceptions.Timeout:
+        print(f"Timeout ao buscar NASA POWER para lat={lat}, lon={lon}, month={month}")
+        return None
+    except requests.exceptions.RequestException as e:
+        print(f"Erro ao buscar NASA POWER: {e}")
+        return None
+    except Exception as e:
+        print(f"Erro inesperado ao processar NASA POWER: {e}")
+        return None
+
+
+def get_nasa_power_status() -> Dict:
+    """
+    Retorna status do provider NASA POWER.
+    
+    Returns:
+        Dicionário com informações de status
+    """
+    return {
+        "provider": "NASA POWER",
+        "type": "climatology",
+        "source": "https://power.larc.nasa.gov/",
+        "parameters": ["T2M", "T2M_MAX", "T2M_MIN", "PRECTOTCORR"],
+        "community": "AG (Agricultural)",
+        "cache_ttl": "7 days",
+        "note": "Climatologia/histórico, não previsão exata"
+    }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agroplan-ai-cli",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "CLI global para AgroPlan AI - modo local acelerado",
   "type": "module",
   "bin": {