ZENQ項(xiàng)目實(shí)訓(xùn)指導(dǎo)手冊(cè)

1、武漢正奇龍科技有限公司 內(nèi)部資料ZENQ項(xiàng)目實(shí)訓(xùn)指導(dǎo)手冊(cè)版本V1.1最后修訂時(shí)間2008-11-29目 錄1概述32開發(fā)過程管理32.1概述32.2軟件開發(fā)基本流程42.2.1立項(xiàng)階段42.2.2需求分析72.2.3概要設(shè)計(jì)82.2.4開發(fā)階段92.2.5測(cè)試階段102.2.6發(fā)布階段112.3迭代開發(fā)123配置管理133.1概述133.2版本控制工具133.3項(xiàng)目目錄結(jié)構(gòu)141 概述本手冊(cè)的目的是為了明確在實(shí)訓(xùn)項(xiàng)目開發(fā)時(shí)每個(gè)環(huán)節(jié)的步驟，需要完成的工作，以及需要完成文檔的模板等提出規(guī)范。沒有規(guī)矩不成方圓，標(biāo)準(zhǔn)是企業(yè)走向成功的利器，在項(xiàng)目的開發(fā)過程中，必須按照本指南的要求，開展項(xiàng)目。在開發(fā)過程管

2、理章節(jié)中，向讀者介紹了從立項(xiàng)階段、需求分析、概要設(shè)計(jì)、開發(fā)階段、測(cè)試階段到發(fā)布階段軟件開發(fā)的基本流程。這些規(guī)范是對(duì)現(xiàn)有企業(yè)開發(fā)方法精煉的積累和總結(jié)，也是學(xué)員在培訓(xùn)過程中所需要遵循的規(guī)范。在配置管理章節(jié)中，介紹企業(yè)中實(shí)際使用的項(xiàng)目版本控制工具的使用，以及配置管理的方法。并通過項(xiàng)目目錄結(jié)構(gòu)來(lái)展示將進(jìn)入產(chǎn)品基線庫(kù)的項(xiàng)目成果，從而引導(dǎo)學(xué)員整個(gè)項(xiàng)目交付時(shí)需要有那些成果及其應(yīng)該以怎樣的方式進(jìn)行歸檔。最后給出項(xiàng)目的開發(fā)模版，以指導(dǎo)學(xué)員以規(guī)范的方式編寫文檔，并通過模版引導(dǎo)學(xué)員對(duì)模版中需要填充的內(nèi)容進(jìn)行思考，從而引導(dǎo)學(xué)員進(jìn)行項(xiàng)目開發(fā)、設(shè)計(jì)、編碼和測(cè)試工作。2 開發(fā)過程管理2.1 概述業(yè)界有非常的開發(fā)方法，來(lái)保證

3、開發(fā)進(jìn)度，開發(fā)的質(zhì)量。比如RUP、CMM-I、MSF、XP開發(fā)等。各種開發(fā)過程都有它的優(yōu)勢(shì)和特點(diǎn)，并適合在各種規(guī)模和類型不同的企業(yè)中進(jìn)行使用。但目前流行的開發(fā)過程都有一個(gè)特點(diǎn)，就是迭代開發(fā)，這是由軟件項(xiàng)目的特點(diǎn)決定的。在現(xiàn)實(shí)項(xiàng)目中，往往很難一次性得到項(xiàng)目的需求，項(xiàng)目需求獲取的漸進(jìn)性，使項(xiàng)目設(shè)計(jì)、開發(fā)也需要隨后跟進(jìn)，整個(gè)項(xiàng)目采用迭代開發(fā)模式可以有效節(jié)約開發(fā)成本。在項(xiàng)目開發(fā)中，將任務(wù)分解為多個(gè)階段，每個(gè)階段能完成可以運(yùn)行的版本，是我們項(xiàng)目中采用的方式。實(shí)訓(xùn)中簡(jiǎn)化這個(gè)過程，一般以一周為單位作為一個(gè)基本時(shí)間。每周能推出一個(gè)可以運(yùn)行的版本。這樣能夠及時(shí)糾正項(xiàng)目中的問題，指導(dǎo)學(xué)員在正確的模式下迭代開發(fā)完成

