禪道使用手冊.doc

禪道使用說明禪道是第一款國產(chǎn)的優(yōu)秀開源項(xiàng)目管理軟件。它集產(chǎn)品管理、項(xiàng)目管理、質(zhì)量管理、文檔管理、組織管理和事務(wù)管理于一體，是一款功能完備的項(xiàng)目管理軟件，完美地覆蓋了項(xiàng)目管理的核心流程。先進(jìn)的管理思想，合理的軟件架構(gòu)，簡潔實(shí)效的操作，優(yōu)雅的代碼實(shí)現(xiàn)，靈活的擴(kuò)展機(jī)制，強(qiáng)大而易用的api調(diào)用機(jī)制，多語言支持，多風(fēng)格支持，搜索功能，統(tǒng)計(jì)功能。一、 系統(tǒng)概述禪道的功能列表：1.產(chǎn)品管理：包括產(chǎn)品、需求、計(jì)劃、發(fā)布、路線圖等功能。2. 項(xiàng)目管理：包括項(xiàng)目、任務(wù)、團(tuán)隊(duì)、build、燃盡圖等功能。3. 質(zhì)量管理：包括bug、測試用例、測試任務(wù)、測試結(jié)果等功能。4. 文檔管理：包括產(chǎn)品文檔庫、項(xiàng)目文檔庫、自定義文檔庫等功能。5. 事務(wù)管理：包括todo管理，我的任務(wù)、我的Bug、我的需求、我的項(xiàng)目等個(gè)人事務(wù)管理功能。6. 組織管理：包括部門、用戶、分組、權(quán)限等功能。7. 統(tǒng)計(jì)功能：豐富的統(tǒng)計(jì)表。8. 搜索功能：強(qiáng)大的搜索，幫助您找到相應(yīng)的數(shù)據(jù)。9. 靈活的擴(kuò)展機(jī)制，幾乎可以對禪道的任何地方進(jìn)行擴(kuò)展。10. 強(qiáng)大的api機(jī)制，方便與其他系統(tǒng)集成。禪道使用流程圖:二、 最簡使用說明禪道的定位不是簡單的任務(wù)管理軟件，而是專業(yè)的協(xié)同管理軟件。研發(fā)類的項(xiàng)目管理本身具有其復(fù)雜性，所以禪道提供的都是必備的功能。但這并不意味著必須按照禪道的流程來使用，完全可以按照自己的實(shí)際情況來使用禪道。下面將介紹使用禪道的最簡單方式。2.1 使用禪道來進(jìn)行項(xiàng)目任務(wù)管理2.1.1創(chuàng)建項(xiàng)目1) 進(jìn)入項(xiàng)目視圖，點(diǎn)擊右側(cè)的”新增項(xiàng)目“鏈接。 2) 出現(xiàn)項(xiàng)目添加的頁面在這個(gè)頁面設(shè)置項(xiàng)目名稱、代號、起止時(shí)間、可用工作日、團(tuán)隊(duì)名稱、項(xiàng)目目標(biāo)和項(xiàng)目描述等字段。其中關(guān)聯(lián)產(chǎn)品是可以為空的。2.1.2設(shè)置團(tuán)隊(duì)1) 點(diǎn)擊保存按鈕，會(huì)提示項(xiàng)目創(chuàng)建成功，然后可以選擇設(shè)置團(tuán)隊(duì)。2) 或者從項(xiàng)目視圖中的團(tuán)隊(duì)菜單，也可以進(jìn)行項(xiàng)目的團(tuán)隊(duì)管理。在維護(hù)項(xiàng)目團(tuán)隊(duì)的時(shí)候，需要選擇都是哪些用戶可以參與到這個(gè)項(xiàng)目中，同時(shí)需要設(shè)置這個(gè)用戶在本項(xiàng)目中的角色（角色可以隨便設(shè)置，比如風(fēng)清揚(yáng)，冬瓜一號等）。可用工作日和可用工時(shí)每天需要仔細(xì)設(shè)置。通常來講，一個(gè)人不可能每天8小時(shí)投入，也不可能一星期七天連續(xù)投入。3) 設(shè)置完畢之后，系統(tǒng)會(huì)自動(dòng)計(jì)算這個(gè)項(xiàng)目總得可用工時(shí)。2.1.3分解任務(wù)設(shè)置了團(tuán)隊(duì)之后，下一步操作就是創(chuàng)建任務(wù)。 在創(chuàng)建任務(wù)的時(shí)候，指派給是從項(xiàng)目團(tuán)隊(duì)成員中讀取。 姓名列表中的首字母可以用來快速篩選用戶。 任務(wù)的優(yōu)先級、預(yù)計(jì)工時(shí)（單位小時(shí)）都需要進(jìn)行設(shè)置。 如果需要設(shè)置任務(wù)必須在某一個(gè)時(shí)間點(diǎn)截止，可以設(shè)置截止日期。 可以上傳附件。2.1.4更新任務(wù)任務(wù)分解完畢之后，每個(gè)人就非常清楚自己做什么事情。所以項(xiàng)目啟動(dòng)之后，對于項(xiàng)目團(tuán)隊(duì)的成員來講，他要做的事情就是更新任務(wù)的狀態(tài)。1) 任務(wù)的列表在任務(wù)的列表頁面，可以看到系統(tǒng)中所有的任務(wù)列表，可以通過各種標(biāo)簽方便的進(jìn)行篩選。點(diǎn)擊某一個(gè)任務(wù)的鏈接進(jìn)入詳情頁面。2) 任務(wù)的詳情頁面在任務(wù)的詳情頁面可以看到任務(wù)的詳細(xì)信息，包括歷次的修改記錄等信息。同時(shí)也給出了各種操作的按鈕。3) 開始任務(wù)。開始某一個(gè)任務(wù)的時(shí)候，可以設(shè)置已經(jīng)消耗的時(shí)間和預(yù)計(jì)剩余的時(shí)間。單位都是工時(shí)。4) 完成任務(wù)。完成任務(wù)的時(shí)候，需要設(shè)置下已經(jīng)消耗的時(shí)間。2.1.5驗(yàn)證關(guān)閉任務(wù)任務(wù)完成之后，會(huì)自動(dòng)指派給任務(wù)的創(chuàng)建者，這時(shí)候任務(wù)的創(chuàng)建者可以驗(yàn)證任務(wù)是否完成。如果完成，則可以將其關(guān)閉。這件任務(wù)就結(jié)束了。2.2 只使用禪道來做bug管理測試禪道的測試功能也可以獨(dú)立出來單獨(dú)使用。這種方式很適合于測試團(tuán)隊(duì)使用。禪道里面的bug最基本流程是：測試人員提出bug - 開發(fā)人員解決bug - 測試人員驗(yàn)證關(guān)閉。2.2.1創(chuàng)建產(chǎn)品使用bug管理功能之前，需要先創(chuàng)建產(chǎn)品。禪道里面設(shè)計(jì)的理念是bug主要附屬在產(chǎn)品概念下面的，后面我們會(huì)詳細(xì)講述產(chǎn)品和項(xiàng)目之間的關(guān)系。新增產(chǎn)品的時(shí)候，需要設(shè)置產(chǎn)品的名稱、代碼，幾個(gè)負(fù)責(zé)人信息。2.2.2提出bug有了產(chǎn)品之后，我們就可以來創(chuàng)建bug了。 在創(chuàng)建bug的時(shí)候，必填的字段是影響版本，bug標(biāo)題，重現(xiàn)步驟這些基本的信息。 所屬項(xiàng)目，相關(guān)產(chǎn)品，需求可以忽略。 創(chuàng)建bug的時(shí)候，可以直接指派給某一個(gè)人員去處理。如果不清楚的話，可以保留為空。2.2.3解決bug當(dāng)一個(gè)bug指派給某一位研發(fā)人員之后，他可以來驗(yàn)證解決這個(gè)bug。1) 通過各種標(biāo)簽和檢索條件找到需要自己處理的bug在對bug進(jìn)行出來之前，需要先要找到需要自己處理的bug。禪道提供了各種各樣的檢索方式，比如指派給我，可以列出所有需要我處理的bug。1) 解決bug研發(fā)人員解決bug，選擇解決方案，一般來講有效的解決bug方案是”已解決“。詳細(xì)的解決方案，我們在后續(xù)的文章中會(huì)詳細(xì)加以講述。2.2.4關(guān)閉bug當(dāng)研發(fā)人員解決了bug之后，bug會(huì)重新指派到bug的創(chuàng)建者頭上。這時(shí)候測試人員可以來驗(yàn)證這個(gè)bug是否已經(jīng)修復(fù)。如果驗(yàn)證通過，則可以關(guān)閉該bug。三、 進(jìn)階使用說明3.1使用流程3.1.1 禪道使用流程圖解在禪道項(xiàng)目管理軟件中，核心的角色有產(chǎn)品經(jīng)理、項(xiàng)目經(jīng)理、研發(fā)團(tuán)隊(duì)和測試團(tuán)隊(duì)四種角色。如果您現(xiàn)在的團(tuán)隊(duì)是采用敏捷開發(fā)的話，那么可以對應(yīng)到product owner, scrum master和team(dev and tester)。這幾種角色之間緊緊圍繞產(chǎn)品的需求展開協(xié)作，取得成果。禪道核心的管理流程全圖如下所示：3.2產(chǎn)品經(jīng)理篇3.2.1 維護(hù)產(chǎn)品產(chǎn)品管理對于公司來講，至關(guān)重要。只有做出好的產(chǎn)品或者服務(wù)出來，才能贏得市場，謀求發(fā)展和生存。所以產(chǎn)品經(jīng)理的這個(gè)位子對于公司來講，是非常關(guān)鍵的，相當(dāng)于公司的大腦，在決定著公司前進(jìn)的方向。在禪道里面，產(chǎn)品和項(xiàng)目這兩個(gè)概念被明確的區(qū)分開來。產(chǎn)品是需求方，決定做什么。項(xiàng)目是執(zhí)行方，解決的是如何做的問題。而測試則是保障方，解決的是正確的做事情的問題。所以在禪道中，所有的一切都是圍繞產(chǎn)品展開的。產(chǎn)品是整個(gè)項(xiàng)目管理活動(dòng)的核心。3.2.1.1創(chuàng)建產(chǎn)品1) 用產(chǎn)品經(jīng)理的角色登錄禪道。2) 進(jìn)入產(chǎn)品視圖，然后點(diǎn)擊頁面右側(cè)的“新增產(chǎn)品”鏈接，即可出現(xiàn)新增產(chǎn)品的頁面。3) 如果系統(tǒng)中還沒有添加產(chǎn)品，系統(tǒng)也會(huì)自動(dòng)跳轉(zhuǎn)到產(chǎn)品的添加頁面。添加產(chǎn)品時(shí)需要注意的地方： 產(chǎn)品代號相當(dāng)于大家對這個(gè)產(chǎn)品的一個(gè)隱喻，比如禪道項(xiàng)目管理軟件的代碼是zentao。 產(chǎn)品負(fù)責(zé)人負(fù)責(zé)整理和解釋整個(gè)產(chǎn)品的需求，制定相應(yīng)的發(fā)布計(jì)劃。 測試負(fù)責(zé)人，可以指定默認(rèn)的測試負(fù)責(zé)人。這樣可以適用于公司人比較多，提交bug不知道該給誰的情況。 發(fā)布負(fù)責(zé)人主要的職責(zé)是創(chuàng)建發(fā)布。 訪問控制，則可以控制訪問該產(chǎn)品的人員列表。比如可以將某一個(gè)產(chǎn)品設(shè)為私有，只有產(chǎn)品添加者、產(chǎn)品負(fù)責(zé)人、測試負(fù)責(zé)人、發(fā)布負(fù)責(zé)人以及該產(chǎn)品的項(xiàng)目團(tuán)隊(duì)才可以訪問。我們產(chǎn)品經(jīng)理可能都習(xí)慣了寫需求設(shè)計(jì)文檔，或者規(guī)格說明書，通過一個(gè)非常完整的word文檔將某一個(gè)產(chǎn)品的需求都定義出來。但在禪道里面，我們提倡 按照功能點(diǎn)的方式來寫需求。簡單來講，就是將原來需求設(shè)計(jì)文檔中的每一個(gè)功能點(diǎn)摘出來，錄在禪道里面，作為一個(gè)個(gè)獨(dú)立的功能點(diǎn)。如果按照scrum標(biāo)準(zhǔn)走 的話，我們可以稱之為用戶故事(user story)。所謂用戶故事，就是來描述一件事情，作為什么用戶，希望如何，這樣做的目的或者價(jià)值何在，這樣有用戶角色，有行為，也有目的和價(jià)值所在，非常方便與團(tuán)隊(duì)成員進(jìn)行溝通。 3.2.2 創(chuàng)建和評審需求3.2.2.1創(chuàng)建需求1) 使用產(chǎn)品經(jīng)理角色登錄系統(tǒng)。2) 進(jìn)入產(chǎn)品視圖。3) 在頁面右側(cè)，有“新增需求”菜單，點(diǎn)擊菜單，出現(xiàn)新增需求的頁面。o 需求的標(biāo)題是必填項(xiàng)。o 所屬計(jì)劃和模塊，可以暫時(shí)保留為空。o 需求審核那塊，我們選上不需要審核，這樣新創(chuàng)建的需求狀態(tài)就是激活的。只有激活狀態(tài)的需求才能關(guān)聯(lián)到項(xiàng)目中，進(jìn)行開發(fā)。o 需求可以設(shè)置抄送給字段，這樣需求的變化都可以通過email的形式抄送給相關(guān)人員。o 可以設(shè)置關(guān)鍵詞，這樣可以比較方便的通過關(guān)鍵詞進(jìn)行檢索。3.2.2.2評審需求在創(chuàng)建需求的時(shí)候，有一個(gè)不需要評審的復(fù)選框，如果選中該復(fù)選框的話，需求的創(chuàng)建是激活中的。但大部分情況下面，需求還是需要評審的。即使產(chǎn)品完全有一個(gè)人負(fù)責(zé)，也可以將一些不成熟的想法存為草稿，后續(xù)再進(jìn)行處理。新增需求的評審流程如下：下面我們來看下具體的需求評審頁面： 評審結(jié)果可以選擇確認(rèn)通過、有待明確、拒絕等操作。如果選擇“確認(rèn)通過”，則需求的狀態(tài)改為“激活中”，然后就可以關(guān)聯(lián)到項(xiàng)目中進(jìn)行開發(fā)了。 如果選擇“有待明確”，會(huì)保持需求的草稿狀態(tài)，并將需求指派回需求的創(chuàng)建者頭上，有其繼續(xù)進(jìn)行完善。 如果選擇了“拒絕”，則需要給出相應(yīng)的拒絕原因，拒絕原因可以有： 由誰評審是記錄的參與評審的人員名單，可以輸入用戶名來自動(dòng)篩選。一般來講需求評審可以是一個(gè)線下的評審會(huì)議，在禪道里面記錄下參與需求評審的人員即可。3.2.3 變更和評審需求變更是需求管理必不可少的流程，禪道項(xiàng)目管理軟件對需求的變更提供了全面的支持。其實(shí)需求的變更并不可怕，但不清楚影響范圍的變更是很可怕的。在傳統(tǒng)項(xiàng)目管理中，由于沒有有力工具的支撐，產(chǎn)品經(jīng)理在變更需求的時(shí)候，無法知曉該需求的影響范圍，會(huì)有很大的隨意性。禪道項(xiàng)目管理軟件將需求、任務(wù)、bug和用例都納入為一體管理，就可以很清楚的知曉變更的影響范圍，從而給產(chǎn)品經(jīng)理更好的指導(dǎo)。禪道里面需求變更的基本流程如下：下面我們來看下具體的操作：3.2.3.1變更需求禪道專門提供了需求的變更流程。凡是對需求標(biāo)題、描述、驗(yàn)證標(biāo)準(zhǔn)和附件的修改，都應(yīng)該走變更流程。變更之后的需求狀態(tài)為變更中。 編輯操作是無法修改需求的標(biāo)題、描述、驗(yàn)收標(biāo)準(zhǔn)和附件的。 在變更需求的時(shí)候，如果選擇了“不需要評審”，則需求狀態(tài)自動(dòng)變成激活，不需要再走評審流程。 在變更需求的時(shí)候，會(huì)列出該需求的影響范圍：3.2.3.2評審需求1) 通過需求的詳情頁面查看變更前后的變化 2) 評審需求，給出評審結(jié)果 評審結(jié)果可以選擇確認(rèn)通過，撤銷變更，有待明確或者拒絕。如果選擇確認(rèn)通過，則需求的狀態(tài)從“已變更”變?yōu)椤凹せ钪小薄?如果選擇撤銷變更，則取消當(dāng)前的變更，并回退到之前的版本。 如果選擇有待明確，需求被打回到需求的變更者，繼續(xù)進(jìn)行完善。 如果選擇拒絕，則需要給出相應(yīng)的拒絕原因。 同樣在評審需求的時(shí)候，也會(huì)列出相應(yīng)的影響范圍，評審者可以參考。3.2.3.3確認(rèn)需求變更當(dāng)需求變更被確認(rèn)之后，研發(fā)團(tuán)隊(duì)和測試人員需要確認(rèn)需求的變更。1) 任務(wù)確認(rèn)需求變動(dòng)：2) 缺陷確認(rèn)需求變動(dòng)3) 用例確認(rèn)需求變動(dòng)3.2.4 需求的狀態(tài)和研發(fā)階段禪道軟件設(shè)計(jì)的需求有兩個(gè)字段來跟蹤它的變化，一個(gè)是需求的狀態(tài)字段，一個(gè)是需求的研發(fā)階段字段，下面來看下這兩個(gè)字段。3.2.4.1需求的狀態(tài)需求狀態(tài)(status)字段，總共有四種狀態(tài)，分別是草稿(draft)、激活(active)、已變更(changed)和已關(guān)閉(closed)。對應(yīng)為需求的流程操作共有：創(chuàng)建、變更、審核、關(guān)閉、激活，其狀態(tài)流轉(zhuǎn)圖如下：3.2.4.2需求的研發(fā)階段 需求還有一個(gè)階段(stage)字段，用來描述激活的需求在研發(fā)過程中所處的階段。目前總共有等待、已計(jì)劃、已立項(xiàng)、開發(fā)中、開發(fā)完畢、測試中、測試完畢、已驗(yàn)收、已發(fā)布。那么需求的研發(fā)階段是如何變化的呢？一種方案是通過編輯操作，來修改研發(fā)階段。但我們更提倡另外一種方案，就是在創(chuàng)建任務(wù)的時(shí)候，仔細(xì)設(shè)置任務(wù)的類型，比如開發(fā)，測試。禪道的程序會(huì)自動(dòng)根據(jù)不同類型任務(wù)的變化來自動(dòng)計(jì)算需求的研發(fā)階段，其規(guī)則如下：1) 如果需求沒有關(guān)聯(lián)到項(xiàng)目，也沒有關(guān)聯(lián)到計(jì)劃，則需求的研發(fā)階段是等待。2) 如果需求關(guān)聯(lián)到了計(jì)劃，還沒有關(guān)聯(lián)到項(xiàng)目中，則需求的研發(fā)階段是已計(jì)劃。3) 如果需求關(guān)聯(lián)到了項(xiàng)目中，但還沒有分解任務(wù)，則需求的研發(fā)階段是已立項(xiàng)。4) 如果需求關(guān)聯(lián)到了項(xiàng)目中，且進(jìn)行了任務(wù)分解:如果有一個(gè)開發(fā)任務(wù)進(jìn)行中，并且所有的測試任務(wù)還沒有開始，需求的研發(fā)階段為“研發(fā)中”。如果所有的開發(fā)任務(wù)已經(jīng)完成，并且所有的測試任務(wù)還沒有開始，則為“研發(fā)完畢”。如果有一個(gè)測試任務(wù)進(jìn)行中，則視為“測試中”。如果所有的測試任務(wù)已經(jīng)結(jié)束，但還有一些開發(fā)任務(wù)沒有結(jié)束，則視為測試中。如果所有的測試任務(wù)已經(jīng)結(jié)束，并且所有的開發(fā)任務(wù)已經(jīng)結(jié)束，則視為測試完畢。5) 驗(yàn)收階段是需要產(chǎn)品經(jīng)理手工來進(jìn)行確認(rèn)的。6) 如果需求關(guān)閉，且關(guān)閉原因是“已發(fā)布”， 則需求的研發(fā)階段是“已發(fā)布”。3.2.5 建立發(fā)布計(jì)劃古人云，凡事預(yù)則立，不預(yù)則廢。產(chǎn)品需要做規(guī)劃，才能有輕重緩急，才能正確的做事。因此對于產(chǎn)品經(jīng)理而言，計(jì)劃是必需的。 對于產(chǎn)品經(jīng)理自己而言，發(fā)布計(jì)劃可以幫助他規(guī)劃產(chǎn)品，制定發(fā)布的節(jié)奏，調(diào)整需求的優(yōu)先級。 對于公司其他部門的同事以及外部的客戶而言，發(fā)布計(jì)劃可以讓他們知曉產(chǎn)品的進(jìn)展情況，以便做好相應(yīng)的安排。 同時(shí)在項(xiàng)目關(guān)聯(lián)需求的時(shí)候，計(jì)劃可以幫助需求的關(guān)聯(lián)。3.2.5.1創(chuàng)建計(jì)劃1) 進(jìn)入產(chǎn)品視圖，選擇某一個(gè)產(chǎn)品。2) 點(diǎn)擊“計(jì)劃列表”3) 出現(xiàn)計(jì)劃列表頁面，點(diǎn)擊頁面右側(cè)的“創(chuàng)建計(jì)劃”，即可出現(xiàn)計(jì)劃增加頁面。 3.2.5.2關(guān)聯(lián)需求創(chuàng)建完計(jì)劃之后，可以為計(jì)劃關(guān)聯(lián)需求也可以在添加需求的時(shí)候指定計(jì)劃(已經(jīng)過期的計(jì)劃不會(huì)列出)3.2.5.3計(jì)劃和項(xiàng)目之間的關(guān)系禪道軟件中并沒有對計(jì)劃和項(xiàng)目并沒有非常強(qiáng)的對應(yīng)關(guān)系。如果某一個(gè)開發(fā)團(tuán)隊(duì)的計(jì)劃和執(zhí)行都非常好，那么一個(gè)計(jì)劃可以對應(yīng)一個(gè)項(xiàng)目。但這是非常理想的狀態(tài)。一般情況下面是這樣，在項(xiàng)目關(guān)聯(lián)需求的時(shí)候，大部分的需求都關(guān)聯(lián)自一個(gè)計(jì)劃，但同時(shí)也關(guān)聯(lián)了其他計(jì)劃的部分需求。3.2.6 建立發(fā)布項(xiàng)目結(jié)束后產(chǎn)品人員的一個(gè)工作就是創(chuàng)建發(fā)布，通過創(chuàng)建發(fā)布，可以告訴公司其他相關(guān)的部門，他們可以在新版本產(chǎn)品的基礎(chǔ)上開展工作。同時(shí)也是鼓舞團(tuán)隊(duì)士氣非常好的一個(gè)手段。3.2.6.1創(chuàng)建發(fā)布的前提創(chuàng)建發(fā)布有兩個(gè)前提：1) 該產(chǎn)品有關(guān)聯(lián)過項(xiàng)目。2) 該項(xiàng)目有創(chuàng)建過版本。3.2.6.2如何創(chuàng)建發(fā)布1) 進(jìn)入產(chǎn)品視圖，選擇發(fā)布列表。2) 然后點(diǎn)擊“創(chuàng)建發(fā)布”，即可出現(xiàn)創(chuàng)建發(fā)布的頁面。 選擇了版本之后，系統(tǒng)會(huì)自動(dòng)計(jì)算這個(gè)版本所對應(yīng)的項(xiàng)目中完成的需求和解決的bug，可以進(jìn)行關(guān)聯(lián)選擇。 如果系統(tǒng)自動(dòng)計(jì)算的需求和bug不完整，可以在描述字段里面補(bǔ)充。5.2.7 文檔管理禪道軟件內(nèi)置了基本的文檔管理功能，這樣禪道沒有覆蓋到的流程就可以通過文檔管理功能來補(bǔ)充。禪道文檔庫共分為三種類型：產(chǎn)品文檔庫、項(xiàng)目文檔庫和自定義文檔庫。其中產(chǎn)品文檔庫用來存儲(chǔ)產(chǎn)品層面產(chǎn)生的文檔，項(xiàng)目文檔庫用來存儲(chǔ)項(xiàng)目過程中產(chǎn)生的文檔。自定義文檔庫則可以用來存儲(chǔ)知識庫、公司管理規(guī)范等文檔。下面讓我們來看下具體的操作。3.2.7.1維護(hù)分類1) 進(jìn)入文檔視圖。2) 選擇產(chǎn)品文檔庫。3) 然后選擇頁面下方的“維護(hù)分類”鏈接，即可出現(xiàn)維護(hù)分類的的頁面。3.2.7.2添加文檔在產(chǎn)品視圖，點(diǎn)擊頁面右側(cè)的“創(chuàng)建文檔”，即可進(jìn)入文檔的創(chuàng)建頁面。 文檔共有文件、鏈接和網(wǎng)頁三種類型。 文件類型的文檔可以上傳一個(gè)附件。 鏈接類型的文檔可以是一個(gè)網(wǎng)頁鏈接。 網(wǎng)頁型的文檔可以直接使用富文本編輯器撰寫。3.2.7.3瀏覽文檔文檔添加之后，可以在文檔庫里面查看相應(yīng)的文檔列表。也可以在產(chǎn)品視圖的文檔庫里面查看這個(gè)產(chǎn)品下面的所有文檔。3.3項(xiàng)目經(jīng)理篇3.3.1 建立項(xiàng)目3.3.1.1創(chuàng)建項(xiàng)目1) 進(jìn)入項(xiàng)目視圖，點(diǎn)擊右側(cè)的”新增項(xiàng)目“鏈接。 2) 出現(xiàn)項(xiàng)目添加的頁面在這個(gè)頁面設(shè)置項(xiàng)目名稱、代號、起止時(shí)間、可用工作日、團(tuán)隊(duì)名稱、項(xiàng)目目標(biāo)和項(xiàng)目描述等字段。其中關(guān)聯(lián)產(chǎn)品是可以為空的。注意事項(xiàng)：1. 項(xiàng)目代號是一種隱喻，也就是團(tuán)隊(duì)內(nèi)部可以互相了解和知曉，比如禪道項(xiàng)目曾經(jīng)使用過“opensesame來作為項(xiàng)目的代號。2. 團(tuán)隊(duì)名稱，可以自己定義，比如叫做“禪道開發(fā)團(tuán)隊(duì)”等等。3. 在添加項(xiàng)目的時(shí)候，可以選擇關(guān)聯(lián)與之相關(guān)的產(chǎn)品，以便后續(xù)進(jìn)行需求的關(guān)聯(lián)。4. 項(xiàng)目可以控制它的訪問權(quán)限，分為默認(rèn)、私有和自定義白名單三種。3.3.2 組建項(xiàng)目團(tuán)隊(duì)項(xiàng)目組建之后要做的事情就是設(shè)置團(tuán)隊(duì)。很多朋友經(jīng)常問，為什么我在創(chuàng)建任務(wù)的時(shí)候，只能指派給自己呢？其實(shí)原因很簡單，是因?yàn)闆]有設(shè)置團(tuán)隊(duì)。當(dāng)項(xiàng)目創(chuàng)建成功之后，可以根據(jù)提示設(shè)置團(tuán)隊(duì)?；蛘邚捻?xiàng)目視圖中的團(tuán)隊(duì)菜單，也可以進(jìn)行項(xiàng)目的團(tuán)隊(duì)管理。在維護(hù)項(xiàng)目團(tuán)隊(duì)的時(shí)候，需要選擇都是哪些用戶可以參與到這個(gè)項(xiàng)目中，同時(shí)需要設(shè)置這個(gè)用戶在本項(xiàng)目中的角色（角色可以隨便設(shè)置，比如風(fēng)清揚(yáng)，冬瓜一號等）?？捎霉ぷ魅蘸涂捎霉r(shí)每天需要仔細(xì)設(shè)置。通常來講，一個(gè)人不可能每天8小時(shí)投入，也不可能一星期七天連續(xù)投入。設(shè)置完畢之后，系統(tǒng)會(huì)自動(dòng)計(jì)算這個(gè)項(xiàng)目總得可用工時(shí)。當(dāng)團(tuán)隊(duì)設(shè)置完畢之后，整個(gè)項(xiàng)目的可用資源就已經(jīng)確定了：起止時(shí)間確定了，參與的人員也確定了。下面就是來確定項(xiàng)目中要做的事情了。3.3.3 確定項(xiàng)目要完成的需求列表項(xiàng)目團(tuán)隊(duì)組建完畢之后，接下來要做的一個(gè)工作就是確定這期項(xiàng)目要做的需求。這項(xiàng)任務(wù)其實(shí)是整個(gè)團(tuán)隊(duì)，包括產(chǎn)品在內(nèi)，共同完成的。3.3.3.1關(guān)聯(lián)產(chǎn)品如果在創(chuàng)建項(xiàng)目的時(shí)候，已經(jīng)關(guān)聯(lián)過產(chǎn)品，可以忽略這個(gè)步驟。1) 以項(xiàng)目經(jīng)理身份登錄。2) 進(jìn)入項(xiàng)目視圖。3) 點(diǎn)擊“關(guān)聯(lián)產(chǎn)品”按鈕。然后點(diǎn)選該項(xiàng)目相關(guān)的產(chǎn)品即可。3.3.3.2關(guān)聯(lián)需求1) 在關(guān)聯(lián)需求的時(shí)候，可以按照優(yōu)先級進(jìn)行排序。2) 關(guān)聯(lián)的需求狀態(tài)必須是激活的（評審?fù)ㄟ^，不能是草稿）3.3.4 組織進(jìn)行任務(wù)分解需求確定之后，項(xiàng)目中幾個(gè)關(guān)鍵的因素都有了：周期確定、資源確定、需求確定。下面我們要做的事情就是為每一個(gè)需求做wbs任務(wù)分解，生成完成這個(gè)需求的所有的任務(wù)。 3.3.4.1訪問項(xiàng)目的需求列表頁面： 在項(xiàng)目的需求列表頁面，可以很方便地對某一個(gè)需求進(jìn)行任務(wù)分解。 同時(shí)還可以查看這個(gè)需求已經(jīng)分解的任務(wù)數(shù)。3.3.4.2分解任務(wù) 這時(shí)候創(chuàng)建任務(wù)的時(shí)候，就可以選擇需求了。 我們同時(shí)提供了需求查看的鏈接。 如果需求和任務(wù)的標(biāo)題是一樣的，可以通過”同需求“按鈕快捷的復(fù)制需求的標(biāo)題。3.3.4.3任務(wù)分解的幾個(gè)注意事項(xiàng)1) 需要將所有的任務(wù)都分解出來。這里面包括設(shè)計(jì)，開發(fā)，測試，美工，甚至包括購買機(jī)器，部署測試環(huán)境等等。2) 任務(wù)分解的粒度越小越好，比如幾個(gè)小時(shí)就可以完成。3) 如果一個(gè)任務(wù)需要多個(gè)人負(fù)責(zé)，繼續(xù)考慮將其拆分。4) 事務(wù)型的事務(wù)可以批量指派，比如需要讓團(tuán)隊(duì)里面的每一個(gè)人都寫個(gè)項(xiàng)目總結(jié)，可以選擇類型是事務(wù)，然后批量指派給團(tuán)隊(duì)里面的所有人員。5) 任務(wù)的類型請仔細(xì)設(shè)置，這個(gè)會(huì)涉及到需求研發(fā)階段的自動(dòng)計(jì)算。后面我們會(huì)有講解。6) 任務(wù)的分配最好是自由領(lǐng)取，這樣可以最大程度上調(diào)動(dòng)大家的積極性。7) 任務(wù)的分解最好是由團(tuán)隊(duì)共同完成，不要由項(xiàng)目經(jīng)理一人包辦。3.4開發(fā)團(tuán)隊(duì)篇3.4.1 領(lǐng)取任務(wù)，并每天更新任務(wù)當(dāng)項(xiàng)目的任務(wù)分解完畢之后，項(xiàng)目團(tuán)隊(duì)成員需要領(lǐng)取自己喜歡做的任務(wù)，開始每天的開發(fā)。除了日常的編碼工作之外，還應(yīng)當(dāng)每天花點(diǎn)時(shí)間在禪道里面更新下任務(wù)的狀態(tài)以及消耗情況。3.4.1.1領(lǐng)取任務(wù)領(lǐng)取任務(wù)可以通過兩種方式，一種是通過“指派”操作，一種是通過“編輯”操作。3.4.1.2更新任務(wù)狀態(tài)項(xiàng)目開始之后，每個(gè)人每天應(yīng)當(dāng)及時(shí)更新自己所負(fù)責(zé)的任務(wù)的狀態(tài)。禪道提供了幾個(gè)快捷的操作按鈕：開始、完成、關(guān)閉、取消和激活。開始、完成和取消沒有什么歧義。解釋下關(guān)閉和激活。禪道有一個(gè)可選流程，就是當(dāng)任務(wù)完成之后，會(huì)自動(dòng)指派回任務(wù)的創(chuàng)建者頭上，這時(shí)候任務(wù)的創(chuàng)建者可以驗(yàn)證任務(wù)是否完成。如果完成，則將任務(wù)關(guān)閉。如果任務(wù)沒有完成，則激活任務(wù)。這個(gè)流程是可選的，不是必須的流程。適用于傳統(tǒng)的命令-控制式的管理。如果對于敏捷開發(fā)團(tuán)隊(duì)來講，忽略這個(gè)流程即可。3.4.1.3更新任務(wù)的消耗除了更新自己負(fù)責(zé)任務(wù)的狀態(tài)之外，還應(yīng)該及時(shí)更新任務(wù)的工時(shí)消耗情況：最初預(yù)計(jì)，即創(chuàng)建任務(wù)的時(shí)候的最初預(yù)計(jì)。該字段在任務(wù)開始之后，不應(yīng)該再進(jìn)行修改。這個(gè)字段當(dāng)任務(wù)結(jié)束之后，可以和已經(jīng)消耗字段進(jìn)行對比，以糾正自己的估計(jì)。已經(jīng)消耗，則是你在這個(gè)任務(wù)上所有花費(fèi)的工時(shí)數(shù)。預(yù)計(jì)剩余，則是你預(yù)計(jì)這個(gè)任務(wù)完成大約還需要多少時(shí)間。如果預(yù)計(jì)剩余為0，則表示任務(wù)完成。這里面需要特別強(qiáng)調(diào)的是，最初預(yù)計(jì) 已經(jīng)消耗 + 預(yù)計(jì)剩余。一定要每天更新自己所負(fù)責(zé)的任務(wù)，因?yàn)槿急M圖的繪制，就是通過預(yù)計(jì)剩余這個(gè)字段來計(jì)算的。3.4.2 創(chuàng)建版本當(dāng)完成若干功能之后，就可以創(chuàng)建版本了。版本的概念在英文里面是build，可以對應(yīng)到軟件配置管理的范疇。這是一個(gè)可選流程，但還是建議團(tuán)隊(duì)能夠?qū)嵤┌姹竟芾怼＿@個(gè)版本主要的作用在于明確測試的范疇，方便測試人員和開發(fā)人員的互動(dòng)，以及解決不同版本的發(fā)布和bug修復(fù)等問題。流程如下：1) 首先是團(tuán)隊(duì)經(jīng)過開發(fā)，完成了若干需求，或者解決了一些bug。2) 這時(shí)候某一位發(fā)布負(fù)責(zé)人在subversion中創(chuàng)建了一個(gè)tag(標(biāo)簽)，比如禪道的tag目錄如下：3) 創(chuàng)建了tag之后，這位發(fā)布負(fù)責(zé)人就可以在禪道里面創(chuàng)建一個(gè)版本了。說明：1) 名稱編號，團(tuán)隊(duì)?wèi)?yīng)該有自己的配置管理規(guī)范。比如可以是產(chǎn)品名_版本號_狀態(tài)(stble, beta之類)_日期2) 不同開發(fā)語言其版本的存在形式也不同，有的需要編譯，有的只需要源代碼。請根據(jù)公司的實(shí)際情況來填寫源代碼地址，或者是存儲(chǔ)地址。3) 在創(chuàng)建版本的時(shí)候，可選擇這次版本完成的功能和解決的bug。這樣提交給測試人員進(jìn)行測試的時(shí)候，就可以明確這次測試的范疇，測試可以更加有針對性。4) 描述字段可以填寫一些測試的注意事項(xiàng)、重點(diǎn)內(nèi)容等。3.4.3 申請測試當(dāng)版本創(chuàng)建完畢之后，就可以提交給測試人員進(jìn)行測試了，提交測試會(huì)生成一個(gè)測試任務(wù)。在這兒需要和大家解釋下這個(gè)測試任務(wù)的概念。其實(shí)英文里面里面比較合適的單位是testrun，但翻譯到中文里面沒有太貼切的詞語，我們暫時(shí)用了測試任務(wù)的概念。但這個(gè)測試任務(wù)和項(xiàng)目里面創(chuàng)建的類型為“測試”的任務(wù)沒有直接關(guān)聯(lián)。請大家在使用的時(shí)候，注意這個(gè)細(xì)節(jié)。一般來講，我們在分解任務(wù)的時(shí)候，可以創(chuàng)建若干測試類型的任務(wù)，比如測試某某，測試某某，大概估計(jì)下測試需要的時(shí)間。然后具體的測試工作通過測試視圖的測試任務(wù)來跟蹤。申請測試的步驟：1) 進(jìn)入項(xiàng)目視圖，點(diǎn)擊“測試申請”。2) 然后選擇“提交測試”，即可出現(xiàn)提交測試的頁面。說明：1) 負(fù)責(zé)人為本次測試的負(fù)責(zé)人。2) 可以指定這次測試預(yù)計(jì)起止的時(shí)間。3) 任務(wù)描述里面，可以注明此次測試需要注意的地方。4) 還需要說明的一點(diǎn)是，目前測試任務(wù)還沒有指派的功能，所以需要大家線下通知測試團(tuán)隊(duì)的負(fù)責(zé)人，由他來負(fù)責(zé)組織相應(yīng)人員來進(jìn)行測試。3.4.4 解決bug提交測試之后，測試人員展開測試，便會(huì)有bug產(chǎn)生。這時(shí)候研發(fā)團(tuán)隊(duì)的一個(gè)重要職責(zé)便是解決bug。禪道里面bug的處理流程比較簡單：測試人員提交bug = 開發(fā)人員解決bug = 測試人員驗(yàn)證關(guān)閉，這是比較正常的流程。還有一個(gè)流程是激活流程：測試人員提交bug = 開發(fā)人員解決bug = 測試人員驗(yàn)證未通過 = 激活bug = 重新解決 =驗(yàn)證關(guān)閉。開發(fā)人員所需要做的事情便是處理自己負(fù)責(zé)bug，并在禪道中登記解決方案：1) 項(xiàng)目視圖中的bug列表2) bug的詳情頁面也可以找到“解決”操作的按鈕。3) 解決bug的時(shí)候，需要填寫bug的解決方案。附：bug的解決方案禪道軟件總共提供了其中解決方案：bydesign = 設(shè)計(jì)如此，無需改動(dòng)。duplicate = 重復(fù)Bug，以前已經(jīng)有同樣的bug。external = 外部原因，非本系統(tǒng)原因。fixed = 已解決;notrepro = 無法重現(xiàn)，無非重現(xiàn)bug。postponed = 延期處理，確實(shí)是bug，但現(xiàn)在不解，放在以后。willnotfix = 不予解決這其中“已解決”和“延期”的bug視為有效bug。3.4.5 文檔管理敏捷開發(fā)不提倡面面俱到的文檔，但必要的文檔還是很有必要的，比如數(shù)據(jù)庫的設(shè)計(jì)文檔、接口文檔、測試總結(jié)報(bào)告等等。具體文檔庫的使用，請參考：產(chǎn)品經(jīng)理篇中的文檔管理。3.4.6 確認(rèn)bug當(dāng)測試人員提交了bug之后，如果開發(fā)人員來不及解決這個(gè)bug，這時(shí)候可選的一個(gè)操作是確認(rèn)這個(gè)bug，給測試人員一個(gè)反饋。bug列表頁面會(huì)顯示是否已經(jīng)確認(rèn)過。bug詳情頁面有確認(rèn)操作按鈕。需要說明的是，如果一個(gè)bug被解決之后，也會(huì)自動(dòng)變成已確認(rèn)。3.5測試團(tuán)隊(duì)篇3.5.1 維護(hù)bug視圖模塊在禪道軟件中，bug也同樣需要維護(hù)模塊，以便更好的組織管理bug。這個(gè)地方需要特別說明下，bug模塊、用例模塊和產(chǎn)品模塊是獨(dú)立的，每個(gè)視圖都有自己的模塊。為什么這樣做呢？主要是考慮到使用的角色不同。在產(chǎn)品視圖里面，主要是用來組織需求。而在bug模塊，則主要偏重bug管理，那么可能會(huì)有和產(chǎn)品視圖不同的模塊劃分。至于測試用例視圖，則更不同了。模塊劃分里面會(huì)有很多和測試用例直接相關(guān)的劃分，比如兼容性測試，壓力測試等等。所以禪道將這三個(gè)模塊分開，需要單獨(dú)進(jìn)行維護(hù)。1) 進(jìn)入測試視圖，然后選擇缺陷管理。2) 在頁面的左側(cè)，會(huì)出現(xiàn)該產(chǎn)品的缺陷模塊列表。3) 模塊列表的下部，有模塊維護(hù)的連接，點(diǎn)擊此鏈接，即可維護(hù)模塊，詳情的維護(hù)界面， 維護(hù)模塊的時(shí)候是一級級進(jìn)行維護(hù)的。比如可以選擇我的地盤，然后維護(hù)它的子模塊。 左側(cè)的數(shù)字是用來排序的，可以將通過調(diào)整模塊的排序字段來調(diào)整它在模塊樹里面的位置。 可以選擇某一個(gè)模塊編輯，編輯的時(shí)候可以修改它所屬的上級模塊，以及這個(gè)模塊的默認(rèn)負(fù)責(zé)人(當(dāng)創(chuàng)建bug的時(shí)候，會(huì)自動(dòng)將這個(gè)用戶作為默認(rèn)的負(fù)責(zé)人) 可以選擇產(chǎn)品視圖的某一個(gè)模塊，將其下級模塊復(fù)制到當(dāng)前的測試視圖的模塊中。3.5.2 提交bug1) 進(jìn)入測試視圖的“缺陷管理”2) 點(diǎn)擊頁面右側(cè)的創(chuàng)建bug，即可進(jìn)入bug創(chuàng)建頁面。說明：1) 項(xiàng)目和任務(wù)，以及相關(guān)需求，應(yīng)該認(rèn)真填寫，這樣可以將bug和項(xiàng)目，任務(wù)，需求關(guān)聯(lián)起來，以便以后的統(tǒng)計(jì)分析。2) 影響版本是必填的。而這里面的列表來源，則是項(xiàng)目中的build。如果這個(gè)地方?jīng)]有build的話，則需要到項(xiàng)目中創(chuàng)建一個(gè)build。3) 重現(xiàn)步驟應(yīng)該翔實(shí)準(zhǔn)確，確保開發(fā)人員可以重現(xiàn)改bug。3.5.3 驗(yàn)證bug，關(guān)閉當(dāng)開發(fā)人員解決bug之后，就需要來驗(yàn)證bug，如果沒有問題，則將其關(guān)閉。3.5.4 激活bug如果開發(fā)人員解決bug之后，驗(yàn)證無法通過，則可以將bug重新激活，交由最后的解決者去重新解決。還有一種情況就是bug關(guān)閉之后，過了一段時(shí)間，bug又重現(xiàn)了，也需要重新激活。激活bug的時(shí)候，指派給會(huì)自動(dòng)設(shè)置成為最后的解決者頭上。3.5.5 找到自己需要的bug測試人員一個(gè)