UPDATE

docs/yield_harvest_ai_integration.md

@@ -0,0 +1,40 @@
+# Yield & Harvest AI Integration
+
+این سند خلاصه قرارداد فرانت برای ماژول `yield-harvest` است.
+
+## اصل اصلی
+
+برای تمام endpointهای farm-based در این ماژول، فرانت فقط باید `farm_uuid` را ارسال کند.
+
+فرانت **نباید** این فیلدها را بفرستد:
+
+- `plant_name`
+- `crop_name`
+- هر context دیگری که backend از مزرعه استخراج می کند
+
+`plant_name` فقط در backend از روی مزرعه استخراج می شود و سپس backend آن را برای AI ارسال می کند.
+
+## endpointهای متصل شده در فرانت
+
+- `POST /api/yield-harvest/current-farm-chart/`
+- `POST /api/yield-harvest/growth/`
+- `GET /api/yield-harvest/growth/{task_id}/status/`
+- `POST /api/yield-harvest/harvest-prediction/`
+- `POST /api/yield-harvest/yield-prediction/`
+- `GET /api/yield-harvest/yield-harvest-summary/`
+
+## وضعیت فعلی فرانت
+
+فایل `src/libs/api/services/yieldHarvestService.ts` فقط با `farm_uuid` به endpointهای farm-based درخواست می زند.
+
+نمونه payload ارسالی از فرانت:
+
+```json
+{
+  "farm_uuid": "11111111-1111-1111-1111-111111111111"
+}
+```
+
+## نکته مهم
+
+حتی اگر responseهای backend شامل `plant_name` باشند، این فیلد فقط برای نمایش یا logging است و از سمت فرانت در request ارسال نمی شود.