東聯(lián)智勝軟件項(xiàng)目管理制度

1、軟件項(xiàng)目管理制度目 錄一、總述2二、項(xiàng)目計(jì)劃2三、項(xiàng)目組織3四、項(xiàng)目管理44.1、軟件開(kāi)發(fā)規(guī)范44.1.1、命名體系44.1.2、編碼風(fēng)格44.1.3、界面風(fēng)格44.1.4、版本控制54.1.5、通用約束54.1.6、開(kāi)發(fā)方法54.1.7、開(kāi)發(fā)流程54.1.8、交流制度64.1.9、代碼標(biāo)準(zhǔn)化管理64.1.10、備份制度64.1.11、文檔管理64.1.12、項(xiàng)目交付管理74.1.13、項(xiàng)目歸檔管理74.2、任務(wù)分解與分目標(biāo)制定74.3、進(jìn)度檢查與績(jī)效考評(píng)84.3.1、考評(píng)原則84.3.2、考評(píng)標(biāo)準(zhǔn)94.3.4、考評(píng)矩陣94.4、應(yīng)對(duì)一些突發(fā)事件（協(xié)調(diào)與調(diào)整）114.5、與有利害關(guān)系的人共享信

2、息11附錄4-1項(xiàng)目開(kāi)發(fā)計(jì)劃12附錄4-2軟件需求說(shuō)明書(shū)14附錄4-3詳細(xì)設(shè)計(jì)說(shuō)明書(shū)16附錄4-4 用戶(hù)手冊(cè)18附錄4-5數(shù)據(jù)要求說(shuō)明書(shū)21附錄4-6項(xiàng)目開(kāi)發(fā)總結(jié)報(bào)告23附錄5-1 JAVA編碼規(guī)范25附錄5-2 應(yīng)用結(jié)構(gòu)定義與命名規(guī)范31附錄5-3 數(shù)據(jù)庫(kù)對(duì)象命名規(guī)范31一、總述項(xiàng)目管理覆蓋整個(gè)項(xiàng)目生命周期，管理制度就是落實(shí)到管理過(guò)程中的一些基本要素，這里我們將其概括為三項(xiàng)基本業(yè)務(wù)： 、項(xiàng)目計(jì)劃 指明要取得的各種結(jié)果 指定進(jìn)度表 估計(jì)所需資源 、項(xiàng)目組織落實(shí)項(xiàng)目體系中的角色配置與角色的職責(zé)、項(xiàng)目管理 約束 任務(wù)分解與分目標(biāo)制定 進(jìn)度檢查與質(zhì)量評(píng)估 應(yīng)對(duì)一些突發(fā)事件（協(xié)調(diào)與調(diào)整） 與有利害關(guān)系

3、的人共享信息二、項(xiàng)目計(jì)劃項(xiàng)目計(jì)劃的結(jié)果體現(xiàn)為“項(xiàng)目開(kāi)發(fā)計(jì)劃”書(shū)面形式，其中要對(duì)開(kāi)發(fā)過(guò)程中各項(xiàng)工作的負(fù)責(zé)人、開(kāi)發(fā)進(jìn)度、進(jìn)度衡量的標(biāo)準(zhǔn)、完成進(jìn)度所需經(jīng)費(fèi)預(yù)算以及所需軟、硬件條件等問(wèn)題詳盡的羅列出來(lái)，以便根據(jù)本計(jì)劃開(kāi)展和檢查本項(xiàng)目的開(kāi)發(fā)工作。附錄4-1給出計(jì)劃書(shū)模板。三、項(xiàng)目組織項(xiàng)目組織包括項(xiàng)目角色定義、角色責(zé)任定義、角色間關(guān)系定義。角色定義是根據(jù)項(xiàng)目需求配置（調(diào)配、招聘）具備相應(yīng)素質(zhì)與能力的成員。角色責(zé)任定義就是將具體的任務(wù)分解到每個(gè)角色；角色間關(guān)系定義指明報(bào)告與檢查體系；一般情況下為三級(jí)組織：業(yè)務(wù)與商務(wù)協(xié)調(diào)組（商務(wù)洽談、目標(biāo)與進(jìn)度及資源定義與落實(shí)調(diào)整）產(chǎn)品經(jīng)理開(kāi)發(fā)組系統(tǒng)支持組負(fù)責(zé)主機(jī)、網(wǎng)絡(luò)、應(yīng)用

4、支撐軟件的安裝調(diào)試開(kāi)發(fā)經(jīng)理系統(tǒng)架構(gòu)組負(fù)責(zé)系統(tǒng)的體系結(jié)構(gòu)與應(yīng)用框架設(shè)計(jì)詳細(xì)設(shè)計(jì)組落實(shí)到具體語(yǔ)言的功能實(shí)現(xiàn)質(zhì)量控制組（負(fù)責(zé)功能、性能、可用性、可維護(hù)性、穩(wěn)定性、壓力測(cè)試）質(zhì)量經(jīng)理業(yè)務(wù)與商務(wù)協(xié)調(diào)組一般由客我雙方成員共同組成，負(fù)責(zé)項(xiàng)目的總體需求、總體目標(biāo)、里程碑，關(guān)鍵技術(shù)路徑定義。在制定項(xiàng)目總體目標(biāo)、里程碑定義與關(guān)鍵技術(shù)路徑時(shí)候要與開(kāi)發(fā)經(jīng)理聯(lián)合統(tǒng)籌，并以產(chǎn)品經(jīng)理意見(jiàn)為主。開(kāi)發(fā)組的責(zé)任人是開(kāi)發(fā)經(jīng)理，系統(tǒng)體系結(jié)構(gòu)與框架由開(kāi)發(fā)經(jīng)理與開(kāi)發(fā)組主力程序員聯(lián)合統(tǒng)籌，并以開(kāi)發(fā)經(jīng)理意見(jiàn)為主，具體功能實(shí)現(xiàn)一般以主力程序員（系統(tǒng)分析員、高級(jí)程序員）意見(jiàn)為主。“系統(tǒng)支持”屬于臨時(shí)調(diào)配，很可能是外部資源，但工作質(zhì)量由開(kāi)發(fā)經(jīng)理檢

5、查。質(zhì)量控制由質(zhì)量經(jīng)理、開(kāi)發(fā)經(jīng)理、產(chǎn)品經(jīng)理聯(lián)合統(tǒng)籌，以質(zhì)量經(jīng)理意見(jiàn)為主。整個(gè)項(xiàng)目生命周期中一般角色責(zé)任定義如下：軟件開(kāi)發(fā)可分為：過(guò)程、定義、設(shè)計(jì)、編碼、系統(tǒng)測(cè)試、接收、移植、運(yùn)行等過(guò)程。過(guò)程階段職責(zé)文檔成果描述角色定義需求定義問(wèn)題說(shuō)明書(shū)產(chǎn)品經(jīng)理/分析員開(kāi)始項(xiàng)目計(jì)劃項(xiàng)目規(guī)劃產(chǎn)品經(jīng)理/分析員設(shè)計(jì)設(shè)計(jì)方案設(shè)計(jì)說(shuō)明書(shū)技術(shù)經(jīng)理/分析員編碼編寫(xiě)程序編碼說(shuō)明書(shū)技術(shù)經(jīng)理/程序員將程序集成到系統(tǒng)中集成測(cè)試說(shuō)明書(shū)程序員測(cè)試驗(yàn)證系統(tǒng)功能與性能系統(tǒng)測(cè)試說(shuō)明書(shū)質(zhì)量經(jīng)理/測(cè)試員接收向客戶(hù)演示系統(tǒng)操作說(shuō)明書(shū)產(chǎn)品經(jīng)理/客戶(hù)移植移植最終運(yùn)行環(huán)境移植說(shuō)明書(shū)技術(shù)經(jīng)理/程序員數(shù)據(jù)采集及導(dǎo)入程序員運(yùn)行用戶(hù)培訓(xùn)用戶(hù)培訓(xùn)文檔產(chǎn)品經(jīng)理/用戶(hù)

6、監(jiān)控系統(tǒng)運(yùn)行性能用戶(hù)/分析員四、項(xiàng)目管理 4.1、軟件開(kāi)發(fā)規(guī)范這里只是給出我司軟件開(kāi)發(fā)必須遵從的原則，具體內(nèi)容應(yīng)該由產(chǎn)品經(jīng)理或開(kāi)發(fā)經(jīng)理根據(jù)具體項(xiàng)目制定詳盡約定。在羅列規(guī)范之前，開(kāi)發(fā)組織（團(tuán)隊(duì)）必須遵從一個(gè)最基本的約定統(tǒng)一開(kāi)發(fā)環(huán)境：OS:操作系統(tǒng);IDE：集成開(kāi)發(fā)工具;DEBUG：調(diào)試工具;SC：源代碼控制器；IM:即時(shí)交流工具；DD:文檔工具（計(jì)劃，任務(wù)，報(bào)告）；ASM:間接交流工具，一般以mail為主。另外還要為團(tuán)隊(duì)固定一些一些角色，builder / Server administrator（dba&osa）。嚴(yán)格區(qū)分開(kāi)發(fā)平臺(tái)與生產(chǎn)平臺(tái)之間的界限（安全、測(cè)試、性能）4.1.1、命名

