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