Tb产品需求说明书规格的PRD.docx

Tb产品需求说明书规格的PRD.docx

《Tb产品需求说明书规格的PRD.docx》由会员分享，可在线阅读，更多相关《Tb产品需求说明书规格的PRD.docx（29页珍藏版）》请在冰豆网上搜索。

Tb产品需求说明书规格的PRD

集团标准化工作小组[Q8QX9QT-X8QQB8Q8-NQ8QJ8-M8QMN]

Tb产品需求说明书规格的PRD

文件编号

SPI-doc-TIP-PRD

作　　者

黑羽

文档版本

最后修改日期

2009/1/20

版本号

TOP接入系统（TaobaoIntergrationPlatform）

产品需求说明书

编写人：

黑羽

编写时间：

2009/1/20

修订控制页

编号

文档版本

修订章节

修订原因

修订日期

修订人

1

1-7

创建

黑羽

2

根据NCP和平台组会议修改

黑羽

3

–

根据29日周一TOP架构讨论会，划分清TIP的需求优先级、子系统结构而调整

黑羽

4

消息中心类型添加，API监控调用管理

黑羽

5

，

根据会议批注内容补充和完善

黑羽

6

修订

2009/1/20

黑羽

7

8

9

10

请与以下部门讨论PRD

序号

OK

部门

沟通内容

1.

□

运营中心：

商城、集市、二手闲置、门户

协助设定产品的RaodMap

协助设定targetcustomer：

使用者

协助评估：

营销/推广需求

协助设定商业目标

2.

□

运营中心：

网站运营

协助设定产品的RaodMap

协助设定targetcustomer：

使用者

协助评估：

营销/推广需求

协助设定商业目标

3.

□

客户中心：

客服服务部

讨论客服如何支持：

客服需求

协助评估诈欺/数据窜改风险：

欺诈/数据窜改风险、不当使用风险

预测客服成本、工作量

4.

□

客户中心：

网络安全部

评估安全性

5.

□

产品技术中心：

系统分析师虚拟团队

讨论以确定方案的规模评估、推出计划

进行技术可行性分析，提出关键问题的技术解决方案

评估系统规模，数据量，所需资源等

协助评估风险

6.

□

产品技术中心：

项目经理

协助确定产品发布日期

协助确定产品成本

协助评估风险

7.

□

产品技术中心：

用户体验设计之交互设计师

协助制作Demo

协助确定useflow：

用户使用方式

8.

□

财务分析中心：

财务组

请评估财务需求

协助评估风险

9.

□

财务分析部：

数据分析组

协助确定如何度量产品目标

10.

□

行政管理中心：

法务部

协助评估法务问题并检视合作伙伴：

使用者数据需求、法务需求、版权、隐私权等需求

协助评估风险：

诈欺/数据窜改风险、不当使用风险

11.

□

规则委员会

协助评估规则变更的影响

12.

□

支付宝

协助确定接口、合作方式等

13.

□

阿里软件

协助确定接口、合作方式等

1概述

1.1名词说明

介绍本文档中会使用到的专用名词，如：

新名词、产品内实体单位，请尽量使用大众可理解的名词

名称

说明

开放平台

以开放OpenAPI为核心的服务开放系统。

包括开放数据、开放平台和开放的业务方入口。

TOP

全称:

TaobaoOpenPlatform,淘宝开放平台

App

应用，本文中指由第三方开发的，需要调用淘宝TOP来完成业务的应用程序。

通常表现为浏览器端的页面插件，桌面端的应用程序。

ISV

IndependentSoftwareVender，独立软件开发商。

Role

业务方角色，对应于不同的API访问权限和监控策略。

包括：

买家、卖家、高级卖家等

TPS

每秒业务处理量。

1.2产品概述及目标

请以三到五段文字摘要说明您所提出的新服务（包含推出新产品、现有产品重新设计或升级、现有服务推出新功能）及目标；请包括：

1、产品背景说明；

淘宝开放平台是建立大淘宝的关键要素之一。

以围绕淘宝开放数据和业务为核心，把握商业趋势，以第三方开发软件为助力，建立繁荣的商业生态圈。

对于外部数据的调用和监管，是淘宝开放中最重要的环节之一。

同时，在可预见的外部数据调用大规模增长时，淘宝开放平台也必须拥有适应的机制。

这些就是TIP（淘宝接入平台）的商业背景和需求。