7、體系A(chǔ)) 數(shù)據(jù)庫(kù)與數(shù)據(jù)庫(kù)對(duì)象命名;B) 開(kāi)發(fā)語(yǔ)言的元素命名(類(lèi)、對(duì)象、文件、命名空間、組件、函數(shù)、方法等)；C) 頁(yè)面與頁(yè)面元素命名.D) 文件目錄體系4.1.2、編碼風(fēng)格縮進(jìn)、換行、塊大小、文件大小、注釋4.1.3、界面風(fēng)格組件類(lèi)別、大小、前景、背景、字體、鼠標(biāo)敏感、邊框、布局4.1.4、版本控制創(chuàng)建權(quán)限、創(chuàng)建分之權(quán)限、更新頻度、提交準(zhǔn)則。4.1.5、通用約束向?qū)гO(shè)置、數(shù)據(jù)校驗(yàn)、提示信息、響應(yīng)時(shí)間與響應(yīng)方式4.1.6、開(kāi)發(fā)方法鑒于用戶(hù)需求的不容易澄清性與變動(dòng)頻繁這一特點(diǎn)，所有項(xiàng)目均采用迭代開(kāi)發(fā)方法。這就是說(shuō)不要指望在明確的需求調(diào)研階段能把問(wèn)題搞清楚，弄清楚個(gè)大概即可，以不超過(guò)兩周的迭代間隔快

8、速的交互原型，以便反饋更進(jìn)一步的需求、這樣一步步逼近用戶(hù)的真實(shí)想法。這里要特別強(qiáng)調(diào)的是多與用戶(hù)交流，項(xiàng)目組內(nèi)有關(guān)設(shè)計(jì)方法與策略也要頻繁地交流。4.1.7、開(kāi)發(fā)流程純粹從開(kāi)發(fā)的角度我們將項(xiàng)目周期劃分為兩個(gè)階段，每個(gè)階段要完成的的如下：4.1.8、交流制度項(xiàng)目組每周至少要進(jìn)行不少于兩次的集體交流，否則就是開(kāi)發(fā)經(jīng)理或產(chǎn)品經(jīng)理失職（交流不限制時(shí)間長(zhǎng)短、方式、內(nèi)容可以從需要到設(shè)計(jì)到實(shí)現(xiàn)、甚至是抱怨）。4.1.9、代碼標(biāo)準(zhǔn)化管理小組內(nèi)成員必須開(kāi)展互測(cè)，產(chǎn)品經(jīng)理要督促進(jìn)行。如果一般性的缺陷被質(zhì)量組測(cè)試發(fā)現(xiàn)，產(chǎn)品經(jīng)理可以作出警告、取消休假、扣發(fā)獎(jiǎng)金等處理措施。產(chǎn)品經(jīng)理或開(kāi)發(fā)經(jīng)理可抽查成員代碼，對(duì)比規(guī)范作出人員

9、基本技術(shù)素養(yǎng)評(píng)測(cè)，計(jì)入期末（項(xiàng)目結(jié)束）考核（去留）。4.1.10、備份制度應(yīng)用系統(tǒng)的所有資料代碼（程序、腳本塊、數(shù)據(jù)庫(kù)腳本）、文檔、數(shù)據(jù)，除了數(shù)據(jù)以外，全部納入源代碼控制系統(tǒng)。數(shù)據(jù)每天備份一次媒介是磁盤(pán)，代碼（程序腳本、數(shù)據(jù)庫(kù)腳本）、文檔每周一次媒介是磁盤(pán)，所有信息每月備份一次媒介是光盤(pán)，并在開(kāi)發(fā)經(jīng)理處填寫(xiě)備份記錄表格。（備份時(shí)間、備份類(lèi)型、備份目標(biāo)、備份人簽字）4.1.11、文檔管理沒(méi)有文檔的軟件是一種災(zāi)難。代碼不是傳達(dá)系統(tǒng)原理和結(jié)構(gòu)的理想媒介；開(kāi)發(fā)團(tuán)隊(duì)更需要編制易于閱讀的文擋，來(lái)對(duì)系統(tǒng)及其設(shè)計(jì)決策的依據(jù)進(jìn)行描述。 然而，過(guò)多的文檔比過(guò)少的文檔更糟。編制眾多的文檔需要花費(fèi)大量的時(shí)間，并且要使

10、這些文檔和代碼保持同步：就要花費(fèi)更多的時(shí)間。如果文檔和代碼之間失去同步，那么文檔就會(huì)變成龐大的、復(fù)雜的謊言會(huì)造成重大的誤導(dǎo)； 對(duì)于團(tuán)隊(duì)來(lái)說(shuō)，編寫(xiě)并維護(hù)一份系統(tǒng)原理和結(jié)構(gòu)方而的文擋將總是一個(gè)好主張，但是那份文檔應(yīng)該是短小、突出主題的。為此我們擬定所有項(xiàng)目都必須編制以下文檔。1項(xiàng)目開(kāi)發(fā)計(jì)劃書(shū)，模板見(jiàn)附錄4-12軟件需求說(shuō)明書(shū)，模板見(jiàn)附錄4-23詳細(xì)設(shè)計(jì)說(shuō)明書(shū)，模板見(jiàn)附錄4-34用戶(hù)手冊(cè)，模板見(jiàn)附錄4-45數(shù)據(jù)庫(kù)需求說(shuō)明，模板見(jiàn)附錄4-56項(xiàng)目開(kāi)發(fā)總結(jié)報(bào)告，模板見(jiàn)附錄4-64.1.12、項(xiàng)目交付管理軟件交付應(yīng)用，源代碼文檔交付視技術(shù)合同要求交付的內(nèi)容而定運(yùn)行維護(hù)技術(shù)交付：系統(tǒng)、數(shù)據(jù)庫(kù)、應(yīng)用的日常管理

11、與維護(hù)。系統(tǒng)安全性交付：操作系統(tǒng)管理與應(yīng)用賬號(hào)、數(shù)據(jù)庫(kù)管理與應(yīng)用開(kāi)發(fā)賬號(hào)、應(yīng)用服務(wù)器的管理與應(yīng)用開(kāi)發(fā)賬號(hào)。4.1.13、項(xiàng)目歸檔管理項(xiàng)目執(zhí)行過(guò)程的所有資料程序、腳本、數(shù)據(jù)、文檔以光盤(pán)作媒介，并附上資料清單，交給公司行政部。4.2、任務(wù)分解與分目標(biāo)制定組織中的負(fù)責(zé)人負(fù)責(zé)具體的任務(wù)分解并落實(shí)到組織中的每個(gè)人。形式如下：軟件開(kāi)發(fā)任務(wù)單項(xiàng)目名稱(chēng)： 任務(wù)編號(hào)_子項(xiàng)名稱(chēng)按“子系統(tǒng)模塊功能”最多三級(jí)劃分功能描述技術(shù)要求復(fù)雜度（業(yè)務(wù)與技術(shù)兩個(gè)層次）任務(wù)發(fā)出人任務(wù)承接人限時(shí)開(kāi)始yyyy/MMdd限時(shí)結(jié)束yyyy/MMdd考核標(biāo)準(zhǔn)（百分制）分值考評(píng)項(xiàng)目301、時(shí)效性：（是否按時(shí)完成）402、客戶(hù)關(guān)注點(diǎn)：（功能、可

