# API

**Repository Path**: LiangShanYi/API

## Basic Information

- **Project Name**: API
- **Description**: No description available
- **Primary Language**: 其他
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-07-08
- **Last Updated**: 2024-05-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

>  **写在前面：如果发现有图片看不了的，可以登录一下gitee账号，如果还是加载有问题，请在级群联系我，谢谢，麻烦各位啦！**  :smiley: 

### 项目名称：“懂酒人”APP

| 文档名称：  | “懂酒人”APP——产品需求文档  |
|---|---|
| 产品名称：  | 懂酒人  |
| 产品描述：  | 一款专门为美酒爱好者打造的酒类社区APP，利用精准的“红酒识别”API技术和智能推荐，帮助用户选好酒、品美酒、更懂酒。  |
| 发布日期：  | 2020-7-18  |
| 产品版本：  | 迭代二  |
| 文件拥有者：  | 梁善宜 181013114  |

### 下面是迭代一与迭代二的增量修改说明。
> [版本对比diff链接：点击此处进行跳转](https://gitee.com/LiangShanYi/API/compare/e01e9df329a37f1656fbb35fede123a3b3b25724...master)，此次提交的改动很大，大家可以下载到本地查看，万分谢谢！
- 对20*20秒的产品介绍PPT进行了内容的增加，增加了心得，修改了20秒的表述。
- 添加了价值宣言画布、用户旅程地图、人工智能系统性偏差、API使用可行性、API接口设计五张图。
- 对界面流程图、产品结构图进行了修改，标记了对应的人工智能API实现的功能部分。
- 对推荐系统中的API接口设计图片的内容表述进行了更改。
- 增加了人工智能概率性中数据流程中的内容表述。
- 增加了产品的利害相关者分析，对人工智能系统性偏差的描述和论述。
- 根据李克量表的评分细则，进行了PRD文档的顺序调整。
- 完善了对于外部参考文献和外部链接的使用说明。
- 上传了附件文件（包括原创图片、API调用源代码、录音文件、PPT原件、PPT录播文件）

# 一、价值主张设计
********************
## 1. 加值宣言

在红酒消费越来越趋平民化的今天，了解一些红酒知识还是有好处的。但是不是所有喜爱喝红酒的人都能懂酒，想要根据掌握的红酒知识，直接说出眼前的红酒的名称国家、产区、特点等信息，还是具有一定的困难的。本产品利用百度AI平台精准的 **“红酒识别”API** 以及 华为云**智能推荐系统API** 进行整合并加值和优化，帮助用户选好酒、品美酒、更懂酒，为 **美酒爱好者** 打造专业的酒类社区，在这里了解酒知识、评价酒品质、分享酒内容、结交新酒友。

## 2. 核心价值

#### 任务点/痛点（问题）：
1. 葡萄酒品牌的复杂性。随着经济的发展以及消费的升级，红酒逐渐走进大众的日常生活，现在市场上的酒类品种也越来越丰富。在超市挑选葡萄酒的时候，面对品类繁多，各式各样的红酒品牌而且来自世界各地，由于语言的不同，存在消费者看不懂酒标上的信息，认不清红酒的痛点。对于普通的红酒爱好者来说，分辨各种葡萄酒品牌是一件非常困难的事情。
2. 刚入门的小白对于红酒领域的知识一知半解，想要了解现在市面上的红酒行情、红酒资讯，但网上的资料不一定可靠，没有一个专门的平台帮助更快的了解想知道的酒的信息。面对多语言、多品类和海量的葡萄酒信息，如何第一时间快速的找到正确、可靠的红酒信息，对刚入门的红酒小白来说，很重要。
3. 在购买葡萄酒时，可能会存在用户对于红酒味道、红酒知名度的未知性，导致消费者在购买葡萄酒时会迷茫和不确定，不知道这款红酒是否值得购买，评价如何，会害怕出现想淘宝那样，商品买回来后出现“货不对板”的情况。

#### 最小可行性产品（解决方案）：
利用红酒识别和智能推荐系统的功能，为红酒喜爱者提供一个社区分享的平台，在选酒时通过拍照直接反馈详细的红酒信息，以此来了解酒知识，通过对比和测评评论等方法，找到适合自己的一款酒，帮助用户更加懂酒，更会选酒。

## 3. 价值主张画布

![价值主张画布](https://images.gitee.com/uploads/images/2020/0723/234449_698ae75e_2228658.jpeg "价值主张画布.jpg")

## 4.人工智能概率性与用户痛点
> 随着人工智能（Artificial Intelligence, AI）的普及，人机互动方式也发生着改变，人们对产品的期望也越来越高。但是，AI系统具有情境感知能力，可以提供个性化服务，能通过机器学习不断升级，还会有出错的风险。人工智能算法是基于概率的、有缺陷的，所以是会犯错误的。

百度AI开放平台的图像识别中的红酒识别和华为云的推荐系统RES，有以下优势：

| 红酒识别API优势/用户痛点  |  华为云推荐系统RES优势/用户痛点 |
|---|---|
|  **技术领先：** 基于百度深厚的深度学习和图像检索识别技术，红酒识别算法业界领先，准确率高。——保证红酒信息获取的准确性，随时随地进行红酒信息的获取。  |  **个性化的推荐** ：用户的喜好的口味，推荐出适合的红酒以及美食搭配，提供个性化的酒单。——帮助用户找到适合自己的酒，得到更好的品酒体验。 |
|  **高质量数据：** 整合了基于酒标的“可视化”葡萄酒信息中文数据库。已有超过100万款进口葡萄酒信息，覆盖90多个国家，400多个产区和4000多种葡萄品种。——帮助用户更好的掌握葡萄酒的信息。  |  **相关推荐：** 根据用户的搜索结果，提供相关的红酒资讯，并对用户的关键词进行数据的历史记录，根据推荐系统，推荐出相关的内容。——帮助用户拓展更多关于红酒的相关资讯，学习更多红酒知识。  |
|  **简单·易用·专业：** 操作简单，只需上传单张图片，即可获取完整识别结果，同时结合资深的葡萄酒行业人士，提供专业的红酒信息。——让用户获取更加专业的红酒资讯，增加用户的信任感。  |  **定期更新：** 推荐系统会通过数据的不断收集，进行数据库的更新，定期为用户更新最新的数据，呈现最精准的红酒信息。——提高用户对产品的忠诚度和帮助用户迅速找到想要的信息。  |

# 二、需求概述
*********************
## A.用户分析
1. 目标用户群：
- 核心用户：各年龄层的红酒爱好人士，小众的酒庄企业，红酒相关从业者等专业红酒人士
- 一般用户：普通红酒消费者、酒类电商平台
2. 用户画像及使用场景

![用户A](https://images.gitee.com/uploads/images/2020/0714/214331_f2f6ca52_2228658.png "第1页.png")

- 具体的应用场景：杰森是一家小众的酒庄老板，刚从海外回国，对于国内的红酒市场行情不太熟悉和了解。最近正在研发自己酒庄的一款红酒，于是打开了“懂酒人”APP，通过红酒达人的社区分享平台，了解了最热榜的红酒类型，掌握了国内知名红酒品牌的基本信息，对比了不同酒类的品质评价，通过浏览酒区的信息，帮助酒庄在研发新品红酒时提供参考的方向。

![用户B](https://images.gitee.com/uploads/images/2020/0714/214353_0e58bae3_2228658.png "第2页.png")

- 具体的应用场景：马克在一次超市挑选葡萄酒的时候，面对琳琅满目的葡萄酒种类，一时之间不知道如何进行挑选。想查看红酒瓶上的信息，但由于葡萄酒的品类太多，而且来自于世界各地，实在是看不懂酒标上的信息，于是他打开了“懂酒人”APP，通过拍照识别的方法，得到了红酒的基本信息，在结合几次识别的信息对比和借鉴了其他人的评价后，最终选择了一款适合的红酒。

## B.需求列表（对应人工智能加值）

| 优先级  | 智能加值  | 用户场景(具体如何加值)  | API类型  |
|---|---|---|---|
| 很重要  | 是  | 拍照识别红酒标签，得出红酒的详细信息，了解相关酒知识。  | 百度AI平台中的“红酒识别”API  |
| 重要  |  是 | 对用户的喜好的口味，推荐出适合的红酒以及美食搭配。定制化个性化的推荐，更好的品酒体验。  | 华为云推荐系统RES  |
| 重要  | 否  | 红酒知识的交流社区，简单了解酒知识，评价酒品质、分享酒内容，变得更加懂酒。  | /  |

## C.核心价值与用户痛点
- 功能优先级说明

| 序号 | 用户痛点 | API加值 |
|---|---|---|
| 1 | 基于用户看不懂和记不住红酒的痛点，用户只需要简单拍张照，直接反馈详细的红酒信息，包括红酒名称、国家、产区、酒庄、类型、糖分、葡萄品种、酒品描述等。可识别数十万中外红酒。|  百度AI平台中的“红酒识别”API  |
| 2 | 每个人对于红酒的口味，感受都不一样，定制化的红酒对于红酒喜爱者来说是最好的选择。基于这个痛点需求，产品推出了智能推荐系统，可以根据用户的喜好的口味，推荐出适合的红酒、相关的美食搭配以及配餐建议，为红酒爱好者提供便捷和专业的信息服务。| 华为云推荐系统RES |

## D.利害相关者分析
### 1、人工智能系统性偏差
> 该APP集合了精准的红酒识别+个性化的推荐系统，满足不同需求的用户，让用户得到各自的需求满足。但是依然会存在人工智能的系统性偏差问题。

![人工智能系统性偏差](https://images.gitee.com/uploads/images/2020/0723/154713_81292d08_2228658.jpeg "人工智能系统性偏差.jpg")

> 参考文献：[训练集、验证集和测试集](https://zhuanlan.zhihu.com/p/48976706)

# 三、界面流程及关键智能交互
***********************************
## A. 用户旅程地图

![用户旅程地图](https://images.gitee.com/uploads/images/2020/0723/232330_086e77f9_2228658.jpeg "用户旅程地图.jpg")

## B.产品需求设计
> 葡萄酒按照国家、产区、酒庄、品牌、年份、葡萄品种、酿造工艺等细分不同，其复杂和多样的文化历史等因素造就了葡萄酒的差异性和独特性，这正是葡萄酒的魅力来源。

## 1. 产品背景
- 随着经济的发展以及消费的升级，红酒逐渐走进大众的日常生活，现在市场上的酒类品种也越来越丰富。**面对多语言、多品类和海量的葡萄酒信息，如何挑选合适的美酒，如何选酒时就能判断葡萄酒品质，是葡萄酒消费者面对的大难题。** 
- 对于红酒爱好者来说，面对品类繁多、口味多样的葡萄酒，能找到一款适合自己的红酒是很难得的，会存在 **用户对于红酒味道、红酒口感的未知性，导致在选葡萄酒时迷茫和不确定。** 一方面希望能增加对于红酒的知识储备、另一方面，希望能够得到其他酒友的推荐和测评，进行对酒的更深入了解。

## 2. 产品市场（技术可行性 Feasibility）
目前对于酒类APP的分类，80%都是结合了电商平台的卖酒APP，在此基础上，也提供了红酒识别API的技术，同时经过调查，发现有一款专业红酒识别的APP(酒咔嚓)，但此款APP同样也是和电商平台合作。并未发现有类似有专门的红酒爱好者的社区APP，类似的酒类知识平台依旧处于起步阶段，特别是像此类的酒类垂直社交平台。

## 3. 市场概述(用户可欲性Desirability)
##### 3.1红酒APP类应用市场概述
>根据[报告](https://wenku.baidu.com/view/9b37073f76232f60ddccda38376baf1ffc4fe39c.html)显示，今天中国的红酒产量已经累计百万千升，在世界上是红酒增长速度最快的国家，现在排名第五。据专家经过大量的数据分析，在2027年，中国的红酒销量预计超感法国和美国，成为世界第一红酒市场。

显然，随着生活水平的提高，红酒正是作为一种生活品质的符号而受到越来越多人的喜爱。红酒发展至今，品种繁多，文化博大精深。西方的红酒发展历史久远,文化底蕴浓厚，而在中国红酒文化传播才刚刚开始。
随着中国红酒市场的发展，关于红酒的手机应用也应运而生，这些红酒APP对于红酒行业的发展起着至关重要的作用。

##### 3.2市场特征
- 红酒逐渐走进大众的视野，人们对于红酒认知度的提高，大部分用户都喜欢品尝优质的红酒。
- 目前国内已有领先的技术，图像识别技术的成熟，尤其是有针对红酒这类物品的专门化识别，拥有强大的葡萄酒数据库。
- 潜力巨大，葡萄酒市场大有可为。在消费升级的大背景下，中国葡萄酒消费份额在不断加大。红酒爱好者的群体也越来越庞大。

## 4. 产品优势（商业可行性 Viability）：

1.  **查找红酒：** 通过酒标拍照识别或者是关键词搜索，提供方便快捷查询红酒资料的途径；APP中有全世界红酒的庞大数据展示红酒的产区、葡萄品种、酒庄、获奖等全方位的资料。
2.  **红酒知识学习：** APP内置红酒知识速查手册，不仅有全球的名庄简洁，还有评级记录、有权威的专家发布相关的知识、葡萄品种知识以及葡萄酒产区概况，对于想要了解红酒的用户来说就是好平台。
3.  **酒友之间交流：** 更加注重内容的场景化、社交性以及用户的参与感。创造了场景化内容的更多可能性，更加突出用户之间的互动。
4.  **酒类垂直社交平台：** 集合各地红酒爱好者进行分享板块，让更多喜欢喝酒的人来主动分享，这种模式可以让人更快的了解想知道的酒的信息。


## C.产品结构展示
1. APP功能结构图

![APP功能结构图](https://images.gitee.com/uploads/images/2020/0715/035222_08653cfe_2228658.png "“懂酒人”APP.png")

2. 产品结构图

![产品结构图](https://images.gitee.com/uploads/images/2020/0723/162458_0cd004b2_2228658.jpeg "产品结构图.jpg")

3. 界面流程图
![界面流程图](https://images.gitee.com/uploads/images/2020/0723/162120_7064fa94_2228658.jpeg "用户流程图.jpg")

# 四、产品设计原型
*************************
#### A.原型文档
##### 1、[展示页面连接](https://liangshanyi.gitee.io/api_app)
##### 2、原型源文件下载：[“懂酒人”APP原型源文件](https://gitee.com/LiangShanYi/API_APP/blob/master/API%E5%8E%9F%E5%9E%8B.rp)

#### B.交互及界面设计

1. APP页面展示
![APP功能展示图](https://images.gitee.com/uploads/images/2020/0716/201224_288624ad_2228658.png "app功能.png")

2. 核心页面——红酒识别功能、推荐系统功能
![核心页面](https://images.gitee.com/uploads/images/2020/0716/201844_b22f2309_2228658.jpeg "1.jpg")

3. 主要页面——红酒垂直社交平台
![主要页面](https://images.gitee.com/uploads/images/2020/0716/202038_8f7940c3_2228658.jpeg "2.jpg")

4. 主要界面交互流程
- 【拍一拍】交互流程

![拍一拍](https://images.gitee.com/uploads/images/2020/0716/202250_c5188742_2228658.png "拍一拍交互流程.png")

- 【口感测试】交互流程

![口感测试](https://images.gitee.com/uploads/images/2020/0716/202525_3a55e923_2228658.png "口感测试交互流程.png")

#### C.信息设计

![信息设计](https://images.gitee.com/uploads/images/2020/0716/201337_1f323456_2228658.png "信息设计.png")

# 五、数据流程图
***************************************
![数据流程图](https://images.gitee.com/uploads/images/2020/0723/163736_393a56a1_2228658.png "数据流程图.png")

# 六、API使用可行性
********************************
#### API风险使用报告
![DVF模型](https://images.gitee.com/uploads/images/2020/0723/165236_fd7b23a7_2228658.jpeg "默认文件1595494317381.jpg")

# 七、API 产品使用及输出展示
*****************************

### 1、API展示说明及输出
 **（1）红酒识别API（百度AI开放平台）** 
- 接口描述：该服务用于识别红酒标签，即对于输入的一张图片（可正常解码，长宽比适宜，且酒标清晰可见），输出图片中的红酒名称、国家、产区、酒庄、类型、糖分、葡萄品种、酒品描述等信息。可识别数十万中外常见红酒。
- 平台接入网址:[图像识别-红酒识别](https://console.bce.baidu.com/ai/#/ai/imagerecognition/overview/index)
- HTTP 方法：POST
- 请求URL： https://aip.baidubce.com/rest/2.0/image-classify/v1/redwine
- 源代码展示（点击此处跳转链接）
- 1. 调用前进行认证授权代码输入：[Access Token获取](https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjhhu)

![TOKEN获取](https://images.gitee.com/uploads/images/2020/0715/221150_94a300d7_2228658.png "API.png")
- 2. 调用API输入：

![红酒示例](https://images.gitee.com/uploads/images/2020/0715/221733_a0d1fe98_2228658.png "API2.png")
![API调用](https://images.gitee.com/uploads/images/2020/0715/221758_c94fefb7_2228658.jpeg "API.jpg")

- 3. 输出结果：

![输出结果](https://images.gitee.com/uploads/images/2020/0715/222026_64e2c77d_2228658.png "shuchu.png")

 **(2)华为推荐系统RES（华为云开放平台）** 
> 参考文档：[推荐系统API服务接口](https://blog.csdn.net/Lynnzxl/article/details/105252909)
##### 推荐系统的两大场景
- U2I推荐：给每个用户推荐个性化的内容，首页推荐、猜你喜欢等
- I2I推荐：基于当前消费的内容推荐相似的内容，一般叫做相关推荐
##### API接口要完成的任务：
- 给某个确定的用户，在他某个使用场景下，推荐他喜欢的列表
- function(用户信息、环境信息、物品信息) = 推荐概率
1. 前端传入：用户ID、环境信息、需要API接口传入
2. 后端返回：返回的是按概率排序的TOPN物品
3. 后端计算：根据用户ID查询用户信息、物品ID查询物品信息、计算用户对每个物品的喜欢的概率
##### API接口设计
> 参考文献： [推荐系统API服务接口](https://blog.csdn.net/Lynnzxl/article/details/105252909)

![API接口设计](https://images.gitee.com/uploads/images/2020/0723/174618_9765755f_2228658.jpeg "API接口设计.jpg")

> [华为推荐系统RES产品功能](https://support.huaweicloud.com/productdesc-res/res_01_0002.html)
- 调用API获取项目ID

```
{ 
    "projects": [ 
        { 
            "domain_id": "65382450e8f64ac0870cd180d14e684b", 
            "is_domain": false, 
            "parent_id": "65382450e8f64ac0870cd180d14e684b", 
            "name": "cn-north-4", 
            "description": "", 
            "links": { 
                "next": null, 
                "previous": null, 
                "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" 
            }, 
            "id": "a4a5d4098fb4474fa22cd05f897d6b99", 
            "enabled": true 
        } 
    ], 
    "links": { 
        "next": null, 
        "previous": null, 
        "self": "https://www.example.com/v3/projects" 
    } 
}

```
- 平台接入网址：/v2.0/{project_id}/workspaces/{workspace_id}/intelligent-scenes
- HTTP方法：POST
- 创建智能化场景

```
/v2.0/testuuidxxxxxxxxxxxxxxxxxxxxxxxx/workspaces/testuuidxxxxxxxxxxxxxxxxxxxxxxxx/intelligent-scenes

{
  "category" : "popularity",
  "job_configs" : { },
  "schedule" : "00 50 01 * * ?",
  "specs_config" : {
    "online_tps" : 5,
    "offline" : "4CU",
    "nearline" : "2CU",
    "rank" : "8CU"
  },
  "description" : "",
  "datasource_id" : "aa6d657026de42a2927a50400ae69a4b",
  "scene_name" : "ceshi3"
}

```
- 返回示例
- 状态码为 200 时:OK

```
{
  "scene" : {
    "type" : "UI",
    "service_type" : "rec",
    "scene_name" : "ceshi3",
    "category" : "popularity",
    "scene_id" : "ae1d4f1ee659404eaefb7a3a3f1c716f",
    "datasource_id" : "aa6d657026de42a2927a50400ae69a4b",
    "status" : "Draft",
    "created_at" : 1588857123744,
    "update_at" : 0,
    "schedule" : "00 50 01 * * ?",
    "next_schedule_time" : 1588873800000,
    "workspace_id" : "06a7c49afc00d4972ff1c0113d8c49ba",
    "description" : ""
  },
  "is_success" : true
}

```
- 创建场景成功！
- 智能场景（猜你喜欢）获取推荐结果：

> “id”为需要请求的用户id，“rec_num”为推荐物品的数量。

```
{   
    "id":"user894", 
    "rec_num": 10
}
```
- 返回结果：

> “flow_id”代表流程id，“rec_num”为推荐物品结果的数量，“candidates”为候选集结果，字段“id”为推荐结果物料id，“score”为推荐物料的评分，“source”代表该推荐物料来源策略。

```
{
"flow_id": "flow1",
"rec_num": 10,
"candidates": [
{
"id": "item235",
"score": 0.58418584,
"source": "WeightBehavior-DIREC"
},
{
"id": "item338",
"score": 0.5653803,
"source": "WeightBehavior-DIREC"
},
{
"id": "item709",
"score": 0.55219465,
"source": "WeightBehavior-DIREC"
},
{
"id": "item960",
"score": 0.55219465,
"source": "WeightBehavior-DIREC"
},
{
"id": "item469",
"score": 0.55219465,
"source": "WeightBehavior-DIREC"
},
{
"id": "item236",
"score": 0.55219465,
"source": "WeightBehavior-DIREC"
}
]
}
```

### 2、推荐系统API比较分析

#### 华为云：推荐系统RES和百度智能云：推荐系统BRS的对比

|  | [华为云：推荐系统RES](https://www.huaweicloud.com/product/res.html)  | [百度智能云：推荐系统BRS](http://di.baidu.com/product/tuijian?castk=LTE%3D#solution-sec1)  |
|---|---|---|
| 优势  |  **1.开放式推荐：** 提供完整的推荐平台和原子推荐算法，不绑定客户的运营场景，客户可以自定义专属的推荐流程。 **2.场景式推荐：** 提供多维度的场景推荐，含猜你喜欢、关联推荐、热门推荐，一键式操作。 **3.全面的推荐实体：** 支持以用户推荐物品、以用户推荐用户、以物品推荐物品、以物品推荐用户四种全面的推荐对象，用户根据场景选择不同的推荐实体。 |  **1.百度数据，深知用户：** 借助百度丰富的用户画像数据，全方位洞察用户行为特征、关注点及意图，提升推荐结果的精准性及多样性。 **2.领先技术，尽在其中：** 融入AI、NLP、 CTR预估等经过百度多年积累及验证的领先技术。其中，CTR预估技术经过凤巢广告10+年的实战经验，有效提升用户点击转化率。**3.实时服务，简单易用：** 提供数据上传及预测服务API，实时传递数据、获取推荐结果，无需担心机器学习技术门槛和运维问题。  |
|   | ![华为云](https://images.gitee.com/uploads/images/2020/0717/020025_d289892f_2228658.png "3.png")  | ![百度云](https://images.gitee.com/uploads/images/2020/0717/020045_bfe78e3e_2228658.png "2.png")  |
| 操作简易  | 创建华为云账号→为账号充值→进行服务授权→（可选）购买套餐包  | 注册百度智能云账号→智能推荐BRS无需申请开通，可直接接入测试  |

> 参考文档：
> - [华为云推荐系统介绍](https://support.huaweicloud.com/productdesc-res/res_01_0001.html)
> - [百度云推荐系统介绍](https://cloud.baidu.com/doc/BRS/s/ajwvxjo4j)

#### 总结分析：
> 通过对百度智能云和华为云的推荐系统的文档对比，我对这两款推荐系统的功能有了大致的了解。

1. 在技术文档的说明下，我认为 **华为云的官方文档要比百度智能云的技术文档要详细** ，对于未使用过推荐系统的人来说，比较友好。
2. 在操作简易程度上，很明显，在准备工作，百度云的准备工作要比华为云的简单。而在调用推荐系统的使用流程上， **个人认为华为云的要比百度云简单** 。
3. 在两者之间的优势对比中，两者都各有优势。百度云有强大的用户数据库，相比华为云在用户的画像数据上比较全面和丰富，但为什么选择华为， **主要是考虑到华为自身的业务多样性，他们推出的这套推荐系统服务应该是经过各种推荐场景和服务足够的检验而抽象出来的。能够较好的适应各场景的需求。** 不管您当前所面对的产品形态是什么，华为云的推荐系统能够更加灵活的根据自己产品本身的场景，进行智能的推荐。而百度云的使用场景比较有针对性，主要为新闻、视频、电商业务提供了数据接口，比较局限。

### 3、人工智能概率性考量：API精准度测试

##### 1. 选用不同角度的图片，确定API对于红酒识别图片要求
- 测试实验组：（4张不同的红酒图片）

| 红酒1  | 红酒2  | 红酒3 | 红酒4  |
|---|---|---|---|
| ![红酒1](https://images.gitee.com/uploads/images/2020/0716/001040_140cb0ac_2228658.png "1.png")  | ![红酒2](https://images.gitee.com/uploads/images/2020/0716/001054_d003a9c6_2228658.png "2.png")  | ![红酒3](https://images.gitee.com/uploads/images/2020/0716/001108_40052901_2228658.png "3.png")  | ![红酒4](https://images.gitee.com/uploads/images/2020/0716/001120_b734b092_2228658.png "4.png")  |

- 描述：
1. 红酒1：图标清楚，酒身全显示，除红酒外有其他物体
2. 红酒2：重点拍摄图标，酒身全显示，但有点模糊的酒标。
3. 红酒3：图标清楚，酒身全显示，只有红酒。
4. 红酒4：只拍摄酒标，并图片清晰。

- 输出结果

| 红酒1  | 红酒2  | 红酒3  | 红酒4  |
|---|---|---|---|
| ![红酒1](https://images.gitee.com/uploads/images/2020/0716/004941_16e8eca4_2228658.png "1-1.png")  | ![红酒2](https://images.gitee.com/uploads/images/2020/0716/004957_195c61d8_2228658.png "2-2.png")  | ![红酒3](https://images.gitee.com/uploads/images/2020/0716/005011_0adc30dd_2228658.png "3-3.png")  | ![红酒4](https://images.gitee.com/uploads/images/2020/0716/005022_d2568807_2228658.png "4-4.png")  |

- 分析：
1. 由红酒1输出结果来看，可以得知，物体不清晰的红酒，无法被识别。
2. 由红酒2输出结果来看，重点拍摄图标可以识别出红酒的名称，但未能识别出详细的信息。
3. 从红酒3输出结果来看，只有红酒一个主体，但是未能识别出酒标中的信息。
4. 从红酒4输出结果来看，只拍摄酒标，并且酒标清晰的图，可以被精准识别，并且能够识别出详细信息。

 :bangbang:  **总结：从上述的识别结果来看，用户在进行红酒酒标识别时，必须要确保使用清晰、单独酒标的图片，才能够确保API对于红酒详细信息的返回值。**

*********************************************

##### 2. 选用不同的数据图片对红酒识别API精准度进行测试

> 参考文档:[百度AI评测：红酒识别](https://blog.csdn.net/hawkman/article/details/103728922?utm_medium=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-2.nonecase&depth_1-utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-2.nonecase)

| ![1](https://images.gitee.com/uploads/images/2020/0716/031831_9a8db4c2_2228658.jpeg "1.jpg")  |  ![2](https://images.gitee.com/uploads/images/2020/0716/031842_0645de4b_2228658.jpeg "2.jpg") | ![3](https://images.gitee.com/uploads/images/2020/0716/031852_76979f17_2228658.jpeg "3.jpg")  |
|---|---|---|
| 识别结果  | 识别结果  | 识别结果  |
| ![1](https://images.gitee.com/uploads/images/2020/0716/032055_a197eda1_2228658.png "1.png")  | ![2](https://images.gitee.com/uploads/images/2020/0716/032105_82a27042_2228658.png "2.png")  | ![3](https://images.gitee.com/uploads/images/2020/0716/032115_03ee4dc2_2228658.png "3.png")  |


| ![4](https://images.gitee.com/uploads/images/2020/0716/031942_93198be5_2228658.jpeg "4.jpg")  | ![5](https://images.gitee.com/uploads/images/2020/0716/031953_720b440c_2228658.jpeg "5.jpg")  |
|---|---|
| 识别结果  | 识别结果  |
| ![4](https://images.gitee.com/uploads/images/2020/0716/032125_eae9205d_2228658.png "4.png")  | ![5](https://images.gitee.com/uploads/images/2020/0716/032135_3791eea5_2228658.png "5.png")  |

| ![6](https://images.gitee.com/uploads/images/2020/0716/032021_f669475c_2228658.jpeg "6.jpg")  | ![7](https://images.gitee.com/uploads/images/2020/0716/032031_1cfbfd56_2228658.jpeg "7.jpg")  |
|---|---|
| 识别结果  | 识别结果  |
| ![6](https://images.gitee.com/uploads/images/2020/0716/032144_83e9af5a_2228658.png "6.png")  | ![输入图片说明](https://images.gitee.com/uploads/images/2020/0716/032155_cc50a6de_2228658.png "7.png")  |

- 测试数据分析：
对于最常出现的，只有一瓶酒的场景，进行了10次测试，结果如下图所示：
![test](https://images.gitee.com/uploads/images/2020/0716/015941_c36a0520_2228658.jpeg "test.jpg")

1. 对于不同角度，不同部分的10张红酒图片，平均用时3.2秒左右，对于测试的10瓶酒的识别率为100%，详细信息的返回率为60%。整体效果相当不错。不过在详细信息中葡萄品种，所有的10张图片都没有返回。

2. 对于包含多瓶酒的图片，虽然不是重点场景，也进行了测试，发现如果是一种酒，一般可以返回，如果是不同的酒，一般都不会返回酒的信息。

 :bangbang: **测试结论：通过测试可以发现，在图片中只有一种酒的情况下，百度红酒识别，不论识别效率还是返回信息的详细程度都很不错。各种相关的应用都可以放心使用。** 

### 4、API使用价格
#### 免费额度
> [百度图像产品价格文档](https://ai.baidu.com/ai-doc/IMAGERECOGNITION/Yk3bcxagu)

图像识别下各个能力都具有免费调用额度，开通付费后，免费调用额度仍保留。开始产生调用次数时，优先抵扣免费额度，超出免费额度后按次计费。免费额度如下：
![免费额度](https://images.gitee.com/uploads/images/2020/0716/042705_7576bb02_2228658.png "微信图片_20200716042644.png")

#### 红酒识别API价目表
> [百度图像识别价目表](https://ai.baidu.com/ai-doc/IMAGERECOGNITION/gk3bcx9n1)

QPS叠加包 是指已经开通付费（或购买次数包）的情况下，在默认10QPS的基础上继续购买获得更多的QPS并发量。请注意：调用量依然按次计费。（QPS：每秒可发送请求数）

![红酒识别API价目表](https://images.gitee.com/uploads/images/2020/0716/043141_f74ba0e8_2228658.png "2.png")

#### 华为云推荐系统配额说明
> [推荐系统 RES配额](https://support.huaweicloud.com/productdesc-res/res_01_0005.html)

为防止资源滥用，平台限定了各服务资源的配额，对用户的资源数量和容量做了限制。
![配额说明](https://images.gitee.com/uploads/images/2020/0716/052924_206fff78_2228658.png "3.png")

# 八、该产品未来的发展路线构想
**********************************
1. 后续可以增加“电商”模式，与各大酒柜电商平台进行合作
2. 继续优化和丰富葡萄酒数据库
3. 增加用户的使用量，提高推荐系统的准确性

# 九、学习/实践心得总结及感谢
********************************
-  **心得总结：** 通过这次项目的实践操作，进行API的对比和测试，对API有了更加深刻的了解。最终决定利用百度AI平台精准的 “红酒识别”API 以及华为云智能推荐系统API 进行整合并加值和优化。不仅如此，此次的实践，进行了产品原型的制作，用户交互，对于用户流程、界面流程有了清晰的了解，对项目进行产品的设计及验证。这次最大的锻炼是，书写PRD文档，对价值主张画布、用户需求、数据流程图有了系统的梳理，能给帮助我们对产品功能和性能更清晰明确。
-  **感谢：** 本项目通过参考了[学姐美术馆导览](http://xlayal.gitee.io/art_gallery)的原型设计排版及[黄滢学姐savor](https://github.com/NFUNM032/app-of-savor)的产品需求文档的大纲。在调用API的使用中，参考了[CSDN社区中百度AI-红酒识别](https://blog.csdn.net/hawkman/article/details/103728922?utm_medium=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-2.nonecase&depth_1-utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-2.nonecase)的代码，在一些API等对比中，参考了平台提供的官方的文档（详细可查看下面目录）。感谢学姐文档的参考，对于第一次书写PRD文档的我来说，提供了明晰的方向。感谢网络上的开源代码，帮助了我解决了调用API的问题。感谢宿友陪伴，陪我一起度过这奇幻的期末，这段时间的通宵时光，我不会忘记的。
-  **所用的AI功能文档** 
> 1. [华为云推荐系统介绍](https://support.huaweicloud.com/productdesc-res/res_01_0001.html)
> 2. [百度云推荐系统介绍](https://cloud.baidu.com/doc/BRS/s/ajwvxjo4j)
> 3. [百度AI平台：图像识别-红酒识别](https://ai.baidu.com/tech/imagerecognition/redwine)
> 4. [百度图像产品价格文档](https://ai.baidu.com/ai-doc/IMAGERECOGNITION/Yk3bcxagu)
> 5. [推荐系统 RES配额](https://support.huaweicloud.com/productdesc-res/res_01_0005.html)
-  **其他参考文献** 
> 1. [训练集、验证集和测试集](https://zhuanlan.zhihu.com/p/48976706)
> 2. [CSDN社区中百度AI-红酒识别](https://blog.csdn.net/hawkman/article/details/103728922?utm_medium=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-2.nonecase&depth_1-utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-2.nonecase)
> 3. [推荐系统API服务接口](https://blog.csdn.net/Lynnzxl/article/details/105252909)
> 4. [红酒APP市场调研](https://wenku.baidu.com/view/9b37073f76232f60ddccda38376baf1ffc4fe39c.html)
> 5. [推荐系统从入门到接着入门](https://zhuanlan.zhihu.com/p/27502172)
> 6. [学姐美术馆导览](http://xlayal.gitee.io/art_gallery)
> 7. [黄滢学姐savor](https://github.com/NFUNM032/app-of-savor)
-  **原创性图和表** [（16个，点击此处查看源文件）](https://gitee.com/LiangShanYi/API/tree/master/img)

# 十、价值写作：
********************************
-  **一句话版本：** 一款专门为美酒爱好者打造的酒类社区APP，利用精准的“红酒识别”API技术和智能推荐，帮助用户选好酒、品美酒、更懂酒。
-  **一分钟版本：** 
“懂酒人”APP是一款专门为美酒爱好者打造的专业的酒类社区。利用百度AI平台精准的 “红酒识别”API 以及 华为云智能推荐系统API进行整合并加值和优化，帮助你们选好酒、品美酒、更懂酒。我们产品提供了方便快捷查询红酒资料的途径，只需简单的拍一下酒标，就能够直接反馈详细的红酒信息，让用户可以随时随地了解酒知识；同时提供了酒问答平台，随时随地提问，还有大咖定期进行上线答疑。同时我们为用户提供了关于大量的红酒、各类国内外酒类资讯，有全世界红酒的庞大数据，展示红酒的产区、葡萄品种、酒庄、口感等全方位的资料。拥有这款APP，用户就能化身成为行走的红酒百科全书。不仅如此，我们产品还为红酒爱好者提供了一个垂直性的社区分享平台，推出了酒资讯、酒测评、酒社区的功能。集合各地红酒爱好者进行分享板块，让更多喜欢喝酒的人来主动分享，这种模式可以增加用户之间的互动，同时让人更快的了解想知道的酒的信息。你可以在这里了解酒知识、评价酒品质、分享酒内容、结交新酒友。
********************************
# 附件：
- 20*20秒PPT[（点击此处跳转下载）](https://gitee.com/LiangShanYi/API/blob/master/20x20%E6%87%82%E9%85%92%E4%BA%BA.ppt)
- 20*20秒音频[（点击此处跳转下载）](https://gitee.com/LiangShanYi/API/tree/master/%E5%BD%95%E9%9F%B3%E6%96%87%E4%BB%B6)
- 20*20秒录屏[（点击此处跳转下载）](https://gitee.com/LiangShanYi/API/blob/master/PPT%E5%BD%95%E6%92%AD.mp4)
- 版本对比diff链接[（点击此处进行跳转）](https://gitee.com/LiangShanYi/API/compare/e01e9df329a37f1656fbb35fede123a3b3b25724...master)

****************************************
### 下面是迭代一与迭代二的增量修改说明。
> [版本对比diff链接：点击此处进行跳转](https://gitee.com/LiangShanYi/API/compare/e01e9df329a37f1656fbb35fede123a3b3b25724...master)，此次提交的改动很大，大家可以下载到本地查看，万分谢谢！
- 对20*20秒的产品介绍PPT进行了内容的增加，增加了心得，修改了20秒的表述。
- 添加了价值宣言画布、用户旅程地图、人工智能系统性偏差、API使用可行性、API接口设计五张图。
- 对界面流程图、产品结构图进行了修改，标记了对应的人工智能API实现的功能部分。
- 对推荐系统中的API接口设计图片的内容表述进行了更改。
- 增加了人工智能概率性中数据流程中的内容表述。
- 增加了产品的利害相关者分析，对人工智能系统性偏差的描述和论述。
- 根据李克量表的评分细则，进行了PRD文档的顺序调整。
- 完善了对于外部参考文献和外部链接的使用说明。
- 上传了附件文件（包括原创图片、API调用源代码、录音文件、PPT原件、PPT录播文件）