图书馆管理系统软件文档实训111403017关赛娜.docx

1、图书馆管理系统软件文档实训111403017关赛娜辽 宁 工 业 大 学 软件文档写作 实训报告题目： 图书馆管理系统软件文档 院（系）: 软件学院 专业班级： 计算机信息管理111班 学 号： 111403017 学生姓名： 关 赛 娜 指导教师： 武 志 刚 教师职称： 讲 师 起止时间： 2010.11.22-2010.12.05 实训任务及评语院（系）：软件学院 教研室：软件教研室学 号111403017学生姓名关赛娜专业班级计算机信息管理111班实训题目 图书馆管理系统软件文档实训任务实训任务及要求：1、了解软件开发周期各阶段的文档。2、掌握各文档阐述的内容及作用。3、了解文档所采用

2、的国际、国家等相关标准。4、了解各文档所涉及的软件知识。5、掌握各文档采用的描述工具。6、具体编写出2个主要的软件文档。实训过程中，要严格遵守实训的时间安排，听从指导教师的指导。正确地完成上述内容，记录实习日记，规范完整地撰写出实训报告。几个人为一组完成一个相对完整的软件系统开发文档，组内成员编写的文档不能重复，文档要严格按照所采用的标准编写，图表布局要合理规范。指导教师评语及成绩成绩： 指导教师签字： 2013 年12 月 5 日第1章 实训目的与要求1.1 实训目的 本实训要求学生通过具体的实例，模仿软件开发过程中软件文档写作的具体方法和步骤，分组完成一套较为简单软件文档，具体要达到以下几

3、点目的。1、了解软件开发周期各阶段的文档。2、掌握各文档阐述的内容及作用。3、了解文档所采用的国际、国家等相关标准。4、了解各文档所涉及的软件知识。5、掌握各文档采用的描述工具。6、具体编写出2个主要的软件文件。 1.2 实训的实验环境学校图书馆，互联网查询环境，具有软件图表制作软件的计算机。1.3 实训的预备知识要求学生修完全部专科所有课程，具有较全面计算机软件知识和一定的文献检索能力及动手实践能力。该实训应安排在毕业设计之前进行。1.4 实训要求实训过程中，要严格遵守实训的时间安排，听从指导教师的指导。正确地完成上述内容，记录实习日记，规范完整地撰写出实训报告。 第2章 软件文档及其组成2

4、.1软件文档的作用及分类文档是计算机软件产品的重要组成部分，没有文档就不成其为软件，也更不能成为软件产品。软件文档是一种重要的软件工程技术资料。如系统分析文档、设计文档、版本说明文档。软件文档的规范编制，在软件开发工作中占有突出的地位和相当大的工作量。高质量、高效率的编制、分发、管理、维护文档，及时的变更、修正、扩充和使用文档，对于软件产品的设计开发、发行使用、变更维护、转让移植、二次开发等，对于充分发挥软件产品的效益，都有着重要的意义。开发文档的作用：(1) 作为软件生存期个阶段之间的通信工具，记录生成软件需求、设计、编码、测试等的详细规定和说明；(2) 描述开发小组的工作职责。通过规定软件

5、规划设计、主题脚本编制、文档编制、质量保证等人员的角色，来定义“如何做”和“何时做”；(3) 用作检验点，而允许管理者评估开发进度。如果开发文档缺失或过时，管理者将失去跟踪和控制软件项目的重要工具；(4) 形成系统维护人员所要求的基本的软件支持文档，并构成产品文档 的一部分；(5) 记录软件开发的历史。可行性研究报告的内容：(1) 陈述开发目的、要求和限制条件，表达可行性研究的前提条件。(2) 对现有系统的描述，进而阐述系统开发的意义和必要性。(3) 提出若干新系统的建议方案，并依次进行技术、经济和社会可行性分析(4) 在比较多个方案的基础上，得出可行性研究的结论 可行性研究报告的要求：软件的

6、开发首先要确切定义用户要求解决的问题，即确定要解决问题的性质、目标和规模。对此，可行性分析人员对所要解决问题的理解是否正确十分关键，因为这决定了开发工作的方向。 (1) 阐明目标软件的基本要求 性能 输出(如报告、文档或数据，输出项特征，如用途、产生频度、接口及方法对象) 输入(包括数据来源、类型、数量、数据的组织以及提供的频度) 处理流程和数据流程(用图表表示最基本的部分，并辅之以文字说明) 安全和保密方面的要求 与本系统相关联的其他系统(2) 说明所建议系统的主要开发目标 人力与设备费用的减少 处理速度的提高 控制精度或生产能力的提高 管理信息服务的改进 自动决策系统的改进 人员利用率的改

