信息系統(tǒng)軟件開發(fā)經(jīng)過流程管理方案計劃規(guī)范標準初稿

1、*軟件開發(fā)流程管理規(guī)范軟件開發(fā)流程管理規(guī)范 1一、概述 2二、流程 2三、附件 3附件一、編碼規(guī)范 31 、命名空間 32 、命名規(guī)則 32.1 文件夾及相關(guān)文件命名規(guī)則 32.2 數(shù)據(jù)庫表命名規(guī)則 43、代碼規(guī)范 43.1 代碼分層結(jié)構(gòu) 43.2 編碼規(guī)范 54、注釋 64.1 注釋模板設(shè)置 64.2 手工添加注釋 74.3 注釋要求 8附件二、軟件需求申請表 9附件三、軟件開發(fā)申請表 10附件四、項目組成成員表 11附件五、項目策劃 /任務(wù)書 12附件六、 WBS 表 13附件七、項目進度計劃表 14附件八、項目風險管理表 15附件九、項目溝通計劃表 16附件十、項目會議紀要 17附件十一

2、、項目狀態(tài)報告表 18附件十二、項目變更管理表 19附件十三、項目總結(jié)表 20、概述隨著公司規(guī)模的擴大、各部門對軟件需求的激增、提高效率的工作要求，IT部門承接的軟件開發(fā)項目越來越多，而與之相對應(yīng)的就是軟件開發(fā)流程不明確，軟件項目的隨意性較大、可追溯性較差、可統(tǒng)計性模糊、可預(yù)測性不足是擺在我們面前最直接的問題。為了適應(yīng)公司的發(fā)展，IT部軟件開發(fā)項目特制訂本流程。二、流程S3展由上圖可以得出以下幾個關(guān)鍵步驟：一、需求部門：I、需求部門首先需要填寫軟件需求申請表，說明需要開發(fā)的軟件具體用途徑、目前 工作模式、工作不方便之處、基本功能等信息；II、待IT部門評審?fù)ㄟ^后，通知需求部門，填寫軟件開發(fā)申請

3、表，具體列明需要實 現(xiàn)的功能、目前工作流程、使用系統(tǒng)后需要達到的狀態(tài)，可節(jié)省的人力、物力，調(diào)高的效率 等信息；III、軟件開發(fā)測試完成之后，接受 IT部門的軟件使用培訓，并填寫參與培訓確認單；IV、軟件試用結(jié)束后，填寫軟件驗收表，完成軟件項目的開發(fā)流程；V、在開發(fā)測試過程中，遇到開發(fā)風險增加、需求變更等，都需要配合IT軟件開發(fā)人員填寫相關(guān)的項目風險管理表和項目變更管理表。二、IT部門：I、積極對需求部門提出的軟件需求申請表進行評審、審批，限3個工作日完成，及時反饋結(jié)果給需求部門；II、指導需求部門填寫各類表格；III、積極評審需求部門填寫的表格、積極溝通，有效獲得相對準確的需求，并填寫完善，讓

4、需求部門簽字確認；IV、進入開發(fā)流程后，積極填寫項目成員組成表、項目策劃任務(wù)書、 WBS表、 項目進度計劃表等（具體見附件）；V、積極開展人員培訓和軟件試用工作，編寫完善的XXX軟件試用說明書，并要求相關(guān)人員簽字確認，并存檔處理。三、附件 附件一、編碼規(guī) 范 1 、命名空間1. 公共類庫（公司功能業(yè)務(wù)）：（ 1 ） 全局公共類庫：例：ECO.Common.DBhelper/Excel/email,生成dll文件，添加至最小應(yīng)用庫可全程序引用（ 2 ） 局部公共類庫（主要區(qū)分公司），命名方式為專有業(yè)務(wù)場景+專有業(yè)務(wù)名+具體類名：例：ECO.Gp （總部）/In （國內(nèi)市場）/Rb （生產(chǎn)）注：（

5、公共類庫）信息登記、評審、信息共享，命名空間最多三層2.項目程序文件：項目文件名，以核心功能的英文名稱為準，格式:ECO去文名詞首字母大寫2、命名規(guī)則2.1 文件夾及相關(guān)文件命名規(guī)則a） 文件夾：功能文件夾，采用駝峰形式，首字母大寫全稱b） 窗體文件：采用駝峰形式，首字母大寫全稱c） 接口：I+采用駝峰形式，首字母大寫全稱d） 方法名：采用駝峰形式，首字母大寫全稱e） 窗體控件：同上f） 局部變量：變量類型縮寫（ int ， fl ， str） +駝峰形式g） 全局變量：不建議使用h） 常量：全英文大寫，不建議出現(xiàn)在頁面i） 數(shù)組：功能名稱首字母小寫+駝峰+Arrj） List 集合：功能名稱

