ConnectFlow Messenger — مراسلة فورية
منصة تواصل فورية تدعم النص والصور والصوت والملصقات، بمصادقة JWT وبنية Docker + CI/CD.
ملخص المشروع
ConnectFlow Messenger منصة مراسلة كاملة مبنية لتكون مرجعًا جاهزًا للإنتاج، مع مصادقة آمنة ودعم متعدد الوسائط وبنية حاويات.
المشكلة
معظم مشاريع المراسلة التعليمية تنجح في إظهار رسالة على الشاشة، ثم تتوقف عند أول سؤال حقيقي: كيف تُبنى منصة يمكن نشرها فعليًا وتشغيلها بأمان واستمرار؟ الفجوة ليست في واجهة المحادثة، بل في الطبقات التي لا تُرى: المصادقة، إدارة الجلسات، بنية النشر، والاختبار تحت ضغط.
ConnectFlow Messenger بُني ليعبر هذه الفجوة: منصة مراسلة فورية بمصادقة JWT وجلسات متجددة، وبنية حاويات Docker مع خط نشر آلي (CI/CD)، بحيث يصبح "التشغيل" خطوة موثّقة لا تجربة شخصية.
المزايا الرئيسية
محادثات فورية
رسائل لحظية.
دعم الوسائط
صور، صوت، ملفات، ملصقات.
JWT
رموز قصيرة العمر مع refresh.
Docker جاهز
Docker Compose.
CI/CD
اختبار ونشر آلي.
بنية قابلة للتوسع
فصل الخدمات.
التحديات التقنية وقرارات التصميم
- المصادقة بين الأمان والملاءمة: رمز وصول قصير العمر يحمي الحساب لكنه يقطع الجلسة على المستخدم. الحل كان رمز وصول قصير + رمز تحديث (refresh) يُدار بحذر، مع تسجيل خروج فعلي عند إبطال الجلسة.
- سلامة التسليم الفوري: الاتصال المباشر (WebSocket) يفقد الرسائل عند انقطاع الشبكة. أُضيف التعامل مع الانقطاع وإعادة الاتصال التلقائي، مع إبقاء حالة الرسالة ظاهرة للمستخدم.
- نشر قابل للتكرار: تشغيل المشروع على جهاز المطوّر لا يعني أنه قابل للنشر. تغليف البنية في Docker مع خط CI/CD حوّل النشر من خطوات يدوية إلى خطوة واحدة متكررة.
- الاختبار تحت التزامن: الأخطاء الحقيقية في أنظمة المراسلة تظهر عند تزامن المستخدمين لا في الاستخدام الفردي، لذلك كان اختبار التزامن جزءًا من التطوير لا مرحلة تالية.
البنية التقنية
منهجية الاختبار
- اختبار مسار المصادقة كاملًا: تسجيل، دخول، انتهاء صلاحية الرمز، تجديد الجلسة، وتسجيل الخروج.
- اختبار قطع الاتصال أثناء المحادثة والتحقق من إعادة الاتصال واستمرار تسليم الرسائل بعد العودة.
- اختبار تزامن عدة مستخدمين متصلين في آن واحد للتأكد من ثبات حالة الرسائل.
- التحقق من أن نشرًا نظيفًا من الصفر يعمل بنفس الخطوات الموثّقة دون أي إعداد يدوي إضافي.
- مراجعة الواجهة في الوضعين الفاتح والداكن وعلى أحجام شاشات مختلفة.
النتيجة والأثر
- منصة مراسلة فورية بمصادقة مُحكمة وجلسات متجددة تعمل في بيئة حاويات.
- نشر بنقرة واحدة عبر خط CI/CD بدل خطوات يدوية موثّقة بالأخطاء.
- مستودع عام موثَّق يصلح كمرجع لفريق يعمل على نفس النمط المعماري.
المشروع منشور برخصة MIT؛ يمكن مراجعة الكود وبنية النشر مباشرة من المستودع.