需求说明书样例1.doc

附录1 阶段项目文档要求阶段项目要求每个项目小组完成的文档包括以下内容。 阶段答辩：答辩用的幻灯片，幻灯片的内容要求参见下面的“答辩用的幻灯片的目录结构”。 其他：项目进度安排表（由项目经理或小组长提供），参见下面的“项目进度安排表模板”。附1.1 系统需求和需求分析说明书模板系统需求和需求分析说明书文件状态： 草稿 正式发布 正在修改文件标识项目名称XXX当前版本beta1作 者完成日期版本历史版本/状态修订人修改日期备 注发布第一部分 概述1项目名称及背景 项目名称游戏点卡在线销售系统 开发背景网络购物已经随着Internet的飞速发展而得到越来越多应用。传统的面对面的现金交易已经远远不能满足人们的现代化生活需要，尤其是卡片类商品，人们往往要为了简单的卡号和密码跑一趟商店。这些都给人们的生活带来了很大的不便。为了更好的适应现代社会人们的购物需要，为了提高交易效率，节省人们的宝贵时间，我们开发了这套稳定可靠、操作方便、安全有效的游戏点卡在线销售系统，它主要包括：用户管理、卡片管理、公告管理、汇款审核、综合信息管理、会员购物等几大模块。2文档说明该需求文档在实际开发过程中，迎合用户不断完善需求的过程中总结而来，请仔细阅读。第二部分 任务说明1功能概述该系统要求实现管理员后台管理和会员购买卡片功能。会员操作包括：会员注册、修改个人信息、汇款、投诉、购买物品、查看个人汇款信息和购物信息等；管理员后台管理包括：修改个人资料、新会员和会员汇款审核、用户管理、角色管理、卡片类别管理、游戏卡管理、汇款审核、公告管理、销售统计、投诉浏览。2用户环境Window Server 2003; Visual Studio 2005; SqlServer2005第三部分 需求分析1实现功能 系统用例图管理员和会员业务逻辑如下图所示： 管理员功能清单功 能 编 号功 能 名 称文中标题编号备 注01个人管理0101修改资料0102审核操作 续表 功 能 编 号功 能 名 称文中标题编号备 注02系统管理0201用户管理0202角色管理0203卡片类型管理0204游戏卡管理0205汇款审核0206公告管理03综合信息0301销售统计0302浏览投诉 会员功能清单功 能 编 号功 能 名 称文中标题编号备 注01个人管理0101修改资料 续表 功 能 编 号功 能 名 称文中标题编号备 注02会员操作0201商品列表0202投诉建议0203汇款通知03综合信息0301存款记录0302购物记录0303联系我们2用例说明 用例1l 用例图l 描述该模块主要包括：修改个人资料和审核操作。修改个人资料与会员注册所需资料完全一致，主要有：登录号、密码、真实姓名、性别、密码问题、密码答案、Email、地址、电话、身份证。审核操作：主要是对新注册的会员和会员的汇款信息进行审核，可以把新会员设置成为正式会员，根据会员汇款的数额，对会员的个人帐户充值。l 参与者/*参与者，参与用例的对象*/ 用例2l 用例图l 描述用户管理：（1）选择不同类型用户可以用GridView自动绑定该类型所有用户信息。（2）把选中的用户设置为“普通会员”，“vip会员”，“管理员”。（3）删除选中用户。l 参与者/*参与者，参与用例的对象*/ 用例3l 用例图l 描述角色管理：主要包括添加角色、修改角色、删除角色、分配角色功能、浏览所有角色功能、设置会员优惠价。添加角色：包括角色名称、角色描述。分配角色功能：用CheckBoxList列出所有功能菜单，菜单分为两级，只列出子菜单，把选中的菜单id及菜单的父菜单id添加到指定的角色下，可以随时修改角色对应的功能菜单。浏览所有角色功能：按角色分别列出这些角色对应的权限菜单。设置会员优惠价：设置不同角色的优惠比例。l 参与者/*参与者，参与用例的对象*/ 用例4l 用例图l 描述卡片类型管理：包括显示卡片类型、添加卡片类型、删除卡片类型。添加卡片类型：包括卡片名称、卡片代表图片（把所有用到的图片都放到工程下的images/card文件夹里，路径默认为：/images/card/xxxx.gif），卡片价格（用DropDownList初始化几个价格）3个字段信息。用ListBox列出所有卡片信息，以“卡片名称价格”表示。l 参与者/*参与者，参与用例的对象*/ 用例5l 用例图l 描述游戏卡片管理：主要包括显示卡片信息、添加卡片、修改卡片、删除卡片。添加卡片：包括选择卡片类型（用DropDownList绑定已有卡片类型），卡号，密码，卡片备注等字段信息。用GridView显示所有卡片信息。l 参与者/*参与者，参与用例的对象*/ 用例6l 用例图l 描述汇款审核主要包括：显示汇款信息、通过审核、撤回审核和删除汇款记录几个功能。用GridView显示汇款信息。显示汇款信息：用DropDownList绑定不同的汇款类型，根据选择的汇款类型自动绑定该汇款类型对应的汇款信息。审核操作：“通过审核”将把选中的会员汇款金额追加到该用户的帐户下，“撤回审核”将不追加金额，让系统以消息的形式通知该会员汇款失败信息，并提醒重新填写邮寄信息。删除汇款记录：把选定的汇款记录删除。l 参与者/*参与者，参与用例的对象*/ 用例7l 用例图l 描述公告管理主要包括：显示公告信息、添加公告、修改公告、发布公告、删除公告。添加公告：主要包括公告标题和公告内容两个字段信息。发布公告前可以修改公告，当发布公告后不可以修改公告。l 参与者/*参与者，参与用例的对象*/ 用例8l 用例图l 描述销售统计：用GridView显示销售统计信息，主要包括商品名称、单价、总量、售出量、剩余量。l 参与者/*参与者，参与用例的对象*/ 用例9l 描述浏览投诉：用DataList显示信息，主要包括投诉人和投诉内容。l 参与者/*参与者，参与用例的对象*/ 用例10l 用例图l 描述商品列表主要包括：显示所有商品、按商品名称模糊查询、放入购物车、我的购物车几个部分。显示所有商品：用DataList显示所有商品，具体内容如下图所示： 图：所有商品列表“我的购物车”和“放入购物车”共用同一个弹出窗口，当选择新的商品点“放入购物车”后，打开的购物车自动刷新。购物车页面：如下图所示： 图：我的购物车 选好的商品和推荐商品部分都用DataList显示，选好的商品中，购买数量默认为1，当超过库存量结算时就报告库存不足错误。推荐的商品：根据会员选好的商品提供相关的商品推荐，（1） 循环“您选好的商品”，根据会员已经选择的每一个商品，查找选择了该商品的所有其他会员；（2） 查找这些会员所购买过的商品中，尚有库存的，并且被购买次数最多的2种商品，如果商品不在“您选好的商品”列表中，并且不在“相关推荐表”中，则添加到推荐的相关信息表中。l 参与者/*参与者，参与用例的对象*/ 用例11l 用例图l 描述投诉建议：默认投诉用户为登录用户，填写投诉或建议内容提交即可。l 参与者/*参与者，参与用例的对象*/ 用例12l 用例图l 描述汇款通知：默认汇款用户为登录用户，填写汇款银行，汇款金额，汇款时间，附言，提交即可。l 参与者/*参与者，参与用例的对象*/ 用例12l 用例图l 描述汇款记录：显示该会员所有汇款历史记录，包括汇款人、汇款金额、汇款时间、附言。购物记录：包括商品名称、面值、卡号、密码、购物日期。以上两个都用GridView显示信息，要求相同的项要进行单元格合并，如上图所示。l 参与者/*参与者，参与用例的对象*/ 用例13l 用例图l 描述联系我们：静态页面，如上图所示。l 参与者/*参与者，参与用例的对象*/3用例关系可以查看业务关系图。附1.2 系统设计说明书模板系统设计说明书文件状态： 草稿 正式发布 正在修改文件标识当前版本正式版作 者完成日期版本历史版本/状态修 订 人修 改 日 期备 注第一部分 概述1文档说明本文档主要包括数据库详细设计和界面详细设计讲解，所以请认真阅读，以提高开发的质量和效率。2系统需求概述整个系统中所有布局统一采用div布局，所有数据展示控件，如GridView和DataList都要有分页处理。建议在浏览页面时，设置浏览器：从工具-Internet选项-设置-每次访问网页时检查。第二部分 系统总体结构本系统采用了传统的3层架构实现，理解起来更简单，请采用3层架构的模式开发你的系统。如下图所示：第三部分 系统设计类图/*系统中主要的、关键实体类图，参考图如下*/ 用例1实现l 时序图/用例1的时序图，参考图如下*/l 描述第四部分 数据库设计1逻辑设计数据库关系图：2表设计/*所有的表的详细设计信息汇总，如：*/4.1 数据库：GameCardSale所有表信息表 名功 能 说 明UserInfo存放用户基本信息UserState可扩展性，设置用户是否被屏蔽的状态RoleInfo存放角色基本信息SysFun存放菜单功能基本信息RoleRight存放所有角色权限CardType卡片类型信息表Card具体卡片表CardState可扩展，卡片是否被售出的状态ShoppingCart购物车功能，存放用户已经选择的卡片信息TempRelativeCard根据用户选择的卡片，给出相关的选择ShopHistory用户购物历史记录PostHistory用户汇款历史记录ApproveState可扩展，用户汇款被审核状态PostFailedInfo存放汇款失败时，系统发送的信息News存放系统公告信息Advice存放会员的投诉建议信息4.2 表UserInfo表名列名数据类型（精度范围）空/非空约束条件其他说明UserIdVarchar(50)非空用户唯一标识UserNameVarchar(50)非空真实姓名PassWordVarchar(50)非空密码UserRoleint非空用户角色Genderint非空性别PassQuestionVarchar(50)非空密码提示问题PassAnswerVarchar(50)非空密码提示答案EmailVarchar(50)非空TelNobigint非空电话号码AddressVarchar(50)联系地址IDCardNobigint身份证号Moneyfloat用户余额UserStateint非空表UserState中UserStateId的外键用户状态4.3 表UserState表名列名数据类型（精度范围）空/非空约束条件其他说明UserStateIdVarchar(50)非空1：正常状态；0：被屏蔽UserStateNameVarchar(50)非空4.4 表RoleInfo表名列名数据类型（精度范围）空/非空约束条件其他说明RoleIdint非空角色id RoleNameVarchar(50)非空角色名称RoleDescVarchar(50)角色描述DisCountint会员折扣4.5 表SysFun表名列名数据类型（精度范围）空/非空约束条件其他说明NodeIdint非空菜单节点idDisplayNameVarchar(50)非空菜单名称NodeURLVarchar(50)菜单连接地址DisplayOrderint非空菜单显示顺序ParentNodeIdint非空父节点id4.6 表RoleRight表名列名数据类型（精度范围）空/非空约束条件其他说明RoleRightIdint非空角色权限idRoleIdint非空表RoleInfo中RoleId的外键角色idNodeIdint非空表SysFun中NodeId的外键菜单节点id4.7 表CardType表名列名数据类型（精度范围）空/非空约束条件其他说明CardTypeIdint非空卡片类型idCardTypeNameVarchar(50)非空卡片类型名称CardPriceint非空卡片价格CardImageVarchar(50)对应图片地址4.8 表Card表名列名数据类型（精度范围）空/非空约束条件其他说明CardIdint非空卡片idCardTypeIdint非空表CardType中CardTypeId的外键卡片类型idCardNobigint非空卡片序号CardPasswordint非空卡片密码CardDescVarchar(50)卡片描述CardTimedatetime非空添加卡片时间CardStateint非空表CardState中CardStateId的外键卡片售出状态4.9 表CardState表名列名数据类型（精度范围）空/非空约束条件其他说明CardStateIdint非空卡片状态id1：售出；0：未售出CardStateNameVarchar(50)非空卡片状态名称4.10 表ShoppingCart表名列名数据类型（精度范围）空/非空约束条件其他说明ShoppingCartItemIdint非空购物车项idUserIdVarchar(50)非空表UserInfo中userid的外键用户idCardTypeIdint非空表CardType中CardTypeId的外键卡片类型idNumint非空购买数量4.11 表TempRelativeCard表名列名数据类型（精度范围）空/非空约束条件其他说明TempRelativeCardIdVarchar(50)非空相关卡片标识idUserIdint非空表UserInfo中userid的外键用户idCardTypeIdint非空表CardType中CardTypeId的外键卡片类型id4.12 表ShopHistory表名列名数据类型（精度范围）空/非空约束条件其他说明ShopHistoryIdint非空购物历史记录idUserIdVarchar(50)非空表UserInfo中userid的外键用户idCardIdint非空表Card中CardId的外键卡片idShopTimedatetime非空购买时间4.13 表PostHistory表名列名数据类型（精度范围）空/非空约束条件其他说明PostHistoryIdint非空汇款历史记录idUserIdVarchar(50)非空表UserInfo中userid的外键用户idBankVarchar(50)非空汇款银行Moneyint非空汇款金额PostTimedatetime非空汇款时间PostDescVarchar(50)备注ApproveStateint非空表ApproveState中ApproveStateId的外键审核状态4.14 表ApproveState表名列名数据类型（精度范围）空/非空约束条件其他说明ApproveStateIdint非空种子，自增1审核状态idApproveStateNameVarchar(50)非空审核状态名称名称4.15 表PostFailedInfo表名列名数据类型（精度范围）空/非空约束条件其他说明PostFailedInfoIdint非空汇款失败信息idUserIdVarchar(50)非空表UserInfo中userid的外键用户idPostHistoryIdint非空表PostHistory中PostHistoryId的外键汇款历史记录idReadStateint非空消息阅读状态0：未读；1：已读4.16 表News表名列名数据类型（精度范围）空/非空约束条件其他说明NewsIdint非空公告idTitleVarchar(50)非空公告标题ContentVarchar(500)公告内容NewsTimedatetime非空发布公告时间NewsStateint非空消息发布状态1：已发布；0：未发布4.17 表Advice表名列名数据类型（精度范围）空/非空约束条件其他说明AdviceIdint非空投诉建议idUserIdVarchar(50)非空表UserInfo中userid的外键用户idContentVarchar(2000)非空投诉或建议内容第五部分 界面设计1登陆界面设计说明：所有页面设计要求使用div布局完成。 图1.1用户登陆首页用户登陆首页要求：只有当用户名、密码和验证码都正确时才能通过验证。“网站公告”部分为由下到上的滚动字幕，“查看所有商品”部分为从右到左的滚动字幕。点“注册会员”时，弹出添加新会员窗口，如图1.2所示。点“忘记密码？”，弹出找回密码页面，如图1.4所示。点“查看所有商品”，弹出商品展示页面，如图1.7所示。点网站公告信息，弹出该公告的详细信息页面，如图1.9所示。会员注册页面：（如图1.2所示） 图1.2 用户注册页面会员注册页面要求：用户登陆名只能为数字和字母以及“_”“-”，不得使用其它字符。并且用户登陆名不能少于4位，密码不能少于6位，最多不超过10位，email和电话都要进行有效性验证，除了地址和身份证号外，其他信息不能为空。提交后若注册成功则提示，如图1.3所示。 图1.3 注册成功提示信息找回密码页面：（如图1.4所示） 图1.4 找回密码页面找回密码页面要求：首先只显示用户登陆名填写部分，如图1.4所示。验证该用户是否存在，不存在则报错，若存在则显示找回密码问题和答案框部分，如图1.5所示。 图1.5用户存在后显示用户和密码框界面如果问题和答案都填写正确，则显示输入新密码部分，如图1.6所示。 图1.6 问题和答案完全正确提交后的新密码界面输入新密码后提交，则显示：“恭喜您，重新设置密码成功，请牢记”，确定后，找回密码页自动关闭。商品展示页面：（如图1.7所示） 图1.7商品展示页面商品展示页面功能要求：用DataList展示所有商品，如图1.7所示，要求实现翻页和模糊查询功能，点“放入购物车”后报告“请登录后购买！”，如图1.8所示。图1.8放入购物车时提示公告详细信息浏览页面：（如图1.9所示） 图1.9公告详细信息页面公告详细信息页面功能要求：显示公告标题和内容，点“关闭”按钮可以关闭窗体。2后台管理主界面设计 图2.1 后台管理主界面主界面功能要求：要求使用母版页设计主界面，如图2.2所示，使用TreeView展示用户功能菜单，内容首页展示待审核的新用户和用户汇款，如图2.1所示。管理员菜单包括：个人管理、系统管理、综合信息3个父级模块，个人管理包括：修改资料、审核操作2个菜单，系统管理包括：用户管理、角色管理、分类管理、游戏卡管理、汇款审核、公告管理6个菜单项，综合信息包括：销售统计、浏览投诉2个菜单项。 图2.2 后台管理主页面设计3后台管理用例界面实现/*用例界面实现是对需求的进一步明确和以可视化的方式呈现，作为编码和实现依据*/ 用例1个人修改资料界面：（如图2.3所示） 图2.3修改个人资料界面修改个人资料页面功能要求：显示用户基本信息如图2.3所示，修改资料时的限制如注册时相同。 用例2审核操作界面：（如图2.4所示） 图2.4审核操作界面审核操作页面功能要求：用两个GridView分别显示待审核的用户和汇款信息，如图2.4所示，都有“查看详细”功能。点“通过审核”实现通过审核功能，如果汇款出现错误，点“撤回汇款”则以系统消息的形式通知用户。 用例3用户管理界面：（如图2.5所示） 图2.5 用户管理界面用户管理页面功能要求：用GridView展示用户基本信息，点“查看详细”可以查看更详细的信息，如图2.4所示，选中用户后，点页面上的四个操作按钮，即可以实现把用户设置为普通会员、vip会员、管理员和删除选中用户功能。另外添加全选功能，选择不同的用户角色，GridView重新绑定相应的用户信息。 用例4角色管理页面：（如图2.6所示） 图2.6 角色管理界面角色管理页面功能要求：用GridView展示角色基本信息，如图2.5 所示，要求实现添加角色、修改角色、删除角色、分配角色权限、浏览角色功能和设置会员优惠价功能。添加角色页面：（如图2.7所示） 图2.7 添加角色界面添加角色页面功能要求：为模式对话框，角色名称不能为空，提交后自动关闭并刷新角色管理页面。修改角色页面：（如图2.8 所示） 图2.8 修改角色界面功能要求同添加页面。分配角色权限页面：（如图2.9所示） 图2.9 分配角色权限分配角色权限页面功能要求：用CheckBoxList列出所有子菜单权限名称，不要求列出父菜单名称，要求选中子菜单时，自动把父菜单分配给该角色，把选中的权限分配给对应的角色，点“提交”提示“权限已生效”，确定后关闭该模式对话框。角色功能浏览页面：（如图2.10所示） 图2.10 角色功能浏览界面角色功能浏览界面功能要求：按角色展示它们被分配的权限，如图2.9所示。设置会员优惠价页面：（如图2.11所示） 图2.11 设置会员优惠价页面设置会员优惠价页面功能要求：会员类型又roleinfo表动态绑定，然后选择你要设置的会员类型，填写优惠价比（1100之间的整数）后，点“提交”则更新选定会员类型的优惠价比例，如图2.12所示。 图2.12 设置会员优惠价比能成功执行删除操作。 用例5卡片类别管理界面：（如图2.13所示） 图2.13 卡片类别管理界面卡片类别管理页面功能要求：卡片类别可以同名，用卡片类别和价格结合起来作为唯一标志，用ListBox列出所有卡片类别+价格。商品价格部分可以自己定义，但菜单项要合理。图片路径部分要求只保存图片的相对路径，并且输入框部分为只读，可以把所有的图片都放在项目中的“images”文件夹里，保存数据库时，路径保存为：“/images/.gif”。点“添加新类型后”卡片类别列表自动刷新，显示刚才添加的卡片类别，另外点“删除选中类型”按钮，删除该行记录，并自动刷新卡片ListBox。 用例6卡片管理界面：（如图2.14所示） 图2.14 卡片管理界面卡片管理页面功能要求：用GridView显示卡片基本信息，按卡片类别名称和价格排序，相同的部分尽量合并单元格，如图2.14所示。实现添加、修改和删除功能。添加卡片页面功能要求：为卡片管理页面弹出的模式对话框，如图2.15所示，要求所属类型部分为自动绑定的所有卡片类型+价格，默认编号是从数据库获取的当前默认种子最大值，卡号和密码部分要有有效性验证，比如卡号只能为1020位整数，密码为310位数字。点“提交”后保存卡片信息，并自动关闭模式对话框。 图2.15 添加卡片界面修改卡片页面功能要求：初始时分别绑定卡片管理中选中的卡片信息，卡片类型也要自动绑定为该卡片对应的类型，修改卡片的内容，“提交”更新卡片信息，关闭模式对话框，自动刷新卡片管理页面。 图2.16 修改卡片界面 用例7汇款审核界面：（如图2.17所示） 图2.17 汇款审核界面汇款审核页面功能要求：用GridView显示汇款基本信息，添加查看详细信息和全选功能，“汇款信息选择”下拉菜单项如图2.18所示，点“通过审核”追加用户余额，点“撤回汇款”通知用户汇款失败，当改变“汇款信息选择”中的类型时，则重新绑定GridView，显示相关信息。 图2.18 汇款审核菜单展开界面 用例8公告管理界面：（如图2.19所示） 图2.19 公告管理界面公告管理页面功能要求：用GridView显示公告基本信息，有添加、修改、删除和发布功能，要求发布后，不能修改，但可以删除。添加新消息页面功能要求：公告管理页面弹出的模式对话框，如图2.20所示。填写消息标题和内容，提交后关闭该对话框，自动刷新公告管理页面，消息标题不能为空。 图2.20 添加新消息界面修改消息页面功能要求：初始时显示该消息的基本信息，其他要求同添加新消息页面。 用例9商品统计界面：（如图2.21所示） 图2.21 商品统计界面商品统计页面功能要求：用GridView显示商品销售情况信息。 用例10浏览投诉界面：（如图2.22所示） 图2.22 浏览投诉界面浏览投诉页面功能要求：用DataList显示投诉建议基本信息。4前台操作主界面设计功能菜单部分 图4.1 前台操作主界面前台操作主界面功能要求：要求使用母版页设计主界面，如图4.1所示，使用TreeView展示用户功能菜单，内容首页展示所有可购商品信息，如图4.1所示。会员菜单包括：个人管理、会员操作、综合信息3个父级模块，个人管理包括：修改资料1个菜单，会员操作包括：商品列表、投诉建议、汇款通知3个菜单项，综合信息包括：存款记录、购物记录和联系我们3个菜单项。5前台操作用例界面实现/*用例界面实现是对需求的进一步明确和以可视化的方式呈现，作为编码和实现依据*/ 用例1修改个人资料页面功能要求与后台管理中的相同。 用例2商品列表界面：（如图4.2所示） 图4.2 商品列表界面商品列表页面功能要求：用DataList显示可购商品基本信息，展示方式如图4.2所示。可以按照商品名称模糊搜索，点“放入购物车”后，打开新的窗口，里面显示该会员已经选择的卡片信息，当选择另外的商品点“放入购物车”后，只刷新原来的窗口不打开新窗口，点“我的购物车”共用刚才打开的窗口。如图4.3所示。 图4.3 我的购物车界面我的购物车页面功能要求：用DataList显示选好的商品信息，根据已经选择好的商品，在上边用DataList列出推荐的商品，如图4.3所示。选择好的商品部分“您的成交价”即是该会员的身份所对应的优惠价比*卡片面值而得到，当更改购买数量时，金额总计自动刷新，当购买数量超过库存量，结算时报告库存不足的提示。推荐商品来源-首先查找购买了该会员已经选择的某一件商品的所有会员，然后从这些会员购买的商品中，挑选出被购买次数最多的2种商品，如果这些商品不在购物车中则把它们显示出来。依照上边的方法，遍历该会员选择好的所有的商品。另外：当推荐的商品，点“购买”时，将自动更新已经选择的商品和推荐的商品数据，如图4.4所示。 图4.4 推荐的商品点“购买”后的界面 用例3投诉建议界面：（如图4.5所示） 图4.5 投诉建议界面投诉建议页面功能要求:客户文本框部分默认为用户登陆时的id，内容有非空验证。 用例4汇款通知界面：（