12、靠性、易用性、高效性、可維護(hù)性、可移植性）表現(xiàn)如何103、規(guī)范與標(biāo)準(zhǔn)54、復(fù)用與創(chuàng)新85、團(tuán)隊(duì)精神26、奉獻(xiàn)精神57、溝通精神4.3、進(jìn)度檢查與績(jī)效考評(píng)4.3.1、考評(píng)原則軟件開(kāi)發(fā)人員的績(jī)效考評(píng)要求遵循以下六條原則：1、 被考核對(duì)象必須有明確的任務(wù)產(chǎn)品經(jīng)理或開(kāi)發(fā)經(jīng)理必須發(fā)出明確的任務(wù)書(shū)：任務(wù)書(shū)中指定任務(wù)名稱(chēng)、任務(wù)內(nèi)容、完成時(shí)限、考核標(biāo)準(zhǔn)、向誰(shuí)負(fù)責(zé)、任務(wù)的難易程度（業(yè)務(wù)與技術(shù)兩個(gè)方面）。難易程度由項(xiàng)目組成員集體評(píng)價(jià)。沒(méi)有明確的任務(wù)當(dāng)然就無(wú)法考評(píng)（見(jiàn)軟件任務(wù)開(kāi)發(fā)單）。2、 考評(píng)標(biāo)準(zhǔn)要綜合計(jì)量量與非計(jì)量量。計(jì)量量如：完成時(shí)間、完成了多少功能、測(cè)試出多少缺陷等，非計(jì)量量如：用戶(hù)接受程度如何、項(xiàng)目組合作

13、情況如何等等，要將這些因素綜合考慮。3、 要體現(xiàn)多勞多得、獎(jiǎng)勤罰懶。高效、高質(zhì)完成任務(wù)的人員必須得到區(qū)別對(duì)待（調(diào)資、休假、獎(jiǎng)金）。4、 考評(píng)結(jié)果要及時(shí)與被考評(píng)對(duì)象溝通，容許爭(zhēng)議協(xié)調(diào)。5、 考評(píng)時(shí)間不得跨度太大一般為兩周一次，不符合這種周期的，產(chǎn)品經(jīng)理與開(kāi)發(fā)經(jīng)理需要適當(dāng)對(duì)任務(wù)做進(jìn)一步分解。6、 被考評(píng)要提供周報(bào)月報(bào)之類(lèi)的內(nèi)容周報(bào)、月報(bào)不作為考評(píng)的依據(jù)，只注重結(jié)果，也就是說(shuō)根據(jù)結(jié)果認(rèn)定過(guò)程。4.3.2、考評(píng)標(biāo)準(zhǔn)1、 時(shí)效性：不管是承攬項(xiàng)目還是產(chǎn)品研發(fā)都有一定的時(shí)間限定，愈期就意味著成本增加甚至是失敗。所以能否按時(shí)完成任務(wù)是績(jī)效考評(píng)的一個(gè)重要標(biāo)致。2、 客戶(hù)關(guān)注點(diǎn)客戶(hù)關(guān)注點(diǎn)也就是軟件的品質(zhì)，涉及的內(nèi)

14、容很多，按國(guó)家標(biāo)準(zhǔn)分為六個(gè)層面，即：功能、可靠性、易用性、高效性、可維護(hù)性、可移植性。這六個(gè)項(xiàng)目的次序也就是我們考察的順序，首先必須完成功能，然后再衡量功能是否可靠，再然后才其他幾個(gè)方面，以百分制來(lái)衡量，這六個(gè)指標(biāo)的比例是50,25,15,10,5,5。也就是說(shuō)必須保證前四項(xiàng)。而功能、可靠性又是重中之重75%。3、 規(guī)范與標(biāo)準(zhǔn)不以規(guī)矩不能成方園，不遵從標(biāo)準(zhǔn)的與規(guī)范的設(shè)計(jì)開(kāi)發(fā)必將造成巨大的維護(hù)成本與技術(shù)積累成本，同時(shí)也給軟件交流與究錯(cuò)設(shè)置障礙，所以必須強(qiáng)調(diào)規(guī)范化與標(biāo)準(zhǔn)化。4、 復(fù)用與創(chuàng)新性這是軟件開(kāi)發(fā)人員設(shè)計(jì)與開(kāi)發(fā)綜合能力的一個(gè)集中體現(xiàn)。5、 團(tuán)隊(duì)精神沒(méi)有團(tuán)隊(duì)精神的軟件開(kāi)發(fā)人員堅(jiān)決辭退。開(kāi)發(fā)過(guò)程

15、中團(tuán)隊(duì)精神主要表現(xiàn)在：一、對(duì)測(cè)試出的問(wèn)題是互相推委，還是協(xié)商解決；二、接口設(shè)計(jì)各行其事還是共同制訂；三、發(fā)現(xiàn)他人犯錯(cuò)是善意提醒還是沉默不語(yǔ)；四、不注重版本管理。6、 奉獻(xiàn)精神任務(wù)比較緊張時(shí)候，是否不計(jì)較個(gè)人得失主動(dòng)加班加點(diǎn)趕任務(wù)。7、 溝通精神不懂問(wèn)題是拖延時(shí)間還是主動(dòng)尋求幫助，技術(shù)經(jīng)驗(yàn)是否主動(dòng)分享。4.3.4、考評(píng)矩陣成都東聯(lián)智勝有限公司 Page 34 3/5/2022開(kāi)發(fā)人員當(dāng)期任務(wù)評(píng)測(cè)表任務(wù)書(shū)編號(hào)：項(xiàng)目指標(biāo)時(shí)效率按時(shí)未按時(shí)X%(X=100)完成未完成X%Y%客戶(hù)關(guān)注點(diǎn)功能可靠易用性能維護(hù)移植功能可靠易用性能維護(hù)移植A50%B25%C15%D10%E5%F5%A50%B25%C15%D1

16、0%E5%F5%規(guī)范與標(biāo)準(zhǔn)好中差G610G4G=0復(fù)用與創(chuàng)新性好中差H35H2H=0團(tuán)隊(duì)精神好中差I(lǐng)58I4I02奉獻(xiàn)精神好中差J1.52.0J=0.5J=0.0溝通精神好中差K35K2K=0.0記分(30 + (A+B+C+D+E+F)*40+G+H+I+J+K)*X%功能：實(shí)現(xiàn)的結(jié)果是否體現(xiàn)的客戶(hù)的意圖，與客戶(hù)意圖之間的差距（x%）, 功能測(cè)評(píng)比例(1-x%)*50%可靠性：主要以測(cè)試出的缺陷多少來(lái)衡量，如果一個(gè)最低級(jí)功能被測(cè)出超過(guò)三個(gè)缺陷，可靠性為零。易用性：重要從數(shù)據(jù)校驗(yàn)與否、出錯(cuò)提示信息明細(xì)程度，輸入數(shù)據(jù)量多少，是否符合輸入習(xí)慣四個(gè)方面進(jìn)行衡量；性能：主要是響應(yīng)速度可維護(hù)性與可移植性

17、要看與規(guī)范與標(biāo)準(zhǔn)的差距4.4、應(yīng)對(duì)一些突發(fā)事件（協(xié)調(diào)與調(diào)整）項(xiàng)目可能造成的結(jié)果人員流動(dòng)招聘、調(diào)配、項(xiàng)目延期突發(fā)性需求商務(wù)談判、項(xiàng)目延期技術(shù)更新利潤(rùn)損失、技術(shù)積累損失、項(xiàng)目延期法律問(wèn)題無(wú)法進(jìn)展其它4.5、與有利害關(guān)系的人共享信息項(xiàng)目共享范圍一般信息共享核心信息有限共享專(zhuān)有信息不共享 附錄4-1項(xiàng)目開(kāi)發(fā)計(jì)劃 編制項(xiàng)目開(kāi)發(fā)計(jì)劃的目的是用文件的形式，把對(duì)于在開(kāi)發(fā)過(guò)程中各項(xiàng)工作的負(fù)責(zé)人員、開(kāi)發(fā)進(jìn)度、 所需經(jīng)費(fèi)預(yù)算、所需軟、硬件條件等問(wèn)題作出的安排記載下來(lái)，以便根據(jù)本計(jì)劃開(kāi)展和檢查本項(xiàng)目的開(kāi)發(fā)工作。編制內(nèi)容要求如下：1引言11編寫(xiě)目的 說(shuō)明編寫(xiě)這份項(xiàng)目開(kāi)發(fā)計(jì)劃的目的，并指出預(yù)期的讀者。12背景說(shuō)明：a待開(kāi)

18、發(fā)的軟件系統(tǒng)的名稱(chēng)；b本項(xiàng)目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)及實(shí)現(xiàn)該軟件的計(jì)算中心或計(jì)算機(jī)網(wǎng)絡(luò)；C該軟件系統(tǒng)同其他系統(tǒng)或其他機(jī)構(gòu)的基本的相互來(lái)往關(guān)系。13定義 列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。14參考資料列出用得著的參考資料，如：a本項(xiàng)目的經(jīng)核準(zhǔn)的計(jì)劃任務(wù)書(shū)或合同、上級(jí)機(jī)關(guān)的批文；b屬于本項(xiàng)目的其他已發(fā)表的文件；C本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標(biāo)準(zhǔn)。 列出這些文件資料的標(biāo)題、文件編號(hào)、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。2項(xiàng)目概述 21 工作內(nèi)容簡(jiǎn)要地說(shuō)明在本項(xiàng)目的開(kāi)發(fā)中須進(jìn)行的各項(xiàng)主要工作。22主要參加人員扼要說(shuō)明參加本項(xiàng)目開(kāi)發(fā)工作的