7、进(3) 说明在该项开发中给出的条件、假定和所受到的限制 所建议系统的运行寿命的最小值 进行系统方案选择比较的时间 经费、投资方面的来源和限制 法律和政策方面的限制 硬件、软件、运行环境和开发环境方面的条件和限制 可利用的信息和资源 系统投入使用的最晚时间(4) 说明进行可行性研究的方法和评价尺度 说明该项可行性研究的进行方法，所建议的系统的评价方法。摘要说明所使用的基本方法和策略，如调查、加权、确定模型、建立基准点或仿真等 说明对系统进行评价时所使用的主要尺度。如费用、各项功能的优先次序、开发时间的长短及使用中的难易程度等(5) 对现有系统的分析 现有系统是新系统将来的取代对象，也是新系统的

8、参照对象。对现有系统的分析是为了阐明开发新系统的必要性，同时，也是导出新系统的方案的出发点用户文档用户文档主要负责对软件产品的安装、配置、使用、维护等信息进行描述。包括系统安装配置手册、用户操作手册、软件需求说明书、数据要求说明书等。用户文档的作用(1) 为使用和运行软件产品的用户提供培训和运行参考信息；(2) 为产品维护工程师提供必要的信息；(3) 促进和方便软件产品的市场推广。管理文档 管理文档主要是对软件开发过程的管理信息进行描述。管理文档除了前面列表内容，还应该包括被管理者的反馈信息，如各色表格、工作总结、开发体会、产品建议等。软件测试计划文档测试计划起到测试工作过程框架结构的功能，是

9、好的测试工作的基础。一个测试计划的基本内容包括：基本情况分析、测试需求说明、测试策略和记录、测试资源配置、问题跟踪报告、测试计划的评审等。基本情况分析。包括系统运行平台、应用领域、特点和主要功能模块等。分析要点有：测试目的和侧重点、系统适合于测试的内容/操作划分、测试的潜在风险、系统与测试相关的资料说明。测试需求说明。列出测试功能项，规定应该测试的具体内容。测试策略和记录。描述如何开展测试，规定测试记录的内容。必要时，应给出测试记录文档的模板。测试资源配置。针对测试项目的每一个阶段任务，列出所需要的资源，可能的话，给出可能更新需要的空间。问题跟踪报告。报告包括问题的发行者和修改者、问题发生的频

10、率、发现问题的测试用例，以及明确问题产生时的测试环境。问题描述应尽可能是定量、分门别类的列举。问题分为：严重问题、一般问题、建议问题。2.2软件文档所采用的标准CIMS是英文Computer Integrated Manufacturing Systems或contemporary的缩写，直译就是计算机/现代集成制造系统。计算机集成制造-CIM的概念最早是由美国学者哈林顿博士提出的，其基本出发点是： 1）企业的各种生产经营活动是不可分割的，要统一考虑； 2）整个生产制造过程实质上是信息的采集、传递和加工处理的过程。 CIMS 定义：CIMS是通过计算机硬软件。并综合运用现代管理技术、制造技术、

11、信息技术、自动化技术、系统工程技术。将企业生产全部过程中有关的人、技术、经营管理三要素及其信息与物流有机集成并优化运行的复杂的大系统。现代集成制造系统（Contemporary Integrated Manufacturing System）。将信息技术、现代管理技术和制造技术相结合，并应用于企业全生命周期各个阶段，通过信息集成，过程优化及资源优化，实现物流、信息流、价值流的集成和优化运行，达到人（组织及管理）、经营和技术三要素的集成，以加强企业新产品开发的T、Q、C、S、E，从而提高企业的市场应变能力和竞争力。从功能上看，CIMS包括了一个制造企业的设计、制造、经营管理三种主要功能，要使这三

12、者集成起来，还需要一个支撑环境，即分布式数据库和计算机网络以及指导集成运行的系统技术。 1.四个功能分系统 （1）管理信息分系统 （2）产品设计与制造工程设计自动化分系统 （3）制造自动化或柔性制造分系统 （4）质量保证分系统 2.两个支撑分系统 （1）计算机网络分系统 （2) 数据库分系统CIMS集成的内涵集成和连接不同，它不是简单地把两个或多个单元连接在一起，它是将原来没有联系或联系不紧密的单元组成为有一定功能的、紧密联系的新系统。两种或多种功能的集成包含着两种或多种功能之间的相互作用。集成是属于系统工程中的系统综合、系统优化范畴。CIMS的集成，从宏观上看主要是以下5个方面： 1）系统运

