# 01-总体规范

## 1. 研发工作流

软件研发过程包含 6 大工作流：

```
需求 → 分析与设计 → 实现(编码) → 测试 → 发布和部署 → 配置和变更管理
```

## 2. 项目角色

| 角色 | 职责 |
|------|------|
| **项目经理** | 项目整体管理、进度控制、资源协调 |
| **产品经理** | 需求定义、产品规划 |
| **需求工程师** | 需求调研、分析、编写、跟踪 |
| **架构师** | 技术选型、架构设计 |
| **开发工程师** | 编码实现、单元测试 |
| **测试工程师** | 测试方案、用例编写、执行测试 |
| **配置管理员** | 代码/制品/文档版本管理 |
| **QA 工程师** | 质量保证、过程审计 |

## 3. 各工作流交付成果

| 工作流 | 交付物（C1 必选） |
|--------|-------------------|
| 需求 | 《软件需求规格说明书》、《需求追踪表》 |
| 分析与设计 | 《概要设计说明书》（C1）、《详细设计说明书》（C2） |
| 实现 | 源代码、单元测试代码 |
| 测试 | 《测试方案》、《测试用例》、《测试报告》、《缺陷追踪表》 |
| 发布和部署 | 部署计划、实施方案、回退方案 |
| 配置管理 | 配置项清单、变更记录 |

## 4. 开发模式

- **【推荐 C2】** 采用迭代式开发，推荐 2-4 周为一次迭代
- **【强制 C1】** 每个迭代需建立功能、需求和测试用例间的双向追踪关系
- **【强制 C1】** 迭代结束需建立基线，进行版本打标

## 5. 配置和变更管理

- **【强制 C1】** 源码、需求文档、设计文档、测试用例纳入配置管理
- **【强制 C1】** 所有配置项必须存储在电信内部服务器，不得使用外部云存储
- **【强制 C2】** 需求、迭代、测试用例、代码版本、制品版本、产品版本间建立双向追踪
- **【强制 C1】** 源码、制品、发行版本必须维护可回溯性

## 6. 评审要求

### 评审方式
- **预评审**：提前 3 个工作日申请，≥50% 评审成员反馈预评审结果
- **会议评审**：正式会议评审，输出评审记录和缺陷汇总
- **离线评审**：邮件/平台分发材料，限时提交评审结果

### 评审通过标准
| 结论 | 说明 |
|------|------|
| **通过** | 无背离需求的缺陷，少量细微修改 |
| **有条件通过** | 少量重要缺陷，修正后不影响主要结构，经评审专家确认即可 |
| **不通过** | 较多重要缺陷或修改影响主要结构，需重新评审 |

## 7. 技术栈要求

- **【强制】** 新项目 100% 使用天翼云底座、统一技术组件
- **【强制】** 技术选型须符合《中国电信软件开发统一技术栈要求(试行版)》
- **【推荐 C0】** 优先复用统一制品库中已有自主研发组件
- **【强制 C1】** 编码工作在云电脑内进行，所有代码不出研发云
- **【强制 C4】** 系统/模块间接口调用参照 OpenAPI 规范

## 8. 域名规则

共享代码/组件域名格式：
```
cn.chinatelecom.<分公司/专业公司缩写>.<自定义名称>
```

## 9. 质量度量指标

代码质量扫描需获取以下指标：
- 阻断级问题数量、严重级问题数量
- 可靠性评级、安全性评级、可维护性评级
- 代码重复率
- 行覆盖率、分支覆盖率