学之思开源考试系统(Postgresql版)技术文档
1. 项目概述
学之思开源考试系统是一款基于Java+Vue的前后端分离考试系统,支持Web端和微信小程序。系统采用PostgreSQL数据库,具有界面友好、部署灵活等特点,适用于教育机构、企业培训等场景。
2. 安装指南
2.1 环境要求
- JDK 1.8+
- Maven 3.6+
- Node.js 12+
- PostgreSQL 9.5+
- Redis 5.0+
2.2 数据库准备
- 创建PostgreSQL数据库实例
- 执行项目提供的SQL脚本初始化数据库结构
- 配置数据库连接参数(见后端配置)
3. 项目安装方式
3.1 后端部署
- 克隆项目仓库:
git clone https://gitee.com/mindskip/xzs.git - 修改配置文件:
application.yml配置数据库连接application-dev.yml配置Redis等组件
- 构建项目:
mvn clean package - 启动服务:
java -jar target/xzs.jar
3.2 前端部署
- 进入前端目录:
cd xzs-web - 安装依赖:
npm install - 修改API地址配置
- 启动开发服务器:
npm run serve - 生产环境构建:
npm run build
3.3 Docker部署
- 构建Docker镜像:
docker-compose build - 启动容器:
docker-compose up -d
4. 使用说明
4.1 学生系统
- 注册/登录:使用年级、用户名和密码登录系统
- 考试功能:
- 任务中心:完成管理员发布的年级任务
- 固定试卷:可重复练习的自批改试卷
- 时段试卷:限时完成的练习试卷
- 学习辅助:
- 考试记录查看
- 错题本自动收集
- 个人信息管理
4.2 管理系统
- 用户管理:
- 学生/管理员账号管理
- 禁用/启用账户
- 考试管理:
- 学科管理
- 试卷创建(时段/固定/任务试卷)
- 题目管理(支持多种题型)
- 系统监控:
- 用户活跃度统计
- 消息推送管理
- 操作日志查看
4.3 小程序使用
- 微信绑定登录
- 移动端考试功能
- 错题本同步
- 消息实时接收
5. API使用文档
5.1 认证接口
POST /api/user/login用户登录POST /api/user/register用户注册
5.2 考试接口
GET /api/exam/paper/list获取试卷列表POST /api/exam/paper/start开始考试POST /api/exam/paper/submit提交试卷
5.3 管理接口
POST /api/admin/user/create创建用户POST /api/admin/paper/create创建试卷GET /api/admin/dashboard获取仪表盘数据
5.4 数据格式示例
// 登录请求示例
{
"userName": "student01",
"password": "123456"
}
// 试卷提交响应示例
{
"code": 200,
"message": "提交成功",
"data": {
"score": 85,
"correctRate": 0.85
}
}
6. 注意事项
- 生产环境请务必修改默认密码
- 定期备份数据库
- 微信小程序需配置合法域名
- 时段试卷需确保服务器时间准确
本系统采用AGPL开源协议,使用时请遵守相关许可条款。如需商业支持,请联系项目官方团队。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



