الدليل المعماري والهندسي الشامل لمنظومة Agronex (AgriAi Pro)

الرسوم الهندسية والمعمارية التفاعلية (Visual Architecture Diagrams)

الرسوم التوضيحية لتدفق المنظومة ومسارات العمليات

1. المخطط البياني لتسلسل إدخال البيانات والاعتماديات بين الشاشات:

يوضح الرسم التفاعلي التالي كيف تتدفق البيانات من القواميس التأسيسية للمزارع والعمليات الحقلية وصولاً لمحركات الذكاء الاصطناعي والمخرجات:

graph TD subgraph Phase0 ["المرحلة 0: المستخدمين والصلاحيات"] U[المستخدمين والأدوار RBAC] --> P[الملفات الشخصية والتراخيص] end subgraph Phase1 ["المرحلة 1: القواميس المرجعية"] C[دليل وقاموس المحاصيل] AI[دليل المواد الفعالة والسمية] end subgraph Phase2 ["المرحلة 2: المنتجات وقواعد الخلط"] AP[دليل المبيدات والأسمدة التجارية] MC[جدول توافق خلط المبيدات] end subgraph Phase3 ["المرحلة 3: المزارع والحقول والمواسم"] F[المزارع وإحداثيات GPS] FL[تقسيم الحقول] S[المواسم الزراعية والدورات] end subgraph Phase4 ["المرحلة 4: التشغيل الميداني وحساب الجرعات"] FO[العمليات الحقلية اليومية] DC[محرك حاسبة الجرعات والتسميد] end subgraph Phase5 ["المرحلة 5: الذكاء الاصطناعي والأرصاد الحية"] OM[محطة Open-Meteo الحية] AID[تشخيص أمراض النبات Gemini Vision] EWS[بؤر الأوبئة والإنذار المبكر 10 كم] end subgraph Phase6 ["المرحلة 6: المجتمع والاستشارات الميدانية"] COM[منتدى المجتمع والحلول المعتمدة] BK[حجوزات واستشارات المهندسين] CR[التقارير الفنية للزيارات الميدانية] end subgraph Phase7 ["المرحلة 7: المخرجات والتحليلات والتقارير"] PDF[الروشتات والتقارير المطبوعة PDF] KPI[لوحة المؤشرات والخرائط الجغرافية GIS] CMP[بورصة أسعار المحاصيل اليومية] end %% Dependencies Connections U --> F AI --> AP AI --> MC C --> S F --> FL FL --> S AP --> DC S --> FO FO --> DC F --> OM OM --> AID AID --> EWS AID --> COM AID --> BK BK --> CR CR --> PDF AID --> PDF EWS --> KPI

2. مسار معالجة التشخيص المناخي الحي (AI & Open-Meteo Pipeline):

يوضح المخطط التالي كيف يتم التقاط الصورة ودمجها مع بيانات الطقس اللحظية وإرجاع التشخيص والإنذار المبكر:

sequenceDiagram autonumber actor Farmer as المزارع / الهاتف المحمول participant Web as واجهة المنظومة (Blade / API) participant Meteo as محطة Open-Meteo API participant Gemini as محرك Gemini 1.5 Flash Vision participant DB as قاعدة بيانات المنظومة participant EWS as محرك الإنذار المبكر (10 كم) participant PDF as مولد الروشتات (Mpdf) Farmer->>Web: التقاط صورة النبات + إحداثيات GPS activate Web Web->>Meteo: طلب الطقس الحي (حرارة، رطوبة، رياح، أمطار) Meteo-->>Web: إرجاع قراءات الطقس الميدانية Web->>Gemini: إرسال الصورة + الطقس الحي + سياق الحقل Gemini-->>Web: تشخيص المرض + أثر الطقس + العلاج + تعليمات الرش Web->>DB: حفظ التشخيص والبيانات المناخية Web->>EWS: فحص الإصابات المجاورة وتحديث بؤر الأوبئة EWS-->>Farmer: إشعار المزارع وتنبيه الحقول المجاورة Web->>PDF: توليد روشتة الفحص المعتمدة PDF Web-->>Farmer: عرض نتيجة الفحص + شارة الطقس + زر تحميل الروشتة deactivate Web

3. الهيكل المعماري والطبقات ومبادئ SOLID:

يوضح الهيكل كيفية عزل المتحكمات عن الخدمات وحقن التبعيات وحماية البيانات:

