当前位置:文档之家› 系统需求规格说明书 (1)

系统需求规格说明书 (1)

XXX系统或XXX项目
产品需求规格说明书
版本信息
注:状态可以为N-新建、A-增加、M-更改、
对方的所得税说明:版本信息必须更新,审核人和审核时间也必须审核后填写,审核人要求部门经理级别以上。

否则开发测试可拒绝评审。

审核业务功能是否有遗漏、业务流程是否符合规划、关键业务逻辑是否有合理
目录
1.关于本文档
1.1.内容说明
说明:此处描述的是文档说明,产品需求文档更新需要走修订模式,下次更新前先接受修订,并且每次更新必须更新版本号和版本记录。

例子:
本文档用于描述苏宁开放平台物流状态服务系统的需求定义。

包括各个需求的功能描述,处理逻辑规则,界面定义,与其它功能的关系,与其它系统的接口等各个方面的定义。

是苏宁物流状态服务系统唯一的全面需求定义文档。

本文档将根据需求管理流程和要求,随系统功能变化进行及时的修订和更新,以确保本文档的全面性,准确性和实效性。

因此在阅读使用此文档时,请注意从项目的文档管理系统中获取最新版本。

1.2.名词解释
1.3.参考文档
《系统需求定义规范使用说明》
2.系统概述
2.1.业务背景
说明:此处描述业务背景,不可裁剪,清晰的业务背景描述能更好的帮助研发和测试理解产品需求,明确业务测试场景,此部分是产品需求定位的核心导向。

例子一:电子面单的业务描述
随着电子商务服务和物流服务信息化飞速发展,包裹运单号成为快递公司串联快递单、订单、商家、商品等各种信息的枢纽。

相比之下,传统纸质面单价格高、信息录入效率低、信息安全隐患等方面的劣势已愈发凸显。

我司在两年前就开始了电子面单在自营物流上的应用,经过长期的的磨合和积累,目前将我司的应用经验推广到社会物流上,让社会上愿意与我司物流合作的伙伴,也同样享受到我司电子面单服务。

例子二:LSQ的业务描述
物流作业状态服务存在不足
1)服务无标准不统一
需物流作业的各渠道订单,作业状态转化为文案描述处理的逻辑系统多,且处理规不统一,
-B2C自营订单,逻辑在B2C,数据源在OMS
-菜鸟平台/4PS平台订单状态展示,逻辑在LAPI,数据源在LAPI
-物流门户订单状态展示,逻辑在LPS,数据源在LOS
-开放平台订单,逻辑在SOD,数据源在SOD
-R3自营订单,无逻辑,数据源在R3
2)维度单一而不满足新需求
不能满足多样化的展示需求,如目前只有订单维度的状态详情展示,不支持任务单、顾客包裹等维度的详情服务。

同时,缺乏物流特定作业状态的高实时性精确查询服务(如是否销单完成,是否过账,最新站点是哪个等)。

3)开放服务的渠道有待拓展
目前,物流没有一个公网渠道,使顾客能快速查询在苏宁各渠道订单的作业状态信息。

故设计一个物流状态系统统一管理物流状态的收发,状态描述转换,以及提供状态服务查询。

2.2.系统概述
说明:系统说明包括文字部分和图形部分,文字部分主要描述系统之间的关联关系,图形主要包括系统和相关联系统之间的交互结构,不可裁剪
例子一:系统说明
合作伙伴申请苏宁电子面单服务,选择相应的合作模式,由合作伙伴提供预配送包裹的信息,由苏宁电子面单服务生成相应的面单信息,并由合作伙伴系统打印出来并完成包装,最终投递给苏宁网点且面单能被苏宁物流体系识别。

系统之间的关联关系:
苏宁电子面单服务是基于苏宁自营物流电子面单应用,整合社会上多家快递公司,搭建一套具有苏宁配送特色的电子面单服务体系,为苏宁物流的合作伙伴提供统一的电子面单服务。

实现了,合作伙伴对接苏宁的物流服务,由使用纸质面单向电子面单转变。

只要合作伙伴对接了苏宁电子面单服务,那么就可以享受苏宁物流体系的电子面单服务。

本系统当期功能主要包含:
A、用户操作权限管理;
B、配置数据信息管理;
C、订单对应的作业单物流节点状态信息接收与分发功能;
D、订单对应的作业单物流节点状态信息查询功能;
2.3.流程概览/系统框架
说明:此处需要描述和图形化系统内部功能结构模块图,可从架构和技术获取资源。

清晰的系统架构对于系统的扩展性和维护性都非常有帮助,也便于开发和测试从整体上理解该系统的结构。

2.4.系统规划与迭代
说明:此处说明对该系统的总体规划步骤,一期接入什么功能,二期接入什么功能达到什么业务效果。

2.5.功能模块
说明:此处的列表和下面的功能需求是对应的,系统需求编号是唯一识别需求的标识。

