Humor App

未分类

需求分析：

用户希望能够使用一款手机APP通过阅读英文幽默短文学习英文。用户可通过标题列表选择短文，可分别查看英文原文、中文译文和单词解释。

界面设计

1、主界面

2、作者介绍界面

3、幽默详情-英文

4、幽默详情-单词释义

5、幽默详情-中文译文

功能设计：

后台API

1、获取短文标题列表

请求方法：GET
请求地址：/api/humor/titles?count_per_page=x&page=y
请求参数：

count_per_page

分页请求的每页记录数。服务器端默认20。

page

分页请求的第几页。服务器端默认为1。

返回数据格式：

{
    "doc_count": 10,
    "titles": [
        {
            "_id":     "编号"
            "title":   "English Title",
            "chinese": "中文标题"
        },
        ...
    ]
}

其中：

doc_count

数据库中的短文数目，整型数。

titles

标题对象集合，数组。

_id

短文编号（唯一值），字符串。

title

短文英文标题，字符串。

chinese_title

短文中文标题，字符串。

2、获取幽默短文

请求方法：GET
请求地址：/api/humor/{humor_id}
地址参数：

humor_id

幽默短文的编号，字符串。

返回数据格式：

{
    "_id": "短文编号",
    "title": "English Title",
    "chinese_title": "中文编号",
    "content": [
        "paragraph 1",
        "paragraph 2",
        ...
    ],
    "words":[
        "word 1",
        "word 2",
        ...
    ],
    "chinese": [
        "中文译文段落 1",
        "中文译文段落 2",
        ...
    ]
}

其中：

_id

短文编号（唯一值），字符串。

title

短文英文标题，字符串。

chinese_title

短文中文标题，字符串。

content

英文段落集合，数组。

words

单词释义集合，数组。

chinese

中文译文段落集合，数组。