حاسبة منتجات منزلية ذكية

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

1.1 الوظائف الأساسية

جمع البيانات من المستخدم:

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

معالجة البيانات وإجراء الحسابات:

يجب أن يقوم النظام بمعالجة البيانات المدخلة باستخدام مجموعة من المعادلات الرياضية المدروسة والمعاملات المؤثرة. هذه المعالجة تتضمن حسابات أساسية للكميات المطلوبة مع تطبيق معاملات تعديل بناءً على الظروف الخاصة لكل أسرة.

تقديم التوصيات الذكية:

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

1.2 متطلبات واجهة المستخدم

التصميم والتخطيط:

يجب أن تكون الواجهة مصممة خصيصاً للمستخدمين العرب مع دعم كامل للغة العربية من اليمين إلى اليسار. التصميم يجب أن يكون بديهياً وسهل الاستخدام مع تدرج منطقي في الأسئلة والخطوات.

التفاعل والاستجابة:

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

1.3 متطلبات المحتوى

قاعدة بيانات المنتجات:

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

المعادلات والخوارزميات:

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

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

2.1 تقنيات الواجهة الأمامية (Frontend)

التقنيةالإصدار المطلوبالغرضReact18.0+إطار العمل الأساسي للواجهةTypeScript5.0+لضمان جودة الكود وتقليل الأخطاءTailwind CSS3.4+نظام التصميم والأنماطFramer Motion11.0+الرسوم المتحركة والتفاعلاتReact Hook Form7.0+إدارة النماذج والتحقق من البياناتAxios1.6+التواصل مع الخوادم والـ APIs

2.2 تقنيات الخادم الخلفي (Backend)

التقنيةالإصدار المطلوبالغرضNode.js20.0+بيئة تشغيل الخادمExpress.js4.18+إطار عمل الخادمMongoDB7.0+قاعدة البيانات الأساسيةMongoose8.0+التفاعل مع قاعدة البياناتJWT9.0+المصادقة والأمانJoi17.0+التحقق من صحة البيانات

2.3 خدمات الذكاء الاصطناعي

OpenAI API Integration:

يجب تكامل النظام مع OpenAI API لتوفير حسابات ذكية متقدمة. هذا التكامل يتطلب إعداد مفاتيح API آمنة وإدارة الطلبات بكفاءة لتجنب تجاوز الحدود المسموحة.

Prompt Engineering:

يجب تطوير مجموعة من النصوص التوجيهية (Prompts) المحسنة للحصول على أفضل النتائج من نموذج الذكاء الاصطناعي. هذه النصوص يجب أن تكون مصممة خصيصاً للسوق السعودي والثقافة المحلية.

2.4 متطلبات قاعدة البيانات

هيكل البيانات:

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

الأداء والفهرسة:

يجب إنشاء فهارس مناسبة لضمان سرعة الاستعلامات خاصة عند البحث في المنتجات والحسابات السابقة. كما يجب تحسين الاستعلامات لتقليل وقت الاستجابة.

3. متطلبات الأداء (Performance Requirements)

3.1 سرعة الاستجابة

المقياس المتطلب الملاحظات تحميل الصفحة الأولى أقل من 2 ثانية على اتصال 4G عادي معالجة الحسابات أقل من 3 ثواني للحسابات البسيطة الحسابات المتقدمة (AI)أقل من 10 ثواني مع OpenAI APIتحديث الواجهة أقل من 100 مللي ثانية للتفاعلات المحلية

3.2 قابلية التوسع

عدد المستخدمين المتزامنين:

يجب أن يدعم النظام ما لا يقل عن 1000 مستخدم متزامن في المرحلة الأولى مع إمكانية التوسع إلى 10,000 مستخدم متزامن خلال السنة الأولى.

حجم البيانات:

يجب أن يكون النظام قادراً على التعامل مع قاعدة بيانات تحتوي على مليون حساب مستخدم و100,000 منتج دون تأثير ملحوظ على الأداء.

3.3 متطلبات الموثوقية

وقت التشغيل (Uptime):

يجب أن يحقق النظام معدل تشغيل لا يقل عن 99.5% شهرياً، مما يعني عدم توقف يزيد عن 3.6 ساعات في الشهر.

استرداد البيانات:

يجب إجراء نسخ احتياطية يومية لقاعدة البيانات مع إمكانية الاسترداد الكامل خلال 4 ساعات في حالة الطوارئ.

4. متطلبات الأمان (Security Requirements)

4.1 حماية البيانات

تشفير البيانات:

يجب تشفير جميع البيانات الحساسة باستخدام معايير AES-256 أثناء التخزين وTLS 1.3 أثناء النقل. هذا يشمل معلومات المستخدمين الشخصية ونتائج الحسابات.

إدارة كلمات المرور:

في حالة إضافة نظام تسجيل دخول مستقبلاً، يجب استخدام خوارزميات تشفير قوية مثل bcrypt مع salt عشوائي لحماية كلمات المرور.

4.2 التحقق من البيانات

التحقق من المدخلات:

يجب التحقق من صحة جميع البيانات المدخلة من المستخدمين على مستوى الواجهة والخادم لمنع هجمات الحقن والبيانات الضارة.

حدود المعدل (Rate Limiting):

يجب تطبيق حدود على عدد الطلبات المسموحة لكل مستخدم لمنع إساءة الاستخدام والهجمات المحتملة.

