agroplan-ai-cli 1.0.27 → 1.0.28

package/backend-template/.env.example

@@ -20,6 +20,10 @@ DATA_MODE=hybrid
 WEATHER_PROVIDER=open-meteo
 PROVIDER_CACHE_TTL=3600
 
+# Debug Configuration
+# Set to true to expose detailed error tracebacks (development only)
+DEBUG_ERRORS=false
+
 # Cache Administration (optional)
 # If set, /cache/limpar endpoint requires X-Cache-Token header
 # Leave empty to disable protection (not recommended for production)

package/backend-template/VERSION.json

@@ -1,6 +1,6 @@
 {
-  "cli_version": "1.0.27",
-  "backend_template_version": "1.0.27",
+  "cli_version": "1.0.28",
+  "backend_template_version": "1.0.28",
   "zarc_index_version": "2025-2026-fast-index-v2",
   "price_index_version": "2025-05-reference-v1",
   "features": [
@@ -15,7 +15,8 @@
     "price_unit_normalization",
     "market_profit_estimate",
     "market_profit_validation",
-    "market_profit_confidence_refinement"
+    "market_profit_confidence_refinement",
+    "market_profit_comparative_evaluation"
   ],
-  "generated_at": "2026-05-09T23:00:00Z"
+  "generated_at": "2026-05-09T23:30:00Z"
 }

package/backend-template/api.py

