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,
|
|
|
|
|
)
|