辽 宁 工 业 大 学
实训报告
题目： 超市管理系统软件文档
院（系）: 软件学院 专业班级： 电子商务092班 学 号： 091401050 学生姓名： 洪 竹 指导教师： 张莉莉 教师职称： 助 教 起止时间： 2011.11.28-2011.12.03
实训任务及评语
目 录
第1章 实训目的与要求 ....................................................... 1
1.1 实训目的 ............................................................ 1 1.2 实训的实验环境 ...................................................... 1 1.3 实训的预备知识 ...................................................... 1 1.4 实训要求 ............................................................ 1 第2章 软件文档及其组成 ..................................................... 2
2.1软件文档的作用及分类 ................................................ 2 2.2软件文档所采用的标准 ................................................ 2 2.2 软件文档的主要内容 .................................................. 3 第3章 实 例 ................................................................ 5
3.1 超市管理系统软件需求说明书的编写实例 ................................ 5 第4章 实训日记 ............................................................ 12 第5章 实训总结 ............................................................ 13 参考文献 ................................................................... 14
第1章 实训目的与要求
1.1 实训目的
本实训要求学生通过具体的实例，模仿软件开发过程中软件文档写作的具体方法和步骤，分组完成一套较为简单软件文档，具体要达到以下几点目的。
1、了解软件开发周期各阶段的文档。 2、掌握各文档阐述的内容及作用。
3、了解文档所采用的国际、国家等相关标准。 4、了解各文档所涉及的软件知识。 5、掌握各文档采用的描述工具。 6、具体编写出2个主要的软件文件。
1.2 实训的实验环境
学校图书馆，互联网查询环境，具有软件图表制作软件的计算机。
1.3 实训的预备知识
要求学生修完全部专科所有课程，具有较全面计算机软件知识和一定的文献检索能力及动手实践能力。该实训应安排在毕业设计之前进行。
1.4 实训要求
实训过程中，要严格遵守实训的时间安排，听从指导教师的指导。正确地完成上述内容，记录实习日记，规范完整地撰写出实训报告。
第2章 软件文档及其组成
2.1软件文档的作用及分类
软件文档是一种重要的软件工程技术资料。如系统分析文档、设计文档、版本说明文档等。
软件文档的规范编制，在软件开发工作中占有突出的地位和相当大的工作量。高质量、高效率的编制、分发、管理、维护文档，及时的变更、修正、扩充和使用文档，对于软件产品的设计开发、发行使用、变更维护、转让移植、二次开发等，对于充分发挥软件产品的效益，都有着重要的意义。
软件文档可按照基于软件生存期方法以及根据其产生和使用的范围两大类分类。
1.基于软件生存期方法，可以从形式上将软件文档大致分成两类：软件开发过程中需要填写的各种图表，及应编制的各种技术文件或管理资料。
2.软件文档根据其产生和使用的范围，主要划分为3大类：开发文档、用户文档和管理文档。
其中，开发文档包括：可行性研究报告，项目开发计划，软件需求说明书，数据库设计说明书，概要设计说明书，详细设计说明书。
用户文档包括：用户手册，操作手册，软件需求说明书，数据要求说明书。 管理文档包括：项目开发计划，模块开发卷宗，开发进度月报，测试计划，测试分析报告，项目开发总结报告。
而供开发人员使用的文档为可行性研究报告，项目开发计划，软件需求说明书，数据要求说明书，概要设计说明书，详细设计说明书，数据库设计说明书，测试计划，测试分析报告。
维护人员使用的文档为设计说明书，测试分析报告，模块开发卷宗。 管理人员使用的文档为可行性研究报告，项目开发计划，模块开发卷宗，开发进度月报，项目开发总结报告。
用户使用的文档则为用户手册和操作手册。
2.2软件文档所采用的标准
1.根据软件工程标准制定的机构和标准适用的范围，可分为4个层次： (1)国际标准: ISO 国际标准化组织
(2)国家标准:GB中国ANSI美国BS英国JIS日本 (3)行业标准: IEEE (4)企业(机构)标准: IBM
IBM（International Business Machines Corporation），国际商业机器公司，或万国商业机器公司的简称。
IBM公司同时也是备受世人尊重的公司。受人尊重的原因，其中之一是能够在近百年的历史过程中，多次领导产业革命，尤其是在IT行业中，制定多项标准，并努力帮助客户成功。另外，该公司一直在世界500强中位居前列。更为重要的是，其受人尊重的原因在于，IBM公司近百年的历史当中，一直坚持遵守“沃森哲学”。
在1914年创办IBM公司时，托马斯为公司制定了“行为准则”，这些准则一直牢记在公司每位人员的心中，任何一个行动及政策都直接受到这三条准则的影响，“沃森哲学”对公司的成功所贡献的力量，比技术革新、市场销售技巧，或庞大财力所贡献的力量更大，主要包括：
必须尊重个人；
必须尽可能给予别人最好的服务； 必须追求优异的工作表现。 IBM新的政策的原则如下：
根据标准化机构所制定的标准质量及其流程、会员制度和知识产权政策的开放程度，决定是否参加或退出该标准化机构。
倡导新兴国家和发达国家采用开放的全球标准、并参与这些标准的制定。 推动标准化机构建立规章制度，以保证技术决策、投票和争议解决由独立的参与者公正做出，避免受到不当利益的影响。
与标准化机构和开发者社区合作，确保可以自由地获得和实施开放的软件互操作标准。
协力推动标准化机构创建清晰、简洁和贯彻始终的知识产权政策，使得标准开发者和实施者可以在信息透明的环境下做出技术和商业决策。
IBM倡导标准化社区的成员采用类似的原则，它们比现存法律和政策的要求更加严格。IBM新的标准化政策推崇简化和统一的知识产权操作规程，强调包括开源社区和成长型市场在内的所有利益相关方在参与标准化过程中一律平等。
2.3 软件文档的主要内容
本软件文档是超市管理系统软件文档。超市系统软件文档包括超市系统操作手册、超市系统测试计划、超市系统概要设计说明书、超市系统可行性分析报告、超市系统需求说明书、超市系统详细设计说明书、超市系统项目计划、超市系统项目总结报告、超
市系统用户手册。
首先本超市管理系统分为以下几个功能：系统设置、商品供应商信息管理、员工档案管理、商品信息管理、商品入库管理、销售管理、销售数据查询。
我在超市管理系统软件文档所作的内容为：
可行性分析报告：说明该软件开发项目的实现在技术上、经济上和社会因素上的可行性，评述为了合理地达到开发目标可供选择的各种可能实施方案，说明并论证所选定实施方案的理由。
项目开发计划：为软件项目实施方案制订出具体计划，应该包括各部分工作的负责人员、开发的进度、开发经费的预算、所需的硬件及软件资源等。
软件需求说明书（软件规格说明书）：对所开发软件的功能、性能、用户界面及运行环境等作出详细的说明。它是在用户与开发人员双方对软件需求取得共同理解并达成协议的条件下编写的，也是实施开发工作的基础。该说明书应给出数据逻辑和数据采集的各项要求，为生成和维护系统数据文件做好准备。
测试计划：为做好集成测试和验收测试，需为如何组织测试制订实施计划。计划应包括测试的内容、进度、条件、人员、测试用例的选取原则、测试结果允许的偏差范围等。
数据要求说明书：通过数据录入和处理的准确性和实时性，数据的一致性与完整性，数据的共享与独立性，静态数据，动态输入输出数据等，已达到了解数据库，了解超市管理系统的存储及输出。以提高系统工作效率和管理水平。
第3章 实 例
3.1超市管理系统软件需求说明书的编写实例
8
9
10
11
第4章 实训日记
第一天：我们确立了分工小组，研究了课题，我们确立的题目是超市管理系统。 第二天：我们就开始了我们的工作，由于分工明确，我们小组顺利的完成了资料查询工作，并进一步进行分组分模块的分工。
第三天：我们小组内部又分出一部分去网上查阅资料，另一部分负责对搜集来的资料进行整理和分析，从而确立了超市管理系统的代码。
第四天：我们对现有的程序代码进行了测试与修改，并记录了几组测试信息。
第五天：我们对现有的代码进行分工，分模块进行文档的编写，通过前几天对系统第六天，我们进行了文档的收官阶段，小组集体进行文档的查缺补漏，完善文档信息，并对一周以来的工作进行总结分析，吸取经验教训为以后的进一步学习奠定基础。并将编写完的文档上交。
12 的测试数据我们进行进一步的分析整理逐步完善了系统的稳定性以及文档的及时记录。
第5章 实训总结
在一周的时间内，我们小组分工合作，顺利的完成了本次课程设计。
本次课程设计我们选的题目是超市管理系统，对于软件文档的写作我不是很了解，但是在小组成员的帮助和我们共同的努力之下，我们完成了本次软件文档的写作，我们之所以选择超市管理系统是因为超市在我们的生活之中无处不在，对于超市的运行流程我们也是略有了解，所以对文档的写作会有一定的帮助，同样之下也降低了本次文档写作的难度，在小组的合作分工下我们完成了对超市的整体运营的了解，完成了对文档写作的初识，完成了对超市管理系统的编写及测试，同样也完成了本次课程设计，在此其中我们经历了很多困难，比如说代码运行错误，文档内容的陌生，以及分工不太谨慎导致工作日程的的滞后等等，但是在大家的共同研讨和共同努力之下我们一一克服了困难，我们在困难中进步，学到了知识也积累了经验。
在这次的课设设计中我学到了很多，不但是对软件文档的写作理解的更近一步加深，也增进了我们之间友谊。
13
参考文献
[1] 霍林. 《c语言软件详解》.北京： 北京大学出版社， 2008.6
[2] 王陵. 《软件知识概括》.北京：清华大学出版社， 2009.4
[3] 袁建. 《计算机网络工程》.上海：化学工业出版社 2011.5
[4] 郑涛. 《SQL课程设计》.宁波：高等教育出版社 2009.7
[5] 刘宁. 《SQL软件》. 北京：清华大学出版社 2009.9
[6] 康玲.
[7] 尨博.
[8] 孙菱.
[9] 赵成.
[10] 吴宁.
[11] 张彀.
[12] 康雪.
[13] 襄澄.
[14] 程明.
[15] 兰梅.
.武汉：机械工业出版社 2009.10 . 湖北：电子工业出版社 2010.8 C语言工作原理》.天津： 中国青年出版社 2005.5 .四川： 电子工业出版社 2008.3 .浙江：电子工业出版社 2006.6 . 北京：北京航空航天大学出版社 2008.1 .北京： 清华大学出版社 2007.11 . 北京：人民邮电出版社 2005.6 .重庆： 重庆大学出版社 2008.3 .辽宁：辽宁交通大学出版社 2011.8 14 《软件基础要点》《计算机软件》《《程序设计介绍》《实用软件工程技术》《软件工程技术》《软件文档写作》《软件测试详解》《计算机基础理论》《计算机软件技术》
辽 宁 工 业 大 学
实训报告
题目： 超市管理系统软件文档
院（系）: 软件学院 专业班级： 电子商务092班 学 号： 091401050 学生姓名： 洪 竹 指导教师： 张莉莉 教师职称： 助 教 起止时间： 2011.11.28-2011.12.03
实训任务及评语
目 录
第1章 实训目的与要求 ....................................................... 1
1.1 实训目的 ............................................................ 1 1.2 实训的实验环境 ...................................................... 1 1.3 实训的预备知识 ...................................................... 1 1.4 实训要求 ............................................................ 1 第2章 软件文档及其组成 ..................................................... 2
2.1软件文档的作用及分类 ................................................ 2 2.2软件文档所采用的标准 ................................................ 2 2.2 软件文档的主要内容 .................................................. 3 第3章 实 例 ................................................................ 5
3.1 超市管理系统软件需求说明书的编写实例 ................................ 5 第4章 实训日记 ............................................................ 12 第5章 实训总结 ............................................................ 13 参考文献 ................................................................... 14
第1章 实训目的与要求
1.1 实训目的
本实训要求学生通过具体的实例，模仿软件开发过程中软件文档写作的具体方法和步骤，分组完成一套较为简单软件文档，具体要达到以下几点目的。
1、了解软件开发周期各阶段的文档。 2、掌握各文档阐述的内容及作用。
3、了解文档所采用的国际、国家等相关标准。 4、了解各文档所涉及的软件知识。 5、掌握各文档采用的描述工具。 6、具体编写出2个主要的软件文件。
1.2 实训的实验环境
学校图书馆，互联网查询环境，具有软件图表制作软件的计算机。
1.3 实训的预备知识
要求学生修完全部专科所有课程，具有较全面计算机软件知识和一定的文献检索能力及动手实践能力。该实训应安排在毕业设计之前进行。
1.4 实训要求
实训过程中，要严格遵守实训的时间安排，听从指导教师的指导。正确地完成上述内容，记录实习日记，规范完整地撰写出实训报告。
第2章 软件文档及其组成
2.1软件文档的作用及分类
软件文档是一种重要的软件工程技术资料。如系统分析文档、设计文档、版本说明文档等。
软件文档的规范编制，在软件开发工作中占有突出的地位和相当大的工作量。高质量、高效率的编制、分发、管理、维护文档，及时的变更、修正、扩充和使用文档，对于软件产品的设计开发、发行使用、变更维护、转让移植、二次开发等，对于充分发挥软件产品的效益，都有着重要的意义。
软件文档可按照基于软件生存期方法以及根据其产生和使用的范围两大类分类。
1.基于软件生存期方法，可以从形式上将软件文档大致分成两类：软件开发过程中需要填写的各种图表，及应编制的各种技术文件或管理资料。
2.软件文档根据其产生和使用的范围，主要划分为3大类：开发文档、用户文档和管理文档。
其中，开发文档包括：可行性研究报告，项目开发计划，软件需求说明书，数据库设计说明书，概要设计说明书，详细设计说明书。
用户文档包括：用户手册，操作手册，软件需求说明书，数据要求说明书。 管理文档包括：项目开发计划，模块开发卷宗，开发进度月报，测试计划，测试分析报告，项目开发总结报告。
而供开发人员使用的文档为可行性研究报告，项目开发计划，软件需求说明书，数据要求说明书，概要设计说明书，详细设计说明书，数据库设计说明书，测试计划，测试分析报告。
维护人员使用的文档为设计说明书，测试分析报告，模块开发卷宗。 管理人员使用的文档为可行性研究报告，项目开发计划，模块开发卷宗，开发进度月报，项目开发总结报告。
用户使用的文档则为用户手册和操作手册。
2.2软件文档所采用的标准
1.根据软件工程标准制定的机构和标准适用的范围，可分为4个层次： (1)国际标准: ISO 国际标准化组织
(2)国家标准:GB中国ANSI美国BS英国JIS日本 (3)行业标准: IEEE (4)企业(机构)标准: IBM
IBM（International Business Machines Corporation），国际商业机器公司，或万国商业机器公司的简称。
IBM公司同时也是备受世人尊重的公司。受人尊重的原因，其中之一是能够在近百年的历史过程中，多次领导产业革命，尤其是在IT行业中，制定多项标准，并努力帮助客户成功。另外，该公司一直在世界500强中位居前列。更为重要的是，其受人尊重的原因在于，IBM公司近百年的历史当中，一直坚持遵守“沃森哲学”。
在1914年创办IBM公司时，托马斯为公司制定了“行为准则”，这些准则一直牢记在公司每位人员的心中，任何一个行动及政策都直接受到这三条准则的影响，“沃森哲学”对公司的成功所贡献的力量，比技术革新、市场销售技巧，或庞大财力所贡献的力量更大，主要包括：
必须尊重个人；
必须尽可能给予别人最好的服务； 必须追求优异的工作表现。 IBM新的政策的原则如下：
根据标准化机构所制定的标准质量及其流程、会员制度和知识产权政策的开放程度，决定是否参加或退出该标准化机构。
倡导新兴国家和发达国家采用开放的全球标准、并参与这些标准的制定。 推动标准化机构建立规章制度，以保证技术决策、投票和争议解决由独立的参与者公正做出，避免受到不当利益的影响。
与标准化机构和开发者社区合作，确保可以自由地获得和实施开放的软件互操作标准。
协力推动标准化机构创建清晰、简洁和贯彻始终的知识产权政策，使得标准开发者和实施者可以在信息透明的环境下做出技术和商业决策。
IBM倡导标准化社区的成员采用类似的原则，它们比现存法律和政策的要求更加严格。IBM新的标准化政策推崇简化和统一的知识产权操作规程，强调包括开源社区和成长型市场在内的所有利益相关方在参与标准化过程中一律平等。
2.3 软件文档的主要内容
本软件文档是超市管理系统软件文档。超市系统软件文档包括超市系统操作手册、超市系统测试计划、超市系统概要设计说明书、超市系统可行性分析报告、超市系统需求说明书、超市系统详细设计说明书、超市系统项目计划、超市系统项目总结报告、超
市系统用户手册。
首先本超市管理系统分为以下几个功能：系统设置、商品供应商信息管理、员工档案管理、商品信息管理、商品入库管理、销售管理、销售数据查询。
我在超市管理系统软件文档所作的内容为：
可行性分析报告：说明该软件开发项目的实现在技术上、经济上和社会因素上的可行性，评述为了合理地达到开发目标可供选择的各种可能实施方案，说明并论证所选定实施方案的理由。
项目开发计划：为软件项目实施方案制订出具体计划，应该包括各部分工作的负责人员、开发的进度、开发经费的预算、所需的硬件及软件资源等。
软件需求说明书（软件规格说明书）：对所开发软件的功能、性能、用户界面及运行环境等作出详细的说明。它是在用户与开发人员双方对软件需求取得共同理解并达成协议的条件下编写的，也是实施开发工作的基础。该说明书应给出数据逻辑和数据采集的各项要求，为生成和维护系统数据文件做好准备。
测试计划：为做好集成测试和验收测试，需为如何组织测试制订实施计划。计划应包括测试的内容、进度、条件、人员、测试用例的选取原则、测试结果允许的偏差范围等。
数据要求说明书：通过数据录入和处理的准确性和实时性，数据的一致性与完整性，数据的共享与独立性，静态数据，动态输入输出数据等，已达到了解数据库，了解超市管理系统的存储及输出。以提高系统工作效率和管理水平。
第3章 实 例
3.1超市管理系统软件需求说明书的编写实例
8
9
10
11
第4章 实训日记
第一天：我们确立了分工小组，研究了课题，我们确立的题目是超市管理系统。 第二天：我们就开始了我们的工作，由于分工明确，我们小组顺利的完成了资料查询工作，并进一步进行分组分模块的分工。
第三天：我们小组内部又分出一部分去网上查阅资料，另一部分负责对搜集来的资料进行整理和分析，从而确立了超市管理系统的代码。
第四天：我们对现有的程序代码进行了测试与修改，并记录了几组测试信息。
第五天：我们对现有的代码进行分工，分模块进行文档的编写，通过前几天对系统第六天，我们进行了文档的收官阶段，小组集体进行文档的查缺补漏，完善文档信息，并对一周以来的工作进行总结分析，吸取经验教训为以后的进一步学习奠定基础。并将编写完的文档上交。
12 的测试数据我们进行进一步的分析整理逐步完善了系统的稳定性以及文档的及时记录。
第5章 实训总结
在一周的时间内，我们小组分工合作，顺利的完成了本次课程设计。
本次课程设计我们选的题目是超市管理系统，对于软件文档的写作我不是很了解，但是在小组成员的帮助和我们共同的努力之下，我们完成了本次软件文档的写作，我们之所以选择超市管理系统是因为超市在我们的生活之中无处不在，对于超市的运行流程我们也是略有了解，所以对文档的写作会有一定的帮助，同样之下也降低了本次文档写作的难度，在小组的合作分工下我们完成了对超市的整体运营的了解，完成了对文档写作的初识，完成了对超市管理系统的编写及测试，同样也完成了本次课程设计，在此其中我们经历了很多困难，比如说代码运行错误，文档内容的陌生，以及分工不太谨慎导致工作日程的的滞后等等，但是在大家的共同研讨和共同努力之下我们一一克服了困难，我们在困难中进步，学到了知识也积累了经验。
在这次的课设设计中我学到了很多，不但是对软件文档的写作理解的更近一步加深，也增进了我们之间友谊。
13
参考文献
[1] 霍林. 《c语言软件详解》.北京： 北京大学出版社， 2008.6
[2] 王陵. 《软件知识概括》.北京：清华大学出版社， 2009.4
[3] 袁建. 《计算机网络工程》.上海：化学工业出版社 2011.5
[4] 郑涛. 《SQL课程设计》.宁波：高等教育出版社 2009.7
[5] 刘宁. 《SQL软件》. 北京：清华大学出版社 2009.9
[6] 康玲.
[7] 尨博.
[8] 孙菱.
[9] 赵成.
[10] 吴宁.
[11] 张彀.
[12] 康雪.
[13] 襄澄.
[14] 程明.
[15] 兰梅.
.武汉：机械工业出版社 2009.10 . 湖北：电子工业出版社 2010.8 C语言工作原理》.天津： 中国青年出版社 2005.5 .四川： 电子工业出版社 2008.3 .浙江：电子工业出版社 2006.6 . 北京：北京航空航天大学出版社 2008.1 .北京： 清华大学出版社 2007.11 . 北京：人民邮电出版社 2005.6 .重庆： 重庆大学出版社 2008.3 .辽宁：辽宁交通大学出版社 2011.8 14 《软件基础要点》《计算机软件》《《程序设计介绍》《实用软件工程技术》《软件工程技术》《软件文档写作》《软件测试详解》《计算机基础理论》《计算机软件技术》