1 例：软件产品开发文档一、需求规格说明书1. 引言编写目的在软件项目开发过程的初期，用户对自身的需求也仅仅有一个模糊的概念需求分析的目的就是把这个概念具体化，并在用户和开发人员之间达成共识，包括对用户需求的全面了解和分析、筛选，明确所要开发的软件项目的职责界限、并进行可行性研究和指定资源、进度预算等。项目背景本项目的委托单位为安徽农业大学教务处，开发单位为自由软件开发室，主管部门为自由软件开发室的项目经理部。随着高等教育的改革和高校的不断扩招，传统的教学管理方式已远远不能满足高等教育的发展，高等教育的发展也使传统的教学管理方式日益被淘汰，这样以来，一批精明的软件开发商开发了基于局部网络校园网和数据库的应用系统。大多情况下，这些系统是以客户机/ 服务器结构的分布式系统，它的核心教学管理系统和数据库放置在学校的中心电脑上，用户接口端的应用程序分别配置在图书馆、专业系、 和学生宿舍的客户机上 . 2.1 目标成绩管理系统实现以下功能：学生成绩管理成绩管理档 案 管 理课程管理系 统 管 理成绩录入成绩查询院系专业设置课程设置选课管理院系专业查询院系专业查询院系专业查询口令更改重新登录操作员管理数据备份数据恢复退出系统按学生查询按学生查询精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 1 页，共 18 页2 2.2 运行环境1 软件环境Windows操作系统： Windows 95/98/Me 或 Windows NT4.0/2000/XP 。2硬件环境最低配置：?CPU ：奔腾 100MHz以上?内存： 32MB ?显卡：标准VGA ，16 色显示模式建议配置：?CPU ：奔腾 166 MMX以上?内存： 64MB以上?显卡：标准VGA ，24 位真彩色?其它：鼠标3语言支持支持简体中文、 繁体中文、 英语、日语四种语言文字， 其中英语可以在所有语言Windows平台上工作。将来会支持更多语言。常见问题（1）在将本项目软件编译生成可执行文件后，安装时应注意操作，防止死机。（2）为了确保您正常的安装与使用，强烈建议您在安装学生管理系统软件前重启系统后再安装。（3）在 Windows95/98/NT 系统下安装学生管理系统时时，有时会出现 和不存在，请检查安装路径或重新启动 的提示。产生这个问题是由于您系统中的此文件版本过低，只要按照提示，重新启动电脑就可以了。（4）本系统软件在未生成可执行文件前如果随意改变数据库的路径，再运行时便出现数据库连接失败的情况，鉴于这一点，也可以说数据库的操作和管理是PowerBuilder应用程序的核心，数据库管理在应用程序开发的初级阶段是非常关键的。 经过不断摸索和研究，我们会渐渐地掌握PowerBuilder内置的桌面管理系统 Adaptive Server Anywhere(简称 ASA)能够非常方便的建立、删除、和连接等一系列操作。3数据描述本系统利用PowerBuilder 内置的桌面管理系统Adaptive Server Anywhere( 简称 ASA) 建立一个 score 数据库，其中包括 8 个数据表， 分别是：院系表department 、 专业表major 、教师档案表teacher 、学生档案表student 课程设置表course 、学生选课表course_sel 、学生成绩表score 、操作员档案表operator院系表 department 主键： department_id 字段名字段名字段类型字段宽度院系代码Department_id char 6 院系名称Department_name char 40 3.2.2专业表 major 主键： major_id 字段名字段名字段类型字段宽度专业代码Major_id char 6 精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 2 页，共 18 页3 专业名称Major_name char 40 所属院系代码Department_id char 6 所属院系名称 Department_name char 40 3.2.3教师档案表student 主键： student_id 字段名字段名字段类型字段宽度教师编号Teacher_id char 6 教师名称Teacher_name char 8 所属院系代码Department_id char 40 所属院系名称Department_name char 40 3.2.4学生档案表student 主键： student_id 字段名字段名字段类型字段宽度学号Student_id char 10 Student_name char 12 性别sex char 2 出生日期Birthday date 格式 :mm/dd/yyyy 民族Nation char 10 政治面貌Background char 40 职务Duty char 10 院系Department_name char 40 专业Major_name char 40 班级Class char 4 籍贯Hometown char 20 Address char 30 Telephone char 20 状态Status char 6 不及格门数Falure char 2 备注Remark char 30 3.2.5课程设置表course 主键： course_id 字段名字段名字段类型字段宽度课程代码Course_id char 10 课程名称Course_name char 40 学时Period numeric 4,0 学分Credit numeric 2,0 类别Kind char 6 教师编号Teacher_id char 6 教师Teacher_name char 8 开课单位Give_unit char 40 开课时间Give_time char 6 选课范围Limit char 20 内容简介Content char 40 备注Remark char 30 精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 3 页，共 18 页4 3.2.6学生选课表course_sel 主键： student_id 字段名字段名字段类型字段宽度学号Student_id char 10 Student_name char 8 课程代码Course_id char 10 课程名称Course_name char 40 学分Credit numeric 2,0 学生成绩表score 主键： student_id 字段名字段名字段类型字段宽度学号Student_id char 10 Student_name char 8 课程代码Course_id char 10 课程名称Course_name char 40 学分Credit numeric 2,0 成绩Score numeric 5,0 3.2.8操作员档案表operator 主键： operator_id 字段名字段名字段类型字段宽度操作员编号Operator_id char 4 操作员Operaor_name char 8 密码Password char 12 权限Permission char 20 本学生管理系统软件可以分成四大功能：1学生的成绩管理2学生的档案管理3学生的课程管理4系统管理1学生的成绩管理主要是管理员对学生成绩的查询、录入、打印、更新、删除、并提交数据库保存。2学生的档案管理是对学生个人档案进行查询、更新、删除以及对院系专业进行查询、打印、更新等操作。3学生的课程管理是对学生的选课信息、课程的设置进行的操作。4系统管理主要包括管理员的管理、数据的备份与恢复等操作。学生管理系统的进入首先必须经过一个用户登录界面，要求用户输入编号和密码，经系统验证是合法用户方可以进入系统主界面，系统的主界面是以最大方式打开的，并且有较为优美的图片作为背景，使用户有一种舒畅的心情主界面以菜单的形式出现在用户面前，并且为了方便用户，主界面还有方便响应的图形工具栏。根据权限的不同，进入主界面后即可对学生成绩管理的各个模块进行操作。学生成绩管理系统的报表格式选用的是普通型的，可分为报表头，表体和页码三部分，精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 4 页，共 18 页5 报表的打印时间是以系统的时间为准。本系统的安全性较好，在进入系统时必须输入操作员编号和密码，这两项必须都正确，方可进入系统， 并且本系统设置一个操作员在进入系统后可以对数据进行更改，其他的用户只可以进行查询、浏览、打印等操作。二、系统设计说明书顶层数据流图1 有效性检验2 处理要求3 处理查询成绩管理要求查询要求非法的成绩管理要求当前日期无效输入有效的查询要求非法操作退出系统学生情况选课情况查询报表0 层数据流图学生成绩管理系统教学管理人员学 生系统时钟成绩管理要求成绩查询学生情况成绩录入成绩报表成绩档案等查询成绩等情况系统当前日期精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 5 页，共 18 页6 2.1 要求类型处理22 成绩录入23 查询成绩2.4 修 改 成 绩密码等2.5 选课录入成绩库成绩管理要求当前日期成绩管理选课查询选课选课卡一层数据流图课程库3.1 查询类别处理3.2 成绩查询3.3 分类统计3.4 按学号统计查询要求学生档案库统计要求查询学生选课情况查询学生情况学生情况选课统计报表学生成绩库课程库一层数据流图选课库精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 6 页，共 18 页7 软件主要界面设计及有关功能说明1系统登录界面。用户必须正确输入编号和口令才能进入主界面，当用户输入系统中操作员数据库中的编号然后按回车键，操作员的文本框会自动显示其，否则将出现“没找到”的提示。本系统只有一个教学管理员，编号为1，口令为0，而有许多一般用户，他们只能进行查询、打印、修改口令等操作。2系统主界面。假设是教学管理人员，他可以对系统进行所有的操作，假设是一般的用户，进入主界面，可以看到主界面一部分是不可用的。3实现对学生成绩的录入的界面，同时实现对学生成绩进行修改、删除、打印的功能。精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 7 页，共 18 页8 4学生档案录入界面。完成对学生档案的添加、修改、保存及打印成绩报表等操作。5实现对学生档案的录入的界面。同时实现对学生成绩进行修改、删除、打印的功能精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 8 页，共 18 页9 6实现对学生院系、专业的修改的界面7功能：完成学生院系专业的查询和打印。精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 9 页，共 18 页10 8实现对学生课程的添加和修改的界面。9实现对学生所选课程的添加、修改和保存的界面。同时选课可以有按学生和按科目两种。精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 10 页，共 18 页11 10操作员管理界面。功能：完成对操作员的信息进行管理的操作。11成绩查询界面。完成对学生的成绩进行查询，可以根据学生查询和课程查询。按学生查询是可以显示所查学生的平均成绩、最高成绩， 并且不及格的学生成绩是用红色显示出来的。精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 11 页，共 18 页12 12学生档案的查询。完成对学生档案的查询。三、测试计划1 任务概述精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 12 页，共 18 页13 1.1 测试目标以最少的时间和人力系统去找出软件潜在的各种错误和缺陷。1.2 运行环境1 软件环境，并装有 , 装有打印机等外部设备。2硬件环境最低配置：?CPU ：奔腾 100MHz以上?内存： 32MB ?显卡：标准VGA ，16 色显示模式建议配置：?CPU ：奔腾 166 MMX以上?内存： 64MB以上?显卡：标准VGA ，24 位真彩色?其它：鼠标3语言支持支持简体中文、 繁体中文、 英语、日语四种语言文字， 其中英语可以在所有语言Windows平台上工作。将来会支持更多语言。2.1 测试方案白盒测试测试用例设计：利用条件组合覆盖可以将系统划为四大功能模块如下列图从图中可以看出假设干个分支，对于每一个判断，要求所有的可能条件的取值的组合都必须取到。学生成绩管理系统系统管理成绩管理档案管理课程管理登录合 法操 作员库操作退出添加，删除，修改等操作添加，删除，查询等操作添加，删除，修改等操作数据备份， 恢复，口 令 更 改 等 操作。正确密码错误精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 13 页，共 18 页14 黑盒测试测试用例设计：因果图测试下面是关于用户登录等的因果图原因1. 打开登录界面结果4 编号错误5 编号密码都错误6 输入都正确26 成功进入系统打开登录界面 21.等待用户输入入正确编号 22.提示没有找到输入正确密码 E 23.提示密码错误编号错误 24.提示请重新输入编号密码都错误 25.输入正确的编号和密码输入都正确 26. 成功进入系统精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 14 页，共 18 页15 四、测试分析报告1.测试计划执行情况一个成功测试的标准可以表示为缺陷在上述优先级上所应表达的分布方式。例如，对于一个成功的测试标准来说，可能不存在优先级为1 的打开的缺陷， 而且优先级为2 的打开的缺陷要少于5 个。例如下面的缺陷分布图：很明显该图显示的情况没有到达标准。请注意， 该图需要通过过滤器才能只显示需要的打开的缺陷。缺陷状态与严重性缺陷严重性报告显示每种严重性级别的缺陷个数，例如致命错误、未执行主要功能、次要错误等严重性级别。缺陷状态与在实施模型中的位置缺陷起源报告显示缺陷在实施模型元素上的分布情况。缺陷龄期报告缺陷龄期分析提供了有关测试有效性和缺陷排除活动的良好反馈。例如，如果大部分龄期较长的、 未解决的缺陷处于有待确认的状态，则可能说明没有充足的资源应用于再次测试工作。缺陷趋势报告趋势报告确定缺陷率并提供了一个出色的测试状态视图。在测试生命周期中，缺陷趋势遵循着一种比较好预测的模式。在生命周期的初期，缺陷率增长很快。在到达顶峰后，就随时间以较慢的速率下降。精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 15 页，共 18 页16 要发现问题，可以根据这一趋势复审项目时间表。例如，在四个星期的生命周期中，如果缺陷率在第三个星期中仍然增长，则项目很明显没有按时间表进行。这一简单的趋势分析假定：缺陷是立即关闭的， 且在随后的工作版本中对修复进行测试，这样关闭缺陷的速率应该遵循与打开缺陷的速率相同的增减趋势。如果情况并非如此，则说明缺陷解决流程发生了问题；缺陷修复所需的资源或再次测试和确认修复所需的资源可能不足。2.评价测试的主要评测方法动态监测动态监测通常以柱状图或曲线图的形式提供实时显示/报告。该报告用于在测试执行过程中，通过显示当前的情况、状态以及测试脚本正在执行的进度来监测或评估性能测试执行情况。例如，在以上柱状图中，有80 个测试脚本正在执行相同的用例。图中显示，有14 个测试脚本处于空闲状态，12 个处于查询状态， 34 个处于SQL 执行状态， 4 个处于SQL 连接状态， 16 个处于其他状态。随着测试的进行，我们将看到各状态脚本的数量会发生变化。精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 16 页，共 18 页17 显示的输出将是正常执行且正在执行中的典型测试执行。但是， 如果在测试执行过程中，测试脚本始终保持一种状态或没有显示任何变化，则说明测试执行发生问题或者需要实施或执行其他性能评测。响应时间 /吞吐量报告正如其名称的含义一样，响应时间/吞吐量报告评测并计算与时间和/或吞吐量处理的事务数相关的性能行为。这些报告通常用曲线图显示，响应时间或事务数y轴上，而事件数在 x 轴上。除了显示实际的性能行为外，它在计算并显示统计信息方面也很实用，如显示数据值的平均偏差和标准偏差。当性能行为可以接受时，或性能监测说明存在可能的瓶颈时如当测试脚本保持给定状态的时间过长 ，追踪报告可能是最有价值的报告。追踪和配置文件报告显示低级信息。该信息包括主角与测试对象之间的消息、执行流、数据访问以及函数和系统调用。该报告反映的趋势显示，在项目开始时， 发现和打开新缺陷的速率很快，但随着时间推移，该速率不断降低。打开的缺陷的趋势与新缺陷的趋势相似，但稍微滞后一些。关闭的缺陷的趋势随着打开的缺陷的修复和核实而不断增长。这些趋势描述的是成功的工作。五、程序维护手册1.引言本系统维护手册适用于系统管理员和一般用户。项目提出者：安徽农业大学教务处开发者：自由软件开发室用户：安徽农业大学教务处成绩管理员和一般学生只可以查询场所：假定在学校的计算中心有功能强大的工作站机器，在各系、各部门、图书馆、学精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 17 页，共 18 页18 生宿舍都有台式PC机，学校的全部电脑已经连网。那么本项目软件将采用客户机/ 服务器结构建立， 学生成绩管理系统的应用服务器和数据库服务器设置在学校计算中心的工作站。学生、教师和教学管理人员可以在各系、各部门、图书馆、学生宿舍的台式机上使用学生成绩管理系统。2.系统说明2.1 系统用途：1完成数据的录入和修改，并提交数据库保存。其中包括：院系及专业设置、课程设置、学生档案、学生成绩、选课记录以及操作员档案等。2实现信息查询。如学生成绩查询、学生档案查询等。3信息具有一定的安全性，如只有一定的权限，才能进行数据的录入和修改。故需要对操作员的权限进行设置，并设置密码。4具有数据备份和数据恢复的功能。本系统的安全性较好，在进入系统时必须输入操作员编号和密码，这两项必须都正确，方可进入系统， 并且本系统设置一个操作员在进入系统后可以对数据进行更改，其他的用户只可以进行查询、浏览、打印等操作。3.操作环境在学校的计算中心有功能强大的工作站机器，在各系、各部门、图书馆、学生宿舍都有台式 PC机，学校的全部电脑已经连网。本项目软件采用的是客户机/ 服务器结构建立，学生成绩管理系统的应用服务器和数据库服务器设置在学校计算中心的工作站。学生、教师和教学管理人员可以在各系、各部门、图书馆、学生宿舍的台式机上使用学生成绩管理系统。由于本学生管理系统是用PowerBuilder开发的， PowerBuilder提供了 ODBC 接口，它能够用统一的方法处理不同的数据源，减轻了学习新系统的压力。目前除了Oracle 、 Sybase、Microsoft SQL 、IBM DB2等大型的数据库管理系统支持OCBC 接口外，诸如dBase、FoxPro、ASA 、Excel 之类的数据源也支持ODBC 接口。本系统利用PowerBuilder 内置的桌面管理系统Adaptive Server Anywhere( 简称 ASA) 建立一个 score 数据库，其中包括 8 个数据表， 分别是：院系表department 、 专业表major 、教师档案表teacher 、学生档案表student 课程设置表course 、学生选课表course_sel 、学生成绩表score 、操作员档案表operator 。结束语：至此一个用PowerBuilder 开发的项目学生成绩管理系统已经完成了，然而要用 PowerBuilder 开发一个优秀的应用程序，还要一个逐步的实践、逐步的积累经验的过程。软件工程作为一门年轻的学科，尽管其中也包含了大量的理论的内容，但它具有一个显著的特点是实践性。软件学科的实践性不仅表达在，它的形成和发展得益于软件工程项目的推动，或者说，是人们在软件开发的实践中碰壁之后为寻求“软件危机”的出路而总结出的原则和方法；而且它的实践性还表达在对于软件开发项目的实际指导作用限于水平有限，时间仓促，课程设计中难免有不妥之处，敬请老师提出珍贵意见！精选学习资料 - - - - - - - - - 名师归纳总结 - - - - - - -第 18 页，共 18 页