13、行环境的集成 2）信息的集成 3）应用功能的集成 4）技术的集成 5）人和组织的集成2.3软件文档的主要内容 读者登记，即输入读者的具体信息。 输入 ：读者具体信息。 处理 ：通过图书管理系统写入读者目录文件中。 输出 ：读者具体信息。 输入新书的全部信息。 输入 ：新书的全部信息。 图书管理系统软件需求分析 处理 ：通过图书管理系统写入图书目录文件中。 输出 ：新书信息的全部内容。 查询读者的相关信息。 输入 ：读者信息的关键字（读者编号或姓名）。 处理 ：利用关键字在读者目录文件中找到此编号或姓名读者的相关信息。 输出 ：读者的相关信息。 查询图书的信息。 输入 ：图书信息的关键字（图书分

14、类号或书名）。 处理 ：利用关键字在图书目录文件中找到此图书分类号或书名图书的相关信息。 输出 ：图书的相关信息。 输入读者借书信息。 输入 ：读者借书信息。 处理 ：通过图书管理系统写入借书文件中。 输出 ：读者借书信息的全部内容 查询读者借书的相关信息。 输入 ：借书信息的关键字（流水号）。 处理 ：利用关键字在借书文件中找到此流水号图书的相关信息。 输出 ：借书相关信息。性能精度需求 在精度需求上，根据使用需要，在各项数据的输入，输出及传输过程中，可以满足各种精度的需求。 时间需求 在软件方面，响应时间，更新处理时间都比较快且迅速，完全满足用户要求。灵活性当用户需求。故障处理 内部故障处

15、理 ：在开发阶段可以随即修改数据库里的相应内容。 外部故障处理 ：对编辑的程序进行重装载时，第一次装载认为错，修改。第二次运行，在需求调用时出错，有错误提示，重试。输人输出项主模块1.输入项目：操作系统传递至的各种消息以及用户的输入数据。2.输出项目：用户界面显示。学生管理模块1.输入项目：与学生管理操作子对话框有关的用户输入及系统消息。2.输出项目：操作结果显示。图书管理模块1.输入项目：用户口令。2.输出项目：相应的界面。借阅管理模块1.输入项目：学生学号、图书编号。2.输出项目：学生信息、相关借书信息。归还管理模块1.输入项目：图书编号。2.输出项目：相关学生信息。流程逻辑登陆模块人机界

16、面设计:系统响应时间：学生或管理人员登陆的响应时间应稳定在1s左右；出错信息处理：若学生或管理人员输入的帐号和密码不匹配或输入不存在的帐号，系统应友好进行提示，如提示you are not a system user ！”学生登记程序描述：实现学生信息登记功能输入项：字符串表示的汉字，字符串最大长度是10；整数类型的数字和时间类型的日期输出项：字符串表示的汉字，字符串最大长度是10；整数类型的数字和时间类型的日期算法：学生登记的程序设计流程图如下学生查询程序描述：实现学生信息查询功能输入项：用字符串表示的汉字，字符串最大长度是10；整数类型的数字，最长不超过6输出项：用字符串表示的汉字，字符串

17、最大长度是10；整数类型的数字和时间类型的日期算法：学生查询的程序设计流程图图书登记程序描述 实现图书登记的功能输入项：用字符串表示的汉字或英文，字符串最大长度是20；数值型的数字输出项：用字符串表示的汉字或英文，字符串最大长度是20；数值型的数字算法：实现图书登记的程序设计的流程图 实现查书功能。输入项：用字符串表示的汉字或英文，字符串的最大长度为40个字符。输入方式为标准输入。输出项：用字符串表示的汉字或英文，字符串的最大长度为40个字符。输出方式为标准输出。算法接口外部接口按Windows应用软件用户界面的规范来设计，使用以对话框为主的用户界面，便于用户使用。内部接口模块间接口采用数据耦

