نظام التجارة الديناميكي للمؤسسات CPS Enterprise DCS¶
نظام تجارة موزع ذكي مبني على الأحداث¶
نظام CPS Enterprise DCS هو منصة تجارة إلكترونية موزعة تعتمد على بنية الوكلاء الذكيين (Agentic Architecture) مع دعم كامل للعمل دون اتصال بالإنترنت.
المميزات الرئيسية¶
-
:material-source-branch:{ .lg .middle } تخزين الأحداث (Event Sourcing)
جميع التغييرات تُسجل كأحداث غير قابلة للتعديل. مصدر الحقيقة الوحيد للنظام.
-
:material-robot:{ .lg .middle } وكلاء ذكيون مستقلون
ثلاث طبقات من الوكلاء: محلي (Python)، إقليمي (Go/Raft)، ورئيسي للتنسيق العالمي.
-
:material-sync:{ .lg .middle } CRDTs للتزامن بدون تعارض
أنواع بيانات متعددة (GCounter, PNCounter, ORSet, LWWRegister) تضمن التقارب التلقائي.
-
:material-shield-lock:{ .lg .middle } تشفير متعدد الطبقات
تشفير المغلفات (AES-256-GCM) مع إدارة المفاتيح عبر HashiCorp Vault.
-
:material-wifi-off:{ .lg .middle } العمل دون اتصال
كل فرع يعمل بشكل مستقل تماماً ويتزامن تلقائياً عند عودة الاتصال.
-
:material-chart-timeline-variant:{ .lg .middle } مراقبة شاملة
Prometheus + Grafana للمراقبة الفورية مع لوحات تحكم مخصصة.
البنية التقنية¶
┌───────────────────────┐
│ الوكيل الرئيسي │
│ (التنسيق العالمي) │
└───────────┬───────────┘
│
┌───────────────┼───────────────┐
▼ ▼
┌───────────────────┐ ┌───────────────────┐
│ الوكيل الإقليمي │ │ الوكيل الإقليمي │
│ (Go / Raft) │ │ (Go / Raft) │
└───────┬───────────┘ └───────┬───────────┘
│ │
┌───────┼───────┐ ┌───────┼───────┐
▼ ▼ ▼ ▼ ▼ ▼
┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐ ┌───┐
│ و │ │ و │ │ و │ │ و │ │ و │ │ و │
│ م │ │ م │ │ م │ │ م │ │ م │ │ م │
└─┬─┘ └─┬─┘ └─┬─┘ └─┬─┘ └─┬─┘ └─┬─┘
│ │ │ │ │ │
┌─┴─┐ ┌─┴─┐ ┌─┴─┐ ┌─┴─┐ ┌─┴─┐ ┌─┴─┐
│POS│ │POS│ │POS│ │POS│ │POS│ │POS│
└───┘ └───┘ └───┘ └───┘ └───┘ └───┘
و م = وكيل محلي (Python) POS = واجهة نقطة البيع (React)
المكونات التقنية¶
| المكون | التقنية | الوصف |
|---|---|---|
| واجهة نقطة البيع | React 18 + TypeScript | واجهة الكاشير مع دعم العمل دون اتصال |
| لوحة الإدارة | React 19 + Vite 7 | لوحة تحكم إدارية مع shadcn/ui |
| الوكيل المحلي | Python 3.11+ | وكيل حافة يعمل في كل فرع |
| الوكيل الإقليمي | Go 1.21+ | تنسيق إقليمي مع إجماع Raft |
| قاعدة البيانات | PostgreSQL 16 | مخزن أحداث مقسم (8 أقسام) |
| التخزين المؤقت | Redis 7 | تخزين مؤقت وإدارة الجلسات |
| الرسائل | Apache Kafka | بث الأحداث بين المناطق |
| الأمان | HashiCorp Vault | إدارة المفاتيح والتشفير |
| المراقبة | Prometheus + Grafana | مراقبة الأداء والتنبيهات |
البدء السريع¶
# استنساخ المستودع
git clone https://gitlab.com/bumble-ideas-projects/niamimniaCmmPS-Enterprise-Dynamics-Commerce-System-DCS.git
cd CPS-Enterprise-Dynamics-Commerce-System-DCS
# تثبيت جميع التبعيات
make install
# تشغيل البنية التحتية
make docker-up
# تشغيل خوادم التطوير
make dev
نصيحة
راجع دليل التطوير للحصول على تعليمات الإعداد الكاملة.
الروابط السريعة¶
- الهيكلية - البنية التقنية التفصيلية
- واجهة البرمجة - مرجع gRPC API الكامل
- التطوير - دليل إعداد بيئة التطوير
- النشر - خيارات النشر والإنتاج