# 管理后台功能说明

## 功能概览

管理后台提供了完整的系统管理功能，包括用户管理、聊天监控、AI模型配置、工具管理、数字员工管理和数据分析。

## 1. 用户管理

### 功能列表
- ✅ 查看所有用户列表
- ✅ 创建新用户
- ✅ 查看用户详情
- ✅ 启用/禁用用户账号
- ✅ 删除用户
- ✅ 搜索和筛选用户

### 使用说明
1. 点击左侧菜单"用户管理"进入用户管理页面
2. 点击"添加新用户"按钮创建新用户
3. 在用户列表中可以查看、编辑、禁用或删除用户
4. 使用搜索框快速查找特定用户

### API 接口
- `GET /api/admin/users` - 获取用户列表
- `POST /api/admin/users` - 创建新用户
- `GET /api/admin/users/{user_id}` - 获取用户详情
- `PUT /api/admin/users/{user_id}/status` - 更新用户状态
- `DELETE /api/admin/users/{user_id}` - 删除用户

## 2. 聊天信息管理

### 功能列表
- ✅ 查看所有聊天记录
- ✅ 实时监控消息
- ✅ AI 敏感信息分析
- ✅ 风险等级标记
- ✅ 搜索和筛选消息

### 使用说明
1. 点击左侧菜单"聊天信息"进入聊天管理页面
2. 查看所有聊天记录，包括发送者、房间、内容和时间
3. 点击"AI 分析"按钮对消息进行敏感信息检测
4. 右侧面板显示实时监控统计数据

### API 接口
- `GET /api/admin/chat-logs` - 获取聊天记录
- `POST /api/admin/analyze-sensitive` - AI 分析敏感消息

## 3. 大模型管理

### 功能列表
- ✅ 查看所有 AI 模型
- ✅ 添加新模型配置
- ✅ 编辑模型参数
- ✅ 删除模型
- ✅ 监控模型使用情况

### 使用说明
1. 点击左侧菜单"大模型管理"进入模型管理页面
2. 点击"添加新模型"按钮配置新的 AI 模型
3. 填写模型名称、API Key 和 Base URL
4. 在模型卡片中可以配置或删除模型

### 配置示例
```json
{
  "name": "gpt-4",
  "api_key": "sk-xxxxxxxxxxxxxxxx",
  "base_url": "https://api.openai.com/v1"
}
```

### API 接口
- `GET /api/ai-agents/models` - 获取模型列表
- `POST /api/ai-agents/models` - 创建新模型
- `PUT /api/ai-agents/models/{model_id}` - 更新模型
- `DELETE /api/ai-agents/models/{model_id}` - 删除模型

## 4. 工具管理

### 功能列表
- ✅ 查看所有工具
- ✅ 添加新工具
- ✅ 编辑工具配置
- ✅ 删除工具
- ✅ 配置工具参数 Schema

### 使用说明
1. 点击左侧菜单"工具管理"进入工具管理页面
2. 点击"添加新工具"按钮创建新工具
3. 填写工具名称、描述和参数 Schema（JSON 格式）
4. 在工具卡片中可以编辑或删除工具

### 参数 Schema 示例
```json
{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "城市名称"
    },
    "units": {
      "type": "string",
      "enum": ["metric", "imperial"],
      "description": "温度单位"
    }
  },
  "required": ["city"]
}
```

### API 接口
- `GET /api/ai-agents/tools` - 获取工具列表
- `POST /api/ai-agents/tools` - 创建新工具
- `PUT /api/ai-agents/tools/{tool_id}` - 更新工具
- `DELETE /api/ai-agents/tools/{tool_id}` - 删除工具

## 5. 数字员工管理

### 功能列表
- ✅ 查看所有数字员工
- ✅ 创建新数字员工
- ✅ 配置员工能力
- ✅ 分配工具权限
- ✅ 删除数字员工

### 使用说明
1. 点击左侧菜单"数字员工管理"进入员工管理页面
2. 点击"创建新员工"按钮创建数字员工
3. 选择使用的 AI 模型
4. 编写系统提示词定义员工角色
5. 选择员工可以使用的工具

### 配置示例
```json
{
  "name": "客服助手",
  "model_id": 1,
  "system_prompt": "你是一个专业的客服助手，负责回答用户问题，提供友好和专业的服务。",
  "tool_ids": [1, 2, 3]
}
```

### API 接口
- `GET /api/ai-agents/employees` - 获取数字员工列表
- `POST /api/ai-agents/employees` - 创建新数字员工
- `PUT /api/ai-agents/employees/{emp_id}` - 更新数字员工
- `DELETE /api/ai-agents/employees/{emp_id}` - 删除数字员工

## 6. 数据分析中心

### 功能列表
- ✅ 实时统计数据展示
- ✅ 每小时消息量趋势图
- ✅ 消息风险分布饼图
- ✅ 用户活跃度分析
- ✅ 系统性能监控

### 使用说明
1. 点击左侧菜单"数据分析"进入分析中心
2. 查看顶部统计卡片了解系统整体情况
3. 查看趋势图分析消息量变化
4. 查看饼图了解消息风险分布

### 统计指标
- 总用户数
- 活跃用户数
- 消息总量
- AI 模型数
- 工具数量
- 数字员工数

### API 接口
- `GET /api/admin/dashboard-stats` - 获取仪表板统计
- `GET /api/admin/analytics/hourly` - 获取每小时分析
- `GET /api/admin/analytics/risk-distribution` - 获取风险分布

## 技术栈

### 前端
- React 18
- React Router v6
- Ant Design (Modal, Form, Input, Select)
- Recharts (数据可视化)
- Zustand (状态管理)
- Axios (HTTP 客户端)

### 后端
- FastAPI
- SQLAlchemy
- PostgreSQL / SQLite
- JWT 认证
- WebSocket (实时通信)

## 安装和运行

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

### 前端
```bash
cd admin_frontend
npm install
npm run dev
```

### 测试
```bash
cd backend
python test_admin_features.py
```

## 默认管理员账号

- 用户名: `admin`
- 密码: `admin123`

## 注意事项

1. 首次使用需要创建管理员账号
2. 删除用户会同时删除其相关数据
3. AI 分析功能需要配置相应的模型
4. 工具参数 Schema 必须是有效的 JSON 格式
5. 数字员工需要先配置模型才能创建

## 未来计划

- [ ] 批量操作功能
- [ ] 数据导出功能
- [ ] 更详细的日志记录
- [ ] 权限细粒度控制
- [ ] 多语言支持
- [ ] 主题切换
- [ ] 移动端适配

## 问题反馈

如有问题或建议，请联系开发团队。