graph LR subgraph PresentationLayer ["1. طبقة العرض والطلبات"] HTTP[HTTP Requests] FR[Form Requests Validation & Sanitization] RES[API Resources JsonResource] end subgraph ControllerLayer ["2. طبقة التحكم (Thin Controllers)"] CTRL[Controllers] end subgraph ContractsLayer ["3. طبقة الواجهات والتجريد (SOLID Interfaces)"] IAI[AiServiceInterface] IWeather[WeatherServiceInterface] end subgraph ServiceLayer ["4. طبقة الخدمات ومنطق الأعمال (Domain Services)"] GAI[GeminiAiService] WS[WeatherService] ADS[AiDiagnosisService] DCS[DosageCalculatorService] MCS[MixCheckerService] end subgraph PersistenceLayer ["5. طبقة البيانات والتكامل الخارجي"] ELO[Eloquent Models & DB] EXT[Open-Meteo & Gemini APIs] end HTTP --> FR FR --> CTRL CTRL --> IAI CTRL --> IWeather CTRL --> ADS CTRL --> DCS CTRL --> MCS IAI -.-> GAI IWeather -.-> WS ADS --> GAI ADS --> WS GAI --> EXT WS --> EXT ADS --> ELO CTRL --> RES RES --> HTTP

4. مخطط العزل التلقائي وحماية خصوصية بيانات المستخدمين (Automatic Multi-Tenant & Role Data Scoping):

يوضح المخطط التالي كيف تقوم المنظومة بتوجيه المستخدمين وعزل السجلات وقوائم التحكم والويدجات تلقائياً بمجرد تسجيل الدخول بناءً على الدور:

graph TD LOGIN["بوابة تسجيل الدخول الموحدة (/admin)"] --> AUTH{"فحص دور المستخدم الحالي (User Role & Type)"} AUTH -->|🌾 مزارع (Farmer)| F_PANEL["لوحة المزارع الخاصة (Farmer Workspace)"] AUTH -->|🧑‍🌾 مهندس زراعي (Engineer)| E_PANEL["لوحة الاستشارات الفنية (Engineer Hub)"] AUTH -->|🏢 شركة / تاجر (Merchant)| M_PANEL["بوابة الشركات وسوق المستلزمات"] AUTH -->|👑 مدير عام (Super Admin)| A_PANEL["مركز الإدارة الشاملة (System Admin Center)"] subgraph FarmerScope ["نطاق بيانات المزارع (Private Tenant Scope)"] F_PANEL --> F1["مزارعي وحقولي الخاصة فقط (where user_id = auth)"] F_PANEL --> F2["عملياتي الحقلية وتكاليفي الخاصة"] F_PANEL --> F3["سجل تشخيصاتي الذكية وروشتاتي PDF"] F_PANEL --> F4["استشاراتي وحجوزاتي الخاصة مع المهندسين"] F_PANEL --> F5["حاسبة الجرعات وبورصة الأسعار ومجتمع المزارعين"] end subgraph EngineerScope ["نطاق بيانات المهندس الزراعي (Consultant Scope)"] E_PANEL --> E1["جدول الاستشارات والزيارات الموكلة إليه"] E_PANEL --> E2["الحالات والتشخيصات المحالة للمراجعة الفنية"] E_PANEL --> E3["تحرير تقارير المعاينة الميدانية الرسمية"] E_PANEL --> E4["مراقبة بؤر الأوبئة وإرشاد المجتمع الزراعي"] end subgraph MerchantScope ["نطاق الشركات والتجارة (Agro Business Scope)"] M_PANEL --> M1["بورصة أسعار المحاصيل والمستلزمات الزراعية"] M_PANEL --> M2["دليل توافق خلط المبيدات والأسمدة"] M_PANEL --> M3["بنك المعرفة الزراعي ومقالات FAO"] M_PANEL --> M4["التواصل وتلبية طلبات المزارعين في المجتمع"] end subgraph AdminScope ["نطاق الإدارة المركزية (System Master Scope)"] A_PANEL --> A1["إحصائيات المنظومة الكاملة لجميع المزارع"] A_PANEL --> A2["إدارة المستخدمين والأدوار والصلاحيات (Shield)"] A_PANEL --> A3["إعدادات محركات الذكاء الاصطناعي والأرصاد"] A_PANEL --> A4["إدارة قواميس المحاصيل والمواد الفعالة والمبيدات"] end

