1、項(xiàng)目組軟件開發(fā)行為規(guī)范僅供信息化部使用1 概述1.1 編寫目的 為了把公司已經(jīng)發(fā)布的軟件開發(fā)過程規(guī)范有效地運(yùn)作于產(chǎn)品開發(fā)活動中， 把 各種規(guī)范“逐步形成工程師的作業(yè)規(guī)范” ，特制定本軟件開發(fā)行為規(guī)范，以到達(dá) 提高系統(tǒng)質(zhì)量的目的。在本規(guī)范中，闡述了基本的開發(fā)模式，包括需求驗(yàn)證、設(shè) 計、編碼規(guī)范、代碼審查、單元測試、配置管理等，并明確開發(fā)過程中的方法、 策略、工具以及環(huán)境要求，開發(fā)人員都必須遵守本軟件開發(fā)規(guī)范。1.2 讀者對象本規(guī)范讀者對象為軟件開發(fā)項(xiàng)目管理者、項(xiàng)目經(jīng)理、開發(fā)組2 需求評審2.1 過程要求 按軟件開發(fā)過程經(jīng)驗(yàn)，問題暴露越早越好。因此，在實(shí)施設(shè)計和編碼前，需 對項(xiàng)目經(jīng)理提供的需求說明

2、文檔進(jìn)行充分的驗(yàn)證， 在不明確的需求點(diǎn)上， 需要和 項(xiàng)目經(jīng)理進(jìn)一步核實(shí)，確保對每個需求點(diǎn)有清晰、一致的認(rèn)識和理解。在需求驗(yàn)證的過程中，需按以下檢查點(diǎn)進(jìn)行逐項(xiàng)檢查（包括不限于） ：1. 所有定義、實(shí)現(xiàn)方法是否清楚地表達(dá)了用戶的原始要求？2. 是否清楚、明確地描述了所有的功能？是否沒有不能理解或造成誤解的 描述 ？3. 需求定義是否包含了有關(guān)功能、性能、限制、目標(biāo)、質(zhì)量等方面的所有 需求？4. 需求是否可以驗(yàn)證（即是否可以檢驗(yàn)軟件是否滿足了需求）？5. 是否有術(shù)語定義一覽表？6. 是否標(biāo)識并定義了在將來可能會變化的需求？7. 各個需求之間是否一致？是否有沖突和矛盾？8. 是否定義了系統(tǒng)所有的輸入、

3、輸出及其來源？主要為客戶或者其他外部接口，是否明確定義了輸入?yún)?shù)和輸出參數(shù)？9. 是否說明了如何進(jìn)行系統(tǒng)輸入的合法性檢查？10. 功能性需求是否覆蓋了所有非正常情況的處理？11. 對異常數(shù)據(jù)產(chǎn)生的結(jié)果是否作了精確的描述？12. 是否充分定義了關(guān)于人機(jī)界面的需求？13. 在不同情況下，是否規(guī)定了系統(tǒng)的響應(yīng)時間？14. 界面需求是否使軟硬件系統(tǒng)具有兼容性？15. 是否有對相關(guān)日志做明確要求？以滿足稽核相關(guān)的需要。針對開發(fā)過程中的需求變更，以上需求驗(yàn)證點(diǎn)同樣適用，并同時評估需求變 更給當(dāng)前項(xiàng)目的設(shè)計和開發(fā)帶來的風(fēng)險，包括架構(gòu)、安全、進(jìn)度等方面，以便項(xiàng) 目經(jīng)理進(jìn)行計劃調(diào)整和安排。2.2 工具及環(huán)境1.