18、合方式，通过参数表传送数据，交换信息。用户接口本产品的用户一般需要通过终端进行操作，进入主界面后点击相应的窗口，分别进入相对应的界面(如：输入界面、输出界面)。用户对程序的维护，最好要有备份。限制条件技术约束 ：本项目的设计是在汉语程序设计语言的条件下进行的，技术设计采用软硬一体化的设计方法。 环境约束 ：运行该软件所适用的具体设备必须是奔腾133、内存16兆以上的计算机;标准约束 ：该软件的开发完全按照企业标准开发，包括硬件、软件和文档规格硬件限制 奔腾133 、内存16兆以上PC机满足输入端条件。第3章 实 例3.1 测试计划实例图书馆管理系统测试计划实例（GB856788）1引言1.1编

19、写目的本测试计划文档作为指导此测试项目循序渐进的基础，帮助我们安排合适的资源和进度，避免可能的风险。本文档有助于实现以下目标：1)确定现有项目的信息和应测试的软件结构。2)列出推荐的测试需求3)推荐可采用的测试策略，并对这些策略加以详细说明4)确定所需的资源，并对测试的工作量进行估计。5)列出测试项目的可交付元素，包括用例以及测试报告等。1.2背景随着人们知识层次的提高，图书馆成为日常生活中不可缺少的一部分。而图书馆的存数量和业务量庞大，仅仅靠传统的记账式管理是不可行的。图书馆管理系统应运而生，逐渐成为信息化建设的重要组成部分。图书馆管理系统为学校或社会型图书馆的管理员提供所有借阅者的详细信息

20、，以及馆内库存的详细情况，对借书和还书两大功能进行合理操纵并登记。说明：开发软件名称：图书管理系统。项目开发者：软件学院：图书馆管理系统开发小组 用户单位：辽宁工业大学1.3定义主键 (Primary Key) ：每一笔资料中的主键都是表格中的唯一值。换言之，它是用来独一无二地确认一个表格中的每一行资料外键（Foreign Key）：设表t1,t2中都有一个name字段,而且是t1的主键，那么如果设t2中的name为外键的话，向t2中添加数据的时候,如果name值不在t1之中就会报错。1.4参考资料张海藩：软件工程导论第五版 清华大学出版社肖刚等：实用软件文档写作清华大学出版社李涛等：Visu

21、al C# SQL Server 数据库开发与实例 清华大学出版社2计划2.1软件说明测试功能输入输出身份验证用户名、密码、身份进入读者界面或管理员界面新书入库书籍基本信息Book_Info表中增加一条记录借书借阅证号、书号Book_Info、Proof_Info、Borrow_Info、Punish_Info表中更新记录还书借阅证号、书号书籍挂失借阅证号、书号缴费借阅证号、书号Proof_Info、Borrow_Info、Punish_Info表中更新记录图书信息查询图书号或图书名显示图书基本信息借书信息查询借阅证号显示借书信息借阅证查询借阅证号显示借阅证信息借阅证挂失借阅证号Proof_I

22、nfo表中删除一条记录办理借阅证借阅证持证人基本信息Proof_Info表中增加一条记录注册管理员账号、密码Admini_Info表中增加一条记录修改密码账号、密码、新密码Admini_Info表中更新一条记录2.2测试内容测试 1：名称：借书测试。 目的：测试借书功能。 进度安排：2013.11.28 内容：括借阅证号输入、合理性检查、合法性检查，借书对话显示控制，图书书号提交、合理性检查、合法性检查，借书登记。测试 2：名称： 还书测试。 目的：测试还书功能。 进度安排：2013.11.29 内容：还书对话框显示控制，图书书号提交、合理性检查、合法性检查，还书登记。2.3借书测试2.3.1