الأمان وخصوصية البيانات (Role-Based Data Scoping & Multi-Tenancy)

نظام العزل التلقائي وخصوصية البيانات بين الشركات والمستخدمين

تم تصميم المنظومة لتعمل وفق نمط البوابة الموحدة الذكية (Intelligent Scoped Portal)، حيث يدخل جميع أطراف المنظومة (المزارعون، المهندسون الاستشاريون، الشركات والتجار، ومديرو النظام) من نفس الرابط /admin، ولكن محرك Filament & Eloquent Scoping يقوم فوراً بعزل وتخصيص الشاشات والبيانات والويدجات التحليلية بما يضمن السرية التامة وحماية خصوصية بيانات كل مزرعة وشركة.

الدور / المستخدم	لوحة المؤشرات (Dashboard Widgets)	الشاشات المتاحة ونطاق البيانات (Accessible Scopes)	الشاشات المحجوبة أمنياً (Restricted Scopes)
المزارع (Farmer) صاحب الحقل / المستثمر	مزارعي الخاصة: عدد مزارعه ومساحاتها فقط بالفدان. فحوصاتي بالـ AI: سجل تشخيصات محاصيله. بؤر الأوبئة: تنبيهات الإنذار المبكر حول مزارعه (10 كم). حجوزاتي: مواعيد استشاراته مع المهندسين.	مزارعي وحقولي (مزارعه فقط) العمليات الحقلية (لحقوله فقط) سجل تشخيصات الـ AI والروشتات حجز استشارة مهندس زراعي حاسبة الجرعات وبورصة الأسعار منتدى المجتمع وبنك المعرفة	مزارع وحقول المستخدمين الآخرين شاشات إدارة الصلاحيات والأدوار الإعدادات العامة وتكوينات السيرفر
مهندس استشاري (Engineer) الخبير الزراعي الميداني	حالات الفحص المحالة: التشخيصات التي تتطلب تأكيد بشري. استشاراتي الموكلة: زيارات المزارع المجدولة معه. بؤر الأوبئة: رصد تفشي الأمراض جغرافياً.	جدول الاستشارات والزيارات الموكلة مراجعة وتأكيد تشخيصات الـ AI إصدار تقارير المعاينة وروشتات الـ PDF الرد على استفسارات المزارعين في المجتمع جدول خلط المبيدات وبنك المعرفة	إدارة مزارع الفلاحين الشخصية استشارات المهندسين الآخرين تعديل أسعار النظام والإعدادات العامة
الشركات والتجار (Merchants) موردو المستلزمات والمدخلات	بورصة الأسعار: تحديث ومتابعة أسعار السلع والمبيدات. المجتمع الزراعي: التواصل مع طلبات وعروض المزارعين.	بورصة أسعار المحاصيل والمستلزمات جدول توافق خلط المبيدات والأسمدة بنك المعرفة الزراعي ومقالات FAO المجتمع الزراعي والتفاعل التجاري	سجلات مزارع وحقول الفلاحين تقارير الاستشارات الفنية والزيارات لوحة الإدارة المركزية والصلاحيات
مدير المنظومة (Super Admin) الإدارة العليا والتحكم الكامل	المزارع المسجلة: إجمالي مزارع الجمهورية ومساحاتها. فحوصات الـ AI: إجمالي التشخيصات المنفذة. بؤر الأوبئة: خارطة الطوارئ والإنذار المبكر. الاستشارات والزيارات: مؤشرات أداء المهندسين.	الوصول المطلق لجميع الشاشات الـ 16 إدارة الأدوار والصلاحيات (Shield Roles) إدارة قواميس المحاصيل والمواد الفعالة إعدادات الموقع وربط APIs الذكاء الاصطناعي	لا يوجد قيود (Full System Authority)

1. كيف يتم تطبيق العزل على مستوى الاستعلامات (Eloquent Query Scoping)؟

في كل Resource من شاشات Filament، يتم تجاوز دالة getEloquentQuery() لفرض شرط التصفية تلقائياً على قاعدة البيانات؛ فلا يتم جلب سوى بيانات المستخدم الحالي حتى لو حاول تعديل معرف السجل (ID) في رابط المتصفح:

public static function getEloquentQuery(): Builder
{
    $query = parent::getEloquentQuery();
    $user = auth()->user();

    // إذا لم يكن المستخدم مديراً، يتم حصر البيانات في مزارعه فقط
    if ($user && !$user->isAdmin()) {
        $query->where('user_id', $user->id);
    }

    return $query;
}

2. كيف تتبدل بطاقات الإحصائيات (Dynamic Dashboard Widgets)؟

يقوم ويدجت StatsOverviewWidget بفحص هوية المستخدم المسجل وتبديل عناوين وأرقام البطاقات في أجزاء من الثانية:

للفلاح: يحسب Farm::where('user_id', $user->id) ويعرض بطاقة "مزارعي الخاصة" و "إجمالي مساحتي".
للمهندس: يحسب الحالات المحالة إليه ويعرض بطاقة "حالات الفحص المحالة" و "استشاراتي الموكلة".
للأدمن: يحسب الإحصائيات الشاملة لكافة مستخدمي المنظومة على مستوى الجمهورية.

3. كيف يسجل المزارع، المهندس، أو الشركة حساباً جديداً على المنظومة؟

تم تفعيل صفحة تسجيل مخصصة عبر الرابط /admin/register (أو بالضغط على "إنشاء حساب جديد" في شاشة تسجيل الدخول)، وتمر عملية التسجيل بالخطوات التالية:

1. اختيار نوع الحساب

يحدد المستخدم صفته: (🌾 مزارع / 🧑‍🌾 مهندس زراعي / 🏢 شركة وتاجر).

2. البيانات والاتصال

إدخال الاسم الكامل، البريد الإلكتروني، ورقم الهاتف المحمول للطوارئ.

3. الإسناد الآلي للدور

يسند النظام دور Spatie Role المناسب تلقائياً وينشئ الـ Profile.

4. الدخول المباشر المخصص

يتم توجيهه للوحة التحكم فوراً ليجد شاشاته المخصصة معزولة وجاهزة.

تسلسل الإدخال والاعتمادية البرمجية (Data Dependency Roadmap)

خريطة تدفق العمل والترتيب المنطقي لإدخال الشاشات

تم بناء المنظومة وفق نمط معماري يعتمد فيه كل موديول تشغيلي على بيانات أساسية مسجلة قبله لضمان تكامل قواعد البيانات ودقة الحسابات. يوضح المخطط التالي التسلسل الإلزامي والموصى به لإدخال البيانات:

0

المستخدمين والأدوار

نقطة البداية الأساسية

إنشاء المستخدم، تحديد الدور (فلاح، مهندس، شركة، تاجر، أدمن)، واستكمال الملف الشخصي والرقم القومي وقيد النقابة.

1

القواميس والمحاصيل

يعتمد على: الأدمن

تسجيل قاموس المحاصيل الزراعية والاحتياجات المائية والحرارة، وقاموس المواد الفعالة الكيميائية والسمية.

2

المبيدات وقواعد الخلط

يعتمد على: المواد الفعالة

تسجيل المنتجات التجارية والجرعات القياسية وفترات الأمان (PHI)، وقواعد توافق خلط المبيدات والأسمدة.

3

المزارع والحقول

يعتمد على: الفلاح والمحصول

تسجيل بيانات المزرعة وإحداثيات GPS ونوع التربة والري، تقسيمها لحقول، وإنشاء المواسم الزراعية.

4

العمليات والجرعات

يعتمد على: المزرعة والمبيد

تدوين المعاملات الحقلية اليومية (ري، تسميد، رش، تكلفة)، واستخدام حاسبة الجرعات لتحويل المساحات وماء الرش.

5

AI والطقس والإنذار

يعتمد على: GPS + Open-Meteo

تشخيص أمراض النبات بالصورة والطقس الحي، وتوليد بؤر الأوبئة والإنذار المبكر للمزارع المجاورة في دائرة 10 كم.

6

المجتمع والاستشارات

يعتمد على: المزارع والمهندس

طرح الحالات في المنتدى واعتماد أفضل حل، حجز مواعيد المهندسين، وإصدار التقارير الفنية للزيارات الميدانية.

7

التقارير والتحليلات

يعتمد على: كافة الأنشطة

استخراج تقارير PDF الرسمية للمزارع والتشخيصات، خرائط التوزيع الجغرافي GIS، وبورصة أسعار المحاصيل.

