portal de administração

portal de administração

Painel de administração para gerenciamento de dados para AI-chatbot

Detalhes de desenvolvimento do projeto

Descrição do projeto

Este projeto é um Portal de Administração para gerenciamento de dados para um chatbot de IA. Ele permite que os administradores façam login, carreguem e excluam arquivos. O aplicativo é construído usando Flask, uma estrutura web Python popular, e fornece uma interface web simples para interagir com os dados do chatbot.

Pré-requisitos

Antes de executar o aplicativo, certifique-se de que os seguintes pré-requisitos sejam atendidos:

1. Python 3.x está instalado no sistema.
2. Os pacotes Python necessários estão instalados. Você pode instalá-los usando pip install -r requirements.txt .
3. As variáveis ​​de ambiente FLASK_SECRET_KEY e quaisquer outras variáveis ​​necessárias devem ser definidas.

Estrutura do Projeto

O projeto consiste nos seguintes arquivos:

0. main.py : O script do programa man. Ponto de partida.
1. app.py : O arquivo principal do aplicativo Flask que contém a lógica do servidor.
2. admin_users.json : um arquivo JSON contendo uma lista de credenciais de usuários administradores.
3. client_secret.json : um arquivo JSON contendo chaves e credenciais da API do Google Drive. (Obtenha aqui [https://console.cloud.google.com/])
4. .stored_files.json : Um arquivo JSON usado para obter transparência de dados, este arquivo é mantido sincronizado com o banco de dados vetorial pinha. (mantido pelo manage_vectordb.py )
5. utils.py : utilitários/funções auxiliares para app.py
6. manage_vectordb.py : Módulo para gerenciamento de dados no banco de dados vetorial Pinecone. Também um script independente para testar o banco de dados.

Instalação e configuração

1. Clone o repositório do GitHub.

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

2. Instale as dependências necessárias usando:

 pip install -r requirements.txt

3. Defina a variável de ambiente FLASK_SECRET_KEY como uma chave aleatória forte para gerenciamento e segurança de sessão. Observação: em um ambiente de produção, certifique-se de que essa chave seja mantida em segredo e não codificada.
4. Certifique-se de que o arquivo admin_users.json contenha credenciais válidas de usuário administrador.
5. Defina todas as variáveis ​​de ambiente necessárias mencionadas no arquivo ".env".

Como correr

• Para iniciar o servidor Flask, execute a função start_server() no arquivo app.py O servidor será executado em http://0.0.0.0:80/ e escutará as solicitações recebidas.

python app.py

ou

python main.py

• Para testar o QnA: Abra outra linha de comando no mesmo diretório e siga os seguintes 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.

Rotas

O aplicativo Flask expõe as seguintes rotas:

1. / : A página inicial do Portal do Administrador.
2. /login : A página de login para os administradores se autenticarem.
3. /dashboard : a página principal do painel onde os administradores podem ver os arquivos enviados e gerenciá-los.
4. /uploads/ : uma rota para servir arquivos carregados diretamente do servidor.
5. /upload : uma rota para enviar arquivos para o servidor.
6. /upload_google_drive : uma rota para fazer upload de arquivos do Google Drive.
7. /handle_url : uma rota para buscar dados usando uma URL.
8. /delete/ : Uma rota para excluir arquivos carregados do servidor.
9. /logout : uma rota para sair e limpar a sessão autenticada.
10. /chatbot : Redireciona para chatbot.

Notas importantes

1. O projeto usa o gerenciamento de sessão integrado do Flask para armazenar o status autenticado, o que não é adequado para ambientes de produção. Numa aplicação real, considere utilizar uma solução de gestão de sessões mais robusta.
2. A função allowed_file() permite que apenas tipos de arquivos específicos (txt, pdf, doc, docx, csv) sejam carregados. Modifique o conjunto ALLOWED_EXTENSIONS para incluir tipos de arquivo adicionais, se necessário.
3. Em um ambiente de produção, é crucial garantir uploads seguros de arquivos para evitar possíveis riscos de segurança.

Licença

Este projeto está licenciado sob a licença MIT. Sinta-se à vontade para usá-lo e modificá-lo de acordo com suas necessidades.