4、 在此過程中，使用 Excel 對以上檢查點(diǎn)進(jìn)行跟蹤和標(biāo)記。記錄文檔需 check-in 到 svn.2. 評審?fù)瓿傻男枨笪臋n需 check-in 到 svn。3. 任何需求變更文檔需 check-in 到 svn。4. 登記相關(guān)問題，并跟蹤其狀態(tài)。3 系統(tǒng)設(shè)計及評審3.1 過程要求概要設(shè)計要以軟件需求規(guī)格為基礎(chǔ)， 必須保證需要實(shí)現(xiàn)的需求規(guī)格已經(jīng)被設(shè) 計。概要設(shè)計文檔的需涵蓋以下幾方面：1. 涵蓋系統(tǒng)的總體結(jié)構(gòu)、功能。系統(tǒng)共包含哪些模塊，以及模塊之間的關(guān)系。使閱讀者對系統(tǒng)有了全局觀。2. 明確系統(tǒng)使用的外部接口和資源。包括外部環(huán)境、第三方接口、第三方 技術(shù)架構(gòu)等。3. 模塊設(shè)計的進(jìn)一步細(xì)化，包

5、括具體的輸入、輸出、處理邏輯、與其他模 塊之間的接口等。4. 數(shù)據(jù)結(jié)構(gòu)設(shè)計，文檔中明確數(shù)據(jù)的物理結(jié)構(gòu)和邏輯結(jié)構(gòu)，包括數(shù)據(jù)的存 儲方式、緩存策略、備份策略、清理策略等。5. 容災(zāi)設(shè)計，主要指外部資源或接口不可用時，系統(tǒng)如何處理，包括客戶 提示信息、錯誤現(xiàn)場記錄等。6. 監(jiān)控設(shè)計，針對系統(tǒng)中的關(guān)鍵業(yè)務(wù)，特別是對實(shí)時性、準(zhǔn)確性要求較高 的功能，需考慮其監(jiān)控指標(biāo)、監(jiān)控方法、業(yè)務(wù)閥值、告警通知的設(shè)計。7. 安全設(shè)計，在系統(tǒng)概要設(shè)計中，要充分考慮系統(tǒng)安全方面的設(shè)計，包括 數(shù)據(jù)傳輸、數(shù)據(jù)存儲、網(wǎng)絡(luò)攻擊等方面的情況。8. 其他情況，未在以上提及的項(xiàng)目其他情況，可進(jìn)行特別說明。 同時，在概要設(shè)計過程中，需遵循以

6、下原則：1、當(dāng)需求規(guī)格發(fā)生變更時，必須修訂相關(guān)概要設(shè)計文檔。2、在概要設(shè)計文檔，必須記錄、驗(yàn)證需求和概要設(shè)計的跟蹤關(guān)系。3、必須保證概要設(shè)計文檔和代碼的一致性。當(dāng)發(fā)生設(shè)計更改時，必須 修訂相應(yīng)設(shè)計文檔。4、概要設(shè)計過程結(jié)束前，必須通過評審，并保存評審記錄。5、設(shè)計更改必須經(jīng)過相關(guān)評審，并保存評審記錄。 在概要設(shè)計評審階段，可按以下檢查點(diǎn)進(jìn)行逐項(xiàng)驗(yàn)證（包括但不限于）1、是否描述了接口的功能特征 ?2、接口是否便于查錯 ?3、接口相互之間、和其他模塊、和需求說明書及接口規(guī)格書保持一致？4、對接口的數(shù)量和復(fù)雜度進(jìn)行了有效的平衡，使接口數(shù)量控制在一個較小 數(shù)量，每個接口具有可接受的復(fù)雜度？5、是否所有

7、的接口都能描述了必要的類型、數(shù)量、質(zhì)量等信息？6、操作界面是否考慮了用戶（例如：提供準(zhǔn)確、清晰、有用的提示信息）7、是否模塊化設(shè)計？8、模塊遵循高內(nèi)聚、低耦合的原則？9、是否每一部分的設(shè)計都可以追溯到需求說明書，接口規(guī)格說明書、或其 他產(chǎn)品文檔？10、對所繼承下來的那些特別和不常用的特性對目前設(shè)計的影響是否進(jìn)行了 分析？11、需求規(guī)格評審中不完整的需求是否都已經(jīng)解決 ?12、設(shè)計是否考慮了檢錯和恢復(fù)措施？（例如：輸入檢查，數(shù)據(jù)錯誤后如何 恢復(fù)）13、是否考慮了異常情況？14、是否完全準(zhǔn)確描述了所有的出錯情況？15、設(shè)計是否能夠滿足所有系統(tǒng)集成方面的要求？3.3 工具及環(huán)境1. 概要設(shè)計文檔及其