19、主要人員的情況，包括他們的技術(shù)水平。23產(chǎn)品231程序列出需移交給用戶(hù)的程序的名稱(chēng)、所用的編程語(yǔ)言及存儲(chǔ)程序的媒體形式，并通過(guò)引用有關(guān)文件， 逐項(xiàng)說(shuō)明其功能和能力。 232文件列出需移交給用戶(hù)的每種文件的名稱(chēng)及內(nèi)容要點(diǎn)。 233服務(wù)列出需向用戶(hù)提供的各項(xiàng)服務(wù)，如培訓(xùn)安裝、維護(hù)和運(yùn)行支持等，應(yīng)逐項(xiàng)規(guī)定開(kāi)始日期、所提供支持 的級(jí)別和服務(wù)的期限。234非移交的產(chǎn)品 說(shuō)明開(kāi)發(fā)集體應(yīng)向本單位交出但不必向用戶(hù)移交的產(chǎn)品（文件甚至某些程序）。24驗(yàn)收標(biāo)準(zhǔn) 對(duì)于上述這些應(yīng)交出的產(chǎn)品和服務(wù)，逐項(xiàng)說(shuō)明或引用資料說(shuō)明驗(yàn)收標(biāo)準(zhǔn)。25完成項(xiàng)目的員遲用限 26本計(jì)劃的批準(zhǔn)者和批準(zhǔn)日期 3實(shí)施計(jì)劃 31工作任務(wù)的分門(mén)與人員

20、分工 對(duì)于項(xiàng)目開(kāi)發(fā)中需完成的各項(xiàng)工作，從需求分析、設(shè)計(jì)、實(shí)現(xiàn)、測(cè)試直到維護(hù)，包括文件的編制、審批、打印、分發(fā)工作，用戶(hù)培訓(xùn)工作，軟件安裝工作等，按層次進(jìn)行分解，指明每項(xiàng)任務(wù)的負(fù)責(zé)人和參加人員。32 接口人員說(shuō)明負(fù)責(zé)接口工作的人員及他們的職責(zé)，包括：a 負(fù)責(zé)本項(xiàng)目同用戶(hù)的接口人員；b負(fù)責(zé)本項(xiàng)目同本單位各管理機(jī)構(gòu)，如合同計(jì)劃管理部門(mén)、財(cái)務(wù)部門(mén)、質(zhì)量管理部門(mén)等的接口人員； c負(fù)責(zé)本項(xiàng)目同各分合同負(fù)責(zé)單位的接口人員等。 33進(jìn)度 對(duì)于需求分析、設(shè)計(jì)、編碼實(shí)現(xiàn)、測(cè)試、移交、培訓(xùn)和安裝等工作，給出每項(xiàng)工作任務(wù)的預(yù)。定開(kāi)始日期、完成日期及所需資源，規(guī)定各項(xiàng)工作任務(wù)完成的先后順序以及表征每項(xiàng)工作任務(wù)完成的標(biāo)志

21、性事件（即所謂"里程碑"）。 34預(yù)算 逐項(xiàng)列出本開(kāi)發(fā)項(xiàng)目所需要的勞務(wù)（包括人員的數(shù)量和時(shí)間）以及經(jīng)費(fèi)的預(yù)算（包括辦公費(fèi)、差旅費(fèi)、機(jī)時(shí)費(fèi)、資料費(fèi)、通訊設(shè)備和專(zhuān)用設(shè)備的租金等）和來(lái)源。35關(guān)鍵問(wèn)題逐項(xiàng)列出能夠影響整個(gè)項(xiàng)目成敗的關(guān)鍵問(wèn)題、技術(shù)難點(diǎn)和風(fēng)險(xiǎn)，指出這些問(wèn)題對(duì)項(xiàng)目的影響。4支持條件說(shuō)明為支持本項(xiàng)目的開(kāi)發(fā)所需要的各種條件和設(shè)施。41計(jì)算機(jī)系統(tǒng)支持逐項(xiàng)列出開(kāi)發(fā)中和運(yùn)行時(shí)所需的計(jì)算機(jī)系統(tǒng)支持，包括計(jì)算機(jī)、外圍設(shè)備、通訊設(shè)備、模擬器、編譯 （或 匯編）程序、操作系統(tǒng)、數(shù)據(jù)管理程序包、數(shù)據(jù)存儲(chǔ)能力和測(cè)試支持能力等，逐項(xiàng)給出有關(guān)到貨日期、 使用時(shí)間的要求。42需由用戶(hù)承擔(dān)的工作逐項(xiàng)

22、列出需要用戶(hù)承擔(dān)的工作和完成期限。包括需由用戶(hù)提供的條件及提供時(shí)間。43由外單位提供的條件 逐項(xiàng)列出需要外單位分合同承包者承擔(dān)的工作和完成的時(shí)間，包括需要由外單位提供的條件和提 供的時(shí)間。 5專(zhuān)題計(jì)劃要點(diǎn)說(shuō)明本項(xiàng)目開(kāi)發(fā)中需制訂的各個(gè)專(zhuān)題計(jì)劃（如分合同計(jì)劃、開(kāi)發(fā)人員培訓(xùn)計(jì)劃、測(cè)試計(jì)劃、安全保密 計(jì)劃、質(zhì)量保證計(jì)劃、配置管理計(jì)劃、用戶(hù)培訓(xùn)計(jì)劃、系統(tǒng)安裝計(jì)劃等）的要點(diǎn)。附錄4-2軟件需求說(shuō)明書(shū) 軟件需求說(shuō)明書(shū)的編制是為了使用戶(hù)和軟件開(kāi)發(fā)者雙方對(duì)該軟件的初始規(guī)定有一個(gè)共同的理解， 使之成為整個(gè)開(kāi)發(fā)工作的基礎(chǔ)。編制軟件需求說(shuō)明書(shū)的內(nèi)容要求如下：1引言11編寫(xiě)目的說(shuō)明編寫(xiě)這份軟件需求說(shuō)明書(shū)的目的，指出預(yù)期

23、的讀者。12背景 說(shuō)明： a待開(kāi)發(fā)的軟件系統(tǒng)的名稱(chēng)；b本項(xiàng)目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)及實(shí)現(xiàn)該軟件的計(jì)算中心或計(jì)算機(jī)網(wǎng)絡(luò)；C該軟件系統(tǒng)同其他系統(tǒng)或其他機(jī)構(gòu)的基本的相互來(lái)往關(guān)系。 13定義列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。14參考資料 列出用得著的參考資料，如：a本項(xiàng)目的經(jīng)核準(zhǔn)的計(jì)劃任務(wù)書(shū)或合同、上級(jí)機(jī)關(guān)的批文；b屬于本項(xiàng)目的其他已發(fā)表的文件；c本文件中各處引用的文件、資料、包括所要用到的軟件開(kāi)發(fā)標(biāo)準(zhǔn)。 列出這些文件資料的標(biāo)題、文件編號(hào)、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。2任務(wù)概述 21目標(biāo) 敘述該項(xiàng)軟件開(kāi)發(fā)的意圖、應(yīng)用目標(biāo)、作用范圍以及其他應(yīng)向讀者說(shuō)明

24、的有關(guān)該軟件開(kāi)發(fā)的背景材料。解釋被開(kāi)發(fā)軟件與其他有關(guān)軟件之間的關(guān)系。如果本軟件產(chǎn)品是一項(xiàng)獨(dú)立的軟件，而且全部?jī)?nèi)容自含，則說(shuō)明這一點(diǎn)。如果所定義的產(chǎn)品是一個(gè)更大的系統(tǒng)的一個(gè)組成部分，則應(yīng)說(shuō)明本產(chǎn)品與該系統(tǒng)中其他各組成部分之間的關(guān)系，為此可使用一張方框圖來(lái)說(shuō)明該系統(tǒng)的組成和本產(chǎn)品同其他各部分的聯(lián)系和接口。|22用戶(hù)的特點(diǎn) 列出本軟件的最終用戶(hù)的特點(diǎn)，充分說(shuō)明操作人員、維護(hù)人員的教育水平和技術(shù)專(zhuān)長(zhǎng)，以及本軟件的預(yù)期使甩頻度。這些是軟件設(shè)計(jì)工作的重要約束23假定和約束列出進(jìn)行本軟件開(kāi)發(fā)工作的假定和約束，例如經(jīng)費(fèi)限制、開(kāi)發(fā)期限等。3需求規(guī)定 31對(duì)功能的規(guī)定用列表的方式（例如IPO表即輸入、處理、輸出表