4、項(xiàng)目。2.2 軟件開發(fā)基本流程開發(fā)過程按照一下過程進(jìn)行迭代開發(fā)。每個(gè)階段需要編寫相關(guān)的文檔、完成指定的任務(wù)。由于需求在需求分析階段很難一次性將需求調(diào)研清楚，這是由業(yè)務(wù)需求本身具有其不確定造成的。但項(xiàng)目卻不能在需求完全確定后再考慮分析和設(shè)計(jì)，這樣在時(shí)間與人力的分配上造成了浪費(fèi)。在項(xiàng)目中所采用的通用的方式是，首先選取核心的業(yè)務(wù)進(jìn)行分析，先固定下來(lái)進(jìn)行分析設(shè)計(jì)，能有效確保核心業(yè)務(wù)的完善。而后，需求調(diào)研人員對(duì)后續(xù)需求進(jìn)行補(bǔ)充，這時(shí)候分析設(shè)計(jì)人員能夠同步與需求分析人員進(jìn)行工作，大大提高了工作效率。所以迭代開發(fā)是并發(fā)完成項(xiàng)目所必需的軟件開發(fā)模式。2.2.1 立項(xiàng)階段在立項(xiàng)階段，完成團(tuán)隊(duì)的組建。為項(xiàng)目成員分

5、配任務(wù)，根據(jù)項(xiàng)目目標(biāo)、時(shí)間規(guī)劃項(xiàng)目進(jìn)度。在此階段，需要建立團(tuán)隊(duì)的工作區(qū)，建立源代碼管理環(huán)境。在此時(shí)要分配項(xiàng)目中的角色，明確每個(gè)人的職責(zé)。至少需要以下角色：崗位職責(zé)備注項(xiàng)目經(jīng)理規(guī)劃與管理項(xiàng)目進(jìn)度、協(xié)調(diào)組員間的任務(wù)安排、根據(jù)實(shí)際情況調(diào)整進(jìn)度、按時(shí)向領(lǐng)導(dǎo)匯報(bào)項(xiàng)目進(jìn)展1人測(cè)試經(jīng)理編寫項(xiàng)目的單元測(cè)試代碼、設(shè)計(jì)測(cè)試用例、安裝程序制作、安裝說(shuō)明書1人需求分析師對(duì)業(yè)務(wù)邏輯建模，明確項(xiàng)目需求軟件工程師按需求進(jìn)行模塊設(shè)計(jì)、單元編碼、模塊測(cè)試測(cè)試工程師按照測(cè)試用例編寫好的軟件進(jìn)行功能測(cè)試，記錄測(cè)試的BUG配置管理員負(fù)責(zé)整個(gè)項(xiàng)目的文檔版本管理、代碼備份，為組員分配源代碼管理帳號(hào)。1人在實(shí)際項(xiàng)目中不同的人員可以兼任不同

6、的角色，但是有些情況是不能兼任的。一般來(lái)說(shuō)，軟件工程師不能兼任測(cè)試工程師。在實(shí)訓(xùn)過程中，由于人員限制，軟件工程師也擔(dān)任測(cè)試工程的角色。在這種情況下，軟件工程師負(fù)責(zé)測(cè)試的模塊不能使自己編寫的模塊。立項(xiàng)階段需要完成的工作任務(wù)：1、 角色定義任務(wù)描述：根據(jù)參與項(xiàng)目的人員特長(zhǎng)，為小組成員定義角色，確定項(xiàng)目經(jīng)理、測(cè)試經(jīng)理等；參與人員：全體成員參與；驗(yàn)收標(biāo)準(zhǔn)：完成配置管理計(jì)劃文檔，并經(jīng)過全體成員認(rèn)可；2、 建立工作環(huán)境任務(wù)描述：創(chuàng)建源代碼管理服務(wù)器，根據(jù)源代碼管理要求建立相關(guān)目錄；為項(xiàng)目成員分配登錄帳號(hào)，并測(cè)試源代碼服務(wù)器。每個(gè)成員測(cè)試自己的帳號(hào)，工作環(huán)境是否正常使用。建立過程可以參考第三章配置管理。參與

