管理ポータル

管理ポータル

AIチャットボットのデータを管理するための管理者ダッシュボード

プロジェクト開発の詳細

プロジェクトの説明

このプロジェクトは、AI チャットボットのデータを管理するための管理ポータルです。これにより、管理者はファイルのログイン、アップロード、削除を行うことができます。このアプリケーションは、人気のある Python Web フレームワークである Flask を使用して構築されており、チャットボットのデータを操作するためのシンプルな Web インターフェイスを提供します。

前提条件

アプリケーションを実行する前に、次の前提条件が満たされていることを確認してください。

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 : 松ぼっくりベクトルデータベース上のデータを管理するためのモジュール。データベースをテストするためのスタンドアロン スクリプトでもあります。

インストールとセットアップ

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 ドライブからファイルをアップロードするためのルート。
7. /handle_url : URL を使用してデータを取得するためのルート。
8. /delete/ : アップロードされたファイルをサーバーから削除するルート。
9. /logout : ログアウトして認証されたセッションをクリアするルート。
10. /chatbot : チャットボットにリダイレクトします。

重要な注意事項

1. このプロジェクトでは、Flask の組み込みセッション管理を使用して認証ステータスを保存しますが、これは運用環境には適していません。実際のアプリケーションでは、より堅牢なセッション管理ソリューションの使用を検討してください。
2. allowed_file()関数では、特定のファイル タイプ (txt、pdf、doc、docx、csv) のみのアップロードが許可されます。必要に応じて、 ALLOWED_EXTENSIONSセットを変更して追加のファイル タイプを含めます。
3. 運用環境では、潜在的なセキュリティ リスクを防ぐために、ファイルを安全にアップロードすることが重要です。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。ニーズに応じて自由に使用および変更してください。