6、首字母小寫+駝峰+Listk） 字典：功能名稱首字母小寫+駝峰+Dicl） Dateset：功能名稱首字母小寫+駝峰+Ds m）DateTable：功能名稱首字母小寫+駝峰+Dt附表 1：類型前綴（小寫）+駝峰樣式名詞或名詞短語對于基本類型變量，前綴如下表:前綴intintdoubledoufloatflstringstrboolbooldatetimedatbytebyt對于對象類型變量，也可以采用類似基本類型方式，如 StringBuilder類型，可使用 sb作為 前綴開頭，后跟變量名駝峰樣式。對于集合類型變量，如數(shù)組、 List、Dictionary ,可以在變量命名的基礎(chǔ)上結(jié)尾加入集

7、合類型 簡寫。如，sqlList, dataDic等。2.2 數(shù)據(jù)庫表命名規(guī)則命名方法：項目大寫首字母+_+功能（全英文大寫）【多單詞組成的，取單詞首字母大寫組合】表字段：類似變量命名索引：表名（或縮寫）+_+歹U名+idx注：ID創(chuàng)建人（creator）、創(chuàng)建時間（createTim©、狀態(tài) （state）、創(chuàng)建人工號（create。等字段為必須創(chuàng)建的字段；3、代碼規(guī)范3.1代碼分層結(jié)構(gòu)建議每個模塊中代碼至少分三層結(jié)構(gòu)，根據(jù)項目大小決定是否采用這種方式，可以先以一兩個 項目測試一下這種結(jié)構(gòu)；例如一個項目的一個模塊，可以創(chuàng)建文件夾結(jié)構(gòu)如下所示:j 3 MODELJEiT a app

8、< DAO < ,_J SERVICE <表現(xiàn)層貝囿*.aspx數(shù)據(jù)層*.cs邏輯層 *.cs表現(xiàn)層直接面向用戶，邏輯層負責后端邏輯處理，數(shù)據(jù)層負責和底層數(shù)據(jù)庫交互。邏輯層負責處理 數(shù)據(jù)層負責提供和 層實現(xiàn)。表現(xiàn)層調(diào)用邏輯層代碼，只有查詢數(shù)據(jù)時，表現(xiàn)層可以直接調(diào)用數(shù)據(jù)層； 邏輯，為表現(xiàn)層提供調(diào)用接口，其數(shù)據(jù)操作需要調(diào)用數(shù)據(jù)層提供接口； 處理數(shù)據(jù)，需要為邏輯層提供調(diào)用接口，所有與數(shù)據(jù)庫的操作都只能在該3.2編碼規(guī)范 3.2.1通用a）類功能必須唯一：每個文件中只有一個類（不包括內(nèi)部類）b）行寬限制在80個字符內(nèi)，必須按最低優(yōu)先級換行c） 方法代碼限制在200行內(nèi)d） 類代碼建議

9、限制在1500行內(nèi)e）方法參數(shù)過長，應(yīng)分行顯示，逗號至于末尾f） 每行聲明一個變量，且盡量賦初值，同類型必須連續(xù)寫g） 復(fù)合語句都需加大括號 ,不要寫在一行，if、else盡量配對出現(xiàn)，try、catch、finallyh）高扇入、合理扇出（盡量不超過三層）i） 縮進不允許空行j） 遞歸要慎用，goto不允許使用k） 方法內(nèi)禁止更改傳遞過來的參數(shù)l） 實體類中變量應(yīng)私有化，應(yīng)包含每個變量的set及get方法m）避免三層以上嵌套循環(huán)n）代碼應(yīng)包含正確性和容錯性處理（try、catch、finally）o）編程時應(yīng)考慮代碼的效率（時間、空間），多循環(huán)內(nèi)側(cè)，變量聲明放在循環(huán)外p）對象比較用對應(yīng)方法不

10、用"=",例如：equals, compare toq）計算盡量避免除法r） 設(shè)計方法可重用性s） else、finally> catch、日志必須有出口t） 堆常量統(tǒng)一定義，避免用常量字符串u）變量必須初始化3.2.2表現(xiàn)層頁面端1、JS代碼和CSS弋碼統(tǒng)一放置在 html的head子元素中;2、JS代碼需要有注釋；3、頁面控件有嵌套情況的，各級需要縮進，并且各級的頭尾對齊；頁面處理類1、頁面加載時謹慎處理Session置空；2、類中多處用到的變量建議創(chuàng)建成員變量，成員變量應(yīng)私有化（private）,位于類代碼上方；3、除用于 E 前臺調(diào)用的如 App.direct

