发表于： 2017-12-28 21:55:12
0 583
一.今天完成的主要事情
1.继续和pm沟通需求上的问题
和PM沟通了之后发现学习模块的逻辑要更加复杂一些,有些细节需求要进一步确定,比如
比如这里,这个顺序练习要求上次用户从哪道题目返回,这次也跳到上次的位置,不是我们之前想象的每次都是从头开始,所以在设计接口的时候要考虑这种情况
除了以上这个例子,类似的还有很多,都是乍一看好像对需求都没有什么异议了,但是一细看,还是有很多细节问题需要注意,再比如模拟考试中的题目选择
一开始给的需求是这样,看似没什么问题,但是一看题目表,还有一种题型是多选题,那么多选题有没有呢,再去沟通,发现科目四中是有多选题的,所以最后的需求变成了这样
类似的还有很多,不过现在基本上终于把需求确定下来了
2.修改接口文档,修改之前的代码
重新更改之后的接口文档为:
获取顺序/未做题目/错题/收藏题目练习列表接口
完成状态
后端:假数据
前端:
GET /a/u/practice/portion/list
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| studentId | number | 学员Id | 是 | |
subjectType | String | 科目 | 是 | 1为科目1; 4为科目4 |
| type | number | 类型 | 是 | 0为顺序练习, 1为未做题目练习, 2为错题练习, 3为收藏题目练习 |
| practiceId | number | 题目ID | 是 | |
| size | number | 页长 | 否 | |
| mode | number | 方式 | 是 | 0为向前查找,1为向后查找 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
total | number | 数据总条数 |
|
data | array | 数据 |
|
data：
字段 | 类型 | 说明 | 备注 |
subjectPracticeList | array | 试题列表 |
subjectPracticeList：
字段 | 类型 | 说明 | 备注 |
| id | number | 练习题id | |
| questionsStems | string | 题干 | |
| subjecType | string | 试题科目类型 | 1为科目1, 4为科目4 |
| chapter | string | 习题所在章节 | |
| optionA | string | 选项 | 判断题中为正确 |
| optionB | string | 选项 | 判断题中为错误 |
| optionC | string | 选项 | |
| optionD | string | 选项 | |
| analyse | string | 试题分析 | |
| picture | string | 试题相关图片 | 图片的链接名称,从服务器静态资源获取 |
| answer | string | 答案 | |
| ishard | number | 难度等级 | 备用,暂时没有用到的地方 |
| speciaType | string | 专项练习类型 | 试题专项练习类型(时间题,距离题,易错题等),也就是考点 |
| type | string | 题目类型 | (单选,判断,多选等) |
获取练习题目ID列表接口
完成状态
后端:
前端:
GET /a/u/practice/key/list
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
subjecType | String | 科目 | 是 | 1为科目1; 4为科目4 |
| type | number | 类型 | 是 | 0为顺序获取全部IdList, 1为随机获取全部IdList, 2为专项练习时获取全部IdList,3为模拟考试时获取IdList 4为查看收藏时获取全部IdList,5为查看错题时获取IDList |
| specia | String | 考点 | 否 | 当type=2时必填 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
data | Array | Id列表 |
|
data
字段 | 类型 | 说明 | 备注 |
practiceId | number | 题目ID |
|
status | number | 题目状态 | 0为未做, 1为已做且做对, 2为已做且做错 |
根据IDList获取练习试题列表接口
完成状态
后端:
前端:
GET /a/u/practice/list
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
subjecType | String | 科目 | 是 | 1为科目1; 4为科目4 |
| idList | Array | 题目IdList | 是 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
total | number | 数据总条数 |
|
data | array | 数据 |
|
data：
字段 | 类型 | 说明 | 备注 |
subjectPracticeList | array | 试题列表 |
subjectPracticeList：
字段 | 类型 | 说明 | 备注 |
| id | number | 练习题id | |
| questionsStems | string | 题干 | |
| subjecType | string | 试题科目类型 | 1为科目1, 4为科目4 |
| chapter | string | 习题所在章节 | |
| optionA | string | 选项 | 判断题中为正确 |
| optionB | string | 选项 | 判断题中为错误 |
| optionC | string | 选项 | |
| optionD | string | 选项 | |
| analyse | string | 试题分析 | |
| picture | string | 试题相关图片 | 图片的链接名称,从服务器静态资源获取 |
| answer | string | 答案 | |
| ishard | number | 难度等级 | 备用,暂时没有用到的地方 |
| speciaType | string | 专项练习类型 | 试题专项练习类型(时间题,距离题,易错题等),也就是考点 |
| type | string | 题目类型 | (单选,判断,多选等) |
移除单个错题
完成状态
后端:
前端:
PUT /a/u/note/error/{id}
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
清空所有错题接口
DELETE a/u/note/error
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| idList | array | 错题IDList | 是 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
添加已做的题目
完成状态
后端:
前端:
POST /a/u/note
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| studentId | number | 学员ID | ||
| id | number | 试题id | 是 | |
| targetType | number | 科目类型 | 是 | 科目1为1 科目4为4 |
| type | number | 题目类型 | 是 | 1为正确 0为错误 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
查看模拟考试结果列表接口
完成状态
后端:
前端:
GET /a/u/mocks/list
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| studentId | number | 学员ID | 是 | |
| type | number | 科目类型 | 是 | 科目1为1 科目4为4 |
| page | number | 页长 | 否 | |
| size | number | 页数 | 否 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
| total | number | 总数 | |
| data | Array | 数据 |
data
字段 | 类型 | 说明 | 备注 |
| id | number | 自增长ID |
|
| uid | number | 用户id |
|
| time | number | 考试消耗时间 | |
| rights | number | 正确数 | |
| wrong | number | 错题数 | |
| createAt | number | 数据创建时间/考试时间 |
保存模拟考试结果
完成状态
后端:
前端:
POST /a/u/mocks/
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| studentId | number | 学员ID | 是 | |
| type | number | 科目类型 | 是 | 科目1为1 科目4为4 |
| time | number | 耗费时间 | 是 | 模拟考试用掉的总时间 |
| rights | number | 答对试题数 | 是 | |
| wrong | number | 答错试题数 | 是 | |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
题目纠错
完成状态
后端:
前端:
POST /a/u/correction
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| type | number | 问题类型 | 是 | 题目不全,题目不新,其他等 |
| advice | Stringr | 问题与意见 | 是 | 模拟考试用掉的总时间 |
| img | Stringr | 图片链接 | 是 | |
| phone | number | 联系电话 | 是 | |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
获取学员练习统计结果
GET /a/u/exercised/record
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| studentId | number | 学员Id | 是 | |
| type | number | 类型 | 是 | 1为科目1,4为科目4 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
| total | number | 总题数 | |
| exercised | number | 已做的题目 | |
| correct | number | 做对的题目 | |
| error | number | 做错的题目 |
收藏
完成状态
后端:
前端:
POST /a/u/favorite
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| studentId | number | 学员Id | 是 | |
| target_id | number | 收藏题目id | 是 | |
| target_type | number | 目标类型 | 是 | 收藏目标的类型:/科目2/科目1/考试资讯/语音播报/） |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
获取科目内容(考试资讯/驾驶技巧)
完成状态
后端:
前端:
GET /a/subject/content/list
请求参数
字段 | 类型 | 说明 | 是否必填 | 备注 |
| title | number | 标题 | 否 | |
| status | number | 状态 | 否 | 0下架,1上架 |
| portType | number | 类型 | 否 | 0驾驶技巧,1考试资讯 |
返回参数
字段 | 类型 | 说明 | 备注 |
code | number | 状态码 |
|
message | String | 消息 |
|
二.明天计划完成的事情
1.根据接口文档提供假数据
2.开始编写接口
三.遇到的问题
暂无
四.收获
再次明白了明确需求的重要性
五.项目进度情况
暂无延期风险
返回列表
评论