UPDATE
This commit is contained in:
@@ -0,0 +1,44 @@
|
||||
from rest_framework import serializers
|
||||
|
||||
|
||||
class FertilizationFarmDataSerializer(serializers.Serializer):
|
||||
soilType = serializers.CharField(required=False, allow_blank=True)
|
||||
organicMatter = serializers.CharField(required=False, allow_blank=True)
|
||||
waterEC = serializers.CharField(required=False, allow_blank=True)
|
||||
|
||||
|
||||
class FertilizationRecommendRequestSerializer(serializers.Serializer):
|
||||
crop_id = serializers.CharField(required=False, allow_blank=True)
|
||||
growth_stage = serializers.CharField(required=False, allow_blank=True)
|
||||
farm_data = FertilizationFarmDataSerializer(required=False)
|
||||
soilType = serializers.CharField(required=False, allow_blank=True)
|
||||
organicMatter = serializers.CharField(required=False, allow_blank=True)
|
||||
waterEC = serializers.CharField(required=False, allow_blank=True)
|
||||
|
||||
|
||||
class FertilizationPlanSerializer(serializers.Serializer):
|
||||
npkRatio = serializers.CharField(required=False, allow_blank=True)
|
||||
amountPerHectare = serializers.CharField(required=False, allow_blank=True)
|
||||
applicationMethod = serializers.CharField(required=False, allow_blank=True)
|
||||
applicationInterval = serializers.CharField(required=False, allow_blank=True)
|
||||
reasoning = serializers.CharField(required=False, allow_blank=True)
|
||||
|
||||
|
||||
class FertilizationRecommendResponseDataSerializer(serializers.Serializer):
|
||||
plan = FertilizationPlanSerializer(required=False)
|
||||
|
||||
|
||||
class FertilizationTaskSubmitDataSerializer(serializers.Serializer):
|
||||
task_id = serializers.CharField(required=False, allow_blank=True)
|
||||
status = serializers.CharField(required=False, allow_blank=True)
|
||||
|
||||
|
||||
class FertilizationTaskProgressSerializer(serializers.Serializer):
|
||||
message = serializers.CharField(required=False, allow_blank=True)
|
||||
|
||||
|
||||
class FertilizationTaskStatusDataSerializer(serializers.Serializer):
|
||||
task_id = serializers.CharField(required=False, allow_blank=True)
|
||||
status = serializers.CharField(required=False, allow_blank=True)
|
||||
progress = FertilizationTaskProgressSerializer(required=False)
|
||||
result = FertilizationRecommendResponseDataSerializer(required=False)
|
||||
@@ -1,8 +1,10 @@
|
||||
from django.urls import path
|
||||
|
||||
from .views import ConfigView, RecommendView
|
||||
from .views import ConfigView, RecommendTaskStatusView, RecommendView
|
||||
|
||||
urlpatterns = [
|
||||
path("config/", ConfigView.as_view(), name="fertilization-recommendation-config"),
|
||||
path("recommend/", RecommendView.as_view(), name="fertilization-recommendation-recommend"),
|
||||
# path("recommend/task/", RecommendTaskCreateView.as_view(), name="fertilization-recommendation-task-create"),
|
||||
path("recommend/<str:task_id>/status/", RecommendTaskStatusView.as_view(), name="fertilization-recommendation-task-status"),
|
||||
]
|
||||
|
||||
@@ -1,78 +1,38 @@
|
||||
"""
|
||||
Fertilization Recommendation API views.
|
||||
No database. All responses are static mock data.
|
||||
Response format: {"status": "success", "data": <payload>}. HTTP 200 only.
|
||||
No processing, validation, or use of input parameters in responses.
|
||||
"""
|
||||
|
||||
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 extend_schema
|
||||
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 .mock_data import CONFIG_RESPONSE_DATA
|
||||
from .serializers import (
|
||||
FertilizationRecommendRequestSerializer,
|
||||
FertilizationRecommendResponseDataSerializer,
|
||||
FertilizationTaskStatusDataSerializer,
|
||||
FertilizationTaskSubmitDataSerializer,
|
||||
)
|
||||
|
||||
|
||||
class ConfigView(APIView):
|
||||
"""
|
||||
GET endpoint for fertilization config (farm data, growth stages, crop options).
|
||||
|
||||
Purpose:
|
||||
Returns static farm data (soilType, organicMatter, waterEC), growth
|
||||
stages list, and crop options for the fertilization recommendation form.
|
||||
Used when loading the fertilization recommendation page.
|
||||
|
||||
Input parameters:
|
||||
None. Query parameters, if sent, are not read or used.
|
||||
|
||||
Response structure:
|
||||
- status: string, always "success".
|
||||
- data: object with keys farmData (object), growthStages (array of
|
||||
{ id, icon }), cropOptions (array of { id, labelKey, icon }).
|
||||
|
||||
No processing or validation is performed on inputs.
|
||||
"""
|
||||
|
||||
@extend_schema(
|
||||
tags=["Fertilization Recommendation"],
|
||||
responses={200: status_response("FertilizationConfigResponse", data=serializers.JSONField())},
|
||||
)
|
||||
def get(self, request):
|
||||
return Response(
|
||||
{"status": "success", "data": CONFIG_RESPONSE_DATA},
|
||||
status=status.HTTP_200_OK,
|
||||
)
|
||||
return Response({"status": "success", "data": CONFIG_RESPONSE_DATA}, status=status.HTTP_200_OK)
|
||||
|
||||
|
||||
class RecommendView(APIView):
|
||||
"""
|
||||
POST endpoint for fertilization recommendation.
|
||||
|
||||
Purpose:
|
||||
Returns a static fertilization plan (npkRatio, amountPerHectare,
|
||||
applicationMethod, applicationInterval, reasoning). Body may contain
|
||||
crop_id, growth_stage, farm_data; not read or used in response.
|
||||
|
||||
Input parameters:
|
||||
- body (optional): JSON. May contain "crop_id", "growth_stage",
|
||||
"soilType", "organicMatter", "waterEC". Data type: object.
|
||||
Location: body. Not read or validated; not used in response.
|
||||
|
||||
Response structure:
|
||||
- status: string, always "success".
|
||||
- data: object with key "plan" (object with npkRatio, amountPerHectare,
|
||||
applicationMethod, applicationInterval, reasoning).
|
||||
|
||||
No processing or validation is performed on inputs.
|
||||
"""
|
||||
|
||||
@extend_schema(
|
||||
tags=["Fertilization Recommendation"],
|
||||
request=OpenApiTypes.OBJECT,
|
||||
responses={200: status_response("FertilizationRecommendResponse", data=serializers.JSONField())},
|
||||
request=FertilizationRecommendRequestSerializer,
|
||||
responses={200: status_response("FertilizationRecommendResponse", data=FertilizationRecommendResponseDataSerializer())},
|
||||
)
|
||||
def post(self, request):
|
||||
adapter_response = external_api_request(
|
||||
@@ -82,3 +42,22 @@ class RecommendView(APIView):
|
||||
payload=request.data,
|
||||
)
|
||||
return Response(adapter_response.data, status=adapter_response.status_code)
|
||||
|
||||
|
||||
|
||||
|
||||
class RecommendTaskStatusView(APIView):
|
||||
@extend_schema(
|
||||
tags=["Fertilization Recommendation"],
|
||||
parameters=[
|
||||
OpenApiParameter(name="task_id", type=OpenApiTypes.STR, location=OpenApiParameter.PATH),
|
||||
],
|
||||
responses={200: status_response("FertilizationRecommendTaskStatusResponse", data=FertilizationTaskStatusDataSerializer())},
|
||||
)
|
||||
def get(self, request, task_id):
|
||||
adapter_response = external_api_request(
|
||||
"ai",
|
||||
f"/fertilization/status/{task_id}",
|
||||
method="GET",
|
||||
)
|
||||
return Response(adapter_response.data, status=adapter_response.status_code)
|
||||
|
||||
Reference in New Issue
Block a user