23、进度安排工作内容时间测试人准备输入数据2013-11-28 8:00-9:00测试人员、学生或教师、图书馆工作人员、管理员测试2013-12-3 9:00-11:00整理测试结果2013-11-4 11:00-14:00测试组2.3.2条件设备服务器 (1) 处理器（CPU）：Pentium 900M (推荐Pentium 4 1.2G） (2) 内存容量（RAM）：至少256M（推荐 512M）客户端 (1) 处理器（CPU）：Pentium 133M 或更高 (2) 内存容量（RAM）：64M或更高支持软件数据库服务器端(1) 操作系统：Microsoft Windows 2003(2)

24、数据库管理系统：SQL Server 2005，配置TCP/IP协议Web服务器端(1) 操作系统：Microsoft Windows 2003(2) Internet 信息服务（IIS）6.0管理器(3) Visual Studio.NET 2005，配置TCP/IP协议 客户端(1) 操作系统：Windows 98/2000/2003/XP2.3.3测试资料测试资料主要有软件研发小组的各类文档和图书馆提供的各类资料档案。2.3.4测试培训培训内容受训人员从事培训的工作人员熟悉系统环境测试人员、用户、图书馆工作人员系统开发组了解系统功能测试人员、用户、图书馆工作人员系统开发组学习登录的操作测

25、试人员、用户、图书馆工作人员系统开发组学习登录的基本管理测试人员、用户、图书馆管理人员系统开发组2.4还书测试2.4.1进度安排工作内容时间测试人准备输入数据2013-11-28 8:00-9:00测试人员、学生或教师、图书馆工作人员、管理员测试2013-12-3 9:00-11:00整理测试结果2013-11-4 11:00-14:00测试组2.4.2条件设备服务器 (1) 处理器（CPU）：Pentium 900M (推荐Pentium 4 1.2G） (2) 内存容量（RAM）：至少256M（推荐 512M）客户端 (1) 处理器（CPU）：Pentium 133M 或更高 (2) 内存

26、容量（RAM）：64M或更高支持软件数据库服务器端(1) 操作系统：Microsoft Windows 2003(2) 数据库管理系统：SQL Server 2005，配置TCP/IP协议Web服务器端(1) 操作系统：Microsoft Windows 2003(2) Internet 信息服务（IIS）6.0管理器(3) Visual Studio.NET 2005，配置TCP/IP协议 客户端(1) 操作系统：Windows 98/2000/2003/XP(2) Web浏览器：Internet Explorer 6.0以上或Netscape 4.0以上，配置TCP/IP协议2.4.3测试

27、资料测试资料主要有软件研发小组的各类文档和图书馆提供的各类资料档案。2.4.4测试培训培训内容受训人员从事培训的工作人员学习还书的操作测试人员、用户、图书馆工作人员系统开发组学习还书管理测试人员、用户、图书馆管理人员系统开发组3测试设计说明3.1借书测试借阅证号或书号为空；借阅证号不存在；书号不存在；该读者有欠费记录；该读者已借书中有逾期的书籍；该读者已借书的数量已达到8本；借阅证号和书号都正确，且该读者有借书的资格3.1.1控制输入：半自动操作顺序：先按上面7种情况的顺序输入相应的借阅证号和书号，再提交。结果记录方法：记录输入信息、提示信息、数据库中每个表的更改信息。3.1.2输入、输出、过

28、程输入数据选择策略命令输出数据借阅证号为空，正确书号测试借阅证号为空的情况借书按钮“借阅证号不能为空”的提示框正确借阅证号，书号为空测试书号为空的情况借书按钮“书号不能为空”的提示框错误的借阅证号，正确书号测试当不存在改借阅证时的情况借书按钮“该读者不存在”的提示框正确的借阅证号，错误的书号测试当书号错误的情况借书按钮“该书不存在”的提示框修改数据库，使得Punish_Info表中有某读者的欠费记录，输入这个读者的借阅证号，输入正确的书号测试读者有欠费记录时的情况借书按钮“该读者已欠费”的提示框修改数据库，使某读者的已借书中有逾期的，输入该读者借阅证号和该逾期书籍号测试读者已借书中有逾期的书籍

29、的情况借书按钮“该读者已欠费”的提示框使某读者已借阅8本书，该读者继续借书测试当某读者已借阅书籍已达到8本书的情况借书按钮“该读者已借书8本”的提示框以上情况都没有且借阅证号和书号都正确测试当读者符合借书条件的情况借书按钮“借书成功”的提示框3.1.3过程登陆系统，查阅图书，输入图书号查看可否借阅 3.2还书测试借阅证号或书号为空；借阅证号不存在；书号不存在；该书逾期；借阅证号和书号都正确3.2.1控制输入：半自动操作顺序：先按上面5种情况的顺序输入相应的借阅证号和书号，再提交。结果记录方法：记录输入信息、提示信息、数据库中每个表的更改信息。3.2.2输入、输出、过程输入数据选择策略命令输出数据借阅证号为空，正确书号测试借阅证号为空的情况还书按钮“借阅证号不能为空”的提示框正确借阅证号，书号为空测试书号为空的情况还书按钮“书号不能为空”的提示框错误的借阅证号，正确书号测试当不存在改借阅证时的情况还书按钮“该读者不存在”的提示框正确的借阅证号，错误的书号测试当书号错误的情况还书按钮“该书不存在”的提