一个现代化的师生互动答疑平台，集成AI智能助手，支持实时问答、交流论坛和学习资源推荐。
- 🙋 智能问答 - 学生提问，教师解答，支持富文本编辑和图片上传
- 💬 交流论坛 - 实时讨论区，支持点赞、评论、关注
- ⭐ 收藏关注 - 收藏问题、关注用户，个性化内容推荐
- 👨💼 后台管理 - 完善的管理端，用户、问题、科目统一管理
- 智能对话 - 基于阿里通义千问qwen-turbo模型
- 多轮对话 - 保持上下文，支持连续提问
- 问题分类 - 自动识别技术、学科、课程等问题类型
- 资源推荐 - 根据问题智能推荐学习资源
- 对话管理 - 会话历史、收藏、反馈一体化
- JDK 17+
- Node.js 16+
- MySQL 8.0+
- Redis 6.0+
- Maven 3.8+
# 1. 克隆项目
git clone https://github.com/yourusername/qa-system.git
cd qa-system
# 2. 导入数据库
mysql -u root -p qa_system_v2 < qa-system-backend/src/main/resources/db/schema.sql
# 3. 配置application.yml
cd qa-system-backend/src/main/resources
cp application-dev.yml.example application-dev.yml
# 修改数据库、Redis、AI API配置
# 4. 启动后端
cd qa-system-backend
mvn clean install
mvn spring-boot:run后端服务运行在 http://localhost:8080
# 1. 安装依赖
cd qa-system-frontend
npm install
# 2. 启动开发服务器
npm run dev前端应用运行在 http://localhost:5173
# 使用docker-compose一键启动
docker-compose up -dqa-system/
├── qa-system-backend/ # Spring Boot后端
│ ├── src/main/java/
│ │ └── com/qasystem/
│ │ ├── controller/ # REST API控制器
│ │ ├── service/ # 业务逻辑层
│ │ ├── mapper/ # MyBatis-Plus数据访问
│ │ ├── entity/ # 实体类
│ │ ├── dto/ # 数据传输对象
│ │ ├── config/ # 配置类
│ │ └── security/ # 安全认证
│ └── src/main/resources/
│ ├── db/ # 数据库脚本
│ └── application.yml # 配置文件
│
└── qa-system-frontend/ # Vue 3前端
├── src/
│ ├── api/ # API接口封装
│ ├── views/ # 页面组件
│ │ ├── admin/ # 管理端
│ │ ├── student/ # 学生端
│ │ ├── teacher/ # 教师端
│ │ ├── forum/ # 论坛
│ │ └── common/ # 公共页面(AI助手)
│ ├── components/ # 通用组件
│ ├── layouts/ # 布局组件
│ ├── stores/ # Pinia状态管理
│ ├── router/ # 路由配置
│ └── utils/ # 工具函数
└── package.json
=======
| 技术 | 版本 | 说明 |
|---|---|---|
| Spring Boot | 3.1.5 | 基础框架 |
| Spring Security | 6.1.5 | 安全认证 |
| MyBatis-Plus | 3.5.7 | ORM框架 |
| JWT | 0.12.3 | Token认证 |
| Redis | - | 缓存中间件 |
| MySQL | 8.0 | 数据库 |
| LangChain4j | 0.35.0 | AI集成框架 |
| 阿里百练 | - | AI模型服务 |
| Hutool | 5.8.25 | 工具库 |
| 技术 | 版本 | 说明 |
|---|---|---|
| Vue | 3.4.15 | 渐进式框架 |
| Vue Router | 4.2.5 | 路由管理 |
| Pinia | 2.1.7 | 状态管理 |
| Element Plus | 2.5.4 | UI组件库 |
| Axios | 1.6.5 | HTTP客户端 |
| Vite | 5.0.11 | 构建工具 |
| Marked | 11.1.1 | Markdown渲染 |
| Highlight.js | 11.9.0 | 代码高亮 |
POST /api/v1/auth/login # 用户登录
POST /api/v1/auth/register # 用户注册
POST /api/v1/auth/logout # 退出登录
GET /api/v1/questions # 获取问题列表
POST /api/v1/questions # 发布问题
GET /api/v1/questions/{id} # 获取问题详情
POST /api/v1/questions/{id}/answers # 回答问题
POST /api/ai/chat # AI对话
GET /api/ai/sessions # 获取会话列表
GET /api/ai/sessions/{id}/history # 获取会话历史
POST /api/ai/feedback # 提交反馈
POST /api/ai/bookmark/{id} # 收藏对话
完整API文档：API Documentation
=======
- 浏览问题广场，按科目筛选
- 发布问题，富文本编辑支持
- 查看教师回答，采纳最佳答案
- 使用AI助手获取学习帮助
- 查看待回答问题列表
- 回答学生问题
- 查看历史回答记录
- 用户管理（学生、教师）
- 问题审核与管理
- 科目分类管理
- 系统数据统计
- ChatGPT风格对话界面
- 实时Markdown渲染
- 代码语法高亮
- 学习资源推荐
- 对话历史管理
=======
spring:
datasource:
url: jdbc:mysql://localhost:3306/qa_system_v2
username: root
password: your_password
data:
redis:
host: localhost
port: 6379
jwt:
secret: your-secret-key
expiration: 604800000 # 7天
# AI配置
langchain4j:
dashscope:
api-key: your-dashscope-api-key
model-name: qwen-turboexport default defineConfig({
server: {
proxy: {
'/api': {
target: 'http://localhost:8080',
changeOrigin: true
}
}
}
})| 角色 | 权限 |
|---|---|
| 学生 | 提问、收藏、关注、使用AI助手 |
| 教师 | 回答问题、查看问题列表、使用AI助手 |
| 管理员 | 全部权限，包括用户管理、内容审核 |
管理员: admin / admin123
教师: teacher / teacher123
学生: student / student123
=======
user- 用户表student- 学生信息表teacher- 教师信息表question- 问题表answer- 回答表subject- 科目表forum- 论坛帖子表ai_conversation- AI对话历史表
完整数据库设计：Database Schema
- 构建前端
cd qa-system-frontend
npm run build- 打包后端
cd qa-system-backend
mvn clean package -DskipTests- Nginx配置
server {
listen 80;
server_name your-domain.com;
# 前端静态文件
location / {
root /var/www/qa-system-frontend/dist;
try_files $uri $uri/ /index.html;
}
# 后端API代理
location /api {
proxy_pass http://localhost:8080;
proxy_set_header Host $host;
}
}- 运行后端
java -jar qa-system-backend/target/qa-system-backend-2.0.0.jar欢迎贡献代码！请遵循以下步骤：
- Fork本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启Pull Request =======
本项目采用 MIT 协议开源
- 作者：ZSPSTRIVE
⭐ 如果这个项目对你有帮助，请给一个Star支持一下！