chat.io

chat.io

تطبيق دردشة في الوقت الفعلي تم تصميمه باستخدام Node.js وExpress وMongoose وSocket.io وPassport وRedis.

فِهرِس

• تجريبي
• سمات
• تثبيت
• كيف يعمل
• يدعم
• يساهم
• رخصة

تجريبي

تحقق من العرض التوضيحي

سمات

• يستخدم Express كإطار عمل للتطبيق.
• يدير الجلسات باستخدام حزمة الجلسة السريعة.
• المصادقة عبر اسم المستخدم وكلمة المرور باستخدام Passport.
• يتم تجزئة كلمات المرور باستخدام حزمة bcrypt-nodejs.
• المصادقة الاجتماعية عبر Facebook وTwitter باستخدام Passport.
• التواصل في الوقت الحقيقي بين العميل والخادم باستخدام Jack.io.
• يستخدم MongoDB وMongoose وMongoLab(mLab) لتخزين البيانات والاستعلام عنها.
• يخزن الجلسة في MongoDB باستخدام Connect-mongo؛ مخزن جلسة يستند إلى MongoDB.
• يستخدم Redis كمحول لـSocket.io.
• تسجيل الأخطاء والاستثناءات باستخدام Winston.

تثبيت

تشغيل محليا

تأكد من تثبيت Node.js وnpm.

1. استنساخ أو تنزيل المستودع

   chat.io">

    $ git clone https://github.com/OmarElGabry/chat.io.git
   $ cd chat.io
   

2. تثبيت التبعيات

    $ npm install
   

3. قم بتحرير ملف التكوين في app/config/config.json باستخدام بيانات الاعتماد الخاصة بك (راجع تكوينات الإعداد).

4. تنزيل وتثبيت ريديس.

5. تشغيل خادم Redis (كمسؤول)

    $ redis-server
   

6. ابدأ التطبيق

    $ npm start
   

من المفترض أن يعمل تطبيقك الآن على المضيف المحلي:3000.

النشر إلى Heroku

تأكد من تثبيت Heroku Toolbelt.

1. قم بإنشاء تطبيق Heroku جديد، وادفع تطبيق الدردشة الخاص بك إلى مستودع Git البعيد

    $ heroku create
   $ git push heroku master
   

   أو

2. الآن، تحتاج إلى إعداد متغيرات التكوين على Heroku.

   1. انتقل إلى الإعدادات -> كشف Config Vars.
   2. إضافة متغيرات التكوين. جميع المتغيرات المطلوبة موجودة داخل app/config/index.js . عادةً، هذه هي متغيرات التكوين التي تحتاج إلى تعيينها: { dbURI, sessionSecret, facebookClientID, facebookClientSecret, twitterConsumerKey, twitterConsumerSecret } (راجع تكوينات الإعداد).

3. الخطوة الأخيرة هي إضافة Redis كوظيفة إضافية على Heroku.

   1. انتقل إلى الموارد -> الوظائف الإضافية
   2. حدد هيروكو ريديس

   يتعين عليك إعداد حساب فواتير حتى لو كانت الوظيفة الإضافية مجانية.

4. افتح تطبيق الدردشة الخاص بك في المتصفح

    $ heroku open
   

كيف يعمل

تكوينات الإعداد

سيتم تعيين تكوينات الإنتاج من متغيرات البيئة على Heroku، بينما توجد تكوينات التطوير داخل ملف app/config/config.json .

مونغو دي بي و مونغو لاب

تحتاج إلى إنشاء قاعدة بيانات على MongoLab، ثم إنشاء مستخدم لقاعدة البيانات، والحصول على MongoDB URI ، وتعيينه إلى dbURI .

الفيسبوك وتويتر

تحتاج إلى تسجيل تطبيق جديد على كل من Facebook وTwitter للحصول على الرموز المميزة التي يمكن للمستخدمين من خلالها منح حق الوصول إلى تطبيقك، وتسجيل الدخول باستخدام حساباتهم الاجتماعية.

تسجيل التطبيق على الفيسبوك

1. انتقل إلى مطوري فيسبوك
2. إضافة تطبيق جديد، وملء المعلومات المطلوبة.
3. احصل على App ID الخاص بك، App Secret .
4. انتقل إلى إضافة منتج -> تسجيل الدخول إلى Facebook -> عناوين URI الصالحة لإعادة توجيه OAuth
5. أضف عناوين URI صالحة لرد الاتصال
6. انتقل إلى مراجعة التطبيق -> اجعل تطبيقك عامًا.