التكامل الميداني الذكي (Real-time Meteorological AI)

محرك تشخيص أمراض النبات المدعوم بالأرصاد الحية (Open-Meteo + Gemini Vision)

تم ترقية محرك التشخيص بالذكاء الاصطناعي ليتجاوز مجرد فحص الصورة البصرية؛ حيث يقوم النظام لحظياً باستدعاء محطة الأرصاد المجانية Open-Meteo API لنفس إحداثيات الحقل ودمج المعطيات المناخية مباشرة في برومبت التشخيص:

الرابط الحي المستخدم لحظياً:

https://api.open-meteo.com/v1/forecast?latitude={lat}&longitude={lng}¤t=temperature_2m,relative_humidity_2m,wind_speed_10m,precipitation&timezone=Africa/Cairo

22.3°C

درجة الحرارة الحالية

89%

الرطوبة النسبية الحالية

2.5 كم/س

سرعة الرياح الميدانية

0.0 مم

معدل الأمطار

القيمة التشخيصية لدمج الطقس الحي:

ترجيح المسببات الفطرية: عند رصد رطوبة عالية (> 80%) مع حرارة معتدلة (18-26°م)، يرجح الذكاء الاصطناعي إصابات الندوة المتأخرة، البياض الزغبي، وأعفان الثمار.
ترجيح المسببات الحشرية والحرارية: عند انخفاض الرطوبة وارتفاع الحرارة (> 35°م)، يرجح الـ AI إصابات العنكبوت الأحمر والأكاروسات أو لفحة الشمس وتنفيل الأزهار.
توصيات الرش الذكية: فحص سرعة الرياح قبل التوصية بالرش لمنع تطاير رذاذ المبيد وضياع تكلفة الفدان.

الإضافات الاستثنائية المدمجة (Integrated Smart Tools)

أداة فحص خلط المبيدات وبورصة أسعار المحاصيل اليومية

جدول فحص توافق خلط المبيدات (Tank Mix Checker)

أداة كيميائية تفحص أمان خلط مادتين فعالتين أو سمادين في خزان الرش لضمان عدم احتراق الأوراق أو الترسيب:

⛔ أكسيكلورور النحاس + الأحماض الأمينية خطر (تسمم واحتراق أوراق)

✅ مانكوزيب + ميتالاكسيل (ريدوميل) آمن وتآزر لمكافحة الندوات

⛔ كبريت ميكروني + زيوت معدنية خطر حروق شديدة (فاصل 21 يوم)

✅ أبامكتين + زيت معدني صيفي آمن ومضاعفة النفاذية للأنفاق

بورصة أسعار المحاصيل والسلع الزراعية

متابعة لحظية لأسعار السلع الاستراتيجية في السوق المصري والبورصة السلعية مع نسب التغير اليومية:

المحصول / السلعة	السعر الحالي	الوحدة	التغير
القمح المحلي (23.5)	2,000.00 ج.م	إردب (150 كجم)	▲ 1.50%
القطن المصري (جيزة 94)	12,500.00 ج.م	قنطار	▲ 3.20%
أرز شعير عريض الحبة	17,800.00 ج.م	طن	▲ 0.45%
الذرة الصفراء المحلية	13,500.00 ج.م	طن	▼ -0.80%

الجودة والمعايير الهندسية (Engineering Excellence)

مراجعة معايير SOLID Principles، الحماية والأمان، وClean Code

1. مبادئ SOLID الخمسة

S (Single Responsibility): فصل كامل بين المتحكمات (Controllers) وطبقة الخدمات (Services). على سبيل المثال، DiagnosisController يتعامل فقط مع الطلبات/الاستجابات بينما منطق الرؤية والذكاء الاصطناعي معزول في AiDiagnosisService وGeminiAiService.
O (Open/Closed): الاعتماد على واجهات برمجية مجردة (AiServiceInterface, WeatherServiceInterface) مما يتيح استبدال أو توسيع مزودي الذكاء الاصطناعي ومحطات الطقس دون المساس بالكود الأساسي.
L (Liskov Substitution): تطابق كامل في العقود البرمجية واستجابات DTOs والـ Resources.
I (Interface Segregation): واجهات متخصصة ودقيقة لكل غرض وظيفي.
D (Dependency Inversion): ربط واجهات الخدمات عبر حاوية الخدمات AppServiceProvider بحقن التبعيات التلقائي (Dependency Injection).

