portal admin

portal admin

Dasbor admin untuk mengelola data untuk AI-chatbot

Detail Pengembangan Proyek

Deskripsi Proyek

Proyek ini adalah Portal Admin untuk mengelola data untuk chatbot AI. Ini memungkinkan administrator untuk masuk, mengunggah, dan menghapus file. Aplikasi ini dibangun menggunakan Flask, kerangka web Python yang populer, dan menyediakan antarmuka web sederhana untuk berinteraksi dengan data chatbot.

Prasyarat

Sebelum menjalankan aplikasi, pastikan prasyarat berikut terpenuhi:

1. Python 3.x diinstal pada sistem.
2. Paket Python yang diperlukan telah diinstal. Anda dapat menginstalnya menggunakan pip install -r requirements.txt .
3. Variabel lingkungan FLASK_SECRET_KEY dan variabel lain yang diperlukan harus disetel.

Struktur Proyek

Proyek ini terdiri dari file-file berikut:

0. main.py : Skrip program manusia. Titik awal.
1. app.py : File aplikasi Flask utama yang berisi logika server.
2. admin_users.json : File JSON yang berisi daftar kredensial pengguna admin.
3. client_secret.json : File JSON yang berisi kunci dan kredensial API Google Drive. (Dapatkan dari sini [https://console.cloud.google.com/])
4. .stored_files.json : File JSON yang digunakan untuk mencapai transparansi data, file ini tetap disinkronkan dengan database vektor biji pinus. (dikelola oleh manage_vectordb.py )
5. utils.py : Utilitas / fungsi pembantu untuk app.py
6. manage_vectordb.py : Modul untuk mengelola data pada database vektor Pinecone. Juga skrip mandiri untuk menguji database.

Instalasi dan Pengaturan

1. Kloning repositori dari GitHub.

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

2. Instal dependensi yang diperlukan menggunakan:

 pip install -r requirements.txt

3. Atur variabel lingkungan FLASK_SECRET_KEY ke kunci acak yang kuat untuk manajemen dan keamanan sesi. Catatan: Dalam lingkungan produksi, pastikan kunci ini dirahasiakan dan tidak di-hardcode.
4. Pastikan file admin_users.json berisi kredensial pengguna admin yang valid.
5. Atur semua variabel env yang diperlukan yang disebutkan dalam file ".env".

Cara Berlari

• Untuk memulai server Flask, jalankan fungsi start_server() di file app.py Server akan berjalan di http://0.0.0.0:80/ dan mendengarkan permintaan masuk.

python app.py

atau

python main.py

• Untuk menguji QnA: Buka baris perintah lain di direktori yang sama dan ikuti perintah berikut:

 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.

Rute

Aplikasi Flask memperlihatkan rute berikut:

1. / : Beranda Portal Admin.
2. /login : Halaman login bagi administrator untuk mengautentikasi dirinya.
3. /dashboard : Halaman dashboard utama dimana administrator dapat melihat file yang diupload dan mengelolanya.
4. /uploads/ : Rute untuk menyajikan file yang diunggah langsung dari server.
5. /upload : Rute untuk mengunggah file ke server.
6. /upload_google_drive : Rute untuk mengupload file dari Google Drive.
7. /handle_url : Rute untuk mengambil data menggunakan URL.
8. /delete/ : Rute untuk menghapus file yang diunggah dari server.
9. /logout : Rute untuk keluar dan menghapus sesi yang diautentikasi.
10. /chatbot : Mengalihkan ke chatbot.

Catatan Penting

1. Proyek ini menggunakan manajemen sesi bawaan Flask untuk menyimpan status terautentikasi, yang tidak sesuai untuk lingkungan produksi. Dalam aplikasi dunia nyata, pertimbangkan untuk menggunakan solusi manajemen sesi yang lebih tangguh.
2. Fungsi allowed_file() hanya mengizinkan jenis file tertentu (txt, pdf, doc, docx, csv) untuk diunggah. Ubah kumpulan ALLOWED_EXTENSIONS untuk menyertakan jenis file tambahan jika diperlukan.
3. Dalam lingkungan produksi, sangat penting untuk memastikan pengunggahan file yang aman untuk mencegah potensi risiko keamanan.

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT. Jangan ragu untuk menggunakan dan memodifikasinya sesuai kebutuhan Anda.