計算機軟件產(chǎn)品開(kāi)發(fā)文件編制指南 GB 8567-88
Guidelines for computer software product development documentation
中華人民共和國國家標準 UDC681．3
引言
1 目的
一項計算機軟件的籌劃、研制及實(shí)現，構成一個(gè)軟件開(kāi)發(fā)項目。一個(gè)軟件開(kāi)發(fā)項目的進(jìn)行，一般需要在人力和自動(dòng)化資源等方面作重大的投資。為了保證項目開(kāi)發(fā)的成功，最經(jīng)濟地花費這些投資，并且便 于運行和維護，在開(kāi)發(fā)工作的每一階段，都需要編制二定的文件。這些文件連同計算機程序及數據一起，構成為計算機軟件。文件是計算機軟件中不可缺少的組成部分，它的作用是：
a．作為開(kāi)發(fā)人員在一定階段內的工作成果和結束標志；
b．向管理人員提供軟件開(kāi)發(fā)過(guò)程中的進(jìn)展和情況，把軟件開(kāi)發(fā)過(guò)程中的一些“不可見(jiàn)的”事物轉 換成“可見(jiàn)的”文字資料。以便管理人員在各個(gè)階段檢查開(kāi)發(fā)計劃的實(shí)施進(jìn)展，使之能夠判斷原定目標是否已達到，還將繼續耗用資源的種類(lèi)和數量；
C．記錄開(kāi)發(fā)過(guò)程中的技術(shù)信息，便于協(xié)調以后的軟件開(kāi)發(fā)、使用和修改；
d．提供對軟件的有關(guān)運行、維護和培訓的信息，便于管理人員、開(kāi)發(fā)人員、操作人員和用戶(hù)之間相互了解彼此的工作；
e．向潛在用戶(hù)報導軟件的功能和性能，使他們能判定該軟件能否服務(wù)于自己的需要。
換言之，本指南認為：文件的編制必須適應計算機軟件整個(gè)生存周期的需要。
計算機軟件所包含的文件有兩類(lèi)：一類(lèi)是開(kāi)發(fā)過(guò)程中填寫(xiě)的各種圖表，可稱(chēng)之為工作表格；另一類(lèi)則是應編制的技術(shù)資料或技術(shù)管理資料，可稱(chēng)之為文件。本指南規定軟件文件的編制形式，并提供對這 些規定的解釋。本指南的目的是使得所編制的軟件文件確實(shí)能夠起到軟件文件應該發(fā)揮的作用。
2 范圍
本指南是一份指導性文件。本指甫建議，在一項計算機軟件的開(kāi)發(fā)過(guò)程中，一般地說(shuō)，應該產(chǎn)生十四種文件。這十四種文件是：
可行性研究報告；
項目開(kāi)發(fā)計劃；
軟件需求說(shuō)明書(shū)；
數據要求說(shuō)明書(shū)；
概要設計說(shuō)明書(shū)；
詳細設計說(shuō)明書(shū)；
數據庫設計說(shuō)明書(shū)；
用戶(hù)手冊；
操作手冊；
模塊開(kāi)發(fā)卷宗；
測試計劃；
測試分析報告；
開(kāi)發(fā)進(jìn)度月報；
項目開(kāi)發(fā)總結報告。
本指南將給出開(kāi)發(fā)過(guò)程中建議產(chǎn)生的這十四種文件的編制指導，同時(shí)，本指南也是這十四種文件的編寫(xiě)質(zhì)量的檢驗準則。但是，本指南并未涉及軟件開(kāi)發(fā)過(guò)程中如何填寫(xiě)工作表格的問(wèn)題。
一般地說(shuō)，一個(gè)軟件總是一個(gè)計算機系統（包括硬件、固件和軟件）的組成部分。鑒于計算機系統的多樣性，本指南一般不涉及整個(gè)系統開(kāi)發(fā)中的文件編制問(wèn)題，本指南僅僅是軟件開(kāi)發(fā)過(guò)程中的文件編制指南。
3 文件的使用者
對于使用文件的人員而言，他們所關(guān)心的文件的種類(lèi)，隨他們所承擔的工作而異。
管理人員：可行性研究報告，
項目開(kāi)發(fā)計劃，
模塊開(kāi)發(fā)卷宗，
開(kāi)發(fā)進(jìn)度月報，
項目開(kāi)發(fā)總結報告；
開(kāi)發(fā)人員：可行性研究報告，
項目開(kāi)發(fā)計劃，
軟件需求說(shuō)明書(shū)，
數據要求說(shuō)明書(shū)，
概要設計說(shuō)明書(shū)，
詳細設計說(shuō)明書(shū)，
數據庫設計說(shuō)明書(shū)，
測試計劃，
測試分析報告；
維護人員：設計說(shuō)明書(shū)，
測試分析報告，
模塊開(kāi)發(fā)卷宗；
用戶(hù)：用戶(hù)手冊，
操作手冊。
盡管本指南提出了在軟件開(kāi)發(fā)中文件編制的要求，但并不意味著(zhù)這些文件都必須交給用戶(hù)。一項軟件的用戶(hù)應該得到的文件的種類(lèi)由供應者與用戶(hù)之間簽訂的合同規定。
第一篇 文件的編制指導
4 軟件生存周期與各種文件的編制
一項計算機軟件，從出現一個(gè)構思之日起，經(jīng)過(guò)這項軟件開(kāi)發(fā)成功投入使用，直到最后決定停止使用，并被另一一項軟件代替之時(shí)止，被認為是該軟件的一個(gè)生存周期。一般地說(shuō)這個(gè)軟件生存周期可以分成以下六個(gè)階段：可行性與計劃研究階段
需求分析階段
設計階段
實(shí)現階段
測試階段
運行與維護階段
在可行性研究與計劃階段內，要確定該軟件的開(kāi)發(fā)目標和總的要求，要進(jìn)行可行性分析、投資一收益分析、制訂開(kāi)發(fā)計劃，并完成應編制的文件。
在需求分析階段內，由系統分析人員對被設計的系統進(jìn)行系統分析，確定對該軟件的各項功能、性能需求和設計約束，確定對文件編制的要求，作為本階段工作的結果，一般地說(shuō)，軟件需求說(shuō)明書(shū)、數據要求說(shuō)明書(shū)和初步的用戶(hù)手冊應該編寫(xiě)出來(lái)。
在設計階段內，系統設計人員和程序設計人員應該在反復理解軟件需求的基礎上，提出多個(gè)設計，分析每個(gè)設計能履行的功能并進(jìn)行相互比較，最后確定一個(gè)設計，包括該軟件的結構、模塊的劃分、功能的分配以及處理流程。在被設計系統比較復雜的情況下，設計階段應分解成概要設計階段和詳細設計階段兩個(gè)步驟。在一般情況下，應完成的文件包括：概要設計說(shuō)明書(shū)、詳細設計說(shuō)明書(shū)和測試計劃初稿。
在實(shí)現階段內，要完成源程序的編碼、編譯（或匯編）和排錯調試得到無(wú)語(yǔ)法錯的程序清單，要開(kāi)始編寫(xiě)模塊開(kāi)發(fā)卷宗，并且要完成用戶(hù)手冊、操作手冊等面向用戶(hù)的文件的編寫(xiě)工作，還要完成測試計劃的編制。
在測試階段，該程序將被全面地測試，已編制的文件將被檢查審閱。一般要完成模塊開(kāi)發(fā)卷宗和測試分析報告，作為開(kāi)發(fā)工作的結束，所生產(chǎn)的程序、文件以及開(kāi)發(fā)工作本身將逐項被評價(jià)，最后寫(xiě)出項目開(kāi)發(fā)總結報告。
在整個(gè)開(kāi)發(fā)過(guò)程中（即前五個(gè)階段中），開(kāi)發(fā)集體要按月編寫(xiě)開(kāi)發(fā)進(jìn)度月報。
在運行和維護階段，軟件將在運行使用中不斷地被維護，根據新提出的需求進(jìn)行必要而且可能的擴充和刪改。
對于一項軟件而言，其生存周期各階段與各種文件編寫(xiě)工作的關(guān)系可見(jiàn)表互，其中有些文件的編寫(xiě)工作可能要在若干個(gè)階段中延續進(jìn)行。
表1軟件生存周期各階段中的文件編制
5 文件編制中的考慮因素
文件編制是一個(gè)不斷努力的工作過(guò)程。是一個(gè)從形成最初輪廓，經(jīng)反復檢查和修改，直到程序和文件正式交付使用的完整過(guò)程。其中每一步都要求工作人員做出很大努力。要保證文件編制的質(zhì)量，要體現每個(gè)開(kāi)發(fā)項目的特點(diǎn)，也要注意不要花太多的人力。為此，編制中要考慮如下各項因素。
5．1 文件的讀者
每一種文件都具有特定的讀者。這些讀者包括個(gè)人或小組、軟件開(kāi)發(fā)單位的成員或社會(huì )上的公眾、從事軟件工作的技術(shù)人員、管理人員或領(lǐng)導干部。他們期待著(zhù)使用這些文件的內容來(lái)進(jìn)行工作，例如設計、編寫(xiě)程序、測試、使用、維護或進(jìn)行計劃管理。因此，這些文件的作者必須了解自己的讀者，這些文件的編寫(xiě)必須注意適應自己的特定讀者的水平、特點(diǎn)和要求。
5．2 重復性
本指南第二篇中將列出的這十四種文件的內容要求中，顯然存在某些重復。較明顯的重復有兩類(lèi)。引言是每一種文件都要包含的內容，以向讀者提供總的梗概。第二類(lèi)明顯的重復是各種文件中的說(shuō)明部分，如對功能性能的說(shuō)明、對輸入和輸出的描述、系統中包含的設備等。這是為了方便每種文件各自的讀者，每種產(chǎn)品文件應該自成體系，盡量避免讀一種文件時(shí)又不得不去參考另一種文件。當然，在每一種文件里，有關(guān)引言、說(shuō)明等同其他文件相重復的部分，在行文上、在所用的術(shù)語(yǔ)上、在詳細的程度上，還是應該有一些差別，以適應各種文件的不同讀者的需要。
5．3 靈活性
鑒于軟件開(kāi)發(fā)是具有創(chuàng )造性的腦力勞動(dòng)，也鑒于不同軟件在規模上和復雜程度上差別極大，本指南認為在文件編制工作中應允許一定的靈活性。這種靈活性表現在如下各款。
5．3．1 應編制的文件種類(lèi)
盡管本指南認為在一般情況下，一項軟件的開(kāi)發(fā)過(guò)程中，應產(chǎn)生的文件有十四種，然而針對一項具體的軟件開(kāi)發(fā)項目，有時(shí)不必編制這么多的文件，可以把幾種文件合并成一種。一般地說(shuō)，當項目的規模、復雜性和成敗風(fēng)險增大時(shí)，文件編制的范圍、管理手續和詳細程度將隨之增加。反之，則可適當減少。為了恰當地掌握這種靈活性，本指南要求貫徹分工負責的原則，這意味著(zhù)：
a: 一個(gè)軟件開(kāi)發(fā)單位的領(lǐng)導機構應該根據本單位經(jīng)營(yíng)承包的應用軟件的專(zhuān)業(yè)領(lǐng)域和本單位的管理能力，制定一個(gè)對文件編制要求的實(shí)施規定，主要是：在不同的條件下，應該形成哪些文件？這些文件的詳細程度？該開(kāi)發(fā)單位的每一個(gè)項目負責人，必須認真執行這個(gè)實(shí)施規定。這種規定的兩個(gè)例子可嘆本指南的附錄o（參考件）；
b．對于一個(gè)具體的應用軟件項目，項目負責人應根據上述實(shí)施規定，確定一個(gè)文件編制計劃，主中包括:
(1)應該編制哪幾種文件，詳細程度如何？
（2）各個(gè)文件的編制負責人和進(jìn)度要求；
（3）審查、批準的負責人和時(shí)間進(jìn)度安排；
（4）在開(kāi)發(fā)時(shí)期內，各文件的維護、修改和管理的負責人，以及批準手續。
每項工作必須落實(shí)到人。
這個(gè)文件編制計劃是整個(gè)開(kāi)發(fā)計劃的重要組成部分；
C．有關(guān)的設計人員則必須嚴格執行這個(gè)文件編制計劃。
5．3．2 文件的詳細程度
從同一份提綱起草的文件的篇幅大小往往不同，可以少到幾頁(yè)，也可以長(cháng)達幾百頁(yè)。對于這種差別本指南是允許的。此詳細程度取決于任務(wù)的規模、復雜性和項目負責人對該軟件的開(kāi)發(fā)過(guò)程及運行環(huán)與所需要的詳細程度的判斷。
5．3．3 文件的擴展
當被開(kāi)發(fā)系統的規模非常大（例如源碼超過(guò)一百萬(wàn)行）時(shí)，一種文件可以分成幾卷編寫(xiě)，可以按其。每一個(gè)系統分別編制，也可以按內容劃分成多卷，例如：
項目開(kāi)發(fā)計劃可能包括：質(zhì)量保證計劃，
配置管理計劃，
用戶(hù)培訓計劃，
安裝實(shí)施計劃；
系統設計說(shuō)明書(shū)可分寫(xiě)成：系統設計說(shuō)明書(shū)，
子系統設計說(shuō)明書(shū)；
程序設計說(shuō)明書(shū)可分寫(xiě)成：程序設計說(shuō)明書(shū)，
接口設計說(shuō)明書(shū)，
版本說(shuō)明；
操作手冊可分寫(xiě)成：操作手冊，
安裝實(shí)施過(guò)程；
．測試計劃可分寫(xiě)成：測試計劃，
測試設計說(shuō)明，
測試規程，
測試用例；
測試分析報告可分寫(xiě)成：綜合測試報告，
驗收測試報告；
項目開(kāi)發(fā)總結報告亦可分寫(xiě)成項目開(kāi)發(fā)總結報告和資源環(huán)境統計。
5．3．4 節的擴張與縮并
在有些文件中，可以使用本指南所提供的章、條標題，但在條內又存在一系列需要分別討論的因素本指南認為，所有的條都可以擴展，可以進(jìn)一步細分，以適應實(shí)際需要。反之，如果章條中的有些細節； 非必需，也可以根據實(shí)際情況縮并。此時(shí)章條的編號應相應地改變。
5．3．5 程序設計的表現形式
本指南對于程序的設計表現形式并未作出規定或限制，可以使用流程圖的形式、判定表的形式，1 可以使用其他表現形式，如程序設計語(yǔ)言（PDL）、問(wèn)題分析圖（PAD）等。
5．3．6 文件的表現形式
本指南對于文件的表現形式亦未作出規定或限制，可以使用自然語(yǔ)言，也可以使用形式化語(yǔ)言。
5．3．7 文件的其他種類(lèi)
當本指南中規定的文件種類(lèi)尚不能滿(mǎn)足某些應用部門(mén)的特殊需要時(shí)，他們可以建立一些特殊的文件種類(lèi)要求，例如軟件質(zhì)量保證計劃、軟件配置管理計劃等，這些要求可以包含在本單位的文件編制實(shí)施規定中。
6 文件編制的管理工作
文件編制工作必須有管理工作的配合，才能使所編制的文件真正發(fā)揮它的作用。文件的編制工作實(shí)際上貫穿于一項軟件的整個(gè)開(kāi)發(fā)過(guò)程，因此，對文件的管理必須貫穿于整個(gè)開(kāi)發(fā)過(guò)程。在開(kāi)發(fā)過(guò)程中必須進(jìn)行的管理工作是以下四條。
6．1文件的形成
開(kāi)發(fā)集體中的每個(gè)成員，尤其是項目負責人，應該認識到：文件是軟件產(chǎn)品的必不可少的組成部分；在軟件開(kāi)發(fā)過(guò)程的各個(gè)階段中，必須按照規定及時(shí)地完成各種產(chǎn)品文件的編寫(xiě)工作；必須把在一個(gè)開(kāi)發(fā)步驟中作出的決定和取得的結果及時(shí)地寫(xiě)入文件；開(kāi)發(fā)集體必須及時(shí)地對這些文件進(jìn)行嚴格的評審；這些文件的形成是各個(gè)階段開(kāi)發(fā)工作正式完成的標志。這些文件上必須有編寫(xiě)者、評審者和批準者的簽字，必須有編寫(xiě)、評審完成的日期和批準的日期。
6．2文件的分類(lèi)與標識
在軟件開(kāi)發(fā)的過(guò)程中，產(chǎn)生的文件是很多的，為了便于保存、查找、使用和修改，應該對文件按層次地加以分類(lèi)組織。一個(gè)軟件開(kāi)發(fā)單位應該建立一個(gè)對本單位文件的標識方法，使文件的每一頁(yè)都具有明確的標識。例如可以按如下四個(gè)層次對文件加以分類(lèi)和標識。
a．文件所屬的項目的標識；
b．文件種類(lèi)的標識；
C．同一種文件的不同版本號；
d．頁(yè)號。
此外，對每種文件還應根據項目的性質(zhì)，劃定它們各自的保密級別，確定他們各自的發(fā)行范圍。
6．3文件的控制
在一項軟件的開(kāi)發(fā)過(guò)程中，隨著(zhù)程序的逐步形成和逐步修改，各種文件亦在不斷地產(chǎn)生、不斷地修改或補充。因此，必須加以周密的控制，以保持文件與程序產(chǎn)品的一致性，保持各種文件之間的一致性和文件的安全性。這種控制表現為：
a．就從事一項軟件開(kāi)發(fā)工作的開(kāi)發(fā)集體而言，應設置一位專(zhuān)職的文件管理人員（接口管理工程師或文件管理員）；在開(kāi)發(fā)集體中，應該集中保管本項目現有全部文件的主文本兩套，由該文件管理人員負責保管；
b．每一份提交給文件管理人員的文件都必須具有編寫(xiě)人、審核人和批準人的簽字；
C．這兩套主文本的內容必須完全一致；其中有一套是可供出借的，另一套是絕對不能出借的，以免發(fā)生萬(wàn)一；可出借的主文本在出借時(shí)必須辦理出借手續，歸還時(shí)辦理注銷(xiāo)出借手續；
d．開(kāi)發(fā)集體中的工作人員可以根據工作的需要，在本項目的開(kāi)發(fā)過(guò)程中持有一些文件，即所謂個(gè)人文件，包括為使他完成他承擔的任務(wù)所需要的文件，以及他在完成任務(wù)過(guò)程中所編制的文件；但這種個(gè)人文件必須是主文本的復制品，必須同主文本完全一致，若要修改，必須首先修改主文本；
e．不同開(kāi)發(fā)人員所擁有的個(gè)人文件通常是主文本的各種子集；所謂子集是指把主文本的各個(gè)部分根據承擔不同任務(wù)的人員或部門(mén)的工作需要加以復制、組裝而成的若干個(gè)文件的集合；文件管理人員。應該列出一份不同子集的分發(fā)對象的清單，按照清單及時(shí)把文件分發(fā)給有關(guān)人員或部門(mén)；
f．一份文件如果已經(jīng)被另一份新的文件所代替，則原文件應該被注銷(xiāo)；文件管理人中要隨時(shí)整理主文本，及時(shí)反映出文件的變化和增加情況，及時(shí)分發(fā)文件；
g．當一個(gè)項目的開(kāi)發(fā)工作臨近結束時(shí)，文件管理人員應逐個(gè)收回開(kāi)發(fā)集體內每個(gè)成員的個(gè)人文件，并檢查這些個(gè)人文件的內容；經(jīng)驗表明，這些個(gè)人文件往往可能比主文本更詳細，或同主文本的內容 有所不同，必須認真監督有關(guān)人員進(jìn)行修改，使主文本能真正反映實(shí)際的開(kāi)發(fā)結果。
6．4文件的修改管理
在一個(gè)項目的開(kāi)發(fā)過(guò)程中的任何時(shí)刻，開(kāi)發(fā)集體內的所有成員都可能對開(kāi)發(fā)工作的已有成果—— 文件，提出進(jìn)行修改的要求。提出修改要求的理由可能是各種各樣的，進(jìn)行修改而引起的影響可能很小，也可能會(huì )牽涉到本項目的很多方面。因此，修改活動(dòng)的進(jìn)行必須謹慎，必須對修改活動(dòng)的進(jìn)行加以管理， 必須執行修改活動(dòng)的規程，使整個(gè)修改活動(dòng)有控制地進(jìn)行。
修改活動(dòng)可分如下五個(gè)步驟進(jìn)行：
a．提議開(kāi)發(fā)集體中的任何一個(gè)成員都可以向項目負責人提出修改建議，為此應該填寫(xiě)一份修改建議表，說(shuō)明修改的內容、所修改的文件和部位、以及修改理由；
b．評議由項目負責人或項目負責人指定的人員對該修改建議進(jìn)行評議，包括審查該項修改的必要性、確定這一修改的影響范圍、研究進(jìn)行修改的方法、步驟和實(shí)施計劃；
c．審核一般由項目負責人進(jìn)行審核，包括核實(shí)修改的自的和要求、核實(shí)修改活動(dòng)將帶來(lái)的影響、審核修改活動(dòng)計劃是否可行；
d．批準在一般情況下，批準權屬于該開(kāi)發(fā)單位的部門(mén)負責人；在批準時(shí)，主要是決斷修改工作中各項活動(dòng)的先后順序及各自的完成日期，以保證整個(gè)開(kāi)發(fā)工作按原定計劃日期完成；
e．實(shí)施由項目負責人按照已批準的修改活動(dòng)計劃，安排各項修改活動(dòng)的負責人員進(jìn)行修改，建立修改記錄、產(chǎn)生新的文件以取代原有文件、最后把文件交文件管理人員歸檔，并分發(fā)給有關(guān)的持有者。
第二篇 各種文件的內容要求
本篇將對引言中提到的十四種文件提供內容要求，作為文件編制的技術(shù)標準。
7 可行性研究報告
可行性研究報告的編寫(xiě)目的是：說(shuō)明該軟件開(kāi)發(fā)項目的實(shí)現在技術(shù)、經(jīng)濟和社會(huì )條件方面的可行性；評述為了合理地達到開(kāi)發(fā)目標而可能選擇的各種方案；說(shuō)明并論證所選定的方案。
可行性研究報告的編寫(xiě)內容要求如下：
7．1引言
7．1C1編寫(xiě)目的
7．1．2背景
7．1．3定義
7．1．4參考資料 7
7．2可行性研究的前提
7．2．1要求
7．2．2目標
7．2．3條件、假定和限制
7．2．4進(jìn)行可行性研究的方法
7．2．5評價(jià)尺度
7．3對現有系統的分析
7．3．1數據流程和處理流程
7．3．2工作負荷
7．3．3費用開(kāi)支
7．3．4人員
7．3．5設備
7．3．6局限性
7．4所建議的系統
7．4．1對所建議系統的說(shuō)明
7．4．2數據流程和處理流程
7．4．3改進(jìn)之處
7．4．4影響
7．4．4．1對設備的影響
7．4．4．2對軟件的影響
7．4．4．3對用戶(hù)單位機構的影響
7．4．4．4對系統運行的影響
7．4．4．5對開(kāi)發(fā)的影響
7．4，4．6對地點(diǎn)和設施的影響
7．4．4．7對經(jīng)費開(kāi)支的影響
7．4．5局限性
7．4．6技術(shù)條件方面的可行性
7．5可選擇的其他系統方案
7．5．1可選擇的系統方案1
7．5．2可選擇的系統方案2
．．．．．．
7．6投資及收益分析
7．6．1支出
7．6．1．1基本建設投資
7．6．1．2其他一次性支出
7．6．1．3非一次性支出
7．6．2收益
7．6，2．1一次性收益
7．6．2．2非一次性收益
7．6．2．3不可定量的收益
7．6．3收益／投資比
7．6．4投資回收周期
7．6．5敏感性分析
7．7社會(huì )條件方面的可行性
7．7．1法律方面的可行性
7．7．2使用方面的可行性
7．8結論
8 項目開(kāi)發(fā)計劃
編制項目開(kāi)發(fā)計劃的目的是用文件的形式，把對于在開(kāi)發(fā)過(guò)程中各項工作的負責人員、開(kāi)發(fā)進(jìn)度、所需經(jīng)費預算、所需軟、硬件條件等問(wèn)題作出的安排記載下來(lái)，以便根據本計劃開(kāi)展和檢查本項目的開(kāi) 發(fā)工作。編制內容要求如下：
8．1引言
8．1．1編寫(xiě)目的
8．1．2背景
8．1．3定義
8．1．4參考資料
8．2項目概述
8．2．1作內容
8．2．2主要參加人員
8．2．3產(chǎn)品及成果
8．2．3．1程序
8．2．3．2文件
8．2．3．3服務(wù)
8．2．3．4非移交產(chǎn)品
8．2．4驗收標準
8．．2．5完成項目的最遲期限
8．2．6本計劃的審查者與批準者
8．3實(shí)施總計劃
8．3．1工作任務(wù)的分解
8．3．2接口人員
8．3．3進(jìn)度
8．3．4預算
8．3．5關(guān)鍵問(wèn)題
8．4支持條件
8．4．1計算機系統支持
8．4．2需要用戶(hù)承擔的工作
8．4．3需由外單位提供的條件
8．5專(zhuān)題計劃要點(diǎn)
9 軟件需求說(shuō)明書(shū)
軟件需求說(shuō)明書(shū)的編制是為了使用戶(hù)和軟件開(kāi)發(fā)者雙方對該軟件的初始規定有一個(gè)共同的理解，使之成為整個(gè)開(kāi)發(fā)工作的基礎。編制軟件需求說(shuō)明書(shū)的內容要求如下：
9．1引言
9．1．1編寫(xiě)目的
9．1．2背景
9．1．3定義
9．1．4參考資料
9．2任務(wù)概述
9．2．1目標
9．2．2用戶(hù)的特點(diǎn)
9．2．3假定與約束
9．3需求規定
9．3．1對功能的規定
9．3．2對性能的規定
9．3．2．1精度
9．3．2．2時(shí)間特性耍求
9．3．2．3靈活性
9．3．3輸入輸出要求
9．3．4數據管理能力要求
9．3．5故障處理要求
9．3．6其他專(zhuān)門(mén)要求
9．4運行環(huán)境規定
9．4．1設備
9．4．2支持軟件
9．4．3接口
9．4．4控制
10 數據要求說(shuō)明書(shū)
數據 要求說(shuō)明書(shū)的編制目的是為了向整個(gè)開(kāi)發(fā)時(shí)期提供關(guān)于被處理數據的描述和數據采集要求的技術(shù)信息。編制數據要求說(shuō)明書(shū)的內容要求如下：
10．1引言
10．1．1編寫(xiě)目的
10．1．2背景
10．1．3定義
10．1．4參考資料
10．2數據的邏輯描述
10．2．1靜態(tài)數據
10．2．2動(dòng)態(tài)輸入數據
10．2．3動(dòng)態(tài)輸出數據
10．2．4內部生成數據
10．2．5數據約定
10．3數據的采集
10．3．1要求和范圍
10．3．2輸入的承擔者
10．3．3處理
10．3．4影響。
11 概要設計說(shuō)明書(shū)
概要設計說(shuō)明書(shū)又可稱(chēng)系統設計說(shuō)明書(shū)，這里所說(shuō)的系統是指程序系統。編制的目的是說(shuō)明對程序系統的設計考慮，包括程序系統的基本處。流程、程序系統的組織結構、模塊劃分、功能分配、接口設計。 運行設計、數據結構設計和出錯處理設計等，為程序的詳細設計提供基礎。編制概要設計說(shuō)明書(shū)的內容要求如下：
11．1引言
11．1．1編寫(xiě)目的
11．1．2背景
11．1．3定義
11．1．4參考資料
11．2總體設計
11．2．1需求規定
11．2．2運行環(huán)境
11．2．3基本設計概念和處理流程
11．2．4結構
11．2．5功能需求與程序的關(guān)系
11．2．6人工處理過(guò)程
11．2．7尚未解決的問(wèn)題
11．3接口設計
11．3．1用戶(hù)接口
11．3．2外部接口
11．3．3內部接口
11．4運行設計
11．4．1運行模塊組合
11．4．2運行控制
11．4．3運行時(shí)間
11．5系統論據結構設計
11．5．1邏輯結構設計要點(diǎn)
11．5．2物理結構設計要點(diǎn)
11．5．3數據結構與程序的關(guān)系
11． 6系統出錯處理設計
11．6．1出錯信息
11．6．2補救措施
11．6 3系統維護設計
12詳細設計說(shuō)明書(shū)
詳細設計說(shuō)明書(shū)又可稱(chēng)程序設計說(shuō)明書(shū)。編制目的是說(shuō)明一個(gè)軟件系統各個(gè)層次中的每一個(gè)程序（每個(gè)模塊或子程序）的設計考慮，如果一個(gè)軟件系統比較簡(jiǎn)單，層次很少，本文件可以不單獨編寫(xiě)，有關(guān) 內容合并入概要設計說(shuō)明書(shū)。對詳細設計說(shuō)明書(shū)的內容要求如下：
12．1引言
12．1．1編寫(xiě)目的
12．1．2背景
12．1．3定義
12．1．4參考資料
12．2程序系統的組織結構
12． 3程序1（標識符）設計說(shuō)明
12．3．1程序描述
12．3．2功能
12．3．3性能
12．3．4輸入項
12．3．5輸出項
12．3．6算法
12．3．7流程邏輯
12．3．8接口
12．3．．9存儲分配
12．3．10注釋設計
12．3．11限制條件
12．3．12測試計劃．
12．3．13尚未解決的問(wèn)題
12．4程序2（標識符）設計說(shuō)明
．．．．．．
13 數據庫設計說(shuō)明書(shū)
數據庫設計說(shuō)明書(shū)的編制目的是對于設計中的數據庫的所有標識、邏輯結構和物理結構作出具體的設計規定。其內容要求如下：
13．1引言
13．1．1編寫(xiě)目的
13．1．2背景
13．1．3定義
13．1．4參考資料
13．2外部設計
13．2．1標識符和狀態(tài)
13．2．2使用它的程序
13．2．3約定
13．2．4專(zhuān)門(mén)指導
13．2．5支持軟件
13． 3結構設計
13．3．1概念結構設計
13．3．2邏輯結構設計
13．3．3物理結構設計
13． 4運用設計
13．4．1數據字典設計
13．4．2安全保密設計
14 用戶(hù)手冊
用戶(hù)手冊的編制是要使用非專(zhuān)門(mén)術(shù)語(yǔ)的語(yǔ)言，充分地描述該軟件系統所具有的功能及基本的使用方法。使用戶(hù)（或潛在用戶(hù)）通過(guò)本手冊能夠了解該軟件的用途，并且能夠確定在什么情況下，如何使用它。具體的內容要求如下：
14．1引言
14．1．1編寫(xiě)目的
14．1．2背景
14．1．3定義
14．1．4參考資料
14．2用途
14．2．1功能
14．2．2性能
14．2．2．1精度
14．2．2．2時(shí)間特性
14．2．2．3靈活性
14．2．3安全保密
14． 3運行環(huán)境
14．3．1硬設備
14．3．2支持軟件
14．3．3數據結構
14．4使用過(guò)程
14．4．1安裝與初始化
14．4．2輸入
14．4．2．1輸入數據的現實(shí)背景
14．4．2．2輸入格式
14．4．2．3輸入舉例
14．4．3輸出
14．4．3．1輸出數據的現實(shí)背景
14．4．3．2輸出格式
14．4．3．3輸出舉例
14．4．4文卷查詢(xún)
14．4．5出錯處理與恢復
14．4．6終端操作
15 操作手冊
操作手冊的編制是為了向操作人員提供該軟件每一個(gè)運行的具體過(guò)程和有關(guān)知識，包括操作方法的細節。具體的內容要求如下：
15．1引言
15．1．1編寫(xiě)目的
15．1．2背景
15．1．3定義
15．1．4參考資料
15． 2軟件概述
15．2．1軟件的結構
15．2．2程序表
15．2．3文卷表
15．3安裝與初始化
15．4運行說(shuō)明
15．4．1運行表
15．4．2運行步驟
15．4．3運行1（標識符）說(shuō)明
15．4．3．1運行控制
15．4．3．2操作信息
15．4．3．3輸入一輸出文卷
15．4．3．4輸出文段
15．4．3．5輸出文段的復制
15．4．3．6啟動(dòng)恢復過(guò)程
15．4．4運行2（標識符）說(shuō)明
．．．．．．
15．5非?，F過(guò)程
15．6遠程操作
16 模塊開(kāi)發(fā)卷宗
模塊開(kāi)發(fā)卷宗是在模塊開(kāi)發(fā)過(guò)程中逐步編寫(xiě)出來(lái)的，每完成一個(gè)模塊或一組密切相關(guān)的模塊的復審時(shí)編寫(xiě)一份，應該把所有的模塊開(kāi)發(fā)卷宗匯集在一起。編寫(xiě)的目的是記錄和匯總低層次開(kāi)發(fā)的進(jìn)度和結果，以便于對整個(gè)模塊開(kāi)發(fā)工作的管理和復審，并為將來(lái)的維護提供非常有用的技術(shù)信息。具體的內容要求如下：
16． 1標題
16．2模塊開(kāi)發(fā)情況表（見(jiàn)下表）
模塊開(kāi)發(fā)情況表
16．3功能說(shuō)明
16．4設計說(shuō)明
16．5源代碼清單
16．6測試說(shuō)明
16．7復審的結論
17測試計劃
這里所說(shuō)的測試，主要是指整個(gè)程序系統的組裝測試和確認測試。本文件的編制是為了提供一個(gè)對該軟件的測試計劃，包括對每項測試活動(dòng)的內容、進(jìn)度安排、設計考慮、測試數據的整理方法及評價(jià)準則。具體的內容要求如下：
17．1引言
17．1．1編寫(xiě)目的
17．1．2背景
17．1．3定義
17．1．4參考資料
17． 2計劃
17．2．1軟件說(shuō)明
17．2．2測試內容
17．2．3測試1（標識符）
17．2．3．1進(jìn)度安排
17．2．3．2條件
17．2．3．3測試資料
17．2．3．4測試培訓
17．2．4測試2（標識符）
．．．．．．
17．3測試設計說(shuō)明
17．3．1測試l（標識符）
17．3．1．1控制
17．3．1．2輸入
17．3．1．3輸出
17．3．1．4過(guò)程
17．3．2測試2（標識符）
．．．．．．．
17．4評價(jià)準則
17．4．1范圍
17．4．2數據整理
17．4．3尺度
18 測試分析報告
測試分析報告的編寫(xiě)是為了把組裝測試和確認測試的結果、發(fā)現及分析寫(xiě)成文件加以記載，具體的內容要求如下：
18．1引言
18．1．1編寫(xiě)目的
18．1．2背景
18．1．3定義
18．1．4參考資料
18．2測試概要
18．3測試結果及發(fā)現
18．3．1測試1（標識符）
18．3．2測試2（標識符）
．．．．．．
18．4對軟件功能的結論
18．4．1功能1（標識符）
18．4．1．1能力
18．4．1．2限制
18．4．2功能2（標識符）
18．5分析摘要
18．5．1能力
18．5．2缺陷和限制
18．5．3建議
18．5．4評價(jià)
18．6測試資源消耗
19 開(kāi)發(fā)進(jìn)度月報
開(kāi)發(fā)進(jìn)度月報的編制目的是及時(shí)向有關(guān)管理部門(mén)匯報項目開(kāi)發(fā)的進(jìn)展和情況，以便及時(shí)發(fā)現和處理開(kāi)發(fā)過(guò)程中出現的問(wèn)題。一般地，開(kāi)發(fā)進(jìn)度月報是以項目組為單位每月編寫(xiě)的。如果被開(kāi)發(fā)的軟件系 統規模比較大，整個(gè)工程項目被劃分給若干個(gè)分項目組承擔，開(kāi)發(fā)進(jìn)度月報將以分項目組為單位按月編寫(xiě)。具體的內容要求如下：
19．1標題
19．2工程進(jìn)度與狀態(tài)
19．2．1進(jìn)度
19．2．2狀態(tài)
19．3資源耗用與狀態(tài)
19．3．1資源耗用
19．3．1．1工時(shí)
19．3．1．2機時(shí)
19．3．2狀態(tài)
19．4經(jīng)費支出與狀態(tài)
19．4．1經(jīng)費支出
19．4．1．1支持性費用
19．4．1．2設備購置費
19．4．2狀態(tài)
19．5下個(gè)月的工作計劃
19．6建議
20 項目開(kāi)發(fā)總結報告
項目開(kāi)發(fā)總結報告的編制是為了總結本項目開(kāi)發(fā)工作的經(jīng)驗，說(shuō)明實(shí)際取得的開(kāi)發(fā)結果以及對整個(gè)開(kāi)發(fā)工作的各個(gè)方面的評價(jià)。具體的內容要求如下：
20．1引言
20．1．1編寫(xiě)目的
20．1．2背景
20．1．3定義
20．1．4參考資料
20．2．1產(chǎn)品
20．2實(shí)際開(kāi)發(fā)結果
20．2．2主要功能和性能
20．2．3基本流程
20．2．4進(jìn)度
20．2．5費用
20．3開(kāi)發(fā)工作評價(jià)
20．3．1對生產(chǎn)效率的評價(jià)
20．3．2對產(chǎn)品質(zhì)量的評價(jià)
20．3．3對技術(shù)方法的評價(jià)
20．3．4出錯原因的分析
20．4經(jīng)驗與教訓
附錄A
可行性研究報告的編寫(xiě)提示
（參考件）
A．1引言
A．1．1編寫(xiě)目的
說(shuō)明編寫(xiě)本可行性研究報告的目的，指出預期的讀者。
A．1．2背景
說(shuō)明：
a．所建議開(kāi)發(fā)的軟件系統的名稱(chēng)；
b．本項目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)及實(shí)現該軟件的計算中心或計算機網(wǎng)絡(luò )；
C．該軟件系統同其他系統或其他機構的基本的相互來(lái)往關(guān)系。
A．1．3定義
列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。
A．1．4參考資料
列出用得著(zhù)的參考資料，如：
a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文；
b．屬于本項目的其他已發(fā)表的文件；
C．本文件中各處引用的文件、資料，包括所需用到的軟件開(kāi)發(fā)標準。|
列出這些文件資料的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。
A．2可行性研究的前提
說(shuō)明對所建議的開(kāi)發(fā)項目進(jìn)行可行性研究的前提，如要求、目標、假定、限制等。
A．2．1要求
說(shuō)明對所建議開(kāi)發(fā)的軟件的基本要求，如：
a．功能；
b．性能；
C．輸出如報告、文件或數據，對每項輸出要說(shuō)明其特征，如用途、產(chǎn)生頻度、接口以及分發(fā)對象；
d．輸入說(shuō)明系統的輸入，包括數據的來(lái)源、類(lèi)型、數量、數據的組織以及提供的頻度；
e．處理流程和數據流程用圖表的方式表示出最基本的數據流程和處理流程，并輔之以敘述；
f．在安全與保密方面的要求；
g．同本系統相連接的其他系統；
h．完成期限。
A．2．2目標
說(shuō)明所建議系統的主要開(kāi)發(fā)目標，如：
a．人力與設備費用的減少；
b．處理速度的提高；
C．控制精度或生產(chǎn)能力的提高；
d．管理信息服務(wù)的改進(jìn)；
e．自動(dòng)決策系統的改進(jìn)；
f．人員利用率的改進(jìn)。
A．2．3條件、假定和限制
說(shuō)明對這項開(kāi)發(fā)中給出的條件、假定和所受到的限制，如：
a．所建議系統的運行壽命的最小值；
b．進(jìn)行系統方案選擇比較的時(shí)間；
c．經(jīng)費、投資方面的來(lái)源和限制；
d．法律和政策方面的限制；
e．硬件、軟件、運行環(huán)境和開(kāi)發(fā)環(huán)境方面的條件和限制；
f．可利用的信息和資源；
g．系統投入使用的最晚時(shí)間。
A．2．4進(jìn)行可行性研究的方法
說(shuō)明這項可行性研究將是如何進(jìn)行的，所建議的系統將是如何評價(jià)的。摘要說(shuō)明所使用的基本方法和策略，如調查、加權、確定模型、建立基準點(diǎn)或仿真等。
A．2．5評價(jià)尺度
說(shuō)明對系統進(jìn)行評價(jià)時(shí)所使用的主要尺度，如費用的多少、各項功能的優(yōu)先次序、開(kāi)發(fā)時(shí)間的長(cháng)短及使用中的難易程度。
A．3 對現有系統的分析
這里的現有系統是指當前實(shí)際使用的系統，這個(gè)系統可能是計算機系統，也可能是一個(gè)機械系統甚至是一個(gè)人工系統。
分析現有系統的目的是為了進(jìn)一步闡明建議中的開(kāi)發(fā)新系統或修改現有系統的必要性。
A．3．1處理流程和數據流程
說(shuō)明現有系統的基本的處理流程和數據流程。此流程可用圖表即流程圖的形式表示，并加以敘述。
A．3．2工作負荷
列出現有系統所承擔的工作及工作量。
A．3．3費用開(kāi)支
列出由于運行現有系統所引起的費用開(kāi)支，如人力、設備、空間、支持性服務(wù)、材料等項開(kāi)支以及開(kāi)支總額。
A．3．4人員
列出為了現有系統的運行和維護所需要的人員的專(zhuān)業(yè)技術(shù)類(lèi)別和數量。
A．3．5設備
列出現有系統所使用的各種設備。
A．3．6局限性
列出本系統的主要的局限性，例如處理時(shí)間趕不上需要，響應不及時(shí)，數據存儲能力不足，處理功能不夠等。并且要說(shuō)明，為什么對現有系統的改進(jìn)性維護已經(jīng)不能解決問(wèn)題。
A．4 所建議的系統
本章將用來(lái)說(shuō)明所建議系統的目標和要求將如何被滿(mǎn)足。
A．4．1對所建議系統的說(shuō)明
概括地說(shuō)明所建議系統，并說(shuō)明在第A(yíng)．2章中列出的那些要求將如何得到滿(mǎn)足，說(shuō)明所使用的基本方法及理論根據。
A．4．2處理流程和數據流程
給出所建議系統的處理流程和數據流程。
A．4．3改進(jìn)之處
按A．2．2條中列出的目標，逐項說(shuō)明所建議系統相對于現存系統具有的改進(jìn)。
A．4．4影響
說(shuō)明在建立所建議系統時(shí)，預期將帶來(lái)的影響，包括：
A．4．4．1對設備的影響
說(shuō)明新提出的設備要求及對現存系統中尚可使用的設備須作出的修改。
A．4．4．2對軟件的影響
說(shuō)明為了使現存的應用軟件和支持軟件能夠同所建議系統相適應。而需要對這些軟件所進(jìn)行的修改和補充。
A．4．4．3對用戶(hù)單位機構的影響
說(shuō)明為了建立和運行所建議系統，對用戶(hù)單位機構、人員的數量和技術(shù)水平等方面的全部要求。
A． 4． 4． 4對系統運行過(guò)程的影響
說(shuō)明所建議系統對運行過(guò)程的影響，如：
a．用戶(hù)的操作規程；
b．運行中心的操作規程；
C．運行中心與用戶(hù)之間的關(guān)系；
d．源數據的處理；
e．數據進(jìn)入系統的過(guò)程；
f．對數據保存的要求，對數據存儲、恢復的處理；
g．輸出報告的處理過(guò)程、存儲媒體和調度方法；
h．系統失效的后果及恢復的處理辦法。
A．4．4．5對開(kāi)發(fā)的影響
說(shuō)明對開(kāi)發(fā)的影響，如：
a．為了支持所建議系統的開(kāi)發(fā)，用戶(hù)需進(jìn)行的工作；
b．為了建立一個(gè)數據庫所要求的數據資源；
C．為了開(kāi)發(fā)和測驗所建議系統而需要的計算機資源；
d．所涉及的保密與安全問(wèn)題。
A．4．4．6對地點(diǎn)和設施的影響
說(shuō)明對建筑物改造的要求及對環(huán)境設施的要求。
A．4．4．7對經(jīng)費開(kāi)支的影響
扼要說(shuō)明為了所建議系統的開(kāi)發(fā)，設計和維持運行而需要的各項經(jīng)費開(kāi)支。
A．4．5局限性
說(shuō)明所建議系統尚存在的局限性以．及這些問(wèn)題未能消除的原因。
A．4．6技術(shù)條件方面的可行性
本節應說(shuō)明技術(shù)條件方面的可行性，如：
a．在當前的限制條件下，該系統的功能目標能否達到；
b．利用現有的技術(shù)，該系統的功能能否實(shí)現；
C．對開(kāi)發(fā)人員的數量和質(zhì)量的要求并說(shuō)明這些要求能否滿(mǎn)足；
d．在規定的期限內，本系統的開(kāi)發(fā)能否完成。
A．5可選擇的其他系統方案
扼要說(shuō)明曾考慮過(guò)的每一種可選擇的系統方案，包括需開(kāi)發(fā)的和可從國內國外直接購買(mǎi)的，如果沒(méi)有供選擇的系統方案可考慮，則說(shuō)明這一點(diǎn)。
A．5．1可選擇的系統方案1
參照第A(yíng)．4章的提綱，說(shuō)明可選擇的系統方案1，并說(shuō)明它未被選中的理由。
A．5．2可選擇的系統方案2
按類(lèi)似A． 5． 1條的方式說(shuō)明第2個(gè)乃至第。個(gè)可選擇的系統方案。
．．．．．．
A．6投資及效益分析
A．6．1支出
對于所選擇的方案，說(shuō)明所需的費用。如果已有一個(gè)現存系統，則包括該系統繼續運行期間所需的費用。
A．6．1．1基本建設投資
包括采購、開(kāi)發(fā)和安裝下列各項所需的費用，如：
a．房屋和設施；
b． A DP設備；
C．數據通訊設備；
d．環(huán)境保護設備；
e．安全與保密設備；
f．ADP操作系統的和應用的軟件；
g．數據庫管理軟件。
A．6．1．2其他一次性支出
包括下列各項所需的費用，如：
a．研究（需求的研究和設計的研究）；
b．開(kāi)發(fā)計劃與測量基準的研究；
C．數據庫的建立；
d．ADP軟件的轉換；
e．檢查費用和技術(shù)管理性費用；
f．培訓費、旅差費以及開(kāi)發(fā)安裝人員所需要的一次性支出；
g．人員的退休及調動(dòng)費用等。
A．6．1．3非一次性支出
列出在該系統生命期內按月或按季或按年支出的用于運行和維護的費用，包括：
a．設備的租金和維護費用；
b軟件的租金和維護費用；
C．數據通訊方面的租金和維護費用；
d．人員的工資、獎金；
e．房屋、空間的使用開(kāi)支；
f．公用設施方面的開(kāi)支；
g．保密安全方面的開(kāi)支；
h．其他經(jīng)常性的支出等。
A．6．2收益
對于所選擇的方案，說(shuō)明能夠帶來(lái)的收益，這里所說(shuō)的收益，表現為開(kāi)支費用的減少或避免、差錯的減少、靈活性的增加、動(dòng)作速度的提高和管理計劃方面的改進(jìn)等，包括；
A．6．2．1一次性收益
說(shuō)明能夠用人民幣數目表示的一次性收益，可按數據處理、用戶(hù)、管理和支持等項分類(lèi)敘述，如：
a．開(kāi)支的縮減包括改進(jìn)了的系統的運行所引起的開(kāi)支縮減，如資源要求的減少，運行效率的改進(jìn)，數據進(jìn)入、存貯和恢復技術(shù)的改進(jìn)，系統性能的可監控，軟件的轉換和優(yōu)化，數據壓縮技術(shù)的采用，處理的集中化／分布化等；
b．價(jià)值的增升包括由于一個(gè)應用系統的使用價(jià)值的增升所引起的收益，如資源利用的改進(jìn)，管理和運行效率的改進(jìn)以及出錯率的減少等；
C．其他如從多余設備出售回收的收入等。
A．6．2．2非一次性收益
說(shuō)明在整個(gè)系統生命期內由于運行所建議系統而導致的按月的、按年的能用人民幣數目表示的收益，包括開(kāi)支的減少和避免。
A．6．2．3不可定量的收益
逐項列出無(wú)法直接用人民幣表示的收益，如服務(wù)的改進(jìn)，由操作失誤引起的風(fēng)險的減少，信息掌握情況的改進(jìn)，組織機構給外界形象的改善等。有些不可捉摸的收益只能大概估計或進(jìn)行極值估計（按最好和最差情況估計）。
A．6．3收益／投資比
求出整個(gè)系統生命期的收益／投資比值。
A．6．4投資回收周期
求出收益的累計數開(kāi)始超過(guò)支出的累計數的時(shí)間。
A．6．5敏感性分析
所謂敏感性分析是指一些關(guān)鍵性因素如系統生命期長(cháng)度、系統的工作負荷量、工作負荷的類(lèi)型與這些不同類(lèi)型之間的合理搭配、處理速度要求、設備和軟件的配置等變化時(shí)，對開(kāi)支和收益的影響最靈敏的范圍的估計。在敏感性分析的基礎上做出的選擇當然會(huì )比單一選擇的結果要好一些。
A．7 社會(huì )因素方面的可行性
本章用來(lái)說(shuō)明對社會(huì )因素方面的可行性分析的結果，包括：
A．7．1法律方面的可行性
法律方面的可行性問(wèn)題很多，如合同責任、侵犯專(zhuān)利權、侵犯版權等方面的陷井，軟件人員通常是不熟悉的，有可能陷入，務(wù)必要注意研究。
A．7．2使用方面的可行性
例如從用戶(hù)單位的行政管理、工作制度等方面來(lái)看，是否能夠使用該軟件系統；從用戶(hù)單位的工作人員的素質(zhì)來(lái)看，是否能滿(mǎn)足使用該軟件系統的要求等等，都是要考慮的。
A．8 結論
在進(jìn)行可行性研究報告的編制時(shí)，必須有一個(gè)研究的結論。結論可以是：
a．可以立即開(kāi)始進(jìn)行；
b．需要推遲到某些條件（例如資金、人力、設備等）落實(shí)之后才能開(kāi)始進(jìn)行；
c．需要對開(kāi)發(fā)目標進(jìn)行某些修改之后才能開(kāi)始進(jìn)行；
d．不能進(jìn)行或不必進(jìn)行（例如因技術(shù)不成熟、經(jīng)濟上不合算等）。
附錄B
項目開(kāi)發(fā)計劃的編寫(xiě)提示
B．1引言
B．1．1編寫(xiě)目的
說(shuō)明編寫(xiě)這份項目開(kāi)發(fā)計劃的目的，并指出預期的讀者。
B．1．2背景
說(shuō)明：
a．待開(kāi)發(fā)的軟件系統的名稱(chēng)；
b．本項目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)及實(shí)現該軟件的計算中心或計算機網(wǎng)絡(luò )；
C．該軟件系統同其他系統或其他機構的基本的相互來(lái)往關(guān)系。
B．1．3定義
列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。
B．1．4參考資料
列出用得著(zhù)的參考資料，如：
a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文；
b．屬于本項目的其他已發(fā)表的文件；
C．本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件資料的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。
B．2項目概述
B．2．1 工作內容
簡(jiǎn)要地說(shuō)明在本項目的開(kāi)發(fā)中須進(jìn)行的各項主要工作。
B．2．2主要參加人員
扼要說(shuō)明參加本項目開(kāi)發(fā)工作的主要人員的情況，包括他們的技術(shù)水平。
B．2．3產(chǎn)品
B．2．31程序
列出需移交給用戶(hù)的程序的名稱(chēng)、所用的編程語(yǔ)言及存儲程序的媒體形式，并通過(guò)引用有關(guān)文件，逐項說(shuō)明其功能和能力。
B．2．3．2文件
列出需移交給用戶(hù)的每種文件的名稱(chēng)及內容要點(diǎn)。
B．2．3．3服務(wù)
列出需向用戶(hù)提供的各項服務(wù)，如培訓安裝、維護和運行支持等，應逐項規定開(kāi)始日期、所提供支持的級別和服務(wù)的期限。
B．2．3．4非移交的產(chǎn)品
說(shuō)明開(kāi)發(fā)集體應向本單位交出但不必向用戶(hù)移交的產(chǎn)品（文件甚至某些程序）。
B．2．4驗收標準
對于上述這些應交出的產(chǎn)品和服務(wù)，逐項說(shuō)明或引用資料說(shuō)明驗收標準。
B．2．5完成項目的員遲用限
B．2．6本計劃的批準者和批準日期
B．3實(shí)施計劃
B．3．1工作任務(wù)的分門(mén)與人員分工
對于項目開(kāi)發(fā)中需完成的各項工作，從需求分析、設計、實(shí)現、測試直到維護，包括文件的編制、審批、打印、分發(fā)工作，用戶(hù)培訓工作，軟件安裝工作等，按層次進(jìn)行分解，指明每項任務(wù)的負責人和參加人員。
B．3．2 接口人員
說(shuō)明負責接口工作的人員及他們的職責，包括：
a ．負責本項目同用戶(hù)的接口人員；
b．負責本項目同本單位各管理機構，如合同計劃管理部門(mén)、財務(wù)部門(mén)、質(zhì)量管理部門(mén)等的接口人員；
c．負責本項目同各分合同負責單位的接口人員等。
B．3．3進(jìn)度
對于需求分析、設計、編碼實(shí)現、測試、移交、培訓和安裝等工作，給出每項工作任務(wù)的預。定開(kāi)始日期、完成日期及所需資源，規定各項工作任務(wù)完成的先后順序以及表征每項工作任務(wù)完成的標志性事件（即所謂“里程碑”）。
B．3．4預算
逐項列出本開(kāi)發(fā)項目所需要的勞務(wù)（包括人員的數量和時(shí)間）以及經(jīng)費的預算（包括辦公費、差旅費、機時(shí)費、資料費、通訊設備和專(zhuān)用設備的租金等）和來(lái)源。
B．3．5關(guān)鍵問(wèn)題
逐項列出能夠影響整個(gè)項目成敗的關(guān)鍵問(wèn)題、技術(shù)難點(diǎn)和風(fēng)險，指出這些問(wèn)題對項目的影響。
B．4支持條件
說(shuō)明為支持本項目的開(kāi)發(fā)所需要的各種條件和設施。
B．4．1計算機系統支持
逐項列出開(kāi)發(fā)中和運行時(shí)所需的計算機系統支持，包括計算機、外圍設備、通訊設備、模擬器、編譯（或 匯編）程序、操作系統、數據管理程序包、數據存儲能力和測試支持能力等，逐項給出有關(guān)到貨日期、 使用時(shí)間的要求。
B．4．2需由用戶(hù)承擔的工作
逐項列出需要用戶(hù)承擔的工作和完成期限。包括需由用戶(hù)提供的條件及提供時(shí)間。
B．4．3由外單位提供的條件
逐項列出需要外單位分合同承包者承擔的工作和完成的時(shí)間，包括需要由外單位提供的條件和提供的時(shí)間。
B．5專(zhuān)題計劃要點(diǎn)
說(shuō)明本項目開(kāi)發(fā)中需制訂的各個(gè)專(zhuān)題計劃（如分合同計劃、開(kāi)發(fā)人員培訓計劃、測試計劃、安全保密計劃、質(zhì)量保證計劃、配置管理計劃、用戶(hù)培訓計劃、系統安裝計劃等）的要點(diǎn)。
附錄C
軟件需求說(shuō)明書(shū)的編寫(xiě)提示
C．1引言
C．1．1編寫(xiě)目的
說(shuō)明編寫(xiě)這份軟件需求說(shuō)明書(shū)的目的，指出預期的讀者。
C．1．2背景
說(shuō)明：
a．待開(kāi)發(fā)的軟件系統的名稱(chēng)；
b．本項目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)及實(shí)現該軟件的計算中心或計算機網(wǎng)絡(luò )；
C．該軟件系統同其他系統或其他機構的基本的相互來(lái)往關(guān)系。
C．1．3定義
列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。
C．1．4參考資料
列出用得著(zhù)的參考資料，如：
a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文；
b．屬于本項目的其他已發(fā)表的文件；
c．本文件中各處引用的文件、資料、包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件資料的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。
C．2任務(wù)概述
C．2．1目標
敘述該項軟件開(kāi)發(fā)的意圖、應用目標、作用范圍以及其他應向讀者說(shuō)明的有關(guān)該軟件開(kāi)發(fā)的背景材料。解釋被開(kāi)發(fā)軟件與其他有關(guān)軟件之間的關(guān)系。如果本軟件產(chǎn)品是一項獨立的軟件，而且全部?jì)热葑院?，則說(shuō)明這一點(diǎn)。如果所定義的產(chǎn)品是一個(gè)更大的系統的一個(gè)組成部分，則應說(shuō)明本產(chǎn)品與該系統中其他各組成部分之間的關(guān)系，為此可使用一張方框圖來(lái)說(shuō)明該系統的組成和本產(chǎn)品同其他各部分的聯(lián)系和接口。|
C．2．2用戶(hù)的特點(diǎn)
列出本軟件的最終用戶(hù)的特點(diǎn)，充分說(shuō)明操作人員、維護人員的教育水平和技術(shù)專(zhuān)長(cháng)，以及本軟件的預期使甩頻度。這些是軟件設計工作的重要約束
C．2．3假定和約束
列出進(jìn)行本軟件開(kāi)發(fā)工作的假定和約束，例如經(jīng)費限制、開(kāi)發(fā)期限等。
C．3需求規定
C．3．1對功能的規定
用列表的方式（例如IPO表即輸入、處理、輸出表的形式），逐項定量和定性地敘述對軟件所提出的功能要求，說(shuō)明輸入什么量、經(jīng)怎樣的處理、得到什么輸出，說(shuō)明軟件應支持的終端數和應支持的并行操作的用戶(hù)數。
C．3．2對性能的規定
C．3．2．1精度
說(shuō)明對該軟件的輸入、輸出數據精度的要求，可能包括傳輸過(guò)程中的精度。
C．3．2．2時(shí)間特性要求
說(shuō)明對于該軟件的時(shí)間特性要求，如對：
a．響應時(shí)間；
b．更新處理時(shí)間；
c．數據的轉換和傳送時(shí)間；
d．解題時(shí)間； 等的要求。
C．3．2．3靈活性
說(shuō)明對該軟件的靈活性的要求，即當需求發(fā)生某些變化時(shí)，該軟件對這些變化的適應能力，如：
a．操作方式上的變化；
b．運行環(huán)境的變化；
c．同其他軟件的接口的變化；
d．精度和有效時(shí)限的變化；
e．計劃的變化或改進(jìn)。
對于為了提供這些靈活性而進(jìn)行的專(zhuān)門(mén)設計的部分應該加以標明。
C．3．3輸人輸出要求
解釋各輸入輸出數據類(lèi)型，并逐項說(shuō)明其媒體、格式、數值范圍、精度等。對軟件的數據輸出及必須標明的控制輸出量進(jìn)行解釋并舉例，包括對硬拷貝報告（正常結果輸出、狀態(tài)輸出及異常輸出）以及圖形或顯示報告的描述。
C．3．4數據管理能力要求
說(shuō)明需要管理的文卷和記錄的個(gè)數、表和文卷的大小規模，要按可預見(jiàn)的增長(cháng)對數據及其分量的存儲要求作出估算。
C．3．5故障處理要求
列出可能的軟件、硬件故障以及對各項性能而言所產(chǎn)生的后果和對故障處理的要求。
C．3．6其他專(zhuān)門(mén)要求
如用戶(hù)單位對安全保密的要求，對使用方便的要求，對可維護性、可補充性、易讀性、可靠性、運行環(huán)境可轉換性的特殊要求等。
C．4運行環(huán)境規定
C．4．1設備
列出運行該軟件所需要的硬設備。說(shuō)明其中的新型設備及其專(zhuān)門(mén)功能，包括：
a．處理器型號及內存容量；
b．外存容量、聯(lián)機或脫機、媒體及其存儲格式，設備的型號及數量；
c．輸入及輸出設備的型號和數量，聯(lián)機或脫機；
d．數據通信設備的型號和數量；
e．功能鍵及其他專(zhuān)用硬件
C．4．2支持軟件
列出支持軟件,包括要用到的操作系統、編譯（或匯編）程序、測試支持軟件等。
C．4．3 接口
說(shuō)明該軟件同其他軟件之間的接口、數據通信協(xié)議等。
C．4．4控制
說(shuō)明控制該軟件的運行的方法和控制信號，并說(shuō)明這些控制信號的來(lái)源。
附錄D
數據要求說(shuō)明書(shū)的編寫(xiě)提示
D．1引言
D．1．1編寫(xiě)目的
說(shuō)明編寫(xiě)這份數據要求說(shuō)明書(shū)的目的，指出預期的讀者。
D．1．2背景
說(shuō)明：
a．待開(kāi)發(fā)軟件系統的名稱(chēng)；
b．列出本項目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)以及將運行該項軟件的計算站（中心）或計算機網(wǎng)絡(luò )系統。
D．1．3定義
列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。
D．1．4參考資料
列出有關(guān)的參考資料，如：
a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同，上級機關(guān)的批文；
b．屬于本項目的其他已發(fā)表文件；
c．本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位。說(shuō)明能夠得到這些文件資料的來(lái)源。
D．2數據的邏輯描述
對數據進(jìn)行邏輯描述時(shí)可把數據分為動(dòng)態(tài)數據和靜態(tài)數據。所謂靜態(tài)數據，指在運行過(guò)程中主要作為參考的數據，它們在很長(cháng)的一段時(shí)間內不會(huì )變化，一般不隨運行而改變。所謂動(dòng)態(tài)數據．包括所有在運 行中要發(fā)生變化的數據以及在運行中要輸入、輸出的數據。進(jìn)行描述時(shí)應把各數據元素邏輯地分成若干組，列如函數、源數據或對于其應用更為恰當的邏輯分組。給出每一數據元的名稱(chēng)（包括縮寫(xiě)和代碼）、定 義（或物理意義）度量單位、值域、格式和類(lèi)型等有關(guān)信息。
D．2．1靜態(tài)數據
列出所有作為控制或參考用的靜態(tài)數據元素。
D．2．2動(dòng)態(tài)輸人數據
列出動(dòng)態(tài)輸入數據元素（包括在常規運行中或聯(lián)機操作中要改變的數據）。
D．2．3動(dòng)態(tài)輸出數據
列出動(dòng)態(tài)輸出數據元素（包括在常規運行中或聯(lián)機操作中要改變的數據）。
D．2．4內部生成數據
列出向用戶(hù)或開(kāi)發(fā)單位中的維護調試人員提供的內部生成數據。
D．2．5數據約定
說(shuō)明對數據要求的制約。逐條列出對進(jìn)一步擴充或使用方面的考慮而提出的對數據要求的限制（容量、文卷、記錄和數據元的個(gè)數的最大值）。對于在設計和開(kāi)發(fā)中確定是臨界性的限制更要明確指出。
D．3．數據的采集
D．3．1要求和范圍
按數據元的邏輯分組來(lái)說(shuō)明數據采集的要求和范圍，指明數據的采集方法，說(shuō)明數據采集工作的承擔者是用戶(hù)還是開(kāi)發(fā)者。具體的內容包括：
a．輸入數據的來(lái)源，例如是單個(gè)操作員、數據輸入站，專(zhuān)業(yè)的數據輸入公司或它們的一個(gè)分組；
b．數據輸入（指把數據輸入處理系統內部）所用的媒體和硬設備。如果只有指定的輸入點(diǎn)的輸入才是合法的，則必須對此加以說(shuō)明；
c．接受者說(shuō)明輸出數據的接受者；
d．輸出數據的形式和設備列出輸出數據的形式和硬設備。無(wú)論接受者將接收到的數據是打印輸出，還是CRT上的一組字符、一幀圖形，或一聲警鈴，或向開(kāi)關(guān)線(xiàn)圈提供的一個(gè)電脈沖，或常用介質(zhì)如磁盤(pán)、磁帶、穿孔卡片等，均應具體說(shuō)明；
e．數據值的范圍給出每一個(gè)數據元的合法值的范圍；
f．量綱給出數字的度量單位、增量的步長(cháng)、零點(diǎn)的定標等。在數據是非數字量的情況下，要給出每一種合法值的形式和含意；
g．更新和處理的頻度給出預定的對輸入數據的更新和處理的頻度。如果數據的輸入是隨機的，應給出更新處理的頻度的平均值，或變化情況的某種其他度量。
D．3．2輸人的承擔者
說(shuō)明預定的對數據輸入工作的承擔者。如果輸入數據同某一接口軟件有關(guān)，還應說(shuō)明該接口軟件的來(lái)源。
D．3．3預處理
對數據的采集和預處理過(guò)程提出專(zhuān)門(mén)的規定，包括適合應用的數據格式、預定的數據通信媒體和對輸入的時(shí)間要求等。對于需經(jīng)模擬轉換或數字轉換處理的數據量，要給出轉換方法和轉換因子等有關(guān)信息，以便軟件系統使用這些數據。
D．3．4 影響
說(shuō)明這些數據要求對于設備、軟件、用戶(hù)、開(kāi)發(fā)單位所可能產(chǎn)生的影響，例如要求用戶(hù)單位增設某個(gè)機構等。
附錄E
概要設計說(shuō)明書(shū)的編寫(xiě)提示
E．1引言
E．1．1編寫(xiě)目的
說(shuō)明編寫(xiě)這份概要設計說(shuō)明書(shū)的目的，指出預期的讀者。
E．1．2背景
說(shuō)明：
a．待開(kāi)發(fā)軟件系統的名稱(chēng)；
b．列出此項目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)以及將運行該軟件的計算站（中心）。
E．1．3定義
列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。
E．1．4參考資料
列出有關(guān)的參考文件，如：
a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同，上級機關(guān)的批文；
b．屬于本項目的其他已發(fā)表文件；
c．本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。
E．2總體設計
E．2．1需求規定
說(shuō)明對本系統的主要的輸入輸出項目、處理的功能性能要求，詳細的說(shuō)明可參見(jiàn)附錄C。
E．2．2運行環(huán)境
簡(jiǎn)要地說(shuō)明對本系統的運行環(huán)境（包括硬件環(huán)境和支持環(huán)境）的規定，詳細說(shuō)明參見(jiàn)附錄C。
E．2．3基本設計概念和處理流程
說(shuō)明本系統的基本設計概念和處理流程，盡量使用圖表的形式。
E．2．4結構
用一覽表及框圖的形式說(shuō)明本系統的系統元素（各層模塊、子程序、公用程序等）的劃分，扼要說(shuō)明每個(gè)系統元素的標識符和功能，分層次地給出各元素之間的控制與被控制關(guān)系．
E．2．5功能器求與程序的關(guān)系
本條用一張如下的矩陣圖說(shuō)明各項功能需求的實(shí)現同各塊程序的分配關(guān)系：
E．2．6人工處理過(guò)程
說(shuō)明在本軟件系統的工作過(guò)程中不得不包含的人工處理過(guò)程（如果有的話(huà)）。
E．2．7尚未問(wèn)決的問(wèn)題
說(shuō)明在概要設計過(guò)程中尚未解決而設計者認為在系統完成之前必須解決的各個(gè)問(wèn)題。
E．3 接口設計
E．3．1用戶(hù)接口
說(shuō)明將向用戶(hù)提供的命令和它們的語(yǔ)法結構，以及軟件的回答信息。
E．3．2外部接口
說(shuō)明本系統同外界的所有接口的安排包括軟件與硬件之間的接口、本系統與各支持軟件之間的接口關(guān)系。
E．3．3內部接口
說(shuō)明本系統之內的各個(gè)系統元素之間的接口的安排。
E．4運行設計
E．4．1運行模塊組合
說(shuō)明對系統施加不同的外界運行控制時(shí)所引起的各種不同的運行模塊組合，說(shuō)明每種運行所歷經(jīng)的內部模塊和支持軟件。
E．4．2運行控制
說(shuō)明每一種外界的運行控制的方式方法和操作步驟。
E．4．3運行時(shí)間
說(shuō)明每種運行模塊組合將占用各種資源的時(shí)間。
E．5系統數據結構設計
E．5．1邏輯結構設計要點(diǎn)
給出本系統內所使用的每個(gè)數據結構的名稱(chēng)、標識符以及它們之中每個(gè)數據項、記錄、文卷和系的標識、定義、長(cháng)度及它們之間的層次的或表格的相互關(guān)系。
E．5．2物理結構設計要點(diǎn)
給出本系統內所使用的每個(gè)數據結構中的每個(gè)數據項的存儲要求，訪(fǎng)問(wèn)方法、存取單位、存取的物理關(guān)系（索引、設備、存儲區域）、設計考慮和保密條件。
E．5．3數據結構與程序的關(guān)系
說(shuō)明各個(gè)數據結構與訪(fǎng)問(wèn)這些數據結構的形式:
E．6系統出錯處理設計
E．6．1出錯信息
用一覽表的方式說(shuō)朗每種可能的出錯或故障情況出現時(shí)，系統輸出信息的形式、含意及處理方法。
E．6．2補救措施
說(shuō)明故障出現后可能采取的變通措施，包括：
a．后備技術(shù)說(shuō)明準備采用的后備技術(shù)，當原始系統數據萬(wàn)一丟失時(shí)啟用的副本的建立和啟動(dòng)的技術(shù)，例如周期性地把磁盤(pán)信息記錄到磁帶上去就是對于磁盤(pán)媒體的一種后備技術(shù)；
b．降效技術(shù)說(shuō)明準備采用的后備技術(shù)，使用另一個(gè)效率稍低的系統或方法來(lái)求得所需結果的某些部分，例如一個(gè)自動(dòng)系統的降效技術(shù)可以是手工操作和數據的人工記錄；
c．恢復及再啟動(dòng)技術(shù)說(shuō)明將使用的恢復再啟動(dòng)技術(shù)，使軟件從故障點(diǎn)恢復執行或使軟件從頭開(kāi)始重新運行的方法。
E．6．3系統維護設計
說(shuō)明為了系統維護的方便而在程序內部設計中作出的安排，包括在程序中專(zhuān)門(mén)安排用于系統的檢查與維護的檢測點(diǎn)和專(zhuān)用模塊。各個(gè)程序之間的對應關(guān)系，可采用如下的矩陣圖的形式；
附錄F
詳細設計說(shuō)明書(shū)的編寫(xiě)提示
F．1引言
F．1．1編寫(xiě)目的
說(shuō)明編寫(xiě)這份詳細設計說(shuō)明書(shū)的目的，指出預期的讀者。
F．1．2背景
說(shuō)明：
a．待開(kāi)發(fā)軟件系統的名稱(chēng)；
b．本項目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)和運行該程序系統的計算中心。
F．1．3定義
列出本文件中用到專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。
F．1．4參考資料
列出有關(guān)的參考資料，如：
a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文；
b．屬于本項目的其他已發(fā)表的文件；
c．本文件中各處引用到的文件資料，包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠取得這些文件的來(lái)源。
F．2程序系統的結構
用一系列圖表列出本程序系統內的每個(gè)程序（包括每個(gè)模塊和子程序）的名稱(chēng)、標識符和它們之間的層次結構關(guān)系。
F．3程序1（標識符）設計說(shuō)明
從本章開(kāi)始，逐個(gè)地給出各個(gè)層次中的每個(gè)程序的設計考慮。以下給出的提綱是針對一般情況的。對于一個(gè)具體的模塊，尤其是層次比較低的模塊或子程序，其很多條目的內容往往與它所隸屬的上一層 模塊的對應條目的內容相同，在這種情況下，只要簡(jiǎn)單地說(shuō)明這一點(diǎn)即可。
F．3．1程序描述
給出對該程序的簡(jiǎn)要描述，主要說(shuō)明安排設計本程序的目的意義，并且，還要說(shuō)明本程序的特點(diǎn)（如是常駐內存還是非常駐？是否子程序？是可重人的還是不可重人的？有無(wú)覆蓋要求？是順序處理還是并發(fā) 處理卜…．．等）。
F．3．2功能
說(shuō)明該程序應具有的功能，可采用IPO圖（即輸入一處理一輸出圖）的形式。
F．3．3性能
說(shuō)明對該程序的全部性能要求，包括對精度、靈活性和時(shí)間特性的要求。
F．3．4輸人項
給出對每一個(gè)輸入項的特性，包括名稱(chēng)、標識、數據的類(lèi)型和格式、數據值的有效范圍、輸入的方式。數量和頻度、輸入媒體、輸入數據的來(lái)源和安全保密條件等等。
F． 3． 5輸出項
給出對每一個(gè)輸出項的特性，包括名稱(chēng)、標識、數據的類(lèi)型和格式，數據值的有效范圍，輸出的形式、數量和頻度，輸出媒體、對輸出圖形及符號的說(shuō)明、安全保密條件等等。
F．3．6算法
詳細說(shuō)明本程序所選用的算法，具體的計算公式和計算步驟。
F．3．7流程邏輯
用圖表（例如流程圖、判定表等）輔以必要的說(shuō)明來(lái)表示本程序的邏輯流程。
F．3．8接口
用圖的形式說(shuō)明本程序所隸屬的上一層模塊及隸屬于本程序的下一層模塊、子程序，說(shuō)明參數賦值和調用方式，說(shuō)明與本程序相直接關(guān)聯(lián)的數據結構（數據庫、數據文卷）。
F．3．9存儲分配
根據需要，說(shuō)明本程序的存儲分配。
F．3．10注釋設計
說(shuō)明準備在本程序中安排的注釋?zhuān)纾?/span> a． 加在模塊首部的注釋?zhuān)?/span> b．加在各分枝點(diǎn)處的注釋?zhuān)粚Ω髯兞康墓δ?、范圍、缺省條件等所加的注釋?zhuān)?/span> d．對使用的邏輯所加的注釋等等。 F．3．11限制條件 說(shuō)明本程序運行中所受到的限制條件。 F．3．12測試計劃 說(shuō)明對本程序進(jìn)行單體測試的計劃，包括對測試的技術(shù)要求、輸入數據、預期結果、進(jìn)度安排、人員職責、設備條件驅動(dòng)程序及樁模塊等的規定。 F．3．13尚未解決的問(wèn)題 說(shuō)明在本程序的設計中尚未解決而設計者認為在軟件完成之前應解決的問(wèn)題。 F．4程序2（標識符）設計說(shuō)明 用類(lèi)似F．3的方式，說(shuō)明第2個(gè)程序乃至第N個(gè)程序的設計考慮。 ．．．．．． 附錄G 數據庫設計說(shuō)明書(shū)的編寫(xiě)提示 G．1引言 G．1．1編寫(xiě)目的 說(shuō)明編寫(xiě)這份數據庫設計說(shuō)明書(shū)的目的，指出預期的讀者。 G．1．2背景 說(shuō)明： a．說(shuō)明待開(kāi)發(fā)的數據庫的名稱(chēng)和使用此數據庫的軟件系統的名稱(chēng)； b．列出該軟件系統開(kāi)發(fā)項目的任務(wù)提出者、用戶(hù)以及將安裝該軟件和這個(gè)數據庫的計算站（中心）。 G．1．3定義 列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義、外文首字母組詞的原詞組。 G．1．4參考資料 列出有關(guān)的參考資料： a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)批文； b．屬于本項目的其他已發(fā)表的文件； c．本文件中各處引用到的文件資料，包括所要用到的軟件開(kāi)發(fā)標準。 列出這些文件的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠取得這些文件的來(lái)源。 G．2外部設計 G．2．1標識符和狀態(tài) 聯(lián)系用途，詳細說(shuō)明用于唯一地標識該數據庫的代碼、名稱(chēng)或標識符，附加的描述性信息亦要給出。如果該數據庫屬于尚在實(shí)驗中、尚在測試中或是暫時(shí)使用的，則要說(shuō)明這一特點(diǎn)及其有效時(shí)間范圍。 G．2．2使用它的程序 列出將要使用或訪(fǎng)問(wèn)此數據庫的所有應用程序，對于這些應用程序的每一個(gè)，給出它的名稱(chēng)和版本號。 G．2．3約定 陳述一個(gè)程序員或一個(gè)系統分析員為了能使用此數據庫而需要了解的建立標號、標識的約定，例如用于標識數據庫的不同版本的約定和用于標識庫內各個(gè)文卷、、記錄、數據項的命名約定等。 G．2．4專(zhuān)門(mén)指導 向準備從事此數據庫的生成、從事此數據庫的測試、維護人員提供專(zhuān)門(mén)的指導，例如將被送入數據庫的數據的格式和標準、送入數據庫的操作規程和步驟，用于產(chǎn)生、修改、更新或使用這些數據文卷的操 作指導。 如果這些指導的內容篇幅很長(cháng)，列出可參閱的文件資料的名稱(chēng)和章條。 G．2．5支持軟件 簡(jiǎn)單介紹同此數據庫直接有關(guān)的支持軟件，如數據庫管理系統、存儲定位程序和用于裝入、生成、修改、更新數據庫的程序等。說(shuō)明這些軟件的名稱(chēng)、版本號和主要功能特性，如所用數據模型的類(lèi)型、允許 的數據容量等。列出這些支持軟件的技術(shù)文件的標題、編號及來(lái)源。 G．3結構設計 G．3．1概念結構設計 說(shuō)明本數據庫將反映的現實(shí)世界中的實(shí)體、屬性和它們之間的關(guān)系等的原始數據形式，包括各數據項、記錄、系、文卷的標識符、定義、類(lèi)型、度量單位和值域，建立本數據庫的每一幅用戶(hù)視圖。 G．3．2邏輯結構設計 說(shuō)明把上述原始數據進(jìn)行分解、合并后重新組織起來(lái)的數據庫全局邏輯結構，包括所確定的關(guān)鍵字和屬性、重新確定的記錄結構和文卷結構、所建立的各個(gè)文卷之間的相互關(guān)系，形成本數據庫的數據庫管理員視圖。 G．3．3物理結構設計 建立系統程序員視圖，包括： a．數據在內存中的安排，包括對索引區、緩沖區的設計； b．所使用的外存設備及外存空間的組織，包括索引區、數據塊的組織與劃分； c．訪(fǎng)問(wèn)數據的方式方法。 G．4運用設計 G．4．1數據字典設計 對數據庫設計中涉及到的各種項目，如數據項、記錄、系、文卷、模式、子模式等一般要建立起數據字典，以說(shuō)明它們的標識符、同義名及有關(guān)信息。在本節中要說(shuō)明對此數據字典設計的基本考慮。 G．4．2安全保密設計 說(shuō)明在數據庫的設計中，將如何通過(guò)區分不同的訪(fǎng)問(wèn)者、不同的訪(fǎng)問(wèn)類(lèi)型和不同的數據對象，進(jìn)行分別對待而獲得的數據庫安全保密的設計考慮。 附錄H 用戶(hù)手冊的編寫(xiě)提示 H．1引言 H．1．1編寫(xiě)目的 說(shuō)明編寫(xiě)這份用戶(hù)手冊的目的，指出預期的讀者。 H．1．2背景 說(shuō)明： a．這份用戶(hù)手冊所描述的軟件系統的名稱(chēng)； b．該軟件項目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)（或首批用戶(hù)）及安裝此軟件的計算中心。 H．1．3定義 列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。 H．1．4參考資料 列出有用的參考資料，如： a．項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文； b．屬于本項目的其他已發(fā)表文件； c．本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件資料的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠取得這些文件資料的來(lái)源。 H．2用途 H．2．1功能 結合本軟件的開(kāi)發(fā)目的逐項地說(shuō)明本軟件所具有各項功能以及它們的極限范圍。 H．2．2性能 H．2．2．1精度 逐項說(shuō)明對各項輸入數據的精度要求和本軟件輸出數據達到的精度，包括傳輸中的精度要求。 H．2．2．2時(shí)間特性 定量地說(shuō)明本軟件的時(shí)間特性，如響應時(shí)間，更新處理時(shí)間，數據傳輸、轉換時(shí)間，計算時(shí)間等。 H．2．2．3靈活性 說(shuō)明本軟件所具有的靈活性，即當用戶(hù)需求（如對操作方式、運行環(huán)境、結果精度、時(shí)間特性等的要求）有某些變化時(shí)，本軟件的適應能力。 H． 2． 3 安 全保密 說(shuō)明本軟件在安全、保密方面的設計考慮和實(shí)際達到的能力。 H．3運行環(huán)境 H．3．1 硬設備 列出為運行本軟件所要求的硬設備的最小配置，如： a．處理機的型號、內存容量; b．所要求的外存儲器、媒體、記錄格式、設備的型號和臺數、聯(lián)機／脫機； c． I／O設備（聯(lián)機／脫機？）； d．數據傳輸設備和轉換設備的型號、臺數。 H．3．2支持軟件 說(shuō)明為運行本軟件所需要的支持軟件，如： a．操作系統的名稱(chēng)、版本號； b．程序語(yǔ)言的編譯／匯編系統的名稱(chēng)和版本號； c．數據庫管理系統的名稱(chēng)和版本號； d．其他支持軟件。 H．3．3數據結構 列出為支持本軟件的運行所需要的數據庫或數據文卷。 H．4使用過(guò)程 在本章，首先用圖表的形式說(shuō)明軟件的功能同系統的輸入源機構、輸出接收機構之間的關(guān)系。 11． 4． 1安裝與初始化 一步一步地說(shuō)明為使用本軟件而需進(jìn)行的安裝與初始化過(guò)程，包括程序的存儲形式、安裝與初始化過(guò)程中的全部操作命令、系統對這些命令的反應與答復。表征安裝工作完成的測試實(shí)例等。如果有的話(huà)，還應說(shuō)明安裝過(guò)程中所需用到的專(zhuān)用軟件。 H．4．2輸入 規定輸入數據和參量的準備要求。 H．4．2．1輸入數據的現實(shí)背景 說(shuō)明輸入數據的現實(shí)背景，主要是 a．情況——例如人員變動(dòng)、庫存‘缺貨； b．情況出現的頻度——例如是周期性的、隨機的、一項操作狀態(tài)的函數． c．情況來(lái)源—一例如人事部門(mén)、倉庫管理部門(mén)； d．輸入媒體———例如鍵盤(pán)、穿孔卡片、磁帶； e．限制——出于安全、保密考慮而對訪(fǎng)問(wèn)這些輸入數據所加的限制； f．質(zhì)量管理——例如對輸入數據合理性的檢驗以及當輸入數據有錯誤時(shí)應采取的措施，如建立出錯情況的記錄等； g．支配——例如如何確定輸入數據是保留還是廢棄，是否要分配給其他的接受者等。 H．4．2．2輸入格式 說(shuō)明對初始輸入數據和參量的格式要求，包括語(yǔ)法規則和有關(guān)約定，如： a．長(cháng)度—一例如字符數／行，字符數／項； b．格式基準——例如以左面的邊沿為基準； c．標號——例如標記或標識符； d．順序——例如各個(gè)數據項的次序及位置； e．標點(diǎn)——例如用來(lái)表示行、數據組等的開(kāi)始或結束而使用的空格、斜線(xiàn)、星號、字符組等。 f．詞匯表——給出允許使用的字符組合的列表，禁止使用＊的字符組合的列表等； g．省略和重復——給出用來(lái)表示輸人元素可省略或重復的表示方式； h．控制——給出用來(lái)表示輸入開(kāi)始或結束的控制信息。 H．4．2．3輸入舉例 為每個(gè)完整的輸入形式提供樣本，包括： a．控制或首部——例如用來(lái)表示輸入的種類(lèi)和類(lèi)型的信息，標識符輸入日期，正文起點(diǎn)和對所用編碼的規定； b．主體——輸入數據的主體，包括數據文卷的輸入表述部分； c．尾部——用來(lái)表示輸入結束的控制信息，累計字符總數等； d．省略——指出哪些輸入數據是可省略的； e．重復——指出哪些輸入數據是重復的。 H．4．3輸出 對每項輸出作出說(shuō)明． H．4．3．1輸出數據的現實(shí)背景， 說(shuō)明輸出數據的現實(shí)背景，主要是： a．使用——這些輸出數據是給誰(shuí)的，用來(lái)干什么； b．使用頻度——例如每周的、定期的或備查閱的； c．媒體——打印、CRI顯示、磁帶、卡片、磁盤(pán)， d．質(zhì)量管理—一例如關(guān)于合理性檢驗、出錯糾正的規定； e．支配——例如如何確定輸出數據是保留還是廢棄，是否要分配給其他接受者等。 H．4．3．2輸出格式 給出對每一類(lèi)輸出信息的解釋?zhuān)饕牵?/span> a．首部——如輸出數據的標識符，輸出日期和輸出編號； b．主體——輸出信息的主體，包括分欄標題； c．尾部——包括累計總數，結束標記。 H．4．3．3輸出舉例 為每種輸出類(lèi)型提供例子。對例子中的每一項，說(shuō)明： a．定義——每項輸出信息的意義和用途； b．來(lái)源——是從特定的輸入中抽出、從數據庫文卷中取出、或從軟件的計算過(guò)程中得到； c．特性——輸出的值域、計量單位、在什么情況下可缺省等。 H．4．4文卷查詢(xún) 這一條的編寫(xiě)針對具有查詢(xún)能力的軟件，內容包括：同數據庫查詢(xún)有關(guān)的初始化、準備、及處理所需要的詳細規定，說(shuō)明查詢(xún)的能力、方式，所使用的命令和所要求的控制規定。 H．4．5出錯處理和恢復 列出由軟件產(chǎn)生的出錯編碼或條件以及應由用戶(hù)承擔的修改糾正工作。指出為了確保再啟動(dòng)和恢復的能力，用戶(hù)必須遵循的處理過(guò)程。 H．4．6終端操作 當軟件是在多終端系統上工作時(shí)，應編寫(xiě)本條，以說(shuō)明終端的配置安排、連接步釋、數據和參數輸入步驟以及控制規定．說(shuō)明通過(guò)終端操作進(jìn)行查詢(xún)、檢索、修改數據文卷的能力、語(yǔ)言、過(guò)程以及輔助性程 序等。 附錄1 操作手冊的編寫(xiě)提示 I．I引言 I．I．I編寫(xiě)目的 說(shuō)明編寫(xiě)這份操作手冊的目的，指出預期的讀者。 I．I．2前景 說(shuō)明： a．這份操作手冊所描述的軟件系統的名稱(chēng)； b．該軟件項目的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)（或首批用戶(hù)）及安裝該軟件的計算中心。 I．I．3定義 列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。 I．I．4參考資料 列出有用的參考資料，如： a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文； b．屬于本項目的其他已發(fā)表的文件； c．本文件中各處引用的文件、資料，包括所列出的這些文件資料的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。 I．2軟件征述 I．2．1軟件的結構 結合軟件系統所具有的功能包括輸入、處理和輸出提供該軟件的總體結構圖表。 I．2．2程序表 列出本系統內每個(gè)程序的標識符、編號和助記名。 I．2．3文卷表 列出將由本系統引用、建立或更新的每個(gè)永久性文卷，說(shuō)明它們各自的標識符、編號、助記名、存儲媒體和存儲要求。 I．3 安裝與初始化 一步一步地說(shuō)明為使用本軟件而需要進(jìn)行的安裝與初始化過(guò)程，包括程序的存載形式，安裝與初始化過(guò)程中的全部操作命令，系統對這些命令的反應與答復，表征安裝工作完成的測試實(shí)例等。如果有的 話(huà)，還應說(shuō)明安裝過(guò)程中所需用到的專(zhuān)用軟件。 I．4運行說(shuō)明 所謂一個(gè)運行是指提供一個(gè)啟動(dòng)控制信息后，直到計算機系統等待另一個(gè)啟動(dòng)控制信息時(shí)為止的計算機系統執行的全部過(guò)程。 I．4．1運行表 列出每種可能的運行，摘要說(shuō)明每個(gè)運行的目的，指出每個(gè)運行各自所執行的程序。 I．4．2運行步驟 說(shuō)明從一個(gè)運行轉向另一個(gè)運行以完成整個(gè)系統運行的步驟。 I． 4． 3運行1（標識符）說(shuō)明 把運行1的有關(guān)信息，以對操作人員為最方便最有用的形式加以說(shuō)明。 I．4．3．1運行控制 列出為本運行所需要”的運行流向控制的說(shuō)明。 I．4．3．2操作信息 給出為操作中心的操作人員和管理人員所需要的信息，如： a． 運行目的； b．操作要求； c． 啟動(dòng)方法 如應請啟動(dòng)（由所遇到的請求信息啟動(dòng)）、預定時(shí)間啟動(dòng)、…，．．等； d．預計的運行時(shí)間和解題時(shí)間；操作命令； f．與運行有聯(lián)系的其他事項。 I．4．3．3輸入一輸出文卷 提供被本運行建立、更新或訪(fǎng)問(wèn)的數據文卷的有關(guān)信息，如： a． 文卷的標識符或標號； b．記錄媒體； c．存留的目錄表； d．文卷的支配如確定保留或廢棄的準則、是否要分配給其他接受者、占用硬設備的優(yōu)先級以及保密控制等有關(guān)規定。 I．4．3．4輸出文段 提供本軟件輸出的每一一個(gè)用于提示、說(shuō)明、或應答的文段（包括“菜單”）的有關(guān)信息，如： a． 文段的標識符； b．輸出媒體（屏幕顯示、打印、……）； c． 文字容量； d．分發(fā)對象； e． 保密要求。 I．4．3．5輸出文段的復制 對由計算機產(chǎn)生，而后需用其他方法復制的那些文段提供有關(guān)信息，如： a． 文段的標識符； b．復制的技術(shù)手段； c． 紙張或其他媒體的規格； d．裝訂要求； e． 分發(fā)對象； f．復制份數。 I．4．3．6恢復過(guò)程 說(shuō)明本運行故障后的恢復過(guò)程。 I．4．4運行2（標識符）說(shuō)明 用與本手冊1．4．3條相類(lèi)似的方式介紹另一個(gè)運行的有關(guān)信息。 I．5非常規過(guò)程 提供有關(guān)應急操作或非常規操作的必要信息，如出錯處理操作、向后備系統的切換操作以及其他必須向程序維護人員交待的事項和步驟。 I．6遠程操作 如果本軟件能夠通過(guò)遠程終端控制運行，則在本章說(shuō)明通過(guò)遠程終端運行本軟件的操作過(guò)程。 附錄J 模塊開(kāi)發(fā)卷宗的編寫(xiě)提示 1．1標題 軟件系統名稱(chēng)和標識符 模塊名稱(chēng)和標識符（如果本卷宗包含多于一個(gè)的模塊，則用這組模塊的功能標識代替模塊名） 程序編制員簽名 卷宗的修改文本序號 修改完成日期 卷宗序號（說(shuō)明本卷宗在整個(gè)卷宗中的序號） 編排日期（說(shuō)明整個(gè)卷宗最近的一次編排日期） J．2模塊開(kāi)發(fā)情況表 J．3功能說(shuō)明 扼要說(shuō)明本模塊（或本組模塊）的功能，主要是輸入、要求的處理、輸出?？梢詮南到y設計說(shuō)明書(shū)中摘錄。同時(shí)列出在軟件需求說(shuō)明書(shū)中對這些功能的說(shuō)明的章、條、款。 J．4設計說(shuō)明 說(shuō)明本模塊（或本組模塊）的設計考慮，包括： a．在系統設計說(shuō)明書(shū)中有關(guān)對本模塊（或本組模塊）設計考慮的敘述，包括本模塊在軟件系統中所處的層次，它同其他模塊的接口； b．在程序設計說(shuō)明書(shū)中有關(guān)對本模塊（或本組模塊）的設計考慮，包括本模塊的算法、處理流程、牽涉到的數據文卷設計限制、驅動(dòng)方式和出錯信息等； c．在編制目前已通過(guò)全部測試的源代碼時(shí)實(shí)際使用的設計考慮。 J．5原代碼清單 要給出所產(chǎn)生的本模塊（或本組模塊）的第一份無(wú)語(yǔ)法錯的源代碼清單以及已通過(guò)全部測試的當前有效的源代碼清單。 J．6測試說(shuō)明 說(shuō)明直接要經(jīng)過(guò)本模塊（或本組模塊）的每一項測試，包括這些測試各自的標識符和編號、進(jìn)行這些測試的目的、所用的配置和輸入、預期的輸出及實(shí)際的輸出。 J．7復審的結論 把實(shí)際測試的結果，同軟件需求說(shuō)明書(shū)、系統設計說(shuō)明書(shū)、程序設計說(shuō)明書(shū)中規定的要求進(jìn)行比較和給出結論。 附錄K 測試計劃的編寫(xiě)提示 K．1引言 K．1．1編寫(xiě)目的 本測試計劃的具體編寫(xiě)目的，指出預期的讀者范圍。 K．1．2背景 說(shuō)明： a 測試計劃所從屬的軟件系統的名稱(chēng)； b．該開(kāi)發(fā)項目的歷史，列出用戶(hù)和執行此項目測試的計算中心，說(shuō)明在開(kāi)始執行本測試計劃之前必須完成的各項工作。 K．1．3定義 列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。 K．1．4參考資料 列出要用到的參考資料，如： a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文； b．屬于本項目的其他已發(fā)表的文件； c．本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。 K．2計劃 K．2．1軟件說(shuō)明 提供一份圖表，并逐項說(shuō)明被測軟件的功能、輸入和輸出等質(zhì)量指標，作為敘述測試計劃的提綱。 K．2．2測試內容 列出組裝測試和確認測試中的每一項測試內容的名稱(chēng)標識符、這些測試的進(jìn)度安排以及這些測試的內容和目的，例如模塊功能測試、接口正確性測試、數據文卷存取的測試、運行時(shí)間的測試、設計約束和極限的測試等。 K．2．3測試1（標識符） 給出這項測試內容的參與單位及被測試的部位。 K．2．3．1進(jìn)度安排 給出對這項測試的進(jìn)度安排，包括進(jìn)行測試的日期和工作內容（如熟悉環(huán)境。培訓、準備輸入數據等）。 K．2．3．2條件 陳述本項測試工作對資源的要求，包括： a．設備所用到的設備類(lèi)型、數量和預定使用時(shí)間； b．軟件列出將被用來(lái)支持本項測試過(guò)程而本身又并不是被測軟件的組成部分的軟件，如測試驅動(dòng)程序、測試監控程序、仿真程序、樁模塊等等； c．人員列出在測試工作期間預期可由用戶(hù)和開(kāi)發(fā)任務(wù)組提供的工作人員的人數。技術(shù)水平及有關(guān)的預備知識，包括一些特殊要求，如倒班操作和數據鍵入人員。 K．2．3．3測試資料 列出本項測試所需的資料，如： a．有關(guān)本項任務(wù)的文件； b．被測試程序及其所在的媒體； c．測試的輸入和輸出舉例； d．有關(guān)控制此項測試的方法、過(guò)程的圖表。 K．2．3．4測試培訓 說(shuō)明或引用資料說(shuō)明為被測軟件的使用提供培訓的計劃。規定培訓的內容、受訓的人員及從事培訓的工作人員。 K．2．4測試2（標識符） 用與本測試計劃K．2．3條相類(lèi)似的方式說(shuō)明用于另一項及其后各項測試內容的測試工作計劃。 K．3測試設計說(shuō)明 K．3．1測試1（標識符） 說(shuō)明對第一項測試內容的測試設計考慮。 K．3．1．1控制 說(shuō)明本測試的控制方式，如輸入是人工、半自動(dòng)或自動(dòng)引入、控制操作的順序以及結果的記錄方法。 K．3．1．2輸入 說(shuō)明本項測試中所使用的輸入數據及選擇這些輸入數據的策略。 K．3．1．3輸出 說(shuō)明預期的輸出數據，如測試結果及可能產(chǎn)生的中間結果或運行信息。 K．3．1．4過(guò)程 說(shuō)明完成此項測試的一個(gè)個(gè)步驟和控制命令，包括測試的準備、初始化、中間步聚和運行結束方式。 K．3．2測試2（標識符） 用與本測試計劃K．3．l條相類(lèi)似的方式說(shuō)明第2項及其后各項測試工作的設計考慮。 K．4評價(jià)準則 K．4．1范圍 說(shuō)明所選擇的測試用例能夠接查的范圍及其局限性。 K．4．2數據整理 陳述為了把測試數據加工成便于評價(jià)的適當形式，使得測試結果可以同，已知結果進(jìn)行比較而要用到的轉換處理技術(shù)，如手工方式或自動(dòng)方式；如果是用自動(dòng)方式整理數據，還要說(shuō)明為進(jìn)行處理而要用到的硬件、軟件資源。 K．4．3尺度 說(shuō)明用來(lái)判斷測試工作是否能通過(guò)的評價(jià)尺度，如合理的輸出結果的類(lèi)型、測試輸出結果與預期輸出之間的容許偏離范圍、允許中斷或停機的最大次數。 附錄L 測試分析報告的編寫(xiě)提示 L．1引言 L．1．1編寫(xiě)目的 說(shuō)明這份測試分析報告的具體編寫(xiě)目的，指出預期的閱讀范圍。 L．1．2背景 說(shuō)明： a．被測試軟件系統的名稱(chēng)； b．該軟件的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)及安裝此軟件的計算中心，指出測試環(huán)境與實(shí)際運行環(huán)境之間可能存在的差異以及這些差異對測試結果的影響。 L．1．3定義 列出本文件中用到的專(zhuān)問(wèn)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。 L．1．4參考資料 列出要用到的參考資料，如： a．本項目的經(jīng)核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文； b．屬于本項目的其他已發(fā)表的文件； c．本文件中各處引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。 L．2測試概要 用表格的形式列出每一項測試的標識符及其測試內容，并指明實(shí)際進(jìn)行的測試工作內容與測試計劃中預先設計的內容之間的差別，說(shuō)明作出這種改變的原因。 L．3測試結果及發(fā)現 L． 3．1測試1（標識符） 把本項測試中實(shí)際得到的動(dòng)態(tài)輸出（包括內部生成數據輸出）結果同對于動(dòng)態(tài)輸出的要求進(jìn)行比較，陳述其中的各項發(fā)現。 L．3．2測試2（標識符） 用類(lèi)似本報告 L． 3． 1條的方式給出第 2項及其后各項測試內容的測試結果和發(fā)現。 L．4對軟件功能的結論 L． 4． 1功能1（標識符） L．4．1．1能力 簡(jiǎn)述該項功能，說(shuō)明為滿(mǎn)足此項功能而設計的軟件能力以及經(jīng)過(guò)一項或多項測試已證實(shí)的能力。 L．4．1．2限制 說(shuō)明測試數據值的范圍（包括動(dòng)態(tài)數據和靜態(tài)數據），列出就這項功能而言，測試期間在該軟件中查出的缺陷、局限性。 L．4．2功能2（標識符） 用類(lèi)似本報告L．4．l的方式給出第2項及其后各項功能的測試結論。 ．．．．．． L．5分析摘要 L．5．1能力 陳述經(jīng)測試證實(shí)了的本軟件的能力。如果所進(jìn)行的測試是為了驗證一項或幾項特定性能要求的實(shí)現，應提供這方面的測試結果與要求之間的比較，并確定測試環(huán)境與實(shí)際運行環(huán)境之間可能存在的差異 對能力的測試所帶來(lái)的影響。 L．5．2缺陷和限制 陳述經(jīng)測試證實(shí)的軟件缺陷和限制，說(shuō)明每項缺陷和限制對軟件性能的影響，并說(shuō)明全部測得的性能缺陷的累積影響和總影響。 L．5．3建議 對每項缺陷提出改進(jìn)建議，如： a．各項修改可采用的修改方法； b．各項修改的緊迫程度； c．各項修改預計的工作量； d．各項修改的負責人。 L．5．4評價(jià) 說(shuō)明該項軟件的開(kāi)發(fā)是否已達到預定目標，能否交付使用。 L．6測試資源消耗 總結測試工作的資源消耗數據，如工作人員的水平級別數量、機時(shí)消耗等。 附錄M 開(kāi)發(fā)進(jìn)度月報的縮寫(xiě)提示 M．l標題 開(kāi)發(fā)中的軟件系統的名稱(chēng)和標識符分項目名稱(chēng)和標識符 分項目負責人簽名 本期月報編寫(xiě)人簽名 本期月報的編號及所報告的年月 M．2工程進(jìn)度與狀態(tài) M．2．1進(jìn)度 列出本月內進(jìn)行的各項主要活動(dòng)，并且說(shuō)明本月內遇到的重要事件，這里所說(shuō)的重要事件是指一個(gè)開(kāi)發(fā)階段（即軟件生存周期內各個(gè)階段中的某一個(gè)，例如需求分析階段）的開(kāi)始或結束，要說(shuō)明階段名稱(chēng) 及開(kāi)始（或結束）的日期。 M．2．2狀態(tài) 說(shuō)明本月的實(shí)際工作進(jìn)度與計劃相比，是提前了、按期完成了、或是推遲了？如果與計劃不一致，說(shuō)明原因及準備采取的措施。 M．3資額耗用與狀態(tài) M．3．1 資額耗用 主要說(shuō)明本月份內耗用的工時(shí)與機時(shí)。 M．3．1．1工時(shí) 分為三類(lèi)： a．管理用工時(shí)包括在項目管理（制訂計劃、布置工作、收集數據、檢查匯報工作等）方面耗用的工時(shí)； b．服務(wù)工時(shí)包括為支持項目開(kāi)發(fā)所必須的服務(wù)工作及非直接的開(kāi)發(fā)工作所耗用的工時(shí)； C．開(kāi)發(fā)用工時(shí)要分各個(gè)開(kāi)發(fā)階段填寫(xiě)。 M．3．1．2機時(shí) 說(shuō)明本月內耗用的機時(shí)，以小時(shí)為單位，說(shuō)明計算機系統的型號。 M．3．2狀態(tài) 說(shuō)明本月內實(shí)際耗用的資源與計劃相比，是超出了、相一致、還是不到計劃數？如果與計劃不一致，說(shuō)明原因及準備采取的措施。 M．4經(jīng)費支出與狀態(tài) M．4．1經(jīng)費支出 M．4．1．1支持性費用 列出本月內支出的支持性費用，一般可按如下七類(lèi)列出，并給出本月支持費用的總和： a． 房租或房屋折舊費； b．社工資、獎金、補貼； c．培訓費包括給教師的酬金及教室租金； d．資料費包括復印及購買(mǎi)參考資料的費用； e．會(huì )議費召集有關(guān)業(yè)務(wù)會(huì )議的費用； f．旅差費； g．其他費用。 M．4．1．2設備購置費 列出本月內支出的設備購置費，一般可分如下三類(lèi)： a．購買(mǎi)軟件的名稱(chēng)與金額； b．購買(mǎi)硬設備的名稱(chēng)、型號、數量及金額； c．已有硬設備的折舊費。 M．4．2狀態(tài) 說(shuō)明本月內實(shí)際支出的經(jīng)費與計劃相比較，是超過(guò)了。相符合、還是不到計劃數？如果與計劃不一致，說(shuō)明原因及準備采取的措施。 M．5下個(gè)月的工作計劃 M．6建議 本月遇到的重要問(wèn)題和應引起重視的問(wèn)題以及因此產(chǎn)生的建議。 附錄N 項目開(kāi)發(fā)總結報告的編寫(xiě)提示 N．I引言 N．1．1編寫(xiě)目的 說(shuō)明編寫(xiě)這份項目開(kāi)發(fā)總結報告的目的，指出預期的閱讀范圍。 N．1．2背景 說(shuō)明： a．本項目的名稱(chēng)和所開(kāi)發(fā)出來(lái)的軟件系統的名稱(chēng)； b．此軟件的任務(wù)提出者、開(kāi)發(fā)者、用戶(hù)及安裝此軟件的計算中心。 N．I．3定義 列出本文件中用到的專(zhuān)門(mén)術(shù)語(yǔ)的定義和外文首字母組詞的原詞組。 N．1．4參考資料 列出要用到的參考資料，如： a．本項目的已核準的計劃任務(wù)書(shū)或合同、上級機關(guān)的批文； b．屬于本項目的其他已發(fā)表的文件； c．本文件中各處所引用的文件、資料，包括所要用到的軟件開(kāi)發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位，說(shuō)明能夠得到這些文件資料的來(lái)源。 N．2實(shí)際開(kāi)發(fā)結果 N．2．1產(chǎn)品 說(shuō)明最終制成的產(chǎn)品，包括： a．程序系統中各個(gè)程序的名字，它們之間的層次關(guān)系，以千字節為單位的各個(gè)程序的程序量、存儲媒體的形式和數量； b．程序系統共有哪幾個(gè)版本，各自的版本號及它們之間的區別； c．每個(gè)文件的名稱(chēng)； d．所建立的每個(gè)數據庫。如果開(kāi)發(fā)中制訂過(guò)配置管理計劃，要同這個(gè)計劃相比較。 N．2．2主要功能和性能 逐項列出本軟件產(chǎn)品所實(shí)際具有的主要功能和性能，對照可行性研究報告、項目開(kāi)發(fā)計劃、功能需．求說(shuō)明書(shū)的有關(guān)內容，說(shuō)明原定的開(kāi)發(fā)目標是達到了、未完全達到、或超過(guò)了。 N．2．3基本流程 用圖給出本程序系統的實(shí)際的基本的處理流程。 N．2．4進(jìn)度 列出原定計劃進(jìn)度與實(shí)際進(jìn)度的對比，明確說(shuō)明，實(shí)際進(jìn)度是提前了、還是延遲了，分析主要原因。 N．2．5費用 列出原定計劃費用與實(shí)際支出費用的對比，包括： a．工時(shí)，以人月為單位，并按不同級別統計； b．計算機的使用時(shí)間，區別CPU時(shí)間及其他設備時(shí)間； c．物料消耗、出差費等其他支出。 明確說(shuō)明，經(jīng)費是超出了、還是節余了，分析其主要原因。 N．3開(kāi)發(fā)工作評價(jià) N．3．1對生產(chǎn)效率的評價(jià) 給出實(shí)際生產(chǎn)效率，包括： a．程序的平均生產(chǎn)效率，即每人月生產(chǎn)的行數； b．文件的平均生產(chǎn)效率，即每人月生產(chǎn)的千字數； 并列出原訂計劃數作為對比。 N．3．2對產(chǎn)品質(zhì)量的評價(jià) 說(shuō)明在測試中檢查出來(lái)的程序編制中的錯誤發(fā)生率，即每干條指令（或語(yǔ)句）中的錯誤指令數（或語(yǔ)句數）。如果開(kāi)發(fā)中制訂過(guò)質(zhì)量保證計劃或配置管理計劃，要同這些計劃相比較。 N．3．3對技術(shù)方法的評價(jià) 給出對在開(kāi)發(fā)中所使用的技術(shù)、方法、工具、手段的評價(jià)。 N．3．4出錯原因的分析 給出對于開(kāi)發(fā)中出現的錯誤的原因分析。 N．4經(jīng)驗與教訓 列出從這項開(kāi)發(fā)工作中所得到的最主要的經(jīng)驗與教訓及對今后的項目開(kāi)發(fā)工作的建議。 附錄O 文件給制實(shí)施規定的實(shí)例 盡管在文件編制中存在著(zhù)很多靈活性，然而，文件的編制確實(shí)是非常必要的，其意義如前所述。為了控制這種靈活性，保證文件編制能達到應該達到的目的，對于具體的軟件開(kāi)發(fā)任務(wù)，應編制的文件的種類(lèi)、詳細程度應取決于承擔開(kāi)發(fā)單位的管理能力、任務(wù)的規模、復雜性和成敗風(fēng)險等因素。一個(gè)軟件開(kāi)發(fā)單位應該根據本單位經(jīng)營(yíng)承包的應用軟件的專(zhuān)業(yè)特點(diǎn)和本單位的管理能力，制定一個(gè)文件編制實(shí)施規定，說(shuō)明在什么情況下應該編制哪些文件。由于國內目前在這方面還缺乏成熟的經(jīng)驗，這里提供參考國外經(jīng)驗制定的兩個(gè)例子，用以向國內軟件開(kāi)發(fā)單位說(shuō)明如何建立這種實(shí)施規定，使項目負責人能確定本項目開(kāi)發(fā)過(guò)程中應編制的文件的種類(lèi)。當然，例子畢竟只是例子，這兩個(gè)例子各自都不免有其片面性，它們兩者之間也不免有不一致之處，之所以列出來(lái)無(wú)非是供國內軟件開(kāi)發(fā)單位參考。 例1： 此例規定用求和法來(lái)確定應編制的文件。該方法的要點(diǎn)是提出十二個(gè)考慮因素來(lái)衡量一個(gè)應用軟，件，每個(gè)因素可能取值的范圍是互至5。任務(wù)負責人可用這十二個(gè)因素對所要開(kāi)發(fā)的程序進(jìn)行衡量，確定每個(gè)因素的具體值。把這十二個(gè)因素的值相加，得到一個(gè)總和。然后由這個(gè)總和的值來(lái)確定應該編制的文件的種類(lèi)。使用這個(gè)方法的具體過(guò)程如下： a． 按表OI中的十二個(gè)因素衡量所要開(kāi)發(fā)的程序，得到每個(gè)因素的值; b．把衡量所得的各個(gè)因素的值相加，得總和之值； c． 根據總和之值，從表OZ查出應編制的文件的種類(lèi)。 表OI文件編制的十二項衡量因素 表 O1 文件編制的十二項衡量因素 *在因素總和較低的情況下,項目開(kāi)發(fā)總結報告的內容應包括：程序的主要功能、基本流程、測試結果和使用說(shuō)明。 **測試分析報告應該寫(xiě)，但不必很正規。 * **數據要求說(shuō)明和數據庫設計說(shuō)明是否需要編寫(xiě)應根據所開(kāi)發(fā)軟件的實(shí)際需要來(lái)決定。 例2： 為了避免在軟件開(kāi)發(fā)中文件編制的不足或過(guò)分，一個(gè)簡(jiǎn)便的辦法是把對軟件文件的編制要求同軟件的規模大小聯(lián)系起來(lái)，這就是本例的出發(fā)點(diǎn)。軟件的規模不妨分為四級： 1．小規模軟件源程序行數小于5 000的軟件； 2．中規模軟件源程序行數為 10 000～ 50 000的軟件； 3．大規模軟件源程序行數為 100 000—500 000的軟件； 4．特大規模軟件源程序行數大于500 000的軟件。 對上述的四級軟件的文件編制要求分別列于表O3。 至于源程序行數為 5 000～ 10 000， 50 000～ 100 000的軟件，其文件編制要求介于兩級之間，可根據一個(gè)軟件產(chǎn)品的具體情況，由項目負責人參照表O3的規定，確定需要編制的文件種類(lèi)。 對于源程序行數大于500 000的特大規模軟件，可進(jìn)一步把本指南規定的十四種文件按實(shí)際需要擴展成更多種類(lèi)，這一點(diǎn)在本指南5．3．3已經(jīng)提到。
聯(lián)系客服
