禅道是一款国产开源的项目管理软件，覆盖了产品规划、需求管理、任务分配、缺陷跟踪、测试管理、发布上线。是围绕产品–项目–测试板块协作。

一、禅道概念和角色

产品（Product）：要开发的东西，比如CRM系统。

需求（Story）：产品功能点，例如用户可自助重置密码。

项目（Project）：一次迭代或开发活动，用于完成一批需求。

任务（Task）：开发人员具体要干的技术活，由需求拆解而来。

Bug：测试或用户发现的缺陷。

测试用例（Case）：预先设计好的测试场景。

发布（Release）：产品版本正式对外上线的记录。

对应的协作角色：产品经理 - 管产品/需求；项目经理 - 管项目/任务；研发 - 领任务、写代码；测试 - 提Bug、管用例。

二、标准需求发布工作流

大多数团队按以下步骤在禅道里协作：

1. 产品经理创建产品 - 录入需求

在产品模块下新建产品，划分模块（如用户端、管理后台），然后写清楚每条需求，并规划到对应的产品计划（代表哪个版本发布）。

2. 项目经理创建项目 - 关联需求

在项目模块下新建项目，选好迭代周期和团队。然后进入项目的需求页面，把上面创建的需求关联进来，表示本次迭代要开发这些。

3. 拆解任务 - 分配开发

项目经理把关联进来的需求，逐一分解成具体的技术任务（比如设计数据表、开发接口），指派给开发人员，并预估工时。

4. 开发人员领任务、更新状态

开发者在我的地盘看到任务，完成后将状态改为已完成，并可填写实际工时消耗。

5. 测试工程师写用例、测Bug

测试在测试模块编写测试用例，然后创建测试单执行测试。发现的问题直接提Bug，Bug会和对应的需求、任务关联起来。开发者修复后，Bug流转回测试验证。

6. 发布版本

项目结束时，在发布里创建一个版本，关联已完成的需求和已解决的Bug，版本状态改为正常，代表上线。

三、上手步骤

假设刚打开禅道：

登录后，先点产品 - 新建一个产品，确定名称和代号。

进入该产品，点需求 -提几条需求，比如支持手机验证码登录，指定所属模块。

点项目 -新建项目，类型选Scrum（推荐），设置起止日期。

进入项目，点需求 - 点关联需求，把前面提的需求勾选进来。

点项目的任务 → 点建任务，把需求拆成开发任务、前端任务等，指派给同事。

点测试 → 写几条测试用例。然后在项目内点测试单，关联用例开始测试。

发现缺陷，点击提Bug并关联需求或任务，Bug就会进入解决流程。

完成后，在项目里点发布新建发布，关联本轮需求和Bug，完成闭环。

四、实用功能

看板视图：项目和任务支持看板，拖拽卡片就能更新状态（未开始 - 进行中 - 已完成）。

我的地盘：每个人一登录就能看到待办任务、待解决Bug，不用到处翻找。

文档管理：产品、项目下都能上传文档，还能在线编写，方便存PRD或会议纪要。

统计图表：有燃尽图、需求分布图、Bug统计等，汇报进度一目了然。

自定义工作流：如果公司流程特殊，可以在后台调整Bug、任务的流转步骤。

五、常见疑问

一定要按产品→项目走吗？

不一定，禅道也支持只有项目，直接管任务/Bug的极简模式，但如果想发挥全流程威力，建议按标准流程走。

需求、任务、Bug怎么区分？

简单记：需求是要什么，任务是怎么开发，Bug是哪儿错了。

忘记录入了怎么办？

任何角色都可以补录，但建议养成先建需求再拆任务的习惯，后期追溯和统计会更清晰。