Redmine及SVN在项目管理中应用.docx

1、Redmine及SVN在项目管理中应用文档名称Product name密级Confidentiality level1产品版本Product versionTotal 3pages 共3页V1.0Redmine及SVN在项目管理中应用Prepared by 拟制Name+IDDate日期2010-03-31Reviewed by 评审人Date日期yyyy-mm-ddApproved by批准Date日期yyyy-mm-ddAuthorized by签发Date日期yyyy-mm-ddDaasan Software Technologies Co., Ltd. 大山软件科技有限责任公司文档修订

2、记序 号修改时间修 改 人审 核 人备 注1234567891011121314151617181920目 录1 Redmine及SVN的介绍1.1 Redmine的介绍Redmine是用Ruby开发的基于web的项目管理软件，是用ROR框架开发的一套跨平台项目管理系统，支持多种数据库，有不少自己独特的功能，例如提供wiki、新闻台等，还可以集成其他版本管理系统和BUG跟踪系统，例如SVN、CVS、TD等等。这种 Web 形式的项目管理系统通过“项目（Project）”的形式把成员、任务（问题）、文档、讨论以及各种形式的资源组织在一起，大家参与更新任务、文档等内容来推动项目的进度，同时系统利用

3、时间线索和各种动态的报表形式来自动给成员汇报项目进度。Redmine是一个灵活的项目管理工具，它可以有效的管理项目开发的整个流程（需求，设计，开发）。1.2 Redmine的功能主要功能功能介绍多项目支持在一个redmine里面，可以管理任意多的项目；在每一个项目里面可以独自定义此用户的角色；可以自定义每个项目为公共的项目还是私有的项目；每个项目单独设计项目所包含的模块，如wiki，如问题跟踪，论坛，文档；多子项目支持每个项目底下，可以设立多个子项目自定义的基于角色的访问控制系统可以自定义每个redmine里面的角色信息，并自定义其权限；自定义的问题跟踪系统可以自定义问题类型；可以自定义每个问

4、题类型的流程；自定义甘特图和日历自动根据问题的开始、结束时间，自动生成项目的甘特图和日历，方便进行项目的跟踪，并且自动根据问题的状态在甘特图中显示不同的颜色；时间追踪可以跟踪每个问题、每个用户，每个类别，每个活动的时间花费，方便项目进行总结；自定义字段你可以定义问题、项目和用户自定义字；自定义字段的格式可供选择：文本，日期，布尔，整数，下拉列表和复选框并且可以将自定义字段作为过滤器的查询项，方便查询；每个项目都支持wiki,论坛支持为每个项目配备wiki、论坛，方便内部项目沟通，特别是异地的项目组的沟通；配置库浏览以及差异查看支持多种配置库，如Subversion, CVS, Mercuria

5、l, Darcs, Bazaar and Git.在项目中设置好配置库，可以直接在redmine中以web方式浏览配置库；浏览器中可以直接浏览不同版本之间的差异；电子邮件通知项目的活动，变更，新闻，问题，问题的变化都可以通过mail进行通知，前提是必须设置好mail相关参数支持多数据库支持多种语言1.3 SVN的介绍Subversion（简称SVN）是版本管理工具1.4 SVN的功能主要功能附属功能功能介绍Repo-browser版本库浏览器进入SVN系统界面的途径；Import导入工作目录初始化或第一次向数据库上工作目录添加原始文件；Export导出数据库中的文件夹内容复制到本地，不受SVN

6、数据库管理；Checkout检出（将资料库中的文件夹内容复制到本地目录，受SVN数据库管理）Update 更新如果检出的版本过期则使用更新；Commit 提交在检出副本目录中对文件进行的添加、修改、删除等动作上传到数据库；Show log 显示日志包含了该文件（夹）从起源开始操作的一切版本、操作方式、用户名称、日期。用户可以通过该信息追溯原始数据变化的所有结点；Resolved 已解决的当本地受版本控制文件夹由于版本过期导致冲突时使用；Update to revision 更新至版本同一目录不同版本间的切换；Revert 还原对本地工作副本文件做了改动未提交，又想恢复到被改动以前的状态Clea

