نداء — دليل ميزات التطبيق

1. ما هي منصة نداء

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

تطبيق المزارع — الحزمة org.nidaa.user — التحميل: nidaa-user.apk. للمزارع نفسه: تسجيل، دخول، أسعار، إرشاد، معلومات، وإن كان مستحقاً للدعم: مساعدة مالية، حساب بنكي، رمز تحقق، إشعارات، ملف شخصي.

تطبيق الإدارة — الحزمة org.nidaa.admin — التحميل: nidaa-admin.apk. للمشرف والمالك: كتابة الأسعار والإرشاد والمحاصيل، بحث المزارعين، توثيق الهاتف والبنك، تفعيل الأهلية، اعتماد المراحل والصرف، لصق/مسح رمز المستخدم. المالك يرى لوحة أرقام ويدير المشرفين.

عنوان الخادم: http://174.138.29.61:18080. كل مسارات العمل تحت /v1. فحص الصحة: /healthz. دليل المبرمج: frontend.html.

الأدوار الثلاثة بالتفصيل

الدور	رمز الخادم	التطبيق المسموح	صلاحيات القراءة	صلاحيات الكتابة
مزارع	`farmer`	تطبيق المزارع فقط	أسعاره المنشورة، الإرشاد المنشور، معلوماته، دفعاته إن كان مؤهلاً، إشعاراته، رمزه	تسجيل، تحديث الملف، رفع/تعديل بنك، تأكيد «أكملت المرحلة»، تعليم إشعار مقروء
مشرف	`admin`	تطبيق الإدارة	كل المزارعين، كل الدفعات التي يديرها، المسودات	محاصيل، أسواق، أسعار، منشورات، توثيق هاتف/بنك، أهلية، اعتماد، صرف، إيقاف مزارع، إنشاء مزارع
مالك	`owner`	تطبيق الإدارة	كل ما يراه المشرف + لوحة المالك + سجل الدفعات + قائمة المشرفين	كل ما يكتبه المشرف + إنشاء/إيقاف/تفعيل مشرف

الدخول بالتطبيق الخطأ يُرفض في الواجهة حتى لو الرمز صالح. لا تخلط التطبيقين على جهاز واحد دون الخروج أولاً.

هيكل الشريط والدرج

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

اللون الأساسي أخضر #00B76A. الشعار يظهر في شاشة الدخول. عند فشل تحميل الصورة يظهر أيقونة زراعة.

2. حسابات التجريب

كلمة المرور لكل الحسابات أدناه: LabBridge#2026

الاسم	الدور	الدخول	الهاتف	ماذا ترى
أحمد علي	مزارع مؤهل	`farmer.lab@nidaa.local`	0120000001	أهلية مفعّلة. بنك الخرطوم موثّق (1234567890). خمس مراحل: تجهيز الأرض 8500 مدفوع، الزراعة 9200 مدفوع، الري 7800 مدفوع، مكافحة الآفات معتمدة بانتظار الصرف، الحصاد قيد المراجعة. إرشاد وأخبار. رمز تحقق.
فاطمة حسن	مزارعة قيد التوثيق	`fatima.lab@nidaa.local`	0120000004	الأهلية مغلقة. لا تبويب مساعدة. الهاتف غير موثّق. بنك قيد المراجعة. الموقع الحصاحيصا. مساحة 6 هكتار مروي. هذا الحساب لتجربة المشرف: توثيق هاتف ثم بنك ثم أهلية.
عمر صالح	مزارع موقوف	`omar.lab@nidaa.local`	0120000005	الدخول مرفوض. الرسالة تذكر سبب الإيقاف. يظهر في قائمة المشرف بحالة موقوف.
مشرف النظام	مشرف	`admin.lab@nidaa.local`	0120000002	كل تبويبات الإدارة عدا لوحة المالك.
مالك التطبيق	مالك	`owner.lab@nidaa.local`	0120000003	لوحة المالك: عدد المزارعين، الممولون، المشرفون النشطون، مجموع المدفوع، متوسط الفرد، إضافة مشرف، سجل الدفعات.

مسار تجريب كامل (اتبعه بالترتيب)

ثبّت تطبيق المزارع. ادخل ببريد أحمد أو هاتفه. افتح كل تبويب. اضغط «عرض الرمز» في المساعدة. افتح الحساب البنكي وتأكد أن الحالة «موثّق».
اخرج. ادخل بفاطمة. تأكد أن شريحة الأهلية ظاهرة وأن تبويب المساعدة غير موجود في الشريط.
اخرج. حاول عمر. يجب أن تظهر رسالة أن الحساب موقوف ولا يمكن الدخول.
ثبّت تطبيق الإدارة. ادخل بالمشرف. من «المزارعون» ابحث فاطمة. افتح التفاصيل. وثّق الهاتف ثم وثّق البنك ثم فعّل أهلية الدعم.
ارجع لأحمد من قائمة المزارعين. في الدفعات: إن كانت مكافحة الآفات «معتمد» اضغط «صرف + إشعار»، أدخل رقم عملية، ارفع صورة، احفظ.
ادخل بالمالك. افتح لوحة المالك وتحقق من الأرقام وسجل الدفعات وقائمة المشرفين.

3. شاشة الدخول — تطبيق المزارع

نداء🔔

🌾

نداء

تطبيق المزارع

البريد
farmer.lab@nidaa.local

كلمة المرور

دخول

تسجيل مستخدم جديد · قوقل · فيسبوك

عناصر الشاشة واحداً واحداً