需求编号的规则见章节
例子:
3.系统功能需求
3.1状态信息接受推送
3.1.1非采购类状态信息接收
3.1.1.1需求编号LSQ_DDZF_MDZF_0001
说明:
//功能的业务介绍和业务背景
此处的需求编号,在一个系统中必现唯一存在并且最后4位递增,规则:系统名_模块名_子功能名_序列号,如LSQ_DDZF_MDZF_0001:系统名最长保留4位,模块名/子功能名最长4位,序列号最长4位不够4位补0比如0001,如果是优化需求,需求编号不变,新增需求需求编号增加;
3.1.1.2处理流程和约束条件
说明:此处是放上面功能的业务流程图和功能的业务逻辑约束条件
流程图:
说明:如果流程图比较大或比较多,请以单独的附件提供
约束
3.1.1.3页面原

说明:
N/A,系统后台
功能无页面
有页面请截低
保真的图,图片要能
覆盖所描述的功能,
以及页面访问路径。

3.1.1.4数据说

说明:
N/A,系统后台
功能无页面
如果有页面校验请在此处用列表的形式说明各个页面各个控件的校验规则
3.1.1.5功能需求描述
说明:
1)功能描述,需要做到语言准确,结构清晰,须包括从用户角度和业务角度描述功能和业务场景;要尽可能少地从系统逻辑角度去撰写需求,多写业务逻辑以免干扰开发的最优设计。

在需求中明确业务接口。

2)版本优化,如果是优化功能采用修订模式在涉及到的所有原文档(包括需求说明书、流程图、接口文档)上进行修改并标注,需求说明书需对应需求编号章节进行修改,这样便于研发和测试了解原功能,以便快速了解优化的业务判断回归场景。

产品还需说明优化此功能的业务场景以及建议优化功能涉及相关使用场景。

(0522版本)
特别说明:修改的功能会影响系统对外提供的接口,需要这些接口的使用方对接口进行验证,并确认接口的变更
登录
1)针对登录功能,需要做安全性校验,实行https的方式,并且登录密码以*显示,在日志打印中也以*展示;
2)登录功能,登录调用API 接口INTERFACE_LSQ_LOGIN_0001实现登录,需要保证数据传递的安全性。

状态接受
LSQ系统接收状态信息,作如下处理:
3.1.1.6接口说明
说明:如果字段少可直接把接口列表贴这里,接口模板见下表必须包括深度和返回消息,如果有不同返回码也需要一并定义。

每个接口在需求文档中撰写一个编号,在系统中唯一,以便附件中能快速找到对应的接口,便于定期维护,接口编号:规则一个系统唯一:INTERFACE_系统名_一级模块名_编号递增
产品定义的接口只需提供到中文字段名、长度、是否必须,校验说明即可。

API 接口INTERFACE_LSQ_LOGIN_0001
returnCode返回码说明:
状态接收接口INTERFACE_LSQ_STATUS_0001
由于字段较多见附件,每个接口在需求文档中撰写一个编号,规则一个系统唯一:INTERFACE_系统名_一级模块名_编号递增
该功能处理过程中会调用以下接口(见附件):
3.1.1.7其它说明
说明:可以把性能需求或者安全性,稳定性需求,页面浏览器兼容性需求等等放此处3.1.2状态信息发送
3.1.2.1需求编号LSQ_DDZF_MDZF_0002
3.1.2.2处理流程和约束条件
3.1.2.3 页面原型
N/A ,系统后台功能无页面
3.1.2.4
数据说明
N/A ,系统后台功能无页面
3.1.2.5 功能需求描述
针对以下业务场景,前端系统通过该功能完成门店订单收款处理;
3.1.2.6接口说明
3.1.2.7其它说明
3.2最新站点查询服务
3.2.1最新站点查询
3.2.1.1需求编号LSQ_DDTJ_DDTJ_0003
3.2.1.2处理流程和约束条件
接收到前端系统提交的订单后,进行订单提交相关处理,具体逻辑如下:具体步骤逻辑如下:
3.2.1.3页面原型
N/A,系统后台功能无页面
3.2.1.4数据说明
N/A,系统后台功能无页面
3.2.1.5功能需求描述
针对以下业务场景,前端系统提交订单至OMS,OMS进行订单提交的合法校验,订单提交的资源处理以及订单保存,并根据对应的场景,判断是否调用后续处理。

* 接单模式:1-一步式需处理资源;2-两步式需处理资源;3-一步式无需处理资源
3.2.1.6接口说明
该功能处理过程中会调用以下接口:
3.2.1.7其它说明
表-订单行总状态(IS)设置逻辑
表-订单行支付状态(IP)设置逻辑
4.系统非功能需求
3.3性能需求
请根据下表中性能指标项定义性能需求,如不能满足可在其他项中补充。

说明://如果优化版本对原基础数据有影响,需要在需求说明书中使用修订模式明确新指标3.4安全性需求
安全性
3.5扩展性需求
扩展性
3.6兼容性需求
兼容性
3.7维护性需求5.附录。

相关主题