数字化技能提升教程,数字化时代生存宝典

Gitea Issue、标签、里程碑与项目看板使用教程

浏览:28

在 Gitea 中,代码仓库不仅可以管理代码文件,还能通过工单(Issue)、标签、里程碑和项目看板组织日常开发任务。本文以 lin/team-notes 仓库为例,将一个已经修复的问题和两个后续任务整理为工单,并通过标签、里程碑和项目看板进行管理,演示从创建任务到关闭工单的完整流程。

1. 创建三条测试工单

本次测试围绕一个小型项目展开,共设置三条任务:

  • 确认合计输出带金额单位

  • 增加小数金额示例

  • 补充本地测试说明

进入仓库的「工单」页面,点击「创建工单」,分别填写任务标题和说明,明确需要处理的内容及预期完成条件。创建时,还可以在右侧设置标签、里程碑、所属项目和指派人。

建工单表单,说明中关联了已经合并的 PR

为了确保三条测试工单及其关联字段保持一致,本次通过 Gitea 实例 API 创建工单和设置相关信息,随后返回网页检查结果。

创建完成后,三条工单的编号分别为 #2、#3 和 #4。由于此前的 PR 已占用 #1,因此工单编号从 #2 开始。

2. 创建标签并区分任务类型

为了方便识别不同性质的任务,先在仓库中创建三个标签:缺陷、改进和文档。每个标签设置对应的说明和颜色,便于后续查看和筛选。

三条工单分别对应以下标签:

  • 缺陷:合计输出应带金额单位

  • 改进:增加小数金额示例

  • 文档:补充本地测试说明

进入标签页面,可以看到三个标签及其说明,同时查看每个标签关联的开启工单数量。

标签列表展示名称、说明及各自关联的开启工单数量

这里使用标签区分任务性质,而不额外创建「进行中」「已完成」等状态标签。任务的处理进度交由后续项目看板管理,避免标签和任务状态混在一起。

3. 创建里程碑并关联工单

接下来创建一个里程碑,将三条测试工单归入同一阶段。

进入里程碑页面,创建名为「十月测试版」的里程碑,说明填写「整理小项目的三个测试任务」,本次不设置截止日期。创建完成后,将三条工单全部关联到该里程碑。

三条工单均处于开启状态,里程碑当前进度为 0%

里程碑主要用于集中管理同一版本或阶段内的任务。由于此时三个工单都尚未关闭,里程碑页面显示「3 开启中、0 已关闭」,完成进度为 0%。

4. 在工单详情页查看关联信息

完成关联设置后,打开工单 #2,可以在详情页右侧看到该任务的相关信息:

  • 标签:缺陷

  • 里程碑:十月测试版

  • 项目:十月开发看板

  • 负责人:lin

工单时间线还会记录添加标签、设置里程碑、指派负责人以及关联项目等操作,方便后续追踪任务变更。

工单详情页集中展示标签、里程碑、项目和负责人等信息

另外两条工单也分别设置了负责人:小数金额示例指派给 chen,本地测试说明指派给 lin。需要注意,指派负责人只是明确任务分工,并不代表系统会自动执行代码修改。

5. 创建项目看板并添加工单

接下来使用 Gitea 项目功能管理任务进度。

创建名为「十月开发看板」的项目,模板选择基本看板。创建后,系统生成了四个默认列:

  • Backlog:待整理任务

  • To Do:准备处理

  • In Progress:正在处理

  • Done:已完成

将前面创建的三条工单全部添加到项目中。初始状态下,三张卡片都位于默认的 Backlog 列。

三条工单均已加入项目看板,当前集中在 Backlog 列

看板卡片可以直接展示任务标题、工单编号、所属里程碑、标签以及负责人头像,不需要逐条打开工单详情,也能快速了解任务分配情况。

6. 将工单移动到 To Do

为了演示看板的任务流转,将「合计输出应带金额单位」这张卡片从 Backlog 拖动到 To Do。

移动完成后,Backlog 中剩余两条任务,To Do 列增加一条任务。

金额单位工单已移动到 To Do,另外两条工单仍保留在 Backlog

需要注意的是,拖动卡片只会改变任务在项目看板中的位置,并不会直接关闭工单。

重新打开工单详情页,可以在时间线中看到移动到 To Do 的操作记录,此时工单仍然处于开启状态。

7. 关闭已经处理完成的工单

前面提到,「合计输出应带金额单位」对应的问题已经通过 PR 修复,并合并到主分支。因此,本次将工单 #2 作为已完成任务,在详情页点击「关闭工单」。

另外两条任务尚未处理完成,继续保持开启状态。

关闭工单后,重新进入「十月测试版」里程碑页面,可以看到任务统计发生变化:当前有 2 条开启工单、1 条已关闭工单,完成进度更新为 33%。

关闭一条工单后,里程碑根据已关闭工单数量自动更新完成进度

8. 检查工单关闭后的看板变化

最后返回「十月开发看板」,查看工单关闭后的状态。

可以看到,已经关闭的工单仍然保留在 To Do 列,卡片上的图标变为已关闭状态,而 Done 列依然为空。

工单关闭后仍停留在 To Do 列,没有自动移动到 Done

这说明在当前项目配置下,关闭工单和移动看板卡片是两个独立操作。关闭工单会更新工单自身的状态及里程碑完成进度,但不会自动改变卡片所在的项目列。

总结

通过这次测试,可以看到 Gitea 的工单、标签、里程碑和项目看板各自承担着不同的任务管理职责:

  • 工单(Issue):记录具体问题、任务内容和处理状态。

  • 标签(Labels):区分缺陷、改进、文档等任务类型。

  • 里程碑(Milestones):将多个工单归入同一版本或开发阶段,并统计完成进度。

  • 项目看板(Projects):通过不同列展示任务所处的处理阶段,方便团队跟踪工作进展。

相关阅读:《基于Gitea Actions Runner搭建代码提交自动测试流水线》

相关文章
猜你喜欢