软件版本管理
软件版本管理功能通过精确关联任务、用例与发布版本，实现版本级进度跟踪与质量管控。
主要操作
一、版本基础操作
1. 创建软件版本
操作说明：定义新发布周期标识
操作步骤：
项目 → 项目列表 → 编辑- 切换
软件版本标签页 - 点击「添加版本」按钮
- 输入必填项：
- 版本名称（唯一标识，≤40字符）
- 计划开始/发布时间
- 版本描述（≤200字符）
- 点击「确定」保存
⚠️ 命名规范：建议采用主版本.次版本.修订号格式
2. 修改版本信息
操作说明：调整版本计划元数据
操作步骤：
版本管理列表点击目标版本「编辑」- 允许修改字段：
- 版本名称（需保持唯一）
- 时间范围（开始/发布日期）
- 描述文本
- 点击「确定」更新
发布时间修改后自动同步关联任务
3. 合并版本
操作说明：整合多版本资源至目标版本
操作步骤：
- 点击列表上方「合并版本」
- 选择需合并的源版本（可多选）
- 指定目标承接版本
- 点击「确认」执行合并
❗ 不可逆操作：源版本关联资源将迁移至目标版本
二、版本状态管理
1. 发布版本
操作说明：启用版本供任务/用例关联
操作步骤：
版本列表选中规划中版本- 点击「发布」操作按钮
- 二次确认弹窗点击「继续」
✅ 状态转为"已发布"后可见于关联菜单
2. 归档版本
操作说明：冻结已完成版本
操作步骤：
版本列表选中已发布版本- 点击「归档」操作按钮
- 二次确认弹窗点击「继续」
🚫 归档后版本：- 从筛选器隐藏
- 禁止新任务/用例关联
- 保留历史数据追溯
3. 删除版本
操作说明：彻底移除无效版本
操作步骤：
版本列表选中目标版本- 点击「删除」操作按钮
- 输入版本名称二次验证
⚠️ 同步解除关联关系（任务/用例保持独立）
三、版本进度监控
1. 跟踪任务进展
操作说明：监控版本关联任务完成情况
操作步骤：
任务 → 版本打开视图- 点击目标版本名称进入详情页
- 查看核心指标：
- 进度仪表盘（完成百分比）
- 任务状态分布（未开始/进行中/已完成）
- 逾期任务高亮标记
2. 分析测试进展（TODO）
操作说明：评估版本测试覆盖质量
操作步骤：
功能 → 版本打开视图- 点击目标版本名称进入详情页
- 关键数据维度：
- 用例通过率（成功/失败/阻塞）
- 缺陷密度（每千行代码缺陷数）
- 测试进度趋势图
版本字段信息
| 参数 | 字段名 | 类型 | 必填 | 长度限制 | 说明 |
|---|---|---|---|---|---|
| ID | id | bigint | 条件 | / | 版本唯一标识符；修改时必须 |
| 项目ID | projectId | long | 是 | / | 所属项目唯一标识 |
| 版本名称 | name | string | 是 | ≤40 | 版本标识名称， 如：V1.0.0 |
| 开始日期 | startDate | datetime | 否 | / | 版本开发启动时间 |
| 发布日期 | releaseDate | datetime | 否 | / | 版本正式发布时间 |
| 描述 | description | string | 否 | ≤200 | 版本功能描述 |
| 版本状态 | status | enum | 只读 | / | 状态枚举： 未发布/已发布/已归档 |
| 进度统计 | progress | object | 只读 | / | 版本开发进度统计 |
| 任务状态分布 | taskByStatus | map | 只读 | / | 按状态分类的任务统计 |
| 创建人ID | createdBy | long | 只读 | / | 版本创建人ID |
| 创建人姓名 | createdByName | string | 只读 | / | 创建人姓名 |
| 创建时间 | createdDate | datetime | 只读 | / | 版本创建时间 |
| 最后修改人ID | lastModifiedBy | long | 只读 | / | 最后修改人ID |
| 最后修改人姓名 | lastModifiedByName | string | 只读 | / | 最后修改人姓名 |
| 最后修改时间 | lastModifiedDate | datetime | 只读 | / | 最后修改时间 |
版本状态（status）
| 枚举值 | 说明 |
|---|---|
NOT_RELEASED | 未发布 |
RELEASED | 已发布 |
ARCHIVED | 已归档 |