يمكنك الآن تعيين App ID لـ facebookClientID App Secret لـ facebookClientSecret .

تسجيل التطبيق على تويتر

1. انتقل إلى تطبيقات تويتر
2. أنشئ تطبيقًا جديدًا، واملأ المعلومات المطلوبة.
3. أضف عنوان URL لموقع الويب ورد الاتصال
4. احصل على Consumer Key الخاص بك، Consumer Secret .

يمكنك الآن تعيين Consumer Key إلى twitterConsumerKey Consumer Secret إلى twitterConsumerSecret .

عنوان URL لرد الاتصال

• يمكنه الرجوع إلى المضيف المحلي الخاص بك؛ http://localhost:3000/auth/facebook/callback

• عند النشر في Heroku، سيكون لديك شيء يشبه هذا؛ http://my-chat-app.herokuapp.com/auth/facebook/callback

حصة

تحتاج الجلسة إلى سلسلة عشوائية للتأكد من أن معرف الجلسة في المتصفح عشوائي. يتم استخدام هذه السلسلة العشوائية لتشفير معرف الجلسة في المتصفح، لماذا؟ لمنع تخمين معرف الجلسة.

قاعدة البيانات

يتم استخدام Mongoose للتفاعل مع MongoDB الذي يستضيفه MongoLab.

المخططات

هناك مخططان؛ المستخدمين والغرف.

كل مستخدم لديه اسم مستخدم وكلمة مرور ومعرف اجتماعي وصورة. إذا تم تسجيل دخول المستخدم عبر اسم المستخدم وكلمة المرور، فيجب أن تكون الهوية الاجتماعية فارغة، وإذا تم تسجيل الدخول عبر حساب اجتماعي، فستكون كلمة المرور فارغة.

كل غرفة لها عنوان، ومجموعة من الاتصالات. يمثل كل عنصر في مصفوفة الاتصالات مستخدمًا متصلاً عبر مقبس فريد؛ كائن مكون من {userId +ocketId} . كلاهما معًا فريد من نوعه.

نماذج

يغلف كل نموذج كائن Mongoose Model، ويتجاوزه ويوفر بعض الأساليب. هناك نموذجان؛ المستخدم والغرفة.

حصة

من الأفضل إدارة الجلسة في تطبيقات Express باستخدام حزمة الجلسة السريعة. يتم تخزين بيانات الجلسة محليًا على جهاز الكمبيوتر الخاص بك، بينما يتم تخزينها في قاعدة البيانات في بيئة الإنتاج. سيتم حذف بيانات الجلسة عند تسجيل الخروج.

مصادقة المستخدم

يمكن للمستخدم تسجيل الدخول باستخدام اسم المستخدم وكلمة المرور، أو تسجيل الدخول عبر حساب التواصل الاجتماعي. تتم مصادقة المستخدم باستخدام Passport. يحتوي Passport على وثائق شاملة ومفصلة حول كيفية تنفيذ كل طريقة من طرق المصادقة.

مآخذ

وجود اتصال نشط مفتوح بين العميل والخادم حتى يتمكن العميل من إرسال واستقبال البيانات. وهذا يسمح بالاتصال في الوقت الحقيقي باستخدام مآخذ توصيل TCP. وقد أصبح هذا ممكنا بفضل المقبس.io.

يبدأ العميل بالاتصال بالخادم عبر مأخذ توصيل (ربما يتم تعيينه أيضًا لمساحة اسم محددة). بمجرد نجاح الاتصالات، يمكن للعميل والخادم بث الأحداث والاستماع إليها.

هناك نوعان من مساحات الأسماء المستخدمة؛ /rooms و /chatroom .

المسجل

وغني عن القول أنك بحاجة إلى مراقبة طلبك. يستطيع ونستون تسجيل الدخول والتقاط الاستثناءات التي لم يتم اكتشافها. يتم عرض كافة السجلات في وحدة التحكم، ويتم حفظها في ملف debug.log .

في Heroku، يمكنك مراقبة السجلات من خلال النقر على المزيد -> عرض السجلات في الجزء العلوي الأيسر من لوحة تحكم التطبيق الخاص بك.

يدعم

لقد كتبت هذا السيناريو في وقت فراغي أثناء دراستي. إذا وجدت أنه مفيد، يرجى دعم المشروع من خلال نشر الكلمة.

يساهم

ساهم بإنشاء أعداد جديدة أو إرسال طلبات السحب على Github أو يمكنك إرسال بريد إلكتروني على: [email protected]

رخصة

بنيت بموجب ترخيص معهد ماساتشوستس للتكنولوجيا.