guoyu/Test/md/快速参考-课件管理.md

# 课件管理和视频播放 - 快速参考

## 🎯 你的配置信息

| 项目 | 值 |
|------|-----|
| **本机IP地址** | `192.168.137.1` |
| **后端端口** | `30091` |
| **后端访问地址** | `http://192.168.137.1:30091` |
| **文件存储路径** | `D:\wwwroot\study_web\web\profile\upload\` |

---

## 📂 文件夹结构

```
D:\wwwroot\study_web\web\profile\upload\
├── courseware\       # 课件文件（视频、文档等）
├── voice\           # 语音评测录音
├── screenshots\     # 屏幕监控截图
└── avatar\          # 用户头像
```

**创建命令**：右键以管理员身份运行 `一键配置本地环境.bat`

---

## 🚀 快速启动流程

### 1. 配置环境（首次使用）
```powershell
# 右键以管理员身份运行
一键配置本地环境.bat
```

### 2. 启动后端服务
```powershell
cd Study-Vue-redis\ry-study-admin
mvn spring-boot:run
```

### 3. 测试后端是否启动成功
浏览器访问: `http://192.168.137.1:30091`

### 4. 编译运行APP
在HBuilderX中打开 `fronted_uniapp\fronted_uniapp` 项目，运行到真机

---

## 📚 课件管理功能

### 后台管理系统操作

#### 1. 上传课件
1. 登录后台: `http://192.168.137.1:30091` 或 `http://localhost:30091`
2. 进入【教学管理】→【课件管理】
3. 点击【新增课件】
4. 填写信息：
   - **课件名称**: 如"第一课：拼音学习"
   - **所属课程**: 选择对应课程
   - **课件类型**: 视频/文档/音频
   - **课件文件**: 点击上传按钮
   - **排序号**: 控制显示顺序（数字越小越靠前）
5. 点击【确定】提交

#### 2. 文件上传限制
- **最大文件大小**: 2GB
- **支持的视频格式**: MP4, AVI, MKV, FLV（推荐MP4）
- **支持的文档格式**: PDF, PPT, PPTX, DOC, DOCX
- **支持的音频格式**: MP3, WAV, M4A

#### 3. 课件管理
- **查看列表**: 教学管理 → 课件管理
- **编辑课件**: 点击【修改】按钮
- **删除课件**: 点击【删除】按钮（会同时删除文件）
- **按课程筛选**: 使用课程下拉框筛选

### APP端使用

#### 1. 查看课件
1. 登录APP
2. 进入【课程学习】
3. 选择课程
4. 查看课件列表

#### 2. 播放视频
- 点击视频课件即可播放
- 支持暂停、快进、调节音量
- 自动记录学习进度

---

## 🎥 视频文件路径说明

### 路径映射关系

| 类型 | 示例 |
|------|------|
| **数据库存储** | `/profile/upload/2025/12/05/abc123.mp4` |
| **物理路径** | `D:\wwwroot\study_web\web\profile\upload\2025\12\05\abc123.mp4` |
| **APP访问URL** | `http://192.168.137.1:30091/profile/upload/2025/12/05/abc123.mp4` |
| **后台管理访问** | `http://192.168.137.1:30091/profile/upload/2025/12/05/abc123.mp4` |

### 访问流程

```
用户请求视频
    ↓
http://192.168.137.1:30091/profile/upload/2025/12/05/video.mp4
    ↓
Spring Boot (ResourcesConfig.java)
    ↓
映射到: D:\wwwroot\study_web\web\profile\upload\2025\12\05\video.mp4
    ↓
返回视频文件流
    ↓
浏览器/APP播放器播放
```

---

## 🔧 常用API接口

### 1. 文件上传
```http
POST http://192.168.137.1:30091/common/upload
Content-Type: multipart/form-data

file: [文件对象]
```

**返回示例**:
```json
{
  "code": 200,
  "msg": "操作成功",
  "fileName": "/profile/upload/2025/12/05/abc123.mp4",
  "url": "http://192.168.137.1:30091/profile/upload/2025/12/05/abc123.mp4"
}
```

