Backend/DASHBOARD_CARD_SOURCES.md

Dashboard Card Sources

این فایل مشخص می‌کند هر کارت داشبورد در بک‌اند از کدام app، service و endpoint تغذیه می‌شود.

مسیر اصلی داشبورد

• GET /api/farm-dashboard/?farm_uuid=...
• تجمیع نهایی کارت‌ها در dashboard/services.py انجام می‌شود.
• این سرویس از app های مختلف داده را جمع می‌کند و response نهایی داشبورد را می‌سازد.

مپ ردیف‌ها و کارت‌ها

overviewKpis

این ردیف در نهایت در dashboard/services.py ساخته می‌شود، ولی هر KPI از app خودش می‌آید:

Card / KPI ID	عنوان	منبع اصلی	service	endpoint
farm_health_score	امتیاز سلامت مزرعه	crop_health	get_crop_health_summary_data	GET /api/crop-health/summary/
water_stress_index	شاخص تنش آبی	WATER	get_water_stress_index_data	GET /api/water/stress-index/
avg_soil_moisture	میانگین رطوبت خاک	soil	get_avg_soil_moisture_data	GET /api/soil/avg-moisture/
disease_risk	ریسک بیماری	pest_detection	get_risk_summary_data	GET /api/pest-detection/risk-summary/
yield_prediction	پیش‌بینی عملکرد	yield_harvest	get_yield_harvest_summary_data	GET /api/yield-harvest/summary/
pest_risk	ریسک آفات	pest_detection	get_risk_summary_data	GET /api/pest-detection/risk-summary/

weatherAlerts

Card ID	عنوان	منبع اصلی	service	endpoint
farmWeatherCard	کارت آب‌وهوا	WATER	get_farm_weather_card_data	GET /api/water/card/
farmAlertsTracker	خلاصه هشدارها	farm_alerts	get_alert_tracker_data	هنوز endpoint مستقل service-based ندارد؛ در داشبورد از service داخلی استفاده می‌شود

sensorMonitoring

Card ID	عنوان	منبع اصلی	service	endpoint
sensorValuesList	لیست مقادیر سنسورها	فعلا dashboard	فعلا مستقیم از dashboard/mock_data.py	endpoint مستقل ندارد

sensorCharts

Card ID	عنوان	منبع اصلی	service	endpoint
sensorRadarChart	نمودار راداری سنسورها	soil	get_sensor_radar_chart_data	GET /api/soil/sensor-radar-chart/
sensorComparisonChart	مقایسه با هفته قبل	soil	get_sensor_comparison_chart_data	GET /api/soil/sensor-comparison-chart/

alertsWater

Card ID	عنوان	منبع اصلی	service	endpoint
anomalyDetectionCard	ناهنجاری سنسورها/خاک	soil	get_anomaly_detection_card_data	GET /api/soil/anomalies/
farmAlertsTimeline	تایم‌لاین هشدارها	farm_alerts	get_alert_timeline_data	هنوز endpoint مستقل service-based ندارد؛ در داشبورد از service داخلی استفاده می‌شود
waterNeedPrediction	نیاز آبی 7 روز آینده	WATER	get_water_need_prediction_data	GET /api/water/need-prediction/

predictions

Card ID	عنوان	منبع اصلی	service	endpoint
harvestPredictionCard	پیش‌بینی برداشت	yield_harvest	get_yield_harvest_summary_data	GET /api/yield-harvest/summary/
yieldPredictionChart	نمودار پیش‌بینی عملکرد	yield_harvest	get_yield_harvest_summary_data	GET /api/yield-harvest/summary/

soilHeatmap

Card ID	عنوان	منبع اصلی	service	endpoint
soilMoistureHeatmap	نقشه حرارتی رطوبت خاک	soil	get_soil_moisture_heatmap_data	GET /api/soil/moisture-heatmap/

ndviRecommendations

Card ID	عنوان	منبع اصلی	service	endpoint
ndviHealthCard	کارت سلامت NDVI	crop_health	get_crop_health_summary_data	GET /api/crop-health/summary/
recommendationsList	لیست پیشنهادها	ترکیبی	ترکیب در dashboard/services.py	endpoint مستقل نهایی ندارد

منابع recommendationsList:

• farm_alerts از get_recommendations_list_data
• irrigation_recommendation از get_irrigation_dashboard_recommendation
• fertilization_recommendation از get_fertilization_dashboard_recommendation
• yield_harvest برای آیتم بازه برداشت

economic

Card ID	عنوان	منبع اصلی	service	endpoint
economicOverview	نمای اقتصادی	economic_overview	get_economic_overview_data	GET /api/economic-overview/summary/

endpoint های summary جدید برای app ها

برای استفاده راحت‌تر در فرانت، این app ها الان منبع واضح برای کارت‌های داشبورد دارند:

• crop_health
  • GET /api/crop-health/summary/
• WATER
  • GET /api/water/card/
  • GET /api/water/need-prediction/
  • GET /api/water/stress-index/
  • GET /api/water/summary/
• soil
  • GET /api/soil/avg-moisture/
  • GET /api/soil/sensor-radar-chart/
  • GET /api/soil/sensor-comparison-chart/
  • GET /api/soil/anomalies/
  • GET /api/soil/moisture-heatmap/
  • GET /api/soil/summary/
• yield_harvest
  • GET /api/yield-harvest/summary/
• economic_overview
  • GET /api/economic-overview/summary/

وضعیت فعلی کارت‌ها

کاملا service-based

• farmOverviewKpis به صورت ترکیبی
• farmWeatherCard
• farmAlertsTracker
• sensorRadarChart
• sensorComparisonChart
• anomalyDetectionCard
• farmAlertsTimeline
• waterNeedPrediction
• harvestPredictionCard
• yieldPredictionChart
• soilMoistureHeatmap
• ndviHealthCard
• recommendationsList
• economicOverview

هنوز مستقیم از mock داشبورد

• sensorValuesList

پیشنهاد برای فرانت

• اگر صفحه مستقل برای هر domain دارید، برای هر صفحه از endpoint خود همان app استفاده کنید.
• اگر صفحه داشبورد اصلی دارید، فقط از GET /api/farm-dashboard/?farm_uuid=... استفاده کنید.
• اگر لازم است هر کارت به صفحه جزئیات خودش لینک شود، بهترین mapping فعلی این است:
  • Weather + Water cards -> WATER
  • NDVI + Farm Health -> crop_health
  • Soil cards -> soil
  • Yield + Harvest -> yield_harvest
  • Alerts -> farm_alerts
  • Economy -> economic_overview
  • Pest/Disease risk -> pest_detection