软件产品开发文档(规格说明书)

1、例：软件产品开发文档一、 需求规格说明书1.引言 1.1编写目的在软件项目开发过程的初期，用户对自身的需求也仅仅有一个模糊的概念需求分析的目的就是把这个概念具体化，并在用户和开发人员之间达成共识，包括对用户需求的全面了解和分析、筛选，明确所要开发的软件项目的职责界限、并进行可行性研究和指定资源、进度预算等。1.2项目背景本项目的委托单位为安徽农业大学教务处，开发单位为自由软件开发室，主管部门为自由软件开发室的项目经理部。随着高等教育的改革和高校的不断扩招，传统的教学管理方式已远远不能满足高等教育的发展，高等教育的发展也使传统的教学管理方式日益被淘汰，这样以来，一批精明的软件开发商开发了基于局部

2、网络（校园网）和数据库的应用系统。大多情况下，这些系统是以客户机/服务器结构的分布式系统，它的核心教学管理系统和数据库放置在学校的中心计算机上，用户接口端的应用程序分别配置在图书馆、专业系、和学生宿舍的客户机上.2.任务概述2.1目标成绩管理系统实现以下功能：学生成绩管理系统档 案 管 理成绩管理系 统 管 理课程管理退出系统数据恢复数据备份操作员管理重新登录口令更改院系专业查询成绩查询成绩录入院系专业查询院系专业查询院系专业设置选课管理课程设置按学生查询按学生查询2.2 运行环境（1） 软件环境Windows操作系统：Windows 95/98/Me或Windows NT4.0/2000/X

3、P。（2）硬件环境最低配置：· CPU：奔腾100MHz以上 · 内存：32MB · 显卡：标准VGA，16色显示模式 建议配置：· CPU：奔腾166 MMX以上 · 内存：64MB以上 · 显卡：标准VGA，24位真彩色 · 其它：鼠标 （3）语言支持支持简体中文、繁体中文、英语、日语四种语言文字，其中英语可以在所有语言Windows平台上工作。将来会支持更多语言。2.3条件与限制2.3.1常见问题（1） 在将本项目软件编译生成可执行文件后，安装时应注意操作，防止死机。（2） 为了确保您正常的安装与使用，强烈建议您在安装

4、学生管理系统软件前重启系统后再安装。（3） 在Windows95/98/NT系统下安装学生管理系统时时，有时会出现" PBVM80.DLL和LIBJCC.DLL不存在，请检查安装路径或重新启动"的提示。 产生这个问题是由于您系统中的此文件版本过低，只要按照提示，重新启动计算机就可以了。（4） 本系统软件在未生成可执行文件前如果随意改变数据库的路径，再运行时便出现数据库连接失败的情况，鉴于这一点，也可以说数据库的操作和管理是PowerBuilder应用程序的核心，数据库管理在应用程序开发的初级阶段是非常关键的。经过不断摸索和研究，我们会渐渐地掌握PowerBuilder内置的

5、桌面管理系统Adaptive Server Anywhere(简称ASA)能够非常方便的建立、删除、和连接等一系列操作。3数据描述3.1数据库描述本系统利用PowerBuilder内置的桌面管理系统Adaptive Server Anywhere(简称ASA)建立一个score数据库，其中包括8个数据表，分别是：院系表（department）、专业表（major）、教师档案表（teacher）、学生档案表（student）课程设置表（course）、学生选课表（course_sel）、学生成绩表（score）、操作员档案表（operator）3.2数据字典3.2.1院系表（department

6、）主键：department_id 字段名字段名字段类型字段宽度院系代码Department_idchar6院系名称Department_namechar403.2.2专业表（major）主键：major_id字段名字段名字段类型字段宽度专业代码Major_idchar6专业名称Major_namechar40 所属院系代码Department_idchar6 所属院系名称 Department_namechar403.2.3教师档案表（student）主键：student_id字段名字段名字段类型字段宽度教师编号Teacher_idchar6教师名称Teacher_namechar8所属院系