7、人員：本任務(wù)負(fù)責(zé)人為配置管理員，所有團(tuán)隊(duì)成員參與。驗(yàn)收標(biāo)準(zhǔn)：完成配置管理計(jì)劃文檔，并經(jīng)過全體成員確認(rèn)。3、 項(xiàng)目進(jìn)度計(jì)劃任務(wù)描述：根據(jù)項(xiàng)目難易程度、項(xiàng)目時(shí)間要求，估算項(xiàng)目進(jìn)度。并為項(xiàng)目成員進(jìn)行工作安排。項(xiàng)目計(jì)劃可以根據(jù)情況，進(jìn)行一定的變更。參與人員：項(xiàng)目經(jīng)理負(fù)責(zé)完成，與項(xiàng)目成員確認(rèn)工作安排。驗(yàn)收標(biāo)準(zhǔn)：使用 Project 完成項(xiàng)目進(jìn)度計(jì)劃，并將文檔簽入服務(wù)器。4、 任務(wù)跟蹤表任務(wù)描述：通過完成項(xiàng)目計(jì)劃，確定每個(gè)人的任務(wù)。根據(jù)模板建立任務(wù)跟蹤表，通過此表格跟蹤每個(gè)人的任務(wù)完成情況。任務(wù)跟蹤表可以根據(jù)項(xiàng)目計(jì)劃的編號(hào)，對(duì)任務(wù)進(jìn)行終止、暫停等。參與人員：項(xiàng)目經(jīng)理負(fù)責(zé)完成。驗(yàn)收標(biāo)準(zhǔn)：根據(jù)項(xiàng)目跟蹤模板建立

8、項(xiàng)目跟蹤記錄表，并將文檔簽入服務(wù)器。2.2.2 需求分析任務(wù)描述：需求分析是開發(fā)人員要準(zhǔn)確理解用戶的要求，進(jìn)行細(xì)致的調(diào)查分析，將用戶非形式的需求陳述轉(zhuǎn)化為完整的需求定義，再由需求定義轉(zhuǎn)化到相應(yīng)的形式功能規(guī)約（需求規(guī)格說(shuō)明）的過程。需求分析雖處于軟件開發(fā)過程的初期階段,但它對(duì)于整個(gè)軟件開發(fā)過程以及軟件產(chǎn)品質(zhì)量是至關(guān)重要的。需求分析的基本任務(wù)1.問題識(shí)別   (1) 功能需求：明確所開發(fā)的軟件必須具備什么樣的功能。   (2) 性能需求：明確待開發(fā)的軟件的技術(shù)性能指標(biāo)。   (3) 環(huán)境需求：明確軟件運(yùn)行時(shí)所

9、需要的軟、硬件的要求。   (4) 用戶界面需求：明確人機(jī)交互方式、輸入輸出數(shù)據(jù)格式。2. 分析與綜合，導(dǎo)出軟件的邏輯模型分析人員對(duì)獲取的需求，進(jìn)行一致性的分析檢查，在分析、綜合中逐步細(xì)化軟件功能，劃分成各個(gè)子功能。用圖文結(jié)合的形式，建立起新系統(tǒng)的邏輯模型。3. 編寫文檔一般可以采用 UML 對(duì)需求分析進(jìn)行建模?？梢愿鶕?jù)需求分析，適當(dāng)調(diào)整項(xiàng)目計(jì)劃。參與人員：需求分析工程師；驗(yàn)收標(biāo)準(zhǔn)：完成需求分析說(shuō)明書，并簽入服務(wù)器；2.2.3 概要設(shè)計(jì)在軟件需求分析階段，已經(jīng)搞清楚了軟件“做什么”的問題，并把這些需求通過規(guī)格說(shuō)明書描述了出來(lái)，這也是目標(biāo)系統(tǒng)的邏輯模型。進(jìn)入了設(shè)計(jì)階

