Skip to content

Commit

Permalink
Merge branch 'main' into feat/example-ver
Browse files Browse the repository at this point in the history
  • Loading branch information
rottenpen authored Dec 30, 2020
2 parents 3b0fd06 + c617a7f commit 30869fc
Show file tree
Hide file tree
Showing 2 changed files with 160 additions and 0 deletions.
127 changes: 127 additions & 0 deletions packages/requirements/API.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
## 每日一题列表
### 接口地址
```js
GET /api/questions
```

### 参数
#### query参数
|变量名|类型|说明|
|:----|:----|:----|
|current|整数|当前页数|
|pageSize|整数|每页条数|

### 返回值
#### 返回结果
|变量名|类型|说明|
|:----|:----|:----|
|success|布尔值|是否成功|
|current|整数|当前页数|
|pageSize|整数|每页条数|
|total|整数|总页数|
|data|问题对象数组|问题数组|

#### 问题对象
|变量名|类型|说明|
|:----|:----|:----|
|id|整数|每日一题ID|
|name|字符串|题目名称|
|type|字符串|题目类型,目前有两种,md和js|
|content|字符串|题目内容|
|publish_date|日期|发布时间|

示例
```json
{
"success":true,
"current":1,
"pageSize":10,
"total":10,
"data":[
{
"id":1,
"name":"请说一下什么是虚拟DOM?",
"publish_date":"2020-12-22"
}
]
}
```

## 回答问题
### 接口地址
```js
POST /api/answer/:day_id
```

### 参数
#### 路径参数
|变量名|类型|说明|
|:----|:----|:----|
|day_id|整数|每日一题ID|

#### 请求体参数
|变量名|类型|说明|
|:----|:----|:----|
|content|字符串|回答的内容|

#### 示例
```json
{
"success":true
}
```


### 返回值
|变量名|类型|说明|
|:----|:----|:----|
|success|布尔值|是否成功|


## 每日一题回答列表
### 接口地址
```js
GET /api/answers/:day_id
```


### 参数
#### 路径参数
|变量名|类型|说明|
|:----|:----|:----|
|day_id|整数|每日一题ID|


### 返回值
#### 返回结果
|变量名|类型|说明|
|:----|:----|:----|
|success|布尔值|是否成功|
|subject_name|字段串|题目|
|subject_content|字符串|题目内容|
|subject_type|字符串|题目类型,目前有两种,md和js|
|refer_answer|字符串|参考答案|
|data|回答对象数组|全部回答|

#### 回答对象
|变量名|类型|说明|
|:----|:----|:----|
|answer_id|数字|回答ID|
|answer_content|字符串|回答内容|

示例
```json
{
"success":true,
"subject_name":"请说一下什么是虚拟DOM?",
"subject_content":"请说一下什么是虚拟DOM?",
"refer_answer":"虚拟DOM其实是一个JavaScript对象",
"data":[
{
"answer_id":1,
"answer_content":"虚拟DOM其实是一个JavaScript对象?",
"answer_date":"2020-12-22"
}
]
}
```
33 changes: 33 additions & 0 deletions packages/requirements/database.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
## 题目(subjects)
|字段名|类型|说明|
|:----|:----|:----|
|id|int(11)|ID|
|name|varchar(255)|标题|
|content|text|内容|
|description|varchar(255)|描述|
|created_at|datetime|创建时间|
|updated_at|datetime|更新时间|


## 每日一题(days)
|字段名|类型|说明|
|:----|:----|:----|
|id|int(11)|ID|
|subject_id|int(11)|题目ID|
|description|varchar(255)|描述|
|publish_date|date|发布日期|
|created_at|datetime|创建时间|
|updated_at|datetime|更新时间|



## 每日一题回答(day_answers)
|字段名|类型|说明|
|:----|:----|:----|
|id|int(11)|ID|
|day_id|int(11)|每日一题ID|
|content|int(11)|ID|
|id|text|回答|
|description|varchar(255)|描述|
|created_at|datetime|创建时间|
|updated_at|datetime|更新时间|

0 comments on commit 30869fc

Please sign in to comment.