7、n up 清理轻微冲突时使用；Branch/tag 分支/标志Switch 切换应用于本地副本目录不同路径、不同版本间的切换；Merge 合并将分支文档、数据进行自动合并Add 增加新增文件或文件夹需要进行提交显示时使用。2 Redmine的使用2.1 我的工作台2.1.1 显示你所参与的项目的各种信息块。默认情况下只有下面两个模块启用：a.指派给我的问题：提供一个跨项目的指派给当前用户的问题列表，显示问题的ID，项目，跟踪标签类型和主题b.已报告的问题：提供一个跨项目的由当前用户报告的问题列表，显示问题的ID，项目，跟踪标签类型和主题2.2 项目列表2.2.1 任何页面点击顶端可“项目”即可

8、展现项目列表 2.2.2 列出了所有自己有权限查看的项目2.2.3 点击项目名称可进入该项目主页2.2.4 左上角有3个快捷链接：a.在一个页面上查看所有项目的问题 b.在一个页面上查看所有项目的耗时情况 c.在一个页面上查看所有项目的活动2.3 项目概述2.3.1 页面提供一个关于该项目的总体概述2.3.2 左上角的问题跟踪区域列出了目前项中每一种问题跟踪标签的打开数量以及总共数量2.3.3 在成员区域列出该项目组的所有成员2.3.4 在最新新闻区域列出了项目的最新新闻 2.3.5 问题跟踪：a.错误指该项目中发现的错误b.功能指对该项目提出的新增功能需求 c.支持指为项目做出的贡献，例如提

9、交了一个补丁文件 d.工作安排指日常的工作安排（需后台添加，管理员可以添加更多问题类型）2.4 问题2.4.1 发现的错误、新提的要求、对工作的安排等都可以被当作问2.4.2 问题是一个过程性的概念，从提出问题到解决问题、关闭问题是一个完整的过程，表示了对错误的处理、对新需求的响应或对工作安排的完成情况正处于什么样的阶段2.4.3 系统默认的问题状态有5种：a.新建：表示错误刚被发现、新需求刚被提出、或者工作任务刚被下达b.进行中：表示已经安排了人来处理该问题c.已解决：表示此问题已经被解决d.反馈：表示有人对问题的解决效果提出了反馈意见 e.已关闭：表示问题已经彻底解决并通过审核，可以告一段

10、落。默认情况下问题列表中将不再显示已经关闭的问题。f.已拒绝：认为该问题提出的错误不存在、工作任务不合理等，拒绝执行此问题2.5 项目活动2.5.1 活动就是指人们在系统上进行各种操作的记录：a.所有可以显示的活动类型见右侧边栏（问题、变更、新闻、文档、文件、Wiki编辑记录、帖子、耗时）b. 对于管理者来说可以看看项目成员每天都在做什么工作c.在项目列表页面点击全部活动显示的是所有项目的活动 d.如果想看看近期有什么新内容，可以把Wiki和帖子选上，则可以看到Wiki新 增加的内容和讨论区里面新发布的帖子2.6 路线图路线图提供了一个更高级别的基于项目版本的对于整个问题跟踪系统的概述, 它可

11、以帮助制定项目计划, 管理项目开发。 概述 点击路线图选项卡, 你就可以查看当前项目的进展状态: 版本名称、版本的完成日期、进度条、目标版本相关连的问题列表管理路线图如果你的权限合适, 你可以为版本添加一个wiki页面, 用于描述当前版本的一些主要事件。边栏路线图页面的右边栏为你提供了以下功能:可以根据需要, 选择路线图上显示哪些跟踪标签。可以根据需要, 选择是否显示已经完成的版本所有版本的链接2.7 路线图的运用 项目版本同时新建问题（一般来说是功能）时选择 对应目标版本 每个版本会列出预定的结束时间和进度（按照已关闭问题占全部问题的比例计算） 画了删除线的问题表示已经解决 所有问题都解决后