8、評審文檔需 check-in 到 svn 中。2. 概要設(shè)計過程中的問題跟蹤需記錄。4 系統(tǒng)實(shí)現(xiàn)4.1 過程要求編碼必須以設(shè)計文檔為基礎(chǔ)， 必須保證所有的設(shè)計都被編碼實(shí)現(xiàn)。 當(dāng)設(shè)計發(fā) 生變更時， 必須修改相關(guān)代碼。 同時必須保證設(shè)計文檔和代碼的一致性。 當(dāng)代碼 的修改已經(jīng)造成設(shè)計更改時，必須修訂相應(yīng)設(shè)計文檔。在系統(tǒng)實(shí)現(xiàn)過程中，需遵循以下規(guī)范：1. 遵照各項(xiàng)編碼規(guī)范。2. 所有代碼使用 svn 進(jìn)行統(tǒng)一管理，并至少提供開發(fā)、測試、生產(chǎn)三種構(gòu) 建腳本。3. 在系統(tǒng)開始之前，需在 svn 上創(chuàng)建對應(yīng)的分支，開發(fā)工作統(tǒng)一在分支上 進(jìn)行。4. 針對開發(fā)任務(wù)的分解，需要參照單人單任務(wù)在兩天以內(nèi)完成的標(biāo)準(zhǔn)。

9、5. 開發(fā)過程中，單元測試通過的代碼需要及時 check-in 到 svn。6. 代碼進(jìn)入系統(tǒng)測試前需進(jìn)行評審， 可以是集中評審或者交叉評審的方式。 評審內(nèi)容包括基本編碼規(guī)范、基本邏輯、日志規(guī)范、出錯處理等。7. 單元測試的覆蓋率需在 80%以上。具體的單元測試要點(diǎn)如下：對所測模塊的數(shù)據(jù)進(jìn)行測試。檢查不正確或不一致的數(shù)據(jù)類型說明、使用尚未附值或尚未初始化 的變量、錯誤的初始值或缺省值。設(shè)計測試用例查找由于不正確的計算（包括算法錯、表達(dá)式符號表 示不正確、 運(yùn)算精度不夠等）、不正確的比較或不正常的控制流 （包括不 同數(shù)據(jù)類型量的相互比較、不適當(dāng)?shù)匦薷牧搜h(huán)變量、錯誤的或不可能 的循環(huán)終止條件等）

10、而導(dǎo)致的錯誤。檢查模塊有沒有對預(yù)見錯誤的條件設(shè)計比較完善的錯誤處理功能， 保證其邏輯上的正確性。邊界檢查，注意設(shè)計數(shù)據(jù)、控制中剛好等于、大于或小于確定的比 較值的用例。8. 開發(fā)過程中，需進(jìn)行持續(xù)化構(gòu)建，保證 check-in 的代碼質(zhì)量。9. 項(xiàng)目中引進(jìn)的新技術(shù)需經(jīng)過統(tǒng)一評審。5 測試5.1 過程要求在系統(tǒng)交付給測試組進(jìn)行測試前，開發(fā)人員需在內(nèi)部進(jìn)行第一輪功能測試。 測試過程中需保持測試代碼的準(zhǔn)確性和測試環(huán)境的獨(dú)立性。 具體測試內(nèi)容包含但 不限于以下幾方面：1. 功能測試。對照需求文檔中的功能點(diǎn)， 對系統(tǒng)的功能進(jìn)行測試驗(yàn)證， 確保 系統(tǒng)完全滿足需求文檔中的要求。2. 平臺兼容性測試。 在不同

