235 lines
8.4 KiB
Python
235 lines
8.4 KiB
Python
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,
|
|
)
|