إنشاء تطبيق متجر جملة

متطلبات تطوير تطبيق متجر جملة

نظرة عامة عن المشروع

المشروع: تطبيق متجر بيع جملة (B2B) ويقبل أيضاً عملاء شبه تجزئة، لكن بشروط.

الهدف: البيع للتجار (تجار الجملة، أصحاب المحلات، البقالات، المعارض).

المنصات المطلوبة:

تطبيق iOS (آيفون).

تطبيق Android.

لوحة تحكم ويب (Web Admin Panel) لإدارة المحتوى والعملاء والطلبات.

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

السيناريو التجاري (Business Flow):

الزائر يتصفح بدون تسجيل → يشوف أقسام ومنتجات بدون أسعار.

لما يبي يشتري أو يعرف السعر، لازم يسجل كمستخدم (تاجر).

نموذج التسجيل يطلب بيانات رسمية (سجل تجاري، رقم ضريبي، هوية...).

الإدارة تراجع الحساب وتوافق عليه يدوي.

بعد الموافقة: المستخدم يقدر يشوف الأسعار، يضيف للسلة، يكمل الطلب ويدفع.

كل طلب له حالة (قيد المراجعة / تحت التحضير / تم الشحن / مكتمل) ويجي إشعار للعميل مع كل تحديث.

نقطة ملكية الكود:

السورس كود كامل للتطبيق (iOS و Android) + السورس كود للباك إند ولوحة التحكم + قاعدة البيانات + ملفات التصميم (Figma/XD) + التوثيق، كلها ملك للعميل ملكية كاملة وغير حصرية.

لا يُسمح بإعادة بيع نفس الحل لعميل آخر بنفس الشكل بدون إذن مكتوب.

2. مواصفات تطبيق الموبايل (iOS و Android)

2.1 شاشة البداية / الـ Onboarding

سلايدر تعريفي/إعلاني يمكن التحكم فيه من لوحة التحكم (بنرات عروض، منتجات مميزة).

اختيار اللغة (العربية و انجليزي).

دعم كامل للواجهة العربية (RTL).

2.2 الصفحة الرئيسية (Home Screen)

سلايدر إعلاني علوي (قابل للإدارة من لوحة التحكم).

أقسام رئيسية (تصنيفات المنتجات).

منتجات مميزة / منتجات جديدة.

شريط بحث.

2.3 صفحة المنتج (Product Details)

كل منتج يعرض:

صور متعددة مع إمكانية التكبير.

اسم المنتج.

وصف/مواصفات المنتج.

حالة المخزون (متوفر / غير متوفر / حسب الطلب).

الحد الأدنى للطلب (MOQ لو موجود).

السعر:

إذا المستخدم غير مسجل أو غير معتمد: السعر مخفي، ويظهر بداله "سجّل لعرض سعر الجملة".

إذا المستخدم معتمد: يظهر السعر (سعر الجملة، وسعر التجزئة إذا فيه).

زر "أضف إلى السلة":

يظهر ويعمل فقط للمستخدم المعتمد.

المستخدم غير المعتمد إذا ضغطه يطلع له تنبيه "يجب اعتماد حسابك التجاري لمتابعة الطلب".

2.4 التسجيل (Sign Up / KYC)

نموذج التسجيل يجب أن يحتوي الحقول التالية:

اسم النشاط التجاري/المؤسسة.

رقم السجل التجاري.

الرقم الضريبي (VAT).

اسم المالك / الشخص المسؤول.

رقم الهوية/الإقامة (مع رفع صورة الهوية).

رقم الجوال (مع توثيق OTP).

البريد الإلكتروني.

المدينة / المنطقة.

سؤال: "كيف سمعت عنا؟" (سناب، تيك توك، مندوب مبيعات، صديق، أخرى).

رفع المستندات التالية:

صورة/ملف السجل التجاري.

شهادة الرقم الضريبي (إن وجدت).

الهوية.

بعد الإرسال:

حالة الحساب تكون "قيد المراجعة".

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

مهم:

لازم يكون فيه تحقق من رقم الجوال برمز (OTP).

2.5 تسجيل الدخول (Login)

تسجيل دخول برقم الجوال + كلمة المرور.

خيار "إرسال كود تحقق" (OTP login).

نسيان كلمة المرور / إعادة تعيين.

2.6 السلة (Cart)

متاحة فقط للمستخدمين المعتمدين.