25、的形式），逐項(xiàng)定量和定性地?cái)⑹鰧?duì)軟件所提出的功能要求，說(shuō)明輸入什么量、經(jīng)怎樣的處理、得到什么輸出，說(shuō)明軟件應(yīng)支持的終端數(shù)和應(yīng)支持的并行操作的用戶(hù)數(shù)。 32對(duì)性能的規(guī)定321精度 說(shuō)明對(duì)該軟件的輸入、輸出數(shù)據(jù)精度的要求，可能包括傳輸過(guò)程中的精度。322時(shí)間特性要求 說(shuō)明對(duì)于該軟件的時(shí)間特性要求，如對(duì)：a響應(yīng)時(shí)間；b更新處理時(shí)間；c數(shù)據(jù)的轉(zhuǎn)換和傳送時(shí)間；d解題時(shí)間； 等的要求。323靈活性 說(shuō)明對(duì)該軟件的靈活性的要求，即當(dāng)需求發(fā)生某些變化時(shí)，該軟件對(duì)這些變化的適應(yīng)能力，如：a操作方式上的變化；b運(yùn)行環(huán)境的變化； c同其他軟件的接口的變化；d精度和有效時(shí)限的變化； e計(jì)劃的變化或改進(jìn)。 對(duì)于為了提供

26、這些靈活性而進(jìn)行的專(zhuān)門(mén)設(shè)計(jì)的部分應(yīng)該加以標(biāo)明。33輸人輸出要求解釋各輸入輸出數(shù)據(jù)類(lèi)型，并逐項(xiàng)說(shuō)明其媒體、格式、數(shù)值范圍、精度等。對(duì)軟件的數(shù)據(jù)輸出及必須標(biāo)明的控制輸出量進(jìn)行解釋并舉例，包括對(duì)硬拷貝報(bào)告（正常結(jié)果輸出、狀態(tài)輸出及異常輸出）以及圖形或顯示報(bào)告的描述。34數(shù)據(jù)管理能力要求 說(shuō)明需要管理的文卷和記錄的個(gè)數(shù)、表和文卷的大小規(guī)模，要按可預(yù)見(jiàn)的增長(zhǎng)對(duì)數(shù)據(jù)及其分量的存儲(chǔ)要求作出估算。 35故障處理要求列出可能的軟件、硬件故障以及對(duì)各項(xiàng)性能而言所產(chǎn)生的后果和對(duì)故障處理的要求。36其他專(zhuān)門(mén)要求如用戶(hù)單位對(duì)安全保密的要求，對(duì)使用方便的要求，對(duì)可維護(hù)性、可補(bǔ)充性、易讀性、可靠性、運(yùn)行環(huán)境可轉(zhuǎn)換性的特殊要

27、求等。 4運(yùn)行環(huán)境規(guī)定 41設(shè)備 列出運(yùn)行該軟件所需要的硬設(shè)備。說(shuō)明其中的新型設(shè)備及其專(zhuān)門(mén)功能，包括：a處理器型號(hào)及內(nèi)存容量；b外存容量、聯(lián)機(jī)或脫機(jī)、媒體及其存儲(chǔ)格式，設(shè)備的型號(hào)及數(shù)量；c輸入及輸出設(shè)備的型號(hào)和數(shù)量，聯(lián)機(jī)或脫機(jī)； d數(shù)據(jù)通信設(shè)備的型號(hào)和數(shù)量；e功能鍵及其他專(zhuān)用硬件42支持軟件 列出支持軟件,包括要用到的操作系統(tǒng)、編譯（或匯編）程序、測(cè)試支持軟件等。43 接口說(shuō)明該軟件同其他軟件之間的接口、數(shù)據(jù)通信協(xié)議等。44控制 說(shuō)明控制該軟件的運(yùn)行的方法和控制信號(hào)，并說(shuō)明這些控制信號(hào)的來(lái)源。 附錄4-3詳細(xì)設(shè)計(jì)說(shuō)明書(shū) 1 引言 11編寫(xiě)目的說(shuō)明編寫(xiě)這份詳細(xì)設(shè)計(jì)說(shuō)明書(shū)的目的，指出預(yù)期的讀者。1

28、2背景 說(shuō)明：a待開(kāi)發(fā)軟件系統(tǒng)的名稱(chēng)； b本項(xiàng)目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)和運(yùn)行該程序系統(tǒng)的計(jì)算中心。 13定義 列出本文件中用到專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。14參考資料 列出有關(guān)的參考資料，如： a本項(xiàng)目的經(jīng)核準(zhǔn)的計(jì)劃任務(wù)書(shū)或合同、上級(jí)機(jī)關(guān)的批文；b屬于本項(xiàng)目的其他已發(fā)表的文件；c本文件中各處引用到的文件資料，包括所要用到的軟件開(kāi)發(fā)標(biāo)準(zhǔn)。 列出這些文件的標(biāo)題、文件編號(hào)、發(fā)表日期和出版單位，說(shuō)明能夠取得這些文件的來(lái)源。2程序系統(tǒng)的結(jié)構(gòu)用一系列圖表列出本程序系統(tǒng)內(nèi)的每個(gè)程序（包括每個(gè)模塊和子程序）的名稱(chēng)、標(biāo)識(shí)符和它們之間 的層次結(jié)構(gòu)關(guān)系。3程序1（標(biāo)識(shí)符）設(shè)計(jì)說(shuō)明 從本章開(kāi)始，逐個(gè)地

29、給出各個(gè)層次中的每個(gè)程序的設(shè)計(jì)考慮。以下給出的提綱是針對(duì)一般情況的。 對(duì)于一個(gè)具體的模塊，尤其是層次比較低的模塊或子程序，其很多條目的內(nèi)容往往與它所隸屬的上一層 模塊的對(duì)應(yīng)條目的內(nèi)容相同，在這種情況下，只要簡(jiǎn)單地說(shuō)明這一點(diǎn)即可。 31程序描述 給出對(duì)該程序的簡(jiǎn)要描述，主要說(shuō)明安排設(shè)計(jì)本程序的目的意義，并且，還要說(shuō)明本程序的特點(diǎn)（如 是常駐內(nèi)存還是非常駐？是否子程序？是可重人的還是不可重人的？有無(wú)覆蓋要求？是順序處理還是并發(fā) 處理卜等）。32功能 說(shuō)明該程序應(yīng)具有的功能，可采用IPO圖（即輸入一處理一輸出圖）的形式。33性能說(shuō)明對(duì)該程序的全部性能要求，包括對(duì)精度、靈活性和時(shí)間特性的要求。34輸人

30、項(xiàng) 給出對(duì)每一個(gè)輸入項(xiàng)的特性，包括名稱(chēng)、標(biāo)識(shí)、數(shù)據(jù)的類(lèi)型和格式、數(shù)據(jù)值的有效范圍、輸入的方式。 數(shù)量和頻度、輸入媒體、輸入數(shù)據(jù)的來(lái)源和安全保密條件等等。3 5輸出項(xiàng) 給出對(duì)每一個(gè)輸出項(xiàng)的特性，包括名稱(chēng)、標(biāo)識(shí)、數(shù)據(jù)的類(lèi)型和格式，數(shù)據(jù)值的有效范圍，輸出的形式、 數(shù)量和頻度，輸出媒體、對(duì)輸出圖形及符號(hào)的說(shuō)明、安全保密條件等等。36算法 詳細(xì)說(shuō)明本程序所選用的算法，具體的計(jì)算公式和計(jì)算步驟。37流程邏輯 用圖表（例如流程圖、判定表等）輔以必要的說(shuō)明來(lái)表示本程序的邏輯流程。38接口用圖的形式說(shuō)明本程序所隸屬的上一層模塊及隸屬于本程序的下一層模塊、子程序，說(shuō)明參數(shù)賦值和調(diào)用方式，說(shuō)明與本程序相直接關(guān)聯(lián)的數(shù)

