禅道使用规范篇

欢迎使用Markdown一、标题命名规范

1.计划/迭代
命名格式：【{创建时间}】《{产品/子产品}》{计划/迭代名称}
例子：
【20190531】《订单管理》v1.0.1版迭代计划
【20190615】《运单管理》v1.0.1版迭代计划

2.发布版本命名
命名格式：{产品/子产品}{版本号}
例子：
TMS运单管理v1.0.1
TMS订单管理v1.0.2

***以上待完善：需结合新科技【代码版本控制流程】、【分支管理规范】等流程规范

二、项目开发计划流程规范
1.创建产品-创建一个主线产品，若这个产品涉及多个平台，则根据父子关系创建树
规范事项：
1）产品只能由超级管理员建立。
2）每个主线产品，自身再细分不同平台的子产品。

2.创建迭代
如果你已经创建了产品树，则新建一个主线迭代后，它将会关联整个产品的树结构
规范事项：
1）迭代只能由超级管理员建立。
2）只要创建好产品体系，直接创建一个主线迭代会有对应产品的子项目。

3.创建工作计划
为了更好维护产品，我们采用阶段性迭代开发方式。每个开发阶段都以唯一的版本号命名计划，每个阶段都合理汇总需求及要修复的bugs，尽可能地确定及控制每个阶段开发时间及人力成本。使产品开发能做到高效率与高稳定兼顾。
1）由产品/项目经理创建“计划”
描述计划的版本号，工作概述，开发时间等。（时间尽量预松，以备摸索时遇到坑）
2）为计划创建需求及关联需本次迭代修复的bugs
规范事项：
1）开发计划只能由项目经理、架构师等人员建立。
2）开发计划尽力做到小而精准，做好需求分析，做出符合用户需要的功能。
3）开发计划中列明开发人员及职责，尽量不要一个人员同时在进行多个计划，避免其进度无法把握。
4）开发计划的时间预估应该要合理，必须包含需求分析，原型设计，编程开发，功能测试等时间，时间安排不合理会造成偷工减料，Bugs频繁出现。
5）完成每个计划都必须写下《计划总结》，总结新技术和遇到的问题，提高团队效率。

4.创建需求
有了开发计划，我们就可以创建需求，把需求关联到计划中。有时候，可能会出一些突发奇想的需求，这些可以不纳入到计划中，可以作为临时任务完成。但我们还是尽可能把需求汇总好，归纳到计划中，这样才能保证项目稳定，降低成本。避免仓促粗糙的测试导致项目上线遇到严重问题，付出沉重成本。关于需求的INVEST原则，这里就不花篇幅赘述了，但产品人员应时刻牢记，良好的用户故事是敏捷开发的基础
规范事项：
1）需求只能由产品经理，产品专员等人员建立。
2）需求尽可能绑定到开发计划中。
3）需求要指明所属的产品模块。
4）需求必须经由产品经理审核。
5）尽可能归纳多个需求点到一个记录中，可使用《XMind》等脑图工具整理出来，方便理解阅读。
6）禅道从1.2版本中，已经增加了文档库管理。可以将原型图作为设计文档，上传到某一个产品相关的文档库中，和用户故事相互配合
7）禅道手册-产品经理篇：https://www.zentao.net/book/zentaopmshelp/59.html

5.创建任务
有了需求，我们就可以依照每个需求点制定日常的开发任务指派给下属。有时候有些简单的任务，可以不需要需求做支持。例如，一些文档整理任务。但我们尽量把任务归类好，要保证任务是在那个版本，那需求点而做的。保证Bugs出现时可查找到开发人员和原始的需求内容。
规范事项：
1）任务只能由项目经理、架构师等人员提出。
2）单个任务时间最好控制在1周内，尽可能细分任务，保障进度把控尽量精准。
3）开发人员每日要求简述任务进度和遇到的问题。避免低级问题造成任务阻塞。
4）只要任务关联上需求，在详细页面中可以看到需求内容。
5）任务描述尽可能清晰罗列工作要点和注意事项。
6）不要一个任务指派给多个人一起做，避免开发上的冲突。
7）为了区分任务是属于需求关联的任务，还是日常临时的任务，可用颜色区分，“默认颜色”为计划任务，“绿色”为临时任务
8）禅道手册-任务篇：https://www.zentao.net/book/zentaopmshelp/86.html