2、产品的目标客户；

从TIP系统的使用来说，有外部客户和内部用户

外部用户：

第三方开发者通过开发的App对TIP平台发出数据调用请求。

内部用户：

a）开发者社区。

开发者通过开发者社区系统向TIP平台请求相关App管理接口和开发者管理接口。

b）AdminCenter。

AdminCenter使用方为淘宝小二。

AdminCenter主要用于管理开放平台的开发者、App、API；统计分析TOP数据调用的情况。

1.3产品roadmap

请描述产品发展的各个阶段，可以用图表等多种方式表述。

产品发展阶段

阶段描述

时间

1

满足外部数据调用的基本（P1）需求

实现基本的监控、管理功能

对App和开发者有最基本的管理，支持AdminCenter对单个ISV单个应用手工纳入TIP管理体系。

AdminCenter有基本的ISV管理界面，和数据统计分析

2009年3月

2

完善监控与管理。

（完成相关P2需求）。

完善App和开发者管理，支持对批量的ISV批量应用纳入TIP管理体系。

建立初步消息通知机制

AdminCenter完善ISV/App管理界面，数据统计

支持开发者社区批量接入第三方开发者

2009年6月

3

App和开发者管理支持第三方草根开发者。

将沙箱环境使用结合进TIP的相关申请/管理流程

支持开发者社区对第三方草根开发者的开放。

AdminCenter完成半自动化的管理，集合对淘宝Hosting程序的相关支持

2009年10月

1.4产品风险

请描述产品可能存在的风险，比如商务谈判的风险外部合作的风险不当使用的风险等等。

风险级别为高中低。

风险

风险级别

描述

监控策略

改善策略

（

环境

时间

1.

2.

3.

1.

2.

3.

4.

5.

1.

2.

3.

4.

5.

1.

2.

3.

4.

5.

1.

2.

3.

4.

6.

7.

8.

正常使用

暂停使用

9.

1

AppManager

对外接口

只提供接口，由其他子系统调用，

如，由小二在AdminCenter中调用

增加App接口

删除App接口

修改App接口

查询App接口

界面原型

执行者

前置条件

后置条件

主流程

1.1.1.1API管理

简要说明

提供各种App信息的对外接口

业务规则

序号

优先级

需求名称

需求描述

10.

2

OpenAPI对应信息

//TBD

OpenAPI对应的角色信息

OpenAPI对应的Sessionkey是否需要绑定，何种类型。

11.

2

消息通知API对应信息

12.

2

可以设置OpenAPI的角色

具体设置OpenAPI能被哪几种角色可以访问。

角色列表见：

OpenAPI

界面原型

执行者

前置条件

后置条件

主流程

1.1.1.2Role管理

简要说明

提供各种终端用户角色信息的对外接口

业务规则

序号

优先级

需求名称

需求描述

13.

2

终端用户角色

每个角色对应一组OpenAPI权限、注册侦听消息权限

角色对应的App

每个App中需要的角色由App来决定。

14.

2

用户角色

买家：

普通买家：

没有发生卖出交易的用户

高级买家：

可以使用TIP的消息接口的用户，该类用户数据可以产生消息发送。

卖家：

普通卖家：

接口使用权限低。

旺铺卖家：

具有API大部分使用权限，但在产品发布等接口上不具有权限

商城卖家和外部网店卖家：

具有API所有使用权限

高级卖家：

除了具有API使用权限外，还可以使用TIP消息接口。

淘客：

可以渠道

15.

2

用户角色的绑定

在开发者社区提供专门的角色权限申请页面

在AdminCenter中提供“角色权限”勾选范围

界面原型

执行者

前置条件

后置条件

主流程

3.2

1.2.1AdminCenter

1.2.1.1管理开发者的部分

统计需求：

1

开发者调用统计

以图表形式表现如下数据

总调用数、频率的日线图

调用的各个接口次数、图表

所有App数量统计、

所有开发者的分类统计

管理需求：

序号

优先级

需求名称

需求描述

5.

2

待审核开发者

1、列表显示字段有：

开发者的类别、联系姓名、电子邮件地址、网址、联系电话、已通过的角色。

2、可做的操作有：

通过、拒绝

a）通过后则待审用户自动进入下一个角色的待审列表中。

b）拒绝则需要输入拒绝理由。

审核机制采取一票否决制。

6.

2

已通过开发者

1、列表显示字段有：