31、據(jù)結(jié)構(gòu)（數(shù)據(jù)庫(kù)、數(shù)據(jù)文卷）。 39存儲(chǔ)分配 根據(jù)需要，說(shuō)明本程序的存儲(chǔ)分配。 310注釋設(shè)計(jì) 說(shuō)明準(zhǔn)備在本程序中安排的注釋?zhuān)纾篴 加在模塊首部的注釋?zhuān)籦加在各分枝點(diǎn)處的注釋?zhuān)?對(duì)各變量的功能、范圍、缺省條件等所加的注釋?zhuān)?d對(duì)使用的邏輯所加的注釋等等。 311限制條件 說(shuō)明本程序運(yùn)行中所受到的限制條件。312測(cè)試計(jì)劃 說(shuō)明對(duì)本程序進(jìn)行單體測(cè)試的計(jì)劃，包括對(duì)測(cè)試的技術(shù)要求、輸入數(shù)據(jù)、預(yù)期結(jié)果、進(jìn)度安排、人員職責(zé)、設(shè)備條件驅(qū)動(dòng)程序及樁模塊等的規(guī)定。313尚未解決的問(wèn)題說(shuō)明在本程序的設(shè)計(jì)中尚未解決而設(shè)計(jì)者認(rèn)為在軟件完成之前應(yīng)解決的問(wèn)題。4程序2（標(biāo)識(shí)符）設(shè)計(jì)說(shuō)明用類(lèi)似3的方式，說(shuō)明第2個(gè)程序乃至第

32、N個(gè)程序的設(shè)計(jì)考慮。附錄4-4 用戶(hù)手冊(cè)1引言 11編寫(xiě)目的說(shuō)明編寫(xiě)這份用戶(hù)手冊(cè)的目的，指出預(yù)期的讀者。 12背景說(shuō)明：a這份用戶(hù)手冊(cè)所描述的軟件系統(tǒng)的名稱(chēng)；b該軟件項(xiàng)目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)（或首批用戶(hù)）及安裝此軟件的計(jì)算中心。13定義列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。14參考資料 列出有用的參考資料，如：a項(xiàng)目的經(jīng)核準(zhǔn)的計(jì)劃任務(wù)書(shū)或合同、上級(jí)機(jī)關(guān)的批文；b屬于本項(xiàng)目的其他已發(fā)表文件； c本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標(biāo)準(zhǔn)。 列出這些文件資料的標(biāo)題、文件編號(hào)、發(fā)表日期和出版單位，說(shuō)明能夠取得這些文件資料的來(lái)源。2用途21功能結(jié)合本軟件的開(kāi)發(fā)目

33、的逐項(xiàng)地說(shuō)明本軟件所具有各項(xiàng)功能以及它們的極限范圍。22性能221精度 逐項(xiàng)說(shuō)明對(duì)各項(xiàng)輸入數(shù)據(jù)的精度要求和本軟件輸出數(shù)據(jù)達(dá)到的精度，包括傳輸中的精度要求。222時(shí)間特性 定量地說(shuō)明本軟件的時(shí)間特性，如響應(yīng)時(shí)間，更新處理時(shí)間，數(shù)據(jù)傳輸、轉(zhuǎn)換時(shí)間，計(jì)算時(shí)間等。 223靈活性 說(shuō)明本軟件所具有的靈活性，即當(dāng)用戶(hù)需求（如對(duì)操作方式、運(yùn)行環(huán)境、結(jié)果精度、時(shí)間特性等的要求）有某些變化時(shí)，本軟件的適應(yīng)能力。 2 3 安 全保密說(shuō)明本軟件在安全、保密方面的設(shè)計(jì)考慮和實(shí)際達(dá)到的能力。3運(yùn)行環(huán)境31 硬設(shè)備列出為運(yùn)行本軟件所要求的硬設(shè)備的最小配置，如： a處理機(jī)的型號(hào)、內(nèi)存容量; b所要求的外存儲(chǔ)器、媒體、記錄格

34、式、設(shè)備的型號(hào)和臺(tái)數(shù)、聯(lián)機(jī)脫機(jī)；c IO設(shè)備（聯(lián)機(jī)脫機(jī)？）； d數(shù)據(jù)傳輸設(shè)備和轉(zhuǎn)換設(shè)備的型號(hào)、臺(tái)數(shù)。32支持軟件說(shuō)明為運(yùn)行本軟件所需要的支持軟件，如：a操作系統(tǒng)的名稱(chēng)、版本號(hào)；b程序語(yǔ)言的編譯匯編系統(tǒng)的名稱(chēng)和版本號(hào)；c數(shù)據(jù)庫(kù)管理系統(tǒng)的名稱(chēng)和版本號(hào)；d其他支持軟件。33數(shù)據(jù)結(jié)構(gòu) 列出為支持本軟件的運(yùn)行所需要的數(shù)據(jù)庫(kù)或數(shù)據(jù)文卷。4使用過(guò)程 在本章，首先用圖表的形式說(shuō)明軟件的功能同系統(tǒng)的輸入源機(jī)構(gòu)、輸出接收機(jī)構(gòu)之間的關(guān)系。4 1安裝與初始化 一步一步地說(shuō)明為使用本軟件而需進(jìn)行的安裝與初始化過(guò)程，包括程序的存儲(chǔ)形式、安裝與初始化過(guò)程中的全部操作命令、系統(tǒng)對(duì)這些命令的反應(yīng)與答復(fù)。表征安裝工作完成的測(cè)試實(shí)

35、例等。如果有的話(huà)，還應(yīng)說(shuō)明安裝過(guò)程中所需用到的專(zhuān)用軟件。42輸入規(guī)定輸入數(shù)據(jù)和參量的準(zhǔn)備要求。421輸入數(shù)據(jù)的現(xiàn)實(shí)背景說(shuō)明輸入數(shù)據(jù)的現(xiàn)實(shí)背景，主要是a情況-例如人員變動(dòng)、庫(kù)存缺貨；b情況出現(xiàn)的頻度-例如是周期性的、隨機(jī)的、一項(xiàng)操作狀態(tài)的函數(shù)c情況來(lái)源-一例如人事部門(mén)、倉(cāng)庫(kù)管理部門(mén)；d輸入媒體-例如鍵盤(pán)、穿孔卡片、磁帶；e限制-出于安全、保密考慮而對(duì)訪(fǎng)問(wèn)這些輸入數(shù)據(jù)所加的限制；f質(zhì)量管理-例如對(duì)輸入數(shù)據(jù)合理性的檢驗(yàn)以及當(dāng)輸入數(shù)據(jù)有錯(cuò)誤時(shí)應(yīng)采取的措施，如建立出錯(cuò)情況的記錄等；g支配-例如如何確定輸入數(shù)據(jù)是保留還是廢棄，是否要分配給其他的接受者等。422輸入格式 說(shuō)明對(duì)初始輸入數(shù)據(jù)和參量的格式要求，

36、包括語(yǔ)法規(guī)則和有關(guān)約定，如：a長(zhǎng)度-一例如字符數(shù)行，字符數(shù)項(xiàng)；b格式基準(zhǔn)-例如以左面的邊沿為基準(zhǔn)；c標(biāo)號(hào)-例如標(biāo)記或標(biāo)識(shí)符； d順序-例如各個(gè)數(shù)據(jù)項(xiàng)的次序及位置；e標(biāo)點(diǎn)-例如用來(lái)表示行、數(shù)據(jù)組等的開(kāi)始或結(jié)束而使用的空格、斜線(xiàn)、星號(hào)、字符組等。f詞匯表-給出允許使用的字符組合的列表，禁止使用的字符組合的列表等；g省略和重復(fù)-給出用來(lái)表示輸人元素可省略或重復(fù)的表示方式； h控制-給出用來(lái)表示輸入開(kāi)始或結(jié)束的控制信息。 H423輸入舉例 為每個(gè)完整的輸入形式提供樣本，包括： a控制或首部-例如用來(lái)表示輸入的種類(lèi)和類(lèi)型的信息，標(biāo)識(shí)符輸入日期，正文起點(diǎn)和對(duì)所用編碼的規(guī)定； b主體-輸入數(shù)據(jù)的主體，包括數(shù)

37、據(jù)文卷的輸入表述部分；c尾部-用來(lái)表示輸入結(jié)束的控制信息，累計(jì)字符總數(shù)等； d省略-指出哪些輸入數(shù)據(jù)是可省略的；e重復(fù)-指出哪些輸入數(shù)據(jù)是重復(fù)的。43輸出 對(duì)每項(xiàng)輸出作出說(shuō)明 431輸出數(shù)據(jù)的現(xiàn)實(shí)背景，說(shuō)明輸出數(shù)據(jù)的現(xiàn)實(shí)背景，主要是：a使用-這些輸出數(shù)據(jù)是給誰(shuí)的，用來(lái)干什么； b使用頻度-例如每周的、定期的或備查閱的；c媒體-打印、CRI顯示、磁帶、卡片、磁盤(pán)， d質(zhì)量管理-一例如關(guān)于合理性檢驗(yàn)、出錯(cuò)糾正的規(guī)定；e支配-例如如何確定輸出數(shù)據(jù)是保留還是廢棄，是否要分配給其他接受者等。432輸出格式 給出對(duì)每一類(lèi)輸出信息的解釋?zhuān)饕牵篴首部-如輸出數(shù)據(jù)的標(biāo)識(shí)符，輸出日期和輸出編號(hào)；b主體-輸出信

