egg/Meeting_Assistant

Fork 0

Files

beabigegg df5411e44c OK

2025-11-13 08:18:15 +08:00

5.3 KiB

Raw Permalink Blame History

AI Meeting Assistant V2.1

一個智能會議助手系統，旨在通過轉錄、摘要和管理您會議中的行動項目來簡化您的工作流程。此全棧應用程式使用Python Flask後端提供強大的API服務，React前端提供動態用戶體驗。

🔑 主要功能

LDAP/AD 認證: 整合企業Active Directory進行安全登入，支援本地備用認證
用戶管理: 基於角色的訪問控制（管理員、用戶），管理員可刪除用戶帳號
會議管理: 創建、查看和管理會議，上傳轉錄或從音頻生成轉錄
AI智能摘要: 從冗長的會議轉錄自動生成簡潔摘要
行動項目追蹤: 自動預覽並批量創建摘要中的行動項目，手動添加、編輯和刪除行動項目並分配負責人和截止日期
權限控制: 基於用戶角色（管理員、會議所有者、行動項目所有者）的精細權限管理
檔案處理工具: 獨立的音頻提取、轉錄和文本翻譯工具

🏗️ 技術棧

後端:

框架: Flask + Gunicorn
資料庫: MySQL (生產環境) + SQLAlchemy ORM
認證: Flask-JWT-Extended + LDAP整合
異步任務: Celery + Redis
API: RESTful API設計

前端:

框架: React.js
UI庫: Material-UI (MUI)
構建工具: Vite
API通訊: Axios

部署:

容器化: Docker + Docker Compose
服務編排: Redis, Backend, Celery Worker, Celery Flower, Frontend
生產就緒: 包含健康檢查和資源限制

📋 系統需求

Docker Desktop (Windows/macOS) 或 Docker Engine (Linux)
Docker Compose V2
至少4GB可用記憶體
企業Active Directory (LDAP) 服務器訪問權限

🚀 快速部署

方法一：一鍵部署（推薦）

# 克隆專案
git clone <your-repository-url>
cd AI_meeting_assistant-V2.1

# 啟動所有服務（強制重建以確保使用最新代碼）
docker-compose up -d --build

# 檢查服務狀態
docker-compose ps

# 停止服務
docker-compose down

# 查看日誌
docker-compose logs -f

方法二：開發環境設置

如需自定義配置或開發調試，請參考下方的詳細設置說明。

🔧 詳細配置

環境變數配置

主要配置已在docker-compose.yml中設定，如需修改：

# 資料庫配置
DATABASE_URL: mysql+pymysql://username:password@host:port/database

# LDAP配置
LDAP_SERVER: your-domain.com
LDAP_PORT: 389
LDAP_BIND_USER_DN: CN=LdapBind,CN=Users,DC=DOMAIN,DC=COM
LDAP_BIND_USER_PASSWORD: your-bind-password
LDAP_SEARCH_BASE: OU=Users,DC=domain,DC=com
LDAP_USER_LOGIN_ATTR: userPrincipalName

# JWT配置
JWT_SECRET_KEY: your-super-secret-key

# AI服務配置（Dify API）
DIFY_API_BASE_URL: https://your-dify-server.com/v1
DIFY_STT_API_KEY: app-xxxxxxxxxx
DIFY_TRANSLATOR_API_KEY: app-xxxxxxxxxx
DIFY_SUMMARIZER_API_KEY: app-xxxxxxxxxx
DIFY_ACTION_EXTRACTOR_API_KEY: app-xxxxxxxxxx

服務端口

前端: http://localhost:12015
後端API: http://localhost:5000
Celery Flower監控: http://localhost:5555
Redis: localhost:6379

👥 用戶角色與權限

管理員權限

查看所有用戶列表
刪除用戶帳號（除自己外）
管理所有會議和行動項目
修改任何會議狀態

一般用戶權限

管理自己創建的會議
編輯分配給自己的行動項目
查看有權限的會議內容

預設管理員

系統預設將 ymirliu@panjit.com.tw 設為管理員角色
其他AD帳號預設為一般用戶角色

🔧 維護與監控

查看服務日誌

# 查看所有服務日誌
docker-compose logs -f

# 查看特定服務日誌
docker-compose logs -f backend
docker-compose logs -f celery-worker

健康檢查

系統包含自動健康檢查：

Backend: HTTP健康檢查
Frontend: HTTP健康檢查
Celery: 程序狀態監控

備份與恢復

# 資料庫備份（需要mysql客戶端）
mysqldump -h mysql.theaken.com -P 33306 -u A060 -p db_A060 > backup.sql

# 檔案備份
docker-compose exec backend tar -czf /app/uploads/backup.tar.gz /app/uploads

🛠️ 開發指南

本地開發設置

後端開發:

# 安裝依賴
pip install -r requirements.txt

# 啟動Flask開發服務器
flask run --port 5000

# 啟動Celery Worker
celery -A celery_worker.celery worker --loglevel=info

前端開發:

cd frontend
npm install
npm run dev

資料庫遷移

# 建立新遷移
docker-compose exec backend flask db migrate -m "Description"

# 應用遷移
docker-compose exec backend flask db upgrade

🐛 疑難排解

常見問題

1. LDAP認證失敗

檢查LDAP服務器連接性
驗證綁定用戶憑證
確認搜索基準DN正確

2. Celery任務無響應

檢查Redis服務狀態
重啟Celery Worker: docker-compose restart celery-worker
查看Worker日誌: docker-compose logs celery-worker

3. 前端無法連接後端

確認後端服務運行在5000端口
檢查防火牆設置
驗證API base URL配置

獲取支援

查看服務日誌進行初步診斷
檢查系統資源使用情況
聯繫IT管理員協助LDAP配置問題

📄 授權

此專案為企業內部使用，請遵守公司軟體使用政策。

版本: V2.1 最後更新: 2025-09-18 維護團隊: PANJIT IT Team

5.3 KiB Raw Permalink Blame History Unescape Escape