### 2. 课件管理API

| 功能 | 方法 | URL |
|------|------|-----|
| 获取课件列表 | GET | `/study/courseware/list` |
| 获取课件详情 | GET | `/study/courseware/{id}` |
| 新增课件 | POST | `/study/courseware` |
| 修改课件 | PUT | `/study/courseware` |
| 删除课件 | DELETE | `/study/courseware/{id}` |
| APP端获取课件 | GET | `/study/courseware/app/list?courseId=xxx` |

---

## ❓ 常见问题

### Q1: APP无法连接后端？

**检查清单**:
- [ ] 手机和电脑在同一WiFi网络
- [ ] 防火墙已开放30091端口（运行`测试配置.bat`检查）
- [ ] 后端服务已启动
- [ ] APP配置的IP是 `192.168.137.1`

**快速测试**: 
在手机浏览器访问 `http://192.168.137.1:30091`，如果能打开登录页面，说明网络通畅。

### Q2: 视频无法播放？

**检查清单**:
- [ ] 视频文件确实存在于 `D:\wwwroot\study_web\web\profile\upload\` 目录
- [ ] 视频格式为MP4（其他格式可能不兼容）
- [ ] 在浏览器中直接访问视频URL测试
- [ ] 文件权限正确（右键 → 属性 → 安全）

**测试方法**:
1. 找到视频在数据库中的路径，如 `/profile/upload/2025/12/05/test.mp4`
2. 在浏览器访问: `http://192.168.137.1:30091/profile/upload/2025/12/05/test.mp4`
3. 如果能播放，说明服务器配置正确

### Q3: 上传课件失败？

**可能原因**:
1. 文件太大（超过2GB限制）
2. 目标文件夹不存在或无写权限
3. 磁盘空间不足

**解决方法**:
1. 检查文件大小
2. 运行 `一键配置本地环境.bat` 重新创建文件夹
3. 检查D盘剩余空间

### Q4: 如何修改IP地址？

**如果你的电脑IP变化了**:

1. 修改APP配置文件：
   - 文件: `fronted_uniapp\fronted_uniapp\src\utils\config.js`
   - 第17行: `const DEFAULT_SERVER_HOST = '新的IP地址'`
   - 第19行: `const DEV_SERVER_HOST = '新的IP地址'`

2. 重新编译APP

3. 或者在APP设置中动态配置（如果实现了设置页面）

---

## 🔐 安全提示

1. **开发环境**: 当前配置适用于局域网开发测试
2. **生产部署**: 需要修改为公网IP或域名
3. **防火墙**: 生产环境建议配置更严格的防火墙规则
4. **文件大小**: 根据实际需求调整上传限制
5. **备份**: 定期备份 `D:\wwwroot\study_web\web\profile\` 目录

---

## 📞 文件位置速查

| 文件 | 位置 |
|------|------|
| 后端配置 | `Study-Vue-redis\ry-study-admin\src\main\resources\application.yml` |
| APP配置 | `fronted_uniapp\fronted_uniapp\src\utils\config.js` |
| 课件控制器 | `Study-Vue-redis\ry-study-admin\src\main\java\com\ddnai\web\controller\study\StudyCoursewareController.java` |
| 文件上传工具 | `Study-Vue-redis\ry-study-common\src\main\java\com\ddnai\common\utils\file\FileUploadUtils.java` |
| 资源配置 | `Study-Vue-redis\ry-study-admin\src\main\java\com\ddnai\framework\config\ResourcesConfig.java` |

---

## 📝 测试检查单

使用前请完成以下检查：

- [ ] 运行 `一键配置本地环境.bat` (以管理员身份)
- [ ] 运行 `测试配置.bat` 验证配置
- [ ] 启动后端服务
- [ ] 浏览器访问 `http://192.168.137.1:30091` 测试
- [ ] 手机浏览器访问测试（手机连接同一WiFi）
- [ ] 编译运行APP到真机
- [ ] 上传一个测试视频课件
- [ ] 在APP中播放测试视频

全部通过后，系统即可正常使用！