منصة سوق إلكتروني

المتطلبات الوظيفية (Functional Requirements)

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

.1 نواة النظام الأساسية (Core Kernel)

• نظام متعدد البائعين والمشترين: قدرة النظام على تمييز الأدوار والصلاحيات لكل نوع من المستخدمين (مشتري، بائع، لوجستي، مدير، مدقق).

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

• لوحات تحكم مخصصة: لكل دور واجهة خاصة تعرض المؤشرات والعمليات المناسبة، مع دعم كامل للغة العربية والواجهة من اليمين لليسار (RTL).

.2 وحدة إدارة المنتجات

• إضافة، تعديل، حذف المنتجات (المنتجات، المستلزمات، الأجهزة،المعدات).

• تصنيف هرمي وفقاً لدليل التصنيف الليبي او الدولي (أو نظام تصنيف مخصص).

• إدارة الأسعار متعددة المستويات (سعر الجملة، سعر المورد، سعر المستهلك).

• إدارة المخزون متعدد المستودعات (المستودع المركزي، فروع التوزيع).

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

• دعم طرق إدخال متعددة: يدوي، صوتي (محاكاة بالعربية)، صورة ( OCR، QR، BC ))، استيراد ملف Excel/CSV،مربوط بالترميز الدولي والمحلي.

•

.3 وحدة إدارة الطلبات

• إنشاء طلب شراء عادي (سلة شراء).

• دعم طرق تسجيل النواقص: طلبات سابقة، يدوي، متزامن، صوتي (محاكاة بالعربية)، صورةOCR، QR، BC استيراد ملف Excel/CSV.

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

• دورة حياة الطلب (مسودة، مؤكد، قيد التجهيز، مشحون، مستلم، ملغي).

.4 وحدة المناقصات (Tendering System)

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

• دعوة الموردين: إرسال إشعارات للموردين المؤهلين (عبر البريد الإلكتروني، إشعار داخل التطبيق).

• تقديم العروض: نموذج ديناميكي لإدخال أسعار المنتجات بالدينار الليبي، تاريخ التسليم، الوثائق الفنية (شهادات تحليل، فواتير شراء).

• تقييم العروض: خوارزمية تقييم ذكية تعتمد على معايير قابلة للتخصيص (السعر 50%، الجودة 30%، وقت التسليم 20%، إضافة وزن لأداء المورد التاريخي).

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

.5 وحدة العقود والتوقيع الإلكتروني

• توليد عقود PDF احترافية وفق قوالب معتمدة باللغتين العربية والإنجليزية.

• دمج لوحة توقيع إلكتروني (Signature Pad) لتوقيع العقد من الطرفين (على الأجهزة اللوحية والهواتف).

• أرشفة العقود الموقعة في مخزن آمن (Supabase Storage أو خدمة سحابية).

• إصدار إشعارات ببدء تنفيذ العقد.

.6 وحدة اللوجستيات والتتبع

• إدارة الشحن: إنشاء مهمة توصيل، تعيين سائق/مندوب، تحديد مركبة.

• التتبع الحي (GPS): عرض موقع الشحنة على خريطة تفاعلية (Leaflet + OpenStreetMap) – مع إمكانية العمل دون اتصال بشكل جزئي.

• تحديثات الحالة: خط زمني يوضح مراحل الشحن (Pending → Picked → Shipped → Out for Delivery → Delivered).

• إشعارات: تنبيهات فورية للمشتري والمورد عبر إشعارات الدفع والـ SMS (اختياري).

• تأكيد الاستلام: رقمي عبر رمز QR أو رابط آمن، مع مهلة زمنية (مثلاً 15 دقيقة) لتأكيد الاستلام.

.7 وحدة المدفوعات والفواتير

• بوابات الدفع الإلكتروني: يجب توفير:

o خيار الدفع عند الاستلام (Cash on Delivery).

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

o تكامل مستقبلي مع أي بوابة دفع ليبية (يجب أن تكون البنية قابلة للتوسع).

• الفواتير الإلكترونية: إصدار فاتورة ضريبية مبسطة متوافقة مع متطلبات مصلحة الضرائب الليبية (تتضمن: الرقم الضريبي إن وجد، تفاصيل المنتج، الضريبة 0% حالياً، إجمالي المبلغ).

• سجل مالي وتقارير التحصيل: تقارير بالمبالغ المستلمة والمستحقة لكل مورد/مشتري.

.8 وحدة الذكاء الاصطناعي والتوصيات (اختياري)

• التنبؤ بالطلب: تحليل البيانات التاريخية للتنبؤ بالمخزون المستقبلي (يمكن تنفيذه بسيطاً باستخدام المتوسطات المتحركة).

• التوصيات الذكية: اقتراح منتجات بديلة في حال نفاد المخزون، أو منتجات مكملة.

• تحليل العروض: توليد تقرير مقارنة مع توصية بأفضل عرض.

.9 وحدة التقارير والتحليلات (BI)

• لوحة تحليلية شاملة (Dashboard) تعرض مؤشرات الأداء الرئيسية (KPIs) للمديرين.

• تقارير قابلة للتصدير (PDF, Excel, CSV).

• تحليل أداء الموردين (وقت التسليم، نسبة القبول، جودة المنتج).

.10 ميزات PWA المتقدمة (ضرورية جداً )

• إمكانية تثبيت التطبيق على الشاشة الرئيسية (Add to Home screen) لجميع الأجهزة.

• العمل دون اتصال (Offline First): تخزين البيانات محلياً (IndexedDB) وعرض آخر البيانات المتاحة في حالة انقطاع الإنترنت، مع إنشاء الطلبات والتوقيعات دون اتصال ومزامنتها تلقائياً عند استعادة الاتصال.

• المزامنة التلقائية في الخلفية: باستخدام Service Worker و Background Sync.

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

• أحجام منخفضة للبيانات: تحسين استخدام الباقة، مع تقليل حجم الصور والملفات.رايكم الفني

المتطلبات الخاصة:

• دعم اللغة العربية: اتجاه النص RTL

• خطوط كبيرة: دعم ضعف البصر

• التباين العالي: وضع عالي التباين

• التحكم بالصوت: أوامر صوتية

المتطلبات غير الوظيفية (Non-Functional Requirements)

البند المواصفات المطلوبة

الأداء زمن تحميل الصفحة الرئيسية < 3 ثوانٍ (في متوسط سرعة إنترنت ليبيا). زمن استجابة API < 300 مللي ثانية (لـ 95% من الطلبات). دعم 1,000 مستخدم متزامن في المرحلة الأولى.

التوفر نسبة تشغيل (Uptime) 99.5% (مع توقع انقطاعات محتملة للتيار الكهربائي؛ يجب أن يتعامل النظام معها برشاقة).

الأمان تشفير البيانات أثناء النقل (HTTPS) إلزامي. تشفير البيانات الحساسة في قاعدة البيانات (AES-256). حماية من XSS، CSRF، SQL Injection. مصادقة ثنائية (2FA) اختيارية للمستخدمين. سجل تدقيق لجميع العمليات الحساسة (إنشاء/تعديل/حذف طلبات، عقود، مناقصات).

الامتثال مراعاة القوانين الليبية: قانون مزاولة المهنة ، قانون التجارة الإلكترونية (رقم 9/2013) إن وجد. سياسة الخصوصية وحماية البيانات الشخصية. إمكانية الاحتفاظ بالسجلات المالية لمدة 10 سنوات حسب القانون.

قابلية التوسع بنية قابلة للتوسع أفقياً (Horizontal Scaling) لدعم النمو إلى 10,000 مستخدم. استخدام تقنيات التخزين المؤقت (Redis) لتحسين الأداء.

التوافقية دعم أحدث إصدارات Chrome، Firefox، Safari، Edge على الحاسب والجوال. دعم iOS Safari و Android Chrome مع كامل ميزات PWA.

إمكانية الوصول يُفضل الامتثال لمعايير WCAG 2.1 Level AA لضمان استخدام ذوي الاحتياجات الخاصة.

النسخ الاحتياطي نسخ احتياطي آلي يومي لقاعدة البيانات والملفات. خطة استعادة الكوارث (Disaster Recovery) موثقة.

متطلبات التكامل (Integrations)

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

• بوابات الدفع:

o الدفع عند الاستلام (COD) – إلزامي.

o التحويل البنكي المحلي] – إلزامي (إنشاء أمر دفع، رفع إيصال).

o بوابات مستقبلية: PayTabs معاملات، سداد، مسارات (اختياري).

• شركات الشحن المحلية:

o فانكس، درب السبيل] – تتبع عبر رقم الشحنة (API أو واجهة ويب.

o المدار الجديد] – تتبع.

o آرامكس – إنشاء شحنة وتتبع.

o فيدكس – إنشاء شحنة وتتبع (اختياري).

o مندوبون مستقلون – نظام داخلي لتتبع الموقع عبر الجوال.

• خدمات الإشعارات:

