نظرة عامة
قطعتي مرجع رقمي متخصص في توافقات قطع غيار الهواتف، صُمم لتسهيل وصول فنيي الصيانة إلى الأجهزة والموديلات التي يمكن أن تتشارك القطعة نفسها، مع منظومة إدارية لإدارة البيانات والمستخدمين والاشتراكات.
التحديات تمثيل علاقات التوافق بين الجهاز ونوع القطعة والأجهزة البديلة بصورة قابلة للبحث والتوسع. حماية بيانات الخدمة عبر حساب مستخدم موثق ومرتبط بجهاز محدد واشتراك ساري أو فترة تجريبية. استيراد كميات كبيرة من بيانات التوافق المنظمة في ملفات Excel مع الحفاظ على ترابطها داخل قاعدة البيانات. توفير تجربة عربية وإنجليزية تشمل البحث والمفضلة والإعدادات وحالات الاتصال والأخطاء. منح الإدارة رؤية تشغيلية حول المستخدمين والإيرادات والاشتراكات وجودة بيانات الأجهزة والعلامات. الحل
اعتمد تطبيق الهاتف على Flutter مع BLoC ومستودعات بيانات وحقن اعتماد، واستخدم Dio للاتصال بالخلفية مع تخزين آمن للرموز وذاكرة محلية للإعدادات والمفضلة والبيانات المؤقتة.
في الخلفية، قُسمت الوظائف إلى وحدات للمصادقة والعلامات والأجهزة والبحث والتوافقات والاشتراكات والإدارة، مع حراس منفصلين للمستخدم والمدير، وقفل الجهاز، والتحقق من الاشتراك.
تتولى لوحة React إدارة البيانات الأساسية والخطط والحسابات، وتدعم الاستيراد من Excel، ومراجعة مشكلات الجودة، وسجل الإجراءات.
البنية التقنية
يتصل تطبيق أندرويد بواجهة REST موثقة عبر Swagger وOpenAPI، وتستخدم الخلفية NestJS وTypeScript فوق PostgreSQL وKnex.js.
تتضمن قاعدة البيانات فهارس للبحث النصي باستخدام pg_trgm، بينما تُبنى لوحة الإدارة بواسطة React وVite، وتُنشر الواجهات والخدمات عبر Docker وNGINX ضمن إعدادات جاهزة للعمل خلف وكيل عكسي.
الوحدات الأساسية التسجيل وتسجيل الدخول وتجديد الرموز وربط الحساب بالجهاز. العلامات التجارية والأجهزة وأنواع القطع وعلاقات التوافق. البحث المباشر والاقتراحات والبحث العكسي داخل الأجهزة المتوافقة. الاشتراكات والخطط والفترة التجريبية وسجل الاشتراك. المفضلة وعمليات البحث الحديثة واللغة والمظهر ومراقبة الاتصال. لوحة المؤشرات وإدارة المستخدمين والاشتراكات والاستيراد وجودة البيانات وسجل العمليات. النتائج
يقدم السورس منظومة مترابطة تجمع تطبيق الهاتف وواجهة الإدارة والخلفية وقاعدة البيانات، مع حماية لمسارات الاستخدام المدفوعة، وأدوات تشغيل لتحديث بيانات التوافق، واختبارات تغطي المصادقة والبحث والمفضلة والإعدادات والاشتراكات ومسارات API الرئيسية.
