Update Docker Compose ports to 8081 and add new apps and URL routes for crop zoning, plant simulator, pest detection, irrigation recommendation, fertilization recommendation, and farm AI assistant.

2026-02-25 12:21:53 +03:30
parent 608252714b
commit 2a77f90ccd
46 changed files with 4142 additions and 2 deletions
@@ -0,0 +1,44 @@
+"""
+Static mock data for Farm AI Assistant API.
+No database, no dynamic values. All responses are fixed JSON.
+"""
+
+CHAT_RESPONSE_DATA = {
+    "message_id": "a-1739123456789",
+    "conversation_id": "conv-abc123",
+    "content": "",
+    "sections": [
+        {
+            "type": "recommendation",
+            "title": "Irrigation recommendation",
+            "icon": "droplet",
+            "frequency": "3 times per week",
+            "amount": "15–20 L per plant",
+            "timing": "Early morning (05:00–07:00)",
+            "expandableExplanation": "Your loamy soil holds moisture well...",
+        },
+        {
+            "type": "list",
+            "title": "Key points",
+            "icon": "leaf",
+            "items": [
+                "Avoid midday watering to reduce evaporation",
+                "Drip irrigation preferred for root zone targeting",
+            ],
+        },
+        {
+            "type": "warning",
+            "title": "Weather advisory",
+            "icon": "warning",
+            "content": "High temps forecasted next week. Consider increasing frequency.",
+        },
+    ],
+}
+
+CONTEXT_RESPONSE_DATA = {
+    "soilType": "Loamy",
+    "waterEC": "1.2 dS/m",
+    "selectedCrop": "Tomato",
+    "growthStage": "Flowering",
+    "lastIrrigationStatus": "2 days ago",
+}
@@ -0,0 +1,48 @@
+{
+  "info": {
+    "name": "Farm AI Assistant",
+    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
+    "description": "Farm AI Assistant API. GET context (farm bar data). POST chat (user message + optional farm_context/images). Static JSON only."
+  },
+  "item": [
+    {
+      "name": "Get farm context (GET)",
+      "request": {
+        "method": "GET",
+        "header": [{"key": "Content-Type", "value": "application/json"}],
+        "url": "{{baseUrl}}/api/farm-ai-assistant/context/",
+        "description": "Returns static farm context: soilType, waterEC, selectedCrop, growthStage, lastIrrigationStatus for the context bar."
+      },
+      "response": [
+        {
+          "name": "Success",
+          "status": "OK",
+          "code": 200,
+          "body": "{\n  \"status\": \"success\",\n  \"data\": {\n    \"soilType\": \"Loamy\",\n    \"waterEC\": \"1.2 dS/m\",\n    \"selectedCrop\": \"Tomato\",\n    \"growthStage\": \"Flowering\",\n    \"lastIrrigationStatus\": \"2 days ago\"\n  }\n}"
+        }
+      ]
+    },
+    {
+      "name": "Chat (POST)",
+      "request": {
+        "method": "POST",
+        "header": [{"key": "Content-Type", "value": "application/json"}],
+        "body": {
+          "mode": "raw",
+          "raw": "{\n  \"content\": \"برنامه آبیاری برای گوجه در مرحله گلدهی چطور باشد؟\",\n  \"farm_context\": {\n    \"soilType\": \"Loamy\",\n    \"waterEC\": \"1.2 dS/m\",\n    \"selectedCrop\": \"Tomato\",\n    \"growthStage\": \"Flowering\",\n    \"lastIrrigationStatus\": \"2 days ago\"\n  }\n}"
+        },
+        "url": "{{baseUrl}}/api/farm-ai-assistant/chat/",
+        "description": "Body: content (required), optional images, conversation_id, farm_context. Returns static message with sections (recommendation, list, warning). Input not processed."
+      },
+      "response": [
+        {
+          "name": "Success",
+          "status": "OK",
+          "code": 200,
+          "body": "{\n  \"status\": \"success\",\n  \"data\": {\n    \"message_id\": \"a-1739123456789\",\n    \"conversation_id\": \"conv-abc123\",\n    \"content\": \"\",\n    \"sections\": [\n      {\n        \"type\": \"recommendation\",\n        \"title\": \"Irrigation recommendation\",\n        \"icon\": \"droplet\",\n        \"frequency\": \"3 times per week\",\n        \"amount\": \"15–20 L per plant\",\n        \"timing\": \"Early morning (05:00–07:00)\",\n        \"expandableExplanation\": \"Your loamy soil holds moisture well...\"\n      },\n      {\n        \"type\": \"list\",\n        \"title\": \"Key points\",\n        \"icon\": \"leaf\",\n        \"items\": [\n          \"Avoid midday watering to reduce evaporation\",\n          \"Drip irrigation preferred for root zone targeting\"\n        ]\n      },\n      {\n        \"type\": \"warning\",\n        \"title\": \"Weather advisory\",\n        \"icon\": \"warning\",\n        \"content\": \"High temps forecasted next week. Consider increasing frequency.\"\n      }\n    ]\n  }\n}"
+        }
+      ]
+    }
+  ],
+  "variable": [{"key": "baseUrl", "value": "http://localhost:8000"}]
+}
@@ -0,0 +1,8 @@
+from django.urls import path
+
+from .views import ChatView, ContextView
+
+urlpatterns = [
+    path("context/", ContextView.as_view(), name="farm-ai-assistant-context"),
+    path("chat/", ChatView.as_view(), name="farm-ai-assistant-chat"),
+]
@@ -0,0 +1,77 @@
+"""
+Farm AI Assistant API views.
+Plain Django only; no DRF. 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.
+CSRF exempt on POST so frontend can call without token.
+"""
+
+from django.http import JsonResponse
+from django.utils.decorators import method_decorator
+from django.views import View
+from django.views.decorators.csrf import csrf_exempt
+
+from .mock_data import CHAT_RESPONSE_DATA, CONTEXT_RESPONSE_DATA
+
+
+class ContextView(View):
+    """
+    GET endpoint for farm context (Farm AI Assistant bar).
+
+    Purpose:
+        Returns static farm context for the Farm AI Assistant UI bar:
+        soilType, waterEC, selectedCrop, growthStage, lastIrrigationStatus.
+        Used when loading the farm-ai-assistant page to populate the context strip.
+
+    Input parameters:
+        None. Query parameters, if sent, are not read or used.
+
+    Response structure:
+        - status: string, always "success".
+        - data: object with keys soilType, waterEC, selectedCrop,
+          growthStage, lastIrrigationStatus (all strings).
+
+    No processing or validation is performed on inputs.
+    """
+
+    def get(self, request):
+        return JsonResponse(
+            {"status": "success", "data": CONTEXT_RESPONSE_DATA},
+            status=200,
+        )
+
+
+@method_decorator(csrf_exempt, name="dispatch")
+class ChatView(View):
+    """
+    POST endpoint for Farm AI Assistant chat (send message, get structured reply).
+
+    Purpose:
+        Accepts user message (and optional images, conversation_id, farm_context)
+        and returns a static structured reply with sections (recommendation,
+        list, warning) for rendering as cards in the chat UI. No AI or
+        computation; response is fixed.
+
+    Input parameters (body, JSON; all optional except conceptually content):
+        - content: string. Location: body. User message text. Not read or used.
+        - images: array of strings (URLs or base64). Location: body. Not read.
+        - conversation_id: string. Location: body. Conversation id. Not used.
+        - farm_context: object (soilType, waterEC, selectedCrop, growthStage,
+          lastIrrigationStatus). Location: body. Not read or used.
+
+    Response structure:
+        - status: string, always "success".
+        - data: object with message_id, conversation_id, content (string),
+          sections (array of section objects). Each section has type, title,
+          icon, and type-specific fields (content, items, frequency, amount,
+          timing, expandableExplanation).
+
+    No processing or validation is performed on inputs. Input values are
+    not used in the response.
+    """
+
+    def post(self, request):
+        return JsonResponse(
+            {"status": "success", "data": CHAT_RESPONSE_DATA},
+            status=200,
+        )