SH-Supplements

عنوان المشروع:

SH-Supplements | نظام خلفي متكامل (Backend API) لمتجر مكملات غذائية ذكي

وصف المشروع:

نظام خلفي متكامل ومتقدم (Advanced API) مبني ببيئة عمل .NET Core باستخدام هيكلية Clean Architecture ونمط CQRS لضمان أقصى درجات قابلية التوسع والصيانة. المشروع يتجاوز كونه مجرد متجر إلكتروني تقليدي، ليقدم منصة ذكية تدمج بين التجارة الإلكترونية، المتابعة الصحية، وأنظمة التسويق بالعمولة. تم تصميم النظام لمعالجة التحديات البرمجية المعقدة مثل التزامن في المبيعات (Concurrency)، التحديثات اللحظية للمخزون، واكتشاف التعارض الطبي بين المكملات.

التقنيات المستخدمة (Tech Stack):

الإطار البرمجي: ASP.NET Core (.NET 9)

البنية المعمارية: Clean Architecture & CQRS Pattern (باستخدام MediatR)

قواعد البيانات: Entity Framework Core & SQL Server

التقنيات اللحظية: SignalR (لإشعارات المخزون ومواعيد الجرعات)

المهام المجدولة: Hangfire (للتخفيضات التلقائية وإشعارات توفر المنتجات)

بوابات الدفع: Paymob Integration (مع تأمين الـ Webhooks عبر HMAC)

الحماية والمصادقة: JWT Authentication & Role-based Authorization

أبرز المميزات البرمجية والتجارية (Features):

🛍️ 1. نظام تجارة إلكترونية متقدم (E-Commerce Engine):

البيع الآمن (Optimistic Concurrency): نظام صارم يمنع بيع نفس القطعة الأخيرة لمستخدمين في نفس الوقت.

المحفظة الرقمية (Digital Wallet): نظام مالي يسمح بشحن رصيد المستخدم واستخدامه في عمليات الشراء واستقبال عمولات المسوقين.

باقات المنتجات (Smart Bundles): تفكيك باقات المنتجات (Stacks) برمجياً إلى عناصر مفردة في السلة مع تطبيق خصومات ديناميكية.

التخفيضات التلقائية (Dynamic Clearance): نظام خلفي يقوم بخصم أسعار المنتجات التي اقتربت صلاحيتها من الانتهاء تلقائياً وعرضها في قسم الـ Flash Sales.

🛡️ 2. أنظمة الثقة والأمان (Trust & Authenticity):

مكافحة الغش (Anti-Counterfeit): نظام يتيح للمشتري التحقق من موثوقية المنتج عبر فحص "الرقم التسلسلي" مع خوارزمية تمنع تكرار الفحص لمنع استنساخ الباركود.

كاشف التعارض الطبي (Stack Conflict Detection): خوارزمية ذكية تحلل مكونات المنتجات في سلة المشتري وتطلق تحذيرات إذا تجاوزت مجموع المكونات (مثل الكافيين) الحد الطبي اليومي الآمن.

👨‍💼 3. بوابة المدربين والتسويق بالعمولة (Coaches & Affiliates Portal):

نظام مخصص للمدربين لإنشاء أكواد خصم (Promo Codes).

لوحة تحكم للمدرب تتبع استخدام الأكواد وتصب العمولات النقدية تلقائياً في المحفظة الرقمية الخاصة به.

🏋️‍♂️ 4. التخصيص والمتابعة الصحية (Health & Gamification):

التسوق الموجه بالأهداف (Goal-Based Shopping): ترشيح المنتجات ديناميكياً بناءً على هدف المستخدم (تضخيم، تنشيف، الخ).

حاسبات صحية مدمجة: حساب احتياجات الجسم (BMI, BMR, TDEE) وحفظ سجل التطور البدني (Progress Tracker).

نظام التنبيهات اللحظي (SignalR Reminders): إنشاء جدول جرعات تلقائي بمجرد الشراء، وإرسال تنبيهات لحظية للمستخدم بموعد تناول المكمل.

نظام الولاء (Loyalty Points): منح نقاط للمستخدمين عند الشراء أو كتابة مراجعات، يمكن استبدالها في الطلبات المستقبلية.

🔗 5. البدائل الذكية (Smart Dupes):

محرك ربط يقترح منتجات محلية أو أقل سعراً كبديل للمنتجات المستوردة، مع حساب نسبة التوفير (Savings Percentage) لتشجيع العميل على إتمام الشراء.