7、代码Department_idchar40所属院系名称Department_namechar403.2.4学生档案表（student）主键：student_id字段名字段名字段类型字段宽度学号Student_idchar10姓名Student_namechar12性别sexchar2出生日期Birthdaydate格式:mm/dd/yyyy民族Nationchar10政治面貌Backgroundchar40职务Dutychar10院系Department_namechar40专业Major_namechar40班级Classchar4籍贯Hometownchar20联系地址Addresscha

8、r30电话Telephonechar20状态Statuschar6不及格门数Falurechar2备注Remarkchar303.2.5课程设置表（course）主键：course_id字段名字段名字段类型字段宽度课程代码Course_idchar10课程名称Course_namechar40学时Periodnumeric4,0学分Creditnumeric2,0类别Kindchar6教师编号Teacher_idchar6教师姓名Teacher_namechar8开课单位Give_unitchar40开课时间Give_timechar6选课范围Limitchar20内容简介Contentcha

9、r40备注Remarkchar30 3.2.6学生选课表（course_sel）主键：student_id字段名字段名字段类型字段宽度学号Student_idchar10姓名Student_namechar8课程代码Course_idchar10课程名称Course_namechar40学分Creditnumeric2,03.2.7学生成绩表（score）主键：student_id字段名字段名字段类型字段宽度学号Student_idchar10姓名Student_namechar8课程代码Course_idchar10课程名称Course_namechar40学分Creditnumeric2,

10、0成绩Scorenumeric5,03.2.8操作员档案表（operator）主键：operator_id字段名字段名字段类型字段宽度操作员编号Operator_idchar4操作员姓名Operaor_namechar8密码Passwordchar12权限Permissionchar204.功能需求4.1功能划分本学生管理系统软件可以分成四大功能：（1）学生的成绩管理（2）学生的档案管理（3）学生的课程管理（4）系统管理4.2功能描述（1）学生的成绩管理主要是管理员对学生成绩的查询、录入、打印、更新、删除、并提交数据库保存。（2）学生的档案管理是对学生个人档案进行查询、更新、删除以及对院系专业

11、进行查询、打印、更新等操作。（3）学生的课程管理是对学生的选课信息、课程的设置进行的操作。 （4）系统管理主要包括管理员的管理、数据的备份与恢复等操作。5.运行需求5.1用户界面学生管理系统的进入首先必须经过一个用户登录界面，要求用户输入编号和密码，经系统验证是合法用户方可以进入系统主界面，系统的主界面是以最大方式打开的，并且有较为优美的图片作为背景，使用户有一种舒畅的心情主界面以菜单的形式出现在用户面前，并且为了方便用户，主界面还有方便响应的图形工具栏。根据权限的不同，进入主界面后即可对学生成绩管理的各个模块进行操作。学生成绩管理系统的报表格式选用的是普通型的，可分为报表头，表体和页码三部分

12、，报表的打印时间是以系统的时间为准。7.其它需求 本系统的安全性较好，在进入系统时必须输入操作员编号和密码，这两项必须都正确，方可进入系统，并且本系统设置一个操作员在进入系统后可以对数据进行更改，其他的用户只可以进行查询、浏览、打印等操作。二、 系统设计说明书1.数据流图成绩管理要求学 生教学管理人员成绩档案等查询成绩等情况成绩查询学生成绩管理系统成绩录入成绩报表系统当前日期学生情况系统时钟顶层数据流图 2.系统软件主要界面设计及有关功能说明（1）系统登录界面。用户必须正确输入编号和口令才能进入主界面，当用户输入系统中操作员数据库中的编号然后按回车键，操作员姓名的文本框会自动显示其姓名，否则将

13、出现“没找到”的提示。本系统只有一个教学管理员，编号为1，口令为0，而有许多一般用户，他们只能进行查询、打印、修改口令等操作。 （2）系统主界面。若是教学管理人员，他可以对系统进行所有的操作，若是一般的用户，进入主界面 ，可以看到主界面一部分是不可用的。（3）实现对学生成绩的录入的界面，同时实现对学生成绩进行修改、删除、打印的功能。（4）学生档案录入界面。完成对学生档案的添加、修改、保存及打印成绩报表等操作 。（5）实现对学生档案的录入的界面。同时实现对学生成绩进行修改、删除、打印的功能（6）实现对学生院系、专业的修改的界面（7）功能：完成学生院系专业的查询和打印。（8）实现对学生课程的添加和

