بوابة المشرف

بوابة المشرف

لوحة تحكم المشرف لإدارة البيانات لـ AI-chatbot

تفاصيل تطوير المشروع

وصف المشروع

هذا المشروع عبارة عن بوابة إدارية لإدارة البيانات الخاصة ببرنامج الدردشة الآلي الذي يعمل بالذكاء الاصطناعي. يسمح للمسؤولين بتسجيل الدخول وتحميل وحذف الملفات. تم إنشاء التطبيق باستخدام Flask، وهو إطار عمل ويب Python شائع، ويوفر واجهة ويب بسيطة للتفاعل مع بيانات chatbot.

المتطلبات الأساسية

قبل تشغيل التطبيق، تأكد من استيفاء المتطلبات الأساسية التالية:

1. تم تثبيت Python 3.x على النظام.
2. تم تثبيت حزم بايثون المطلوبة. يمكنك تثبيتها باستخدام pip install -r requirements.txt .
3. يجب تعيين متغيرات البيئة FLASK_SECRET_KEY وأي متغيرات أخرى مطلوبة.

هيكل المشروع

يتكون المشروع من الملفات التالية:

0. main.py : البرنامج النصي لبرنامج الرجل. نقطة البداية.
1. app.py : ملف تطبيق Flask الرئيسي الذي يحتوي على منطق الخادم.
2. admin_users.json : ملف JSON يحتوي على قائمة ببيانات اعتماد المستخدمين الإداريين.
3. client_secret.json : ملف JSON يحتوي على مفاتيح Google Drive API وبيانات الاعتماد. (احصل عليه من هنا [https://console.cloud.google.com/])
4. .stored_files.json : ملف JSON يستخدم لتحقيق شفافية البيانات، ويتم الاحتفاظ بهذا الملف متزامنًا مع قاعدة بيانات متجهات كوز الصنوبر. (التي تتم صيانتها بواسطة manage_vectordb.py )
5. utils.py : الأدوات المساعدة/الوظائف المساعدة لـ app.py
6. manage_vectordb.py : وحدة لإدارة البيانات في قاعدة بيانات متجهات Pinecone. أيضًا برنامج نصي مستقل لاختبار قاعدة البيانات.

التثبيت والإعداد

1. استنساخ المستودع من جيثب.

 git clone https://github.com/madhav-mknc/admin-portal
cd https://github.com/madhav-mknc/admin-portal

2. قم بتثبيت التبعيات المطلوبة باستخدام:

 pip install -r requirements.txt

3. قم بتعيين متغير البيئة FLASK_SECRET_KEY إلى مفتاح عشوائي قوي لإدارة الجلسة وأمانها. ملاحظة: في بيئة الإنتاج، تأكد من الحفاظ على هذا المفتاح سريًا وليس مشفرًا.
4. تأكد من أن ملف admin_users.json يحتوي على بيانات اعتماد مستخدم مسؤول صالحة.
5. قم بتعيين كافة متغيرات env المطلوبة المذكورة في ملف ".env".

كيفية التشغيل

• لبدء تشغيل خادم Flask، قم بتشغيل وظيفة start_server() في ملف app.py سيتم تشغيل الخادم على http://0.0.0.0:80/ والاستماع إلى الطلبات الواردة.

python app.py

أو

python main.py

• لاختبار QnA: افتح سطر أوامر آخر في نفس الدليل واتبع الأوامر التالية:

 python manage_vectordb.py

 * ".stats" is a command short for index.describe_index_stats()
* ".reset_index" is for resetting the index by deleting and creating a new one.

الطرق

يعرض تطبيق Flask الطرق التالية:

1. / : الصفحة الرئيسية لبوابة الإدارة.
2. /login : صفحة تسجيل الدخول للمسؤولين لمصادقة أنفسهم.
3. /dashboard : صفحة لوحة التحكم الرئيسية حيث يمكن للمسؤولين رؤية الملفات التي تم تحميلها وإدارتها.
4. /uploads/ : طريق لخدمة الملفات المرفوعة مباشرة من الخادم.
5. /upload : طريق لتحميل الملفات إلى الخادم.
6. /upload_google_drive : طريق لتحميل الملفات من Google Drive.
7. /handle_url : مسار لجلب البيانات باستخدام عنوان URL.
8. /delete/ : طريق لحذف الملفات التي تم تحميلها من الخادم.
9. /logout : طريق لتسجيل الخروج ومسح الجلسة المصادق عليها.
10. /chatbot : إعادة التوجيه إلى chatbot.

ملاحظات هامة

1. يستخدم المشروع إدارة الجلسة المضمنة في Flask لتخزين حالة المصادقة، وهي غير مناسبة لبيئات الإنتاج. في التطبيقات الواقعية، فكر في استخدام حل أكثر قوة لإدارة الجلسة.
2. تسمح الوظيفة allowed_file() بتحميل أنواع ملفات محددة فقط (txt، pdf، doc، docx، csv). قم بتعديل مجموعة ALLOWED_EXTENSIONS لتشمل أنواع ملفات إضافية إذا لزم الأمر.
3. في بيئة الإنتاج، من الضروري التأكد من تحميل الملفات بشكل آمن لمنع أي مخاطر أمنية محتملة.

رخصة

هذا المشروع مرخص بموجب ترخيص MIT. لا تتردد في استخدامه وتعديله وفقا لاحتياجاتك.