{"openapi":"3.1.0","info":{"title":"DefoAlert Agri AI","description":"Plataforma Nacional de Inteligência Agrícola, Segurança Alimentar e Prevenção da Fome. Integra Sensoriamento Remoto (Copernicus Sentinel-2), Dados Climáticos (Open-Meteo), Modelos ML, National Hunger Prevention Engine, Food Availability Forecast, Regional Clusters Autônomos, Explainable AI e Public Policy Mode. Cobertura: 26 países LATAM | 25 culturas | 17 tabelas | 60+ endpoints.","version":"7.0.0","x-platform":"DefoAlert Agri"},"paths":{"/login":{"get":{"tags":["⚙ Sistema"],"summary":"GET Login Page","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"login_page_login_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"tags":["⚙ Sistema"],"summary":"POST Do Login","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"do_login_login_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_do_login_login_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/register":{"get":{"tags":["⚙ Sistema"],"summary":"GET Register Page","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"register_page_register_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"tags":["⚙ Sistema"],"summary":"POST Do Register","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"do_register_register_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/forgot-password":{"get":{"tags":["⚙ Sistema"],"summary":"GET Forgot Page","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"forgot_page_forgot_password_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"tags":["⚙ Sistema"],"summary":"POST Do Forgot","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"do_forgot_forgot_password_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_do_forgot_forgot_password_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/reset-password":{"get":{"tags":["⚙ Sistema"],"summary":"GET Reset Page","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"reset_page_reset_password_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"tags":["⚙ Sistema"],"summary":"POST Do Reset","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"do_reset_reset_password_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_do_reset_reset_password_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/change-password":{"get":{"tags":["⚙ Sistema"],"summary":"GET Change Password Page","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"change_password_page_change_password_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"post":{"tags":["⚙ Sistema"],"summary":"POST Do Change Password","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"do_change_password_change_password_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_do_change_password_change_password_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/pending-approval":{"get":{"tags":["⚙ Sistema"],"summary":"GET Pending Page","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"pending_page_pending_approval_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/visitor":{"get":{"tags":["⚙ Sistema"],"summary":"GET Visitor Login","description":"Acesso imediato como visitante DEMO — sem cadastro.","operationId":"visitor_login_visitor_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/demo":{"get":{"tags":["⚙ Sistema"],"summary":"GET Demo Login","description":"Alias de /visitor para retrocompatibilidade.","operationId":"demo_login_demo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/dashboard-demo":{"get":{"tags":["⚙ Sistema"],"summary":"GET Dashboard Demo","description":"Fallback: se /visitor falhar, ainda cria sessão DEMO e redireciona.","operationId":"dashboard_demo_dashboard_demo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/logout":{"get":{"tags":["⚙ Sistema"],"summary":"GET Get Logout","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_logout_logout_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["⚙ Sistema"],"summary":"POST Do Logout","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"do_logout_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/me":{"get":{"tags":["⚙ Sistema"],"summary":"GET Me","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"me_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/alertas":{"get":{"tags":["🚨 Central de Alertas"],"summary":"GET Listar Alertas","description":"Retorna alertas reais da análise Copernicus/NDVI.\nFiltros opcionais: nivel_risco (medio|alto|critico), agricultor_id, limite.","operationId":"listar_alertas_alertas_get","parameters":[{"name":"nivel_risco","in":"query","required":false,"schema":{"type":"string","title":"Nivel Risco"}},{"name":"agricultor_id","in":"query","required":false,"schema":{"type":"integer","title":"Agricultor Id"}},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limite"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/alertas/{alerta_id}":{"get":{"tags":["🚨 Central de Alertas"],"summary":"GET Get Alerta","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_alerta_alertas__alerta_id__get","parameters":[{"name":"alerta_id","in":"path","required":true,"schema":{"type":"integer","title":"Alerta Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["🚨 Central de Alertas"],"summary":"PUT Atualizar Alerta","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"atualizar_alerta_alertas__alerta_id__put","parameters":[{"name":"alerta_id","in":"path","required":true,"schema":{"type":"integer","title":"Alerta Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertaUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["🚨 Central de Alertas"],"summary":"DELETE Deletar Alerta","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"deletar_alerta_alertas__alerta_id__delete","parameters":[{"name":"alerta_id","in":"path","required":true,"schema":{"type":"integer","title":"Alerta Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agricultores":{"get":{"tags":["🌾 Gestão de Agricultores"],"summary":"GET Listar Agricultores","description":"Retorna todos os agricultores cadastrados com seus últimos dados NDVI.","operationId":"listar_agricultores_agricultores_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["🌾 Gestão de Agricultores"],"summary":"POST Criar Agricultor","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"criar_agricultor_agricultores_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgricultorCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"200":{"description":"Resposta JSON ou HTML válida retornada com sucesso."}}}},"/agricultores/{ag_id}":{"get":{"tags":["🌾 Gestão de Agricultores"],"summary":"GET Get Agricultor","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_agricultor_agricultores__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["🌾 Gestão de Agricultores"],"summary":"PUT Atualizar Agricultor","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"atualizar_agricultor_agricultores__ag_id__put","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgricultorUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["🌾 Gestão de Agricultores"],"summary":"DELETE Deletar Agricultor","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"deletar_agricultor_agricultores__ag_id__delete","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"tags":["⚙ Sistema"],"summary":"Health Check","description":"Endpoint de saúde — sempre retorna JSON válido.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/status":{"get":{"tags":["⚙ Sistema"],"summary":"GET Status","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"status_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/data-state":{"get":{"tags":["⚙ Sistema"],"summary":"GET Api Data State","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"api_data_state_api_data_state_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/coletar":{"post":{"tags":["⚙ Sistema"],"summary":"POST Coletar Agora","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"coletar_agora_coletar_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/diagnostico":{"get":{"tags":["⚙ Sistema"],"summary":"GET Diagnostico Copernicus","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"diagnostico_copernicus_diagnostico_get","parameters":[{"name":"lat","in":"query","required":false,"schema":{"type":"number","default":-15.7801,"title":"Lat"}},{"name":"lon","in":"query","required":false,"schema":{"type":"number","default":-47.9292,"title":"Lon"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/eventos":{"get":{"tags":["⚙ Sistema"],"summary":"GET Listar Eventos","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"listar_eventos_eventos_get","parameters":[{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":500,"title":"Limite"}},{"name":"agricultor_id","in":"query","required":false,"schema":{"type":"integer","title":"Agricultor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/alerts":{"get":{"tags":["⚙ Sistema"],"summary":"GET Unified Alerts","description":"Retorna alertas preditivos unificados de três fontes:\n\n  - preditivo: ai_predictions com probabilidade >= 0.45\n\n  - reativo:   alertas NDVI do Copernicus\n\n  - anomalia:  anomaly_events detectados estatisticamente\n\n\n\nFiltros: nivel (baixo|medio|alto|critico), agricultor_id, tipo, limite.","operationId":"unified_alerts_alerts_get","parameters":[{"name":"nivel","in":"query","required":false,"schema":{"type":"string","title":"Nivel"}},{"name":"agricultor_id","in":"query","required":false,"schema":{"type":"integer","title":"Agricultor Id"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string","title":"Tipo"}},{"name":"limite","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limite"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/dashboard":{"get":{"tags":["⚙ Sistema"],"summary":"GET Api Dashboard","description":"Endpoint JSON que agrega todos os dados necessários para o dashboard IA.\n\nUsado pelo frontend SPA (templates/index.html) como fonte única de dados.\n\nSempre retorna JSON válido — nunca Internal Server Error em texto.","operationId":"api_dashboard_api_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/train":{"post":{"tags":["⚙ Sistema"],"summary":"POST Trigger Training","description":"Dispara pipeline de treinamento ML em background thread.","operationId":"trigger_training_train_post","parameters":[{"name":"synthetic","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Synthetic"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dashboard":{"get":{"tags":["⚙ Sistema"],"summary":"GET Dashboard","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"dashboard_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/ver/agricultores":{"get":{"tags":["⚙ Sistema"],"summary":"GET Ver Agricultores","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"ver_agricultores_ver_agricultores_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/ver/alertas":{"get":{"tags":["⚙ Sistema"],"summary":"GET Ver Alertas","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"ver_alertas_ver_alertas_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/ver/agricultor/{ag_id}":{"get":{"tags":["⚙ Sistema"],"summary":"GET Ver Agricultor","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"ver_agricultor_ver_agricultor__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/crop-recommendations":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET All Crop Recommendations","description":"Retorna a melhor cultura recomendada para cada agricultor\n(último cálculo persistido), ordenada por score decrescente.","operationId":"all_crop_recommendations_crop_recommendations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/crop-recommendations/engine/status":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Engine Status","description":"Retorna informações sobre o motor SCRE e modelos disponíveis.","operationId":"engine_status_crop_recommendations_engine_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/crop-recommendations/{ag_id}":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Get Crop Recommendations","description":"Relatório completo de recomendação de culturas para um agricultor.\n\n- Se `fresh=false` (padrão): retorna resultado salvo no banco.\n- Se `fresh=true`: calcula em tempo real (pode demorar alguns segundos).","operationId":"get_crop_recommendations_crop_recommendations__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Fresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/crop-recommendations/{ag_id}/gerar":{"post":{"tags":["🧠 Farm Strategy AI"],"summary":"POST Gerar Recomendacoes","description":"Dispara o pipeline SCRE completo para um agricultor e persiste o resultado.\nUsa dados atuais de índices espectrais e clima.","operationId":"gerar_recomendacoes_crop_recommendations__ag_id__gerar_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/crop-recommendations/{ag_id}/calendar":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Get Calendar","description":"Retorna o calendário agrícola anual ajustado para a localização do agricultor.\nIndica os meses ideais para cada cultura.","operationId":"get_calendar_crop_recommendations__ag_id__calendar_get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/crop-recommendations/{ag_id}/rotation":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Get Rotation","description":"Retorna sugestões de rotação de culturas baseadas na cultura atual do agricultor.\nInclui justificativa agronômica para cada sugestão.","operationId":"get_rotation_crop_recommendations__ag_id__rotation_get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crops/engine":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Engine Info","description":"Retorna informações do motor LAIE: países, culturas e categorias.","operationId":"engine_info_api_crops_engine_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/crops/all":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET All Recommendations","description":"Melhor cultura recomendada de cada agricultor (último LAIE calculado).","operationId":"all_recommendations_api_crops_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/crops/country/{ag_id}":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Country Info","description":"Detecta e retorna informações geográficas do agricultor.","operationId":"country_info_api_crops_country__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crops/recommendations/{ag_id}":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Get Recommendations","description":"Relatório LAIE completo para um agricultor.\n\n- `fresh=false` (padrão): retorna dados salvos no banco.\n- `fresh=true`: recalcula em tempo real.","operationId":"get_recommendations_api_crops_recommendations__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Fresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crops/top/{ag_id}":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Get Top","description":"Retorna o top-N de culturas com maior ICV para o agricultor.\nInclui lucro estimado, classificação e justificativa resumida.","operationId":"get_top_api_crops_top__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"n","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crops/calendar/{ag_id}":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Get Calendar","description":"Calendário agrícola anual ajustado para a localização do agricultor.","operationId":"get_calendar_api_crops_calendar__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crops/profit/{ag_id}":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"GET Get Profit","description":"Ranking econômico — culturas ordenadas por maior lucro estimado (USD/ha).\nInclui ICV, perfil de risco e range min-max.","operationId":"get_profit_api_crops_profit__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"n","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crops/generate/{ag_id}":{"post":{"tags":["🧠 Farm Strategy AI"],"summary":"POST Generate","description":"Dispara o pipeline LAIE completo para um agricultor.\nDetecta país, calcula ICV das 25 culturas, gera estimativas econômicas.","operationId":"generate_api_crops_generate__ag_id__post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crops/generate-all":{"post":{"tags":["🧠 Farm Strategy AI"],"summary":"POST Generate All","description":"Dispara o pipeline LAIE para TODOS os agricultores cadastrados.","operationId":"generate_all_api_crops_generate_all_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/assistant/chat":{"post":{"tags":["🤖 Inteligência Artificial"],"summary":"POST Chat","description":"Envia mensagem ao assistente e retorna resposta em streaming (text/event-stream).","operationId":"chat_assistant_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather/{ag_id}":{"get":{"tags":["🌦 Inteligência Climática"],"summary":"GET Get Weather","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_weather_weather__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"history_days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"History Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather/{ag_id}/history":{"get":{"tags":["🌦 Inteligência Climática"],"summary":"GET Get History","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_history_weather__ag_id__history_get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":60,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather/{ag_id}/forecast":{"get":{"tags":["🌦 Inteligência Climática"],"summary":"GET Get Forecast","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_forecast_weather__ag_id__forecast_get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather/{ag_id}/coletar":{"post":{"tags":["🌦 Inteligência Climática"],"summary":"POST Coletar Weather","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"coletar_weather_weather__ag_id__coletar_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/indices":{"get":{"tags":["🛰 Sensoriamento Remoto"],"summary":"GET All Latest Indices","description":"Retorna último registro de cada índice para todos os agricultores.","operationId":"all_latest_indices_indices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/indices/{ag_id}":{"get":{"tags":["🛰 Sensoriamento Remoto"],"summary":"GET Get Indices","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_indices_indices__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/indices/{ag_id}/series":{"get":{"tags":["🛰 Sensoriamento Remoto"],"summary":"GET Get Series","description":"Série temporal completa de todos os índices para um agricultor.","operationId":"get_series_indices__ag_id__series_get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":40,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/indices/{ag_id}/coletar":{"post":{"tags":["🛰 Sensoriamento Remoto"],"summary":"POST Coletar Indices","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"coletar_indices_indices__ag_id__coletar_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/risk-score":{"get":{"tags":["📈 Í?ndice de Risco Agrícola"],"summary":"GET All Scores","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"all_scores_risk_score_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/risk-score/{ag_id}":{"get":{"tags":["📈 Í?ndice de Risco Agrícola"],"summary":"GET Get Score","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_score_risk_score__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"history","in":"query","required":false,"schema":{"type":"integer","default":15,"title":"History"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/risk-score/{ag_id}/calcular":{"post":{"tags":["📈 Í?ndice de Risco Agrícola"],"summary":"POST Calcular Score","description":"Força o recálculo imediato do IRAg para um agricultor.","operationId":"calcular_score_risk_score__ag_id__calcular_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/predictions":{"get":{"tags":["🤖 Inteligência Artificial"],"summary":"GET All Predictions","description":"Lista última predição de cada agricultor com alertas preditivos ativos.","operationId":"all_predictions_predictions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/predictions/{ag_id}":{"get":{"tags":["🤖 Inteligência Artificial"],"summary":"GET Get Predictions","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_predictions_predictions__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/predictions/{ag_id}/anomalias":{"get":{"tags":["🤖 Inteligência Artificial"],"summary":"GET Get Anomaly Events","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_anomaly_events_predictions__ag_id__anomalias_get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/predictions/{ag_id}/run":{"post":{"tags":["🤖 Inteligência Artificial"],"summary":"POST Run Prediction","description":"Força execução imediata dos modelos preditivos para um agricultor.","operationId":"run_prediction_predictions__ag_id__run_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/recommendations":{"get":{"tags":["🤖 Inteligência Artificial"],"summary":"GET All Recommendations","description":"Lista todas as recomendações com nome e cultura do agricultor.","operationId":"all_recommendations_recommendations_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"ativa","title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/recommendations/{ag_id}":{"get":{"tags":["🤖 Inteligência Artificial"],"summary":"GET Get Recommendations","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"get_recommendations_recommendations__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"ativa","title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/recommendations/{ag_id}/gerar":{"post":{"tags":["🤖 Inteligência Artificial"],"summary":"POST Gerar","description":"Gera e persiste novas recomendações com base nos dados atuais.","operationId":"gerar_recommendations__ag_id__gerar_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/recommendations/{rec_id}/status":{"put":{"tags":["🤖 Inteligência Artificial"],"summary":"PUT Update Status","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"update_status_recommendations__rec_id__status_put","parameters":[{"name":"rec_id","in":"path","required":true,"schema":{"type":"integer","title":"Rec Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_update_status_recommendations__rec_id__status_put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/digital-twin":{"get":{"tags":["🔮 Digital Twin Agrícola"],"summary":"GET Future Simulator Page","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"future_simulator_page_digital_twin_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/future-simulator":{"get":{"tags":["🔮 Digital Twin Agrícola"],"summary":"GET Future Simulator Page","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"future_simulator_page_future_simulator_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/api/future-simulator/{ag_id}/current":{"get":{"tags":["🔮 Digital Twin Agrícola"],"summary":"GET Current Future State","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"current_future_state_api_future_simulator__ag_id__current_get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/future-simulator/{ag_id}/simulate":{"post":{"tags":["🔮 Digital Twin Agrícola"],"summary":"POST Simulate Future","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"simulate_future_api_future_simulator__ag_id__simulate_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Scenario"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/future-simulator/{ag_id}/compare":{"post":{"tags":["🔮 Digital Twin Agrícola"],"summary":"POST Compare Future","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"compare_future_api_future_simulator__ag_id__compare_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/future-simulator/{ag_id}/ask":{"post":{"tags":["🔮 Digital Twin Agrícola"],"summary":"POST Ask Future","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"ask_future_api_future_simulator__ag_id__ask_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/copernicus-core/status":{"get":{"tags":["⚙ Sistema"],"summary":"Copernicus Core Status","description":"OAuth, token cache, fontes Sentinel e estado Open-Meteo.","operationId":"copernicus_core_status_api_copernicus_core_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/laie/status":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"LAIE Status","description":"Status e métricas do LAIE — Crop Engine.","operationId":"laie_status_api_laie_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/laie/recommendations":{"get":{"tags":["🧠 Farm Strategy AI"],"summary":"LAIE Recommendations","description":"Últimas recomendações de culturas geradas pelo LAIE.","operationId":"laie_recommendations_api_laie_recommendations_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/irag/status":{"get":{"tags":["📈 Í?ndice de Risco Agrícola"],"summary":"IRAg Status","description":"Status e métricas do IRAg Risk Engine.","operationId":"irag_status_api_irag_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/irag/score":{"get":{"tags":["📈 Í?ndice de Risco Agrícola"],"summary":"IRAg All Scores","description":"IRAg atual de todos os agricultores monitorados.","operationId":"irag_score_all_api_irag_score_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/weather-intelligence/status":{"get":{"tags":["🌦 Inteligência Climática"],"summary":"Weather Status","description":"Status e métricas do Weather Intelligence Engine.","operationId":"weather_status_api_weather_intelligence_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/weather-intelligence/forecast":{"get":{"tags":["🌦 Inteligência Climática"],"summary":"Weather Forecast","description":"Previsão meteorológica para um agricultor.","operationId":"weather_forecast_api_weather_intelligence_forecast_get","parameters":[{"name":"ag_id","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/satellite-analytics/status":{"get":{"tags":["🛰 Sensoriamento Remoto"],"summary":"Satellite Status","description":"Status e métricas do Satellite Analytics Engine.","operationId":"satellite_status_api_satellite_analytics_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/satellite-analytics/indices":{"get":{"tags":["🛰 Sensoriamento Remoto"],"summary":"Satellite Indices","description":"Últimos índices vegetativos de todos os agricultores.","operationId":"satellite_indices_api_satellite_analytics_indices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/ai-prediction/status":{"get":{"tags":["🤖 Inteligência Artificial"],"summary":"AI Prediction Status","description":"Status e métricas do AI Prediction Engine.","operationId":"ai_prediction_status_api_ai_prediction_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/ai-prediction/results":{"get":{"tags":["🤖 Inteligência Artificial"],"summary":"AI Prediction Results","description":"Predições mais recentes de todos os agricultores.","operationId":"ai_prediction_results_api_ai_prediction_results_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/hunger-prevention/status":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"Hunger Prevention Status","description":"Status e métricas do National Hunger Prevention Engine.","operationId":"hunger_status_api_hunger_prevention_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/hunger-prevention/risk":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"Hunger Risk Score","description":"Hunger Risk Score nacional completo com componentes e projeções.","operationId":"hunger_risk_api_hunger_prevention_risk_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/food-security/status":{"get":{"tags":["🍽 Segurança Alimentar"],"summary":"Food Security Status","description":"Status e métricas do Food Security Layer.","operationId":"food_security_status_api_food_security_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/food-security/dashboard":{"get":{"tags":["🍽 Segurança Alimentar"],"summary":"Food Security Dashboard","description":"Dashboard consolidado de impacto alimentar.","operationId":"food_security_dashboard_api_api_food_security_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/regional-clusters/status":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"Clusters Status","description":"Status e métricas dos Clusters Regionais Autônomos.","operationId":"clusters_status_api_regional_clusters_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/regional-clusters/list":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"Clusters List","description":"Lista de clusters regionais com métricas coletivas.","operationId":"clusters_list_api_regional_clusters_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/regional-clusters/dashboard":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"Clusters Dashboard","description":"Dashboard operacional dos clusters regionais.","operationId":"clusters_dashboard_api_regional_clusters_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public-policy/status":{"get":{"tags":["🏛 Políticas Públicas"],"summary":"Public Policy Status","description":"Status e métricas do Public Policy Mode.","operationId":"policy_status_api_public_policy_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public-policy/dashboard":{"get":{"tags":["🏛 Políticas Públicas"],"summary":"Public Policy Dashboard","description":"Visão executiva nacional para tomadores de decisão institucionais.","operationId":"policy_dashboard_api_api_public_policy_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/explainable-ai/status":{"get":{"tags":["🧩 Explainable AI"],"summary":"XAI Status","description":"Status e métricas do Explainable AI Engine.","operationId":"xai_status_api_explainable_ai_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/explainable-ai/explain":{"get":{"tags":["🧩 Explainable AI"],"summary":"XAI Explain","description":"Explica uma decisão do sistema para um agricultor.","operationId":"xai_explain_api_explainable_ai_explain_get","parameters":[{"name":"ag_id","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Ag Id"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string","default":"irag","title":"Tipo"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/digital-twin/status":{"get":{"tags":["⚙ Sistema"],"summary":"Digital Twin Status","description":"Status minimo funcional do Digital Twin agricola.","operationId":"digital_twin_status_api_digital_twin_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/farm-strategy/status":{"get":{"tags":["⚙ Sistema"],"summary":"Farm Strategy Status","description":"Status minimo funcional do Farm Strategy AI.","operationId":"farm_strategy_status_api_farm_strategy_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/economic-simulator/status":{"get":{"tags":["⚙ Sistema"],"summary":"Economic Simulator Status","description":"Status minimo funcional do Simulador Economico.","operationId":"economic_simulator_status_api_economic_simulator_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/connections/status":{"get":{"tags":["⚙ Sistema"],"summary":"Status das fontes de dados","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"status_api_connections_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/connections/copernicus/connect":{"post":{"tags":["⚙ Sistema"],"summary":"Conectar todos os Sentinel Copernicus","description":"Conecta Sentinel-1, Sentinel-2 e Sentinel-3 com uma única chamada OAuth.","operationId":"connect_all_copernicus_api_connections_copernicus_connect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/connections/copernicus/disconnect":{"post":{"tags":["⚙ Sistema"],"summary":"Desconectar todos os Sentinel Copernicus","description":"Desconecta Sentinel-1, Sentinel-2 e Sentinel-3 com uma única chamada.","operationId":"disconnect_all_copernicus_api_connections_copernicus_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/connections/copernicus/{sentinel}/connect":{"post":{"tags":["⚙ Sistema"],"summary":"Conectar Copernicus Sentinel","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"connect_copernicus_api_connections_copernicus__sentinel__connect_post","parameters":[{"name":"sentinel","in":"path","required":true,"schema":{"type":"string","title":"Sentinel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/connections/copernicus/{sentinel}/disconnect":{"post":{"tags":["⚙ Sistema"],"summary":"Desconectar Copernicus Sentinel","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"disconnect_copernicus_api_connections_copernicus__sentinel__disconnect_post","parameters":[{"name":"sentinel","in":"path","required":true,"schema":{"type":"string","title":"Sentinel"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/connections/open-meteo/connect":{"post":{"tags":["⚙ Sistema"],"summary":"Conectar Open-Meteo","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"connect_open_meteo_api_connections_open_meteo_connect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/connections/open-meteo/disconnect":{"post":{"tags":["⚙ Sistema"],"summary":"Desconectar Open-Meteo","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"disconnect_open_meteo_api_connections_open_meteo_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/intelligent/live":{"get":{"tags":["⚙ Sistema"],"summary":"GET Intelligent Live","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"intelligent_live_api_intelligent_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/intelligent/status":{"get":{"tags":["⚙ Sistema"],"summary":"GET Intelligent Status","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"intelligent_status_api_intelligent_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/home/summary":{"get":{"tags":["⚙ Sistema"],"summary":"GET Home Summary","description":"Endpoint único e resiliente para os KPIs da home.\nSempre retorna JSON válido e campos padronizados; nunca deixa cards vazios.","operationId":"home_summary_api_home_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/intelligent/engines":{"get":{"tags":["⚙ Sistema"],"summary":"GET Intelligent Engines","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"intelligent_engines_api_intelligent_engines_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/digital-twin/dashboard":{"get":{"tags":["⚙ Sistema"],"summary":"GET Digital Twin Dashboard","description":"Endpoint operacional do DefoAlert Agri com retorno estruturado e status de execução.","operationId":"digital_twin_dashboard_api_digital_twin_dashboard_get","parameters":[{"name":"ag_id","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/farm-strategy/dashboard":{"get":{"tags":["⚙ Sistema"],"summary":"GET Farm Strategy Dashboard","description":"Painel funcional do Farm Strategy AI, derivado dos dados existentes no banco.","operationId":"farm_strategy_dashboard_api_farm_strategy_dashboard_get","parameters":[{"name":"ag_id","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/economic-simulator/dashboard":{"get":{"tags":["⚙ Sistema"],"summary":"GET Economic Simulator Dashboard","description":"Painel funcional do Simulador Econômico, sem inventar valores quando faltarem dados.","operationId":"economic_simulator_dashboard_api_economic_simulator_dashboard_get","parameters":[{"name":"ag_id","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/food-security":{"get":{"tags":["🍽 Segurança Alimentar"],"summary":"GET Food Security All","description":"Food Security Score de todos os agricultores monitorados.","operationId":"food_security_all_food_security_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/food-security/national/dashboard":{"get":{"tags":["🍽 Segurança Alimentar"],"summary":"GET Food Impact Dashboard","description":"Dashboard consolidado de impacto alimentar nacional.","operationId":"food_impact_dashboard_food_security_national_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/food-security/national/forecast":{"get":{"tags":["🍽 Segurança Alimentar"],"summary":"GET Food National Forecast","description":"Projeção de disponibilidade alimentar nacional.\n\nCobre arroz, feijão, milho, soja, trigo, mandioca, sorgo.\nHorizontes: 30 / 90 / 180 / 365 dias.","operationId":"food_national_forecast_food_security_national_forecast_get","parameters":[{"name":"populacao","in":"query","required":false,"schema":{"type":"integer","default":50000,"title":"Populacao"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/food-security/forecast/{cultura}":{"get":{"tags":["🍽 Segurança Alimentar"],"summary":"GET Food Forecast Cultura","description":"Projeção de disponibilidade para uma cultura específica.\n\n- **cultura**: arroz | feijao | milho | soja | trigo | mandioca | sorgo\n- **horizonte**: 30 | 90 | 180 | 365 dias","operationId":"food_forecast_cultura_food_security_forecast__cultura__get","parameters":[{"name":"cultura","in":"path","required":true,"schema":{"type":"string","title":"Cultura"}},{"name":"horizonte","in":"query","required":false,"schema":{"type":"integer","default":90,"title":"Horizonte"}},{"name":"populacao","in":"query","required":false,"schema":{"type":"integer","default":50000,"title":"Populacao"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/food-security/map":{"get":{"tags":["🍽 Segurança Alimentar"],"summary":"GET Mapa Risco Alimentar","description":"Mapa Nacional de Risco Alimentar — dados para visualização geográfica.","operationId":"mapa_risco_alimentar_food_security_map_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/food-security/{ag_id}":{"get":{"tags":["🍽 Segurança Alimentar"],"summary":"GET Food Security Agricultor","description":"Food Security Score individual com impacto humano e yield gap.","operationId":"food_security_agricultor_food_security__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/food-security/{ag_id}/calcular":{"post":{"tags":["🍽 Segurança Alimentar"],"summary":"POST Calcular Food Security","description":"Força o recálculo imediato do Food Security Score.","operationId":"calcular_food_security_food_security__ag_id__calcular_post","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/hunger/score":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Hunger Score Nacional","description":"Hunger Risk Score consolidado para toda a base de agricultores monitorados.\n\nClassifica o risco em: Estável | Atenção | Alerta | Crítico","operationId":"hunger_score_nacional_hunger_score_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hunger/score/{regiao}":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Hunger Score Regiao","description":"Hunger Risk Score para uma região específica.\n\nExemplos de regiões: 'Norte', 'Nordeste', 'Centro-Oeste', 'Sudeste', 'Sul'","operationId":"hunger_score_regiao_hunger_score__regiao__get","parameters":[{"name":"regiao","in":"path","required":true,"schema":{"type":"string","title":"Regiao"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/hunger/early-warnings":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Hunger Early Warnings","description":"Hunger Early Warning System — detecção automática de alertas preventivos.\n\nDetecta:\n  - Quedas críticas de NDVI\n  - Estresse severo combinado (NDVI + IRAg)\n  - Seca com risco alimentar elevado","operationId":"hunger_early_warnings_hunger_early_warnings_get","parameters":[{"name":"regiao","in":"query","required":false,"schema":{"type":"string","default":"Nacional","title":"Regiao"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/hunger/prioritization":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Hunger Prioritization","description":"Priorização Inteligente de intervenções.\n\nResponde: 'Se houver recursos limitados, onde devemos agir primeiro'\n\nRanking baseado em: risco alimentar × população afetada × produção ameaçada.","operationId":"hunger_prioritization_hunger_prioritization_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hunger/simulate":{"post":{"tags":["⚠️ Prevenção da Fome"],"summary":"POST Hunger Simulate","description":"Simulador de Intervenção — testa o efeito de uma política sobre o Hunger Risk Score.\n\nBody:\n```json\n{\n  \"regiao\": \"Nordeste\",\n  \"tipo_intervencao\": \"irrigacao_emergencial\",\n  \"parametros\": {\"intensidade\": 1.0}\n}\n```\n\nTipos de intervenção:\n  - irrigacao_emergencial\n  - distribuicao_sementes\n  - assistencia_tecnica\n  - subsidios\n  - programa_alimentar","operationId":"hunger_simulate_hunger_simulate_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/hunger/food-impact":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Hunger Food Impact","description":"Food Impact Dashboard — métricas globais de impacto alimentar.\n\nExibe:\n  - Toneladas ameaçadas e protegidas\n  - Famílias protegidas\n  - Pessoas vulneráveis e protegidas\n  - Impacto econômico\n  - Culturas mais afetadas","operationId":"hunger_food_impact_hunger_food_impact_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/hunger/forecast":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Hunger Forecast","description":"Projeções do Hunger Risk Score para 30, 90 e 180 dias.","operationId":"hunger_forecast_hunger_forecast_get","parameters":[{"name":"regiao","in":"query","required":false,"schema":{"type":"string","default":"Nacional","title":"Regiao"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/clusters":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Clusters Regionais","description":"Clusters de agricultores com inteligência coletiva regional.\n\nCada cluster inclui:\n  - Métricas agregadas (IRAg médio, NDVI médio, precipitação)\n  - Alertas coletivos\n  - Impacto em cadeia produtiva\n  - Recomendação de intervenção coletiva","operationId":"clusters_regionais_clusters_get","parameters":[{"name":"tipo","in":"query","required":false,"schema":{"type":"string","description":"Tipo: regional | cultura | clima | risco","default":"regional","title":"Tipo"},"description":"Tipo: regional | cultura | clima | risco"},{"name":"granularidade","in":"query","required":false,"schema":{"type":"string","description":"Campo de agrupamento","default":"regiao","title":"Granularidade"},"description":"Campo de agrupamento"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/clusters/cultura":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Clusters Por Cultura","description":"Clusters agrupados por cultura principal dos agricultores.","operationId":"clusters_por_cultura_clusters_cultura_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/clusters/clima":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Clusters Por Clima","description":"Clusters agrupados por zona climática.","operationId":"clusters_por_clima_clusters_clima_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/clusters/risco":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Clusters Por Risco","description":"Clusters agrupados por nível de risco (Baixo | Médio | Alto | Crítico).\n\nÚtil para identificar regiões que precisam de intervenção urgente.","operationId":"clusters_por_risco_clusters_risco_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/clusters/map":{"get":{"tags":["⚠️ Prevenção da Fome"],"summary":"GET Clusters Mapa","description":"Mapa Nacional de Risco Alimentar por região.\n\nRetorna dados para visualização geográfica:\n  - Coordenadas centroides\n  - IRAg médio por região\n  - Coloração por nível de risco (verde/amarelo/laranja/vermelho)\n  - Cultura dominante\n  - Número de agricultores por região","operationId":"clusters_mapa_clusters_map_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/policy/overview":{"get":{"tags":["🏛 Políticas Públicas"],"summary":"GET Policy Overview","description":"Visão Executiva Nacional — painel para tomadores de decisão institucionais.\n\nConsolida:\n  - Hunger Risk Score nacional\n  - Food Impact Dashboard\n  - Regiões críticas\n  - Priorização de intervenção\n  - Forecast alimentar","operationId":"policy_overview_policy_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/policy/regions":{"get":{"tags":["🏛 Políticas Públicas"],"summary":"GET Policy Regions","description":"Análise regional detalhada — dados para planejamento territorial.\n\nRetorna métricas agrícolas, alimentares e de risco por região.","operationId":"policy_regions_policy_regions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/policy/simulate":{"post":{"tags":["🏛 Políticas Públicas"],"summary":"POST Policy Simulate","description":"Simulação de Política Pública — avalia o impacto de uma política sobre a segurança alimentar.\n\nBody:\n```json\n{\n  \"nome_politica\": \"Programa de Irrigação Emergencial Nordeste\",\n  \"tipo\": \"irrigacao_emergencial\",\n  \"regiao\": \"Nordeste — BA/PI\",\n  \"orcamento_usd\": 5000000,\n  \"intensidade\": 0.8,\n  \"timeline_meses\": 6\n}\n```\n\nTipos disponíveis:\n  - irrigacao_emergencial     (maior impacto produtivo)\n  - distribuicao_sementes     (menor custo por beneficiário)\n  - assistencia_tecnica       (melhor custo-benefício a longo prazo)\n  - subsidios                 (impacto financeiro direto)\n  - programa_alimentar        (redução imediata de insegurança)","operationId":"policy_simulate_policy_simulate_post","requestBody":{"content":{"application/json":{"schema":{"type":"object","title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/policy/investment-ranking":{"get":{"tags":["🏛 Políticas Públicas"],"summary":"GET Policy Investment Ranking","description":"Ranking de Investimento por ROI Social.\n\nSimula as 5 modalidades de intervenção e ranqueia por:\n  - ROI social (pessoas protegidas por USD investido)\n  - Redução do Hunger Risk Score\n  - Custo por beneficiário","operationId":"policy_investment_ranking_policy_investment_ranking_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/policy/food-plan":{"get":{"tags":["🏛 Políticas Públicas"],"summary":"GET Policy Food Plan","description":"Planejamento Alimentar de Curto Prazo.\n\nProjeta disponibilidade das principais culturas alimentares\ne identifica culturas em deficit para intervenção prioritária.","operationId":"policy_food_plan_policy_food_plan_get","parameters":[{"name":"horizonte_dias","in":"query","required":false,"schema":{"type":"integer","default":90,"title":"Horizonte Dias"}},{"name":"populacao","in":"query","required":false,"schema":{"type":"integer","default":50000,"title":"Populacao"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/policy/crop-planning":{"get":{"tags":["🏛 Políticas Públicas"],"summary":"GET Policy Crop Planning","description":"Planejamento Agrícola Estratégico.\n\nAnalisa a distribuição atual de culturas e recomenda\ndiversificação para aumentar a resiliência alimentar regional.","operationId":"policy_crop_planning_policy_crop_planning_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/explain/irag/{ag_id}":{"get":{"tags":["🧩 Explainable AI"],"summary":"GET Explain Irag Endpoint","description":"Explica o cálculo do IRAg (Í?ndice de Risco Agrícola).\n\nMostra:\n  - 5 componentes com pesos e contribuições individuais\n  - Valores das variáveis utilizadas\n  - Fator dominante de risco\n  - Fatores positivos e negativos\n  - Narrativa em linguagem natural","operationId":"explain_irag_endpoint_explain_irag__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/explain/prediction/{ag_id}":{"get":{"tags":["🧩 Explainable AI"],"summary":"GET Explain Prediction Endpoint","description":"Explica uma predição de modelo de IA.\n\nMostra:\n  - Probabilidade e valor estimado\n  - Variáveis mais importantes para a predição\n  - Peso de cada feature\n  - Metodologia utilizada\n  - Interpretação em linguagem natural","operationId":"explain_prediction_endpoint_explain_prediction__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}},{"name":"modelo","in":"query","required":false,"schema":{"type":"string","description":"estresse_hidrico | perda_produtividade","default":"estresse_hidrico","title":"Modelo"},"description":"estresse_hidrico | perda_produtividade"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/explain/food-risk/{ag_id}":{"get":{"tags":["🧩 Explainable AI"],"summary":"GET Explain Food Risk Endpoint","description":"Explica o Food Security Score (Risco Alimentar) de um agricultor.\n\nMostra:\n  - Componentes do score (IRAg, suficiência produtiva, yield gap)\n  - Impacto humano estimado (pessoas afetadas)\n  - Toneladas ameaçadas e protegidas\n  - Narrativa explicativa","operationId":"explain_food_risk_endpoint_explain_food_risk__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/explain/hunger/{regiao}":{"get":{"tags":["🧩 Explainable AI"],"summary":"GET Explain Hunger Endpoint","description":"Explica o Hunger Risk Score de uma região.\n\nMostra:\n  - 5 componentes do Hunger Risk Score com pesos\n  - Fórmula de cálculo\n  - Impacto humano regional\n  - Narrativa institucional","operationId":"explain_hunger_endpoint_explain_hunger__regiao__get","parameters":[{"name":"regiao","in":"path","required":true,"schema":{"type":"string","title":"Regiao"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/explain/hunger":{"get":{"tags":["🧩 Explainable AI"],"summary":"GET Explain Hunger Nacional","description":"Explica o Hunger Risk Score nacional.","operationId":"explain_hunger_nacional_explain_hunger_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/explain/recommendation/{rec_id}":{"get":{"tags":["🧩 Explainable AI"],"summary":"GET Explain Recommendation Endpoint","description":"Explica por que uma recomendação foi gerada.\n\nMostra:\n  - Motivo da recomendação\n  - Urgência e impacto esperado\n  - Como foi gerada (regras + ML)\n  - Grau de confiança","operationId":"explain_recommendation_endpoint_explain_recommendation__rec_id__get","parameters":[{"name":"rec_id","in":"path","required":true,"schema":{"type":"integer","title":"Rec Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/explain/strategy/{ag_id}":{"get":{"tags":["🧩 Explainable AI"],"summary":"GET Explain Strategy Endpoint","description":"Explica a estratégia agrícola recomendada pelo Farm Strategy AI.\n\nMostra:\n  - Critérios de avaliação de culturas\n  - Dados de contexto climático e agronômico\n  - Top culturas recomendadas\n  - Pesos usados no ranqueamento","operationId":"explain_strategy_endpoint_explain_strategy__ag_id__get","parameters":[{"name":"ag_id","in":"path","required":true,"schema":{"type":"integer","title":"Ag Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/explain/alert/{alert_id}":{"get":{"tags":["🧩 Explainable AI"],"summary":"GET Explain Alert Endpoint","description":"Explica um alerta gerado pelo sistema.\n\nMostra:\n  - Causa raiz do alerta\n  - Dados que motivaram o disparo\n  - Recomendação de ação\n  - Nível de urgência e confiança","operationId":"explain_alert_endpoint_explain_alert__alert_id__get","parameters":[{"name":"alert_id","in":"path","required":true,"schema":{"type":"integer","title":"Alert Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Home","operationId":"home__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"AgricultorCreate":{"properties":{"nome":{"type":"string","title":"Nome"},"whatsapp":{"type":"string","title":"Whatsapp"},"lat":{"type":"number","title":"Lat"},"lon":{"type":"number","title":"Lon"},"cultura":{"type":"string","title":"Cultura"},"cooperativa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cooperativa"}},"type":"object","required":["nome","whatsapp","lat","lon","cultura"],"title":"AgricultorCreate"},"AgricultorUpdate":{"properties":{"nome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nome"},"whatsapp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Whatsapp"},"lat":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lat"},"lon":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Lon"},"cultura":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cultura"},"cooperativa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cooperativa"}},"type":"object","title":"AgricultorUpdate"},"AlertaUpdate":{"properties":{"status_envio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Envio"},"descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Descricao"}},"type":"object","title":"AlertaUpdate"},"Body_do_change_password_change_password_post":{"properties":{"password":{"type":"string","title":"Password"},"password2":{"type":"string","title":"Password2"}},"type":"object","required":["password","password2"],"title":"Body_do_change_password_change_password_post"},"Body_do_forgot_forgot_password_post":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"Body_do_forgot_forgot_password_post"},"Body_do_login_login_post":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"},"remember":{"type":"string","title":"Remember","default":""}},"type":"object","required":["email","password"],"title":"Body_do_login_login_post"},"Body_do_reset_reset_password_post":{"properties":{"token":{"type":"string","title":"Token"},"password":{"type":"string","title":"Password"},"password2":{"type":"string","title":"Password2"}},"type":"object","required":["token","password","password2"],"title":"Body_do_reset_reset_password_post"},"Body_update_status_recommendations__rec_id__status_put":{"properties":{"novo_status":{"type":"string","title":"Novo Status"}},"type":"object","required":["novo_status"],"title":"Body_update_status_recommendations__rec_id__status_put"},"ChatRequest":{"properties":{"mensagem":{"type":"string","title":"Mensagem"},"agricultor_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Agricultor Id"},"historico":{"items":{"type":"object"},"type":"array","title":"Historico","default":[]}},"type":"object","required":["mensagem"],"title":"ChatRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"🌾 Gestão de Agricultores","description":"Cadastro, consulta e manutenção de produtores rurais monitorados."},{"name":"🚨 Central de Alertas","description":"Alertas agrícolas, eventos críticos e acompanhamento operacional."},{"name":"🌦 Inteligência Climática","description":"Histórico, previsão e sínteses meteorológicas por propriedade."},{"name":"🛰 Sensoriamento Remoto","description":"Índices espectrais e monitoramento satelital NDVI, EVI, SAVI e NDWI."},{"name":"🤖 Inteligência Artificial","description":"Predições, recomendações, chat agrícola e motores preditivos."},{"name":"📈 Í?ndice de Risco Agrícola","description":"IRAg, histórico de risco e recálculo explicável por agricultor."},{"name":"🔮 Digital Twin Agrícola","description":"Simulação de cenários futuros e comparação de estratégias de manejo."},{"name":"🧠 Farm Strategy AI","description":"Recomendação estratégica de culturas, rotação e calendário agrícola."},{"name":"💰 Simulador Econômico","description":"Projeções econômicas, ROI de intervenções e impacto produtivo."},{"name":"🍽 Segurança Alimentar","description":"Food Security Layer, disponibilidade alimentar e impacto humano."},{"name":"⚠️ Prevenção da Fome","description":"Hunger Risk Score, alertas preventivos e priorização de intervenções."},{"name":"🏛 Políticas Públicas","description":"Visões institucionais, planejamento territorial e simulação de políticas."},{"name":"🧩 Explainable AI","description":"Explicações transparentes para riscos, predições, alertas e recomendações."},{"name":"⚙ Sistema","description":"Saúde da plataforma, dashboards, diagnóstico, documentação e operações."}]}