@@ -28,6 +28,7 @@ CORS_ORIGINS = os.getenv("CORS_ORIGINS", "http://localhost:3000,http://127.0.0.1
 DATA_MODE = os.getenv("DATA_MODE", "hybrid")  # simulated, real, hybrid
 WEATHER_PROVIDER = os.getenv("WEATHER_PROVIDER", "open-meteo")
 PROVIDER_CACHE_TTL = int(os.getenv("PROVIDER_CACHE_TTL", "3600"))
+DEBUG_ERRORS = os.getenv("DEBUG_ERRORS", "false").lower() == "true"
 
 # Cache em memória para resultados pesados
 _resultados_cache = {}
@@ -580,6 +581,69 @@ def get_debug_lucro_mercado(
     except Exception as e:
         raise HTTPException(status_code=500, detail=str(e))
 
+@app.get("/comparar/lucro-mercado")
+def comparar_lucro_mercado(
+    objetivo: str = Query("equilibrado", description="Objetivo de otimização"),
+    seed: int = Query(42, description="Seed para reprodutibilidade"),
+    geracoes: int = Query(100, description="Número de gerações do AG"),
+    populacao: int = Query(50, description="Tamanho da população"),
+    lat: Optional[float] = Query(None, description="Latitude"),
+    lon: Optional[float] = Query(None, description="Longitude"),
+    days: int = Query(30, description="Dias para análise climática"),
+    uf: Optional[str] = Query(None, description="Unidade Federativa (ex: SP, PR)"),
+    municipio: Optional[str] = Query(None, description="Município"),
+    safra: str = Query("2025/2026", description="Safra ZARC")
+):
+    """
+    Avalia o plano do sistema usando lucro de mercado para comparação.
+    
+    NÃO gera um plano otimizado por mercado. Apenas:
+    1. Gera plano normal com AG usando lucro do sistema
+    2. Avalia esse mesmo plano com lucro de mercado normalizado
+    3. Compara os dois valores de lucro
+    
+    Retorna:
+    - modo: "avaliacao_comparativa"
+    - plano_sistema: Plano otimizado pelo AG normal
+    - avaliacao_mercado: Avaliação do mesmo plano com lucro de mercado
+    - comparacao: Diferenças e validação
+    """
+    try:
+        from core.market_profit_comparator import comparar_plano_sistema_com_avaliacao_mercado
+        
+        culturas, talhoes, regras = get_dados()
+        
+        resultado = comparar_plano_sistema_com_avaliacao_mercado(
+            culturas=culturas,
+            talhoes=talhoes,
+            regras=regras,
+            uf=uf,
+            municipio=municipio,
+            safra=safra,
+            objetivo=objetivo,
+            seed=seed,
+            geracoes=geracoes,
+            populacao=populacao
+        )
+        
+        return converter_tipos_python(resultado)
+        
+    except Exception as e:
+        import traceback
+        if DEBUG_ERRORS:
+            raise HTTPException(
+                status_code=500,
+                detail={
+                    "error": str(e),
+                    "traceback": traceback.format_exc()
+                }
+            )
+        else:
+            raise HTTPException(
+                status_code=500,
+                detail="Erro ao gerar avaliação comparativa de lucro de mercado."
+            )
+
 @app.get("/dashboard")
 def get_dashboard(
     lat: Optional[float] = None,

package/backend-template/core/market_profit_comparator.py

@@ -0,0 +1,171 @@
+"""
+Avaliação Comparativa: Plano Sistema vs Avaliação com Lucro de Mercado
+
+Avalia o plano otimizado pelo sistema usando lucro de mercado normalizado.
+NÃO gera um novo plano otimizado por mercado - apenas avalia o plano atual.
+
+Bloqueia uso automático se houver itens críticos ou baixa confiabilidade.
+"""
+
+from typing import Dict, List, Optional
+from core.planner import gerar_plano_genetico
+from core.price_adapter import aplicar_precos_no_plano
+from core.market_profit_validator import validar_plano_lucro_mercado
+
+
+def comparar_plano_sistema_com_avaliacao_mercado(
+    culturas: List[Dict],
+    talhoes: List[Dict],
+    regras: List[Dict],
+    uf: Optional[str] = None,
+    municipio: Optional[str] = None,
+    safra: str = "2025/2026",
+    objetivo: str = "equilibrado",
+    seed: int = 42,
+    geracoes: int = 100,
+    populacao: int = 50
+) -> Dict:
+    """
+    Avalia o plano do sistema usando lucro de mercado para comparação.
+    
+    NÃO gera um plano otimizado por mercado. Apenas:
+    1. Gera plano normal com AG usando lucro do sistema
+    2. Avalia esse mesmo plano com lucro de mercado normalizado
+    3. Compara os dois valores de lucro
+    
+    Args:
+        culturas: Lista de culturas disponíveis
+        talhoes: Lista de talhões
+        regras: Regras de compatibilidade
+        uf: Unidade Federativa
+        municipio: Município
+        safra: Safra agrícola
+        objetivo: Objetivo de otimização
+        seed: Seed para reprodutibilidade
+        geracoes: Número de gerações do AG
+        populacao: Tamanho da população
+    
+    Returns:
+        Dict com modo, plano_sistema, avaliacao_mercado e comparacao
+    """
+    
+    # 1. Gerar plano principal normalmente
+    resultado = gerar_plano_genetico(
+        culturas=culturas,
+        talhoes=talhoes,
+        regras=regras,
+        objetivo=objetivo,
+        seed=seed,
+        geracoes=geracoes,
+        populacao=populacao
+    )
+    
+    # 2. Aplicar ZARC, se houver UF
+    if uf:
+        try:
+            from core.zarc_adapter import enriquecer_plano_com_zarc
+            resultado = enriquecer_plano_com_zarc(
+                resultado,
+                uf=uf,
+                municipio=municipio,
+                safra=safra
+            )
+        except Exception as zarc_error:
+            resultado["zarc_error"] = str(zarc_error)
+    
+    # 3. Aplicar preços
+    # IMPORTANTE: aplicar_precos_no_plano só aceita uf por enquanto
+    resultado = aplicar_precos_no_plano(resultado, uf=uf)
+    
+    # 4. Validar lucro de mercado
+    resultado = validar_plano_lucro_mercado(resultado)
+    
+    plano = resultado.get("plano", [])
+    
+    lucro_sistema_total = float(resultado.get("lucro_total", 0) or 0)
+    
+    lucro_mercado_total = 0.0
+    itens_mercado = []
+    
+    for item in plano:
+        lucro_mercado = item.get("lucro_mercado_estimado")
+        
+        if lucro_mercado is not None:
+            try:
+                lucro_mercado_float = float(lucro_mercado)
+                lucro_mercado_total += lucro_mercado_float
+            except Exception:
+                lucro_mercado_float = None
+        else:
+            lucro_mercado_float = None
+        
+        itens_mercado.append({
+            "talhao": item.get("talhao"),
+            "cultura": item.get("cultura"),
+            "lucro_sistema": item.get("lucro_estimado"),
+            "lucro_mercado_estimado": lucro_mercado_float,
+            "preco_real": item.get("preco_real"),
+            "preco_normalizado": item.get("preco_normalizado"),
+            "validacao_lucro_mercado": item.get("validacao_lucro_mercado")
+        })
+    
+    diferenca_absoluta = lucro_mercado_total - lucro_sistema_total
+    
+    if lucro_sistema_total != 0:
+        diferenca_percentual = (diferenca_absoluta / abs(lucro_sistema_total)) * 100
+    else:
+        diferenca_percentual = 0
+    
+    validacao = resultado.get("validacao_lucro_mercado", {}) or {}
+    
+    total = len(plano)
+    alta = int(validacao.get("itens_alta_confiabilidade", 0) or 0)
+    media = int(validacao.get("itens_media_confiabilidade", 0) or 0)
+    baixa = int(validacao.get("itens_baixa_confiabilidade", 0) or 0)
+    criticos = int(validacao.get("itens_criticos", 0) or 0)
+    
+    percentual_alta = (alta / total * 100) if total else 0
+    
+    pode_usar_mercado = (
+        criticos == 0
+        and baixa == 0
+        and percentual_alta >= 70
+    )
+    
+    motivo_bloqueio = None
+    if not pode_usar_mercado:
+        motivos = []
+        if criticos > 0:
+            motivos.append(f"{criticos} item(ns) crítico(s)")
+        if baixa > 0:
+            motivos.append(f"{baixa} item(ns) de baixa confiabilidade")
+        if percentual_alta < 70:
+            motivos.append(f"apenas {percentual_alta:.1f}% dos itens têm alta confiabilidade")
+        
+        motivo_bloqueio = (
+            "O lucro de mercado não deve ser usado como recomendação principal: "
+            + "; ".join(motivos)
+        )
+    
+    return {
+        "modo": "avaliacao_comparativa",
+        "descricao": "Avalia o plano principal usando lucro de mercado normalizado, sem substituir a recomendação oficial.",
+        "plano_sistema": resultado,
+        "avaliacao_mercado": {
+            "lucro_mercado_total": lucro_mercado_total,
+            "itens": itens_mercado
+        },
+        "comparacao": {
+            "lucro_sistema_total": lucro_sistema_total,
+            "lucro_mercado_total": lucro_mercado_total,
+            "diferenca_absoluta": diferenca_absoluta,
+            "diferenca_percentual": diferenca_percentual,
+            "itens_alta_confiabilidade": alta,
+            "itens_media_confiabilidade": media,
+            "itens_baixa_confiabilidade": baixa,
+            "itens_criticos": criticos,
+            "percentual_alta_confiabilidade": percentual_alta,
+            "pode_usar_mercado": pode_usar_mercado,
+            "motivo_bloqueio": motivo_bloqueio
+        }
+    }

package/package.json

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