【软考】系统文档

1. 说明

• 1.信息系统的文档是系统建设过程的“痕迹”，是系统维护人员的指南，是开发人员与用户交流的工具。
• 2.规范的文档意味着系统是按照工程化开发的，意味着信息系统的质量有了形式上的保障。
• 3.文档的欠缺、文档的随意性和文档的不规范，极有可能导致原来的开发人员流动以后,系统不可维护、不可升级，变成了一个没有扩展性、没有生命力的系统。
• 4.信息系统的文档不仅包括应用软件开发过程中产生的文档，还包括硬件采购和网络设计中形成的文档;不仅包括上述有一定格式要求的规范文档，也包括系统建设过程中的各种来往文件、会议纪要、会计单据等资料形成的不规范文档，后者是建设各方谈判甚至索赔的重要依据:不仅包括系统实施记录，也包括程序资料和培训教程等。

2. 用户与系统分析人员

• 1.在系统规划和系统分析阶段通过文档进行沟通。
• 2.这里的文档主要包括可行性研究报告、总体规划报告、系统开发合同和系统方案说明书等。
• 3.用户能依次对系统分析师是否正确理解了系统的需求进行评价，如不正确，可以在已有文档的基础上进行修正。

3. 系统开发人员与项目管理人员

• 1.通过文档在项目期内进行沟通。
• 2.这里的文档主要有系统开发计划(包括工作任务分解表、PERT 图、甘特图和预算分配表等)、系统开发月报以及系统开发总结报告等项目管理文件。
• 3.不同阶段之间的开发人员就可以进行工作的顺利交接，同时还能降低因为人员流动带来的风险，因为接替人员可以根据文档理解前面人员的设计思路或开发思路。

4. 系统测试人员与系统开发人员

• 1.通过文档进行沟通。
• 2.系统测试人员可以根据系统方案说明书、系统开发合同、系统设计说明书和测试计划等文档对系统开发人员所开发的系统进行测试。
• 3.系统测试人员再将评估结果撰写成系统测试报告。

5. 系统开发人员与用户

• 1.在系统运行期间进行沟通。
• 2.用户通过系统开发人员撰写的文档运行系统。
• 3.这里的文档主要是用户手册和操作指南。

6. 系统开发人员与系统维护人员

• 1.通过文档进行沟通。
• 2.这里的文档主要有系统设计说明书和系统开发总结报告。
• 3.有的开发总结报告写得很详细，分为研制报告、技术报告和技术手册3个文档，其中的技术手册记录了系统开发过程中的各种主要技术细节。
• 4.这样，即使系统维护人员不是原来的开发人员，也可以在这些文档的基础上进行系统的维护与升级。

7. 用户与维修人员

• 1.在运行维护期间进行沟通。
• 2.用户在使用信息系统的过程中，将运行过程中的问题进行记载，形成系统运行报告和维护修改建议。
• 3.系统维护人员根据维护修改建议以及系统开发人员留下的技术手册等文档对系统进行维护和升级。

8. 例题

8.1 例题1

• 1.题目

1.在开发信息系统时，用于系统开发人员与项目管理人员沟通的主要文档是(C)。
A.系统开发合同
B.系统设计说明书
C.系统开发计划
D.系统测试报告

• 2.分析

1.系统开发人员与项目管理人员在项目期内进行沟通的文档主要有系统开发计划、
系统开发月报以及系统开发总结报告等项目管理文件。

8.2 例题2

• 1.题目

2.系统测试人员与系统开发人员需要通过文档进行沟通，系统测试人员应根据一系列文档对系统进行测试，
然后将工作结果撰写成(D)，交给系统开发人员。
A.系统开发合同
B.系统设计说明书
C.测试计划
D.系统测试报告

• 2.分析

1.系统测试人员对系统测试后产生系统测试报告。