研发文档管理规范.doc

文档管理规范 v1 0密级 秘密 2012 6 12 第 1 页 共 9 页 文档管理规范文档管理规范 版本版本 1 0 修订记录 初稿日期2012 6 15 修正日期 审核日期 批准日期 深圳恒飞盈通科技有限公司 版权所有 侵权必究 文档管理规范 v1 0密级 秘密 2012 6 12 第 2 页 共 9 页 目录目录 1 简介简介 3 1 1目的 3 1 2范围 3 1 3读者 3 2 文档类别文档类别 3 3 文档清单文档清单 3 4 文档标识文档标识 6 4 1带版本文档 6 4 1 1标识号 ID 6 4 1 2版本号 7 4 2无版本文档 7 4 2 1项目文档 7 4 2 2员工周报 8 5 文档格式文档格式 9 6 文档修订文档修订 9 文档管理规范 v1 0密级 秘密 2012 6 12 第 3 页 共 9 页 文档管理文档管理 1 简介简介 1 1 目的目的 编制本文档的目的在于为所有的项目文档的命名 编码以及版本号的确定建立一套统一的规 则和方法 以唯一地确定项目的每一产出物 1 2 范围范围 本文档仅描述项目级文档的管理规则 不包括公司级文档 1 3 读者读者 所有软件工程人员应该阅读本文档 并遵从本文档的规则识别项目中产生的文档 并对其进 行标识以及按照规范的格式撰写文档 2 文档类别文档类别 类别说明代码 管理类各种有关项目策划 度量 跟踪 调整的文档MNG 需求类各种与业务和需求相关的文档 模型REQ 设计类各种设计文档 模型等DSN 实施类与软件开发和集成相关的文档IMP 测试类测试相关文档 数据等TST 发布类发布声明以及各种用户文档REL 参考资料类各种参考资料REF 3 文档清单文档清单 序号文档中文名称文档英文名称文档代码模板评审级别 文档管理规范 v1 0密级 秘密 2012 6 12 第 4 页 共 9 页 管理类 MNG 1立项申请Project Establish RequestPER 组织级 2项目任务书Statement of WorkSOW 组织级 3软件开发计划Software Development PlanSDP 组织级 4 软件开发日程 表 Software Development Schedule SDS 组织级 5软件维护计划Software Maintainance PlanSMP 组织级 6任务单Task FormTASK 7项目跟踪报告Project Tracking ReportPTR 8项目总结报告Project Summary ReportPSR 组织级 需求类 REQ 1 可行性分析报 告 Feasibility Analysis ReportFAR 组织级 2 业务分析规格 说明书 Business Analysis Specification BAS 组织级 3前景与范围Vision and ScopeVNS 组织级 4 软件需求规格 说明书 Software Requirment Specification SRS 组织级 设计类 DSN 1 总体设计说明 书 General Design SpecificationGDS 项目级 2 数据库设计说 明书 Database Design Specification DBDS 项目级 3 用户界面设计 说明书 User Interface Design Specification UIDS 项目级 4 接口设计说明 书 Interface Design Specification IDS 项目级 文档管理规范 v1 0密级 秘密 2012 6 12 第 5 页 共 9 页 5 详细设计说明 书 Detailed Design Specification DDS 项目级 实施类 IMP 1软件配置清单Software Configuration ListSCL 项目级 2软件开发文件Software Development FileSDF 项目级 3系统部署文档 System Deployment Document SDD 项目级 测试类 TST 1单元测试用例Unit Test CaseUTC 2单元测试数据Unit Test DataUTD 3单元测试脚本Unit Test ScriptUTS 4单元测试报告Unit Test ReportUTR 项目级 5集成测试用例Integration Test CaseITC 6集成测试数据Integration Test DataITD 7集成测试脚本Integration Test ScriptITS 8集成测试报告Integration Test ReportITR 项目级 9系统测试用例System Test CaseSTC 10系统测试数据System Test DataSTD 11系统测试脚本System Test ScriptSTS 12系统测试报告System Test ReportSTR 组织级 发布类 REL 1 产品技术白皮 书 Product Technical Whitepaper PTW 组织级 2系统安装手册System Installation ManualSIM 组织级 3用户操作手册User Operation ManualUOM 组织级 4产品维护手册 Product Maintainance Manual PMM 组织级 文档管理规范 v1 0密级 秘密 2012 6 12 第 6 页 共 9 页 5产品培训资料Product Training MaterialsPTM 组织级 6产品发布声明Product Release NotePRN 组织级 其它 1评审报告Review ReportRR 2员工周报Weekly ReportWR 对于以上文档清单中未列出的文档 可参考以下编码规则以确定其代码 参考编码规则 中文名称英文名称代码中文名称英文名称代码 计划PlanPLN样例SampleSMPL 模型ModelMDL文档DocumentDOC 数据DataDATA工具ToolTOOL 脚本ScriptSCRP报告ReportRPT 问题IssueISS参考资料ReferenceREF 4 文档标识文档标识 4 1 带版本文档带版本文档 带版本文档指的是有版本修订 演进过程的文档 项目中绝大部分管理文档和技术文档 第 三节的文档清单中以黑色字体标识 都是带版本的 4 1 1 标识号 标识号 ID 文档的标识号用于命名文档 同时写入文档的配置管理页与页眉中 带版本文档的标识号形式为 项目 产品英文简称 系统 子系统 组件代码 文档类别 文档代码 其中 项目 产品英文简称 项目 产品立项时确定的英文名称缩写 如 OBS 1 0 系统 子系统 组件代码 系统 子系统 组件代码用于标识文档的级别或其所属的子系统 组件 对于系统级文档 该代码为 SYS 对于子系统 组件级文档 该代码为子系统 组件代码 子系统 组件由项目经理在总体设计完成之前确定 并写入总体设计规格说明书 文档管理规范 v1 0密级 秘密 2012 6 12 第 7 页 共 9 页 文档类别 本文档第二节确定的文档类别 文档代码 本文档第三节确定的文档代码 如果同类文档有多个 可以在本节加上两位 数的编码 样例 OBS 1 0 SYS MNG SDS为 OBS 系统 1 0 版的软件开发日程表 OBS 1 0 SYS DSN MOD为系统设计模型 OBS 1 0 JSP DSN DDS为 JSP 组件的详细设计规格说明书 OBS 1 0 JSP TST UTR为 JSP 组件的单元测试报告 OBS 1 0 SYS TST ITD01为集成测试的第一组测试数据 4 1 2 版本号版本号 版本号形式为 x y 其中 y 表示文档修订的次数 x 表示文档发布的次数 文档初始版本号为 0 1 以后每产生一次修订 y 1 第一次发布的正式版版本号为 1 0 以后每产生一次修订 y 1 重新评审和发布 x 1 4 2 无版本文档无版本文档 无版本文档指的是由项目当前状态评估而产生的各种文档 如评审报告 SCM 报告 SQA 报 告等各种报告以及任务单 变更请求表等表单 在第三节的文档清单中以灰色字体标识 4 2 1 项目文档项目文档 项目中无版本文档的标识号形式为 项目 产品英文简称 系统 子系统 组件代码 文档类别 文档代码 日期 编码 其中 项目 产品英文简称 项目 产品立项时确定的英文名称缩写 如 OBS 1 0 系统 子系统 组件代码 系统 子系统 组件代码用于标识文档的级别或其所属的子系统 组件 对于系统级文档 该代码为 SYS 对于子系统 组件级文档 该代码为子系统 组件代码 子系统 组件由项目经理在总体设计完成之前确定 并写入总体设计规格说明书 文档管理规范 v1 0密级 秘密 2012 6 12 第 8 页 共 9 页 文档类别 本文档第二节确定的文档类别 文档代码 本文档第三节确定的文档代码 若有本文档中未识别出来的文档 请及时通 知您的 SQA 工程师以获得帮助 日期 编码 对于各种报告规定为报告的日期 形式为 YYYYMMDD 对于各种表单则 为 3 位数的流水号 样例 OBS 1 0 SYS REQ RR 20011121为 2001 年 11 月 21 日需求评审的报告 OBS 1 0 JSP DSN RR 20011121为 2001 年 11 月 21 日 JSP 组件详细设计评审的报告 OBS 1 0 SYS SCM CR 001为项目的第一个变更请求 4 2 2 员工周报员工周报 员工周报命名方式为 WR NAME 日期 其中 NAME 公司统一的 Email 帐号 日期 项目规定的报告日期 形式为 YYYYMMDD 样例 WR LIJUAN 20011121 5 文档格式文档格式 文档的格式包括 文档封面 页眉和页脚 目录 正文 10 页以上的文档必须有目录 标题与字体格式 配置管理页 所有带版本的文档必须有配置管理页 文档管理规范 v1 0密级 秘密 2012