تعديل الكميات.

حساب الإجمالي الفرعي + الضريبة (VAT 15%) + الشحن التقديري.

زر "متابعة لإتمام الطلب".

2.7 إتمام الطلب (Checkout)

طرق الدفع المطلوبة:

بوابة دفع إلكترونية (مدى / فيزا / أبل باي).

تحويل بنكي (يظهر رقم الحساب البنكي ويرفع إيصال التحويل البنكي كصورة).

تقسيط (إذا فيه طرف تمويل B2B لاحقاً؛ نحتاج يكون موجود كنموذج خيار حتى لو لا يعمل الآن).

الدفع عند الاستلام (اختياري - يكون إعداد من لوحة التحكم: تشغيل/إيقاف ومدن محددة).

بيانات الشحن:

اختيار عنوان مسجل مسبقاً أو إضافة عنوان جديد (اسم المستلم، المدينة، الحي، الشارع، رقم الجوال، ملاحظات).

بعد تأكيد الطلب:

يتم إنشاء فاتورة/ملخص الطلب ويخزن في حساب العميل.

2.8 الطلبات الخاصة بي (My Orders)

عرض قائمة الطلبات السابقة والحالية.

لكل طلب: التاريخ، المجموع، الحالة الحالية.

الحالات المطلوبة:

قيد المراجعة.

تحت التحضير.

تم الشحن (مع رقم التتبع/شركة الشحن).

مكتمل.

ملغي.

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

2.9 الإشعارات (Notifications)

إشعارات فورية (Push Notifications) عند:

استلام الطلب.

تغيير حالة الطلب.

شحن الطلب.

اكتمال الطلب.

قسم داخل التطبيق "الإشعارات" يحتفظ بالسجل.

لازم يدعم Firebase للأندرويد و APNs للآيفون.

مطلوب تجهيز إمكانية إرسال إشعار واتساب للعميل (WhatsApp Business API أو مزود طرف ثالث) بخصوص حالة الطلب. إذا ما يطبق من البداية، لازم البنية تكون مجهزة للربط.

2.10 الملف الشخصي (Profile / Account)

عرض بيانات الشركة/التاجر.

حالة الحساب: غير موثق / بانتظار المراجعة / معتمد.

إمكانية تحديث المستندات (لو انتهى السجل التجاري يرفع نسخة جديدة).

إدارة عناوين الشحن.

تسجيل خروج.

ملاحظة تصميم:

واجهة التطبيق لازم تكون مرتبة وجميلة ومرتبة بصرياً، ألوان متناسقة، خطوط واضحة، مظهر احترافي تجاري (B2B look).

الدعم الكامل للغة العربية واتجاه RTL.

3. لوحة التحكم (الويب / الـ Admin Panel)

3.1 تسجيل دخول لوحة التحكم

لوحة تحكم ويب (متصفح).

مديرين متعددين (حسابات موظفين).

نظام صلاحيات (Roles & Permissions).

الصلاحيات (أمثلة أدوار):

مدير عام (صلاحيات كاملة).

مسؤول المنتجات (يدير المنتجات والأسعار والمخزون فقط).

مسؤول الطلبات (يتابع ويحدث حالات الطلب).

خدمة العملاء (يشوف العملاء والطلبات بس بدون تعديل أسعار).

محاسب (يشوف المدفوعات والتحويلات البنكية ويؤكدها).

مسؤول أسعار (يعدل الأسعار، بس ما يلمس الإعدادات الحساسة الأخرى).

3.2 لوحة الإحصائيات (Dashboard)

يظهر فيها:

عدد الطلبات الجديدة اليوم.

عدد العملاء الجدد "قيد المراجعة".

إجمالي المبيعات (اليوم / الأسبوع / الشهر).

المنتجات منخفضة المخزون.

3.3 إدارة العملاء / التجار (Customers / Merchants)

قائمة بكل العملاء المسجلين.

حالة كل عميل: مرفوض / بانتظار الموافقة / معتمد.

زر "اعتماد الحساب" أو "رفض".

في حال الاعتماد:

يرسل إشعار فوري للعميل (داخل التطبيق + تجهيز لإرسال واتساب).

إمكانية تعديل بيانات العميل (اسم النشاط، المدينة، الخ).

ملاحظات داخلية غير ظاهرة للعميل (مثل: "هذا عميل مهم" / "سعر خاص").