38、息的主體，包括分欄標(biāo)題；c尾部-包括累計(jì)總數(shù)，結(jié)束標(biāo)記。433輸出舉例 為每種輸出類(lèi)型提供例子。對(duì)例子中的每一項(xiàng)，說(shuō)明：a定義-每項(xiàng)輸出信息的意義和用途； b來(lái)源-是從特定的輸入中抽出、從數(shù)據(jù)庫(kù)文卷中取出、或從軟件的計(jì)算過(guò)程中得到c特性-輸出的值域、計(jì)量單位、在什么情況下可缺省等。44文卷查詢(xún) 這一條的編寫(xiě)針對(duì)具有查詢(xún)能力的軟件，內(nèi)容包括：同數(shù)據(jù)庫(kù)查詢(xún)有關(guān)的初始化、準(zhǔn)備、及處理所需 要的詳細(xì)規(guī)定，說(shuō)明查詢(xún)的能力、方式，所使用的命令和所要求的控制規(guī)定。 45出錯(cuò)處理和恢復(fù) 列出由軟件產(chǎn)生的出錯(cuò)編碼或條件以及應(yīng)由用戶(hù)承擔(dān)的修改糾正工作。指出為了確保再啟動(dòng)和恢 復(fù)的能力，用戶(hù)必須遵循的處理過(guò)程。46

39、終端操作 當(dāng)軟件是在多終端系統(tǒng)上工作時(shí)，應(yīng)編寫(xiě)本條，以說(shuō)明終端的配置安排、連接步釋、數(shù)據(jù)和參數(shù)輸入 步驟以及控制規(guī)定說(shuō)明通過(guò)終端操作進(jìn)行查詢(xún)、檢索、修改數(shù)據(jù)文卷的能力、語(yǔ)言、過(guò)程以及輔助性程 序等。 附錄4-5數(shù)據(jù)要求說(shuō)明書(shū) 1引言 11編寫(xiě)目的說(shuō)明編寫(xiě)這份數(shù)據(jù)要求說(shuō)明書(shū)的目的，指出預(yù)期的讀者。 12背景說(shuō)明： a待開(kāi)發(fā)軟件系統(tǒng)的名稱(chēng)； b列出本項(xiàng)目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)以及將運(yùn)行該項(xiàng)軟件的計(jì)算站（中心）或計(jì)算機(jī)網(wǎng)絡(luò)系統(tǒng)。 13定義 列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。14參考資料列出有關(guān)的參考資料，如：a本項(xiàng)目的經(jīng)核準(zhǔn)的計(jì)劃任務(wù)書(shū)或合同，上級(jí)機(jī)關(guān)的批文； b屬于本項(xiàng)

40、目的其他已發(fā)表文件；c本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標(biāo)準(zhǔn)。列出這些文件的標(biāo)題、文件編號(hào)、發(fā)表日期和出版單位。說(shuō)明能夠得到這些文件資料的來(lái)源。2數(shù)據(jù)的邏輯描述 對(duì)數(shù)據(jù)進(jìn)行邏輯描述時(shí)可把數(shù)據(jù)分為動(dòng)態(tài)數(shù)據(jù)和靜態(tài)數(shù)據(jù)。所謂靜態(tài)數(shù)據(jù)，指在運(yùn)行過(guò)程中主要作 為參考的數(shù)據(jù)，它們?cè)诤荛L(zhǎng)的一段時(shí)間內(nèi)不會(huì)變化，一般不隨運(yùn)行而改變。所謂動(dòng)態(tài)數(shù)據(jù)包括所有在運(yùn) 行中要發(fā)生變化的數(shù)據(jù)以及在運(yùn)行中要輸入、輸出的數(shù)據(jù)。進(jìn)行描述時(shí)應(yīng)把各數(shù)據(jù)元素邏輯地分成若干 組，列如函數(shù)、源數(shù)據(jù)或?qū)τ谄鋺?yīng)用更為恰當(dāng)?shù)倪壿嫹纸M。給出每一數(shù)據(jù)元的名稱(chēng)（包括縮寫(xiě)和代碼）、定 義（或物理意義）度量單位、值域、格式和類(lèi)型等有關(guān)信息

41、。 21靜態(tài)數(shù)據(jù)列出所有作為控制或參考用的靜態(tài)數(shù)據(jù)元素。22動(dòng)態(tài)輸人數(shù)據(jù)列出動(dòng)態(tài)輸入數(shù)據(jù)元素（包括在常規(guī)運(yùn)行中或聯(lián)機(jī)操作中要改變的數(shù)據(jù)）。23動(dòng)態(tài)輸出數(shù)據(jù) 列出動(dòng)態(tài)輸出數(shù)據(jù)元素（包括在常規(guī)運(yùn)行中或聯(lián)機(jī)操作中要改變的數(shù)據(jù)）。24內(nèi)部生成數(shù)據(jù)列出向用戶(hù)或開(kāi)發(fā)單位中的維護(hù)調(diào)試人員提供的內(nèi)部生成數(shù)據(jù)。 25數(shù)據(jù)約定說(shuō)明對(duì)數(shù)據(jù)要求的制約。逐條列出對(duì)進(jìn)一步擴(kuò)充或使用方面的考慮而提出的對(duì)數(shù)據(jù)要求的限制（容 量、文卷、記錄和數(shù)據(jù)元的個(gè)數(shù)的最大值）。對(duì)于在設(shè)計(jì)和開(kāi)發(fā)中確定是臨界性的限制更要明確指出。 3數(shù)據(jù)的采集31要求和范圍 按數(shù)據(jù)元的邏輯分組來(lái)說(shuō)明數(shù)據(jù)采集的要求和范圍，指明數(shù)據(jù)的采集方法，說(shuō)明數(shù)據(jù)采集工作的

42、承擔(dān)者是用戶(hù)還是開(kāi)發(fā)者。具體的內(nèi)容包括：a輸入數(shù)據(jù)的來(lái)源，例如是單個(gè)操作員、數(shù)據(jù)輸入站，專(zhuān)業(yè)的數(shù)據(jù)輸入公司或它們的一個(gè)分組；b數(shù)據(jù)輸入（指把數(shù)據(jù)輸入處理系統(tǒng)內(nèi)部）所用的媒體和硬設(shè)備。如果只有指定的輸入點(diǎn)的輸入才是合法的，則必須對(duì)此加以說(shuō)明；c接受者說(shuō)明輸出數(shù)據(jù)的接受者； d輸出數(shù)據(jù)的形式和設(shè)備列出輸出數(shù)據(jù)的形式和硬設(shè)備。無(wú)論接受者將接收到的數(shù)據(jù)是打印輸出，還是CRT上的一組字符、一幀圖形，或一聲警鈴，或向開(kāi)關(guān)線(xiàn)圈提供的一個(gè)電脈沖，或常用介質(zhì)如磁盤(pán)、磁帶、穿孔卡片等，均應(yīng)具體說(shuō)明；e數(shù)據(jù)值的范圍給出每一個(gè)數(shù)據(jù)元的合法值的范圍；f量綱給出數(shù)字的度量單位、增量的步長(zhǎng)、零點(diǎn)的定標(biāo)等。在數(shù)據(jù)是非數(shù)字量的

43、情況下，要給出每一種合法值的形式和含意；g更新和處理的頻度給出預(yù)定的對(duì)輸入數(shù)據(jù)的更新和處理的頻度。如果數(shù)據(jù)的輸入是隨機(jī)的，應(yīng)給出更新處理的頻度的平均值，或變化情況的某種其他度量。32輸人的承擔(dān)者 說(shuō)明預(yù)定的對(duì)數(shù)據(jù)輸入工作的承擔(dān)者。如果輸入數(shù)據(jù)同某一接口軟件有關(guān)，還應(yīng)說(shuō)明該接口軟件的來(lái)源。 33預(yù)處理對(duì)數(shù)據(jù)的采集和預(yù)處理過(guò)程提出專(zhuān)門(mén)的規(guī)定，包括適合應(yīng)用的數(shù)據(jù)格式、預(yù)定的數(shù)據(jù)通信媒體和對(duì)輸入的時(shí)間要求等。對(duì)于需經(jīng)模擬轉(zhuǎn)換或數(shù)字轉(zhuǎn)換處理的數(shù)據(jù)量，要給出轉(zhuǎn)換方法和轉(zhuǎn)換因子等有關(guān)信息，以便軟件系統(tǒng)使用這些數(shù)據(jù)。34 影響 說(shuō)明這些數(shù)據(jù)要求對(duì)于設(shè)備、軟件、用戶(hù)、開(kāi)發(fā)單位所可能產(chǎn)生的影響，例如要求用戶(hù)單位增