开发者的类别、联系姓名、电子邮件地址、网址、联系电话，开发者注册的应用（点击后可以查看应用的详细资料）。

可做操作有：

删除

7.

2

删除开发者

1、被删除的开发者如没有注册应用，则输入完删除理由后从列表中消失。

被删除的开发者如有注册应用，输入删除理由后，该开发者所属应用也全部被删除，已使用该应用的模块也相应被删除。

序号

优先级

需求名称

需求描述

8.

2

开发者列表

1、以表格方式列出所有开发者。

2、显示字段为开发者类别/姓名/电邮/应用数目（已通过/未通过）

（//TBD）

界面原型

执行者

开发者

前置条件

登录进入开发者社区，进入管理中心

后置条件

无

主流程

1.2.1.2管理App的部分

简要说明

数据中心，存储App（应用）和开发者相关信息。

业务规则

统计需求

1

App应用统计

以图表形式表现如下数据

注册数统计

App单个调用数统计、列表

分类统计

趋势统计

序号

优先级

需求名称

需求描述

1.

1

添加新的应用

1、需要填写的字段为：

应用名称

必备接入数据：

应用Appkey

应用接入方式：

代码嵌入/Iframe框架嵌入/客户端

应用类型：

旺铺插件/社区插件/NCP插件/独立外部插件

应用是否需要绑定用户Session

基本信息：

应用的图标

分三种图标大小，20X20，40X40，80X80

应用的简介

应用的详细描述

应用的回调接口地址（如果是Client插件，则不需要回调地址）

2、提交后的提示信息中给出api_key，并再次判断用户是否有站点，如无站点提示同注册开发者时相同。

注册成功后，该应用信息进入调试状态。

2.

1

应用详细资料页

显示应用的详细信息，显示的内容为添加应用时填写的内容以及被使用次数、评论。

序号

优先级

需求名称

需求描述

1.

2.

2

修改应用

1、已上线的应用可修改

a）可修改所有字段

b）修改后，用户可以选择发布到调试环境或者是发布到正式环境，发布到调试环境的线上应用，在调试环境中可以添加和使用，并不替换线上应用。

c）选择发布到正式环境后修改后的信息进入审核系统，并不替换线上应用信息。

2、审核中的新应用修改不允许修改。

修改通过后的应用对老模块升级。

3.

2

下线应用

1、已上线的应用开发者可以修改为下线状态，审核流程如同修改

3、被批准的下线应用将从列表中消失，且不能被添加，但原添加的模块可继续使用。

4.

2

删除应用

1、删除上线状态的应用：

提出申请后进入审核流程，审核通过后凡是使用到该应用的模块一并被删除。

5.

2

下线应用

2、已上线的应用开发者可以修改为下线状态，审核流程如同修改

4、被批准的下线应用将从列表中消失，且不能被添加，但原添加的模块可继续使用。

6.

2

下线应用

3、已上线的应用开发者可以修改为下线状态，审核流程如同修改

5、被批准的下线应用将从列表中消失，且不能被添加，但原添加的模块可继续使用。

序号

优先级

需求名称

需求描述

9.

2

应用列表

1、应用列表根据应用的状态分为以下几个tab：

已发布、调试中、审核中、被拒绝、下线、删除。

2、已发布状态的应用为已经通过审核，线上正在使用中的应用。

a）显示字段为：

icon、名称、上线时间、类别、类型、被使用次数、查看评论。

b）点击icon或名称可以查看应用详细资料。

c）可做的操作有：

修改、删除。

3、调试中的应用为调试环境下才能添加和使用的应用，线上环境并不能看到和被添加。

a）显示的字段为：

icon、名称、提交时间、类别、类型。

b）点击icon或名称可以查看应用详细资料。

c）可做的操作有：

修改、发布、删除。

4、审核中状态的应用为新应用或修改后提交审核的应用，目前处于开发环境中。

a）显示字段为：

icon、名称、提交审核时间、类别、类型、状态（新应用还是老应用修改后待审）。

b）点击icon或名称可以查看应用详细资料。

c）可做操作有：

修改、删除。

d）

5、被拒绝状态的应用为新应用或修改后提交审核的应用被淘宝审核人员拒绝的应用。

a）显示字段为：

icon、名称、被拒绝时间、类别、类型、状态（新应用还是老应用修改后待审）、查看拒绝理由