10、段，要把軟件“做什么”的邏輯模型變換為“怎么做”的物理模型，即著手實(shí)現(xiàn)軟件的需求，并將設(shè)計(jì)的結(jié)果反映在“設(shè)計(jì)規(guī)格說(shuō)明書”文檔中，所以軟件設(shè)計(jì)是一個(gè)把軟件需求轉(zhuǎn)換為軟件表示的過程，最初這種表示只是描述了軟件的總的體系結(jié)構(gòu)，稱為軟件概要設(shè)計(jì)。概要設(shè)計(jì)要明確系統(tǒng)的模塊劃分，軟件系統(tǒng)的架構(gòu)，數(shù)據(jù)庫(kù)設(shè)計(jì)等。概要設(shè)計(jì)的基本任務(wù)：1、 概要設(shè)計(jì)任務(wù)描述：概要設(shè)計(jì)明確系統(tǒng)采用的技術(shù)手段、開發(fā)語(yǔ)言，模塊劃分。參與人員：項(xiàng)目經(jīng)理、軟件工程師。驗(yàn)收標(biāo)準(zhǔn)：完成概要設(shè)計(jì)說(shuō)明書。2、 界面設(shè)計(jì)任務(wù)描述：良好的人機(jī)界面是一個(gè)軟件成功的重要因素之一。在軟件設(shè)計(jì)之初就應(yīng)當(dāng)考慮到界面設(shè)計(jì)。界面設(shè)計(jì)應(yīng)當(dāng)考慮色彩搭配、易用性。參與人

11、員：軟件工程師。驗(yàn)收標(biāo)準(zhǔn)：包括在概要設(shè)計(jì)說(shuō)明書中，或則編寫單獨(dú)的界面設(shè)計(jì)說(shuō)明書。3、 數(shù)據(jù)庫(kù)設(shè)計(jì)任務(wù)描述：如果系統(tǒng)需要使用數(shù)據(jù)庫(kù)存儲(chǔ)數(shù)據(jù)，需要進(jìn)行數(shù)據(jù)庫(kù)設(shè)計(jì)。數(shù)據(jù)庫(kù)設(shè)計(jì)一般使用專門的數(shù)據(jù)庫(kù)設(shè)計(jì)軟件，推薦使用 Sybase PowerDesign 。完成數(shù)據(jù)庫(kù)設(shè)計(jì)以后，編寫數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明書。參與人員：軟件工程師。驗(yàn)收標(biāo)準(zhǔn)：在概要設(shè)計(jì)說(shuō)明書中編寫數(shù)據(jù)庫(kù)設(shè)計(jì)章節(jié)，或者單獨(dú)編寫數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明書。2.2.4 開發(fā)階段開發(fā)階段的主要任務(wù)是根據(jù)設(shè)計(jì)，對(duì)系統(tǒng)進(jìn)行構(gòu)建。開發(fā)階段的基本任務(wù)：1、 代碼編寫任務(wù)描述：根據(jù)設(shè)計(jì)文檔，進(jìn)行單元編碼。編碼可能包括兩個(gè)方面：編程語(yǔ)言代碼、數(shù)據(jù)庫(kù)存儲(chǔ)過程代碼。參與人員：軟件工

12、程師。驗(yàn)收標(biāo)準(zhǔn)：?jiǎn)卧幋a。2、 單元測(cè)試任務(wù)描述：根據(jù)詳細(xì)設(shè)計(jì)，編寫單元測(cè)試代碼。編寫單元測(cè)試的目的是為了快速對(duì)模塊的正確性進(jìn)行驗(yàn)證。一般使用 JUnit、NUnit等工具進(jìn)行單元測(cè)試。參與人員：軟件工程師。驗(yàn)收標(biāo)準(zhǔn)：完成單元測(cè)試代碼。2.2.5 測(cè)試階段軟件測(cè)試是程序的一種執(zhí)行過程，目的是盡可能發(fā)現(xiàn)并改正被測(cè)試軟件中的錯(cuò)誤，提高軟件的可靠性。它是軟件生命周期中一項(xiàng)非常重要且非常復(fù)雜的工作，對(duì)軟件可靠性保證具有極其重要的意義。在目前形式化方法和程序正確性證明技術(shù)還無(wú)望成為實(shí)用性方法的情況下，軟件測(cè)試在將來(lái)相當(dāng)一段時(shí)間內(nèi)仍然是軟件可靠性保證的有效方法。軟件工程的總目標(biāo)是充分利用有限的人力和物力資