12、，表示这个版本可以发布了 对项目经理有一定意义，可预先定义产品特性或者项目需求 对产品经理来说意义非凡，可对多个版本需要实现的产品特性进行分派2.8 问题列表2.8.1 默认显示所有打开的问题（即需要有人处理的问题）： a.点击问题列表上的表头可以排序b.使用过滤器可以查找特定的问题（如按类别查找、按作者查找等）c.使用问题前面的复选框可以选择多个问题，然后点击右键可以通过快捷菜单处理多个问题d.可以导出到 RSS（新闻订阅）、CSV、PDF2.8.2 重要操作 a.过滤器应用 b.批量编辑 c.自定义查询 d.条目上的快捷菜单（编辑、状态、跟踪标签、优先级、目标版本、指派给、完成度、登记工时

13、、跟踪者、副本、复制、移动、删除）2.9 新增问题2.9.1 按照表单填写即可 2.9.2 问题被新建或者被更新后系统将自动发送通知邮件2.9.3 问题的作者和被指派者将自动收到通知邮件 2.9.4 收到通知邮件后，正确的做法是：a.点击邮件中的连接打开问题详情页面b.如果对此问题有意见或者需要补充，请点击更新按钮增加说明c.更新后新的通知邮件又会自动发送 d.其他用户（非作者和被指派者）如果也想收到该问题的通知，可以使用跟踪功能（详见问题详情） 2.9.5 创建问题时, 最重要的字段是跟踪标签字段, 它决定了问题的类型。2.10 子任务及相关问题2.10.1 系统支持子任务和相关问题，即支持

14、任务分解（WBS） 2.10.2 点击某一问题，进入问题查看页面。然后点击子任务区域的 新增 链接，进入新建子任务页面，父任务字段的值系统自动获得，其他字段像创建问题一样输入，最后点击保存。 2.10.3 点击相关问题区域的 新增 链接，可根据具体的情况建立不同类型的问题关联。2.11 相关问题的关联允许开发者将某一问题与其他问题建立关联, 从而起到了删除重复问题, 简化工作流的作用。 当前版本允许建立的关联类型有:2.11.1 关联到 普通关联关系，问题A、B需要分别关闭2.11.2 重复如果问题B重复于A，那么关闭A将自动关闭B。2.11.3 阻挡和被阻挡阻挡 ：如果问题B阻挡A，A无法关

15、闭，除非B关闭。被阻挡相反。2.11.4 优先于如果A优先于B，那么将B的起始日期自动设置为A的截至日期+延迟天数+1。2.11.5 跟随于问题B跟随于A（例如A截至于30/12，B开始于31/12），这时如果将A的截至日期延迟2天，那么B的起始和截至日期将自动推迟2天。合理使用跟踪者 新增问题、修改问题都可以添加问题发生变化时需要告知的人员 新增问题时是在跟踪者区域选择人员，修改问题时是在右侧快捷工具区 用户也可以自己来点跟踪按钮实现跟踪功能 通过问题的跟踪者功能来实现对多人的通知 问题有变化后会向所有跟踪者发送通知 跟踪者刚被添加进来后不能立即发送问题现状的邮件给他，必须要等问题有变化后他

16、才能开始收到通知2.12 增加问题需求 问题主题即问题的内容，要简洁，但一定要具体，让人能一眼看明白 对问题的详细描述，要尽量写全写细。提供的问题描述越清楚，就越容易被及时响应和修改。不要让负责人去猜测你的意图。如有可能尽量传图片上来（通过最后的文件功能）。最好指定目标版本，这样系统可以为你生成路线图和更新列表 最好指定类别（相当于博客的标签），问题增多时分类将大有帮助 新建问题前请确认已经选择了正确的项目。不要把本项目的问题创建到别的项目中去！项目名称显示在页面左上角! 如果新建问题时已经定下来由谁负责，那就在指派给那里选中他。 如果对问题的解决有时间限制 请务必写上开始时间和完成日期2.1