44、設(shè)某個(gè)機(jī)構(gòu)等。附錄4-6項(xiàng)目開(kāi)發(fā)總結(jié)報(bào)告 I引言 11編寫(xiě)目的 說(shuō)明編寫(xiě)這份項(xiàng)目開(kāi)發(fā)總結(jié)報(bào)告的目的，指出預(yù)期的閱讀范圍。12背景 說(shuō)明： a本項(xiàng)目的名稱(chēng)和所開(kāi)發(fā)出來(lái)的軟件系統(tǒng)的名稱(chēng)；b此軟件的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)及安裝此軟件的計(jì)算中心。I3定義列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。14參考資料 列出要用到的參考資料，如：a本項(xiàng)目的已核準(zhǔn)的計(jì)劃任務(wù)書(shū)或合同、上級(jí)機(jī)關(guān)的批文；b屬于本項(xiàng)目的其他已發(fā)表的文件；c本文件中各處所引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標(biāo)準(zhǔn)。 列出這些文件的標(biāo)題、文件編號(hào)、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。2實(shí)際開(kāi)發(fā)結(jié)果 21產(chǎn)品

45、 說(shuō)明最終制成的產(chǎn)品，包括：a程序系統(tǒng)中各個(gè)程序的名字，它們之間的層次關(guān)系，以千字節(jié)為單位的各個(gè)程序的程序量、存儲(chǔ)媒體的形式和數(shù)量；b程序系統(tǒng)共有哪幾個(gè)版本，各自的版本號(hào)及它們之間的區(qū)別；c每個(gè)文件的名稱(chēng)； d所建立的每個(gè)數(shù)據(jù)庫(kù)。 如果開(kāi)發(fā)中制訂過(guò)配置管理計(jì)劃，要同這個(gè)計(jì)劃相比較。22主要功能和性能逐項(xiàng)列出本軟件產(chǎn)品所實(shí)際具有的主要功能和性能，對(duì)照可行性研究報(bào)告、項(xiàng)目開(kāi)發(fā)計(jì)劃、功能需 求說(shuō)明書(shū)的有關(guān)內(nèi)容，說(shuō)明原定的開(kāi)發(fā)目標(biāo)是達(dá)到了、未完全達(dá)到、或超過(guò)了。23基本流程 用圖給出本程序系統(tǒng)的實(shí)際的基本的處理流程。24進(jìn)度列出原定計(jì)劃進(jìn)度與實(shí)際進(jìn)度的對(duì)比，明確說(shuō)明，實(shí)際進(jìn)度是提前了、還是延遲了，分析

46、主要原因。 25費(fèi)用列出原定計(jì)劃費(fèi)用與實(shí)際支出費(fèi)用的對(duì)比，包括： a工時(shí)，以人月為單位，并按不同級(jí)別統(tǒng)計(jì)；b計(jì)算機(jī)的使用時(shí)間，區(qū)別CPU時(shí)間及其他設(shè)備時(shí)間； c物料消耗、出差費(fèi)等其他支出。 明確說(shuō)明，經(jīng)費(fèi)是超出了、還是節(jié)余了，分析其主要原因。3開(kāi)發(fā)工作評(píng)價(jià) 31對(duì)生產(chǎn)效率的評(píng)價(jià)給出實(shí)際生產(chǎn)效率，包括：a程序的平均生產(chǎn)效率，即每人月生產(chǎn)的行數(shù)；b文件的平均生產(chǎn)效率，即每人月生產(chǎn)的千字?jǐn)?shù)； 并列出原訂計(jì)劃數(shù)作為對(duì)比。32對(duì)產(chǎn)品質(zhì)量的評(píng)價(jià) 說(shuō)明在測(cè)試中檢查出來(lái)的程序編制中的錯(cuò)誤發(fā)生率，即每干條指令（或語(yǔ)句）中的錯(cuò)誤指令數(shù)（或語(yǔ)句數(shù)）。如果開(kāi)發(fā)中制訂過(guò)質(zhì)量保證計(jì)劃或配置管理計(jì)劃，要同這些計(jì)劃相比較。3

47、3對(duì)技術(shù)方法的評(píng)價(jià)給出對(duì)在開(kāi)發(fā)中所使用的技術(shù)、方法、工具、手段的評(píng)價(jià)。 34出錯(cuò)原因的分析 給出對(duì)于開(kāi)發(fā)中出現(xiàn)的錯(cuò)誤的原因分析。4經(jīng)驗(yàn)與教訓(xùn) 列出從這項(xiàng)開(kāi)發(fā)工作中所得到的最主要的經(jīng)驗(yàn)與教訓(xùn)及對(duì)今后的項(xiàng)目開(kāi)發(fā)工作的建議。附錄5-1 JAVA編碼規(guī)范1、命名規(guī)范定義這個(gè)規(guī)范的目的是讓項(xiàng)目中所有的文檔都看起來(lái)像一個(gè)人寫(xiě)的，增加可讀性，減少項(xiàng)目組中因?yàn)閾Q人而帶來(lái)的損失。命名一般以簡(jiǎn)介單詞構(gòu)成。1、package 的命名package 的名字應(yīng)該都是由一個(gè)小寫(xiě)單詞組成。 package com.neu.util2、class 的命名 class 的名字必須由大寫(xiě)字母開(kāi)頭而其他字母都小寫(xiě)的單詞組成,對(duì)于所

48、有標(biāo)識(shí)符，其中包含的所有單詞都應(yīng)緊靠在一起，而且大寫(xiě)中間單詞的首字母。 public class ThisAClassName3、 class 變量的命名 變量的名字必須用一個(gè)小寫(xiě)字母開(kāi)頭。后面的單詞用大寫(xiě)字母開(kāi)頭 userName , thisAClassMethod 4、 static final 變量的命名 static final 變量的名字應(yīng)該都大寫(xiě)，并且指出完整含義。 public static final String DB_CONFIG_FILE_PATH ="com.neu.etrain.dbconfig"5、參數(shù)的命名 參數(shù)的名字必須和變量的命名規(guī)范一致

49、。 6、數(shù)組的命名 數(shù)組應(yīng)該總是用下面的方式來(lái)命名： byte buffer;而不是： byte buffer;7、方法的參數(shù) 使用有意義的參數(shù)命名，如果可能的話(huà)，使用和要賦值的字段一樣的名字： setCounter(int size) this.size = size;2、注視規(guī)范 Java的注釋有三種/ 注釋一行/* . */ 注釋若干行/* . */ 注釋若干行，并寫(xiě)入javadoc文檔 ，也叫java文檔注釋 注釋要簡(jiǎn)單明了。String userName = null; /用戶(hù)名邊寫(xiě)代碼邊注釋?zhuān)薷拇a同時(shí)修改相應(yīng)的注釋?zhuān)员ＷC注釋與代碼的一致性。在必要的地方注釋?zhuān)⑨屃恳m中。注釋

50、的內(nèi)容要清楚、明了，含義準(zhǔn)確，防止注釋二義性。保持注釋與其描述的代碼相鄰，即注釋的就近原則。對(duì)代碼的注釋?xiě)?yīng)放在其上方相鄰位置，不可放在下面。對(duì)數(shù)據(jù)結(jié)構(gòu)的注釋?xiě)?yīng)放在其上方相鄰位置，不可放在下面；對(duì)結(jié)構(gòu)中的每個(gè)域的注釋?xiě)?yīng)放在此域的右方；同一結(jié)構(gòu)中不同域的注釋要對(duì)齊。變量、常量的注釋?xiě)?yīng)放在其上方相鄰位置或右方。 全局變量要有較詳細(xì)的注釋?zhuān)▽?duì)其功能、取值范圍、哪些函數(shù)或過(guò)程存取它以及存取時(shí)注意事項(xiàng)等的說(shuō)明。 在每個(gè)源文件的頭部要有必要的注釋信息，包括：文件名；版本號(hào)；作者；生成日期；模塊功能描述（如功能、主要算法、內(nèi)部各部分之間的關(guān)系、該文件與其它文件關(guān)系等）；主要函數(shù)或過(guò)程清單及本文件歷史修改記錄等。/* * Copy Right Information : stsoft * Project : jscbmis * JDK version used : jdk1.5.09 * Comments : config path * Version : 1.01 * Modification history :2