13、源，高效率、高質(zhì)量地完成軟件開發(fā)項(xiàng)目。測(cè)試階段的工作可以在開發(fā)階段同步進(jìn)行。測(cè)試階段的主要任務(wù)：1、 編寫測(cè)試用例任務(wù)描述：根據(jù)需求分析、系統(tǒng)設(shè)計(jì)，由針對(duì)性的設(shè)計(jì)測(cè)試系統(tǒng)數(shù)據(jù)、操作流程，用于驗(yàn)證系統(tǒng)。參與人員：測(cè)試經(jīng)理。驗(yàn)收標(biāo)準(zhǔn)：完成測(cè)試說(shuō)明書、數(shù)據(jù)庫(kù)測(cè)試數(shù)據(jù)。2、 測(cè)試跟蹤記錄任務(wù)描述：根據(jù)測(cè)試用例、單元測(cè)試，將出現(xiàn)錯(cuò)誤的結(jié)果記錄在測(cè)試跟蹤表。并跟蹤錯(cuò)誤的解決情況。參與人員：測(cè)試工程師。驗(yàn)收標(biāo)準(zhǔn)：建立測(cè)試跟蹤記錄文件。2.2.6 發(fā)布階段當(dāng)程序通過各項(xiàng)測(cè)試，已經(jīng)沒有明顯影響程序執(zhí)行、功能性錯(cuò)誤時(shí)進(jìn)行。測(cè)試階段的主要任務(wù):1、 編寫安裝程序任務(wù)描述：為應(yīng)用程序編寫安裝程序，方便用戶使用。注意安

14、裝測(cè)試也需要經(jīng)過測(cè)試。參與人員：測(cè)試經(jīng)理。驗(yàn)收標(biāo)準(zhǔn)：安裝測(cè)試。2、 幫助任務(wù)描述：根據(jù)應(yīng)用程序類型制作系統(tǒng)幫助文件。如果是 WEB 應(yīng)用程序應(yīng)包含在程序中。參與人員：測(cè)試工程師。驗(yàn)收標(biāo)準(zhǔn)：完成幫助文檔。2.3 迭代開發(fā)項(xiàng)目中的每個(gè)階段可以進(jìn)一步分解為迭代。一個(gè)迭代是一個(gè)完整的開發(fā)循環(huán)，產(chǎn)生一個(gè)可執(zhí)行的產(chǎn)品版本，是最終產(chǎn)品的一個(gè)子集，它增量式地發(fā)展，從一個(gè)迭代過程到另一個(gè)迭代過程到成為最終的系統(tǒng)。傳統(tǒng)上的項(xiàng)目組織是順序通過每個(gè)工作流，每個(gè)工作流只有一次，也就是我們熟悉的瀑布生命周期。這樣做的結(jié)果是到實(shí)現(xiàn)末期產(chǎn)品完成并開始測(cè)試，在分析、設(shè)計(jì)和實(shí)現(xiàn)階段所遺留的隱藏問題會(huì)大量出現(xiàn)，項(xiàng)目可能要停止并開始

15、一個(gè)漫長(zhǎng)的錯(cuò)誤修正周期。一種更靈活，風(fēng)險(xiǎn)更小的方法是多次通過不同的開發(fā)工作流，這樣可以更好的理解需求，構(gòu)造一個(gè)健壯的體系結(jié)構(gòu)，并最終交付一系列逐步完成的版本。這叫做一個(gè)迭代生命周期。在工作流中的每一次順序的通過稱為一次迭代。軟件生命周期是迭代的連續(xù)，通過它，軟件是增量的開發(fā)。一次迭代包括了生成一個(gè)可執(zhí)行版本的開發(fā)活動(dòng)，還有使用這個(gè)版本所必需的其他輔助成分，如版本描述、用戶文檔等。因此一個(gè)開發(fā)迭代在某種意義上是在所有工作流中的一次完整的經(jīng)過，這些工作流至少包括：需求工作流、分析和設(shè)計(jì)工作流、實(shí)現(xiàn)工作流、測(cè)試工作流。其本身就像一個(gè)小型的瀑布項(xiàng)目。與傳統(tǒng)的瀑布模型相比較，迭代過程具有以下優(yōu)點(diǎn)：1、

