portal de administración

portal de administración

Panel de administración para gestionar datos para AI-chatbot

Detalles del desarrollo del proyecto

Descripción del proyecto

Este proyecto es un portal de administración para gestionar datos para un chatbot de IA. Permite a los administradores iniciar sesión, cargar y eliminar archivos. La aplicación se creó utilizando Flask, un popular marco web de Python, y proporciona una interfaz web sencilla para interactuar con los datos del chatbot.

Requisitos previos

Antes de ejecutar la aplicación, asegúrese de que se cumplan los siguientes requisitos previos:

1. Python 3.x está instalado en el sistema.
2. Los paquetes de Python necesarios están instalados. Puede instalarlos usando pip install -r requirements.txt .
3. Se deben configurar las variables de entorno FLASK_SECRET_KEY y cualquier otra variable requerida.

Estructura del proyecto

El proyecto consta de los siguientes archivos:

0. main.py : el script del programa man. Punto de partida.
1. app.py : el archivo principal de la aplicación Flask que contiene la lógica del servidor.
2. admin_users.json : un archivo JSON que contiene una lista de credenciales de usuarios administradores.
3. client_secret.json : un archivo JSON que contiene las claves y credenciales de la API de Google Drive. (Consíguelo desde aquí [https://console.cloud.google.com/])
4. .stored_files.json : un archivo JSON utilizado para lograr transparencia de datos; este archivo se mantiene sincronizado con la base de datos de vectores de piña. (mantenido por el manage_vectordb.py )
5. utils.py : utilidades/funciones auxiliares para app.py
6. manage_vectordb.py : Módulo para gestionar los datos en la base de datos de vectores Pinecone. También un script independiente para probar la base de datos.

Instalación y configuración

1. Clona el repositorio de GitHub.

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

2. Instale las dependencias requeridas usando:

 pip install -r requirements.txt

3. Establezca la variable de entorno FLASK_SECRET_KEY en una clave aleatoria segura para la gestión y la seguridad de la sesión. Nota: En un entorno de producción, asegúrese de que esta clave se mantenga en secreto y no esté codificada.
4. Asegúrese de que el archivo admin_users.json contenga credenciales de usuario administrador válidas.
5. Establezca todas las variables de entorno requeridas mencionadas en el archivo ".env".

Cómo correr

• Para iniciar el servidor Flask, ejecute la función start_server() en el archivo app.py El servidor se ejecutará en http://0.0.0.0:80/ y escuchará las solicitudes entrantes.

python app.py

o

python main.py

• Para probar QnA: abra otra línea de comando en el mismo directorio y siga los siguientes comandos:

 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.

Rutas

La aplicación Flask expone las siguientes rutas:

1. / : La página de inicio del Portal de administración.
2. /login : la página de inicio de sesión para que los administradores se autentiquen.
3. /dashboard : la página principal del panel donde los administradores pueden ver los archivos cargados y administrarlos.
4. /uploads/ >: una ruta para servir archivos cargados directamente desde el servidor.
5. /upload : una ruta para cargar archivos al servidor.
6. /upload_google_drive : una ruta para cargar archivos desde Google Drive.
7. /handle_url : una ruta para recuperar datos mediante una URL.
8. /delete/ >: una ruta para eliminar archivos cargados del servidor.
9. /logout : una ruta para cerrar sesión y borrar la sesión autenticada.
10. /chatbot : Redirigir al chatbot.

Notas importantes

1. El proyecto utiliza la gestión de sesiones integrada de Flask para almacenar el estado autenticado, lo que no es adecuado para entornos de producción. En una aplicación del mundo real, considere utilizar una solución de gestión de sesiones más sólida.
2. La función allowed_file() permite cargar solo tipos de archivos específicos (txt, pdf, doc, docx, csv). Modifique el conjunto ALLOWED_EXTENSIONS para incluir tipos de archivos adicionales si es necesario.
3. En un entorno de producción, es fundamental garantizar la carga segura de archivos para evitar posibles riesgos de seguridad.

Licencia

Este proyecto está bajo la licencia MIT. Siéntase libre de utilizarlo y modificarlo según sus necesidades.