الشعار ثم عنوان «نداء» ثم سطر «تطبيق المزارع» حتى لا يُخلط مع تطبيق الإدارة.
حقل البريد (أحمد: farmer.lab@nidaa.local).
حقل كلمة المرور مخفي النقاط. الحد الأدنى عند التسجيل 8 أحرف.
زر أخضر «دخول». عند الفشل تظهر «تعذر الدخول» بالأحمر تحت الحقول.
رابط «تسجيل مستخدم جديد» يبدّل النموذج إلى إنشاء حساب (انظر الصفحة التالية).
إن وُجدت أزرار «الدخول بقوقل» و«الدخول بفيسبوك» تظهر تحت خط فاصل. إلغاء المستخدم يعيد «تم إلغاء دخول قوقل/فيسبوك». غياب الإعداد يعيد «غير مُعدّ على هذا البناء».

حسابات المختبر ذات النطاق nidaa.local تتجاوز شاشة رمز الهاتف ويدخل المستخدم مباشرة إلى الرئيسية إن كانت كلمة المرور صحيحة والحساب غير موقوف.

حالات الخطأ التي يجب أن تراها

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

4. تسجيل مستخدم جديد ورمز التحقق وقوقل/فيسبوك

نموذج التسجيل

من رابط «تسجيل مستخدم جديد» تظهر حقول إضافية:

الاسم الكامل — ثلاثة أحرف على الأقل عند إكمال الهاتف الاجتماعي.
البريد — اختياري في بعض المسارات، مطلوب عند إنشاء المشرف لمزارع من الإدارة.
رقم الهاتف — حقل مخصص ببادلة الدولة. يجب ألا يقل الرقم المكتمل عن 10 أرقام. إن كان مستخدماً يرفض الخادم: «الهاتف مستخدم».
كلمة المرور — 8 أحرف على الأقل.
زر «إنشاء حساب». إن نقص الهاتف: «رقم الهاتف مطلوب».
رابط «لدي حساب» يعيد نموذج الدخول.

بعد إنشاء الحساب لا تُصدر رموز الجلسة فوراً في العادة. الاستجابة otp_required: شاشة تطلب رمز 6 أرقام مرسلاً إلى تلميح الهاتف مثل 012***0001. في المختبر قد يظهر سطر «رمز المختبر: 482193». الأزرار: «تأكيد الرقم»، «إعادة إرسال الرمز»، «رجوع».

قوقل وفيسبوك

يفتحان الشاشة الرسمية للمزوّد ثم يرسلان الرمز للخادم. إن لم يكن للحساب هاتف تُفتح شاشة «أكمل رقم الهاتف» مع الاسم والرقم ثم تأكيد. إن وُجد نفس البريد يُربط الحساب بدل إنشاء مزارع ثانٍ.

نسيان كلمة المرور غير منفَّذ في هذا الإصدار. المصادقة الثنائية وحذف الحساب صفّان ظاهران في الملف مكتوب عليهما «غير متاح في هذا الإصدار» ولا يفعلان شيئاً.

5. الرئيسية بعد الدخول

الرئيسية🔔

مرحباً أحمد عليمزارع

أسعار السوقمركز الإرشاد المساعدة الماليةالحساب البنكي

أخبار

دليل تجهيز الأرض للقمححرث على عمق 20 إلى 25 سنتيمتراً…

موعد زراعة القمح في الجزيرة

الرئيسيةالأسعارالإرشادالمعلوماتالمساعدة

بطاقة الترحيب والاختصارات والأخبار

أول بطاقة: «مرحباً {الاسم}». السطر الثاني الدور: مزارع / مشرف / مالك.

اختصارات (رقائق قابلة للضغط):

أسعار السوق → تبويب الأسعار.
مركز الإرشاد → تبويب الإرشاد.
إن كان التطبيق إدارة: رقاقة «المزارعون».
إن supportEligible صحيح: «المساعدة المالية» و«الحساب البنكي» ينقلان لتبويب المساعدة.
إن كان مزارعاً وغير مؤهل (فاطمة): رقاقة ثابتة «المساعدة متاحة بعد تفعيل الأهلية» بلا نقرة.

قسم «أخبار» يسحب المنشورات. عند أحمد تظهر أدلة القمح والذرة والسمسم والدخن. فشل التحميل: «تعذر تحميل الأخبار». أثناء الانتظار مؤشر دائري.

التبويبات السفلية للمزارع المؤهل: الرئيسية، الأسعار، الإرشاد، المعلومات، المساعدة. غير المؤهل يفقد المساعدة من الشريط. الإشعارات والملف من الدرج.

6. أسعار السوق

الأسعار🔔

الكلالحبوب

قمح

سوق ود مدني1,250

طن · SDG · 10 أغسطس

ذرة

سوق ود مدني980

سمسم

سوق ود مدني2,100

دخن

سوق مدني شرق740

الرئيسيةالأسعارالإرشادالمعلوماتالمساعدة

ماذا يرى المزارع

فلاتر أعلى القائمة: «الكل» و«الحبوب». المزارع لا يرى أزرار الإضافة. كل سعر يعرض: اسم المحصول، السوق، الرقم، الوحدة (طن)، العملة (جنيه سوداني)، التاريخ، وملاحظة إن وُجدت (مثل «سعر الجملة» للقمح).

الأرقام الحالية في المختبر:

المحصول	السوق	السعر
قمح	سوق ود مدني	1,250 / طن
ذرة	سوق ود مدني	980 / طن
سمسم	سوق ود مدني	2,100 / طن
دخن	سوق مدني شرق	740 / طن

المشرف من نفس الشاشة يرى أزراراً: إضافة محصول، إضافة سوق، إضافة سعر، وتعديل سعر موجود. نموذج السعر يطلب: المحصول، السوق، الوحدة، الرقم، التاريخ. الخطأ: «أدخل سعراً صحيحاً» أو «تعذر الحفظ».

7. مركز الإرشاد — المراحل الخمس