11、 方法需為 public 外，其他方法建議均為 private ； 4、Page_Load 方法：建議將頁面加載方法中內(nèi)容加入if （!X.IsAjaxRequest）柿碼塊中，避免頁面每次操作后都調(diào)用Page_Load方法；5 、獲取頁面的服務(wù)端控件的值前需對控件值的null 和空進行判斷，避免空指針異常；6、避免過多或復(fù)雜的邏輯處理代碼，統(tǒng)一調(diào)用邏輯層代碼，將展現(xiàn)和邏輯分離；7、對數(shù)據(jù)的增刪改操作不要直接調(diào)用數(shù)據(jù)層，查詢可直接調(diào)用數(shù)據(jù)層代碼；3.2.3 邏輯層1、除對表現(xiàn)層提供的接口方法外，其他方法均保持私有private2、對數(shù)據(jù)庫數(shù)據(jù)處理調(diào)用數(shù)據(jù)處理層代碼3、對串行的數(shù)據(jù)處理時事務(wù)保證

12、4、邏輯代碼容錯性保證3.2.4 數(shù)據(jù)處理層1、除對外提供的接口方法外，其他方法均保持私有private2 、對數(shù)據(jù)庫的底層訪問（獲取數(shù)據(jù)庫連接、執(zhí)行 sql 語句、數(shù)據(jù)庫連接關(guān)閉）均調(diào)用數(shù)據(jù)庫操作幫助類3、數(shù)據(jù)處理層類中只處理數(shù)據(jù)，避免業(yè)務(wù)邏輯代碼4 、 sql 語句編寫時避免使用“+”5、數(shù)據(jù)庫操作幫助類中數(shù)據(jù)庫操作的容錯性和事務(wù)處理（插入、更新、刪除操作需要事務(wù)保證）4、注釋編寫任何代碼都需要有代碼注釋，并且代碼修改后也要修改注釋，保證代碼注釋同步。4.1 注釋模板設(shè)置在vs安裝目錄，以下目錄中，找到 class.cs文件，修改保存后，重啟vs,之后創(chuàng)建新類時即 會自動產(chǎn)生注釋。D:Pr

13、ogramFiles(x86)MicrosoftVisualStudio*10.0Common7IDEItemTemplatesCacheCSharpCode2052Class.zip. Copyri-ght <s> 2013 ECCVftCS Inc4 11 rights reserved!* 科浜斯Fl器人科技（蘇劉）有志公司using Svstez;using System*Cnllecticna,3eMric;Lf$ （rgeE£raaiewoici.,&rsion >= 3,Sensing kTtet.Li:iq： endiffusing Sih3

14、tein,Text;Ht* SIMCE : ? targe tfTdjne wo rcversicn$ 4 CREArOIl: 5u.ser?nainE$* DSkTE： St上皿與"/najnes£?ac?£ $E2ctnBE?Eapace $class $3afeitemroornraine$ （但是修改后沒有效果。4.2 手工添加注釋創(chuàng)建新對象可以手工添加注釋：注釋寫法: 塊注釋 注釋包含在/*和*/中，可以有多行。行注釋以開頭，可以有多行，每行前面都以開頭。文件頭注釋/* =* Copyright ? 2013 ECOVACS Inc. All right

15、s reserved!* 科沃斯機器人科技出州）有限公司*=*/類文件注釋*/* DESC :類功能描述* SINCE : .net 版本* CREATOR創(chuàng)建人* DATE:創(chuàng)建日期/*方法注釋DESC :方法功能描述PARAMS:參數(shù)說明 RETURN:返回值說明CREATOR創(chuàng)建人* DATE: 創(chuàng)建日期*/4.3 注釋要求a） 注釋量：20%30%,項目完成周期延長 20%b）注釋地方：段前以及當行之后1.0注：注釋中的內(nèi)容含創(chuàng)建人、述、返回值；上線后每個源c）上線之前無需版本號，上線之后需版本號，上線前統(tǒng)一為d） 注釋與自身方法之間不為空，其他方法必須為空e）注釋代碼在上線后全刪除，

