Blurz Ecommerce Platform

🛒 Blurz Commerce — وصف المشروع للبورتفوليو

---

نظرة عامة

Blurz Commerce هو نظام خلفي متكامل (Backend) لمتاجر التجارة الإلكترونية، مبني ليكون قابلاً للتوسع ومخصصاً للبيئات الإنتاجية (Production-Grade). النظام يدير كل شيء من كتالوج المنتجات إلى سلة المشتريات، الدفع، الاشتراكات الدورية، وحتى المراقبة الشاملة لأداء النظام (Observability).

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

---

المشكلة التي يحلها المشروع

بناء نظام خلفي لتجارة إلكترونية من الصفر يستغرق شهوراً طويلة والعديد من الفرق تفشل في تنفيذه بشكل صحيح بسبب:

- تكامل الدفع: يستغرق أسابيع من ضبط الـ Webhooks لتجنب الأخطاء

- الاشتراكات الدورية: أنظمة إعادة المحاولة (Dunning) معقدة برمجياً

- العملات المتعددة: إدارة أسعار الصرف تتطلب بنية مرنة

- شراء الزوار (Guest Checkout): مهم جداً لرفع المبيعات ولكنه معقد في ربط الطلبات لاحقاً

- مراقبة الأداء (Observability): غالباً ما يتم تجاهلها مما يؤدي لصعوبة تتبع الأخطاء عند إطلاق المشروع

Blurz Commerce يأتي كحل جاهز ومختبر يعالج كل هذه التحديات مباشرة.

---

الميزات الرئيسية

🛍️ كتالوج المنتجات (Catalog)

- إدارة كاملة للمنتجات، الفئات، العلامات التجارية، والصور

- دعم للمتغيرات (Variants) كالأحجام والألوان

- محرك بحث قوي يعتمد على Elasticsearch للبحث السريع والمتقدم

🛒 سلة المشتريات والطلبات

- سلة مشتريات محفوظة (Persistent Carts)

- قسائم خصم (Coupons) وحملات ترويجية

- دعم العملات المتعددة (Multi-Currency) مع أسعار صرف مرنة

- ميزة "شراء الزائر" (Guest Checkout) مع إمكانية ربط الطلب بحساب المستخدم لاحقاً

💳 الدفع والفوترة (Payments)

- تكامل عميق مع Stripe (PaymentIntents و Webhooks)

- حفظ طرق الدفع بأمان للاستخدام المستقبلي

- حماية ضد تكرار الدفع (Idempotency)

- توليد فواتير إلكترونية بصيغة PDF تلقائياً

🔄 الاشتراكات الدورية (Subscriptions)

- نظام فوترة دورية (Recurring Billing)

- إمكانية إيقاف، استئناف، أو تخطي الاشتراكات

- نظام متابعة المدفوعات المتأخرة وإعادة المحاولة التلقائية (Dunning)

🎁 الولاء وبطاقات الهدايا

- نظام نقاط ولاء متكامل للمستخدمين

- بطاقات هدايا رقمية ورصيد متجر (Store Credit)

- إمكانية تكديس الخصومات (Stackable Discounts)

🔐 الأمان والمصادقة (Auth)

- تسجيل دخول آمن باستخدام JWT

- تشفير كلمات المرور باستخدام خوارزمية Argon2

- المصادقة الثنائية (MFA / TOTP)

- تسجيل الدخول عبر Google و Facebook (OAuth)

📧 نظام البريد الإلكتروني والمهام

- إرسال رسائل التحقق وإعادة تعيين كلمة المرور

- حملات استعادة سلة المشتريات المتروكة (Abandoned Cart Recovery)

- معالجة المهام الثقيلة في الخلفية باستخدام ARQ و Redis

---

البنية التقنية (Architecture & Stack)

هذا المشروع مصمم ليكون "نظاماً يضاهي أنظمة الشركات الكبرى" (Enterprise-level Architecture):

الواجهة البرمجية (API)

- FastAPI (Python 3.12) كإطار عمل رئيسي عالي الأداء

- SQLAlchemy 2.0 للتعامل مع قاعدة البيانات بشكل غير متزامن

- Pydantic للتحقق من صحة البيانات (Data Validation)

قواعد البيانات والتخزين

- PostgreSQL كقاعدة بيانات رئيسية متينة

- Redis للكاشينج (Caching)، الحد من الطلبات (Rate Limiting)، وإدارة طابور المهام

- Elasticsearch كمحرك بحث متقدم للمنتجات

المهام الخلفية (Background Workers)

- ARQ كمدير مهام غير متزامنة خفيف وسريع يعتمد على Redis

📊 المراقبة الشاملة (Full Observability)

النظام مزود ببيئة مراقبة متكاملة (مضمنة عبر Docker) لتتبع كل جزء من التطبيق:

- Prometheus: لجمع مقاييس الأداء (Metrics)

- Grafana: لوحات تحكم مرئية لمراقبة صحة النظام

- Loki: لتجميع وتحليل السجلات (Log Aggregation)

- Tempo: لتتبع مسار الطلبات بين الخدمات (Distributed Tracing)

- OpenTelemetry: لمعايرة وتتبع الأكواد البرمجية تلقائياً

بنية الخدمات الدقيقة (Microservices)

يحتوي المشروع على خدمة مصغرة منفصلة (Payment Microservice) مخصصة فقط للتعامل مع مدفوعات Stripe، مما يضمن أمان وموثوقية عمليات الدفع بعيداً عن ضغط المتجر الرئيسي.

---

كيف يعمل؟ (النشر والتشغيل)

- Docker Compose: يتم تشغيل النظام بأكمله (قاعدة البيانات، الواجهة البرمجية، الكاش، محرك البحث، وأدوات المراقبة التسعة) بأمر واحد فقط docker compose up.

- Alembic: يدير تحديثات قاعدة البيانات بشكل آمن وتلقائي.

- الاختبار (Testing): تغطية اختبار شاملة باستخدام Testcontainers لضمان عمل النظام ضد قاعدة بيانات حقيقية قبل الإطلاق.

---

الرابط والتقنيات

- ⚙️ التقنيات الرئيسية: Python, FastAPI, PostgreSQL, Redis, Elasticsearch, Docker

- 💳 المدفوعات: Stripe API

- 📈 المراقبة (Observability): Grafana, Prometheus, Loki, Tempo

- 📄 الترخيص: MIT

---

ملاحظة: هذا المشروع يُبرز مهارات متقدمة في تصميم الأنظمة الخلفية (Backend Architecture). بدلاً من مجرد بناء "تطبيق بسيط"، يوضح هذا النظام كيفية التعامل مع تحديات العالم الحقيقي مثل: معالجة المدفوعات بأمان، المهام غير المتزامنة، البحث السريع، مراقبة أداء الخوادم، وهندسة قواعد البيانات المعقدة للتجارة الإلكترونية.