سطر توضيحي أعلى الشاشة: «زراعة مطرية أو مروية ثم محصول ثم مرحلة». تحتها رقائق المراحل. اختيار رقاقة يصفّي القائمة. المزارع يقرأ فقط. المشرف يرى «إضافة إرشاد» ويستطيع التعديل والحذف. المسودة تظهر للمشرف بلاحقة «مسودة» ولا يراها المزارع.

الرمز	الاسم	الترتيب	منشور المختبر المرتبط
`land_prep`	تجهيز الأرض	1	دليل تجهيز الأرض للقمح — حرث 20 إلى 25 سم وإزالة المخلفات.
`planting`	الزراعة	2	موعد زراعة القمح في الجزيرة — منتصف نوفمبر حتى أوائل ديسمبر.
`irrigation`	الري والرعاية	3	ري الذرة في الموجة الحارة — ريّة خفيفة كل ثلاثة أيام بلا غمر.
`pest_control`	مكافحة الآفات	4	علامات آفة السمسم — نوع صورة.
`harvest`	الحصاد	5	حصاد الدخن وتخزينه — جفاف السنابل ومكان جاف.

القائمة الفارغة: «لا يوجد محتوى». فشل الشبكة: «تعذر التحميل». كل عنصر يعرض العنوان ونوعه (مقال/صور/صوت/فيديو) واسم المحصول إن رُبط.

8. المعلومات، وأنواع المنشور، ونموذج الإضافة

تبويب المعلومات مكتبة أوسع: بحث نصّي، وفلاتر النوع (الكل / مقال / صور / صوت / فيديو). المشرف زر «إضافة». البطاقة تعرض العنوان والنص. الضغط عند المشرف يفتح التعديل. سلة الحذف تحذف المنشور.

نموذج «منشور جديد» / «تعديل المنشور» — كل الحقول

الحقل	الإلزام	السلوك
العنوان	نعم	مع النص: وإلا «العنوان والنص مطلوبان»
النص	نعم	ستة أسطر إدخال
النوع	نعم	مقال / صور / صوت / فيديو
فترة الأرض / المرحلة	اختياري	من قائمة المراحل الخمس
نوع المحصول	اختياري	«بدون» أو قمح/ذرة/سمسم/دخن…
نشر فوراً	مفتاح	إن فُعّل تُلغى الجدولة
جدولة النشر تلقائياً	اختياري	تقويم ثم ساعة خلال سنة. يلغي النشر الفوري
رفع صور / ملفات / فيديو / صوت	اختياري	اختيار متعدد. الفشل: «تعذر رفع الملف». كل مرفق له زر حذف
حفظ / إضافة	—	الفشل: «تعذر الحفظ»

المزارع يفتح المرفق للتشغيل أو التنزيل. إن تعذر التشغيل داخل التطبيق يظهر «تعذر التشغيل هنا. يمكن فتحه خارج التطبيق» مع زر فتح.

9. المساعدة المالية (للمؤهل فقط)

المساعدة🔔

المستلم25,500

القادمة—

تجهيز الأرضمدفوع — REC-2026-001

الزراعةمدفوع

الري والرعايةمدفوع

مكافحة الآفاتمعتمد

الحصادقيد المراجعة

عرض الرمز

الحساب البنكي — بنك الخرطوم — موثّق

الرئيسيةالأسعارالإرشادالمعلوماتالمساعدة

ملخص المبالغ وخمس المراحل

التبويب لا يُبنى أصلاً إن كان المستخدم مزارعاً وsupportEligible خطأ. فاطمة لا تراه. أحمد يراه.

ثلاثة ملخصات أعلى الصفحة: المستلم (مجموع المدفوع — عند أحمد 8500+9200+7800 = 25500)، القادمة (مبلغ أول دفعة غير مدفوعة أو شرطة)، الموعد (تاريخ متوقع إن وُجد).

كل مرحلة بطاقة: الاسم، الحالة بالعربية، رقم العملية إن وُجد، وسط «تم تأكيد المرحلة» إن ضغط المزارع «أكملت المرحلة». الزر يظهر فقط والمزارع وفي حالة قيد المراجعة ولم يُؤكَّد بعد. بعد التأكيد ينتظر اعتماد المشرف ثم الصرف.

حالات الدفعة: قيد المراجعة، معتمد، مدفوع، مرفوض، فشل. المدفوع يلوّن البطاقة بأخضر خفيف.

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

10. الحساب البنكي ورمز التحقق

شاشة الحساب البنكي

من سطر «الحساب البنكي» في المساعدة. تعرض الحالة الحالية والملاحظات. النموذج:

قائمة البنك (اثنا عشر بنكاً مزروعاً): الخرطوم، فيصل الإسلامي، أم درمان الوطني، النيلين، الزراعي السوداني، المزارع التجاري، التضامن، الادخار، السعودي السوداني، البركة، الثروة الحيوانية، بنك السودان المركزي.
اسم صاحب الحساب.
رقم الحساب — إن فُرغ: «رقم الحساب مطلوب».
رقم بنكك (اختياري).
زر «إرسال للمراجعة».

عند أحمد الحالة موثّق وبنك الخرطوم ورقم 1234567890 وبنكك 249900000001. عند فاطمة قيد المراجعة. المشرف يوثّق أو يرفض من تفاصيل المزارع؛ الرفض يكتب ملاحظة «مرفوض من المشرف».

عرض الرمز

زر أخضر «عرض الرمز» يفتح شاشة «رمز التحقق» مربعاً 240 بكسل. المشرف يلصق الرمز في خانة «لصق الرمز الممسوح» في قائمة المزارعين ثم يتحقق. النتيجة تظهر في شريط أسفل الشاشة: نجاح مع الاسم، أو غير موجود / منتهٍ / غير مؤهل.

11. الإشعارات والملف الشخصي

