관리 포털

관리 포털

AI 챗봇 데이터 관리를 위한 관리자 대시보드

프로젝트 개발 세부사항

프로젝트 설명

본 프로젝트는 AI 챗봇의 데이터를 관리하기 위한 관리자 포털입니다. 관리자는 로그인하여 파일을 업로드하고 삭제할 수 있습니다. 이 애플리케이션은 널리 사용되는 Python 웹 프레임워크인 Flask를 사용하여 구축되었으며 챗봇의 데이터와 상호 작용할 수 있는 간단한 웹 인터페이스를 제공합니다.

전제조건

애플리케이션을 실행하기 전에 다음 전제조건이 충족되는지 확인하십시오.

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 : Google Drive API 키와 자격 증명이 포함된 JSON 파일입니다. (여기에서 다운로드하세요[https://console.cloud.google.com/])
4. .stored_files.json : 데이터 투명성을 확보하는 데 사용되는 JSON 파일로, 이 파일은 솔방울 벡터 데이터베이스와 동기화된 상태로 유지됩니다. ( manage_vectordb.py 에 의해 유지됨)
5. utils.py : 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" 파일에 언급된 모든 필수 환경 변수를 설정합니다.

달리는 방법

• Flask 서버를 시작하려면 app.py 파일에서 start_server() 함수를 실행하세요. 서버는 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 라이선스에 따라 라이선스가 부여됩니다. 필요에 따라 자유롭게 사용하고 수정하세요.