Frontend/docs/yield_harvest_ai_integration.md

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 ارسالی از فرانت:

{
  "farm_uuid": "11111111-1111-1111-1111-111111111111"
}

نکته مهم

حتی اگر responseهای backend شامل plant_name باشند، این فیلد فقط برای نمایش یا logging است و از سمت فرانت در request ارسال نمی شود.