الإشعارات

عداد «غير مقروء». رقائق: الكل / غير مقروء / مقروء. زر «وسم الكل». كل عنصر: عنوان، نص، سلة حذف. الضغط يعلّمه مقروءاً.

عند أحمد في المختبر: «تم صرف دفعة تجهيز الأرض»، «مرحلة مكافحة الآفات بانتظار الصرف»، «منشور إرشاد جديد: ري الذرة». عند المشرف/المالك: إشعارات أن فاطمة رفعت بنكاً وأن هاتفها بانتظار التوثيق.

الملف

الاسم، البريد، الهاتف، الموقع في بطاقة أعلى.
مفتاح «الوضع الليلي» يبدّل ثيم الجهاز محلياً.
صف اللغة (العربية في هذا البناء).
«المصادقة الثنائية» و«حذف الحساب»: غير متاحين في هذا الإصدار.
زر «خروج» يمسح الجلسة ويعيد الدخول.

بيانات أحمد للتحقق: ود مدني، الجزيرة — رقم وطني 119900123456 — 12 هكتار — زراعة مطرية. فاطمة: الحصاحيصا — 6 هكتار — مروي.

12. تطبيق الإدارة — الدخول والشريط

نفس شاشة الدخول لكن العنوان «تطبيق الإدارة». البريد admin.lab@nidaa.local أو owner.lab@nidaa.local. لا تسجيل مزارع من هنا. لا قوقل/فيسبوك في مسار الإدارة المعتاد.

تبويبات الشريط: الرئيسية، الأسعار، الإرشاد، المعلومات، المساعدة (عند الإدارة رسالة توجيه لقائمة المزارعين). من الدرج: المزارعون، المحاصيل، لوحة المالك (للمالك فقط)، الإشعارات، الملف.

الرئيسية للمشرف: ترحيب بالاسم و«مشرف» أو «مالك»، اختصارات الأسعار والإرشاد والمزارعين، والأخبار نفسها.

13. المشرف يكتب الأسعار والمحاصيل والأسواق

من الأسعار: «إضافة محصول» (اسم + تصنيف الحبوب/الأسمدة). اسم فارغ: «اسم المحصول مطلوب».

«سوق جديد»: الاسم إلزامي، الموقع اختياري. المزروع: سوق ود مدني (الجزيرة)، سوق مدني شرق.

«سعر جديد» / «تعديل السعر»: محصول، سوق، وحدة (طن/هكتار حسب النوع)، السعر، ملاحظة اختيارية.

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

14. المشرف ينشئ الإرشاد والمعلومات

من الإرشاد: اختر المرحلة ثم «إضافة إرشاد». من المعلومات: «إضافة». النموذج هو نفسه المشروح في القسم 8. بعد الحفظ يظهر في قائمة المزارعين إن نُشر، ويبقى مسودة إن لم يُنشر. الحذف فوري من أيقونة السلة. التعديل يعيد ملء كل الحقول والمرفقات.

اربط المنشور بمرحلة ومحصول حتى يظهر تحت الرقاقة الصحيحة عند المزارع. مثال التحقق: بعد إضافة مقال لمرحلة الحصاد عن القمح، ادخل بأحمد وافتح الإرشاد → الحصاد.

15. قائمة المزارعين — البحث والإنشاء والرمز

المزارعون🔔

بحث بالاسم أو الهاتف أو البريد

إضافة مستخدم

لصق الرمز الممسوح

أحمد عليمؤهل0120000001 — ود مدني

فاطمة حسنغير مؤهل0120000004 — الحصاحيصا

عمر صالحموقوف0120000005

الرئيسيةالأسعارالإرشادالمعلوماتالمزارعون

كل عناصر القائمة

حقل بحث بالاسم أو الهاتف أو البريد. زر العدسة يعيد التحميل.
«إضافة مستخدم» يفتح نموذج مزارع جديد: اسم، بريد، هاتف إلزامي، كلمة مرور 8 أحرف، موقع، مفتاح أهلية الدعم. النواقص: «الاسم والبريد وكلمة مرور من 8 أحرف مطلوبة» أو «رقم الهاتف مطلوب للمستخدم».
«لصق الرمز الممسوح» مع أيقونة ماسح. بعد التحقق رسالة النتيجة.
كل صف: الاسم، هاتف، بريد، موقع، «موقوف: السبب» إن وُجد، يمين «مؤهل» أو «غير مؤهل». الضغط يفتح بيانات المستخدم.
فشل التحميل: «تعذر تحميل المستخدمين».

16. شاشة بيانات المستخدم (تفاصيل المزارع)

العنوان «بيانات المستخدم». البطاقة الأولى: الاسم، البريد، الهاتف، الموقع، نوع الزراعة، «الهوية: …».

مفتاح أهلية الدعم

يبدّل الاستحقاق فوراً. بعد توثيق هاتف فاطمة وكمال ملفها فعّله ثم ادخل بتطبيق المزارع بحسابها: يجب أن يظهر تبويب المساعدة.

الإيقاف

إن كان موقوفاً يظهر سطر أحمر بالسبب. زر «إيقاف مع تقرير» يفتح حواراً: سبب متعدد الأسطر، إلغاء أو إيقاف. لا يُحفظ سبب فارغ. عمر صالح مثال جاهز. الإيقاف يمنع الدخول.

الحساب البنكي

«لا يوجد حساب» إن لم يُرفع. وإلا: اسم البنك، صاحب الحساب، الرقم، الحالة، من وثّقه، الملاحظات. أزرار «توثيق» و«رفض».

جدول الدفعات في التفاصيل

لكل مرحلة: الحالة، «أكد المرحلة» إن أكد المزارع، اسم من اعتمد، اسم من صرف، رقم العملية. إن الحالة معتمد يظهر «صرف + إشعار». إن قيد المراجعة مع تأكيد مرحلة يظهر «اعتماد للصرف». وإلا يظهر المبلغ.