6.创建版本
开发计划中的需求都完成后，接下来就是安排测试工作，在测试前需要建立版本号。这样测试人员发现bugs，可以标记那个版本发现的。
、规范事项：
1）版本只能由项目经理、架构师等人员建立。
2）最好不要有两个同时是“研发中”的版本，避免分支的代码混乱。
3）发布了的版本记得及时标记为“已发布”状态。
4）解决了bugs或完成了需求，及时在版本号上关联上。
5）禅道手册-版本篇：https://www.zentao.net/book/zentaopmshelp/161.html

7.提交测试
版本号创建后，接下来就可以测试了。建立好的测试用例，做好测试计划，测试质量直接影响到产品质量。长期维护的产品应该以测试推动开发，所以说保证测试质量至关重要。
规范事项：
1）测试只能由项目经理、架构师等人员建立。
2）尽可能描述本次测试计划的要点和注意事项。
3）测试人员熟悉新功能后，尽量做到建立专业的测试用例，并关联到每次的测试计划。

8.测试/日常Bugs提交
当测试人员发现Bugs，最有效的解决就是提交到相关产品对应的Bugs中。避免口头交代问题造成遗忘及处理结果无法交代清楚。
规范事项：
1）Bugs任何人员都可建立。
2）Bugs的发现过程尽可能记录详细，需要账号或数据条件应该列明。
3）Bugs标记好发现的版本和所属产品，可先指派给架构师、研发小组长进行分析处理，再分派给开发人员处理。
4）Bugs解决方案需要说明“原因”和“解决”，标明好解决版本，打包程序测试通过后，最后需要把版本关联所解决的Bugs，才能进行最后的发布。

9.版本发布
规范事项：
1）版本测试通过后，由版本负责人在ERP-OA流程申请上线
2）发布成功通知各方验收，确保发布质量后由产品经理在产品-发布中创建一条发布记录。
3）发布记录可关联已测试通过的版本，及版本包含的发布内容（需求、bug），方便干系成员直观的查看。
4）命名规范例：TMS订单管理1.0.2
5）停止维护老版本：新版本运行稳定后，可在禅道路径“产品-发布”，设置旧版本对应的发布为“停止维护”（这个步骤不能忘记，否则在bug里边选择版本的时候，没有被停止维护的发布对应的版本会一直显示出来）

后话：目前咱们遇到的所有关于流程关于规范的问题，远不是一套项目管理工具就能解决问题的，关键在人，人若无主观努力和同一轨道的向心力，再好的工具也是白搭。禅道官网手册已经很详尽的介绍了各个角色的成员在相关环节的操作步骤和注意事项，所以在它作为我们的管理工具之前，大家需花时间读懂他，理解他。传送门：https://www.zentao.net/book/zentaopmshelp/50.html
编辑器

你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

1. 全新的界面设计 ，将会带来全新的写作体验；
2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
4. 全新的 KaTeX数学公式 语法；
5. 增加了支持甘特图的mermaid语法¹ 功能；
6. 增加了 多屏幕编辑 Markdown文章功能；
7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H₂O is是液体。

2¹⁰ 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

• 项目
  • 项目
    • 项目

1. 项目1
2. 项目2
3. 项目3

• 计划任务
• 完成任务

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	'Isn't this fun?'	‘Isn’t this fun?’
Quotes	"Isn't this fun?"	“Isn’t this fun?”
Dashes	-- is en-dash, --- is em-dash	– is en-dash, — is em-dash

创建一个自定义列表

Markdown

Text-to- HTML conversion tool

Authors

John

Luke

如何创建一个注脚

一个具有注脚的文本。²

注释也是必不可少的

Markdown将文本转换为 HTML。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 $\Gamma (n)=(n-1)!\forall n\in \mathbb{N}$ 是通过欧拉积分

$$\Gamma (z)={\int }_0^{\infty }{t}^{z-1}{e}^{-t}dt.$$

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

• 关于 甘特图 语法，参考 这儿,

UML 图表

可以使用UML图表进行渲染。 Mermaid. 例如下面产生的一个序列图：:

这将产生一个流程图。:

• 关于 Mermaid 语法，参考 这儿,

FLowchart流程图

我们依旧会支持flowchart的流程图：

• 关于 Flowchart流程图 语法，参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件或者.html文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
继续你的创作。

---

1. mermaid语法说明 ↩︎

2. 注脚的解释 ↩︎