模版集萃
综述
在程序员的日常工作中,除了编写代码之外,还免不了需要编写各种技术文档。一个编
写良好的技术文档在项目中能够很好地建立沟通与协作,起到很积极的作用。因此,编写技
术文档也就成为了程序员技能提升的很重要的一面。
为此,我们特意收集了一些在项目开发过程中经常用到的文档模板,这些模板包括格式
和简单的写作说明,相信能够帮助大家编写出更加高效、实用的技术文档。在收集过程中,
我们十分注重其实用性,以确保每个模板的价值,而且对于一些重要的文档提供了多个模板。
为了方便大家查找,我们将收录的 57 模板分为以下几类:
项目及开发管理类:包括立项前的分析,立项后的计划、以及进度跟踪、风险控制方面
的文档模板,共计 16 个;
需求分析类:明确清晰的需求,是项目成功的基础,在此收集了在需求分析过程中所将
使用到的文档模板,共计 14 个;
系统分析与设计类:包括体系结构设计、高层设计、详细设计、数据库设计等 6 个相关
文档模板;
软件质量保证类:软件测试是质量保证的关键活动,在此收集了软件测试相关的 11 个
文档模板;
其它类:除此之外,还收集了关于用户手册、软件维护等方面的 10 个文档模板,其中
还有一个软件过程规范的示例。
另外,值得说明的是,文档模板只是为文档的编写提供一个基础,在实际的编写过程中,
你可以根据自己的需要进行必要的剪裁和增补。
一、项目及开发管理类
1.1 可行性研究报告(ISO 标准)
编者说明:
在立项时,应该对项目进行综合分析,探讨项目的经济、社会、技术可行性,从而为决
策提供基础。该模板为 ISO 标准文档模板,其不仅适用于软件项目,对于其它的系统项目
也适用。
1. 引言
1.1 编写目的
[编写本可行性研究报告的目的,指出预期的读者。]
1.2 背景
a.[所建议开发的软件系统的名称;]
b.[本项目的任务提出者、开发者、用户及实现该软件的计算站或计算机网络;]
c.[该软件系统同其他系统或其他机构的基本的相互来往关系。]
1.3 定义
[列出本文件中用到的专门术语的定义和外文首字母组词的原词组。]
1.4 参考资料
[列出用得着的参考资料。]
2. 可行性研究的前提
[说明对所建议开发的软件的项目进行可行性研究的前提。]
2.1 要求
[说明对所建议开发的软件的基本要求。]
2.2 目标
[说明所建议系统的主要开发目标。]
2.3 条件、假定和限制
[说明对这项开发中给出的条件、假定和所受到期的限制。]
2.4 进行可行性研究的方法
[说明这项可行性研究将是如何进行的,所建议的系统将是如何评价的,摘要说明
所使用的基本方法和策略。]
2.5 评价尺度
[说明对系统进行评价时所使用的主要尺度。]
3. 对现有系统的分析
[这里的现有系统是指当前实际使用的系统,这个系统可能是计算机系统,也可能
是一个机械系统甚至是一个人工系统。]
[分析现有系统的目的是为了进一步阐明建议中的开发新系统或修改现有系统的必
要性。]
3.1 处理流程和数据流程
[说明现有系统的基本的处理流程和数据流程。此流程可用图表即流程图的形式表
示,并加以叙述。]
3.2 工作负荷
[列出现有系统所承担的工作及工作量。]
3.3 费用开支
[列出由于运行现有系统所引起的费用开支。]
3.4 人员
[列出为了现有系统的运行和维护所需要的人员的专业技术类别和数量。]
3.5 设备
[列出现有系统所使用的各种设备。]
3.6 局限性
[列出本系统的主要局限性。]
4. 所建议的系统
4.1 对所建议系统的说明
[概括地说明所建议系统,并说明在第 2 条中列出的那些要求将如何得到满足,说
明所使用的基本方法及理论根据。]
4.2 处理流程和数据流程。
[给出所建议系统的处理流程式和数据流程。]
4.3 改进之处
[按 2.2 条中列出的目标,逐项说明所建议系统相对于现存系统具有的改进。]
4.4 影响
[说明新提出的设备要求及对现存系统中尚可使用的设备须作出的修改。]
4.4.1.对设备的影响
[说明新提出的设备要求及对现存系统中尚可使用的设备须作出的修改]
4.4.2.对软件的影响
[说明为了使现存的应用软件和支持软件能够同所建议系统相适应,而需要对这些
软件所进行的修改和补充。]
4.4.3.对用户单位机构的影响
[说明为了建立和运行所建议系统,对用户单位机构、人员的数量和技术水平等方
面的全部要求。]
4.4.4.对系统运行过程的影响
[说明所建议系统对运行过程的影响。]
4.4.5.对开发的影响
[说明对开发的影响。]
4.4.6.对地点和设施的影响
[说明对建筑物改造的要求及对环境设施的要求。]
4.4.7.对经费开支的影响
[扼要说明为了所建议系统的开发,统计和维持运行而需要的各项经费开支。]
4.5 技术条件方面的可能性
[本节应说明技术条件方面的可能性]
5. 可选择的其他系统方案
[扼要说明曾考虑过的每一种可选择的系统方案,包括需开发的和可从国内国外直接购买
的,如果没有供选择的系统方案可考虑,则说明这一点。]
5.1 可选择的系统方案 1
[说明可选择的系统方案 1,并说明它末被选中的理由。]
5.2 可选择的系统方案 2
[按类似 5。1 条的方式说明第 2 个乃至第 n 个可选择的系统方案。]
[……]
6. 投资及效益分析
6.1 支出
[对于所选择的方案,说明所需的费用,如果已有一个现存系统,则包括该系统继
续运行期间所需的费用。]
6.1.1 基本建设投资
[包括采购、开发和安装所需的费用。]
6.1.2 其他一次性支出
6.1.3 非一次性支出
[列出在该系统生命期内按月或按季或按年支出的用于运行和维护的费用。]
6.2 收益
[对于所选择的方案,说明能够带来的收益,这里所说的收益,表现为开支费用的
减少或避免、差错的减少、灵活性的增加、动作速度的提高和管理计划方面的改进等,包括:
6.2.1 一次性收益]
[说明能够用人民币数目表示的一次性收益,可按数据处理、用户、管理和支持等
项分类叙述。]
6.2.2 非一次性收益
[说明在整个系统生命期内由于运行所建议系统而导致的按月的、按年的能用人民
币数目表示的收益,包括开支的减少和避免。]
6.2.3 不可定量的收益
[逐项列出无法直用人民币表示的收益。]
6.3 收益/投资比
[求出整个系统生命期的收益/投资比值。]
6.4 投资回收周期
[求出收益的累计数开始超过支出的累计数的时间。]
6.5 敏感性分析
[是指一些关键性因素与这些不同类型之间的合理搭配、处理速度要求、设备和软
件的配置等变化时,对开支和收益的影响最灵敏的范围的估计。]
7. 社会因素方面的可能性
7.1.[法律方面的可行性]
7.2.[使用方面的可行性]
8. 结论
[在进行可行性研究报告的编制时,必须有一个研究的结论]
1.2 软件项目商业性分析
编者说明:
随着市场经济的不断发展,一个项目的商业价值、市场价值往往是衡量项目价值的最大
依据。该文档模板十分适用于产品型项目,当你提出一个新的产品开发方向时,一份商业性
分析是说服管理层的一个很好工具。
当然,如果是一些内部项目,也是可以借鉴该文档模板来论证该项目的商业价值。
1. 文档概述
[该部分主要描述该文档的目的、范围、术语以及参考资料等方面的内容。]
1.1 目的
[说明该文档的作用。]
1.2 范围
[简要说明该与文档相关的其它事物与资料。]
1.3 术语
[列出所有将出现于本文档的新术语、缩略语等。]
1.4 参考资料
[在此应列出项目计划中引用的文档列表,对于引用的每个文档都应该列出其标题、文
档编号、日期,并且指出这些文档的来源,以方便该计划的阅读者查找。]
1.5 概述
[本小节说明该文档所包括的内容,以及它的组织方式。]
2.系统说明
[在此简要地说明将要开发的系统,包括其名称、系统所解决的问题以及它的开发价值
等,从而使得读者能够有一个直接的了解。并且在这处还应列出与在本文档中出现的缩略词
的解释,以便读者更好地阅读。]
3.业务环境
[这一小节主要说明要开发的系统所处于的业务环境。它包括系统所面向的领域、用户。
也可以在此指出它是产品型项目,还是用户定制型项目,同时如果该项目与原有的项目有紧
密的联系,在此也应该把这些联系列出来。]
4.产品目标
[这一小节则用于深入说明为什么要开发该系统,它有什么价值。最好还应对进度计划、
进度风险做一些评估。一个明确确定、表述清晰、可以度量的目标将为今后系统的开发工作
打下坚实的基础。]
5. 财务预测
[如果是产品型项目,那么其输出就是一个商业软件产品。对于这样的项目,在此应该
包括对该项目的财务预测,最主要应该得出投资回报(ROI)指标。在做 ROI 分析时,应该
针对不同的完成时间做出不同的预测,以让系统开发者对于进度延迟对投资回报的损伤有一
个直观的了解。]
[在财务预测中,有一个基点就是对项目工作量、资源使用的估算,在这里还应给出估
算的基础技术,当然这里的估算会随着项目的进展而逐步精化,应该这里还是应该估算出一
个合理的范围。]
6. 约束
[任何事有利就有弊,在本小节则主要列举执行该项目时会遇到的一个诸如外部接口、
标准、认证、特殊的技术等约束,这些约速将会对项目带来很大的执行风险,可能对项目的
成本也带来巨大的影响。]
1.3 软件开发项目立项表
编者说明:
在许多开发组织中,开发立项请求通常来自市场部门,该表格的设计就是为了更好地理
顺两个部门之间的沟通与协调,也使得开发立项流程化,你可以根据自己公司的实际情况,
对该表格的格式做一些修改。
项目名称(暂定):
项目编号(开发部填写):
项目申请人:
项目优先级:
问题/机会:
申请日期:
最迟完成时间:
项目目标及成功标准:
目标描述:
假设、风险及障碍:
客户名单:
项目提出人:
项目决策人:
项目相关人员:
审批人意见:
签名:
日期: