212 lines
5.3 KiB
Markdown
212 lines
5.3 KiB
Markdown
# 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) 服務器訪問權限
|
||
|
||
## 🚀 快速部署
|
||
|
||
### 方法一：一鍵部署（推薦）
|
||
|
||
```bash
|
||
# 克隆專案
|
||
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`中設定，如需修改：
|
||
|
||
```yaml
|
||
# 資料庫配置
|
||
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帳號預設為一般用戶角色
|
||
|
||
## 🔧 維護與監控
|
||
|
||
### 查看服務日誌
|
||
```bash
|
||
# 查看所有服務日誌
|
||
docker-compose logs -f
|
||
|
||
# 查看特定服務日誌
|
||
docker-compose logs -f backend
|
||
docker-compose logs -f celery-worker
|
||
```
|
||
|
||
### 健康檢查
|
||
系統包含自動健康檢查：
|
||
- Backend: HTTP健康檢查
|
||
- Frontend: HTTP健康檢查
|
||
- Celery: 程序狀態監控
|
||
|
||
### 備份與恢復
|
||
```bash
|
||
# 資料庫備份（需要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
|
||
```
|
||
|
||
## 🛠️ 開發指南
|
||
|
||
### 本地開發設置
|
||
|
||
1. **後端開發**:
|
||
```bash
|
||
# 安裝依賴
|
||
pip install -r requirements.txt
|
||
|
||
# 啟動Flask開發服務器
|
||
flask run --port 5000
|
||
|
||
# 啟動Celery Worker
|
||
celery -A celery_worker.celery worker --loglevel=info
|
||
```
|
||
|
||
2. **前端開發**:
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
### 資料庫遷移
|
||
```bash
|
||
# 建立新遷移
|
||
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 |