# iMeeting - 智慧会议平台

## 项目简介

iMeeting 是一个基于 AI 技术的智能会议记录与内容管理平台,通过自动化的语音转录、说话人识别和 AI 摘要功能,帮助专业人士高效管理会议内容,从繁琐的记录工作中解放出来。

## 核心价值

- **解放生产力** - 自动化的会议转录和摘要,让用户从繁琐的记录工作中解放出来
- **信息不丢失** - 精准记录每一次会议的细节,确保关键信息和决策得到妥善保存
- **高效回顾** - 通过时间轴、发言人和关键词,快速定位会议内容
- **便捷分享** - 轻松分享会议纪要、材料和关键节点给相关人员

## 技术栈

### 平台端 (Backend)
- **框架**: Python 3.9+ / FastAPI
- **数据库**: MySQL 5.7+
- **缓存**: Redis 5.0+
- **AI服务**: 阿里云通义千问 (Dashscope)
  - 语音识别: Paraformer-v2
  - 说话人分离
  - 大语言模型摘要
- **存储**: 本地对象存储
- **身份认证**: JWT / Python-JOSE
- **部署**: Docker / Nginx

### 客户端 (Frontend)
- **框架**: React 19.1 + Vite 7.0
- **UI组件**: Ant Design 5.27
- **路由**: React Router DOM 7.7
- **Markdown**: @uiw/react-md-editor 4.0
- **可视化**: Markmap (思维导图)
- **其他工具**:
  - Axios (HTTP 客户端)
  - html2canvas + jsPDF (导出功能)
  - QRCode.react (二维码生成)
  - Lucide React (图标库)

## 功能模块

### 平台功能

| 功能模块 | 功能描述 | 状态 |
|---------|---------|------|
| **用户管理** | 用户创建、编辑、删除、密码重置、角色权限管理 | ✅ 已完成 |
| **会议管理** | 会议创建、编辑、删除、参会人员管理 | ✅ 已完成 |
| **音频处理** | 音频文件上传、存储、格式验证 | ✅ 已完成 |
| **异步转录服务** | 基于Paraformer的异步语音识别 | ✅ 已完成 |
| **说话人分离** | 基于CAM++ ,支持自定义标签 | ✅ 已完成 |
| **AI 摘要生成** | 异步生成会议纪要,支持自定义 Prompt | ✅ 已完成 |
| **任务状态管理** | 转录任务和 LLM 任务的状态追踪 | ✅ 已完成 |
| **声纹采集** | 用户声纹数据采集和管理 | ✅ 已完成 |
| **身份认证** | JWT Token 认证、登录登出、Token 刷新 | ✅ 已完成 |
| **图片上传** | 会议相关图片上传,支持 Markdown 引用 | ✅ 已完成 |
| **多会议知识模块** | 基于多会议摘要的知识总结 | ✅ 已完成 |
| **完整的对外接口** | 提供基于PC客户端、手机客户端、专用设备的服务接口 | ✅ 已完成 |
| | | |
| *待扩展功能* | *以下功能将在后续版本中添加* | |
| **对话模式的M-Agent** | 对话模式的会议Agent| |
| **平台多租户**| 云平台支持多租户| |

### PC客户端功能

| 功能模块 | 功能描述 | 状态 |
|---------|---------|------|
| **用户登录** | 登录界面、Token 存储、自动登录 | ✅ 已完成 |
| **会议列表** | 会议展示、筛选、搜索 | ✅ 已完成 |
| **会议采集** | 支持快速会议和自定义会议 | ✅ 已完成 |
| **导出功能** | 会议纪要预览 | ✅ 已完成 |
| **响应式设计** | 适配不同屏幕尺寸 | ✅ 已完成 |
| | | |
| *待扩展功能* | *以下功能将在后续版本中添加* | |
| **声纹采集界面** | 声纹录制、上传、状态管理 | |
| **会议总结概览** | 获取按会议ID的总结一览| |

### 手机客户端功能
| 功能模块 | 功能描述 | 状态 |
|---------|---------|------|

## 快速开始

### 环境要求

- Node.js 16+
- Python 3.9+
- MySQL 5.7+
- Redis 5.0+
- Docker (可选)

### 安装与运行

#### 后端启动

```bash
cd backend
pip install -r requirements.txt
python main.py
```

默认运行在 `http://localhost:8000`

#### 前端启动

```bash
cd frontend
npm install
npm run dev
```

默认运行在 `http://localhost:5173`

### 配置说明

详细的配置文档请参考:
- 数据库设计: [database.md](./database.md)
- 项目详细设计: [project.md](./project.md)
- AI 集成文档: [AI.md](./AI.md)

## 核心特性

### 异步任务处理

系统采用异步任务架构,支持大文件和长时间处理:

- **语音转录任务**: 基于阿里云 Dashscope 的异步 API,支持任务状态追踪
- **AI 摘要任务**: 使用 FastAPI BackgroundTasks,支持进度更新和轮询

### 数据安全

- JWT Token 认证机制
- 基于角色的权限控制 (RBAC)
- 密码 bcrypt 加密
- Token 黑名单机制

### 高性能

- Redis 缓存任务状态
- 异步处理避免阻塞
- 分页查询优化
- 音频流式传输

## API 文档

启动后端服务后,访问以下地址查看 API 文档:

- Swagger UI: `http://localhost:8000/docs`
- ReDoc: `http://localhost:8000/redoc`

## 未来规划

- [ ] 实时转录 - 支持对正在进行的会议进行实时语音转文字
- [ ] 日历集成 - 与 Google Calendar、Outlook Calendar 集成
- [ ] 行动项提取 - AI 自动识别会议中的待办事项
- [ ] 跨会议搜索 - 对所有会议内容进行全文语义搜索
- [ ] 移动端应用 - 开发 iOS 和 Android 原生应用
- [ ] 多语言支持 - 支持中英文等多语言界面
- [ ] 会议协作 - 支持多人实时协作编辑会议纪要
- [ ] 数据分析 - 会议统计分析和可视化报表

## 许可证

[请添加许可证信息]

## 联系方式

[请添加联系方式]