first commit

plant/views.py

@@ -0,0 +1,234 @@
+from drf_spectacular.utils import (
+    OpenApiExample,
+    OpenApiResponse,
+    extend_schema,
+    inline_serializer,
+)
+from rest_framework import serializers as drf_serializers
+from rest_framework import status
+from rest_framework.response import Response
+from rest_framework.views import APIView
+
+from .models import Plant
+from .serializers import PlantSerializer
+from .services import fetch_plant_info_from_api
+
+
+class PlantListCreateView(APIView):
+    """لیست تمام گیاهان و ایجاد گیاه جدید."""
+
+    @extend_schema(
+        tags=["Plant"],
+        summary="لیست گیاهان",
+        description="لیست تمام گیاهان ذخیره‌شده را برمی‌گرداند.",
+        responses={200: PlantSerializer(many=True)},
+    )
+    def get(self, request):
+        plants = Plant.objects.all()
+        serializer = PlantSerializer(plants, many=True)
+        return Response(
+            {"code": 200, "msg": "success", "data": serializer.data},
+            status=status.HTTP_200_OK,
+        )
+
+    @extend_schema(
+        tags=["Plant"],
+        summary="ایجاد گیاه جدید",
+        description="یک گیاه جدید با مشخصات داده‌شده ایجاد می‌کند.",
+        request=PlantSerializer,
+        responses={
+            201: PlantSerializer,
+            400: OpenApiResponse(description="داده نامعتبر"),
+        },
+        examples=[
+            OpenApiExample(
+                "نمونه درخواست",
+                value={
+                    "name": "گوجه‌فرنگی",
+                    "light": "آفتاب کامل",
+                    "watering": "منظم، هفته‌ای ۲-۳ بار",
+                    "soil": "لومی، غنی از مواد آلی",
+                    "temperature": "۲۰-۳۰ درجه سانتی‌گراد",
+                    "planting_season": "بهار",
+                    "harvest_time": "۷۰-۹۰ روز پس از کاشت",
+                    "spacing": "۴۵-۶۰ سانتی‌متر",
+                    "fertilizer": "کود NPK متعادل",
+                },
+                request_only=True,
+            ),
+        ],
+    )
+    def post(self, request):
+        serializer = PlantSerializer(data=request.data)
+        if not serializer.is_valid():
+            return Response(
+                {"code": 400, "msg": "داده نامعتبر.", "data": serializer.errors},
+                status=status.HTTP_400_BAD_REQUEST,
+            )
+        serializer.save()
+        return Response(
+            {"code": 201, "msg": "success", "data": serializer.data},
+            status=status.HTTP_201_CREATED,
+        )
+
+
+class PlantDetailView(APIView):
+    """دریافت، ویرایش و حذف یک گیاه."""
+
+    def _get_plant(self, pk):
+        return Plant.objects.filter(pk=pk).first()
+
+    @extend_schema(
+        tags=["Plant"],
+        summary="جزئیات گیاه",
+        description="مشخصات یک گیاه را بر اساس شناسه برمی‌گرداند.",
+        responses={
+            200: PlantSerializer,
+            404: OpenApiResponse(description="گیاه یافت نشد"),
+        },
+    )
+    def get(self, request, pk):
+        plant = self._get_plant(pk)
+        if not plant:
+            return Response(
+                {"code": 404, "msg": "گیاه یافت نشد.", "data": None},
+                status=status.HTTP_404_NOT_FOUND,
+            )
+        serializer = PlantSerializer(plant)
+        return Response(
+            {"code": 200, "msg": "success", "data": serializer.data},
+            status=status.HTTP_200_OK,
+        )
+
+    @extend_schema(
+        tags=["Plant"],
+        summary="ویرایش کامل گیاه",
+        description="تمام فیلدهای یک گیاه را آپدیت می‌کند.",
+        request=PlantSerializer,
+        responses={
+            200: PlantSerializer,
+            400: OpenApiResponse(description="داده نامعتبر"),
+            404: OpenApiResponse(description="گیاه یافت نشد"),
+        },
+    )
+    def put(self, request, pk):
+        plant = self._get_plant(pk)
+        if not plant:
+            return Response(
+                {"code": 404, "msg": "گیاه یافت نشد.", "data": None},
+                status=status.HTTP_404_NOT_FOUND,
+            )
+        serializer = PlantSerializer(plant, data=request.data)
+        if not serializer.is_valid():
+            return Response(
+                {"code": 400, "msg": "داده نامعتبر.", "data": serializer.errors},
+                status=status.HTTP_400_BAD_REQUEST,
+            )
+        serializer.save()
+        return Response(
+            {"code": 200, "msg": "success", "data": serializer.data},
+            status=status.HTTP_200_OK,
+        )
+
+    @extend_schema(
+        tags=["Plant"],
+        summary="ویرایش جزئی گیاه",
+        description="فقط فیلدهای ارسال‌شده آپدیت می‌شوند.",
+        request=PlantSerializer,
+        responses={
+            200: PlantSerializer,
+            400: OpenApiResponse(description="داده نامعتبر"),
+            404: OpenApiResponse(description="گیاه یافت نشد"),
+        },
+    )
+    def patch(self, request, pk):
+        plant = self._get_plant(pk)
+        if not plant:
+            return Response(
+                {"code": 404, "msg": "گیاه یافت نشد.", "data": None},
+                status=status.HTTP_404_NOT_FOUND,
+            )
+        serializer = PlantSerializer(plant, data=request.data, partial=True)
+        if not serializer.is_valid():
+            return Response(
+                {"code": 400, "msg": "داده نامعتبر.", "data": serializer.errors},
+                status=status.HTTP_400_BAD_REQUEST,
+            )
+        serializer.save()
+        return Response(
+            {"code": 200, "msg": "success", "data": serializer.data},
+            status=status.HTTP_200_OK,
+        )
+
+    @extend_schema(
+        tags=["Plant"],
+        summary="حذف گیاه",
+        description="یک گیاه را حذف می‌کند.",
+        responses={
+            200: OpenApiResponse(description="حذف موفق"),
+            404: OpenApiResponse(description="گیاه یافت نشد"),
+        },
+    )
+    def delete(self, request, pk):
+        plant = self._get_plant(pk)
+        if not plant:
+            return Response(
+                {"code": 404, "msg": "گیاه یافت نشد.", "data": None},
+                status=status.HTTP_404_NOT_FOUND,
+            )
+        plant.delete()
+        return Response(
+            {"code": 200, "msg": "گیاه با موفقیت حذف شد.", "data": None},
+            status=status.HTTP_200_OK,
+        )
+
+
+class PlantFetchInfoView(APIView):
+    """دریافت مشخصات گیاه از API خارجی بر اساس نام."""
+
+    @extend_schema(
+        tags=["Plant"],
+        summary="دریافت مشخصات گیاه از API خارجی",
+        description="بر اساس نام گیاه، مشخصات آن را از API خارجی دریافت می‌کند. (فعلاً خالی)",
+        request=inline_serializer(
+            name="PlantFetchInfoRequest",
+            fields={
+                "name": drf_serializers.CharField(help_text="نام گیاه"),
+            },
+        ),
+        responses={
+            200: PlantSerializer,
+            400: OpenApiResponse(description="نام گیاه ارسال نشده"),
+            503: OpenApiResponse(description="سرویس در دسترس نیست"),
+        },
+        examples=[
+            OpenApiExample(
+                "نمونه درخواست",
+                value={"name": "گوجه‌فرنگی"},
+                request_only=True,
+            ),
+        ],
+    )
+    def post(self, request):
+        plant_name = request.data.get("name")
+        if not plant_name:
+            return Response(
+                {"code": 400, "msg": "نام گیاه الزامی است.", "data": None},
+                status=status.HTTP_400_BAD_REQUEST,
+            )
+
+        result = fetch_plant_info_from_api(plant_name)
+        if result is None:
+            return Response(
+                {
+                    "code": 503,
+                    "msg": "سرویس API هنوز پیاده‌سازی نشده است.",
+                    "data": None,
+                },
+                status=status.HTTP_503_SERVICE_UNAVAILABLE,
+            )
+
+        return Response(
+            {"code": 200, "msg": "success", "data": result},
+            status=status.HTTP_200_OK,
+        )