# 国语教育平台 - 项目介绍

## 📋 项目概述

**国语教育平台**是一个面向国语（普通话）教学的综合性在线教育系统，集成了课程学习、在线考试、语音评测、学习监控等功能。系统采用前后端分离架构，支持Web管理端和移动端（Android/iOS）应用。

- **项目名称**: 国语教育平台 (ry-study)
- **版本**: v2.1.1
- **开发单位**: DDNAI
- **适用场景**: 学校、培训机构的国语教学与管理

---

## 🎯 核心功能

### 1. 用户管理
- **多角色支持**: 管理员、教师、学生
- **用户注册/登录**: 支持账号密码登录，JWT Token认证
- **权限管理**: 基于RBAC的细粒度权限控制
- **学生审核**: 新注册学生需要管理员审核
- **班级管理**: 支持按教育阶段、年级、班级组织学生

### 2. 课程学习
- **课程管理**: 
  - 课程创建、编辑、发布
  - 课程分类（按学科、年级）
  - 课程封面、简介、详情
- **课件管理**:
  - 支持视频、音频、文档等多种格式
  - 课件章节组织
  - 在线播放/预览
- **学习记录**:
  - 自动记录学习进度
  - 学习时长统计
  - 学习轨迹追踪
- **课程分配**:
  - 教师可将课程分配给指定班级
  - 学生查看已分配课程

### 3. 在线考试
- **题库管理**:
  - 支持单选题、多选题、判断题、填空题、简答题
  - 题库分类管理
  - 题目导入/导出（Excel）
- **试卷管理**:
  - 手动组卷
  - 随机抽题组卷
  - 试卷预览
- **考试功能**:
  - 在线答题
  - 自动计时
  - 自动提交
  - 防作弊（屏幕监控）
- **成绩管理**:
  - 自动阅卷（客观题）
  - 手动阅卷（主观题）
  - 成绩统计分析
  - 错题回顾

### 4. 语音评测 ⭐
- **语音识别**:
  - 实时录音
  - 语音转文字（ASR）
  - 支持离线识别（Vosk引擎）
- **发音评测**:
  - 与标准文本对比
  - 发音准确度评分
  - 详细评测报告
- **评测记录**:
  - 历史评测记录查询
  - 评测内容回放
  - 进步趋势分析

### 5. 学习监控
- **屏幕录制**:
  - 考试过程屏幕录制
  - WebRTC实时传输
  - 录制文件存储
- **学习行为分析**:
  - 学习时长统计
  - 学习频率分析
  - 学习效果评估

### 6. 数据统计
- **学生数据**:
  - 学习进度统计
  - 考试成绩统计
  - 语音评测统计
- **教师数据**:
  - 班级学习情况
  - 课程完成率
  - 考试通过率
- **管理员数据**:
  - 平台整体数据
  - 用户活跃度
  - 系统使用情况

---

## 💡 技术特色

### 1. 内网部署支持
- 完全支持局域网环境部署
- 无需公网访问
- 数据安全可控

### 2. 离线语音识别
- 集成Vosk离线语音识别引擎
- 不依赖第三方云服务
- 保护学生隐私

### 3. 横屏优化
- 移动端强制横屏显示
- 适配平板设备
- 更好的视频学习体验

### 4. 实时监控
- WebRTC实时屏幕共享
- 考试过程监控
- 防作弊机制

### 5. 响应式设计
- 支持多种屏幕尺寸
- 自适应布局
- 统一的用户体验

---

## 📱 支持平台

### 管理端（Web）
- Chrome、Firefox、Edge等现代浏览器
- 响应式设计，支持PC和平板

### 移动端（App）
- Android 5.0+（API Level 21+）
- iOS 10.0+
- 支持手机和平板

---

## 🎓 适用场景

### 1. 学校教学
- 普通话课程教学
- 学生发音训练
- 在线考试测评

### 2. 培训机构
- 国语培训课程
- 学员管理
- 学习效果评估

### 3. 企业培训
- 员工普通话培训
- 培训效果考核
- 学习进度跟踪

### 4. 自主学习
- 个人发音练习
- 在线课程学习
- 自我测评

---

## 🔐 安全特性

- **数据加密**: 敏感数据加密存储
- **JWT认证**: 安全的Token认证机制
- **权限控制**: 细粒度的权限管理
- **SQL防注入**: MyBatis参数化查询
- **XSS防护**: 前端输入过滤
- **日志审计**: 完整的操作日志记录

---

## 📊 系统优势

### 1. 功能完整
- 涵盖教学全流程
- 从课程学习到考试评测
- 一站式解决方案

### 2. 易于部署
- 支持内网部署
- Docker容器化部署
- 详细的部署文档

### 3. 性能优良
- Redis缓存优化
- 数据库连接池
- 静态资源CDN

### 4. 扩展性强
- 模块化设计
- 插件化架构
- 易于二次开发

### 5. 用户体验好
- 简洁的界面设计
- 流畅的交互体验
- 完善的错误提示

---

## 📈 未来规划

- [ ] AI智能评测（发音细节分析）
- [ ] 多语言支持（方言识别）
- [ ] 直播课堂功能
- [ ] 社交学习功能（学习圈）
- [ ] 移动端教师管理功能
- [ ] 数据可视化大屏
- [ ] 微信小程序版本

---

## 📞 技术支持

如有问题或建议，请联系技术支持团队。

**项目地址**: http://www.ddnai.com  
**技术栈**: Spring Boot + Vue.js + uni-app  
**开发团队**: DDNAI