16、上線后不允許無效代碼存在 創(chuàng)建時間、功能描述、參數(shù)說明、修改人、修改時間、修改描碼備份空間附件二、軟件需求申請表需求部門：申請人：用途描述目前工作狀態(tài)基本功能描述部門主管建議簽字確認 （時間）附件三、軟件開發(fā)申請表需求部門：申請人：具體功能模塊 說明目前工作流程項目完成所能 帶來的預(yù)期效 益（可節(jié)省的 人力、物力等）部門主管建議簽字確認 （時間）*附件四、項目組成成員表項目組成成員表Project Team Members一、項目基本情況項目名稱(Project Name :項目編號(Project Gode):制作人(Prepared ty):審核人(Reviewed y :項目經(jīng)理(Pro

17、ject Manager :制作日期（Data :二、項目組成員成員姓名Name項目角色Project Role所在部門Dept Name職責Responsibility項目起止日期 Data投入頻度及工作量Time聯(lián)系電話Tel No.主管經(jīng)理Supervisor簽字 Signature :日期Date:項目贊助人 Sponsor項目經(jīng)理 Project Manager項目角色包括項目贊助人（Sponsor）、項目經(jīng)理（Manager）、項目核心成員（Core team）和 項目非核心成員（Extended team）。附件五、項目策劃/任務(wù)書項目策劃/任務(wù)書Project Plan/Cha

18、rter一、項目基本情況項目名稱(Project Names):項目編號(Project Gode):制作人(Prepared by):審核人(Reviewed y :項目經(jīng)理(Project Manager ：制作日期（Data :二、項目描述1、項目背景與目的（所有的項目均起始于某個商業(yè)問題，該部分簡要描述這些問題）2、項目目標（包括質(zhì)量目標，工期目標、費用目標和交付產(chǎn)品特征與特征的主要描述）3、項目里程碑計劃（包含里程碑的時間和成果）4、評價標準（說明項目成果在何種情況下將被接受）5、項目假定與約束條件（說明項目的主要假設(shè)條件和限制性條件）6、項目主要利益干系人（包括高管、客戶、職能部門

19、主管、供應(yīng)商、項目贊助人、項目經(jīng)理、項目組成成員等干系人）姓名類別部門職務(wù)附件六、WBS表WBS表Project Work Breakdown Structure一、項目基本情況項目名稱(Project Names):項目編號(Project Gode):制作人(Prepared by):審核人(Reviewed y :項目經(jīng)理(Project Manager ：制作日期（Data :二、工作分解結(jié)構(gòu)分解代碼WBS Code任務(wù)名稱Task包含活動ActivitiesIncluded工時估算Estimate d Time人力資源Estimated HR其他資源EstimatedResource

20、費用估計Estimate d Cost工期ExpectedDays注：以上工期及費用估算均用最可能值*附件七、項目進度計劃表附件八、項目風險管理表項目風險表Project Risk Management一、項目基本情況項目名稱(Project Nane :項目編號(Project Code):制作人(Prepared by):審核人(Reviewed y :項目經(jīng)理(Project Manager :制作日期（Data :二、項目風險管理風險發(fā)生概率的判斷準則高風險：>60%發(fā)生風險的可能性中風險：30-60%發(fā)生風險的可能性低風F%: <30%發(fā)生風險的可能性序號Sequenc

21、e NO.風險描述Risk Description發(fā)生概率HappeningProbability影響程度Influence degree風險等級Risk Level風險響應(yīng)計劃Risk ResponsePlan責任人Risk owner開放/關(guān)閉Open/Close d附件九、項目溝通計劃表項目溝通計劃表Project Communication Plan一、項目基本情況項目名稱(Project Nane :項目編號(Project Gode):制作人(Prepared by):審核人(Reviewed y :項目經(jīng)理(Project Manager :制作日期（Data :二、項目溝通計劃

22、利益干系人Stakeholders所需信息Info Needed頻率Frequency方法Means責任人Risk owner附件十、項目會議紀要項目會議紀要Project Meeting Minutes一、基本情況會議名稱(Meeting Name):召集人（Called y :會議日期（Meeting DOe）:開始時間（Start ime）:會議地點(Meeting Place :持續(xù)時間(Meeting DuatOn):記錄人(Minutes By :審核人(Reviewed y :二、會議目標簡要說明會議的目標，包括期望達到的結(jié)果三、參加人員（列出參加會議的人員，他在項目中的頭銜或角

23、色）四、發(fā)放材料（列出會議討論的所有項目資料）五、發(fā)言記錄（記錄發(fā)言人的觀點、意見和建議）六、會議決議（說明會議結(jié)論）七、會議紀要發(fā)放范圍附件十一、項目狀態(tài)報告表項目狀態(tài)報告表一、項目基本情況項目名稱(Project Name):項目編號(Project (Ode):制作人(Prepared by):審核人(Reviewed y :項目經(jīng)理（Project Manager ：制作日期（Data :當前項目狀況按計劃進行口比計劃提前落后計劃匯報周期二、當前任務(wù)狀態(tài)（簡要描述任務(wù)進展情況）關(guān)鍵人物狀態(tài)指示狀態(tài)描述三、本周期內(nèi)的主要活動（對本周期內(nèi)的主要交付物進行總結(jié)）四、下一個匯報周期內(nèi)的活動計劃（描述活動需要與項目計劃和WBS相對應(yīng)）五、財務(wù)狀況六、上期遺留問題的處理（說明上一個匯報周期內(nèi)問題的處理意見和處理結(jié)果）本、本期問題與求助附件十二、項目變更管理表項目變更管理表Project Ch