14、修改的界面。（9）实现对学生所选课程的添加、修改和保存的界面。同时选课可以有按学生和按科目两种。（10）操作员管理界面。功能：完成对操作员的信息进行管理的操作。（11）成绩查询界面。完成对学生的成绩进行查询，可以根据学生查询和课程查询。按学生查询是可以显示所查学生的平均成绩、最高成绩，并且不及格的学生成绩是用红色显示出来的。（12）学生档案的查询。完成对学生档案的查询。三、测试计划1 任务概述1. 1测试目标以最少的时间和人力系统去找出软件潜在的各种错误和缺陷。1. 2运行环境（1） 软件环境Windows操作系统：Windows 95/98/Me或Windows NT4.0/2000/XP，

15、并装有PowerBuilder8.0,装有打印机等外部设备。（2）硬件环境最低配置：· CPU：奔腾100MHz以上 · 内存：32MB · 显卡：标准VGA，16色显示模式 建议配置：· CPU：奔腾166 MMX以上 · 内存：64MB以上 · 显卡：标准VGA，24位真彩色 · 其它：鼠标 （3）语言支持支持简体中文、繁体中文、英语、日语四种语言文字，其中英语可以在所有语言Windows平台上工作。将来会支持更多语言。 2.测试计划2. 1测试方案2.1.1白盒测试 测试用例设计：利用条件组合覆盖可以将系统划为四大功能

16、模块如下图登录添加，删除，修改等操作成绩管理操作员库合法用户添加，删除，查询等操作正确档案管理密码错误学生成绩管理系统添加，删除，修改等操作课程管理操作 数据备份，恢复，口令更改等操作。系统管理退出从图中可以看出若干个分支，对于每一个判断，要求所有的可能条件的取值的组合都必须取到。2.1.2黑盒测试测试用例设计：因果图测试下面是关于用户登录等的因果图原因1.打开登录界面 结果21.等待用户输入2.输入编号22.提示没有找到3.输入密码23.提示密码错误4编号错误24.提示请重新输入5编号密码都错误25.输入正确的编号和密码6输入都正确26成功进入系统 打开登录界面 21.等待用户输入入正确编号

17、 22.提示没有找到输入正确密码 E 23.提示密码错误编号错误 24.提示请重新输入编号密码都错误 25.输入正确的编号和密码输入都正确 26. 成功进入系统3.测试工作总体流程图四、测试分析报告1. 测试计划执行情况一个成功测试的标准可以表示为缺陷在上述优先级上所应体现的分布方式。例如，对于一个成功的测试标准来说，可能不存在优先级为 1 的打开的缺陷，而且优先级为 2 的打开的缺陷要少于 5 个。例如下面的缺陷分布图：很明显该图显示的情况没有达到标准。请注意，该图需要通过过滤器才能只显示需要的打开的缺陷。缺陷状态与严重性缺陷严重性报告显示每种严重性级别的缺陷个数，例如致命错误、未执行主要功

18、能、次要错误等严重性级别。缺陷状态与在实施模型中的位置缺陷起源报告显示缺陷在实施模型元素上的分布情况。缺陷龄期报告 缺陷龄期分析提供了有关测试有效性和缺陷排除活动的良好反馈。例如，如果大部分龄期较长的、未解决的缺陷处于有待确认的状态，则可能表明没有充足的资源应用于再次测试工作。缺陷趋势报告 趋势报告确定缺陷率并提供了一个出色的测试状态视图。在测试生命周期中，缺陷趋势遵循着一种比较好预测的模式。在生命周期的初期，缺陷率增长很快。在达到顶峰后，就随时间以较慢的速率下降。要发现问题，可以根据这一趋势复审项目时间表。例如，在四个星期的生命周期中，如果缺陷率在第三个星期中仍然增长，则项目很明显没有按时间

