项目文档管理与配置管理

下图梳理了项目文档管理与配置管理，知识点有软件文档、文档的质量等级、配置管理的活动、配置项、配置库等方面。

项目文档管理与配置管理知识点

• 软件文档
  • 开发文档
    • 描述开发过程本身。
      • 可行性研究报告
      • 需求规格说明书
      • 功能规格说明书
      • 设计规格说明书
      • 开发计划
      • 软件集成和测试计划
      • 质量保证计划
      • 安全和测试信息
  • 产品文档
    • 描述开发过程的产物
      • 培训手册
      • 参考手册和用户指南
      • 软件支持手册
      • 产品手册
      • 信息广告等
  • 管理文档
    • 记录项目管理的信息
      • 每个阶段的进度和进度变更的记录
      • 软件变更情况的记录
      • 开发团队的职责定义
      • 项目计划、项目阶段报告
      • 配置管理计划等
• 文档的质量等级
  • 1、最低限度文档（1级文档）
    • （1） 开发者自己用的文档
  • 2、内部文档（2级文档）
    • 专用程序
  • 3、工作文档（3级文档）
    • 可被其他单位使用的文档
  • 4、正式文档（4级文档）
    • 普遍使用的软件产品
• 配置管理的活动
  • 1、制定配置管理计划
  • 2、配置标识
    • 1. 识别需要受控的软件配置项
    • 2. 给每个产品和它的组件以及相关的文档分配唯一的标识
    • 3. 定义每个配置项的重要特征及识别所有者
    • 4. 识别组件、数据及产品获取点的准则
    • 5. 建立和控制基线
    • 6. 维护文档和组件的修订与产品之间的关系
  • 3、配置控制
    • 1. 应标识和记录变更请求
    • 2. 分析和评价变更
    • 3. 批准或者否决变更请求
    • 4. 实现、验证和发布已经修改的软件项
    • 5. 在每次修改时应保存审核跟踪、并可以追踪修改的原因和修改的授权
    • 6. 对处理安全性和安全保密性功能的受控软件项的所有访问均应进行控制和审核
  • 4、配置状态报告
    • 1. 每个受控项的表示和状态
    • 2. 每个变更申请的状态和已批准的修改的实施状态
    • 3. 每个基线的当前和过去版本的状态以及各个版本的比较
    • 4. 其他配置管理活动的记录
  • 5、配置审计
    • 验证配置项对配置标识的一致性，确保配置管理的有效性，不允许出现混乱现象，如
      • （1） 防止向用户交付不合格的产品，如交付不正确版本的用户手册
      • （2） 发现不完善的实现，如开发出不符合初始规格说明或未按变更请求实施变更
      • （3） 找出各配置项间不匹配或不相容的现象
      • （4） 确认配置项已在所要求的质量控制审查之后作为基线入库保存
      • （5） 确认记录和文档保持可追溯性
  • 6、发布管理和交付
• 配置项
  • 为了在不严重阻碍合理变更的情况下控制变更，引入基线的概念
    • 对于每一个基线，要定义以下内容
      • 建立基线的事件
      • 受控的配置项
      • 建立和变更基线的程序
      • 批准变更基线所需的权限
  • 基线配置项
    • 包括所有设计文档和源程序等
      • 功能 基线
        • 最初通过的功能配置
      • 分配基线
        • 最初通过的分配配置
      • 产品基线
        • 最初通过或者有条件通过的产品配置
    • 向软件开发人员开放读取权限
  • 非基线配置项
    • 包括项目的各类计划和报告等
    • 向PM,CCB及相关人员开放读取权限
  • 典型的配置项
    • 项目计划书
    • 需求文档
    • 设计文档
    • 源代码
    • 可执行代码
    • 测试用例
    • 运行软件所需的各种数据
  • 配置项三种状态
    • 草稿
      • 版本号：0.YZ
    • 正式
      • 版本号：X.Y
    • 修改
      • 版本号：X.YZ
  • 版本控制步骤
    • 创建配置项
    • 修改处于“草稿”状态的配置项
    • 技术评审或领导审批
    • 正式发布
    • 变更
  • 主要属性
    • 名称、标识符、文件状态、版本、作者、日期等
• 配置库
  • 存放配置项并记录与配置项相关的所有信息
    • 1. 动态库（开发库、程序员库、工作库、动态系统、开发系统、工作空间）
      • 1.1. 用于保存开发人员当前正在开发配置实体
      • 1.2. 动态库的配置项被至于版本管理之下
      • 1.3. 是软件工程师的工作区，由开发者控制
      • 1.4. 动态库信息变动频繁除非必要无需对其进行配置控制
      • 由开发者自行支配使用，无需走变更流程。开发的实体在这边编辑。
    • 2. 受控库（主库、系统库、主系统、受控系统）
      • 2.1. 适用于管理当前基线和控制对基线的变更
      • 2.2. 软件工程师和其他被授权人员可以自由复制受控库中的单元和组件
      • 2.3. 主库中的配置项被置于完全的配置管理之下
        • 信息系统开发的某个阶段工作结束时，将当前的工作产品存入。
    • 3. 静态库（软件仓库，软件产品库，产品库）
      • 3.1. 用于存档各种广泛使用的已发布的基线
      • 3.2. 被置于完全的配置管理之下
        • 在开发的信息系统产品完成系统测试后，作为最终产品存入产品库中，等待交付用户或者现场安装。