4.3 الخصوصية

سياسة الخصوصية:

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

إخفاء الهوية:

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

5. متطلبات التكامل مع منصة ذخر

5.1 التكامل مع قاعدة بيانات المنتجات

API المنتجات:

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

تحديث البيانات:

يجب أن يتم تحديث معلومات المنتجات بشكل دوري (كل 6 ساعات على الأقل) لضمان دقة التوصيات والأسعار.

5.2 التكامل مع نظام الطلبات

إنشاء السلة:

يجب أن يتمكن المستخدمون من إضافة المنتجات الموصى بها مباشرة إلى سلة التسوق في تطبيق ذخر.

تتبع التحويلات:

يجب تتبع عدد المستخدمين الذين يقومون بالشراء بعد استخدام الحاسبة لقياس فعالية النظام.

5.3 التكامل مع أنظمة ذخر الموجودة

النظام نوع التكامل لبيانات المتبادلةOdoo (المحاسبة)REST APIبيانات المبيعات والتحليلاتMy Fatoorah (الدفع)Webhookحالة الطلبات والمدفوعاتFlexstock (الشحن)APIمعلومات المخزون والتوفر تطبيق ذخر الجوالDeep Linkingانتقال سلس للمنتجات

6. متطلبات البنية التحتية (Infrastructure Requirements)

6.1 متطلبات الخادم

المواصفات الأساسية:

يجب أن يكون الخادم مزوداً بمعالج لا يقل عن 8 أنوية و32 جيجابايت من الذاكرة العشوائية و500 جيجابايت من التخزين SSD لضمان الأداء المطلوب.

نظام التشغيل:

يُفضل استخدام Ubuntu Server 22.04 LTS أو CentOS 8 مع التحديثات الأمنية المنتظمة.

6.2 الاستضافة السحابية

الخيارات الموصى بها:

المزود الخطة المقترحة التكلفة الشهريةالمميزاتAWSEC2 t3.large + RDS200-300$موثوقية عالية، خدمات متكاملةGoogle CloudCompute Engine + Cloud SQL180-250$أداء ممتاز، تكامل مع AIMicrosoft AzureVirtual Machine + Database190-280$دعم ممتاز، أمان عالي محلي (STC Cloud)خادم افتراضي متوسط800-1200 ريال دعم محلي، امتثال للقوانين

6.3 شبكة توصيل المحتوى (CDN)

التوزيع الجغرافي:

يجب استخدام CDN مع نقاط توزيع في المملكة العربية السعودية ودول الخليج لضمان سرعة تحميل مثلى للمستخدمين المحليين.

التخزين المؤقت:

يجب تكوين التخزين المؤقت للملفات الثابتة (CSS, JS, الصور) لمدة 30 يوماً مع إعدادات تحديث ذكية.

7. متطلبات المراقبة والتحليل

7.1 مراقبة الأداء

المقاييس المطلوبة:

يجب مراقبة مقاييس الأداء الأساسية مثل وقت الاستجابة واستخدام الذاكرة ومعدل الأخطاء بشكل مستمر مع إنذارات فورية عند تجاوز الحدود المقبولة.

أدوات المراقبة:

يُنصح باستخدام أدوات مثل New Relic أو DataDog أو Prometheus مع Grafana لمراقبة شاملة للنظام.

7.2 تحليل سلوك المستخدمين

تتبع الاستخدام:

يجب تتبع كيفية تفاعل المستخدمين مع الحاسبة بما في ذلك الأسئلة الأكثر تخطياً ومعدلات الإكمال.

تحليل التحويلات:

يجب قياس معدل تحويل المستخدمين من استخدام الحاسبة إلى إجراء عمليات شراء فعلية.

8. متطلبات الاختبار (Testing Requirements)

8.1 اختبار الوحدة (Unit Testing)

تغطية الكود:

يجب أن تحقق اختبارات الوحدة تغطية لا تقل عن 80% من الكود مع التركيز على الوظائف الحسابية الأساسية.

أدوات الاختبار:

يُنصح باستخدام Jest للاختبارات في JavaScript و React Testing Library لاختبار مكونات الواجهة.

8.2 اختبار التكامل

اختبار APIs:

يجب اختبار جميع نقاط الاتصال مع الأنظمة الخارجية بما في ذلك OpenAI API وأنظمة ذخر.

اختبار قاعدة البيانات:

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

8.3 اختبار الأداء

اختبار الحمولة:

يجب إجراء اختبارات حمولة لمحاكاة 1000 مستخدم متزامن واختبار استجابة النظام.

اختبار الضغط:

يجب اختبار النظام تحت ضغط يفوق الحمولة المتوقعة لتحديد نقاط الفشل المحتملة.

9. متطلبات النشر والصيانة

9.1 استراتيجية النشر

النشر التدريجي:

يُنصح بنشر النظام على مراحل بدءاً بمجموعة محدودة من المستخدمين ثم التوسع تدريجياً.

النسخ الاحتياطية:

يجب إنشاء نسخة احتياطية كاملة قبل كل عملية نشر مع خطة استرداد واضحة.

9.2 الصيانة الدورية

التحديثات الأمنية:

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

تحسين الأداء:

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

9.3 الدعم الفني

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

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

التوثيق:

يجب إنشاء وثائق فنية شاملة للنظام تشمل دليل المطور ودليل المستخدم ودليل استكشاف الأخطاء.