Files
Ai/fertilization/views.py
T

235 lines
10 KiB
Python
Raw Normal View History

2026-04-30 03:25:31 +03:30
from django.apps import apps
2026-04-28 04:11:49 +03:30
from drf_spectacular.utils import OpenApiExample, extend_schema
2026-03-21 23:50:36 +03:30
from rest_framework import status
from rest_framework.response import Response
from rest_framework.views import APIView
2026-04-28 04:11:49 +03:30
from config.openapi import build_envelope_serializer, build_response
2026-03-25 01:56:41 +03:30
2026-04-28 04:11:49 +03:30
from .serializers import (
2026-04-30 03:25:31 +03:30
FertilizationPlanParserRequestSerializer,
FertilizationPlanParserResponseSerializer,
2026-04-28 04:11:49 +03:30
FertilizationRecommendationResponseDataSerializer,
FertilizationRecommendRequestSerializer,
)
2026-03-21 23:50:36 +03:30
2026-03-25 01:56:41 +03:30
FertilizationValidationErrorSerializer = build_envelope_serializer(
"FertilizationValidationErrorSerializer",
data_required=False,
allow_null=True,
)
2026-04-24 02:50:27 +03:30
FertilizationResponseSerializer = build_envelope_serializer(
"FertilizationResponseSerializer",
2026-04-28 04:11:49 +03:30
data_schema=FertilizationRecommendationResponseDataSerializer,
2026-03-25 01:56:41 +03:30
)
2026-04-30 03:25:31 +03:30
FertilizationPlanParserEnvelopeSerializer = build_envelope_serializer(
"FertilizationPlanParserEnvelopeSerializer",
data_schema=FertilizationPlanParserResponseSerializer,
)
2026-03-25 01:56:41 +03:30
2026-03-21 23:50:36 +03:30
class FertilizationRecommendView(APIView):
"""
2026-04-28 04:11:49 +03:30
توصیه کودهی ساختاریافته با ترکیب RAG و optimizer شبیه سازی.
2026-03-21 23:50:36 +03:30
"""
@extend_schema(
tags=["Fertilization Recommendation"],
2026-04-28 04:11:49 +03:30
summary="درخواست توصیه کودهی ساختاریافته",
2026-03-21 23:50:36 +03:30
description=(
2026-04-28 04:11:49 +03:30
"داده های مزرعه، گیاه و مرحله رشد را دریافت می کند و "
"خروجی نهایی بهینه شده با ترکیب RAG و optimizer مبتنی بر crop_simulation/PCSE را برمی گرداند."
2026-03-21 23:50:36 +03:30
),
request=FertilizationRecommendRequestSerializer,
responses={
2026-04-24 02:50:27 +03:30
200: build_response(
FertilizationResponseSerializer,
2026-04-28 04:11:49 +03:30
"توصیه کودهی ساختاریافته با موفقیت تولید شد.",
2026-03-25 01:56:41 +03:30
),
400: build_response(
FertilizationValidationErrorSerializer,
"پارامتر ورودی نامعتبر است.",
),
2026-04-24 02:50:27 +03:30
500: build_response(
FertilizationValidationErrorSerializer,
"خطا در تولید توصیه کودهی.",
),
2026-03-21 23:50:36 +03:30
},
examples=[
OpenApiExample(
"نمونه درخواست",
value={
2026-04-25 17:22:41 +03:30
"farm_uuid": "11111111-1111-1111-1111-111111111111",
2026-04-28 04:11:49 +03:30
"crop_id": "wheat",
"growth_stage": "flowering",
2026-03-21 23:50:36 +03:30
},
request_only=True,
),
2026-04-28 04:11:49 +03:30
OpenApiExample(
"نمونه پاسخ",
value={
"code": 200,
"msg": "success",
"data": {
"primary_recommendation": {
"fertilizer_code": "15-10-30",
"fertilizer_name": "کود کامل 15-10-30",
"display_title": "کود کامل 15-10-30",
"fertilizer_type": "NPK",
"npk_ratio": {"n": 15, "p": 10, "k": 30, "label": "15-10-30"},
"application_method": {
"id": "foliar_fertigation",
"label": "کودآبیاری یا محلول پاشی سبک",
},
"application_interval": {"value": 14, "unit": "day", "label": "هر 14 روز"},
"dosage": {
"base_amount_per_hectare": 65,
"base_amount_per_square_meter": 0.0065,
"unit": "kg",
"label": "65 کیلوگرم در هکتار",
"calculation_basis": "crop_simulation_heuristic",
},
"reasoning": "این ترکیب برای مرحله گلدهی و توازن نیازهای تغذیه ای مناسب است.",
"summary": "برای پشتیبانی از گلدهی و کاهش تنش تغذیه ای پیشنهاد می شود.",
},
"nutrient_analysis": {
"macro": [
{
"key": "n",
"name": "نیتروژن (N)",
"value": 15,
"unit": "percent",
"description": "نیتروژن برای حفظ رشد رویشی مهم است.",
}
],
"micro": [],
},
"application_guide": {
"safety_warning": "در ساعات خنک مصرف شود و از اختلاط ناسازگار خودداری کنید.",
"steps": [
{"step_number": 1, "title": "آماده سازی", "description": "دوز را آماده کنید."},
{"step_number": 2, "title": "تزریق یا پخش", "description": "طبق روش مصرف اجرا کنید."},
{"step_number": 3, "title": "پایش", "description": "پاسخ مزرعه را بررسی کنید."},
],
},
"alternative_recommendations": [],
},
},
response_only=True,
),
2026-03-21 23:50:36 +03:30
],
)
def post(self, request):
2026-04-24 02:50:27 +03:30
from rag.services.fertilization import get_fertilization_recommendation
2026-03-21 23:50:36 +03:30
serializer = FertilizationRecommendRequestSerializer(data=request.data)
if not serializer.is_valid():
return Response(
{"code": 400, "msg": "داده نامعتبر.", "data": serializer.errors},
status=status.HTTP_400_BAD_REQUEST,
)
validated = serializer.validated_data
2026-04-24 02:50:27 +03:30
try:
result = get_fertilization_recommendation(
2026-04-28 04:11:49 +03:30
farm_uuid=validated["farm_uuid"],
plant_name=validated.get("plant_name"),
crop_id=validated.get("crop_id"),
growth_stage=validated.get("growth_stage"),
query=validated.get("query"),
2026-04-24 02:50:27 +03:30
)
except Exception as exc:
return Response(
{"code": 500, "msg": f"خطا در تولید توصیه کودهی: {exc}", "data": None},
status=status.HTTP_500_INTERNAL_SERVER_ERROR,
)
2026-03-21 23:50:36 +03:30
2026-04-28 04:11:49 +03:30
final_result = result.get("data") if isinstance(result, dict) else None
if not isinstance(final_result, dict):
final_result = {"sections": result.get("sections", [])} if isinstance(result, dict) else {}
2026-03-21 23:50:36 +03:30
return Response(
2026-04-26 01:15:38 +03:30
{"code": 200, "msg": "success", "data": final_result},
2026-03-21 23:50:36 +03:30
status=status.HTTP_200_OK,
)
2026-04-30 03:25:31 +03:30
class FertilizationPlanParserView(APIView):
@extend_schema(
tags=["Fertilization Recommendation"],
summary="استخراج برنامه کودهی از متن آزاد",
description=(
"توضیح متنی کاربر درباره برنامه کودهی را می گیرد و آن را به JSON ساختاریافته تبدیل می کند. "
"اگر اطلاعات کافی نباشد، سوالات تکمیلی لازم را برمی گرداند تا در درخواست بعدی پاسخ داده شوند."
),
request=FertilizationPlanParserRequestSerializer,
responses={
200: build_response(
FertilizationPlanParserEnvelopeSerializer,
"نتیجه استخراج یا سوالات تکمیلی برنامه کودهی.",
),
400: build_response(
FertilizationValidationErrorSerializer,
"داده ورودی نامعتبر است.",
),
500: build_response(
FertilizationValidationErrorSerializer,
"خطا در پردازش برنامه کودهی.",
),
},
examples=[
OpenApiExample(
"نمونه درخواست کامل",
value={
"message": "برای گندم در مرحله پنجه زنی هر 12 روز یک بار 20-20-20 به مقدار 35 کیلوگرم در هکتار از طریق کودآبیاری می دهم.",
"farm_uuid": "11111111-1111-1111-1111-111111111111",
},
request_only=True,
),
OpenApiExample(
"نمونه درخواست تکمیلی",
value={
"partial_plan": {
"crop_name": "گندم",
"applications": [{"fertilizer_name": "20-20-20"}],
},
"answers": {
"amount": "35 کیلوگرم در هکتار",
"timing": "هر 12 روز یک بار",
},
},
request_only=True,
),
],
)
def post(self, request):
serializer = FertilizationPlanParserRequestSerializer(data=request.data)
if not serializer.is_valid():
return Response(
{"code": 400, "msg": "داده نامعتبر.", "data": serializer.errors},
status=status.HTTP_400_BAD_REQUEST,
)
validated = serializer.validated_data
service = apps.get_app_config("fertilization").get_free_text_plan_parser_service()
try:
result = service.parse_plan(
message=validated.get("message", ""),
answers=validated.get("answers"),
partial_plan=validated.get("partial_plan"),
farm_uuid=validated.get("farm_uuid"),
)
except Exception as exc:
return Response(
{"code": 500, "msg": f"خطا در پردازش برنامه کودهی: {exc}", "data": None},
status=status.HTTP_500_INTERNAL_SERVER_ERROR,
)
return Response(
{"code": 200, "msg": "موفق", "data": result},
status=status.HTTP_200_OK,
)