浅谈软件开发中所用到的技术文档.docVIP

软件开发中所用到的技术文档 1.《可行性研究报告》 这是客户在进行项目调研阶段所编写的,具有两重意义,其一,指明项目的必要性和紧迫性,并从业务角度阐述大概的功能需求,注意,只是大概,可能与最后的结果有很大出入;其二,最重要的一点就是为了要钱,向财政部要钱,将最终实现的功能写得天花乱坠,包括决策支持、全文检索、商业智能、远程报表等,但最后开发的可能仅仅是融合简单业务流程的信息输入和输出而已,但这已无关紧要,最重要的是我要到了钱。但是严格来说,这不是项目组所需的文档,于软件开发也意义不大。 2.《建设方案》 或者是《实施方案》,当客户从财政部申请到资金后,就要着手进行详细的调研和分析了,这里有两种情况,其一,客户自己从各个产品厂家进行相关的调研,进行汇总后,编写方案,这样,聪明、细心的软件公司就会从方案的技术环节,挖掘出客户所选择的产品,最后和这个产品公司合作来中标;其二,让和其关系很好的一家或两家软件公司(不会超过三家)编写,客户进行审核,客户最后选择了谁的方案那么最后这个项目就是这家公司的,这样很多情况并不是公开招标。 3.《招标书》 将《建设方案》或《实施方案》进行摘取,并附带上技术问题以及招标时的细节、注意事项,构成《招标书》,这个文件也是由客户写得,软件公司在投标前需要购买《招标书》。 4.《投标书》 与《招标书》所呼应,对技术问题进行相应的技术应答,包括技术标和商务标两部分。 上面几份文档,是项目前期准备时需要的,是侧重于售前方面的;而下面的文档是软件开发过程中必不可少的,我们按开发工作的时间顺序一一介绍。 5.《需求分析说明书》 对于软件开发来说,《需求分析说明书》就好像是盖楼时所用的图纸,是最重要的文档,由项目经理对客户相关部门进行业务调研后编写,语言侧重于从业务的角度描述功能需求。内容涉及三大部分,其一,编写目的、背景、目标任务等公共性语言;其二,功能性需求,将业务梳理成几大功能模块,一级功能下细分二级功能,依次类推,将最终细化的功能按描述、输入、处理和输出进行详细描述;其三,非功能性需求,包括性能、处理能力、进度、界面设计和运行环境的规定。 6.《数据库设计说明书》 我是做数据库出身,因此这部分的工作也是由我这个项目经理来做,根据《需求分析说明书》在Erwin建模工具中设计好逻辑模型和物理模型,然后将其整理到此文档中,文档还包含数据库所有的表结构和相关的字段说明。 7.《概要设计说明书》 说实话,在我做过的项目中,没有编写过此文档,因为我觉得《需求分析说明书》和《详细设计说明书》就足矣了。甚至如果项目简单或时间紧急,《详细设计说明书》都会省略:)。 8.《详细设计说明书》 主要包含两部分内容,其一,体系结构的设计,也就是项目所采用的几层架构,以及层与层之间的通信机制,还有就是基础框架所采用的技术;其二,是本文档的核心部分,包括每个细分模块的详细设计说明,包括程序描述、功能、性能、输入项、输出项、算法、流程逻辑、接口、分配、注释设计、限制条件、计划和尚未解决的问题等内容。本说明书对项目所采用的技术和接口都做了详细的规定,是指导程序员开发的直接工具。但需要说明的是,很多项目由于时间原因,都忽略了此说明书的编写,包括本人目前在做的项目也是如此,因此本文档并不是必须的。但如果作为给客户的交付物,需要在项目完成后补全。 9.《计划进度》 这个不用多说,由项目经理编写,实现对项目进度的严格把控,是项目必须的文档,可用project编写。 10.《测试用例》 测试用例(Test Case)目前没有经典的定义。比较通常的说法是:指对一项特定的软件产品进行测试任务的描述,体现测试方案、方法、技术和策略。内容包括测试目标、测试环境、输入数据、测试步骤、预期结果、测试脚本等,并形成文档。它是将软件测试的行为活动做一个科学化的组织归纳。目的是能够将软件测试的行为转化成可管理的模式;同时测试用例也是将测试具体量化的方法之一。由此可见,《测试用例》非常重要,是对项目或产品质量的严格保证,但由于测试人员和项目组的规范性、时间进度等限制,本文档在本地区的实际项目中也很少应用,至少我认识的很多测试人员中,只有极少数的项目中会编写此文档。 11.《测试结果》 在项目开发阶段使用,也就是交付客户之前。文档为Excel格式,并提供关键字段的数据筛选,内容包括描述、缺陷类型(Bug、需求)、开发人员、状态、关闭时间、所属模块、提交人、解决人、备注等。其中状态包含提交、解决和确认解决,测试人员将问题提交(红色),当程序员解决后就置为解决(黄色),测试人员再次确认无误后,就 修改状态为确认解决(绿色),并且添写关闭时间。 12.《需求变更文档》 产品交付客户之后使用。任何一个好软件,不是在第一个版本就把