نقطة مهمة:

الأسعار لازم تظهر فقط لحسابات بحالة "معتمد".

أي حساب غير معتمد لا يرى الأسعار داخل التطبيق.

3.4 إدارة المنتجات (Products)

إضافة منتج جديد / تعديل / حذف.

رفع عدة صور للمنتج.

الحقول المطلوبة لكل منتج:

اسم بالعربي.

اسم بالإنجليزي (نجهز تعدد لغة).

وصف عربي.

وصف إنجليزي.

SKU / باركود.

التصنيف الرئيسي والفرعي.

حالة التوفر (متوفر / غير متوفر / حسب الطلب).

الحد الأدنى للطلب (MOQ).

سعر الجملة.

سعر التجزئة (اختياري).

تكلفة الشراء (معلومات داخلية لا تظهر للعميل).

كمية المخزون الحالية (Stock Qty).

ترتيب المنتج وظهوره في "منتجات مميزة" في الصفحة الرئيسية.

3.5 إدارة التصنيفات (Categories)

إنشاء / تعديل / حذف أقسام وتصنيفات.

قدرة ترتيب الأقسام (Sorting) للتحكم بترتيب الظهور في التطبيق.

3.6 إدارة السلايدر/البنرات (Home Slider / Banners)

إضافة بنر للسلايدر في الصفحة الرئيسية للتطبيق.

لكل بنر:

صورة.

عنوان قصير.

نص قصير.

رابط (منتج محدد أو تصنيف).

حالة (مفعل / غير مفعل).

ترتيب العرض.

التعديل من لوحة التحكم ينعكس فوراً في التطبيق.

3.7 إدارة الطلبات (Orders Management)

قائمة بالطلبات مع فلتر حسب الحالة.

فتح الطلب وعرض تفاصيله (المنتجات، الأسعار، الضريبة، وسيلة الدفع، عنوان الشحن).

تغيير حالة الطلب:

قيد المراجعة → تحت التحضير → تم الشحن → مكتمل → ملغي.

إدخال رقم بوليصة الشحن / اسم شركة الشحن.

إرسال تحديث الحالة للعميل كبوش (Push) وبالواتساب (إذا مفعّل).

طباعة فاتورة الطلب.

حفظ أو تحميل الفاتورة PDF.

3.8 الدفع والتحصيل (Payments)

عرض كل طلب وطريقة دفعه.

للمدفوعات بتحويل بنكي:

عرض صورة الإيصال اللي رفعها العميل.

زر "تم التأكيد" أو "مرفوض".

حقل ملاحظات محاسبية داخلية.

إمكانية تحديد حالة "تم التحصيل المالي".

3.9 الإشعارات / الرسائل العامة (Notifications / Broadcast)

إرسال إشعار يدوي (Push) من لوحة التحكم:

إلى كل العملاء المعتمدين.

أو لعميل محدد.

أو لعملاء مدينة معينة.

أو لعملاء بتصنيف معين (مثلاً كبار المشترين).

رسالة الإشعار تشمل:

عنوان.

نص.

صورة اختيارية.

نفس النظام يكون جاهز/مجهز لدعم إرسال واتساب أيضاً (باستخدام WhatsApp Business API أو مزوّد طرف ثالث). حتى لو ما يشتغل من أول يوم، لازم التصميم البرمجي يسمح بتركيبه لاحقاً بدون إعادة بناء من الصفر.

3.10 الإعدادات العامة (Settings)

بيانات الحساب البنكي للتحويل (اسم البنك، رقم الآيبان، رقم الحساب).

نسبة الضريبة (مثلاً 15% VAT).

حد أدنى للطلب (مثلاً لا يقبل طلب أقل من مبلغ معين).

سياسة الاسترجاع.

الشروط والأحكام.

إعداد تفعيل/إلغاء "الدفع عند الاستلام" ومدنه المسموحة.

3.11 المستخدمين والصلاحيات (Admin Users & Roles)

إضافة مستخدم (موظف) للوحة التحكم.

تحديد صلاحياته صفحة صفحة (مثلاً: يقدر يشوف المنتجات لكن ما يقدر يغير الأسعار).

تسجيل نشاط (Audit Log):

من عدّل الأسعار؟

من حذف منتج؟

من وافق عميل؟

من غيّر حالة طلب؟

هذا مهم لأمان العمل والمتابعة الإدارية.