17、3 更新问题时机 负责人必须在有变化时及时更新问题 需要更新问题的几种情况： 提出的问题有误 需要添加说明 或者想要提出意见：注意把说明部分写清楚 问题状态变化时：例如状态变为已解决或者已关闭，完成度变为88等 负责人认为不能按照完成日期完成：可修改完成日期并把原因写入说明 负责人改变：修改指派给 登记工时：登记自己为此项目作出的工作。非常实用的功能，建议每个人都使用。不仅仅是对个人工作的认可，可用于管理者评价个人绩效。详细的工作量数据将为以后项目的估算提供坚实基础2.14 工作中问题编辑的要求2.14.1 如果工作有进展，问题的负责人务必及时更新问题的状态。如果问题解决完了，就把完成度选成1

18、00%并将 状态选成已关闭 ，同时写上说明 让关心的人知道问题被如何解决。 2.14.2 更新问题时不必修改指派给谁，因为负责人不会变来变去。创建问题的人、被指派的人、以及跟踪者都会同时收到问题通知。除非问题被错误的指派给你（这时应当将问题指派给创建者并说明原因） 2.14.3 问题解决完后一定要把状态选为关闭，完成度改成100不会自动关闭问题。2.14.4 问题关闭后才会在问题列表中隐藏 否则永远占着位置2.14.5 问题是一个过程，一定要有新建 -处理-反馈-完成-关闭这种类似流程的事情才应该使用问题来处理 2.14.6 文档的共享和保存应该使用文件或文档功能，而不是问题功能。2.14.7

19、 信息的共享和保存应该使用Wiki功能2.15 甘特图2.15.1 甘特图显示问题的起止日期以及版本的截至日期2.15.2 甘特图显示每个问题的进度2.15.3 如果定义了版本，甘特图会显示每个版本的结束时间2.15.4 可以导出到PDF2.16 日历2.16.1 日历提供了一个按月份显示的项目预览。 在这里你可以看到一个任务状态的起止日期。2.16.2 日历上显示的是每天开始的问题和结束的问题2.16.3 以比较直观的显 问题的进度 可以比较直观的显示问题的进度2.16.4 绿色的表示任务的创建日期，红色的表示任务的完成日期。2.17 新闻2.17.1 可以用来介绍项目的新进展2.17.2

20、最新的新闻也会显示系统首页和项目主页上2.17.3 右下角有RSS订阅按钮 2.17.4 详细信息只有点击了该新闻条目时才能看到2.18 文档2.18.1 与本项目相关的文档可以统一放在这里管理2.18.2 管理员可以增加文档的类别2.18.3 可以为文档添加说明2.18.4 一份文档可以包含多个文件2.18.5 在列表页上可以按照文档类别、日期、标题、作者进行排序 2.18.6 默认文档类别为“技术文档”、“用户文档”2.19 WIKI Redmine包含一个简单的Wiki系统 不需要会编写网页 可以很容易把各种资料做成网页形式分享 不比使用WORD更困难 所有有权限的用户都可以随时增加条目

21、或者编辑现有内容，实现协作创造 所有修改都有历史记录，并可还原至前面的某一版本 右侧连接可以查看所有条目的列表，并按照标题或者日期排序 可以包含附件，如图片等 提供丰富的格式，包括粗体、列表、超链接、嵌入的图片、代码语法高亮等因为创建和修改十分方便，因此不必等资料完善后才开始添加2.20 Wiki使用2.20.1 创建一个新的Wiki页面在任何一个wiki页面，仅仅需要添加一个你想要创建的新页面的链接。MyNewPage保存当前页面，点击刚添加的链接，恭喜：你已经成功创建了一个名为MyNewPage的新页面。2.20.2 保护wiki页面 如果你拥有保护wiki页面的权限，你可以点击锁定链接保