11、的瀏覽器、 硬件配置環(huán)境下進(jìn)行測試， 主要瀏覽 器包括 Firefox,safari,IE, chrome 。針對移動端，需涵蓋三個主流操作系統(tǒng)， iOS, Android 和 Windows Mobile 。 硬件兼容性則包括不同的智能終端，PC,MAC,IPAD等其他機(jī)型的不同分辨率下的兼容性測試。3不同網(wǎng)絡(luò)環(huán)境下測試。針對移動端的應(yīng)用，驗(yàn)證不同網(wǎng)絡(luò)環(huán)境下，終端應(yīng)用功能與性能方面是否正常 （ 數(shù)據(jù)業(yè)務(wù)是否會中斷，業(yè)務(wù)模塊是否出現(xiàn)異常 ）網(wǎng)絡(luò)環(huán)境包含：4G信號，3G信號，2G強(qiáng)信號。6 開發(fā)計劃6.1 過程要求軟件開發(fā)是一項(xiàng)復(fù)雜、 長期的系統(tǒng)工程， 為保證開發(fā)能夠順利地進(jìn)行實(shí)施， 必須要制定

12、 科學(xué)、合理、切實(shí)可行的實(shí)施計劃，制定嚴(yán)格的時間進(jìn)度表，明確各個環(huán)節(jié)實(shí)施的時間，以 指導(dǎo)和控制項(xiàng)目的全面實(shí)施。在系統(tǒng)實(shí)現(xiàn)過程中，需遵循以下規(guī)范：1. 軟件項(xiàng)目計劃必須以產(chǎn)品 /軟件的需求規(guī)格為基礎(chǔ)。當(dāng)發(fā)生需求更改時，必須修訂 軟件開發(fā)計劃。2. 對于軟件項(xiàng)目計劃中各項(xiàng)工作產(chǎn)品和工作任務(wù)，必須進(jìn)行規(guī)模和工作量的軟件估 計，并在軟件項(xiàng)目計劃文檔中記錄估計的方法和估計數(shù)據(jù)3. 對某項(xiàng)工作產(chǎn)品和任務(wù)的軟件， 同時采用兩種或以上的方法進(jìn)行估計， 以避免一種 方法的偏差4. 盡量采用歷史經(jīng)驗(yàn)數(shù)據(jù)進(jìn)行軟件估計5. 在“軟件開發(fā)計劃”中須包括項(xiàng)目管理活動的計劃6. 在“軟件開發(fā)計劃”包括人員的培訓(xùn)計劃7. 在

13、“軟件開發(fā)計劃” 中應(yīng)考慮軟件項(xiàng)目進(jìn)行風(fēng)險分析與評估， 可能存在的風(fēng)險領(lǐng)域 含：需求的不明確和變更、外部的限制與對外的依賴、人力資源的到位情況、人力 資源的技術(shù)等級滿足要求狀況、技術(shù)問題等，造成的計劃變更。8. 在開發(fā)活動中，必須按照項(xiàng)目跟蹤與監(jiān)控計劃和體制，對照“軟件開發(fā)計劃” ，跟 蹤項(xiàng)目開發(fā)的實(shí)際結(jié)果和性能。 當(dāng)實(shí)際結(jié)果和 “軟件項(xiàng)目計劃”發(fā)生偏離時，必須 進(jìn)行分析， 根據(jù)分析結(jié)果標(biāo)明糾正措施。 必要的情況下， 要及時修訂“軟件項(xiàng)目計 劃”9. 在軟件項(xiàng)目跟蹤監(jiān)控活動中， 必須定期進(jìn)行總結(jié)和評審， 撰寫開發(fā)狀態(tài)報告。 根據(jù) 項(xiàng)目的特點(diǎn)，報告的周期可以為周、雙周、月。7 數(shù)據(jù)安全7.1 過程要求21 世紀(jì)是一個信息爆炸的時代，數(shù)據(jù)是信息的主要載體，數(shù)據(jù)安全保證了信息的可用 性。而數(shù)據(jù)備份作為保證數(shù)據(jù)安全的方法之一， 則顯得尤為重要。 數(shù)據(jù)安全不僅在防范計算 機(jī)病毒、系統(tǒng)漏洞中有體現(xiàn)，更多的還有代碼安全，數(shù)據(jù)庫防脫庫及數(shù)據(jù)庫備份安全。在系統(tǒng)實(shí)現(xiàn)過程中，需遵循以下規(guī)范：1. 加強(qiáng)開發(fā)人員安全意識培訓(xùn)， 近年來的一系列企業(yè)泄密事件的發(fā)生， 根本原因還在 于安