17. حوار إتمام الصرف بنكك — خطوة بخطوة

من دفعة أحمد «مكافحة الآفات» وهي معتمدة:

اضغط «صرف + إشعار».
عنوان الحوار: «إتمام الصرف بنكك».
أدخل رقم العملية (أي مرجع تحويل).
اضغط «رفع صورة الإشعار» واختر صورة من الجهاز. تُرفع للتخزين ثم تُربط بالدفعة.
«حفظ» يسم الدفعة مدفوعاً بالمرجع والصورة. «إلغاء» يغلق بلا تغيير.

إن نُفّذ الحفظ بلا رقم عملية لا تكتمل العملية. المزارع أحمد بعد التحديث يرى المرحلة مدفوعة ويزيد «المستلم». المالك يراها في سجل الدفعات مع «صرف: مشرف النظام» و«عملية: …».

زر «اعتماد للصرف» على مرحلة أكملها المزارع ينقلها من قيد المراجعة إلى معتمد دون مبلغ بعد؛ المبلغ يظهر عند صفوف أخرى كرقم حتى يتم الصرف.

18. إنشاء مزارع أو مشرف من الواجهة

من قائمة المزارعين: مستخدم جديد (مزارع). من لوحة المالك: «إضافة مشرف» أو «إضافة مستخدم».

الحقل	مزارع	مشرف
الاسم الكامل	مطلوب	مطلوب
البريد	مطلوب	مطلوب
الهاتف	مطلوب ≥ 10	اختياري
كلمة المرور	≥ 8	≥ 8
الموقع	اختياري	لا يظهر
أهلية الدعم	مفتاح	لا يظهر

عنوان الشاشة: «مستخدم جديد» أو «مشرف جديد». زر «إنشاء». عند النجاح تُغلق الشاشة وتُحدَّث القائمة.

19. لوحة المالك

تظهر في الدرج فقط إذا الدور مالك. ادخل owner.lab@nidaa.local.

المؤشر	المعنى	ماذا تتوقع في المختبر
المزارعون	عدد سجلات المزارعين غير المحذوفة	3 (أحمد، فاطمة، عمر)
الممولون	من لهم أهلية أو دفعات ممولة حسب تجميع اللوحة	أحمد على الأقل
المشرفون النشطون	حسابات مشرف بحالة نشط	مشرف النظام
مجموع المدفوع	مجموع مبالغ الحالة مدفوع	25500 من مراحل أحمد الثلاث
متوسط للفرد	المجموع على عدد الممولين	يتغير بعد صرف إضافي

أزرار: إضافة مشرف، إضافة مستخدم. ثم «سجل الدفعات» حتى 20 سطراً: اسم المزارع، المرحلة، الحالة، توثيق البنك، الاعتماد، الصرف، رقم العملية.

«المشرفون»: الاسم، البريد، الهاتف، الحالة، تقرير الإيقاف إن وُجد. نشط → حوار إيقاف بسبب إلزامي. غير نشط → «تفعيل».

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

نفس شاشة الإشعارات. استخدمها بعد رفع بنك فاطمة: يجب أن يصل تنبيه للمشرف/المالك. بعد صرف أحمد يصل تنبيه للمزارع.

ملف المشرف: اسم «مشرف النظام»، بريده، هاتف 0120000002، الوضع الليلي، خروج. المالك مماثل باسم «مالك التطبيق».

21. قواعد العمل التي تفسّر سلوك الأزرار

المساعدة المالية لا تظهر في شريط المزارع إلا بعد أهلية دعم.
الأهلية قرار مشرف من تفاصيل المزارع، مستقل عن البنك في شاشة المفتاح، لكن الصرف الميداني يحتاج حساباً موثّقاً عملياً.
المزارع يؤكد المرحلة («أكملت المرحلة») ثم المشرف يعتمد ثم يصرف مع رقم عملية وصورة.
خمس مراحل لكل دورة. الحالات: قيد المراجعة، معتمد، مدفوع، مرفوض، فشل.
الإيقاف يكتب سبباً ويمنع الدخول. عمر صالح للتجربة.
رمز المزارع للتحقق الميداني. المشرف يلصق النتيجة.
المنشور بلا نشر أو بجدولة لا يراه المزارع.
المحتوى المنشور يبقى بنصّه؛ لا يُترجم آلياً.
الوضع الليلي محلي على الجهاز.
الجلسة تُحفظ وتعود عند فتح التطبيق ما لم يُضغط خروج أو يُرفض التجديد.

22. قائمة تحقق سريعة لكل شاشة

الشاشة	حساب التجربة	علامة النجاح
دخول مزارع	أحمد	رئيسية «مرحباً أحمد علي»
دخول مرفوض	عمر	رسالة موقوف
أسعار	أحمد	قمح 1250 ودخن 740
إرشاد / ري	أحمد	مقال ري الذرة
مساعدة	أحمد	مستلم 25500 وخمس بطاقات
مساعدة غائبة	فاطمة	شريحة أهلية فقط
بنك	أحمد	موثّق — الخرطوم
رمز	أحمد	مربع QR
إدارة / مزارعون	مشرف	الأسماء الثلاثة
توثيق	فاطمة عبر المشرف	هاتف ثم بنك ثم أهلية
صرف	أحمد عبر المشرف	مرحلة تنتقل لمدفوع
لوحة مالك	مالك	مؤشرات وأزرار مشرف

دليل المبرمج للربط البرمجي: frontend.html — كتالوج المسارات: frontend-api.html.

23. جولة أحمد علي — من الأيقونة حتى الرمز