o إشعارات الدفع (Push)] عبر Firebase Cloud Messaging.

o [SMS] مسارات.

o البريد الإلكتروني – عبر SMTP أو خدمة مثل SendGrid يمكن استخدام خادم بريد محلي.

• الخرائط:

o [OpenStreetMap + Leaflet] مجاني ويعمل دون مفتاح API.

o خرائط جوجل (اختياري (بمفتاح API خاص بالجهة الطالبة.

• أنظمة المحاسبة:

o تصدير الفواتير بصيغة PDF] – إلزامي.

o تكامل مع أنظمة محلية مستقبلية – إمكانية توفير API لتصدير البيانات.

• الذكاء الاصطناعي:

o [OpenAI API] اختياري (إذا تم الاتفاق عليه).

o نموذج توصيات بسيط – يمكن بناؤه داخلياً.

متطلبات البنية التحتية والنشر (DevOps)

• نموذج النشر: [✓ حاويات Docker / ✓ خوادم افتراضية (VPS)].

• الاستضافة المفضلة:

o ✓ [خادم محلي داخل ليبيا (المدار...)] – يفضل لتقليل زمن الاستجابة.

o ✓ [خوادم خارجية (AWS / Google Cloud / Hetzner)] – بديل جيد.

o ✓ [استضافة على Hetzner / Contabo] – اقتصادية وموثوقة.

• شبكة توصيل المحتوى (CDN): [✓ Cloudflare] – مجاني ويحسن السرعة.

• المراقبة والتنبيه: استخدام أدوات مثل [✓ Sentry / ✓ UptimeRobot] لتتبع الأخطاء والأداء.

• النشر المستمر: إعداد خط أنابيب (CI/CD) باستخدام [✓ GitHub Actions / ✓ GitLab CI].

• بيئة اختبار مستقلة: يجب توفير بيئة (Staging) مطابقة للإنتاج للاختبار قبل النشر.

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

متطلبات الوثائق والتسليمات

مع نهاية المشروع، يجب تسليم:

1. وثيقة تصميم النظام (System Architecture Document) – رسومات توضح المكونات وتفاعلاتها.

2. مخطط قاعدة البيانات (ERD) – موثق بالكامل.

3. توثيق واجهات برمجة التطبيقات (API Documentation) – باستخدام Swagger/OpenAPI، مع أمثلة عملية.

4. دليل المستخدم (User Manual) – باللغتين العربية والإنجليزية (PDF و HTML تفاعلي) – مع التركيز على دليل الاستخدام السريع للصيادلة والموردين.

5. دليل النشر (Deployment Guide) – خطوات كاملة لتشغيل النظام على خادم جديد (سواء محلي أو سحابي).

6. كود المصدر الكامل – على مستودع (GitHub/GitLab) خاص، مع صلاحية وصول كاملة.

7. خطة الاختبار وتقارير الجودة – توضح تغطية الاختبارات الآلية ونتائج اختبارات الأداء والأمان.

8. فيديو تعريضي (اختياري) – شرح سريع للمنصة وميزاتها.

استراتيجية الاختبار وضمان الجودة

نوع الاختبار المتطلبات الدنيا

اختبارات الوحدة (Unit Tests) نسبة تغطية لا تقل عن 70% للوحدات البرمجية الحرجة (المنطق التجاري، التكاملات).

اختبارات التكامل (Integration Tests) تغطية جميع واجهات برمجة التطبيقات (API) وسيناريوهات التدفق الرئيسية.

اختبارات الأداء والتحميل استخدام أداة (k6 أو JMeter) لمحاكاة 1000 مستخدم متزامن، مع تقرير النتائج.

اختبارات الاختراق (Penetration Testing) تقرير من أداة معترف بها (OWASP ZAP، Burp Suite) يوثق الثغرات وعلاجها.

اختبارات قبول المستخدم (UAT) فترة أسبوعين على الأقل بمشاركة مستخدمين حقيقيين من صيادلة وموردين في ليبيا.

ملخص متطلبات النظام الأساسية

نظام المصادقة والأمان

REQ-AUTH-001: نظام تسجيل دخول متعدد العوامل

• دعم تسجيل الدخول بالبريد/الهاتف

• المصادقة الثنائية 2FA

• إدارة الجلسات

• تجديد التوكن التلقائي

• تسجيل دخول اجتماعي (Google, Apple)

REQ-AUTH-002: إدارة الصلاحيات الديناميكية

• مجموعات صلاحيات قابلة للتخصيص

• تفويض صلاحيات مؤقت

• سجل أنشطة المستخدمين

• كشف الأنشطة المشبوهة

إدارة الملفات الشخصية

REQ-PROF-001: ملف المستهلك

• معلومات الرخصة والتسجيل

• ساعات العمل

• العناوين المتعددة

• تفضيلات التواصل

• سجل المشتريات

REQ-PROF-002: ملف المورد

• الشهادات والتراخيص

• نطاق التغطية الجغرافية

• سعة التخزين

• سياسات الإرجاع

• تقييمات الأداء

```

متطلبات المشتريات والمناقصات

إدارة الطلبات

ربط قاعدة بيانات المنتجات بنظام الباركود الدولي او المحلي GS1

متطلبات النظام

REQ-ORD-001: إنشاء طلب متعدد الوسائط

• إدخال صوتي مع تحويل للنص

• تحميل صورة مع تقنية OCR

• إدخال يدوي مع اقتراحات ذكية

• استيراد من ملف Excel/CSV

REQ-ORD-002: سلة طلبات ذكية

• حفظ مؤقت لمدة 24 ساعة

• مقارنة الأسعار التلقائية

• اقتراح بدائل للناقص

• حساب التكلفة الإجمالية

REQ-ORD-003: تأكيد الطلب

• تأكيد تلقائي قبل الساعة 8 ص

• إشعارات عبر SMS/Email/Push

• خيارات الدفع المتعددة

• إشعار النقص من الموردين

```

نظام المناقصات

متطلبات المناقصات التفصيلية:

تجميع الطلبات في قائمة موحدة وانشاء مناقصات أئمة على المنتجات

REQ-TND-001: إنشاء المناقصة

• قوالب مناقصات قابلة للتخصيص

• تحديد المنتجات والكميات

• شروط الجودة والمواصفات

• جدول زمني واضح

• معايير التقييم المحددة مسبقاً

REQ-TND-002: إدارة العروض

• تقديم العروض إلكترونياً

• ختم زمني للعروض

• إمكانية تعديل العرض قبل الإغلاق

• عرض العروض بشكل مجهول

• نظام الأسئلة والأجوبة

REQ-TND-003: تحليل العروض

• مقارنة الأسعار تلقائياً

• تقييم الموردين التاريخي

• تحليل مخاطر المورد

• تقارير التوفير المتوقعة

• توصيات الذكاء الاصطناعي

```

متطلبات اللوجستيات والتوزيع

إدارة التوزيع

REQ-LOG-001: نماذج التوزيع المتعددة

• التوزيع المركزي: مركز تجميع رئيسي

• التوزيع المباشر: من المورد للمستهلك

• التوزيع الهجين: عبر مستودعات وسيطة

REQ-LOG-002: تخطيط المسارات

• تحسين المسارات بناءً على:

- مواقع التسليم

- أحجام الشحنات

- مواعيد التسليم

- ازدحام المرور

• تخصيص المركبات والسائقين

• جدولة زمنية دقيقة

REQ-LOG-003: التتبع الحي

• خرائط تفاعلية

• تحديثات الموقع كل 30 ثانية

• تنبيهات التأخير

• إشعارات الاقتراب من التسليم

• مشاركة رابط التتبع مع العميل

التسليم والاستلام

REQ-DEL-001: عملية التسليم

• مسح QR code عند التسليم

• تأكيد الهوية

• صور توثيقية

• توقيع إلكتروني

• ختم زمني رقمي

REQ-DEL-002: استلام

• مهلة 15 دقيقة للتأكيد

• عد المنتجات المادية

• الإبلاغ عن النقص/التلف

• إضافة ملاحظات

• تقييم جودة التسليم

REQ-DEL-003: التسوية

• تحديث المخزون تلقائياً

• إنشاء الفاتورة

• بدء عملية الدفع

• إشعارات الاستلام

• تحديث حالة الطلب

متطلبات المدفوعات والمحاسبة

لنظام المالي

REQ-FIN-001: الفواتير الإلكترونية

• إنشاء فواتير معتمدة

• مطابقة الفواتير مع الطلبات

• خصومات وضرائب

• سندات القبض والإرجاع

• أرشفة الفواتير

REQ-FIN-002: المدفوعات

• دفعات آجلة

• مدفوعات فورية

• محفظة إلكترونية

• تحويلات بنكية

• مدفوعات عند الاستلام

• تقسيط المدفوعات

REQ-FIN-003: التقارير المالية

• تقارير المبيعات والمشتريات

• تحليل الربحية

• تقارير التدفق النقدي

• كشف الحسابات

• إقرارات ضريبية

```