Admin-Portal

Admin-Portal

Admin-Dashboard zum Verwalten von Daten für AI-Chatbot

Details zur Projektentwicklung

Projektbeschreibung

Bei diesem Projekt handelt es sich um ein Admin-Portal zur Verwaltung von Daten für einen KI-Chatbot. Es ermöglicht Administratoren, sich anzumelden, Dateien hochzuladen und zu löschen. Die Anwendung wird mit Flask, einem beliebten Python-Webframework, erstellt und bietet eine einfache Webschnittstelle für die Interaktion mit den Daten des Chatbots.

Voraussetzungen

Stellen Sie vor dem Ausführen der Anwendung sicher, dass die folgenden Voraussetzungen erfüllt sind:

1. Python 3.x ist auf dem System installiert.
2. Erforderliche Python-Pakete sind installiert. Sie können sie mit pip install -r requirements.txt installieren.
3. Die Umgebungsvariablen FLASK_SECRET_KEY und alle anderen erforderlichen Variablen sollten festgelegt werden.

Projektstruktur

Das Projekt besteht aus folgenden Dateien:

0. main.py : Das man-Programmskript. Ausgangspunkt.
1. app.py : Die Hauptanwendungsdatei von Flask, die die Serverlogik enthält.
2. admin_users.json : Eine JSON-Datei, die eine Liste der Anmeldeinformationen von Admin-Benutzern enthält.
3. client_secret.json : Eine JSON-Datei mit Google Drive-API-Schlüsseln und Anmeldeinformationen. (Laden Sie es hier herunter [https://console.cloud.google.com/])
4. .stored_files.json : Eine JSON-Datei, die zur Erzielung von Datentransparenz verwendet wird. Diese Datei wird mit der Pinecone-Vektordatenbank synchronisiert. (verwaltet von manage_vectordb.py )
5. utils.py : Dienstprogramme/Hilfsfunktionen für app.py
6. manage_vectordb.py : Modul zur Verwaltung der Daten in der Pinecone-Vektordatenbank. Außerdem ein eigenständiges Skript zum Testen der Datenbank.

Installation und Einrichtung

1. Klonen Sie das Repository von GitHub.

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

2. Installieren Sie die erforderlichen Abhängigkeiten mit:

 pip install -r requirements.txt

3. Legen Sie die Umgebungsvariable FLASK_SECRET_KEY für Sitzungsverwaltung und Sicherheit auf einen starken Zufallsschlüssel fest. Hinweis: Stellen Sie in einer Produktionsumgebung sicher, dass dieser Schlüssel geheim gehalten und nicht fest codiert wird.
4. Stellen Sie sicher, dass die Datei admin_users.json gültige Anmeldeinformationen des Administratorbenutzers enthält.
5. Legen Sie alle erforderlichen Umgebungsvariablen fest, die in der Datei „.env“ erwähnt werden.

Wie man läuft

• Um den Flask-Server zu starten, führen Sie die Funktion start_server() in der Datei app.py aus. Der Server läuft unter http://0.0.0.0:80/ und lauscht auf eingehende Anfragen.

python app.py

oder

python main.py

• Zum Testen von QnA: Öffnen Sie eine weitere Befehlszeile im selben Verzeichnis und befolgen Sie die folgenden Befehle:

 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.

Routen

Die Flask-Anwendung stellt die folgenden Routen bereit:

1. / : Die Homepage des Admin-Portals.
2. /login : Die Anmeldeseite für Administratoren zur Authentifizierung.
3. /dashboard : Die Haupt-Dashboard-Seite, auf der Administratoren die hochgeladenen Dateien sehen und verwalten können.
4. /uploads/ : Eine Route, um hochgeladene Dateien direkt vom Server bereitzustellen.
5. /upload : Eine Route zum Hochladen von Dateien auf den Server.
6. /upload_google_drive : Eine Route zum Hochladen von Dateien von Google Drive.
7. /handle_url : Eine Route zum Abrufen von Daten mithilfe einer URL.
8. /delete/ : Eine Route zum Löschen hochgeladener Dateien vom Server.
9. /logout : Eine Route zum Abmelden und Löschen der authentifizierten Sitzung.
10. /chatbot : Zum Chatbot weiterleiten.

Wichtige Hinweise

1. Das Projekt verwendet die integrierte Sitzungsverwaltung von Flask, um den authentifizierten Status zu speichern, was für Produktionsumgebungen nicht geeignet ist. Erwägen Sie in einer realen Anwendung die Verwendung einer robusteren Sitzungsverwaltungslösung.
2. Mit der Funktion allowed_file() können nur bestimmte Dateitypen (txt, pdf, doc, docx, csv) hochgeladen werden. Ändern Sie den Satz ALLOWED_EXTENSIONS , um bei Bedarf zusätzliche Dateitypen einzuschließen.
3. In einer Produktionsumgebung ist es von entscheidender Bedeutung, sichere Datei-Uploads zu gewährleisten, um potenziellen Sicherheitsrisiken vorzubeugen.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Fühlen Sie sich frei, es entsprechend Ihren Bedürfnissen zu verwenden und zu modifizieren.