41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# 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 ارسال نمی شود.
|