Merge remote-tracking branch 'origin/master'

assignment/README.md

@@ -10,4 +10,10 @@
 | 张怡 | 初始化作业 api           | 2018/12/20 |
 | 张怡 | 修改作业 api | 2018/12/25 |
 | 张亚森 | 修改部分url前缀 | 2018/12/25|
-| 张怡 | 修改团队代码作业展示信息 api | 2019/01/10|
+| 张怡 | 修改团队代码作业展示信息 api | 2019/01/10|
+| 张亚森 | [新增]学生查看单个文档作业信息 | 2019/01/11|
+| 张亚森 | [修改]DocumentResultSerializer | 2019/01/12|
+| 张亚森 | [修改]老师查看文档作业列表 | 2019/01/12|
+| 张亚森 | [新增]文档作业已提交和未提交列表 | 2019/01/12|
+| 张亚森 | [新增]代码作业已提交和未提交列表 | 2019/01/12|
+

assignment/api/Code-代码作业.md

@@ -164,12 +164,12 @@ see [ProjectSerializer](../serializer/ProjectSerializer.md)
 
 
 
-## （新增）老师查看单个代码作业下所有组的过程统计信息
+## （新增）老师查看单个代码作业下所有已提交组的过程统计信息
 
 [TEACHER]
 
 ```http
-get /teacher/code/:codeId/procedure
+get /teacher/code/:codeId/submitted/procedure
 ```
 
 ### Response
@@ -182,7 +182,23 @@ get /teacher/code/:codeId/procedure
 
 see [CodeProcedureSerializer](../serializer/CodeProcedureSerializer.md)
 
+## （新增）老师查看单个代码作业下所有未提交组的信息
 
+[TEACHER]
+
+```http
+get /teacher/code/:codeId/unsubmitted/groups
+```
+
+### Response
+
+```json
+{
+  "data": List<GroupSerializer>
+}
+```
+
+see [**GroupSerializer**](../../course/serializer/GroupSerializer.md) 
 
 ## 老师查看单个代码作业的成绩列表（所有组的）
 

assignment/api/Document-文档作业.md

@@ -1,4 +1,4 @@
-# Document - 代码作业
+# Document - 文档作业
 
 > url 前缀：**/assignment**
 >
@@ -75,7 +75,7 @@ delete /document/:documentId
 ```
 
 
-## 老师查看文档作业列表
+## [修改]老师查看文档作业列表
 
 [TEACHER]
 
@@ -112,25 +112,62 @@ get /student/course/:courseId/document
 
 see [DocumentSerializer](../serializer/DocumentSerializer.md)
 
+## [新增]学生查看单个文档作业信息
+
+[STUDENT]
+
+```http
+get /student/document/:documentId
+```
+
+### Response
+
+```json
+{
+  "data": DocumentSerializer
+}
+```
+
+see [DocumentSerializer](../serializer/DocumentSerializer.md)
 
-## 老师查看文档作业的成绩列表（所有小组）
+
+## [修改]老师查看文档作业的成绩列表（已提交小组）
 
 [TEACHER]
 
 ```http
