พอร์ทัลผู้ดูแลระบบ

พอร์ทัลผู้ดูแลระบบ

แดชบอร์ดผู้ดูแลระบบสำหรับจัดการข้อมูลสำหรับ AI-chatbot

รายละเอียดการพัฒนาโครงการ

รายละเอียดโครงการ

โปรเจ็กต์นี้เป็นพอร์ทัลผู้ดูแลระบบสำหรับจัดการข้อมูลสำหรับแชทบอท AI ช่วยให้ผู้ดูแลระบบสามารถเข้าสู่ระบบ อัพโหลด และลบไฟล์ได้ แอปพลิเคชันนี้สร้างขึ้นโดยใช้ Flask ซึ่งเป็นเฟรมเวิร์กเว็บ Python ยอดนิยม และมีเว็บอินเตอร์เฟสที่เรียบง่ายเพื่อโต้ตอบกับข้อมูลของแชทบอต

ข้อกำหนดเบื้องต้น

ก่อนที่จะรันแอปพลิเคชัน ตรวจสอบให้แน่ใจว่าตรงตามข้อกำหนดเบื้องต้นต่อไปนี้:

1. Python 3.x ได้รับการติดตั้งบนระบบแล้ว
2. ติดตั้งแพ็คเกจ Python ที่จำเป็นแล้ว คุณสามารถติดตั้งได้โดยใช้ pip install -r requirements.txt
3. ควรตั้งค่าตัวแปรสภาพแวดล้อม FLASK_SECRET_KEY และตัวแปรที่จำเป็นอื่นๆ

โครงสร้างโครงการ

โครงการประกอบด้วยไฟล์ต่อไปนี้:

0. main.py : สคริปต์โปรแกรม man จุดเริ่มต้น.
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 : ฟังก์ชั่น Utilites / helper สำหรับ app.py
6. manage_vectordb.py : โมดูลสำหรับจัดการข้อมูลบนฐานข้อมูลเวกเตอร์ Pinecone ยังเป็นสคริปต์แบบสแตนด์อโลนสำหรับการทดสอบฐานข้อมูล

การติดตั้งและตั้งค่า

1. โคลนพื้นที่เก็บข้อมูลจาก GitHub

 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 : เปลี่ยนเส้นทางไปยังแชทบอท

หมายเหตุสำคัญ

1. โปรเจ็กต์ใช้การจัดการเซสชันในตัวของ Flask เพื่อจัดเก็บสถานะการรับรองความถูกต้อง ซึ่งไม่เหมาะกับสภาพแวดล้อมการใช้งานจริง ในแอปพลิเคชันในโลกแห่งความเป็นจริง ให้พิจารณาใช้โซลูชันการจัดการเซสชันที่มีประสิทธิภาพมากขึ้น
2. ฟังก์ชัน allowed_file() อนุญาตให้อัปโหลดเฉพาะไฟล์บางประเภท (txt, pdf, doc, docx, csv) เท่านั้น แก้ไขชุด ALLOWED_EXTENSIONS เพื่อรวมประเภทไฟล์เพิ่มเติมหากจำเป็น
3. ในสภาพแวดล้อมการใช้งานจริง จำเป็นอย่างยิ่งที่จะต้องแน่ใจว่าการอัปโหลดไฟล์ที่ปลอดภัยเพื่อป้องกันความเสี่ยงด้านความปลอดภัยที่อาจเกิดขึ้น

ใบอนุญาต

โครงการนี้ได้รับอนุญาตภายใต้ใบอนุญาต MIT รู้สึกอิสระที่จะใช้และปรับเปลี่ยนได้ตามความต้องการของคุณ