16、降低了在一個(gè)增量上的開支風(fēng)險(xiǎn)。如果開發(fā)人員重復(fù)某個(gè)迭代，那么損失只是這一個(gè)開發(fā)有誤的迭代的花費(fèi)。2、 降低了產(chǎn)品無(wú)法按照既定進(jìn)度進(jìn)入市場(chǎng)的風(fēng)險(xiǎn)。通過在開發(fā)早期就確定風(fēng)險(xiǎn)， 可以盡早來(lái)解決而不至于在開發(fā)后期匆匆忙忙。3、 加快了整個(gè)開發(fā)工作的進(jìn)度。因?yàn)殚_發(fā)人員清楚問題的焦點(diǎn)所在，他們的工作會(huì)更有效率。4、 由于用戶的需求并不能在一開始就做出完全的界定，它們通常是在后續(xù)階段中不斷細(xì)化的。因此，迭代過程這種模式使適應(yīng)需求的變化會(huì)更容易些。3 配置管理3.1 概述軟件配置管理（SCM，Soft Configure Management）的目的是在整個(gè)項(xiàng)目的軟件生存周期內(nèi)，建立和維護(hù)軟件項(xiàng)目產(chǎn)品的完整性

17、。軟件配置管理包括在給定時(shí)間點(diǎn)上及時(shí)地標(biāo)識(shí)軟件的配置，系統(tǒng)地控制對(duì)配置的更改，并在整個(gè)軟件生存周期中維護(hù)配置的完整性和可跟蹤性。置于軟件配置管理之下的工作產(chǎn)品包括交付給客戶的軟件產(chǎn)品（如軟件需求文檔和代碼），以及與這些軟件產(chǎn)品一同標(biāo)識(shí)的或?yàn)楫a(chǎn)生這些軟件產(chǎn)品所要求的產(chǎn)品項(xiàng)（如編譯程序）。軟件配置管理包括了多項(xiàng)相關(guān)活動(dòng)，包括版本控制、建立軟件配置庫(kù)系統(tǒng)、配置項(xiàng)變化的控制、軟件基線記錄報(bào)告等等。在實(shí)訓(xùn)項(xiàng)目中我們只要求進(jìn)行開發(fā)過程中的版本控制。在一個(gè)項(xiàng)目的開發(fā)過程中，一定是涉及到多人合作，共同完成設(shè)計(jì)、編碼、測(cè)試等工作。為了避免項(xiàng)目組的不同成員在開發(fā)過程中，因?yàn)榇a、文檔不一致，影響開發(fā)進(jìn)度；在開發(fā)過

18、程中必須要使用一種版本管理工具。版本管理工具記錄了所有庫(kù)中代碼和文檔的開發(fā)歷程，可以保證產(chǎn)品的可追溯性，為調(diào)試代碼、清除缺陷提供很大的幫助。同時(shí)，版本管理支持并行開發(fā)和維護(hù)，為協(xié)同開發(fā)打下了基礎(chǔ)。3.2 版本控制工具目前流行的源代碼主要有Microsoft SourceSafe、CVS、SVN、Rational ClearCase等。根據(jù)不同的項(xiàng)目，選擇不同的源代碼管理工具。1、 Microsoft SourceSafeSource Safe 微軟公司生產(chǎn)的源代碼管理工具，能夠與Visual Studio 很好的集成。在Windows組成的局域網(wǎng)內(nèi)使用，配置管理非常方便。一般來(lái)講，使用Visual Studio 作為主要的開發(fā)工具時(shí)使用SourceSafe作為項(xiàng)目的源代管理工具。2、 CVS/SVNCVS/SVN都是開源項(xiàng)目經(jīng)常使用的源代碼管理工具。它的優(yōu)點(diǎn)是能夠使用