2. معايير الحماية والأمان (Security)

Rate Limiting (Throttle Middleware): تحديد سقف للطلبات (20 طلب/دقيقة للـ AI لمنع استنزاف الخوادم، و60 طلب/دقيقة لباقي الـ APIs ضد هجمات DDoS).
XSS & Data Sanitization: تعقيم كافة النصوص الحقلية والمنشورات عبر strip_tags() وتنظيف المدخلات في طبقة الـ FormRequests.
File Upload Hardening: تشفير أسماء الصور بـ UUID hashes وفحص صارم للـ MIME Types (jpeg, png, webp) وحجم أقصاه 8MB.
Secrets Protection: عدم استخدام env() مباشرة داخل الكنترولرات، والاعتماد على config('services.gemini.api_key') للتوافق مع Config Caching ومنع تسريب المفاتيح.
Mass Assignment & Policies: تحديد $fillable بدقة على كافة النماذج مع سياسات التحكم بالوصول (RBAC).

3. معايير الكود النظيف (Clean Code)

Dedicated FormRequests: استخراج كافة قواعد التحقق لملفات مستقلة (DiagnosePlantRequest, ChatMessageRequest, CalculateDosageRequest...).
API Resources (JsonResource): توحيد بنية الاستجابات البرمجية (AiDiagnosisResource, CropMarketPriceResource...) لإخفاء أعمدة قواعد البيانات الحساسة وتنسيق البيانات.
Type Hinting & Return Types: توثيق دقيق لأنواع المدخلات والمخرجات على جميع الدوال والفئات.
DRY Principle: إعادة استخدام منطق حساب المسافات الجغرافية، التحويلات المساحية، ومعالجات مخرجات الأرصاد.

الدليل الفني للشاشات (All 16 System Modules)

دليل شاشات المنظومة: الوظائف والمدخلات والابتكارات

SRS 18 1. لوحة المؤشرات التنفيذية (Executive Dashboard)

Admin Engineer Farmer

الهدف الأساسي:

مراقبة حية للمساحات المزروعة، المزارع النشطة، أعداد التشخيصات اليومية، وبؤر الأوبئة.

الاعتمادية والمدخلات:

تجميع آلي من سجلات المزارع والحقول وبؤر الإنذار المبكر والعمليات الحقلية.

الميزات الذكية:

بطاقات رقمية تفاعلية (KPIs) يتم تحديثها فورياً مع رسم بياني لتوزيع المحاصيل.

SRS 04 2. إدارة المزارع والحقول (Farms & Fields Management)

Farmer Admin

الهدف الأساسي:

توثيق مزارع الفلاح، مساحاتها بالفدان، نظام الري (تنقيط/غمر)، نوع التربة، وإحداثيات GPS.

الاعتمادية والمدخلات:

إلزامي: وجود حساب مزارع مسجل. اختياري: ربط الحقول بمواسم المحاصيل.

الميزات الذكية:

الربط الجغرافي التلقائي بمحطة Open-Meteo لتوليد تنبيهات الطقس والإنذار المبكر للأوبئة.

SRS 04 & 13 3. دليل وقاموس المحاصيل الزراعية (Crops Catalog)

Admin Engineer

الهدف الأساسي:

قاموس مرجعي لأنواع المحاصيل، تصنيفاتها (خضر، فاكهة، محاصيل حقلية)، ودرجات الحرارة المثلى.

الاعتمادية والمدخلات:

لا يعتمد على شاشات أخرى (قاموس تأسيسي يتم إدخاله في المرحلة 1).

الميزات الذكية:

تغذية حاسبة الجرعات ومحرك قواعد توصيات الطقس (مثل درجات الحرارة الحرجة للصقيع).

SRS 05 4. محرك حاسبة الجرعات والتسميد (Dosage Calculator Engine)

Farmer Engineer

الهدف الأساسي:

احتساب كميات المبيد وماء الرش وتوزيعها على مواتير الرش الظهرية (20 لتر) وبراميل الرش (200 لتر).

الاعتمادية والمدخلات:

يعتمد على: اختيار المبيد/السماد، إدخال المساحة والوحدة (فدان، قيراط، سهم، هكتار).

الميزات الذكية:

تحويل تلقائي دقيق للمساحات الزراعية وعرض فترة الأمان (PHI) وإرشادات السلامة.

SRS 07 & 16 5. تشخيص أمراض النبات بالـ AI والطقس الحي (AI Diagnosis)

Farmer Engineer

الهدف الأساسي:

فحص صور الأوراق المصابة بالرؤية الحاسوبية (Gemini Vision) وتحديد المرض والعلاج وروشتة PDF.

الاعتمادية والمدخلات:

صورة النبات + إحداثيات GPS (يتم جلب طقس Open-Meteo آلياً فوراً).

الميزات الذكية:

تحليل أثر الرطوبة والحرارة، تعليمات الرش وفق سرعة الرياح، والتصعيد للمهندس المعتمد.

SRS 08 & 15 6. بؤر الأوبئة والإنذار المبكر (Outbreak Clusters & Early Warning)

Admin Engineer Farmer

الهدف الأساسي:

تجميع الإصابات جغرافياً، حساب مؤشر الخطر، وتنبيه المزارع المجاورة في دائرة 10 كم برشة وقائية.

الاعتمادية والمدخلات:

توليد آلي فور تسجيل أي تشخيص لمرض وبائي عبر معادلة المسافات الكروية (Haversine).

الميزات الذكية:

احتساب مؤشر الخطر (Risk Score 0-100) وتوليد إشعارات وقائية موجهة لحماية الحقول المجاورة.

SRS 09 7. منتدى المجتمع الزراعي والحلول المعتمدة (Community Forum)

Farmer Engineer

الهدف الأساسي:

طرح الحالات الحقلية من المزارعين وتبادل الخبرات وإجابات المهندسين مع نظام اعتماد أفضل حل.

الاعتمادية والمدخلات:

يعتمد على: تصنيفات الأقسام (أمراض خضر، موالح، تسميد...) والمحاصيل المسجلة.

الميزات الذكية:

تمييز أفضل إجابة (Best Answer)، إغلاق الحالة كمحلولة، وبناء سمعة المهندسين الخبراء.

SRS 10 & 11 8. حجوزات واستشارات المهندسين (Consultations & Field Visits)

Engineer Farmer

الهدف الأساسي:

تنظيم طلبات الزيارات الميدانية والاستشارات الرقمية، وتوثيق التقرير الفني للزيارة.

الاعتمادية والمدخلات:

يعتمد على: قائمة خدمات المهندس وأسعاره، واختيار المزرعة وتاريخ الموعد.

الميزات الذكية:

إصدار تقرير فني ميداني معتمد بعد الزيارة يشمل خطة التسميد والمكافحة وتصديره PDF.

دليل واجهات البرمجة (RESTful APIs Reference)

دليل نقاط الاتصال البرمجية (APIs) الجاهزة والمفحوصة

الميثود والمسار	الوظيفة	المدخلات المطلوبة	المخرجات
POST /api/diagnose	تشخيص أمراض النبات بالـ AI والطقس	`image, latitude, longitude`	مرض النبات، نسبة الثقة، العلاج، وبيانات Open-Meteo
POST /api/dosage/calculate	محرك حاسبة الجرعات والتسميد	`agri_product_id, area_value, area_unit`	إجمالي المبيد وماء الرش ومواتير 20L والبراميل
POST /api/mix-checker/check	فحص توافق خلط المبيدات والأسمدة	`substance_a, substance_b`	حالة الخلط (آمن/خطر)، التحذيرات، والأضرار المحتملة
GET /api/market/prices	بورصة أسعار المحاصيل اليومية	—	أسعار السلع (قمح، ذرة، قطن، أرز) ونسب التغير
GET /api/weather/farm/{id}	جلب طقس وتنبيهات المزرعة الحية	`farm_id`	درجات الحرارة، سرعة الرياح، وتنبيهات الرش والصقيع
GET /api/early-warning/clusters	بؤر الأوبئة النشطة ومؤشر الخطر	—	البؤر النشطة، نصف القطر، ونقاط الخريطة الجغرافية
GET /api/knowledge/articles	بنك المعرفة الزراعي ومقالات FAO	`category, search`	مقالات الإرشاد والتسميد والمكافحة المتكاملة
GET /reports/diagnosis/{id}/pdf	تحميل روشتة الفحص المعتمدة PDF	`id`	ملف PDF مطبوع يشمل بيانات الفحص والطقس