UPDATE

weather_forecast/apps.py

@@ -0,0 +1,7 @@
+from django.apps import AppConfig
+
+
+class WeatherForecastConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "weather_forecast"
+    verbose_name = "Weather Forecast"

weather_forecast/migrations/0001_initial.py

@@ -0,0 +1,43 @@
+import django.db.models.deletion
+import uuid
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+        ("farm_hub", "0007_farmhub_subscription_plan"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="WeatherForecastLog",
+            fields=[
+                ("id", models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name="ID")),
+                ("uuid", models.UUIDField(db_index=True, default=uuid.uuid4, editable=False, unique=True)),
+                ("condition", models.CharField(blank=True, default="", max_length=128)),
+                ("temperature", models.FloatField(blank=True, null=True)),
+                ("unit", models.CharField(blank=True, default="°C", max_length=16)),
+                ("humidity", models.IntegerField(blank=True, null=True)),
+                ("wind_speed", models.FloatField(blank=True, null=True)),
+                ("wind_unit", models.CharField(blank=True, default="km/h", max_length=16)),
+                ("chart_data", models.JSONField(blank=True, default=dict)),
+                ("fetched_at", models.DateTimeField(auto_now_add=True)),
+                (
+                    "farm",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="weather_forecasts",
+                        to="farm_hub.farmhub",
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "weather_forecast_logs",
+                "ordering": ["-fetched_at"],
+            },
+        ),
+    ]

weather_forecast/mock_data.py

@@ -0,0 +1,17 @@
+"""
+Static mock data for Weather Forecast API.
+Mirrors the farmWeatherCard dashboard card shape.
+"""
+
+FARM_WEATHER_CARD = {
+    "condition": "صاف",
+    "temperature": 24,
+    "unit": "°C",
+    "humidity": 45,
+    "windSpeed": 12,
+    "windUnit": "km/h",
+    "chartData": {
+        "labels": ["۶ صبح", "۹ صبح", "۱۲ ظهر", "۳ بعدازظهر", "۶ عصر", "۹ شب", "۱۲ شب"],
+        "series": [[18, 22, 26, 28, 25, 20, 18]],
+    },
+}

weather_forecast/models.py

@@ -0,0 +1,32 @@
+import uuid as uuid_lib
+
+from django.db import models
+
+from farm_hub.models import FarmHub
+
+
+class WeatherForecastLog(models.Model):
+    uuid = models.UUIDField(default=uuid_lib.uuid4, unique=True, editable=False, db_index=True)
+    farm = models.ForeignKey(
+        FarmHub,
+        on_delete=models.CASCADE,
+        related_name="weather_forecasts",
+        null=True,
+        blank=True,
+    )
+    condition = models.CharField(max_length=128, blank=True, default="")
+    temperature = models.FloatField(null=True, blank=True)
+    unit = models.CharField(max_length=16, blank=True, default="°C")
+    humidity = models.IntegerField(null=True, blank=True)
+    wind_speed = models.FloatField(null=True, blank=True)
+    wind_unit = models.CharField(max_length=16, blank=True, default="km/h")
+    chart_data = models.JSONField(default=dict, blank=True)
+    fetched_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        db_table = "weather_forecast_logs"
+        ordering = ["-fetched_at"]
+
+    def __str__(self):
+        farm_label = str(self.farm_id) if self.farm_id else "no-farm"
+        return f"{farm_label} — {self.condition} {self.temperature}{self.unit}"

weather_forecast/serializers.py

@@ -0,0 +1,19 @@
+from rest_framework import serializers
+
+
+class WeatherChartDataSerializer(serializers.Serializer):
+    labels = serializers.ListField(child=serializers.CharField(), required=False)
+    series = serializers.ListField(
+        child=serializers.ListField(child=serializers.FloatField()),
+        required=False,
+    )
+
+
+class FarmWeatherCardSerializer(serializers.Serializer):
+    condition = serializers.CharField(required=False, allow_blank=True)
+    temperature = serializers.FloatField(required=False)
+    unit = serializers.CharField(required=False, allow_blank=True)
+    humidity = serializers.IntegerField(required=False)
+    windSpeed = serializers.FloatField(required=False)
+    windUnit = serializers.CharField(required=False, allow_blank=True)
+    chartData = WeatherChartDataSerializer(required=False)

weather_forecast/urls.py

@@ -0,0 +1,7 @@
+from django.urls import path
+
+from .views import FarmWeatherCardView
+
+urlpatterns = [
+    path("card/", FarmWeatherCardView.as_view(), name="weather-forecast-card"),
+]

weather_forecast/views.py

@@ -0,0 +1,92 @@
+"""
+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", {}),
+        )