图书馆管理系统软件文档实训111403017关赛娜.docx
《图书馆管理系统软件文档实训111403017关赛娜.docx》由会员分享，可在线阅读，更多相关《图书馆管理系统软件文档实训111403017关赛娜.docx（27页珍藏版）》请在冰豆网上搜索。
图书馆管理系统软件文档实训111403017关赛娜
辽宁工业大学
软件文档写作实训报告
题目：
图书馆管理系统软件文档
院（系）:
软件学院
专业班级：
计算机信息管理111班
学号：
111403017
学生姓名：
关赛娜
指导教师：
武志刚
教师职称：
讲师
起止时间：
2010.11.22-2010.12.05
实训任务及评语
院（系）：
软件学院教研室：
软件教研室
学号
111403017
学生姓名
关赛娜
专业班级
计算机信息管理111班
实训题目
图书馆管理系统软件文档
实训任务
实训任务及要求：
1、了解软件开发周期各阶段的文档。
2、掌握各文档阐述的内容及作用。
3、了解文档所采用的国际、国家等相关标准。
4、了解各文档所涉及的软件知识。
5、掌握各文档采用的描述工具。
6、具体编写出2个主要的软件文档。
实训过程中，要严格遵守实训的时间安排，听从指导教师的指导。
正确地完成上述内容，记录实习日记，规范完整地撰写出实训报告。
几个人为一组完成一个相对完整的软件系统开发文档，组内成员编写的文档不能重复，文档要严格按照所采用的标准编写，图表布局要合理规范。
指导教师评语及成绩
成绩：
指导教师签字：
2013年12月5日
第1章实训目的与要求
1.1实训目的
本实训要求学生通过具体的实例，模仿软件开发过程中软件文档写作的具体方法和步骤，分组完成一套较为简单软件文档，具体要达到以下几点目的。
1、了解软件开发周期各阶段的文档。
2、掌握各文档阐述的内容及作用。
3、了解文档所采用的国际、国家等相关标准。
4、了解各文档所涉及的软件知识。
5、掌握各文档采用的描述工具。
6、具体编写出2个主要的软件文件。
1.2实训的实验环境
学校图书馆，互联网查询环境，具有软件图表制作软件的计算机。
1.3实训的预备知识
要求学生修完全部专科所有课程，具有较全面计算机软件知识和一定的文献检索能力及动手实践能力。
该实训应安排在毕业设计之前进行。
1.4实训要求
实训过程中，要严格遵守实训的时间安排，听从指导教师的指导。
正确地完成上述内容，记录实习日记，规范完整地撰写出实训报告。
第2章软件文档及其组成
2.1软件文档的作用及分类
文档是计算机软件产品的重要组成部分，没有文档就不成其为软件，也更不能成为软件产品。
软件文档是一种重要的软件工程技术资料。
如系统分析文档、设计文档、版本说明文档。
软件文档的规范编制，在软件开发工作中占有突出的地位和相当大的工作量。
高质量、高效率的编制、分发、管理、维护文档，及时的变更、修正、扩充和使用文档，对于软件产品的设计开发、发行使用、变更维护、转让移植、二次开发等，对于充分发挥软件产品的效益，都有着重要的意义。
开发文档的作用：
（1）作为软件生存期个阶段之间的通信工具，记录生成软件需求、设计、编码、测试等的详细规定和说明；
（2）描述开发小组的工作职责。
通过规定软件规划设计、主题脚本编制、文档编制、质量保证等人员的角色，来定义“如何做”和“何时做”；
（3）用作检验点，而允许管理者评估开发进度。
如果开发文档缺失或过时，管理者将失去跟踪和控制软件项目的重要工具；
（4）形成系统维护人员所要求的基本的软件支持文档，并构成产品文档的一部分；
（5）记录软件开发的历史。
可行性研究报告的内容：
（1）陈述开发目的、要求和限制条件，表达可行性研究的前提条件。
（2）对现有系统的描述，进而阐述系统开发的意义和必要性。
（3）提出若干新系统的建议方案，并依次进行技术、经济和社会可行性分析
（4）在比较多个方案的基础上，得出可行性研究的结论
可行性研究报告的要求：
软件的开发首先要确切定义用户要求解决的问题，即确定要解决问题的性质、目标和规模。
对此，可行性分析人员对所要解决问题的理解是否正确十分关键，因为这决定了开发工作的方向。
（1）阐明目标软件的基本要求
►性能
►输出（如报告、文档或数据，输出项特征，如用途、产生频度、接口及方法对象）
►输入（包括数据来源、类型、数量、数据的组织以及提供的频度）
►处理流程和数据流程（用图表表示最基本的部分，并辅之以文字说明）
►安全和保密方面的要求
►与本系统相关联的其他系统
（2）说明所建议系统的主要开发目标
►人力与设备费用的减少
►处理速度的提高
►控制精度或生产能力的提高
►管理信息服务的改进
►自动决策系统的改进
►人员利用率的改进
（3）说明在该项开发中给出的条件、假定和所受到的限制
►所建议系统的运行寿命的最小值
►进行系统方案选择比较的时间
►经费、投资方面的来源和限制
►法律和政策方面的限制
►硬件、软件、运行环境和开发环境方面的条件和限制
►可利用的信息和资源
►系统投入使用的最晚时间
（4）说明进行可行性研究的方法和评价尺度
►说明该项可行性研究的进行方法，所建议的系统的评价方法。
摘要说明所使用的基本方法和策略，如调查、加权、确定模型、建立基准点或仿真等
►说明对系统进行评价时所使用的主要尺度。
如费用、各项功能的优先次序、开发时间的长短及使用中的难易程度等
（5）对现有系统的分析
►现有系统是新系统将来的取代对象，也是新系统的参照对象。
对现有系统的分析是为了阐明开发新系统的必要性，同时，也是导出新系统的方案的出发点
用户文档
用户文档主要负责对软件产品的安装、配置、使用、维护等信息进行描述。
包括系统安装配置手册、用户操作手册、软件需求说明书、数据要求说明书等。
用户文档的作用
（1）为使用和运行软件产品的用户提供培训和运行参考信息；
（2）为产品维护工程师提供必要的信息；
（3）促进和方便软件产品的市场推广。
管理文档
管理文档主要是对软件开发过程的管理信息进行描述。
管理文档除了前面列表内容，还应该包括被管理者的反馈信息，如各色表格、工作总结、开发体会、产品建议等。
软件测试计划文档
测试计划起到测试工作过程框架结构的功能，是好的测试工作的基础。
一个测试计划的基本内容包括：
基本情况分析、测试需求说明、测试策略和记录、测试资源配置、问题跟踪报告、测试计划的评审等。
基本情况分析。
包括系统运行平台、应用领域、特点和主要功能模块等。
分析要点有：
测试目的和侧重点、系统适合于测试的内容/操作划分、测试的潜在风险、系统与测试相关的资料说明。
测试需求说明。
列出测试功能项，规定应该测试的具体内容。
测试策略和记录。
描述如何开展测试，规定测试记录的内容。
必要时，应给出测试记录文档的模板。
测试资源配置。
针对测试项目的每一个阶段任务，列出所需要的资源，可能的话，给出可能更新需要的空间。
问题跟踪报告。
报告包括问题的发行者和修改者、问题发生的频率、发现问题的测试用例，以及明确问题产生时的测试环境。
问题描述应尽可能是定量、分门别类的列举。
问题分为：
严重问题、一般问题、建议问题。
2.2软件文档所采用的标准
CIMS是英文ComputerIntegratedManufacturingSystems或contemporary的缩写，直译就是计算机/现代集成制造系统。
计算机集成制造----CIM的概念最早是由美国学者哈林顿博士提出的，其基本出发点是：
1）企业的各种生产经营活动是不可分割的，要统一考虑；
2）整个生产制造过程实质上是信息的采集、传递和加工处理的过程。
CIMS定义：
CIMS是通过计算机硬软件。
并综合运用现代管理技术、制造技术、信息技术、自动化技术、系统工程技术。
将企业生产全部过程中有关的人、技术、经营管理三要素及其信息与物流有机集成并优化运行的复杂的大系统。
现代集成制造系统（ContemporaryIntegratedManufacturingSystem）。
将信息技术、现代管理技术和制造技术相结合，并应用于企业全生命周期各个阶段，通过信息集成，过程优化及资源优化，实现物流、信息流、价值流的集成和优化运行，达到人（组织及管理）、经营和技术三要素的集成，以加强企业新产品开发的T、Q、C、S、E，从而提高企业的市场应变能力和竞争力。
从功能上看，CIMS包括了一个制造企业的设计、制造、经营管理三种主要功能，要使这三者集成起来，还需要一个支撑环境，即分布式数据库和计算机网络以及指导集成运行的系统技术。
1.四个功能分系统
（1）管理信息分系统
（2）产品设计与制造工程设计自动化分系统
（3）制造自动化或柔性制造分系统
（4）质量保证分系统
2.两个支撑分系统
（1）计算机网络分系统
（2）数据库分系统
CIMS集成的内涵
集成和连接不同，它不是简单地把两个或多个单元连接在一起，它是将原来没有联系或联系不紧密的单元组成为有一定功能的、紧密联系的新系统。
两种或多种功能的集成包含着两种或多种功能之间的相互作用。
集成是属于系统工程中的系统综合、系统优化范畴。
CIMS的集成，从宏观上看主要是以下5个方面：
1）系统运行环境的集成
2）信息的集成
3）应用功能的集成
4）技术的集成
5）人和组织的集成
2.3软件文档的主要内容
读者登记，即输入读者的具体信息。
输入：
读者具体信息。
处理：
通过图书管理系统写入读者目录文件中。
输出：
读者具体信息。
输入新书的全部信息。
输入：
新书的全部信息。
图书管理系统软件需求分析
处理：
通过图书管理系统写入图书目录文件中。
输出：
新书信息的全部内容。
查询读者的相关信息。
输入：
读者信息的关键字（读者编号或姓名）。
处理：
利用关键字在读者目录文件中找到此编号或姓名读者的相关信息。
输出：
读者的相关信息。
查询图书的信息。
输入：
图书信息的关键字（图书分类号或书名）。
处理：
利用关键字在图书目录文件中找到此图书分类号或书名图书的相关信息。
输出：
图书的相关信息。
输入读者借书信息。
输入：
读者借书信息。
处理：
通过图书管理系统写入借书文件中。
输出：
读者借书信息的全部内容
查询读者借书的相关信息。
输入：
借书信息的关键字（流水号）。
处理：
利用关键字在借书文件中找到此流水号图书的相关信息。
输出：
借书相关信息。
性能
精度需求
在精度需求上，根据使用需要，在各项数据的输入，输出及传输过程中，可以满足各种精度的需求。
时间需求
在软件方面，响应时间，更新处理时间都比较快且迅速，完全满足用户要求。
灵活性当用户需求。
故障处理
内部故障处理：
在开发阶段可以随即修改数据库里的相应内容。
外部故障处理：
对编辑的程序进行重装载时，第一次装载认为错，修改。
第二次运行，在需求调用时出错，有错误提示，重试。
输人输出项
主模块
1.输入项目：
操作系统传递至的各种消息以及用户的输入数据。
2.输出项目：
用户界面显示。
学生管理模块
1.输入项目：
与学生管理操作子对话框有关的用户输入及系统消息。
2.输出项目：
操作结果显示。
图书管理模块
1.输入项目：
用户口令。
2.输出项目：
相应的界面。
借阅管理模块
1.输入项目：
学生学号、图书编号。
2.输出项目：
学生信息、相关借书信息。
归还管理模块
1.输入项目：
图书编号。
2.输出项目：
相关学生信息。
流程逻辑
登陆模块
人机界面设计:
系统响应时间：
学生或管理人员登陆的响应时间应稳定在1s左右；
出错信息处理：
若学生或管理人员输入的帐号和密码不匹配或输入不存在的帐号，系统应友好进行提示，如提示＂youarenotasystemuser！
”
学生登记
程序描述：
实现学生信息登记功能
输入项：
字符串表示的汉字，字符串最大长度是10；整数类型的数字和时间类型的日期
输出项：
字符串表示的汉字，字符串最大长度是10；整数类型的数字和时间类型的日期
算法：
学生登记的程序设计流程图如下
学生查询
程序描述：
实现学生信息查询功能
输入项：
用字符串表示的汉字，字符串最大长度是10；整数类型的数字，最长不超过6
输出项：
用字符串表示的汉字，字符串最大长度是10；整数类型的数字和时间类型的日期
算法：
学生查询的程序设计流程图
图书登记
程序描述
实现图书登记的功能
输入项：
用字符串表示的汉字或英文，字符串最大长度是20；数值型的数字
输出项：
用字符串表示的汉字或英文，字符串最大长度是20；数值型的数字
算法：
实现图书登记的程序设计的流程图
实现查书功能。
输入项：
用字符串表示的汉字或英文，字符串的最大长度为40个字符。
输入方式为标准输入。
输出项：
用字符串表示的汉字或英文，字符串的最大长度为40个字符。
输出方式为标准输出。
算法
接口
外部接口
按Windows应用软件用户界面的规范来设计，使用以对话框为主的用户界面，便于用户使用。
内部接口
模块间接口采用数据耦合方式，通过参数表传送数据，交换信息。
用户接口
本产品的用户一般需要通过终端进行操作，进入主界面后点击相应的窗口，分别进入相对应的界面（如：
输入界面、输出界面）。
用户对程序的维护，最好要
有备份。
限制条件
技术约束：
本项目的设计是在汉语程序设计语言的条件下进行的，技术设计采用软硬一
体化的设计方法。
环境约束：
运行该软件所适用的具体设备必须是奔腾133、内存16兆以上的计算机;
标准约束：
该软件的开发完全按照企业标准开发，包括硬件、软件和文档规格
硬件限制
奔腾133、内存16兆以上PC机满足输入端条件。
第3章实例
3.1测试计划实例
图书馆管理系统测试计划实例（GB8567——88）
1．引言
1.1编写目的
本测试计划文档作为指导此测试项目循序渐进的基础，帮助我们安排合适的资源和进度，避免可能的风险。
本文档有助于实现以下目标：
1）确定现有项目的信息和应测试的软件结构。
2）列出推荐的测试需求
3）推荐可采用的测试策略，并对这些策略加以详细说明
4）确定所需的资源，并对测试的工作量进行估计。
5）列出测试项目的可交付元素，包括用例以及测试报告等。
1.2背景
随着人们知识层次的提高，图书馆成为日常生活中不可缺少的一部分。
而图书馆的存数量和业务量庞大，仅仅靠传统的记账式管理是不可行的。
图书馆管理系统应运而生，逐渐成为信息化建设的重要组成部分。
图书馆管理系统为学校或社会型图书馆的管理员提供所有借阅者的详细信息，以及馆内库存的详细情况，对借书和还书两大功能进行合理操纵并登记。
说明：
开发软件名称：
图书管理系统。
项目开发者：
软件学院：
图书馆管理系统开发小组
用户单位：
辽宁工业大学
1.3定义
主键（PrimaryKey）：
每一笔资料中的主键都是表格中的唯一值。
换言之，它是用来独一无二地确认一个表格中的每一行资料
外键（ForeignKey）：
设表t1,t2中都有一个name字段,而且是t1的主键，那么如果设t2中的name为外键的话，向t2中添加数据的时候,如果name值不在t1之中就会报错。
1.4参考资料
张海藩：
《软件工程导论》第五版清华大学出版社
肖刚等：
《实用软件文档写作》清华大学出版社
李涛等：
VisualC#SQLServer数据库开发与实例清华大学出版社
2计划
2.1软件说明
测试功能
输入
输出
身份验证
用户名、密码、身份
进入读者界面或管理员界面
新书入库
书籍基本信息
Book_Info表中增加一条记录
借书
借阅证号、书号
Book_Info、Proof_Info、Borrow_Info、Punish_Info表中更新记录
还书
借阅证号、书号
书籍挂失
借阅证号、书号
缴费
借阅证号、书号
Proof_Info、Borrow_Info、Punish_Info表中更新记录
图书信息查询
图书号或图书名
显示图书基本信息
借书信息查询
借阅证号
显示借书信息
借阅证查询
借阅证号
显示借阅证信息
借阅证挂失
借阅证号
Proof_Info表中删除一条记录
办理借阅证
借阅证持证人基本信息
Proof_Info表中增加一条记录
注册管理员
账号、密码
Admini_Info表中增加一条记录
修改密码
账号、密码、新密码
Admini_Info表中更新一条记录
2.2测试内容
测试1：
名称：
借书测试。
目的：
测试借书功能。
进度安排：
2013.11.28
内容：
括借阅证号输入、合理性检查、合法性检查，借书对话显示控制，图书书号提交、合理性检查、合法性检查，借书登记。
测试2：
名称：
还书测试。
目的：
测试还书功能。
进度安排：
2013.11.29
内容：
还书对话框显示控制，图书书号提交、合理性检查、合法性检查，还书登记。
2.3借书测试
2.3.1进度安排
工作内容
时间
测试人
准备输入数据
2013-11-288:
00-9:
00
测试人员、学生或教师、图书馆工作人员、管理员
测试
2013-12-39:
00-11:
00
整理测试结果
2013-11-411:
00-14:
00
测试组
2.3.2条件
设备
服务器
（1）处理器（CPU）：
Pentium900M（推荐Pentium41.2G）
（2）内存容量（RAM）：
至少256M（推荐512M）
客户端
（1）处理器（CPU）：
Pentium133M或更高
（2）内存容量（RAM）：
64M或更高
支持软件
数据库服务器端
（1）操作系统：
MicrosoftWindows2003
（2）数据库管理系统：
SQLServer2005，配置TCP/IP协议
Web服务器端
（1）操作系统：
MicrosoftWindows2003
（2）Internet信息服务（IIS）6.0管理器
（3）VisualStudio.NET2005，配置TCP/IP协议
客户端
（1）操作系统：
Windows98/2000/2003/XP
2.3.3测试资料
测试资料主要有软件研发小组的各类文档和图书馆提供的各类资料档案。
2.3.4测试培训
培训内容
受训人员
从事培训的工作人员
熟悉系统环境
测试人员、用户、图书馆工作人员
系统开发组
了解系统功能
测试人员、用户、图书馆工作人员
系统开发组
学习登录的操作
测试人员、用户、图书馆工作人员
系统开发组
学习登录的基本管理
测试人员、用户、图书馆管理人员
系统开发组
2.4还书测试
2.4.1进度安排
工作内容
时间
测试人
准备输入数据
2013-11-288:
00-9:
00
测试人员、学生或教师、图书馆工作人员、管理员
测试
2013-12-39:
00-11:
00
整理测试结果
2013-11-411:
00-14:
00
测试组
2.4.2条件
设备
服务器
（1）处理器（CPU）：
Pentium900M（推荐Pentium41.2G）
（2）内存容量（RAM）：
至少256M（推荐512M）
客户端
（1）处理器（CPU）：
Pentium133M或更高
（2）内存容量（RAM）：
64M或更高
支持软件
数据库服务器端
（1）操作系统：
MicrosoftWindows2003
（2）数据库管理系统：
SQLServer2005，配置TCP/IP协议
Web服务器端
（1）操作系统：
MicrosoftWindows2003
（2）Internet信息服务（IIS）6.0管理器
（3）VisualStudio.NET2005，配置TCP/IP协议
客户端
（1）操作系统：
Windows98/2000/2003/XP
（2）Web浏览器：
InternetExplorer6.0以上或Netscape4.0以上，配置TCP/IP协议
2.4.3测试资料
测试资料主要有软件研发小组的各类文档和图书馆提供的各类资料档案。
2.4.4测试培训
培训内容
受训人员
从事培训的工作人员
学习还书的操作
测试人员、用户、图书馆工作人员
系统开发组
学习还书管理
测试人员、用户、图书馆管理人员
系统开发组
3测试设计说明
3.1借书测试
借阅证号或书号为空；借阅证号不存在；书号不存在；该读者有欠费记录；该读者已借书中有逾期的书籍；该读者已借书的数量已达到8本；借阅证号和书号都正确，且该读者有借书的资格
3.1.1控制
输入：
半自动
操作顺序：
先按上面7种情况的顺序输入相应的借阅证号和书号，再提交。
结果记录方法：
记录输入信息、提示信息、数据库中每个表的更改信息。
3.1.2输入、输出、过程
输入数据
选择策略
命令
输出数据
借阅证号为空，正确书号
测试借阅证号为空的情况
借书按钮
“借阅证号不能为空”的提示框
正确借阅证号，书号为空
测试书号为空的情况
借书按钮
“书号不能为空”的提示框
错误的借阅证号，正确书号
测试当不存在改借阅证时的情况
借书按钮
“该读者不存在”的提示框
正确的借阅证号，错误的书号
测试当书号错误的情况
借书按钮
“该书不存在”的提示框
修改数据库，使得Punish_Info表中有某读者的欠费记录，输入这个读者的借阅证号，输入正确的书号
测试读者有欠费记录时的情况
借书按钮
“该读者已欠费…”的提示框
修改数据库，使某读者的已借书中有逾期的，输入该读者借阅证号和该逾期书籍号
测试读者已借书中有逾期的书籍的情况
借书按钮
“该读者已欠费…”的提示框
使某读者已借阅8本书，该读者继续借书
测试当某读者已借阅书籍已达到8本书的情况
借书按钮
“该读者已借书8本”的提示框
以上情况都没有且借阅证号和书号都正确
测试当读者符合借书条件的情况
借书按钮
“借书成功”的提示框
3.1.3过程
登陆系统，查阅图书，输入图书号查看可否借阅
3.2还书测试
借阅证号或书号为空；借阅证号不存在；书号不存在；该书逾期；借阅证号和书号都正确
3.2.1控制
输入：
半自动
操作顺序：
先按上面5种情况的顺序输入相应的借阅证号和书号，再提交。
结果记录方法：
记录输入信息、提示信息、数据库中每个表的更改信息。
3.2.2输入、输出、过程
输入数据
选择策略
命令
输出数据
借阅证号为空，正确书号
测试借阅证号为空的情况
还书按钮
“借阅证号不能为空”的提示框
正确借阅证号，书号为空
测试书号为空的情况
还书按钮
“书号不能为空”的提示框
错误的借阅证号，正确书号
测试当不存在改借阅证时的情况
还书按钮
“该读者不存在”的提示框
正确的借阅证号，错误的书号
测试当书号错误的情况
还书按钮
“该书不存在”的提
升级会员 