第11章项目规划与设计文档本章要点:◎从零开始介绍一个电子商务项目的规划,设计、测试和发布◎介绍项目通用文档的格式和编写◎重点介绍需求分析说明书,概要设计说明书,详细设计说明书,测试计划,发布说明书和项目进度管理说明书的格式和编写11.1需求概述某公司需要在近期开展网上商务,需要开发一个电子商务项目,该项目包括两个部分:网上书店系统和书店后台管理系统。网上书店系统需要的功能为:1、用户注册功能;2、用户登录功能;3、图书分类购买;4、购物车;5、网上下订单;6、后台管理功能;7、用户管理;8、类别管理;9、书籍管理;10、订单管理。(实现代码见光盘/11/shop)11.2通用页面编写在项目的开发过程通常要写大量的文档,B/S架构的开发文档和非B/S架构的开发文档区别很大,B/S架构需要编写需要区分前台和后台,也就是要将客户端和服务器端分开编写。在项目开发过程中,一般编写文档时间占总工作量的50%-60%。文档是否完善是评估一个项目的重要标准。所有的文档虽然内容不同,但是前两页的结构都是大致一样的。文档的首页可以作为封皮,其结构为:XXXX项目XXX说明书文档编号:文档信息:XXX项目开发组开发文档文档名称:文档类别:项目开发文件密级:内部版本信息:0.1建立日期:YY-MM-DD创建人:小张审核者:批准人:批准日期:保管人:存放位置:组内服务器编辑软件:MicrosoftOffice2003中文版第一页主要是文档的一些描述性信息,后面所有文档第一页都是这样的格式,只是题名有所变化。第二页是文档的变更记录和审批记录,所有人对于文档的修改和审批都需要记录,第二页的结构为:文档修改信息:版本*变化状态简要说明日期变更人批准日期批准人1.0CYY-MM-DD小张YY-MM-DD小李1.1MYY-MM-DD小刘YY-MM-DD*变化状态:A——增加,M——修改,D——删除,C——创建文档审批信息:序号审批人角色审批日期签字备注001小李项目经理YY-MM-DD小李两个通用页面是所有文档的第一页和第二页。签订项目合同之后,需要依次建立的文档。按照建立时间的先后分别为:需求采集计划书、需求设计说明书、页面需求设计、开发计划书、程序概要设计、数据库概要设计、页面详细设计、数据库详细设计、后台脚本详细设计、页面测试说明书、开发总结性报告和后台管理使用手册。可以根据实际的开发过程,进行增加和删除。也可以根据开发过程,对部分文档进行合并。11.3系统分析在系统分析阶段,需要对系统进行调研,并制定相应的开发计划。这个阶段需要对应用程序和数据库结构进行概要设计,并编写相关的文档。11.3.1需求采集计划书需求采集计划书主要功能是确立用户对各个模块的要求,弄清楚用户对系统的要求。完成过程由部分开发人员到对方单位进行调研,充分和用户交流,明确系统将要实现的功能。计划书的格式如下:1.引言1.1目的为了更好地顺利完成本项目的需求采集工作,特制定此需求采集计划,便于对需求和进度进行监督和控制。1.2背景本项目由××公司提出,由××公司的开发部进行开发,××部门对整个项目的进度进行监督。1.3关键字网上书店,购物车,竞标系统1.4参考资料《项目开发合同》2.人员及分工说明资源与分配开始时间完成时间工时准备工作YY年MM月DD日YY年MM月DD日8商品部分需求采集YY年MM月DD日YY年MM月DD日8订单部分需求采集YY年MM月DD日YY年MM月DD日8购物部分需求采集YY年MM月DD日YY年MM月DD日8后台管理部分需求采集YY年MM月DD日YY年MM月DD日8需求测试YY年MM月DD日YY年MM月DD日8需求整合确认YY年MM月DD日YY年MM月DD日8准备工作YY年MM月DD日YY年MM月DD日8商城技术需求采集YY年MM月DD日YY年MM月DD日243.采集项目进度预估开始日期:YY年MM月DD日结束日期:YY年MM月DD日标识号任务名称工期开始日期结束日期前置任务承担人1需求设计7工作日YY年MM月DD日YY年MM月DD日小周2准备工作1工作日YY年MM月DD日YY年MM月DD日小王3商城需求采集3工作日YY年MM月DD日YY年MM月DD日2小李4商品需求采集1工作日YY年MM月DD日YY年MM月DD日2小陈5订单需求采集1工作日YY年MM月DD日YY年MM月DD日4小张6购物需求采集1工作日YY年MM月DD日YY年MM月DD日5小陈7后台需求采集1工作日YY年MM月DD日YY年MM月DD日6小李8需求测试1工作日YY年MM月DD日YY年MM月DD日7小李9需求整合确认1工作日YY年MM月DD日YY年MM月DD日8小李4.需要配合的部门市场部,提供客户资料,必要时帮助联系客户。11.3.2需求设计说明书需求设计说明书需要对软硬件环境进行说明,将系统功能划分成具体的模块,并对每个模块进行说明。对系统的性能进行简单的描述,并给出关键模块的处理流程。1.引言1.1编写目的为了更好地记录、分析、描述用户提出的技术需求,特编写此技术需求设计说明书。同时更好地指导编辑的页面需求采集工作。1.2项目背景本项目由××公司提出,由××公司的开发部进行开发,××部门对整个项目的进度进行监督。1.3参考资料《开发合同》《需求采集计划书》2.技术概述2.1目标使用ASP.NET和SQLServer技术,将系统做成界面友好,用户购物方便,编辑管理产品方便的购物系统和网上竞标系统。2.2硬件环境采用用户已有的硬件环境即可。2.3软件环境因为采用ASP.NET+SQLServer技术,所以对允许软件没有特殊。操作系统可以是Windows2000,也可是Windows2003。3.数据描述3.1已有数据用户已有产品数据、商品数据作为基础数据需要导入数据库中。所有这些数据都是电子文档。3.2录入数据需要编写后台的商品、产品、文章等录入程序。3.3数据保存数据一律保存在数据库中。3.4数据词典产品:即数据库中所有的产品。商品:用于销售的产品。3.5数据采集需求采集人员向用户收集相关产品信息。4.功能需求4.1功能划分系统共分两个部分,一部分是面向用户的部分,用户可以在线注册、购物、提交订单等操作;另外一部分是系统管理部分,这部分的内容包括:产品添加、删除、查询、订单管理、操作员管理、注册用户管理等。4.2功能描述4.2.1面向用户功能:(1)注册功能。消费者首先要注册为系统的用户。注册时只要填写登录用户名、密码、联系电子信箱3项信息即可。注册后,用户可继续填写详细个人信息及收货人信息,同时可修改密码、查询及维护订单。(2)选择产品功能。消费者浏览系统,将自己需求的产品放入到购物车中(可在网上商城首页、专柜首页、产品小类、专卖店首页、搜索结果页面、产品详细信息页面进行该操作),可连续添加商品。(3)管理购物车。消费者选择完商品后可进入购物车页面,查看自己要购买的商品,可修改某一商品数量、取消购买某商品和清空整个购物车。(4)订单功能。消费者确定购物车中的商品后提交订单,如消费者已填写收货人信息,则页面显示该信息并由消费者确认。如尚未填写则显示相应表单请其填写,系统记录消费者提交的收货人信息以便其下次购物时使用。消费者提交订单后可在系统查询该订单,并可对尚未处理的订单进行取消、修改等操作。(5)补充说明。消费者可先登录后购物,也可先浏览系统,将商品放入购物车中,在提交订单时系统提示其登录(新用户要先注册)。4.2.2后台管理部分功能(1)管理用户功能。用户分为两级,管理员和基本用户。基本用户分为编辑、专卖店负责人、消费者3类。不能自己注册,一律由最高管理员添加。编辑拥有基本用户的最高权限,可访问所有订单,可浏览、增、删、改、查订单,可维护订单状态。专卖店负责人只具有处理本店订单的权限,同样可浏览、增、删、改、查订单,可维护订单状态。(2)管理订单功能。消费者可通过Web方式取消、修改自己提交的订单(确认前),查询自己提交的订单(随时)。如订单的状态在一定时限(如24个小时)后仍没有变化(“订单关闭”状态除外),系统自动提醒专卖店负责人及网店编辑(如该订单变色,弹出提醒窗口等方式。订单状态发生变化,系统自动发E-mail给消费者,“无效订单”、“订单关闭”状态除外)。(3)管理商品功能。商品由编辑添加、删除和修改。(4)管理文章功能。应该有文章的添加、删除和修改的功能。5.性能需求5.1数据精确度价格单位保留到分。5.2时间特性保证用户一次最简单购物过程在1分钟内完成。5.3适应性购物流程要简单明了,产品图片要清楚,产品信息描述准确。6.操作流程图6.1用户购物流程图6.2订单处理流程说明(1)消费者提交订单。(2)页面显示:“感谢您在网上商城购物,您的订单已成功提交,我们会在12小时内与您联系。如有问题可拨打客服热线”。(3)订单信息进入订单信息库。(4)订单具备以下几种状态:“提交成功、尚未确认”、“用户取消”、“无效订单”、“已确认,尚未洽谈”、“洽谈成功、尚未发货”、“洽谈不成功”、“已发货”、“订单关闭”等。(5)消费者提交订单,订单入库即为“提交成功、尚未确认”状态;专卖店负责人或编辑在后台浏览到消费者提交的订单,在确认订单信息有效后,订单的状态为“已确认,尚未洽谈”,如是无效信息(如收货人信息虚假),则置其状态为“无效信息”;在订单确认前,消费者可在线取消其提交的订单。(6)专卖店自己确认的订单,由其联系消费者,根据结果置订单的状态为“洽谈成功、尚未发货”、“洽谈不成功”,洽谈不成功则“订单关闭”;编辑确认的订单(专卖店无上网条件等原因),由网上商城将该订单信息转交专卖店相应人员进行上述处理流程。(7)洽谈成功的订单接下来依次经过“已发货”、“订单关闭”两个状态。7.其他需求如可使用性、安全保密、可维护性、可移植性等。11.3.3页面需求设计页面需求设计要对主要页面进行规划,将每个页面都需要使用的部分提取出来。还需要对所有页面所需要使用的CSS文档进行编写。1.引言1.1目的和人员为了详细描述网上商城项目的需求,特撰写此需求设计文档。本需求文档由×××撰写,其中×××给予很多建议。1.2关键字商城,商品,购物车,收款台2.页面组成2.1重用的页头(该部分主要把每个页面都用的模块提取出来,主要是页头和页尾的格式。)?xmlversion=1.0encoding=utf-8?configurationappSettingsaddkey=strConnvalue=Provider=Microsoft.Jet.OLEDB.4.0;DataSource=C:\shop.mdb//appSettingssystem.websessionStatetimeout=20mode=InProccookieless=false//system.web/configuration2.2页面样式(该部分是所有页面共同使用的CSS文档。)input,textarea,select{font:14px宋体,新宋体;background-color:#F6F6F6;border-style:solid;border-width:1px;border-color:black}.inputbox{font:14px宋体,新宋体;background-color:#F6F6F6;border-style:solid;border-width:1px;border-color:black}.inputbutton{font:14px宋体,新宋体;background-color:menu;border-style:solid;border-width:1px;border-color:black}2.3内容说明(该部分对每个页面的结构进行说明,需要绘制页面结构图)页头仍然保留常用页头格式,左侧是公司Logo,右侧上半部分是横幅广告,下面是导航条,分别为各个主要频道的链接导航。11.3.4开发计划书开发计划书将对人员分配,并对开发时间进行确定,这个阶段可以预计每个人