文件給制實(shí)施規(guī)定的實(shí)例（GB8567-88）1
文件給制實(shí)施規(guī)定的實(shí)例（GB8567-88） 盡管在文件編制中存在著很多靈活性，然而，文件的編制確實(shí)是非常必要的，其意義 如前所述。為了控制這種靈活性，保證文件編制能達(dá)到應(yīng)該達(dá)到的目的，對(duì)于具體的軟 件開發(fā)任務(wù)，應(yīng)編制的文件的種類、詳細(xì)程度應(yīng)取決于承擔(dān)開發(fā)單位的管理能力、任務(wù) 的規(guī)模、復(fù)雜性和成敗風(fēng)險(xiǎn)等因素。一個(gè)軟件開發(fā)單位應(yīng)該根據(jù)本單位經(jīng)營(yíng)承包的應(yīng)用 軟件的專業(yè)特點(diǎn)和本單位的管理能力，制定一個(gè)文件編制實(shí)施規(guī)定，說明在什么情況下 應(yīng)該編制哪些文件。由于國(guó)內(nèi)目前在這方面還缺乏成熟的經(jīng)驗(yàn)，這里提供參考國(guó)外經(jīng)驗(yàn) 制定的兩個(gè)例子，用以向國(guó)內(nèi)軟件開發(fā)單位說明如何建立這種實(shí)施規(guī)定，使項(xiàng)目負(fù)責(zé)人 能確定本項(xiàng)目開發(fā)過程中應(yīng)編制的文件的種類。當(dāng)然，例子畢竟只是例子，這兩個(gè)例子 各自都不免有其片面性，它們兩者之間也不免有不一致之處，之所以列出來無非是供國(guó) 內(nèi)軟件開發(fā)單位參考。 例1： 此例規(guī)定用求和法來確定應(yīng)編制的文件。該方法的要點(diǎn)是提出十二個(gè)考慮因素來衡量 一個(gè)應(yīng)用軟，件，每個(gè)因素可能取值的范圍是互至5。任務(wù)負(fù)責(zé)人可用這十二個(gè)因素對(duì)所 要開發(fā)的程序進(jìn)行衡量，確定每個(gè)因素的具體值。把這十二個(gè)因素的值相加，得到一個(gè) 總和。然后由這個(gè)總和的值來確定應(yīng)該編制的文件的種類。使用這個(gè)方法的具體過程如 下： a. 按表OI中的十二個(gè)因素衡量所要開發(fā)的程序，得到每個(gè)因素的值； b. 把衡量所得的各個(gè)因素的值相加，得總和之值； c. 根據(jù)總和之值，從表OZ查出應(yīng)編制的文件的種類。 表1文件編制的十二項(xiàng)衡量因素 |序 |因素 |因素取值準(zhǔn)則 | |號(hào) | | | | | |1 |2 |3 |4 |5 | |1 |創(chuàng)造性要求|沒有——在 |很少——具 |有限——具 |相當(dāng)多—— |重大的—— | | | |不同的設(shè) |有嚴(yán)格的 |有新的接 |應(yīng)用現(xiàn)有 |應(yīng)用先進(jìn) | | | |備上重編 |要求 |口 |的技巧 |的技巧 | | | |程序 | | | | | |2 |通用程度 |很強(qiáng)的限 |有限制—— |有限的靈 |多用途， |很靈活—— | | | |制——單一 |功能的范 |活性允許 |靈活的格 |能在不同 | | | |目標(biāo) |圍是參量 |格式上有 |式有一個(gè) |的設(shè)備上 | | | | |化的 |某些變化 |主題領(lǐng)域 |處理范圍 | | | | | | | |廣泛的主 | | | | | | | |題 | |3 |工作范圍 |局部單位 |分指揮部 |單個(gè)指揮 |多個(gè)指揮 |國(guó)防部， | | | | | |部 |部 |世界范圍 | |4 |目標(biāo)范圍的|沒有 |極少 |偶爾有 |經(jīng)常 |不斷 | | |變化 | | | | | | |5 |設(shè)備復(fù)雜性|單機(jī)，常 |單機(jī)，常 |多機(jī)，標(biāo) |多機(jī)，復(fù) |主機(jī)控制 | | | |規(guī)處理 |規(guī)處理， |準(zhǔn)外設(shè)系 |雜的外設(shè) |系統(tǒng)，多 | | | | |擴(kuò)充的外 |統(tǒng) |系統(tǒng) |機(jī)，自動(dòng)I| | | | |設(shè)系統(tǒng) | | |/O和顯示 | |6 |人員 |1～2人 |3～5人 |5～10人 |10～18人 |18人以上 | |7 |開發(fā)投資 |6人月以下|6人月至3 |3人年至10|10人年至3|30人年以 | | | | |人年 |人年 |0人年 |上 | |8 |重要程度 |數(shù)據(jù)處理 |常規(guī)過程 |人身安全 |單位成敗 |國(guó)家安全 | | | | |控制 | | | | |9 |對(duì)程序改變|2周以上 |1～2周 |3～7天 |1～3天 |24小時(shí)以 | | |的完成時(shí)間| | | | |內(nèi) | | |要求 | | | | | | |10 |對(duì)數(shù)據(jù)輸入|2周以上 |1～2周 |1～7天 |1～24小時(shí)|60分鐘內(nèi) | | |的響應(yīng)時(shí)間| | | | | | | |要求 | | | | | | |11 |程序語言 |高級(jí)語言 |高級(jí)語言 |高級(jí)語言 |匯編語言 |機(jī)器語言 | | | | |帶一些匯 |帶相當(dāng)多 | | | | | | |編 |的匯編 | | | |12 |并行的軟件|沒有 |有限 |中等程度 |很多 |完全的并 | | |開發(fā) | | | | |行開發(fā) | 表1文件編制的十二項(xiàng)衡量因素 因素總和 |可行性研究報(bào)告 |項(xiàng)目開發(fā)計(jì)劃 |軟件需求說明書 |數(shù)據(jù)要求說明書 |概要設(shè)計(jì)說明書 |詳細(xì)設(shè)計(jì)說明書 |數(shù)據(jù)庫設(shè)計(jì)說明書 |用戶手冊(cè)（使用說明） |操作手冊(cè) |模塊開發(fā)卷宗 |測(cè)試設(shè)計(jì) |測(cè)試分析報(bào)告 |項(xiàng)目開發(fā)總結(jié)報(bào)告 |開發(fā)制度月報(bào) | |12～18* 14～24 24～38 38～50 48～60 | √ √ √ |√ √ √ √ √ | √ √ √ √ | *** *** *** *** | √ √ | √ | *** *** *** *** |√ √ √ √ √ | √ √ √ | √ √ √ √ | √ √ √ √ | ** ** √ √ |√ √ √ √ √ | √ √ √ √ | |*在因素總和較低的情況下,項(xiàng)目開發(fā)總結(jié)報(bào)告的內(nèi)容應(yīng)包括：程序的主要功能、基本 流程、測(cè)試結(jié)果和使用說明。 **測(cè)試分析報(bào)告應(yīng)該寫，但不必很正規(guī)。 ***數(shù)據(jù)要求說明和數(shù)據(jù)庫設(shè)計(jì)說明是否需要編寫應(yīng)根據(jù)所開發(fā)軟件的實(shí)際需要來決定。 例2： 為了避免在軟件開發(fā)中文件編制的不足或過分，一個(gè)簡(jiǎn)便的辦法是把對(duì)軟件文件的編 制要求同軟件的規(guī)模大小聯(lián)系起來，這就是本例的出發(fā)點(diǎn)。軟件的規(guī)模不妨分為四級(jí)： 1. 小規(guī)模軟件源程序行數(shù)小于5000的軟件； 2. 中規(guī)模軟件源程序行數(shù)為10000～50000的軟件； 3. 大規(guī)模軟件源程序行數(shù)為100000—500000的軟件； 4. 特大規(guī)模軟件源程序行數(shù)大于500000的軟件。 對(duì)上述的四級(jí)軟件的文件編制要求分別列于表3。 至于源程序行數(shù)為5000～10000，50000～100000的軟件，其文件編制要求介于兩級(jí)之 間，可根據(jù)一個(gè)軟件產(chǎn)品的具體情況，由項(xiàng)目負(fù)責(zé)人參照表3的規(guī)定，確定需要編制的文 件種類。 對(duì)于源程序行數(shù)大于500000的特大規(guī)模軟件，可進(jìn)一步把本指南規(guī)定的十四種文件按 實(shí)際需要擴(kuò)展成更多種類，這一點(diǎn)在本指南5.3.3已經(jīng)提到。 表3產(chǎn)品文件體系 ----------------------- 可行性報(bào)告 項(xiàng)目開發(fā)計(jì)劃 對(duì)應(yīng)大規(guī)模軟件所規(guī)定的文件可進(jìn)一步細(xì)分 軟件需求說明 數(shù)據(jù)要求說明 測(cè)試計(jì)劃 項(xiàng)目開發(fā)計(jì)劃 軟件需求說明 測(cè)試計(jì)劃 軟件需求與開發(fā)計(jì)劃 概要設(shè)計(jì)說明 詳細(xì)設(shè)計(jì)說明 數(shù)據(jù)庫設(shè)計(jì)說明 軟件設(shè)計(jì)說明 軟件設(shè)計(jì)說明 使用說明 使用說明 用戶手冊(cè) 操作手冊(cè) 模塊開發(fā)卷宗 測(cè)試分析報(bào)告 測(cè)試分析報(bào)告 模塊開發(fā)卷宗 測(cè)試分析報(bào)告 開發(fā)進(jìn)度月報(bào) 項(xiàng)目開發(fā)總結(jié) 開發(fā)進(jìn)度月報(bào) 項(xiàng)目開發(fā)總結(jié) 項(xiàng)目開發(fā)總結(jié) 小規(guī)模軟件 中規(guī)模軟件 大規(guī)模軟件 超大規(guī)模軟件
文件給制實(shí)施規(guī)定的實(shí)例（GB8567-88）1