SpringBoot+Mybatis在线问卷系统.zip

# 在线问卷系统 > 这是个前后端分离的、支持跨域访问的REST风格的`Vue.js`+`Spring Boot`项目，开发工具为`IDEA`，数据库为`MySQL`。由于当时时间匆忙及能力有限，部分功能实现有待进一步优化，可移步参考我最近整理的[SpringBoot 2.x+Maven多模块项目示例](https://github.com/BlueDriver/SpringBoot-rest-demo)进行修改。 》[前端地址](https://github.com/Nice-Ming/Questionnaire-management/tree/master_online)《 》[体验地址](http://www.niceming.cn/questionnaire/)《 # 数据库名称：questionnaire 字符集：UTF-8 ## user表 字段 | 类型 | 长度 |Null| 默认 | 主键 | 唯一 | 说明 :--- |:--- |:--- |:--- |:--- |:--- |:--- |:--- id |varchar|64| not | | Y | |用户ID username |varchar|64| not | | | |用户昵称 password |varchar|64| not | | | |md5加密后的密码 email |varchar|64| not | | | Y |邮箱 create_time |datetime| | not | | | |用户创建时间 last_login_time|datetime| | null |null | | |用户最后登录时间 status |int| | not | 0 | | |用户账号状态<br>0：未激活<br>1：已激活 random_code |varchar|64| not | | |Y |随机码（用户激活邮箱） ## paper表 字段 | 类型 | 长度 |Null| 默认 | 主键 | 唯一 | 说明 :--- |:--- |:--- |:--- |:--- |:--- |:--- |:--- id |varchar|64| not | | Y | |问卷ID user_id|varchar|64| not | | | |用户ID，外键 title|varchar|64| not | | | |问卷标题 create_time|datetime| | not | | | |问卷创建时间 status|int| | not | 0 | | |问卷状态<br>0：未发布<br>1：已发布<br>2：已结束<br>3：已删除 start_time|datetime| | null | null | | |开始时间 end_time|datetime| | null | null | | |截止时间 ## question表 字段 | 类型 | 长度 |Null| 默认 | 主键 | 唯一 | 说明 :--- |:--- |:--- |:--- |:--- |:--- |:--- |:--- id |varchar|64| not | | Y | |问题ID paper_id|varchar|64| not | | | |问卷ID，外键 create_time|datetime| | not | | | |问题创建时间 question_type|int| | not | | | |问题类型<br>1：单选<br>2：多选<br>3：简答 question_title|varchar|128| not | | | |问题标题 question_option|varchar|512| not | | | |问题选项<br>1：选择题，数组字符串<br>[option1,option2,option3...]<br>2：简答题，空数组字符串<br>[] ## answer表 字段 | 类型 | 长度 |Null| 默认 | 主键 | 唯一 | 说明 :--- |:--- |:--- |:--- |:--- |:--- |:--- |:--- id |varchar|64| not | | Y | |答案ID paper_id|varchar|64| not | | | |问卷ID，外键 question_id|varchar|64| not | | | |问题ID，外键 question_type|int| | not | | | |问题类型<br>1：单选<br>2：多选<br>3：简答 create_time|datetime| | not | | | |答题时间 answer_option|varchar|512| not | | | |答题选项<br>1：选择题，来自question表的问题选项，单选题只有一个option，多选至少一个<br>[option1,option2,option3...]<br>2：简答题，至多一个元素的数组字符串<br>["只能有一个元素"]<br>若未达，则无元素<br>[] # API 编码方式均为UTF-8 ## 1.管理员相关 ### 1.1 注册 #### 接口地址 ``` domain/api/v1/register ``` #### 请求方式 HTTP POST #### 请求示例 ``` { "username": "Alice", "password": "123456", "email": "alice@gmail.com" } ``` > #### 请求参数 参数 | 类型 | 是否必须 | 取值范围 | 说明 :--- |:---|:---|:---|:--- username|String|Y| 2-64个字符 |用户名（昵称） password|String|Y| 6-64个字符 |登录密码 email |String|Y| 5-64个字符且格式正确 |邮箱 #### 返回参数 返回示例 ``` { "code": 0, "msg": "ok", "data": 0 } ``` > #### 参数说明 参数 | 类型 | 是否必须 | 取值范围 | 说明 :--- |:--- |:--- |:--- |:--- code |int |Y | - |请求状态码 msg |String|Y | - |消息提示 data |int |N | - |结果数据 #### code说明 状态值 |说明 :--- |:--- -1 |token失效或未登录（用于需要登录后才能进行的操作） 0 |请求成功（全文适用，下文不再赘述） 1 |系统异常（全文适用，下文不再赘述） 2 |参数不正确（全文适用，下文不再赘述） > #### code的补充 * code非0时，无data参数，可通过msg判断问题原因 * code取0时，若data中有值，则data参数存在，否则无data参数 #### data说明 状态值 |说明 :--- |:--- 0 |注册成功，等待邮件激活 1 |邮箱已被注册过且被激活 2 |邮箱被注册过，但未激活，重新发送激活邮件 ### 1.2 激活 #### 接口地址 ``` domain/api/v1/activate ``` #### 请求方式 HTTP GET 请求示例 ``` domain/api/v1/activate/code ``` > #### 请求参数 参数 | 类型 | 是否必须 | 取值范围 | 说明 :--- |:---|:---|:---|:--- code |String|Y| - |激活码(即随机码） #### 返回参数 无 #### 说明 1. 若激活成功，跳转success页面 2. 若激活码已失效，跳转invalid页面 ### 1.3 登录 #### 接口地址 ``` domain/api/v1/login ``` #### 请求方式 HTTP POST #### 请求示例 ``` { "email": "alice@gmail.com"， "password": "123456" } ``` > #### 请求参数 参数 | 类型 | 是否必须 | 取值范围 | 说明 :--- |:---|:---|:---|:--- email |String|Y| 5-64个字符 |邮箱 password|String|Y| 6-64个字符 |登录密码 #### 返回参数 返回示例 ``` //登录成功 { "code": 0, "msg": "ok", "data": { "result": 0, "token": "abcdefghijkl12345", "username": "Alice", "email": "abc@gmail.com } } //登录失败 { "code": 0, "msg": "password error", "data": { "result": 1 } } ``` > #### 参数说明 参数 | 类型 | 是否必须 | 取值范围 | 说明 :--- |:--- |:--- |:--- |:--- code |int |Y | - |请求状态码 msg |String|Y | - |消息提示 data |Object|N | - |结果 #### data说明 参数 | 类型 | 是否必须 | 取值范围 | 说明 :--- |:--- |:--- |:--- |:--- result |int |Y | - |结果 token |String |N | - |**登陆成功后用于身份识别，凡请求的URL中含`admin`都需要将token放入请求header** username|String |N | - |昵称 email |String |N | - |邮箱 #### result说明 取值 |说明 :--- |:--- 0 |登录成功 1 |密码错误 2 |用户不存在 3 |账号未激活 > header使用token示例 ``` ... headers: {'token': token } ... ``` ### 1.4 退出登录 #### 接口地址 ``` domain/api/v1/admin/logout ``` #### 请求方式 HTTP GET #### 请求示例 无 > #### 请求参数 无 #### 返回参数 返回示例 ``` { "code": 0, "msg": "ok", "data": 0 } ``` > #### 参数说明 参数 | 类型 | 是否必须 | 取值范围 | 说明 :--- |:--- |:--- |:--- |:--- code |int |Y | - |请求状态码 msg |String|Y | - |消息提示 data |int |N | - |结果：0.退出成功，1.失败（未登录或登录已超时） ## 2.问卷相关 ### 2.1 管理员获取问卷列表 #### 接口地址 ``` domain/api/v1/admin/paper-lists ``` #### 请求方式 HTTP GET #### 请求示例 无 > #### 请求参数 无 #### 返回参数 返回示例 ``` //成功 { "code": 0, "msg": "ok", "data": [ {"id": "12345678910","title": "问卷", "status": 0, "createTime": 1536887397173, "startTime": "2018-09-20", "endTime": "2018-10-01"}, {"id": "22345678910","title": "问卷标题", "status": 1, "createTime": 1536887397666, "startTime": "2018-09-10", "endTime": "2018-10-01"}, {"id": "32345678910","title":