22、护该Wiki页面。 已经锁定的wiki页面只允许拥有保护wiki页面权限的用户编辑。 拥有此权限的用户同样可以为该页面解锁。2.20.3 Wiki页面的历史 Redmine保存每一次wiki页面的改动历史。 通过点击历史链接你可以浏览这些变更。 点击变更的序列号可查看某一个具体版本的页面信息。 你可以通过点击回退到这个版本的链接回退该页面到先前的版本。2.21 讨论区2.21.1 讨论区是用户可以任意发布各种信息、讨论、求助等内容的地方a.每个项目有自己的讨论区（1个或多个）b.管理员可以随时为项目添加或删除讨论区 c.需要在项目配置中新增讨论区才可以看见2.22 文件2.22.1 为用户提供

23、文件下载服务的地方2.22.2 按照版本分类 ? 按照版本分类2.22.3 可以上传与某个版本相关的各种文件2.22.4 文件大小限制：10M2.22.5 不要传过大文件，大文件应该放到其他地方保存2.23 版本库2.23.1 点击版本库选项卡, 你可以浏览项目的版本库以及最近的提交。 2.23.2 你可以通过打开目录前面的+按钮, 展开目录。2.23.3 你也可以点击目录链接进入该目录。2.23.4 点击某一修订号你可以查看该次提交的详细信息。2.23.5 想要浏览已知提交号的某一次提交的具体信息, 你可以将该提交号直接输入右上角的输入框里, 按回车键即可查看。 2.23.6 提交修订需要采

24、用SVN客户端，这里只提供web查看。 2.23.7 Redmine生成两种关于变更和修订数量的版本库图片。 一幅按月份显示变更和修订数量; 一幅按提交者显示变更和修订数量。2.23.8 修订 是版本库的提交次数, 显示为橘红色。2.23.9 变更 是对版本库中文件的修改次数, 显示为蓝色2.24 项目配置2.24.1 项目的配置界面，可以修改项目的各种参数 2.24.2 信息a.项目名称b.项目描述c.是否公开如果选中, 该项目将允许所有用户浏览, 包括非项目成员的用户。如果不选, 只有项目成员才有权限访问。f.跟踪标签在这里可以设置开启哪些跟踪标签, 默认可用的有三种: 错误, 功能和支持

25、。2.24.3 模块在这里可以设置该项目开启的功能模块2.24.4 成员在这里可以指定项目的成员, 以及他们的角色。2.25 项目配置22.25.1 版本项目版本可以对变更进行跟踪和计划。 你可以给问题指定目标版本, 然后在路线图中就能看到与该版本关联的问题列表。2.25.2 版本包括的属性:名称、描述、状态Wiki页面可以将该版本的主要事件写入Wiki里, 以供浏览该版本时显示 可选属性 。日期版本的完成日期 可选属性2.25.3 问题类别问题类别功能可以有效组织管理项目的问题。问题类别的属性:名字 必填字段指派给新建属于该类别的问题将自动指派给该项目成员 可选字段 。2.26 项目配置32.26.1 wiki每一个项目拥有它自己的wiki。2.26.2 版本库每一个项目能跟一个版本库(SCM)建立关联。 一旦版本库配置成功, 你就可以点击版本库选项卡, 浏览版本库的变更集了。 版本库的变更集也能在活动页面浏览到。2.26.3 讨论区每一个项目可以有一个或者多个讨论区。 讨论区的属性有:名称描述2.26.4 活动默认情况下, 活动阶段有开发和测试两种类型, 管理员可以根据需要创建新的活动阶段。只有选中的活动阶段才会出现在登记工时页面的下拉框中。3 SVN的使用4 项目过程使用建议一 正文部分