-get /teacher/document/:documentId/result
+get /teacher/document/:documentId/submitted/result
 ```
 
 ### Response
 
 ```json
 {
+  "status":作业进行状态，String  
   "data": List<DocumentResultSerializer>
 }
 ```
 
 see [DocumentResultSerializer](../serializer/DocumentResultSerializer.md)
 
+## [新增]老师查看未提交文档作业小组列表
+
+[TEACHER]
+
+```http
+get /teacher/document/:documentId/unsubmitted/groups
+```
+
+### Response
+
+```json
+{
+  "data": List<GroupSerializer>
+}
+```
+
+see [**GroupSerializer**](../../course/serializer/GroupSerializer.md) 
+
 
 ## 学生查看文档作业的成绩
 

assignment/serializer/CodeProcedureSerializer.md

@@ -9,8 +9,8 @@
 - group：[**GroupSerializer**](../../course/serializer/GroupSerializer.md) - 所属小组
 - buildStatus：StatusSerializer - 构建情况
 - deployStatus：StatusSerializer - 部署情况
-- unitTestStatus：StatusSerializer - 单元测试情况
-- functionTestStatus：StatusSerializer - 功能测试情况
+- unitTestStatus：TestStatusSerializer - 单元测试情况
+- functionTestStatus：TestStatusSerializer - 功能测试情况
 
 
 # StatusSerializer

assignment/serializer/DocumentResultSerializer.md

@@ -5,7 +5,8 @@
 ## Attributes
 
 - id : **Number** - 文档作业成绩 id
-- document：**Number** - 所属文档作业 id
+- document：[**DocumentSerializer**](./DocumentSerializer.md) - 所属文档作业
 - group：[**GroupSerializer**](../../course/serializer/GroupSerializer.md) - 所属小组
-- state：**String** - 作业状态（TBD）
-- result：**String** - 成绩等级（TBD）
+- result：**String** - 成绩等级（TBD） 注：如果无成绩，返回 -1(Number)
+- url：**String** - 作业git地址
+- reviewGroup: List<id>- 互评小组

assignment/serializer/DocumentSerializer.md

@@ -12,7 +12,6 @@
 - startAt：**timestamp** - 开始时间
 - endAt：**timestamp** - 结束时间
 - problem：**NestedProblemSerializer** - 作业题目
-- url：**String** - 作业git地址
 
 
 

prefix.md

@@ -9,6 +9,7 @@
 | 周玮璐 | 新增考试&&考试结果&&考试提交记录&&运行记录前缀     | 2018/12/22 |
 | 周玮璐 | 更改题目前缀为question     | 2018/12/25 |
 | 张亚森 | 新增作业前缀 | 2018/12/25|
+| 周玮璐 | 新增作业成绩统计前缀 | 2018/01/13|
 
 ## 前缀列表
 
@@ -22,4 +23,4 @@
 - [commit](exam/api/Commit-提交记录.md)
 - [record](exam/api/Record-运行记录.md)
 - [assignment](assignment/api/Code-代码作业.md)
-
+- [resultstatistics](resultstatistics/api/Resultstatistics-成绩统计.md)

question/api/Question-题目.md

@@ -26,7 +26,8 @@ see [QuestionTypeSerializer](../serializer/QuestionTypeSerializer.md)
 [TEACHER]
 
 ```http
-get /teacher/questions
+get /teacher/questions/type?type="xxx"&
+get /teacher/questions/assignmenttype?type="xxx
 ```
 
 ### Parameters
@@ -71,7 +72,7 @@ get /teacher/questions
 
 | Name     | Type   | Description      |
 | -------- | ------ | ---------------- |
-| assignmenttype | String | 作业类型|
+| type | String | 作业类型|
 | page | number | 当前页数 |
 | limit | number | 每页的题目数量 |
 

resultstatistics/api/Resultstatistics-成绩统计.md

@@ -0,0 +1,22 @@
+# Resultstatistics - 成绩统计
+
+> url 前缀：**resultstatistics**
+>
+> 示例：**https://xxxxxxxxx/api/resultstatistics/xxxx**
+
+## 获得所有学生所有作业的统计
+
+[TEACHER]
+
+```http
+post /course/:courseId
+```
+
+### Response
+
+```json
+{
+  "data": List<ResultstatisticsSerializer>
+}
+```
+see [ResultstatisticsSerializer](./serializer/ResultstatisticsSerializer.md)

resultstatistics/serializer/NestedScoreSerializer.md

@@ -0,0 +1,8 @@
+# NestedScoreSerializer
+
+作业成绩的基本信息
+
+## Attributes
+- id: **number** - 作业id
+- name: **Sreing** - 作业名称
+- score: **number** - 作业成绩 | `[0-100]`

resultstatistics/serializer/ResultstatisticsSerializer.md

@@ -0,0 +1,10 @@
+# ResultstatisticsSerializer
+
+作业成绩统计的基本信息
+
+## Attributes
+- id: **number** - 成绩统计id
+- user: [**UserSerializer**](../../user/serializer/UserSerializer.md) - 学生信息
+- documents: [**Array<NestedScoreSerializer>**](./NestedScoreSerializer.md) - 文档作业成绩
+- reviews: [**Array<NestedScoreSerializer>**](./NestedScoreSerializer.md) - 互评作业成绩
+- codes: [**Array<NestedScoreSerializer>**](./NestedScoreSerializer) - 代码作业成绩

review/api/Review-互评.md

@@ -31,6 +31,7 @@ post /review
 
 ```json
 {
+  "courseId": Number, // 课程id
   "documentHwId": Number, //文档作业id,
   "taskNumber": Number, //互评任务数
   "startAt" : Number, //互评开始时间
@@ -400,6 +401,7 @@ see [ReviewSimpleSerializer](../serializer/ReviewSimpleSerializer.md)
 
 - id : **Number** - checkListItem id
   
+
 // 评价方id
 // 被评价方 id
 
@@ -454,6 +456,7 @@ see DEFAULT
       "groupId" : Number,// 某个小组的评价 id
       "level" : Boolean,// 小组作出的评价
       "comment" : String,// 小组做出的备注 |
+      "isArgued": Boolean // 是否已经提过argue  只在查看自己的结果时有效
     },...
   ]
  },...