93 lines
3.2 KiB
Python
93 lines
3.2 KiB
Python
"""
|
|
Weather Forecast API views.
|
|
Response format: {"status": "success", "data": <payload>}. HTTP 200 only.
|
|
Fetches weather card data from the AI external adapter and persists a log entry
|
|
if a valid farm_uuid is provided.
|
|
"""
|
|
|
|
from rest_framework import serializers, status
|
|
from rest_framework.response import Response
|
|
from rest_framework.views import APIView
|
|
from drf_spectacular.types import OpenApiTypes
|
|
from drf_spectacular.utils import OpenApiParameter, extend_schema
|
|
|
|
from config.swagger import status_response
|
|
from external_api_adapter import request as external_api_request
|
|
from farm_hub.models import FarmHub
|
|
from .models import WeatherForecastLog
|
|
from .serializers import FarmWeatherCardSerializer
|
|
|
|
|
|
class FarmWeatherCardView(APIView):
|
|
"""
|
|
GET endpoint for the farm weather card dashboard data.
|
|
|
|
Purpose:
|
|
Returns current weather conditions and an intraday temperature chart
|
|
for a given farm. Data is fetched from the AI external adapter.
|
|
If farm_uuid is provided and the farm exists, the result is persisted
|
|
in WeatherForecastLog for historical reference.
|
|
|
|
Input parameters:
|
|
- farm_uuid (query, optional): UUID of the farm.
|
|
|
|
Response structure:
|
|
- status: string, always "success".
|
|
- data: object matching the farmWeatherCard shape — condition,
|
|
temperature, unit, humidity, windSpeed, windUnit, chartData.
|
|
"""
|
|
|
|
@extend_schema(
|
|
tags=["Weather Forecast"],
|
|
parameters=[
|
|
OpenApiParameter(
|
|
name="farm_uuid",
|
|
type=OpenApiTypes.UUID,
|
|
location=OpenApiParameter.QUERY,
|
|
required=False,
|
|
description="UUID of the farm to fetch weather data for.",
|
|
default="11111111-1111-1111-1111-111111111111"),
|
|
],
|
|
responses={200: status_response("FarmWeatherCardResponse", data=FarmWeatherCardSerializer())},
|
|
)
|
|
def get(self, request):
|
|
farm_uuid = request.query_params.get("farm_uuid")
|
|
query = {"farm_uuid": str(farm_uuid)} if farm_uuid else {}
|
|
|
|
adapter_response = external_api_request(
|
|
"ai",
|
|
"/weather-forecast/card",
|
|
method="GET",
|
|
query=query,
|
|
)
|
|
|
|
response_data = adapter_response.data if isinstance(adapter_response.data, dict) else {}
|
|
card_data = response_data.get("result", response_data.get("data", response_data))
|
|
|
|
self._persist_log(farm_uuid, card_data)
|
|
|
|
return Response(
|
|
{"status": "success", "data": card_data},
|
|
status=status.HTTP_200_OK,
|
|
)
|
|
|
|
@staticmethod
|
|
def _persist_log(farm_uuid, card_data):
|
|
farm = None
|
|
if farm_uuid:
|
|
try:
|
|
farm = FarmHub.objects.get(farm_uuid=farm_uuid)
|
|
except (FarmHub.DoesNotExist, Exception):
|
|
pass
|
|
|
|
WeatherForecastLog.objects.create(
|
|
farm=farm,
|
|
condition=card_data.get("condition", ""),
|
|
temperature=card_data.get("temperature"),
|
|
unit=card_data.get("unit", "°C"),
|
|
humidity=card_data.get("humidity"),
|
|
wind_speed=card_data.get("windSpeed"),
|
|
wind_unit=card_data.get("windUnit", "km/h"),
|
|
chart_data=card_data.get("chartData", {}),
|
|
)
|