技术报告编写规范及项目技术报告.doc

技术报告编写规范 文件编号 NW506102 生效日期 2000 3 20 受控编号 密级 秘密 版次 Ver2 1修改状态 总页数 8 正文 4 附录 4 编制 孟莉审核 袁淮批准 孟莉 沈阳东大阿尔派软件股份有限公司 版权所有 翻版必究 文件修改操纵 修改记录编号 修改 状态 修改页码及条款修改人审核人批准人修改日期 目录 1 目的 2 适用范围 3 术语及缩略语 4 编写规范 4 1 排版规范 4 2 模板使用 5 引用文件 6 附录 1 目的 技术报告编写规范要紧描述在软件产品或软件项目开发完成时所需编 写的技术报告应该包含的内容 使得本公司编写的技术报告便于软件 产品或软件项目日后的维护 交接和代码重用 2 适用范围 适用于本公司软件产品或软件项目的技术报告的编写 3 术语及缩略语 本程序采纳 NQ402100 质量手册 中的术语和缩略语及其定义 4 编写规范 4 1排版规范 1 整个规范由 2 节构成 模板单独一节 2 正文样式采纳 规范正文 3 标题编号采纳每节独立编号 4 2模板使用 1 拷贝规范 2 删除第一节 技术报告封面前的所有页 3 在修改完内容后 更新目录域和相关的页数域 5 引用文件 无 6 附录 以下部分为技术报告的模板 密级 机密 文档编号 第 版 分册名称 第 册 共 册 项目名称 项目编号 技术报告 部门名称 沈阳东大阿尔派软件股份有限公司 总页数正文附录生效日期 年 月 日 编制 审核 批准 目录 1 引言 3 1 1 目的 3 1 2 背景 3 1 3 术语 3 1 4 人员 3 1 5 参考资料 3 2 系统概述 3 2 1 适用范围及系统特性简要讲明 3 2 2 子系统及其模块的划分 3 2 3 系统运行环境 3 3 文件一览 4 3 1 系统运行文件一览 4 3 2 源程序文件一览 4 3 3 函数 类 事件一览 可选 4 4 数据库结构 4 5 可重用子系统或模块 4 6 总结与展望 4 1 引言 1 1目的 讲明编写本 技术报告 的目的 1 2背景 讲明理解本报告所需的背景 如与公司其它软件之间的联系等 1 3术语 列出本报告中专门术语的定义和英文缩写词的原词组 1 4人员 给出本软件的开发人员 姓名部门职务或角色 1 5参考资料 列出编写参考的文件 资料 技术标准以及他们的作者 标题 编号 公布日期和出版单位 编号资料名称简介作者日期出版单位 列出编写本报告时需查阅的 Intenet 上杂志 专业著作 技术标准以 及他们的网址 网点简介 2 系统概述 2 1适用范围及系统特性简要讲明 简述本软件系统适用的领域 功能要点 产品化程度 2 2子系统及其模块的划分 给出系统中各个子系统及其模块简要的功能描述 并用图形的方式给 出各个子系统及其模块之间的关系 假如本软件系统是一个更大的系 统的一个组成部分 则还要讲明本软件系统与那个更大的系统中的其 他各组成部分之间的关系 2 3系统运行环境 给出本软件系统运行所需的差不多软 硬件环境 使用本软件系统典型 用户的设备分布图及设备上相应软件配置 软件环境包括 操作系统 数据库 以及其它支撑软件 硬件环境包括 主机类型 网络类型 存储器容量 其它专门设备 如有同等作用的内容或文件 如已编写 的 系统设计报告 则可直接在此引述该文件名及归档的部门即可 3 文件一览 3 1系统运行文件一览 给出本软件系统 或分不给出各子系统 运行时其各种文件系统目录 文件一览表 并讲明其意义 内容等 3 2源程序文件一览 给出本软件系统 或分不给出各子系统 源程序文件及头文件目录 文 件一览表 并简要讲明各源程序文件所包含的内容 与子系统及其模 块的对应关系 3 3函数 类 事件一览 可选 按照源程序文件一览的顺序 给出源程序文件中函数 类 事件的讲 明 具体要求如下 1 函数的功能 必要时简要给出算法 2 函数调用参数及返回值 讲明各参数及返回值的作用 意义及其取 值范围 4 数据库结构 关于 MIS 等使用数据库的项目 必须详细讲明数据库中各数据库表之 间的关系 详细讲明各数据库表中每一个字段的作用 意义及其取值 范围 假如其取值范围是可枚举的 应讲明每一取值的含义 如有同 等作用的内容或文件 如已编写的 系统设计报告 则可直接在此 引述该文件名及归档的部门即可 5 可重用子系统或模块 以列表的方式给出本软件系统中可被其它系统应用的子系统或模块 讲明这些可重用子系统或模块的应用范围 6 总结与展望 讲明本软件系统在开发过程中的经验与教训 尚存的功能 可靠性等 方面的问题 该软件系统以后的进展方向及再开发策略 。