ShareStore

متجر الأسهم

وصف

Stare Store هو تطبيق مشاركة الملفات وتخزينه على شبكة الإنترنت مصممة باستخدام Django و Python للواجهة الخلفية ، و JavaScript و Bootstrap للواجهة الأمامية. هذا هو المشروع النهائي لبرمجة الويب الخاصة بـ CS50 مع Python و JavaScript. يحتوي هذا المشروع على تطبيق واحد "محرك".

يتيح متجر Share للمستخدمين تسجيل الملفات وتسجيل الدخول وتحميل الملفات وإدارة أذونات الوصول لتلك الملفات. يمكن للمستخدمين مشاركة ملفاتهم مع أفراد محددين أو جعلهم في متناول الجميع. بالإضافة إلى ذلك ، يمكن للمستخدمين عرض الملفات المشتركة معهم من قبل الآخرين. متجر Share يستخدم تخزين Firebase لتخزين الملفات واسترجاعها. يوفر ميزات مثل مصادقة المستخدم ، وتحميل الملف/التنزيل ، والتحكم في الوصول ، وتغيير كلمة المرور ، وحذف الحساب ، مما يجعله منصة متعددة الاستخدامات لمشاركة الملفات.

مشروع تجريبي

التحديثات

• تكامل Discord: عزز النظام الأساسي بميزة جديدة تعمل على أتمتة عملية تحميل الملفات (college lecture slides in my case) إلى Discord. الآن ، عندما يقوم المستخدمون بتحميل الملفات التي تحتوي على كلمات رئيسية محددة (على سبيل المثال ، أسماء المحاضرات أو موضوعات مثل Math أو TOC) من حساباتهم ، يتم إرسال هذه الملفات تلقائيًا إلى قناة Discord مخصصة ، كما هو محدد في متغيرات البيئة. يلغي هذا التكامل الحاجة إلى نقل الملفات اليدوية ، وتوفير الوقت وضمان مشاركة المحتوى على الفور مع مجتمع Discord ذي الصلة.

لقطات الشاشة

ملحوظة

توضح لقطة الشاشة أدناه ميزة تكامل Discord ، وتحديداً كيفية نشر ملفات BOT إلى مؤشر ترابط/قناة مخصصة على خادم Discord الخاص بك. يتم تشغيل هذه الوظيفة من خلال تكوين CHANNEL_MAPPINGS ، مثل تضمين "Maths": "maths thread/channel ID" لتوجيه الملفات المتعلقة بالرياضيات إلى موقع Discord المناسب.

الفيديو التجريبي المشروع قديم بعض الشيء ، لذلك لا يعرض هذه الميزة.

التميز والتعقيد

1. التميز :
   • غرض فريد من نوعه : متجر سهم متخصص في مشاركة الملفات وتخزينها الآمن ، تميزه عن الشبكات الاجتماعية التقليدية أو مواقع التجارة الإلكترونية.
   • مشاركة الملفات المستهدفة : ينصب تركيزها الرئيسي على مشاركة الملفات المنظمة ، وليس التفاعلات الاجتماعية أو مبيعات المنتجات. إن الإضافة الأخيرة لتكامل Discord for File (Slide Automatic Lecture Slide) تعزز دورها كمنصة متخصصة لمشاركة المحتوى.
   • تكامل Firebase : يتكامل متجر الأسهم مع تخزين Firebase ، وتعزيز إدارة الملفات.
2. التعقيد :
   • Django الخلفية : يستخدم Django لمصادقة المستخدم وبيانات تعريف الملفات والتحكم في الوصول.
   • JavaScript و Bootstrap : توظف JavaScript و Bootstrap للواجهة الأمامية المستجيبة.
   • مصادقة المستخدم : ينفذ تسجيل وتسجيل تسجيل الدخول الآمن.
   • إدارة الملفات : يتعامل مع المهام المعقدة مثل تحميل الملفات والتنزيلات وأذونات الوصول.

ما هو وارد في الملفات

1. static/drive : يحتوي على JavaScript لمعالجة أذونات الوصول ، وشعار التطبيق ، وملاءة أنماط للتصميم.

2. templates/drive : يحتوي على قوالب HTML المسؤولة عن تقديم صفحات الويب.

3. firebase.py : تهيئة Firebase Admin SDK ويخلق إشارة إلى تخزين Firebase.

4. models.py : يحدد نماذج البيانات للتطبيق ، بما في ذلك File User Share .

5. tests.py : يتضمن اختبارات قاعدة البيانات لإنشاء الملفات والمشاركات والمستخدمين.

6. urls.py : يحدد أنماط URL لتطبيق "محرك الأقراص".

7. utils.py : يحتوي على وظيفة الأداة المساعدة للتكرار على الملفات التي تم جلبها من عناوين URL الخارجية.

8. views.py : المنازل عرض وظائف تعامل مع طلبات HTTP وتحديد كيفية تقديم صفحات الويب.

9. discord_integration.py : يدير أتمتة تحميل الملفات إلى قناة Discord محددة بناءً على معايير معينة ، باستخدام API Discord.

10. requirements.txt : يسرد حزم بيثون الخارجية والتبعيات المطلوبة للمشروع.

كيفية تشغيل متجر المشاركة

ملاحظة: يتم تقديم دليل موجز حول كيفية إنشاء مشروع Firebase والعثور على ملف مفتاح حساب خدمة JSON لهذا المشروع في النهاية.

1. إنشاء بيئة افتراضية (اختياري) : إذا كنت تفضل العمل في بيئة افتراضية (موصى بها للعزلة) ، فيمكنك إنشاء وتنشيط واحدة. انتقل إلى دليل المشروع الخاص بك وتشغيل الأوامر التالية:

    # Create a virtual environment
   python -m venv myenv
   
   # Activate the virtual environment (Windows)
   myenv S cripts a ctivate
   
   # Activate the virtual environment (macOS/Linux)
   source myenv/bin/activate

2. متطلبات التثبيت : تأكد من تثبيت Python على نظامك. انتقل إلى دليل المشروع الخاص بك وتثبيت حزم بيثون المطلوبة المدرجة في requirements.txt . يمكنك القيام بذلك باستخدام pip :

    pip install -r requirements.txt
   

3. إنشاء ملف .env : إنشاء ملف اسمه .env في دليل المشروع الخاص بك. في ملف .ENV ، أضف الأسطر التالية ، واستبدال قيم العناوين المتعلقة بتفاصيل التكوين الفعلية:

    STORAGE_BUCKET="Storage Bucket Name"
   GOOGLE_APPLICATION_CREDENTIALS="Path to your Firebase Admin SDK JSON credential file"
   SECRET_KEY="Your Django secret key"
   CONNECTION_STRING="Your database connection string (production only)"
   SERVER_ID="Your Discord Server ID"
   BOT_TOKEN="Your Discord Bot Token"
   CHANNEL_MAPPINGS={"substring_1": "Channel_ID_1", "substring_2": "Channel_ID_2"}
   P_USERNAME="Specific platform username whose files will be checked for Discord posting."
   

   يخدم كل من هذه المتغيرات غرضًا محددًا في التطبيق الخاص بك ، مثل الاتصال بقواعد البيانات ، والتكامل مع Discord ، وتكوين خدمات Firebase.

نصيحة

إذا كنت ترغب في البحث عن المزيد من الفرعية ، فما عليك سوى إضافة التعيين في متغير بيئة CHANNEL_MAPPINGS مثل SO: CHANNEL_MAPPINGS={"substring_1": "Channel_ID_1", "substring_2": "Channel_ID_2", "additional_substring": "Additional_Channel_ID"} :

ملحوظة

يجب عليك الحصول على ملف اعتماد FireBase Admin SDK JSON من إعدادات مشروع FireBase. إذا لم تكن قد قمت بالفعل بإنشاء مشروع Firebase ، فيمكنك القيام بذلك هنا: Console Firebase

بالإضافة إلى ذلك ، لإعداد الرمز المميز لـ Discord Bot الخاص بك والحصول عليه ، راجع بوابة Discord Developer. يمكن العثور على إرشادات مفصلة لإنشاء روبوت ودعوتها إلى الخادم الخاص بك هنا: بوابة Discord Developer.

4. ترحيل قاعدة البيانات : قم بتشغيل الأوامر التالية لإنشاء وتطبيق ترحيل قاعدة البيانات:

    python manage.py makemigrations
   

    python manage.py migrate
   

5. قم بتشغيل الخادم : أخيرًا ، ابدأ خادم التطوير مع الأمر التالي:

    python manage.py runserver
   

6. الوصول إلى التطبيق : افتح متصفح الويب وانتقل إلى "http: // localhost: 8000`` للوصول إلى تطبيق متجر الأسهم.

---

إعداد Firebase لمتجر الأسهم

1. إنشاء مشروع Firebase :
   • اذهب إلى وحدة التحكم في Firebase.
   • انقر فوق "إضافة مشروع" لإنشاء مشروع جديد.
   • اتبع تعليمات الإعداد ، بما في ذلك اختيار اسم المشروع وتمكين Google Analytics إذا لزم الأمر.
2. انتقل إلى إعدادات المشروع :
   • بعد إنشاء المشروع ، انقر فوق أيقونة الترس (الإعدادات) بجوار "نظرة عامة على المشروع" في الشريط الجانبي الأيسر.
   • حدد "إعدادات المشروع" من القائمة المنسدلة.
3. أضف تطبيقًا إلى مشروعك :
   • بعد إنشاء المشروع ، انقر فوق أيقونة الترس (الإعدادات) بجوار "نظرة عامة على المشروع" في الشريط الجانبي الأيسر.
   • حدد "إعدادات المشروع" من القائمة المنسدلة.
4. إنشاء مفتاح حساب خدمة JSON :
   • في إعدادات مشروع Firebase ، انتقل إلى علامة التبويب "حسابات الخدمة".
   • تحت "Firebase Admin SDK ،" انقر "قم بإنشاء مفتاح خاص جديد".
   • قم بتنزيل ملف مفتاح JSON الذي يحتوي على بيانات الاعتماد الخاصة بك.
5. استخدم ملف مفتاح JSON :
   • قم بتعيين متغير بيئة GOOGLE_APPLICATION_CREDENTIALS في ملف .env الخاص بمتجر الأسهم الخاص بك إلى مسار ملف مفتاح JSON الذي تم تنزيله.

المساهمة

نرحب بالمساهمات في متجر الأسهم! للبدء ، يرجى قراءة إرشاداتنا المساهمة واتباع التعليمات لتقديم المشكلات وسحب الطلبات.

مدونة لقواعد السلوك

يرجى قراءة مدونة قواعد سلوكنا لفهم توقعاتنا للمشاركين والمساهمين.