19、表进行。这一简单的趋势分析假定：缺陷是立即关闭的，且在随后的工作版本中对修复进行测试，这样关闭缺陷的速率应该遵循与打开缺陷的速率相同的增减趋势。如果情况并非如此，则表明缺陷解决流程发生了问题；缺陷修复所需的资源或再次测试和确认修复所需的资源可能不足。2. 评价测试的主要评测方法动态监测 动态监测通常以柱状图或曲线图的形式提供实时显示/报告。该报告用于在测试执行过程中，通过显示当前的情况、状态以及测试脚本正在执行的进度来监测或评估性能测试执行情况。例如，在以上柱状图中，有 80 个测试脚本正在执行相同的用例。图中显示，有 14 个测试脚本处于空闲状态，12 个处于查询状态，34 个处于 SQL

20、执行状态，4 个处于 SQL 连接状态，16 个处于其他状态。随着测试的进行，我们将看到各状态脚本的数量会发生变化。显示的输出将是正常执行且正在执行中的典型测试执行。但是，如果在测试执行过程中，测试脚本始终保持一种状态或没有显示任何变化，则表明测试执行发生问题或者需要实施或执行其他性能评测。响应时间/吞吐量报告 正如其名称的含义一样，响应时间/吞吐量报告评测并计算与时间和/或吞吐量（处理的事务数）相关的性能行为。这些报告通常用曲线图显示，响应时间（或事务数）"y"轴上，而事件数在"x"轴上。除了显示实际的性能行为外，它在计算并显示统计信息方面也很实用，如

21、显示数据值的平均偏差和标准偏差。 当性能行为可以接受时，或性能监测表明存在可能的瓶颈时（如当测试脚本保持给定状态的时间过长），追踪报告可能是最有价值的报告。追踪和配置文件报告显示低级信息。该信息包括主角与测试对象之间的消息、执行流、数据访问以及函数和系统调用。该报告反映的趋势显示，在项目开始时，发现和打开新缺陷的速率很快，但随着时间推移，该速率不断降低。打开的缺陷的趋势与新缺陷的趋势相似，但稍微滞后一些。关闭的缺陷的趋势随着打开的缺陷的修复和核实而不断增长。这些趋势描述的是成功的工作。五、程序维护手册1. 引言1.1编写目的本系统维护手册适用于系统管理员和一般用户。1.2项目背景项目提出者：安

22、徽农业大学教务处开发者：自由软件开发室用户：安徽农业大学教务处成绩管理员和一般学生（只可以查询）场所：假定在学校的计算中心有功能强大的工作站机器，在各系、各部门、图书馆、学生宿舍都有台式PC机，学校的全部计算机已经连网。那么本项目软件将采用客户机/服务器结构建立，学生成绩管理系统的应用服务器和数据库服务器设置在学校计算中心的工作站。学生、教师和教学管理人员可以在各系、各部门、图书馆、学生宿舍的台式机上使用学生成绩管理系统。2. 系统说明2.1系统用途：（1）完成数据的录入和修改，并提交数据库保存。其中包括：院系及专业设置、课程设置、学生档案、学生成绩、选课记录以及操作员档案等。（2）实现信息查询。如学生成绩查询、学生档案查询等。（3）信息具有一定的安全性，如只有一定的权限，才能进行数据的录入和修改。故需要对操作员的权限进行设置，并设置密码。（4）具有数据备份和数据恢复的功能。2.2安全保密本系统的安全性较好，在进入系统时必须输入操作员编号和密码，这两项必须都正确，方可进入系统，并且本系统设置一个操作员在进入系统后可以对数据进行更改，其他的用户只可以进行查询、浏览、打印等操作。3. 操作环境3.1设备在学校的计算中心有功能强大的工作站机器，在各系、各部门、图书馆、学生宿舍都有台式PC机，学校的全部计算机已经连网。本项目软件