ثبّت nidaa-user.apk. اسمح بالمصادر المجهولة إن طلب أندرويد ذلك.
افتح التطبيق. تأكد أن العنوان «تطبيق المزارع» لا «تطبيق الإدارة».
البريد farmer.lab@nidaa.local وكلمة المرور LabBridge#2026. اضغط دخول.
يفترض أن تصل للرئيسية: «مرحباً أحمد علي» و«مزارع». إن ظهرت شاشة رمز، أدخل الرمز الظاهر في المختبر ثم تأكيد الرقم.
اضغط رقاقة أسعار السوق. اقرأ القمح 1250 في سوق ود مدني والدخن 740 في سوق مدني شرق. لا يوجد زر إضافة.
ارجع للشريط → الإرشاد. اضغط تجهيز الأرض ثم الزراعة ثم الري ثم مكافحة الآفات ثم الحصاد. في كل مرحلة منشور واحد على الأقل.
المعلومات: اكتب في البحث «قمح» وتأكد أن النتائج تضيق. صفّر البحث. جرّب فلتر صور لعلامات آفة السمسم.
المساعدة: المستلم 25500. ثلاث بطاقات مدفوعة مع أرقام REC-2026-001 وما يليها. مكافحة الآفات معتمد. الحصاد قيد المراجعة. إن كانت الحصاد قيد المراجعة بلا تأكيد، يظهر «أكملت المرحلة» — لا تضغطه إن كنت تريد الإبقاء على سيناريو المشرف كما هو، أو اضغطه لتجربة الاعتماد لاحقاً.
افتح الحساب البنكي. الحالة موثّق. لا داعي لإعادة الإرسال.
ارجع واضغط عرض الرمز. اترك الشاشة مفتوحة إن كان معك جهاز ثانٍ لتطبيق الإدارة.
من الدرج: الإشعارات ثم الملف. بدّل الوضع الليلي وتأكد أن الخلفية تتغيّر. اخرج فقط بعد انتهاء الجولة.

24. جولة فاطمة ثم عمر — ماذا يجب أن يختلف

فاطمة حسن

خروج من أحمد إن كنت لا تزال داخله.
دخول fatima.lab@nidaa.local / LabBridge#2026.
الرئيسية: مرحباً فاطمة حسن. لا رقائق مساعدة مالية ولا حساب بنكي. شريحة ثابتة عن تفعيل الأهلية.
الشريط السفلي أربعة أو خمسة بدون المساعدة. الأسعار والإرشاد والمعلومات تُقرأ كما يقرأها أي مزارع.
الملف: الحصاحيصا، لا أهلية. إن حاولت من الدرج فتح مساعدة فلن تجدها.

عمر صالح

خروج.
دخول omar.lab@nidaa.local أو الهاتف 0120000005 مع نفس كلمة المرور.
لا رئيسية. رسالة أن الحساب موقوف مع سبب المخالفة. لا جلسة تُحفظ.

25. جولة المشرف — توثيق فاطمة وصرف أحمد

ثبّت nidaa-admin.apk. العنوان يجب أن يكون تطبيق الإدارة.
دخول admin.lab@nidaa.local / LabBridge#2026.
من الدرج افتح المزارعون. يجب أن ترى أحمد (مؤهل) وفاطمة (غير مؤهل) وعمر (موقوف).
ابحث «فاطمة» ثم افتح الصف. وثّق رقم الهاتف. وثّق البنك. فعّل مفتاح أهلية الدعم. ارجع للقائمة: يفترض أن تصبح مؤهلة.
افتح أحمد. في مكافحة الآفات المعتمدة اضغط صرف + إشعار. رقم العملية مثلاً TXN-LAB-001. ارفع أي صورة إيصال. حفظ.
اختياري: من الحصاد إن كان المزارع أكد المرحلة، اضغط اعتماد للصرف.
من الأسعار أضف سعراً تجريبياً لمحصول موجود ثم عدّله. من الإرشاد أضف مسودة ولا تنشرها، ادخل بأحمد وتأكد أنها لا تظهر، ثم ارجع وانشر.
لصق رمز أحمد إن كان مفتوحاً على الجهاز الآخر في خانة لصق الرمز الممسوح.

بعد توثيق فاطمة ادخل بتطبيق المزارع بحسابها: يفترض أن يظهر تبويب المساعدة وصندوق البنك موثّق.

26. جولة المالك — الأرقام والمشرفون

خروج من المشرف. دخول owner.lab@nidaa.local.
من الدرج لوحة المالك. اقرأ: المزارعون 3، مجموع المدفوع (25500 أو أكثر بعد صرف إضافي)، المشرفون النشطون.
سجل الدفعات: صفوف أحمد بالمراحل المدفوعة مع أسماء الاعتماد والصرف إن وُجدت.
لا توقف مشرف النظام أثناء التجريب الجماعي حتى لا تُغلق البوابة على الباقين. إن أنشأت مشرفاً تجريبياً يمكنك إيقافه بسبب مكتوب ثم تفعيله.
الملف ثم خروج.

البنوك الاثنا عشر في قائمة الحساب البنكي

بنك الخرطوم، بنك فيصل الإسلامي السوداني، بنك أم درمان الوطني، بنك النيلين، البنك الزراعي السوداني، بنك المزارع التجاري، بنك التضامن الإسلامي، بنك الادخار، البنك السعودي السوداني، بنك البركة، بنك الثروة الحيوانية، بنك السودان المركزي.

حالات الحساب البنكي

قيد المراجعة — موثّق — مرفوض — يحتاج تحديثاً. المزارع بعد الرفع ينتظر. لا يُطلب منه الرفع ثانية إلا إذا طُلب تحديث.

حالات المستخدم والمزارع

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

1. What Nidaa is