b）点击icon或名称可以查看应用详细资料。

c）新应用被拒绝后可做的操作有：

修改、删除。

点击修改后流程同添加新应用；点击删除后，该应用的信息从列表中消失。

d）老应用修改被拒绝后无可作操作。

6、下线状态的应用为老应用被开发者或淘宝审核者作出下线操作的应用，该类应用将不会在列表中出现，且不能被添加，但已使用中的不受影响。

a）显示字段为：

icon、名称、上线时间、下线时间、类别、类型、被使用次数、查看评论。

b）点击icon或名称可以查看应用详细资料。

c）可做的操作有：

修改、删除。

7、删除状态的应用为被删除的老应用，包括开发者自己删除和淘宝审核删除。

a）显示字段为：

icon、名称、上线时间、删除时间、类别、类型、被使用次数、查看评论、删除理由、删除者的角色。

b）点击icon或名称可以查看应用详细资料。

无任何可做的操作，仅仅是一个信息记录。

10.

界面原型

执行者

前置条件

后置条件

主流程

1.2.1.3管理API的部分

简要说明

业务规则

序号

优先级

需求名称

需求描述

16.

1

OpenAPI各项指标统计

API接口调用次数统计

所耗性能

被调用的APP数目

17.

2

单个OpenAPI的信息

名称

状态

所属角色权限

18.

1

OpenAPI列表

列出当前所有OpenAPI

信息：

名称

状态

19.

2

暂停服务

暂停服务包括整体OpenAPI的暂停和选定API接口的暂停。

总体限制：

暂停单个App访问API

service限制：

单个API在30秒内能被访问的API

按service+uri进行限制：

可以对单个service+uri进行设置，限制访问

按api_key+service_name进行限制：

可以按单个api_key+service_name进行设置，设置特定的api_key对特定的service_name限制访问

按api_key+service_name+uri进行限制：

20.

2

更改OpenAPI对应角色

更改对应角色权限。

界面原型

执行者

前置条件

后置条件

主流程

5.1整合需求

请详细说明此产品可与其它产品或公司的整合需求。

（详细的功能应在「功能详情」中说明）

产品/合作公司

描述

基本需求

优先级

5.2BETA测试需求

请说明是否需要BETA测试，BETA测试的要求及期望达到的目标。

2非功能需求

产品营销需求

如果此产品有推广需求和推广资源，请说明使用的推广方式、目标受众以及是否有限制或特殊要求（网站运营部应提供主要内容。

范例：

推广方式

受众

描述说明

站内信通知

卖家

规则变更需求

本产品可能涉及到的对淘宝规则的变更。

（（规则委员会应提供主要内容。

产品服务需求

产品上线是否需要客服协助此产品计划的服务优先级和重要性如何当此产品上线后，你想要从客服中得到什么信息（例如，关于此产品，请根据产品相关数据进行推断，客服每周处理多少客诉花多少时间回复e-mail会员常问的问题是什么）客服应如何支持对客服有何影响客服最常遇到什么状况应如何回应此产品尚未上线前或上线时，客服可或不可与客户沟通，沟通什么（请与客户服务部和技术支持讨论确定）

范例：

服务类型

是否为

新服务

预计服务事件

预计频率

场景描述

服务解决方案

　□

评价被删除的咨询

1000个/天

1、为缓解服务压力，项目采取逐步推进方式，先自动删除99%以上概率为信用炒作的评价，然后逐步降低概率；

2、面对咨询，为客服提供以下功能：

1）后台评价单向删除；

2）后台评价双向删除

3、在知识库、帮助中心添加相关内容；

4、在客服中组织培训；

法务需求

请详细说明与隐私权、知识产权、专利权、商标、服务条款（TOS）、版权、合同责任、客户沟通等相关之法务议题或需求。

（法务应提供协助）

财务需求

此产品是否有特殊的会计财务需求，如有请详细说明。

（财务部应提供协助）

帮助需求

请提供内部使用者或者客户在使用此产品时所需要的任何说明文件或帮助，比如线上帮助、CRM知识库、FAQ等。

安全性需求

产品需符合网络安全部的相关规定；

3上、下线需求

7.1上线时限需求

此产品预定上线日期上线日期有无任何特殊依据或规定

7.2下线需求（活动类需求必须明确下线时间）

此产品预定下线日期下线日期有无任何特殊依据或规定

8运营计划

请说明产品的后续运营计划。