📚 课程目录第2章前置条件与角色定义

2. 前置条件与角色定义

2.1 适用场景

本章前置条件定义适用于以下研发管理场景：

新建研发团队或重组团队时，首次建立评审机制所需的角色与权限基线
已有评审流程需要升级或对齐到统一角色-权限-工具映射关系
跨职能团队（产品、开发、测试、架构）协作评审时，需明确各参与方的责权边界
引入新评审工具或平台时，需批量配置角色与权限模板

    关键提示： 前置条件的完整度直接影响后续评审效率。角色定义模糊或权限缺失是评审流于形式的首要原因，建议在本阶段完成角色-权限-工具三者的显式映射，并形成团队共识。

2.2 前置条件

在执行角色定义、权限分配与工具准备之前，团队必须完成以下基础工作：

流程基线已发布：已完成第1章《研发评审总流程框架设计》，评审阶段、准入准出标准已获管理层批准。
组织架构已确认：参与评审的职能部门（产品、开发、测试、架构、项目管理）及对应人员名单已确定。
工具选型已决策：评审管理平台（如GitLab/GitHub/Jira）、代码仓库、文档系统、通讯工具已完成选型并部署。
管理授权已下达：CTO或技术委员会已授权项目经理牵头建立评审角色体系，并承诺资源支持。

以下架构图展示了前置条件中角色、权限与工具的三层映射关系：

2.3 操作步骤

按照以下步骤依次建立角色、权限与工具之间的映射关系：

步骤	操作内容	具体说明	输出物
1	定义参与角色清单	根据团队组织架构，列出所有需参与评审的角色：项目经理、技术负责人、开发工程师、测试工程师、产品经理。每个角色指定一名主责人及一名备选人。	《评审角色注册表》
2	分配权限矩阵	为每个角色分配对应的评审权限，包括：创建评审、分配评审人、提交代码、审核通过/驳回、需求确认等。权限粒度需与角色职责匹配。	《角色-权限映射矩阵》
3	配置工具权限模板	在评审管理平台、代码仓库、文档系统中创建权限模板，将角色-权限矩阵落地为工具配置。例如在代码仓库中设置分支保护规则与CODEOWNERS。	工具权限配置文件
4	集成验证	使用测试账号模拟各角色的评审全流程操作，验证权限设置是否正确，工具间数据流是否通畅。	《验证测试报告》
5	发布并沟通	将角色定义、权限矩阵及工具使用指南通过团队公告、文档站或评审启动会正式发布，确保全员知悉。	《评审前置条件基线公告》

实操建议： 在步骤3中，建议使用代码仓库的 CODEOWNERS 文件来固化代码评审的自动指派规则。以下是一个可用于 GitLab / GitHub 的配置示例：

# 仓库根目录 CODEOWNERS 示例
# 全局默认所有者
* @tech-lead @senior-dev

# 前端代码由前端团队负责
/src/frontend/ @frontend-team-lead @frontend-dev

# 后端代码由后端团队负责
/src/backend/ @backend-team-lead @backend-dev

# 文档与配置由项目经理审核
/docs/ @project-manager
*.md @project-manager

# 关键分支保护（通过仓库设置）
# main 分支至少需要 2 个 Approvals
# 不允许直接 push，必须通过 Merge Request

2.4 输入输出物

类型	名称	责任人	说明
输入物	《研发评审总流程设计稿》	流程设计组	来自第1章，提供评审阶段定义与准入准出标准。
输入物	《团队组织架构图》	HR/项目管理	明确参与评审的职能部门及人员名单。
输出物	《评审角色注册表》	项目经理	包含角色名称、主责人、备选人、所属部门。
输出物	《角色-权限映射矩阵》	技术负责人	矩阵形式呈现角色与权限的对应关系。
输出物	《工具权限配置清单》	DevOps/工具管理员	记录各工具平台的权限模板与配置文件。
输出物	《验证测试报告》	测试工程师	包含测试场景、测试结果、问题列表及修复状态。

2.5 责任边界

角色	职责范围	不涉及/交接边界
项目经理	牵头组织角色定义，维护《评审角色注册表》，组织共识会议。	不负责具体技术工具配置，工具配置由DevOps主导。
技术负责人	定义技术审核与代码提交权限粒度，审核《角色-权限映射矩阵》。	不干预产品需求的确认流程，需求确认权归属产品经理。
开发工程师	配合验证代码提交权与审核流程，反馈权限配置问题。	不参与权限审批，仅作为被授权方使用工具。
测试工程师	验证需求验证权及相关工具链路，输出《验证测试报告》。	不负责代码仓库的权限配置，仅关注测试环境工具可用性。
产品经理	确认需求确认权配置正确，验收文档系统中需求状态流转。	不介入技术评审或代码审核相关的权限设置。
DevOps/工具管理员	将角色-权限矩阵落地为工具配置，执行权限模板部署。	不参与角色定义与权限矩阵设计，仅负责技术实现。

常见越界风险： 项目经理直接修改工具权限配置而未通过DevOps审核，可能导致权限模板与角色矩阵不一致。所有工具层变更必须经由DevOps或工具管理员执行，确保审计可追溯。

2.6 记录材料

本章所有操作必须留存以下记录材料，以备后续审计与回溯：

《评审角色注册表》 —— 经项目经理与技术负责人双方签字确认的电子版或纸质扫描件。
《角色-权限映射矩阵》 —— 版本化存储于文档系统，每次变更需记录修订历史。
工具权限配置文件快照 —— 代码仓库中 CODEOWNERS、.gitlab-ci.yml 或平台导出的权限模板JSON。
权限验证测试录像或日志 —— 记录每个角色执行典型评审操作的屏幕录像或工具操作日志。
《前置条件基线评审纪要》 —— 召开前置条件评审会议的会议纪要，包含问题与决议。