Nidaa is a field platform for farming and agricultural finance. There is no browser console. Work happens in two Android apps against one lab server.

Farmer app — package org.nidaa.user — nidaa-user.apk. Registration, sign-in, prices, guidance, info; if eligible: aid, bank, QR, alerts, profile.

Admin app — package org.nidaa.admin — nidaa-admin.apk. Staff write prices, guidance and crops, search farmers, verify phone and bank, enable eligibility, approve stages and pay out, paste/verify QR. The owner also gets a numeric dashboard and staff management.

Server: http://174.138.29.61:18080. Business routes under /v1. Health: /healthz. Engineer guide: frontend.html.

Three roles

Role	Code	App	Read	Write
Farmer	`farmer`	Farmer app only	Published prices/guidance/info, own payments if eligible, own alerts, own QR	Register, profile, bank submit, complete stage, mark alerts
Admin	`admin`	Admin app	All farmers, drafts, payments they manage	Crops, markets, prices, posts, phone/bank review, eligibility, approve, pay, ban, create farmer
Owner	`owner`	Admin app	Admin plus dashboard, ledger, staff list	Admin plus create/suspend/activate admins

The wrong app rejects the role locally. Bottom bar shows five destinations; the rest live in the drawer. Brand green is #00B76A.

2. Trial accounts

Password for every account below: LabBridge#2026

Name	Role	Login	Phone	What you will see
Ahmed Ali	Eligible farmer	`farmer.lab@nidaa.local`	0120000001	Aid on. Bank of Khartoum verified. Five stages: land prep 8500 paid, planting 9200 paid, irrigation 7800 paid, pest control approved waiting payout, harvest pending review. Guidance, news, QR.
Fatima Hassan	Pending farmer	`fatima.lab@nidaa.local`	0120000004	Eligibility off. No Aid tab. Phone unverified. Bank pending. Hassahisa, 6 ha irrigated. Use her for admin verification practice.
Omar Saleh	Banned farmer	`omar.lab@nidaa.local`	0120000005	Sign-in rejected with the ban reason. Still listed for staff.
System Admin	Admin	`admin.lab@nidaa.local`	0120000002	All admin tabs except Owner.
App Owner	Owner	`owner.lab@nidaa.local`	0120000003	Owner dashboard KPIs, add admin, payment ledger, staff list.

Suggested path

Install the farmer app. Sign in as Ahmed. Open every tab. Show QR. Confirm bank is verified.
Sign in as Fatima. Confirm the eligibility chip and the missing Aid tab.
Try Omar. Login must fail.
Install the admin app. As admin, open Fatima: verify phone, verify bank, enable eligibility.
Open Ahmed’s payments: complete payout on the approved stage with a transaction number and receipt image.
Sign in as owner. Check KPIs, ledger, and staff.

3. Farmer sign-in screen

Nidaa🔔

🌾

Nidaa

Farmer app

Email
farmer.lab@nidaa.local

Password

Every control

Logo, title Nidaa, subtitle “Farmer app” so it is not confused with admin.
Email (Ahmed: farmer.lab@nidaa.local) and hidden password.
Green Sign in. Failure: could not sign in. Banned Omar: account is suspended with reason.
Create account toggles registration. Google/Facebook sit under a divider when compiled in.

Lab accounts on nidaa.local skip the OTP screen when the password is correct and the user is not banned.

4. Registration, OTP, Google, Facebook

Registration fields: full name, email, phone (complete number at least 10 digits; taken phone is rejected), password ≥ 8. After register the usual response is OTP: six digits, phone hint, lab echo on this server, Confirm / Resend / Back.

Google and Facebook open the official provider sheet, then the server. Missing phone opens “finish the phone number”. Same email is linked rather than duplicated.

Forgot-password is not implemented. Profile rows for two-factor and delete account are visible but labelled unavailable in this release.

5. Home

Greeting card with name and role. Chips: Market prices, Guidance center, Farmers (admin app), Financial aid + Bank account if eligible. Fatima sees a non-tappable “Aid is available after eligibility is approved”. News lists published posts (wheat land-prep guide, planting window, sorghum irrigation, sesame pest image, millet harvest). Load failure: could not load news.

Eligible farmer bottom bar: Home, Prices, Guidance, Info, Aid. Alerts and Profile are in the drawer.

6. Market prices

Filters: All, Grains. Farmer is read-only. Lab rows: wheat 1,250 Wad Madani, sorghum 980 Wad Madani, sesame 2,100 Wad Madani, millet 740 Madani East. Unit ton, currency SDG. Admin gets add crop, add market, add/edit price. Invalid number: enter a valid price.

7. Guidance — five stages

Hint line, then stage chips: land preparation, planting, irrigation, pest control, harvest. Farmer reads. Admin adds, edits, deletes. Drafts visible only to staff. Empty: no content. Network: could not load.

Lab posts by stage: wheat land prep; wheat planting window; sorghum irrigation; sesame pest (image); millet harvest.

8. Info library and the post form

Search box, type filters (all / article / image / audio / video), Add for staff. Form fields: title and body required; type; stage; crop or none; publish now; schedule date+time within a year; multi file upload (failure: could not upload); save/add (failure: could not save). Unpublished or scheduled posts are hidden from farmers. In-app media falls back to Open outside the app.

9. Financial aid (eligible farmers only)

The tab is omitted when a farmer is not eligible. Admin opening Aid sees: open the farmers list to view user data, accounts and payments.

Three totals: received (Ahmed 25,500), next unpaid amount, next date. Five stage cards. Complete stage is shown only to the farmer while pending review and not yet submitted. Paid cards are tinted green. Statuses: pending review, approved, paid, rejected, failed.

10. Bank account and QR

Bank form: 12 Sudanese banks, account holder, account number (required), Bankak number. Submit for review. Ahmed is verified at Bank of Khartoum 1234567890 / Bankak 249900000001. Fatima is pending. Admin verifies or rejects from farmer detail.

Show code opens a 240px QR. Admin pastes into “paste the scanned code” on the farmers list. Snackbar: success + name, or not found / expired / ineligible.

11. Alerts and profile

Unread count, chips all/unread/read, mark all, delete, tap to mark read. Ahmed has payout and guidance notices. Staff have Fatima phone/bank pending notices.

Profile: name, email, phone, location; dark mode; language row; disabled 2FA and delete; logout. Ahmed: Wad Madani, national id 119900123456, 12 ha rain-fed. Fatima: Hassahisa, 6 ha irrigated.

12. Admin app shell

Same login chrome with subtitle Admin app. Use admin.lab or owner.lab. Tabs: Home, Prices, Guidance, Info, Aid (redirect copy). Drawer: Farmers, Crops, Owner (owner only), Alerts, Profile.

13. Admin writes prices, crops, markets

Add crop (name + grains/fertilizers). Add market (name required, location optional). Add/edit price (crop, market, unit, number, notes). Crops tab lists wheat, sorghum, sesame, millet.

14. Admin writes guidance and info

Same post form as section 8. Publish for farmers to see. Delete from the trash icon. Tie a post to a stage and crop so it appears under the matching chip for Ahmed.

15. Farmers list

Search by name, phone, or email. Add user (farmer form). Paste scanned code. Rows: Ahmed eligible, Fatima not eligible, Omar banned with reason. Tap opens user details. Load error: could not load users.

16. User details

Card: name, email, phone, location, farm type, national id. Eligibility switch. Red ban line + Ban with report dialog (reason required). Bank block with Verify / Reject. Payments: Complete Bankak payout when approved; Approve for payout when the farmer completed the stage; otherwise amount.

17. Complete Bankak payout

On Ahmed, pest control, status approved, tap payout.
Enter transaction number.
Upload receipt image.
Save marks the row paid. Cancel leaves it.

Ahmed’s received total increases. Owner ledger shows who paid and the operation number.

18. Create farmer vs create admin

Farmer: name, email, required phone, password, optional location, eligibility switch. Admin: name, email, optional phone, password — no location, no eligibility. Titles: New user / New admin.

19. Owner dashboard

Sign in as owner.lab. KPIs: farmers (3), funded farmers (Ahmed at least), active admins, total paid (25,500 before extra payouts), average per funded farmer. Buttons add admin / add user. Ledger up to 20 rows. Staff cards with suspend (reason required) or activate.

20. Admin alerts and profile

Same alerts UI. After Fatima submits a bank, staff should see a notice. After paying Ahmed, the farmer should see a notice. Admin profile shows System Admin / App Owner and logout.

21. Business rules

Aid tab exists for farmers only when supportEligible is true.
Eligibility is an admin switch on the farmer record.
Farmer completes a stage → admin approves → admin pays with txn + image.
Five stages per cycle. Statuses: pending review, approved, paid, rejected, failed.
Ban writes a reason and blocks login (Omar).
Farmer QR is for field verification; admin pastes the token.
Draft or scheduled posts are hidden from farmers.
Published body text is not auto-translated.
Dark mode is device-local.
Session restores until logout or refresh failure.

22. Screen checklist

Screen	Account	Pass if
Farmer login	Ahmed	Hello Ahmed Ali
Banned login	Omar	Suspended message
Prices	Ahmed	Wheat 1250, millet 740
Guidance / irrigation	Ahmed	Sorghum irrigation article
Aid	Ahmed	Received 25500, five cards
No aid	Fatima	Eligibility chip only
Bank	Ahmed	Verified Khartoum
QR	Ahmed	QR square
Farmers	Admin	Three names
Verify	Fatima via admin	Phone then bank then eligibility
Payout	Ahmed via admin	Stage becomes paid
Owner	Owner	KPIs and staff actions

Engineer guide: frontend.html — API catalog: frontend-api.html.

23. Ahmed’s walkthrough — icon to QR

Install nidaa-user.apk.
Confirm the subtitle is Farmer app.
Email farmer.lab@nidaa.local, password LabBridge#2026.
Home: Hello Ahmed Ali, role Farmer.
Prices: wheat 1250 Wad Madani, millet 740 Madani East. No add button.
Guidance: open each of the five stage chips; each has at least one post.
Info: search wheat; filter image for the sesame pest post.
Aid: received 25,500; three paid cards; pest control approved; harvest pending. Bank verified. Show QR.
Drawer: alerts, profile, dark mode, then continue or logout.

24. Fatima and Omar

Fatima: no aid chips, no Aid tab, eligibility chip only, Hassahisa profile. Omar: sign-in blocked with the ban reason; no session stored.

25. Admin walkthrough — verify Fatima, pay Ahmed

Install nidaa-admin.apk. Subtitle Admin app.
admin.lab@nidaa.local / LabBridge#2026.
Farmers list: Ahmed eligible, Fatima not, Omar banned.
Open Fatima: verify phone, verify bank, turn eligibility on.
Open Ahmed: payout on approved pest control with txn number and receipt image.
Optional: add a draft guidance post, confirm Ahmed cannot see it, then publish.
Paste Ahmed’s QR token into paste the scanned code.

After Fatima is verified, her farmer app should gain the Aid tab.

26. Owner walkthrough

owner.lab@nidaa.local.
Owner tab: farmers 3, total paid 25,500 or more, active admins.
Ledger shows Ahmed’s paid stages.
Do not suspend System Admin during a shared trial. A spare admin you create can be suspended with a written reason and activated again.

Twelve banks in the picker; bank statuses pending / verified / rejected / needs update. User statuses active / inactive / suspended. Suspended users cannot sign in.