4. المتطلبات التقنية (Technical Requirements)

4.1 البنية والتقنية

التطبيق موبايل يكون Cross-Platform (مثل Flutter أو React Native) لآيفون وأندرويد من كود واحد.

لوحة التحكم والباك إند تكون Web (مثلاً Laravel / Node.js / Django). المهم: يتم تسليم السورس كود كامل.

قاعدة البيانات مركزية (MySQL أو PostgreSQL).

الـ API تكون RESTful أو GraphQL لكن لازم تكون موثقة (تسليم Postman Collection أو Swagger).

4.2 الأمان

تشفير كلمات المرور (BCrypt أو أقوى).

التحقق من الهوية برقم جوال OTP.

حماية رفع الملفات (الهويات، السجلات التجارية) بحيث الملفات ما تكون متاحة بشكل عام بدون صلاحيات.

منع رفع ملفات تنفيذية ضارة.

فلترة المدخلات/Validation.

4.3 الأداء

التطبيق سريع في التصفح، يدعم آلاف المنتجات.

البحث داخل التطبيق بالاسم أو SKU.

كاش / تحميل تدريجي (lazy loading / pagination).

4.4 اللغة والتصميم

دعم كامل للغة العربية (RTL).

تصميم واجهة احترافية نظيفة تليق بتجار الجملة (B2B look & feel).

Responsive للوحة التحكم (تشتغل حتى من الجوال للمدير).

4.5 الفواتير والضريبة

كل طلب يتم حفظه في النظام مع تفاصيل:

الأسعار.

الخصومات (إن وجدت).

ضريبة القيمة المضافة (VAT 15%).

الإجمالي النهائي.

العميل يقدر يشوف فاتورته من التطبيق.

الإدارة تقدر تطبع الفاتورة PDF من لوحة التحكم.

5. تكامل مع النظام المحاسبي (ERP / Accounting Integration)

نحتاج بنية واضحة تسمح بالربط مع برنامج محاسبي لاحقاً. المطلوب منذ الآن:

الـ Backend يجب أن يوفر API endpoints (وممكن Webhooks) تسمح بما يلي:

إرسال الطلبات الجديدة تلقائياً للنظام المحاسبي الخارجي (كمبيعات).

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

تحديث حالة المخزون في التطبيق إذا تغيرت في المحاسبة.

مهم:

حتى لو الربط الفعلي مع المحاسبة ما راح ينفذ الآن، يجب تجهيز الـ API Layer بشكل منظم وواضح وقابل للتوسع.

نحتاج توثيق الـ API.

6. الإشعارات (Notifications)

متطلبات إلزامية:

إشعار عميل عند إنشاء الطلب.

إشعار عند تغيير حالة الطلب.

إشعار عند الشحن مع رقم التتبع.

إشعار عند اكتمال الطلب.

قنوات الإشعار:

Push Notification داخل التطبيق (Firebase / APNs).

حفظ نسخة في تبويب "الإشعارات" داخل حساب العميل.

تجهيز نقطة تكامل لإرسال رسالة واتساب عبر WhatsApp Business API أو مزود طرف ثالث (رسالة آلية مثل: "طلبك رقم #### تم شحنه مع رقم التتبع ####").

لو ما يتم تفعيل الواتساب من أول يوم، لازم الكود يكون جاهز لإضافته بدون إعادة كتابة النظام كامل.

7. شروط التسليم

المطلوب من المبرمج/الشركة عند التسليم النهائي:

السورس كود كامل للتطبيق (iOS / Android).

السورس كود الكامل للباك إند ولوحة التحكم.

ملف الـ Database (هيكل الجداول + نسخة من قاعدة البيانات).

ملفات التصميم UI/UX (Figma أو XD).

توثيق كامل:

كيفية رفع التطبيقات على App Store و Google Play.

كيفية إعداد الإشعارات (Firebase / APNs).

كيفية إعداد بوابة الدفع.

شرح REST API / Webhooks.

حساب Admin أساسي للوحة التحكم.

صلاحيات المستخدمين (Roles/Permissions) شغّالة.

اللغة العربية شغالة RTL بدون مشاكل.

الفواتير تظهر ضريبة القيمة المضافة بوضوح.

الأسعار لا تظهر لغير العملاء المعتمدين (شرط مهم جداً).

نقطة أخيرة مهمة:

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