![1-計算機軟件產(chǎn)品開發(fā)文件編制指南GB8567-88_第1頁](http://file4.renrendoc.com/view12/M07/39/30/wKhkGWXm3AKAZHwaAAKeNTwBPj0157.jpg)
![1-計算機軟件產(chǎn)品開發(fā)文件編制指南GB8567-88_第2頁](http://file4.renrendoc.com/view12/M07/39/30/wKhkGWXm3AKAZHwaAAKeNTwBPj01572.jpg)
![1-計算機軟件產(chǎn)品開發(fā)文件編制指南GB8567-88_第3頁](http://file4.renrendoc.com/view12/M07/39/30/wKhkGWXm3AKAZHwaAAKeNTwBPj01573.jpg)
![1-計算機軟件產(chǎn)品開發(fā)文件編制指南GB8567-88_第4頁](http://file4.renrendoc.com/view12/M07/39/30/wKhkGWXm3AKAZHwaAAKeNTwBPj01574.jpg)
![1-計算機軟件產(chǎn)品開發(fā)文件編制指南GB8567-88_第5頁](http://file4.renrendoc.com/view12/M07/39/30/wKhkGWXm3AKAZHwaAAKeNTwBPj01575.jpg)
版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進行舉報或認領(lǐng)
文檔簡介
計算機軟件產(chǎn)品開發(fā)文件編制指南 GB8567-88
Guidelinesforcomputersoftwareproductdevelopmentdocumentation
中華人民共和國國家標準
UDC681.3
引言
1目的
一項計算機軟件的籌劃、研制及實現(xiàn),構(gòu)成一個軟件開發(fā)工程。一個軟件開發(fā)工程的進行,一般需要在人力和自動化資源等方面作重大的投資。為了保證工程開發(fā)的成功,最經(jīng)濟地花費這些投資,并且便于運行和維護,在開發(fā)工作的每一階段,都需要編制二定的文件。這些文件連同計算機程序及數(shù)據(jù)一起,構(gòu)成為計算機軟件。文件是計算機軟件中不可缺少的組成局部,它的作用是:
a.作為開發(fā)人員在一定階段內(nèi)的工作成果和結(jié)束標志;
b.向管理人員提供軟件開發(fā)過程中的進展和情況,把軟件開發(fā)過程中的一些“不可見的〞事物轉(zhuǎn)換成“可見的〞文字資料。以便管理人員在各個階段檢查開發(fā)方案的實施進展,使之能夠判斷原定目標是否已到達,還將繼續(xù)耗用資源的種類和數(shù)量;
C.記錄開發(fā)過程中的技術(shù)信息,便于協(xié)調(diào)以后的軟件開發(fā)、使用和修改;
d.提供對軟件的有關(guān)運行、維護和培訓的信息,便于管理人員、開發(fā)人員、操作人員和用戶之間相互了解彼此的工作;
e.向潛在用戶報導(dǎo)軟件的功能和性能,使他們能判定該軟件能否效勞于自己的需要。
換言之,本指南認為:文件的編制必須適應(yīng)計算機軟件整個生存周期的需要。
計算機軟件所包含的文件有兩類:一類是開發(fā)過程中填寫的各種圖表,可稱之為工作表格;另一類那么是應(yīng)編制的技術(shù)資料或技術(shù)管理資料,可稱之為文件。本指南規(guī)定軟件文件的編制形式,并提供對這些規(guī)定的解釋。本指南的目的是使得所編制的軟件文件確實能夠起到軟件文件應(yīng)該發(fā)揮的作用。
2范圍
本指南是一份指導(dǎo)性文件。本指甫建議,在一項計算機軟件的開發(fā)過程中,一般地說,應(yīng)該產(chǎn)生十四種文件。這十四種文件是:
可行性研究報告;
工程開發(fā)方案;
軟件需求說明書;
數(shù)據(jù)要求說明書;
概要設(shè)計說明書;
詳細設(shè)計說明書;
數(shù)據(jù)庫設(shè)計說明書;
用戶手冊;
操作手冊;
模塊開發(fā)卷宗;
測試方案;
測試分析報告;
開發(fā)進度月報;
工程開發(fā)總結(jié)報告。
本指南將給出開發(fā)過程中建議產(chǎn)生的這十四種文件的編制指導(dǎo),同時,本指南也是這十四種文件的編寫質(zhì)量的檢驗準那么。但是,本指南并未涉及軟件開發(fā)過程中如何填寫工作表格的問題。
一般地說,一個軟件總是一個計算機系統(tǒng)〔包括硬件、固件和軟件〕的組成局部。鑒于計算機系統(tǒng)的多樣性,本指南一般不涉及整個系統(tǒng)開發(fā)中的文件編制問題,本指南僅僅是軟件開發(fā)過程中的文件編制指南。
3文件的使用者
對于使用文件的人員而言,他們所關(guān)心的文件的種類,隨他們所承擔的工作而異。
管理人員:可行性研究報告,
工程開發(fā)方案,
模塊開發(fā)卷宗,
開發(fā)進度月報,
工程開發(fā)總結(jié)報告;
開發(fā)人員:可行性研究報告,
工程開發(fā)方案,
軟件需求說明書,
數(shù)據(jù)要求說明書,
概要設(shè)計說明書,
詳細設(shè)計說明書,
數(shù)據(jù)庫設(shè)計說明書,
測試方案,
測試分析報告;
維護人員:設(shè)計說明書,
測試分析報告,
模塊開發(fā)卷宗;
用戶:用戶手冊,
操作手冊。
盡管本指南提出了在軟件開發(fā)中文件編制的要求,但并不意味著這些文件都必須交給用戶。一項軟件的用戶應(yīng)該得到的文件的種類由供應(yīng)者與用戶之間簽訂的合同規(guī)定。文件的編制指導(dǎo)
4軟件生存周期與各種文件的編制
一項計算機軟件,從出現(xiàn)一個構(gòu)思之日起,經(jīng)過這項軟件開發(fā)成功投入使用,直到最后決定停止使用,并被另一一項軟件代替之時止,被認為是該軟件的一個生存周期。一般地說這個軟件生存周期可以分成以下六個階段:可行性與方案研究階段
需求分析階段
設(shè)計階段
實現(xiàn)階段
測試階段
運行與維護階段
在可行性研究與方案階段內(nèi),要確定該軟件的開發(fā)目標和總的要求,要進行可行性分析、投資一收益分析、制訂開發(fā)方案,并完成應(yīng)編制的文件。
在需求分析階段內(nèi),由系統(tǒng)分析人員對被設(shè)計的系統(tǒng)進行系統(tǒng)分析,確定對該軟件的各項功能、性能需求和設(shè)計約束,確定對文件編制的要求,作為本階段工作的結(jié)果,一般地說,軟件需求說明書、數(shù)據(jù)要求說明書和初步的用戶手冊應(yīng)該編寫出來。
在設(shè)計階段內(nèi),系統(tǒng)設(shè)計人員和程序設(shè)計人員應(yīng)該在反復(fù)理解軟件需求的根底上,提出多個設(shè)計,分析每個設(shè)計能履行的功能并進行相互比較,最后確定一個設(shè)計,包括該軟件的結(jié)構(gòu)、模塊的劃分、功能的分配以及處理流程。在被設(shè)計系統(tǒng)比較復(fù)雜的情況下,設(shè)計階段應(yīng)分解成概要設(shè)計階段和詳細設(shè)計階段兩個步驟。在一般情況下,應(yīng)完成的文件包括:概要設(shè)計說明書、詳細設(shè)計說明書和測試方案初稿。
在實現(xiàn)階段內(nèi),要完成源程序的編碼、編譯〔或匯編〕和排錯調(diào)試得到無語法錯的程序清單,要開始編寫模塊開發(fā)卷宗,并且要完成用戶手冊、操作手冊等面向用戶的文件的編寫工作,還要完成測試方案的編制。
在測試階段,該程序?qū)⒈蝗娴販y試,已編制的文件將被檢查審閱。一般要完成模塊開發(fā)卷宗和測試分析報告,作為開發(fā)工作的結(jié)束,所生產(chǎn)的程序、文件以及開發(fā)工作本身將逐項被評價,最后寫出工程開發(fā)總結(jié)報告。
在整個開發(fā)過程中〔即前五個階段中〕,開發(fā)集體要按月編寫開發(fā)進度月報。
在運行和維護階段,軟件將在運行使用中不斷地被維護,根據(jù)新提出的需求進行必要而且可能的擴充和刪改。
對于一項軟件而言,其生存周期各階段與各種文件編寫工作的關(guān)系可見表互,其中有些文件的編寫工作可能要在假設(shè)干個階段中延續(xù)進行。
表1軟件生存周期各階段中的文件編制
5文件編制中的考慮因素
文件編制是一個不斷努力的工作過程。是一個從形成最初輪廓,經(jīng)反復(fù)檢查和修改,直到程序和文件正式交付使用的完整過程。其中每一步都要求工作人員做出很大努力。要保證文件編制的質(zhì)量,要表達每個開發(fā)工程的特點,也要注意不要花太多的人力。為此,編制中要考慮如下各項因素。
5.1文件的讀者
每一種文件都具有特定的讀者。這些讀者包括個人或小組、軟件開發(fā)單位的成員或社會上的公眾、從事軟件工作的技術(shù)人員、管理人員或領(lǐng)導(dǎo)干部。他們期待著使用這些文件的內(nèi)容來進行工作,例如設(shè)計、編寫程序、測試、使用、維護或進行方案管理。因此,這些文件的作者必須了解自己的讀者,這些文件的編寫必須注意適應(yīng)自己的特定讀者的水平、特點和要求。
5.2重復(fù)性
本指南第二篇中將列出的這十四種文件的內(nèi)容要求中,顯然存在某些重復(fù)。較明顯的重復(fù)有兩類。引言是每一種文件都要包含的內(nèi)容,以向讀者提供總的梗概。第二類明顯的重復(fù)是各種文件中的說明局部,如對功能性能的說明、對輸入和輸出的描述、系統(tǒng)中包含的設(shè)備等。這是為了方便每種文件各自的讀者,每種產(chǎn)品文件應(yīng)該自成體系,盡量防止讀一種文件時又不得不去參考另一種文件。當然,在每一種文件里,有關(guān)引言、說明等同其他文件相重復(fù)的局部,在行文上、在所用的術(shù)語上、在詳細的程度上,還是應(yīng)該有一些差異,以適應(yīng)各種文件的不同讀者的需要。
5.3靈巧性
鑒于軟件開發(fā)是具有創(chuàng)造性的腦力勞動,也鑒于不同軟件在規(guī)模上和復(fù)雜程度上差異極大,本指南認為在文件編制工作中應(yīng)允許一定的靈巧性。這種靈巧性表現(xiàn)在如下各款。
5.3.1應(yīng)編制的文件種類
盡管本指南認為在一般情況下,一項軟件的開發(fā)過程中,應(yīng)產(chǎn)生的文件有十四種,然而針對一項具體的軟件開發(fā)工程,有時不必編制這么多的文件,可以把幾種文件合并成一種。一般地說,當工程的規(guī)模、復(fù)雜性和成敗風險增大時,文件編制的范圍、管理手續(xù)和詳細程度將隨之增加。反之,那么可適當減少。為了恰當?shù)卣莆者@種靈巧性,本指南要求貫徹分工負責的原那么,這意味著:
a:一個軟件開發(fā)單位的領(lǐng)導(dǎo)機構(gòu)應(yīng)該根據(jù)本單位經(jīng)營承包的應(yīng)用軟件的專業(yè)領(lǐng)域和本單位的管理能力,制定一個對文件編制要求的實施規(guī)定,主要是:在不同的條件下,應(yīng)該形成哪些文件?這些文件的詳細程度?該開發(fā)單位的每一個工程負責人,必須認真執(zhí)行這個實施規(guī)定。這種規(guī)定的兩個例子可嘆本指南的附錄o〔參考件〕;
b.對于一個具體的應(yīng)用軟件工程,工程負責人應(yīng)根據(jù)上述實施規(guī)定,確定一個文件編制方案,主中包括:
(1)應(yīng)該編制哪幾種文件,詳細程度如何?
〔2〕各個文件的編制負責人和進度要求;
〔3〕審查、批準的負責人和時間進度安排;
〔4〕在開發(fā)時期內(nèi),各文件的維護、修改和管理的負責人,以及批準手續(xù)。
每項工作必須落實到人。
這個文件編制方案是整個開發(fā)方案的重要組成局部;
C.有關(guān)的設(shè)計人員那么必須嚴格執(zhí)行這個文件編制方案。
5.3.2文件的詳細程度
從同一份提綱起草的文件的篇幅大小往往不同,可以少到幾頁,也可以長達幾百頁。對于這種差異本指南是允許的。此詳細程度取決于任務(wù)的規(guī)模、復(fù)雜性和工程負責人對該軟件的開發(fā)過程及運行環(huán)與所需要的詳細程度的判斷。
5.3.3文件的擴展
當被開發(fā)系統(tǒng)的規(guī)模非常大〔例如源碼超過一百萬行〕時,一種文件可以分成幾卷編寫,可以按其。每一個系統(tǒng)分別編制,也可以按內(nèi)容劃分成多卷,例如:
工程開發(fā)方案可能包括:質(zhì)量保證方案,
配置管理方案,
用戶培訓方案,
安裝實施方案;
系統(tǒng)設(shè)計說明書可分寫成:系統(tǒng)設(shè)計說明書,
子系統(tǒng)設(shè)計說明書;
程序設(shè)計說明書可分寫成:程序設(shè)計說明書,
接口設(shè)計說明書,
版本說明;
操作手冊可分寫成:操作手冊,
安裝實施過程;
.測試方案可分寫成:測試方案,
測試設(shè)計說明,
測試規(guī)程,
測試用例;
測試分析報告可分寫成:綜合測試報告,
驗收測試報告;
工程開發(fā)總結(jié)報告亦可分寫成工程開發(fā)總結(jié)報告和資源環(huán)境統(tǒng)計。
5.3.4節(jié)的擴張與縮并
在有些文件中,可以使用本指南所提供的章、條標題,但在條內(nèi)又存在一系列需要分別討論的因素本指南認為,所有的條都可以擴展,可以進一步細分,以適應(yīng)實際需要。反之,如果章條中的有些細節(jié);非必需,也可以根據(jù)實際情況縮并。此時章條的編號應(yīng)相應(yīng)地改變。
5.3.5程序設(shè)計的表現(xiàn)形式
本指南對于程序的設(shè)計表現(xiàn)形式并未作出規(guī)定或限制,可以使用流程圖的形式、判定表的形式,1可以使用其他表現(xiàn)形式,如程序設(shè)計語言〔PDL〕、問題分析圖〔PAD〕等。
5.3.6文件的表現(xiàn)形式
本指南對于文件的表現(xiàn)形式亦未作出規(guī)定或限制,可以使用自然語言,也可以使用形式化語言。
5.3.7文件的其他種類
當本指南中規(guī)定的文件種類尚不能滿足某些應(yīng)用部門的特殊需要時,他們可以建立一些特殊的文件種類要求,例如軟件質(zhì)量保證方案、軟件配置管理方案等,這些要求可以包含在本單位的文件編制實施規(guī)定中。6文件編制的管理工作
文件編制工作必須有管理工作的配合,才能使所編制的文件真正發(fā)揮它的作用。文件的編制工作實際上貫穿于一項軟件的整個開發(fā)過程,因此,對文件的管理必須貫穿于整個開發(fā)過程。在開發(fā)過程中必須進行的管理工作是以下四條。
6.1文件的形成
開發(fā)集體中的每個成員,尤其是工程負責人,應(yīng)該認識到:文件是軟件產(chǎn)品的必不可少的組成局部;在軟件開發(fā)過程的各個階段中,必須按照規(guī)定及時地完成各種產(chǎn)品文件的編寫工作;必須把在一個開發(fā)步驟中作出的決定和取得的結(jié)果及時地寫入文件;開發(fā)集體必須及時地對這些文件進行嚴格的評審;這些文件的形成是各個階段開發(fā)工作正式完成的標志。這些文件上必須有編寫者、評審者和批準者的簽字,必須有編寫、評審?fù)瓿傻娜掌诤团鷾实娜掌凇?/p>
6.2文件的分類與標識
在軟件開發(fā)的過程中,產(chǎn)生的文件是很多的,為了便于保存、查找、使用和修改,應(yīng)該對文件按層次地加以分類組織。一個軟件開發(fā)單位應(yīng)該建立一個對本單位文件的標識方法,使文件的每一頁都具有明確的標識。例如可以按如下四個層次對文件加以分類和標識。
a.文件所屬的工程的標識;
b.文件種類的標識;
C.同一種文件的不同版本號;
d.頁號。
此外,對每種文件還應(yīng)根據(jù)工程的性質(zhì),劃定它們各自的保密級別,確定他們各自的發(fā)行范圍。
6.3文件的控制
在一項軟件的開發(fā)過程中,隨著程序的逐步形成和逐步修改,各種文件亦在不斷地產(chǎn)生、不斷地修改或補充。因此,必須加以周密的控制,以保持文件與程序產(chǎn)品的一致性,保持各種文件之間的一致性和文件的平安性。這種控制表現(xiàn)為:
a.就從事一項軟件開發(fā)工作的開發(fā)集體而言,應(yīng)設(shè)置一位專職的文件管理人員〔接口管理工程師或文件管理員〕;在開發(fā)集體中,應(yīng)該集中保管本工程現(xiàn)有全部文件的主文本兩套,由該文件管理人員負責保管;
b.每一份提交給文件管理人員的文件都必須具有編寫人、審核人和批準人的簽字;
C.這兩套主文本的內(nèi)容必須完全一致;其中有一套是可供出借的,另一套是絕對不能出借的,以免發(fā)生萬一;可出借的主文本在出借時必須辦理出借手續(xù),歸還時辦理注銷出借手續(xù);
d.開發(fā)集體中的工作人員可以根據(jù)工作的需要,在本工程的開發(fā)過程中持有一些文件,即所謂個人文件,包括為使他完成他承擔的任務(wù)所需要的文件,以及他在完成任務(wù)過程中所編制的文件;但這種個人文件必須是主文本的復(fù)制品,必須同主文本完全一致,假設(shè)要修改,必須首先修改主文本;
e.不同開發(fā)人員所擁有的個人文件通常是主文本的各種子集;所謂子集是指把主文本的各個局部根據(jù)承擔不同任務(wù)的人員或部門的工作需要加以復(fù)制、組裝而成的假設(shè)干個文件的集合;文件管理人員。應(yīng)該列出一份不同子集的分發(fā)對象的清單,按照清單及時把文件分發(fā)給有關(guān)人員或部門;
f.一份文件如果已經(jīng)被另一份新的文件所代替,那么原文件應(yīng)該被注銷;文件管理人中要隨時整理主文本,及時反映出文件的變化和增加情況,及時分發(fā)文件;
g.當一個工程的開發(fā)工作臨近結(jié)束時,文件管理人員應(yīng)逐個收回開發(fā)集體內(nèi)每個成員的個人文件,并檢查這些個人文件的內(nèi)容;經(jīng)驗說明,這些個人文件往往可能比主文本更詳細,或同主文本的內(nèi)容有所不同,必須認真監(jiān)督有關(guān)人員進行修改,使主文本能真正反映實際的開發(fā)結(jié)果。
6.4文件的修改管理
在一個工程的開發(fā)過程中的任何時刻,開發(fā)集體內(nèi)的所有成員都可能對開發(fā)工作的已有成果——文件,提出進行修改的要求。提出修改要求的理由可能是各種各樣的,進行修改而引起的影響可能很小,也可能會牽涉到本工程的很多方面。因此,修改活動的進行必須謹慎,必須對修改活動的進行加以管理,必須執(zhí)行修改活動的規(guī)程,使整個修改活動有控制地進行。
修改活動可分如下五個步驟進行:
a.提議開發(fā)集體中的任何一個成員都可以向工程負責人提出修改建議,為此應(yīng)該填寫一份修改建議表,說明修改的內(nèi)容、所修改的文件和部位、以及修改理由;
b.評議由工程負責人或工程負責人指定的人員對該修改建議進行評議,包括審查該項修改的必要性、確定這一修改的影響范圍、研究進行修改的方法、步驟和實施方案;
c.審核一般由工程負責人進行審核,包括核實修改的自的和要求、核實修改活動將帶來的影響、審核修改活動方案是否可行;
d.批準在一般情況下,批準權(quán)屬于該開發(fā)單位的部門負責人;在批準時,主要是決斷修改工作中各項活動的先后順序及各自的完成日期,以保證整個開發(fā)工作按原定方案日期完成;
e.實施由工程負責人按照已批準的修改活動方案,安排各項修改活動的負責人員進行修改,建立修改記錄、產(chǎn)生新的文件以取代原有文件、最后把文件交文件管理人員歸檔,并分發(fā)給有關(guān)的持有者。
第二篇各種文件的內(nèi)容要求
本篇將對引言中提到的十四種文件提供內(nèi)容要求,作為文件編制的技術(shù)標準。
7可行性研究報告
可行性研究報告的編寫目的是:說明該軟件開發(fā)工程的實現(xiàn)在技術(shù)、經(jīng)濟和社會條件方面的可行性;評述為了合理地到達開發(fā)目標而可能選擇的各種方案;說明并論證所選定的方案。
可行性研究報告的編寫內(nèi)容要求如下:
7.1引言
7.1C1編寫目的
7.1.2背景
7.1.3定義
7.1.4參考資料7
7.2可行性研究的前提
7.2.1要求
7.2.2目標
7.2.3條件、假定和限制
7.2.4進行可行性研究的方法
7.2.5評價尺度
7.3對現(xiàn)有系統(tǒng)的分析
7.3.1數(shù)據(jù)流程和處理流程
7.3.2工作負荷
7.3.3費用開支
7.3.4人員
7.3.5設(shè)備
7.3.6局限性
7.4所建議的系統(tǒng)
7.4.1對所建議系統(tǒng)的說明
7.4.2數(shù)據(jù)流程和處理流程
7.4.3改進之處
7.4.4影響
7.4.4.1對設(shè)備的影響
7.4.4.2對軟件的影響
7.4.4.3對用戶單位機構(gòu)的影響
7.4.4.4對系統(tǒng)運行的影響
7.4.4.5對開發(fā)的影響
7.4,4.6對地點和設(shè)施的影響
7.4.4.7對經(jīng)費開支的影響
7.4.5局限性
7.4.6技術(shù)條件方面的可行性
7.5可選擇的其他系統(tǒng)方案
7.5.1可選擇的系統(tǒng)方案1
7.5.2可選擇的系統(tǒng)方案2
......
7.6投資及收益分析
7.6.1支出
7.6.1.1根本建設(shè)投資
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社會條件方面的可行性
7.7.1法律方面的可行性
7.7.2使用方面的可行性
7.8結(jié)論8工程開發(fā)方案
編制工程開發(fā)方案的目的是用文件的形式,把對于在開發(fā)過程中各項工作的負責人員、開發(fā)進度、所需經(jīng)費預(yù)算、所需軟、硬件條件等問題作出的安排記載下來,以便根據(jù)本方案開展和檢查本工程的開發(fā)工作。編制內(nèi)容要求如下:
8.1引言
8.1.1編寫目的
8.1.2背景
8.1.3定義
8.1.4參考資料
8.2工程概述
8.2.1作內(nèi)容
8.2.2主要參加人員
8.2.3產(chǎn)品及成果
8.2.3.1程序
8.2.3.2文件
8.2.3.3效勞
8.2.3.4非移交產(chǎn)品
8.2.4驗收標準
8..2.5完成工程的最遲期限
8.2.6本方案的審查者與批準者
8.3實施總方案
8.3.1工作任務(wù)的分解
8.3.2接口人員
8.3.3進度
8.3.4預(yù)算
8.3.5關(guān)鍵問題
8.4支持條件
8.4.1計算機系統(tǒng)支持
8.4.2需要用戶承擔的工作
8.4.3需由外單位提供的條件
8.5專題方案要點
9軟件需求說明書
軟件需求說明書的編制是為了使用戶和軟件開發(fā)者雙方對該軟件的初始規(guī)定有一個共同的理解,使之成為整個開發(fā)工作的根底。編制軟件需求說明書的內(nèi)容要求如下:
9.1引言
9.1.1編寫目的
9.1.2背景
9.1.3定義
9.1.4參考資料
9.2任務(wù)概述
9.2.1目標
9.2.2用戶的特點
9.2.3假定與約束
9.3需求規(guī)定
9.3.1對功能的規(guī)定
9.3.2對性能的規(guī)定
9.3.2.1精度
9.3.2.2時間特性耍求
9.3.2.3靈巧性
9.3.3輸入輸出要求
9.3.4數(shù)據(jù)管理能力要求
9.3.5故障處理要求
9.3.6其他專門要求
9.4運行環(huán)境規(guī)定
9.4.1設(shè)備
9.4.2支持軟件
9.4.3接口
9.4.4控制
10數(shù)據(jù)要求說明書
數(shù)據(jù)要求說明書的編制目的是為了向整個開發(fā)時期提供關(guān)于被處理數(shù)據(jù)的描述和數(shù)據(jù)采集要求的技術(shù)信息。編制數(shù)據(jù)要求說明書的內(nèi)容要求如下:
10.1引言
10.1.1編寫目的
10.1.2背景
10.1.3定義
10.1.4參考資料
10.2數(shù)據(jù)的邏輯描述
10.2.1靜態(tài)數(shù)據(jù)
10.2.2動態(tài)輸入數(shù)據(jù)
10.2.3動態(tài)輸出數(shù)據(jù)
10.2.4內(nèi)部生成數(shù)據(jù)
10.2.5數(shù)據(jù)約定
10.3數(shù)據(jù)的采集
10.3.1要求和范圍
10.3.2輸入的承擔者
10.3.3處理
10.3.4影響。
11概要設(shè)計說明書
概要設(shè)計說明書又可稱系統(tǒng)設(shè)計說明書,這里所說的系統(tǒng)是指程序系統(tǒng)。編制的目的是說明對程序系統(tǒng)的設(shè)計考慮,包括程序系統(tǒng)的根本處。流程、程序系統(tǒng)的組織結(jié)構(gòu)、模塊劃分、功能分配、接口設(shè)計。運行設(shè)計、數(shù)據(jù)結(jié)構(gòu)設(shè)計和出錯處理設(shè)計等,為程序的詳細設(shè)計提供根底。編制概要設(shè)計說明書的內(nèi)容要求如下:
11.1引言
11.1.1編寫目的
11.1.2背景
11.1.3定義
11.1.4參考資料
11.2總體設(shè)計
11.2.1需求規(guī)定
11.2.2運行環(huán)境
11.2.3根本設(shè)計概念和處理流程
11.2.4結(jié)構(gòu)
11.2.5功能需求與程序的關(guān)系
11.2.6人工處理過程
11.2.7尚未解決的問題
11.3接口設(shè)計
11.3.1用戶接口
11.3.2外部接口
11.3.3內(nèi)部接口
11.4運行設(shè)計
11.4.1運行模塊組合
11.4.2運行控制
11.4.3運行時間
11.5系統(tǒng)論據(jù)結(jié)構(gòu)設(shè)計
11.5.1邏輯結(jié)構(gòu)設(shè)計要點
11.5.2物理結(jié)構(gòu)設(shè)計要點
11.5.3數(shù)據(jù)結(jié)構(gòu)與程序的關(guān)系
11.6系統(tǒng)出錯處理設(shè)計
11.6.1出錯信息
11.6.2補救措施
11.63系統(tǒng)維護設(shè)計
12詳細設(shè)計說明書
詳細設(shè)計說明書又可稱程序設(shè)計說明書。編制目的是說明一個軟件系統(tǒng)各個層次中的每一個程序〔每個模塊或子程序〕的設(shè)計考慮,如果一個軟件系統(tǒng)比較簡單,層次很少,本文件可以不單獨編寫,有關(guān)內(nèi)容合并入概要設(shè)計說明書。對詳細設(shè)計說明書的內(nèi)容要求如下:
12.1引言
12.1.1編寫目的
12.1.2背景
12.1.3定義
12.1.4參考資料
12.2程序系統(tǒng)的組織結(jié)構(gòu)
12.3程序1〔標識符〕設(shè)計說明
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注釋設(shè)計
12.3.11限制條件
12.3.12測試方案.
12.3.13尚未解決的問題
12.4程序2〔標識符〕設(shè)計說明
......
13數(shù)據(jù)庫設(shè)計說明書
數(shù)據(jù)庫設(shè)計說明書的編制目的是對于設(shè)計中的數(shù)據(jù)庫的所有標識、邏輯結(jié)構(gòu)和物理結(jié)構(gòu)作出具體的設(shè)計規(guī)定。其內(nèi)容要求如下:
13.1引言
13.1.1編寫目的
13.1.2背景
13.1.3定義
13.1.4參考資料
13.2外部設(shè)計
13.2.1標識符和狀態(tài)
13.2.2使用它的程序
13.2.3約定
13.2.4專門指導(dǎo)
13.2.5支持軟件
13.3結(jié)構(gòu)設(shè)計
13.3.1概念結(jié)構(gòu)設(shè)計
13.3.2邏輯結(jié)構(gòu)設(shè)計
13.3.3物理結(jié)構(gòu)設(shè)計
13.4運用設(shè)計
13.4.1數(shù)據(jù)字典設(shè)計
13.4.2平安保密設(shè)計
14用戶手冊
用戶手冊的編制是要使用非專門術(shù)語的語言,充分地描述該軟件系統(tǒng)所具有的功能及根本的使用方法。使用戶〔或潛在用戶〕通過本手冊能夠了解該軟件的用途,并且能夠確定在什么情況下,如何使用它。具體的內(nèi)容要求如下:
14.1引言
14.1.1編寫目的
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時間特性
14.2.2.3靈巧性
14.2.3平安保密
14.3運行環(huán)境
14.3.1硬設(shè)備
14.3.2支持軟件
14.3.3數(shù)據(jù)結(jié)構(gòu)
14.4使用過程
14.4.1安裝與初始化
14.4.2輸入
14.4.2.1輸入數(shù)據(jù)的現(xiàn)實背景
14.4.2.2輸入格式
14.4.2.3輸入舉例
14.4.3輸出
14.4.3.1輸出數(shù)據(jù)的現(xiàn)實背景
14.4.3.2輸出格式
14.4.3.3輸出舉例
14.4.4文卷查詢
14.4.5出錯處理與恢復(fù)
14.4.6終端操作
15操作手冊
操作手冊的編制是為了向操作人員提供該軟件每一個運行的具體過程和有關(guān)知識,包括操作方法的細節(jié)。具體的內(nèi)容要求如下:
15.1引言
15.1.1編寫目的
15.1.2背景
15.1.3定義
15.1.4參考資料
15.2軟件概述
15.2.1軟件的結(jié)構(gòu)
15.2.2程序表
15.2.3文卷表
15.3安裝與初始化
15.4運行說明
15.4.1運行表
15.4.2運行步驟
15.4.3運行1〔標識符〕說明
15.4.3.1運行控制
15.4.3.2操作信息
15.4.3.3輸入一輸出文卷
15.4.3.4輸出文段
15.4.3.5輸出文段的復(fù)制
15.4.3.6啟動恢復(fù)過程
15.4.4運行2〔標識符〕說明
......
15.5非?,F(xiàn)過程
15.6遠程操作
16模塊開發(fā)卷宗
模塊開發(fā)卷宗是在模塊開發(fā)過程中逐步編寫出來的,每完成一個模塊或一組密切相關(guān)的模塊的復(fù)審時編寫一份,應(yīng)該把所有的模塊開發(fā)卷宗聚集在一起。編寫的目的是記錄和匯總低層次開發(fā)的進度和結(jié)果,以便于對整個模塊開發(fā)工作的管理和復(fù)審,并為將來的維護提供非常有用的技術(shù)信息。具體的內(nèi)容要求如下:
16.1標題
16.2模塊開發(fā)情況表〔見下表〕
模塊開發(fā)情況表
16.3功能說明
16.4設(shè)計說明
16.5源代碼清單
16.6測試說明
16.7復(fù)審的結(jié)論
17測試方案
這里所說的測試,主要是指整個程序系統(tǒng)的組裝測試和確認測試。本文件的編制是為了提供一個對該軟件的測試方案,包括對每項測試活動的內(nèi)容、進度安排、設(shè)計考慮、測試數(shù)據(jù)的整理方法及評價準那么。具體的內(nèi)容要求如下:
17.1引言
17.1.1編寫目的
17.1.2背景
17.1.3定義
17.1.4參考資料
17.2方案
17.2.1軟件說明
17.2.2測試內(nèi)容
17.2.3測試1〔標識符〕
17.2.3.1進度安排
17.2.3.2條件
17.2.3.3測試資料
17.2.3.4測試培訓
17.2.4測試2〔標識符〕
......
17.3測試設(shè)計說明
17.3.1測試l〔標識符〕
17.3.1.1控制
17.3.1.2輸入
17.3.1.3輸出
17.3.1.4過程
17.3.2測試2〔標識符〕
.......
17.4評價準那么
17.4.1范圍
17.4.2數(shù)據(jù)整理
17.4.3尺度
18測試分析報告
測試分析報告的編寫是為了把組裝測試和確認測試的結(jié)果、發(fā)現(xiàn)及分析寫成文件加以記載,具體的內(nèi)容要求如下:
18.1引言
18.1.1編寫目的
18.1.2背景
18.1.3定義
18.1.4參考資料
18.2測試概要
18.3測試結(jié)果及發(fā)現(xiàn)
18.3.1測試1〔標識符〕
18.3.2測試2〔標識符〕
......
18.4對軟件功能的結(jié)論
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評價
18.6測試資源消耗
19開發(fā)進度月報
開發(fā)進度月報的編制目的是及時向有關(guān)管理部門匯報工程開發(fā)的進展和情況,以便及時發(fā)現(xiàn)和處理開發(fā)過程中出現(xiàn)的問題。一般地,開發(fā)進度月報是以工程組為單位每月編寫的。如果被開發(fā)的軟件系統(tǒng)規(guī)模比較大,整個工程工程被劃分給假設(shè)干個分工程組承擔,開發(fā)進度月報將以分工程組為單位按月編寫。具體的內(nèi)容要求如下:
19.1標題
19.2工程進度與狀態(tài)
19.2.1進度
19.2.2狀態(tài)
19.3資源耗用與狀態(tài)
19.3.1資源耗用
19.3.1.1工時
19.3.1.2機時
19.3.2狀態(tài)
19.4經(jīng)費支出與狀態(tài)
19.4.1經(jīng)費支出
19.4.1.1支持性費用
19.4.1.2設(shè)備購置費
19.4.2狀態(tài)
19.5下個月的工作方案
19.6建議
20工程開發(fā)總結(jié)報告
工程開發(fā)總結(jié)報告的編制是為了總結(jié)本工程開發(fā)工作的經(jīng)驗,說明實際取得的開發(fā)結(jié)果以及對整個開發(fā)工作的各個方面的評價。具體的內(nèi)容要求如下:
20.1引言
20.1.1編寫目的
20.1.2背景
20.1.3定義
20.1.4參考資料
20.2.1產(chǎn)品
20.2實際開發(fā)結(jié)果
20.2.2主要功能和性能
20.2.3根本流程
20.2.4進度
20.2.5費用
20.3開發(fā)工作評價
20.3.1對生產(chǎn)效率的評價
20.3.2對產(chǎn)品質(zhì)量的評價
20.3.3對技術(shù)方法的評價
20.3.4出錯原因的分析
20.4經(jīng)驗與教訓附錄A可行性研究報告的編寫提示
〔參考件〕
A.1引言
A.1.1編寫目的
說明編寫本可行性研究報告的目的,指出預(yù)期的讀者。
A.1.2背景
說明:
a.所建議開發(fā)的軟件系統(tǒng)的名稱;
b.本工程的任務(wù)提出者、開發(fā)者、用戶及實現(xiàn)該軟件的計算中心或計算機網(wǎng)絡(luò);
C.該軟件系統(tǒng)同其他系統(tǒng)或其他機構(gòu)的根本的相互來往關(guān)系。
A.1.3定義
列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。
A.1.4參考資料
列出用得著的參考資料,如:
a.本工程的經(jīng)核準的方案任務(wù)書或合同、上級機關(guān)的批文;
b.屬于本工程的其他已發(fā)表的文件;
C.本文件中各處引用的文件、資料,包括所需用到的軟件開發(fā)標準。|
列出這些文件資料的標題、文件編號、發(fā)表日期和出版單位,說明能夠得到這些文件資料的來源。
A.2可行性研究的前提
說明對所建議的開發(fā)工程進行可行性研究的前提,如要求、目標、假定、限制等。
A.2.1要求
說明對所建議開發(fā)的軟件的根本要求,如:
a.功能;
b.性能;
C.輸出如報告、文件或數(shù)據(jù),對每項輸出要說明其特征,如用途、產(chǎn)生頻度、接口以及分發(fā)對象;
d.輸入說明系統(tǒng)的輸入,包括數(shù)據(jù)的來源、類型、數(shù)量、數(shù)據(jù)的組織以及提供的頻度;
e.處理流程和數(shù)據(jù)流程用圖表的方式表示出最根本的數(shù)據(jù)流程和處理流程,并輔之以表達;
f.在平安與保密方面的要求;
g.同本系統(tǒng)相連接的其他系統(tǒng);
h.完成期限。
A.2.2目標
說明所建議系統(tǒng)的主要開發(fā)目標,如:
a.人力與設(shè)備費用的減少;
b.處理速度的提高;
C.控制精度或生產(chǎn)能力的提高;
d.管理信息效勞的改進;
e.自動決策系統(tǒng)的改進;
f.人員利用率的改進。
A.2.3條件、假定和限制
說明對這項開發(fā)中給出的條件、假定和所受到的限制,如:
a.所建議系統(tǒng)的運行壽命的最小值;
b.進行系統(tǒng)方案選擇比較的時間;
c.經(jīng)費、投資方面的來源和限制;
d.法律和政策方面的限制;
e.硬件、軟件、運行環(huán)境和開發(fā)環(huán)境方面的條件和限制;
f.可利用的信息和資源;
g.系統(tǒng)投入使用的最晚時間。
A.2.4進行可行性研究的方法
說明這項可行性研究將是如何進行的,所建議的系統(tǒng)將是如何評價的。摘要說明所使用的根本方法和策略,如調(diào)查、加權(quán)、確定模型、建立基準點或仿真等。
A.2.5評價尺度
說明對系統(tǒng)進行評價時所使用的主要尺度,如費用的多少、各項功能的優(yōu)先次序、開發(fā)時間的長短及使用中的難易程度。
A.3對現(xiàn)有系統(tǒng)的分析
這里的現(xiàn)有系統(tǒng)是指當前實際使用的系統(tǒng),這個系統(tǒng)可能是計算機系統(tǒng),也可能是一個機械系統(tǒng)甚至是一個人工系統(tǒng)。
分析現(xiàn)有系統(tǒng)的目的是為了進一步說明建議中的開發(fā)新系統(tǒng)或修改現(xiàn)有系統(tǒng)的必要性。
A.3.1處理流程和數(shù)據(jù)流程
說明現(xiàn)有系統(tǒng)的根本的處理流程和數(shù)據(jù)流程。此流程可用圖表即流程圖的形式表示,并加以表達。
A.3.2工作負荷
列出現(xiàn)有系統(tǒng)所承擔的工作及工作量。
A.3.3費用開支
列出由于運行現(xiàn)有系統(tǒng)所引起的費用開支,如人力、設(shè)備、空間、支持性效勞、材料等項開支以及開支總額。
A.3.4人員
列出為了現(xiàn)有系統(tǒng)的運行和維護所需要的人員的專業(yè)技術(shù)類別和數(shù)量。
A.3.5設(shè)備
列出現(xiàn)有系統(tǒng)所使用的各種設(shè)備。
A.3.6局限性
列出本系統(tǒng)的主要的局限性,例如處理時間趕不上需要,響應(yīng)不及時,數(shù)據(jù)存儲能力缺乏,處理功能不夠等。并且要說明,為什么對現(xiàn)有系統(tǒng)的改進性維護已經(jīng)不能解決問題。
A.4所建議的系統(tǒng)
本章將用來說明所建議系統(tǒng)的目標和要求將如何被滿足。
A.4.1對所建議系統(tǒng)的說明
概括地說明所建議系統(tǒng),并說明在第A.2章中列出的那些要求將如何得到滿足,說明所使用的根本方法及理論根據(jù)。
A.4.2處理流程和數(shù)據(jù)流程
給出所建議系統(tǒng)的處理流程和數(shù)據(jù)流程。
A.4.3改進之處
按A.2.2條中列出的目標,逐項說明所建議系統(tǒng)相對于現(xiàn)存系統(tǒng)具有的改進。
A.4.4影響
說明在建立所建議系統(tǒng)時,預(yù)期將帶來的影響,包括:
A.4.4.1對設(shè)備的影響
說明新提出的設(shè)備要求及對現(xiàn)存系統(tǒng)中尚可使用的設(shè)備須作出的修改。
A.4.4.2對軟件的影響
說明為了使現(xiàn)存的應(yīng)用軟件和支持軟件能夠同所建議系統(tǒng)相適應(yīng)。而需要對這些軟件所進行的修改和補充。
A.4.4.3對用戶單位機構(gòu)的影響
說明為了建立和運行所建議系統(tǒng),對用戶單位機構(gòu)、人員的數(shù)量和技術(shù)水平等方面的全部要求。
A.4.4.4對系統(tǒng)運行過程的影響
說明所建議系統(tǒng)對運行過程的影響,如:
a.用戶的操作規(guī)程;
b.運行中心的操作規(guī)程;
C.運行中心與用戶之間的關(guān)系;
d.源數(shù)據(jù)的處理;
e.數(shù)據(jù)進入系統(tǒng)的過程;
f.對數(shù)據(jù)保存的要求,對數(shù)據(jù)存儲、恢復(fù)的處理;
g.輸出報告的處理過程、存儲媒體和調(diào)度方法;
h.系統(tǒng)失效的后果及恢復(fù)的處理方法。
A.4.4.5對開發(fā)的影響
說明對開發(fā)的影響,如:
a.為了支持所建議系統(tǒng)的開發(fā),用戶需進行的工作;
b.為了建立一個數(shù)據(jù)庫所要求的數(shù)據(jù)資源;
C.為了開發(fā)和測驗所建議系統(tǒng)而需要的計算機資源;
d.所涉及的保密與平安問題。
A.4.4.6對地點和設(shè)施的影響
說明對建筑物改造的要求及對環(huán)境設(shè)施的要求。
A.4.4.7對經(jīng)費開支的影響
扼要說明為了所建議系統(tǒng)的開發(fā),設(shè)計和維持運行而需要的各項經(jīng)費開支。
A.4.5局限性
說明所建議系統(tǒng)尚存在的局限性以.及這些問題未能消除的原因。
A.4.6技術(shù)條件方面的可行性
本節(jié)應(yīng)說明技術(shù)條件方面的可行性,如:
a.在當前的限制條件下,該系統(tǒng)的功能目標能否到達;
b.利用現(xiàn)有的技術(shù),該系統(tǒng)的功能能否實現(xiàn);
C.對開發(fā)人員的數(shù)量和質(zhì)量的要求并說明這些要求能否滿足;
d.在規(guī)定的期限內(nèi),本系統(tǒng)的開發(fā)能否完成。
A.5可選擇的其他系統(tǒng)方案
扼要說明曾考慮過的每一種可選擇的系統(tǒng)方案,包括需開發(fā)的和可從國內(nèi)國外直接購置的,如果沒有供選擇的系統(tǒng)方案可考慮,那么說明這一點。
A.5.1可選擇的系統(tǒng)方案1
參照第A.4章的提綱,說明可選擇的系統(tǒng)方案1,并說明它未被選中的理由。
A.5.2可選擇的系統(tǒng)方案2
按類似A.5.1條的方式說明第2個乃至第。個可選擇的系統(tǒng)方案。
......
A.6投資及效益分析
A.6.1支出
對于所選擇的方案,說明所需的費用。如果已有一個現(xiàn)存系統(tǒng),那么包括該系統(tǒng)繼續(xù)運行期間所需的費用。
A.6.1.1根本建設(shè)投資
包括采購、開發(fā)和安裝以下各項所需的費用,如:
a.房屋和設(shè)施;
b.ADP設(shè)備;
C.數(shù)據(jù)通訊設(shè)備;
d.環(huán)境保護設(shè)備;
e.平安與保密設(shè)備;
f.ADP操作系統(tǒng)的和應(yīng)用的軟件;
g.數(shù)據(jù)庫管理軟件。
A.6.1.2其他一次性支出
包括以下各項所需的費用,如:
a.研究〔需求的研究和設(shè)計的研究〕;
b.開發(fā)方案與測量基準的研究;
C.數(shù)據(jù)庫的建立;
d.ADP軟件的轉(zhuǎn)換;
e.檢查費用和技術(shù)管理性費用;
f.培訓費、旅差費以及開發(fā)安裝人員所需要的一次性支出;
g.人員的退休及調(diào)動費用等。
A.6.1.3非一次性支出
列出在該系統(tǒng)生命期內(nèi)按月或按季或按年支出的用于運行和維護的費用,包括:
a.設(shè)備的租金和維護費用;
b軟件的租金和維護費用;
C.數(shù)據(jù)通訊方面的租金和維護費用;
d.人員的工資、獎金;
e.房屋、空間的使用開支;
f.公用設(shè)施方面的開支;
g.保密平安方面的開支;
h.其他經(jīng)常性的支出等。
A.6.2收益
對于所選擇的方案,說明能夠帶來的收益,這里所說的收益,表現(xiàn)為開支費用的減少或防止、過失的減少、靈巧性的增加、動作速度的提高和管理方案方面的改進等,包括;
A.6.2.1一次性收益
說明能夠用人民幣數(shù)目表示的一次性收益,可按數(shù)據(jù)處理、用戶、管理和支持等項分類表達,如:
a.開支的縮減包括改進了的系統(tǒng)的運行所引起的開支縮減,如資源要求的減少,運行效率的改進,數(shù)據(jù)進入、存貯和恢復(fù)技術(shù)的改進,系統(tǒng)性能的可監(jiān)控,軟件的轉(zhuǎn)換和優(yōu)化,數(shù)據(jù)壓縮技術(shù)的采用,處理的集中化/分布化等;
b.價值的增升包括由于一個應(yīng)用系統(tǒng)的使用價值的增升所引起的收益,如資源利用的改進,管理和運行效率的改進以及出錯率的減少等;
C.其他如從多余設(shè)備出售回收的收入等。
A.6.2.2非一次性收益
說明在整個系統(tǒng)生命期內(nèi)由于運行所建議系統(tǒng)而導(dǎo)致的按月的、按年的能用人民幣數(shù)目表示的收益,包括開支的減少和防止。
A.6.2.3不可定量的收益
逐項列出無法直接用人民幣表示的收益,如效勞的改進,由操作失誤引起的風險的減少,信息掌握情況的改進,組織機構(gòu)給外界形象的改善等。有些不可捉摸的收益只能大概估計或進行極值估計〔按最好和最差情況估計〕。
A.6.3收益/投資比
求出整個系統(tǒng)生命期的收益/投資比值。
A.6.4投資回收周期
求出收益的累計數(shù)開始超過支出的累計數(shù)的時間。
A.6.5敏感性分析
所謂敏感性分析是指一些關(guān)鍵性因素如系統(tǒng)生命期長度、系統(tǒng)的工作負荷量、工作負荷的類型與這些不同類型之間的合理搭配、處理速度要求、設(shè)備和軟件的配置等變化時,對開支和收益的影響最靈敏的范圍的估計。在敏感性分析的根底上做出的選擇當然會比單一選擇的結(jié)果要好一些。
A.7社會因素方面的可行性
本章用來說明對社會因素方面的可行性分析的結(jié)果,包括:
A.7.1法律方面的可行性
法律方面的可行性問題很多,如合同責任、侵犯專利權(quán)、侵犯版權(quán)等方面的陷井,軟件人員通常是不熟悉的,有可能陷入,務(wù)必要注意研究。
A.7.2使用方面的可行性
例如從用戶單位的行政管理、工作制度等方面來看,是否能夠使用該軟件系統(tǒng);從用戶單位的工作人員的素質(zhì)來看,是否能滿足使用該軟件系統(tǒng)的要求等等,都是要考慮的。
A.8結(jié)論
在進行可行性研究報告的編制時,必須有一個研究的結(jié)論。結(jié)論可以是:
a.可以立即開始進行;
b.需要推遲到某些條件〔例如資金、人力、設(shè)備等〕落實之后才能開始進行;
c.需要對開發(fā)目標進行某些修改之后才能開始進行;
d.不能進行或不必進行〔例如因技術(shù)不成熟、經(jīng)濟上不合算等〕。附錄B
工程開發(fā)方案的編寫提示
B.1引言
B.1.1編寫目的
說明編寫這份工程開發(fā)方案的目的,并指出預(yù)期的讀者。
B.1.2背景
說明:
a.待開發(fā)的軟件系統(tǒng)的名稱;
b.本工程的任務(wù)提出者、開發(fā)者、用戶及實現(xiàn)該軟件的計算中心或計算機網(wǎng)絡(luò);
C.該軟件系統(tǒng)同其他系統(tǒng)或其他機構(gòu)的根本的相互來往關(guān)系。
B.1.3定義
列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。
B.1.4參考資料
列出用得著的參考資料,如:
a.本工程的經(jīng)核準的方案任務(wù)書或合同、上級機關(guān)的批文;
b.屬于本工程的其他已發(fā)表的文件;
C.本文件中各處引用的文件、資料,包括所要用到的軟件開發(fā)標準。列出這些文件資料的標題、文件編號、發(fā)表日期和出版單位,說明能夠得到這些文件資料的來源。
B.2工程概述
B.2.1工作內(nèi)容
簡要地說明在本工程的開發(fā)中須進行的各項主要工作。
B.2.2主要參加人員
扼要說明參加本工程開發(fā)工作的主要人員的情況,包括他們的技術(shù)水平。
B.2.3產(chǎn)品
B.2.31程序
列出需移交給用戶的程序的名稱、所用的編程語言及存儲程序的媒體形式,并通過引用有關(guān)文件,逐項說明其功能和能力。
B.2.3.2文件
列出需移交給用戶的每種文件的名稱及內(nèi)容要點。
B.2.3.3效勞
列出需向用戶提供的各項效勞,如培訓安裝、維護和運行支持等,應(yīng)逐項規(guī)定開始日期、所提供支持的級別和效勞的期限。
B.2.3.4非移交的產(chǎn)品
說明開發(fā)集體應(yīng)向本單位交出但不必向用戶移交的產(chǎn)品〔文件甚至某些程序〕。
B.2.4驗收標準
對于上述這些應(yīng)交出的產(chǎn)品和效勞,逐項說明或引用資料說明驗收標準。
B.2.5完成工程的員遲用限
B.2.6本方案的批準者和批準日期
B.3實施方案
B.3.1工作任務(wù)的分門與人員分工
對于工程開發(fā)中需完成的各項工作,從需求分析、設(shè)計、實現(xiàn)、測試直到維護,包括文件的編制、審批、打印、分發(fā)工作,用戶培訓工作,軟件安裝工作等,按層次進行分解,指明每項任務(wù)的負責人和參加人員。
B.3.2接口人員
說明負責接口工作的人員及他們的職責,包括:
a.負責本工程同用戶的接口人員;
b.負責本工程同本單位各管理機構(gòu),如合同方案管理部門、財務(wù)部門、質(zhì)量管理部門等的接口人員;
c.負責本工程同各分合同負責單位的接口人員等。
B.3.3進度
對于需求分析、設(shè)計、編碼實現(xiàn)、測試、移交、培訓和安裝等工作,給出每項工作任務(wù)的預(yù)。定開始日期、完成日期及所需資源,規(guī)定各項工作任務(wù)完成的先后順序以及表征每項工作任務(wù)完成的標志性事件〔即所謂“里程碑〞〕。
B.3.4預(yù)算
逐項列出本開發(fā)工程所需要的勞務(wù)〔包括人員的數(shù)量和時間〕以及經(jīng)費的預(yù)算〔包括辦公費、差旅費、機時費、資料費、通訊設(shè)備和專用設(shè)備的租金等〕和來源。
B.3.5關(guān)鍵問題
逐項列出能夠影響整個工程成敗的關(guān)鍵問題、技術(shù)難點和風險,指出這些問題對工程的影響。
B.4支持條件
說明為支持本工程的開發(fā)所需要的各種條件和設(shè)施。
B.4.1計算機系統(tǒng)支持
逐項列出開發(fā)中和運行時所需的計算機系統(tǒng)支持,包括計算機、外圍設(shè)備、通訊設(shè)備、模擬器、編譯〔或匯編〕程序、操作系統(tǒng)、數(shù)據(jù)管理程序包、數(shù)據(jù)存儲能力和測試支持能力等,逐項給出有關(guān)到貨日期、使用時間的要求。
B.4.2需由用戶承擔的工作
逐項列出需要用戶承擔的工作和完成期限。包括需由用戶提供的條件及提供時間。
B.4.3由外單位提供的條件
逐項列出需要外單位分合同承包者承擔的工作和完成的時間,包括需要由外單位提供的條件和提供的時間。
B.5專題方案要點
說明本工程開發(fā)中需制訂的各個專題方案〔如分合同方案、開發(fā)人員培訓方案、測試方案、平安保密方案、質(zhì)量保證方案、配置管理方案、用戶培訓方案、系統(tǒng)安裝方案等〕的要點。
附錄C
軟件需求說明書的編寫提示
C.1引言
C.1.1編寫目的
說明編寫這份軟件需求說明書的目的,指出預(yù)期的讀者。
C.1.2背景
說明:
a.待開發(fā)的軟件系統(tǒng)的名稱;
b.本工程的任務(wù)提出者、開發(fā)者、用戶及實現(xiàn)該軟件的計算中心或計算機網(wǎng)絡(luò);
C.該軟件系統(tǒng)同其他系統(tǒng)或其他機構(gòu)的根本的相互來往關(guān)系。
C.1.3定義
列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。
C.1.4參考資料
列出用得著的參考資料,如:
a.本工程的經(jīng)核準的方案任務(wù)書或合同、上級機關(guān)的批文;
b.屬于本工程的其他已發(fā)表的文件;
c.本文件中各處引用的文件、資料、包括所要用到的軟件開發(fā)標準。列出這些文件資料的標題、文件編號、發(fā)表日期和出版單位,說明能夠得到這些文件資料的來源。
C.2任務(wù)概述
C.2.1目標
表達該項軟件開發(fā)的意圖、應(yīng)用目標、作用范圍以及其他應(yīng)向讀者說明的有關(guān)該軟件開發(fā)的背景材料。解釋被開發(fā)軟件與其他有關(guān)軟件之間的關(guān)系。如果本軟件產(chǎn)品是一項獨立的軟件,而且全部內(nèi)容自含,那么說明這一點。如果所定義的產(chǎn)品是一個更大的系統(tǒng)的一個組成局部,那么應(yīng)說明本產(chǎn)品與該系統(tǒng)中其他各組成局部之間的關(guān)系,為此可使用一張方框圖來說明該系統(tǒng)的組成和本產(chǎn)品同其他各局部的聯(lián)系和接口。|
C.2.2用戶的特點
列出本軟件的最終用戶的特點,充分說明操作人員、維護人員的教育水平和技術(shù)專長,以及本軟件的預(yù)期使甩頻度。這些是軟件設(shè)計工作的重要約束
C.2.3假定和約束
列出進行本軟件開發(fā)工作的假定和約束,例如經(jīng)費限制、開發(fā)期限等。
C.3需求規(guī)定
C.3.1對功能的規(guī)定
用列表的方式〔例如IPO表即輸入、處理、輸出表的形式〕,逐項定量和定性地表達對軟件所提出的功能要求,說明輸入什么量、經(jīng)怎樣的處理、得到什么輸出,說明軟件應(yīng)支持的終端數(shù)和應(yīng)支持的并行操作的用戶數(shù)。
C.3.2對性能的規(guī)定
C.3.2.1精度
說明對該軟件的輸入、輸出數(shù)據(jù)精度的要求,可能包括傳輸過程中的精度。
C.3.2.2時間特性要求
說明對于該軟件的時間特性要求,如對:
a.響應(yīng)時間;
b.更新處理時間;
c.數(shù)據(jù)的轉(zhuǎn)換和傳送時間;
d.解題時間;等的要求。
C.3.2.3靈巧性
說明對該軟件的靈巧性的要求,即當需求發(fā)生某些變化時,該軟件對這些變化的適應(yīng)能力,如:
a.操作方式上的變化;
b.運行環(huán)境的變化;
c.同其他軟件的接口的變化;
d.精度和有效時限的變化;
e.方案的變化或改進。
對于為了提供這些靈巧性而進行的專門設(shè)計的局部應(yīng)該加以標明。
C.3.3輸人輸出要求
解釋各輸入輸出數(shù)據(jù)類型,并逐項說明其媒體、格式、數(shù)值范圍、精度等。對軟件的數(shù)據(jù)輸出及必須標明的控制輸出量進行解釋并舉例,包括對硬拷貝報告〔正常結(jié)果輸出、狀態(tài)輸出及異常輸出〕以及圖形或顯示報告的描述。
C.3.4數(shù)據(jù)管理能力要求
說明需要管理的文卷和記錄的個數(shù)、表和文卷的大小規(guī)模,要按可預(yù)見的增長對數(shù)據(jù)及其分量的存儲要求作出估算。
C.3.5故障處理要求
列出可能的軟件、硬件故障以及對各項性能而言所產(chǎn)生的后果和對故障處理的要求。
C.3.6其他專門要求
如用戶單位對平安保密的要求,對使用方便的要求,對可維護性、可補充性、易讀性、可靠性、運行環(huán)境可轉(zhuǎn)換性的特殊要求等。
C.4運行環(huán)境規(guī)定
C.4.1設(shè)備
列出運行該軟件所需要的硬設(shè)備。說明其中的新型設(shè)備及其專門功能,包括:
a.處理器型號及內(nèi)存容量;
b.外存容量、聯(lián)機或脫機、媒體及其存儲格式,設(shè)備的型號及數(shù)量;
c.輸入及輸出設(shè)備的型號和數(shù)量,聯(lián)機或脫機;
d.數(shù)據(jù)通信設(shè)備的型號和數(shù)量;
e.功能鍵及其他專用硬件
C.4.2支持軟件
列出支持軟件,包括要用到的操作系統(tǒng)、編譯〔或匯編〕程序、測試支持軟件等。
C.4.3接口
說明該軟件同其他軟件之間的接口、數(shù)據(jù)通信協(xié)議等。
C.4.4控制
說明控制該軟件的運行的方法和控制信號,并說明這些控制信號的來源。
附錄D
數(shù)據(jù)要求說明書的編寫提示
D.1引言
D.1.1編寫目的
說明編寫這份數(shù)據(jù)要求說明書的目的,指出預(yù)期的讀者。
D.1.2背景
說明:
a.待開發(fā)軟件系統(tǒng)的名稱;
b.列出本工程的任務(wù)提出者、開發(fā)者、用戶以及將運行該項軟件的計算站〔中心〕或計算機網(wǎng)絡(luò)系統(tǒng)。
D.1.3定義
列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。
D.1.4參考資料
列出有關(guān)的參考資料,如:
a.本工程的經(jīng)核準的方案任務(wù)書或合同,上級機關(guān)的批文;
b.屬于本工程的其他已發(fā)表文件;
c.本文件中各處引用的文件、資料,包括所要用到的軟件開發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位。說明能夠得到這些文件資料的來源。
D.2數(shù)據(jù)的邏輯描述
對數(shù)據(jù)進行邏輯描述時可把數(shù)據(jù)分為動態(tài)數(shù)據(jù)和靜態(tài)數(shù)據(jù)。所謂靜態(tài)數(shù)據(jù),指在運行過程中主要作為參考的數(shù)據(jù),它們在很長的一段時間內(nèi)不會變化,一般不隨運行而改變。所謂動態(tài)數(shù)據(jù).包括所有在運行中要發(fā)生變化的數(shù)據(jù)以及在運行中要輸入、輸出的數(shù)據(jù)。進行描述時應(yīng)把各數(shù)據(jù)元素邏輯地分成假設(shè)干組,列如函數(shù)、源數(shù)據(jù)或?qū)τ谄鋺?yīng)用更為恰當?shù)倪壿嫹纸M。給出每一數(shù)據(jù)元的名稱〔包括縮寫和代碼〕、定義〔或物理意義〕度量單位、值域、格式和類型等有關(guān)信息。
D.2.1靜態(tài)數(shù)據(jù)
列出所有作為控制或參考用的靜態(tài)數(shù)據(jù)元素。
D.2.2動態(tài)輸人數(shù)據(jù)
列出動態(tài)輸入數(shù)據(jù)元素〔包括在常規(guī)運行中或聯(lián)機操作中要改變的數(shù)據(jù)〕。
D.2.3動態(tài)輸出數(shù)據(jù)
列出動態(tài)輸出數(shù)據(jù)元素〔包括在常規(guī)運行中或聯(lián)機操作中要改變的數(shù)據(jù)〕。
D.2.4內(nèi)部生成數(shù)據(jù)
列出向用戶或開發(fā)單位中的維護調(diào)試人員提供的內(nèi)部生成數(shù)據(jù)。
D.2.5數(shù)據(jù)約定
說明對數(shù)據(jù)要求的制約。逐條列出對進一步擴充或使用方面的考慮而提出的對數(shù)據(jù)要求的限制〔容量、文卷、記錄和數(shù)據(jù)元的個數(shù)的最大值〕。對于在設(shè)計和開發(fā)中確定是臨界性的限制更要明確指出。
D.3.數(shù)據(jù)的采集
D.3.1要求和范圍
按數(shù)據(jù)元的邏輯分組來說明數(shù)據(jù)采集的要求和范圍,指明數(shù)據(jù)的采集方法,說明數(shù)據(jù)采集工作的承擔者是用戶還是開發(fā)者。具體的內(nèi)容包括:
a.輸入數(shù)據(jù)的來源,例如是單個操作員、數(shù)據(jù)輸入站,專業(yè)的數(shù)據(jù)輸入公司或它們的一個分組;
b.數(shù)據(jù)輸入〔指把數(shù)據(jù)輸入處理系統(tǒng)內(nèi)部〕所用的媒體和硬設(shè)備。如果只有指定的輸入點的輸入才是合法的,那么必須對此加以說明;
c.接受者說明輸出數(shù)據(jù)的接受者;
d.輸出數(shù)據(jù)的形式和設(shè)備列出輸出數(shù)據(jù)的形式和硬設(shè)備。無論接受者將接收到的數(shù)據(jù)是打印輸出,還是CRT上的一組字符、一幀圖形,或一聲警鈴,或向開關(guān)線圈提供的一個電脈沖,或常用介質(zhì)如磁盤、磁帶、穿孔卡片等,均應(yīng)具體說明;
e.數(shù)據(jù)值的范圍給出每一個數(shù)據(jù)元的合法值的范圍;
f.量綱給出數(shù)字的度量單位、增量的步長、零點的定標等。在數(shù)據(jù)是非數(shù)字量的情況下,要給出每一種合法值的形式和含意;
g.更新和處理的頻度給出預(yù)定的對輸入數(shù)據(jù)的更新和處理的頻度。如果數(shù)據(jù)的輸入是隨機的,應(yīng)給出更新處理的頻度的平均值,或變化情況的某種其他度量。
D.3.2輸人的承擔者
說明預(yù)定的對數(shù)據(jù)輸入工作的承擔者。如果輸入數(shù)據(jù)同某一接口軟件有關(guān),還應(yīng)說明該接口軟件的來源。
D.3.3預(yù)處理
對數(shù)據(jù)的采集和預(yù)處理過程提出專門的規(guī)定,包括適合應(yīng)用的數(shù)據(jù)格式、預(yù)定的數(shù)據(jù)通信媒體和對輸入的時間要求等。對于需經(jīng)模擬轉(zhuǎn)換或數(shù)字轉(zhuǎn)換處理的數(shù)據(jù)量,要給出轉(zhuǎn)換方法和轉(zhuǎn)換因子等有關(guān)信息,以便軟件系統(tǒng)使用這些數(shù)據(jù)。
D.3.4影響
說明這些數(shù)據(jù)要求對于設(shè)備、軟件、用戶、開發(fā)單位所可能產(chǎn)生的影響,例如要求用戶單位增設(shè)某個機構(gòu)等。附錄E
概要設(shè)計說明書的編寫提示
E.1引言
E.1.1編寫目的
說明編寫這份概要設(shè)計說明書的目的,指出預(yù)期的讀者。
E.1.2背景
說明:
a.待開發(fā)軟件系統(tǒng)的名稱;
b.列出此工程的任務(wù)提出者、開發(fā)者、用戶以及將運行該軟件的計算站〔中心〕。
E.1.3定義
列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。
E.1.4參考資料
列出有關(guān)的參考文件,如:
a.本工程的經(jīng)核準的方案任務(wù)書或合同,上級機關(guān)的批文;
b.屬于本工程的其他已發(fā)表文件;
c.本文件中各處引用的文件、資料,包括所要用到的軟件開發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位,說明能夠得到這些文件資料的來源。
E.2總體設(shè)計
E.2.1需求規(guī)定
說明對本系統(tǒng)的主要的輸入輸出工程、處理的功能性能要求,詳細的說明可參見附錄C。
E.2.2運行環(huán)境
簡要地說明對本系統(tǒng)的運行環(huán)境〔包括硬件環(huán)境和支持環(huán)境〕的規(guī)定,詳細說明參見附錄C。
E.2.3根本設(shè)計概念和處理流程
說明本系統(tǒng)的根本設(shè)計概念和處理流程,盡量使用圖表的形式。
E.2.4結(jié)構(gòu)
用一覽表及框圖的形式說明本系統(tǒng)的系統(tǒng)元素〔各層模塊、子程序、公用程序等〕的劃分,扼要說明每個系統(tǒng)元素的標識符和功能,分層次地給出各元素之間的控制與被控制關(guān)系.
E.2.5功能器求與程序的關(guān)系
本條用一張如下的矩陣圖說明各項功能需求的實現(xiàn)同各塊程序的分配關(guān)系:
E.2.6人工處理過程
說明在本軟件系統(tǒng)的工作過程中不得不包含的人工處理過程〔如果有的話〕。
E.2.7尚未問決的問題
說明在概要設(shè)計過程中尚未解決而設(shè)計者認為在系統(tǒng)完成之前必須解決的各個問題。
E.3接口設(shè)計
E.3.1用戶接口
說明將向用戶提供的命令和它們的語法結(jié)構(gòu),以及軟件的答復(fù)信息。
E.3.2外部接口
說明本系統(tǒng)同外界的所有接口的安排包括軟件與硬件之間的接口、本系統(tǒng)與各支持軟件之間的接口關(guān)系。
E.3.3內(nèi)部接口
說明本系統(tǒng)之內(nèi)的各個系統(tǒng)元素之間的接口的安排。
E.4運行設(shè)計
E.4.1運行模塊組合
說明對系統(tǒng)施加不同的外界運行控制時所引起的各種不同的運行模塊組合,說明每種運行所歷經(jīng)的內(nèi)部模塊和支持軟件。
E.4.2運行控制
說明每一種外界的運行控制的方式方法和操作步驟。
E.4.3運行時間
說明每種運行模塊組合將占用各種資源的時間。
E.5系統(tǒng)數(shù)據(jù)結(jié)構(gòu)設(shè)計
E.5.1邏輯結(jié)構(gòu)設(shè)計要點
給出本系統(tǒng)內(nèi)所使用的每個數(shù)據(jù)結(jié)構(gòu)的名稱、標識符以及它們之中每個數(shù)據(jù)項、記錄、文卷和系的標識、定義、長度及它們之間的層次的或表格的相互關(guān)系。
E.5.2物理結(jié)構(gòu)設(shè)計要點
給出本系統(tǒng)內(nèi)所使用的每個數(shù)據(jù)結(jié)構(gòu)中的每個數(shù)據(jù)項的存儲要求,訪問方法、存取單位、存取的物理關(guān)系〔索引、設(shè)備、存儲區(qū)域〕、設(shè)計考慮和保密條件。
E.5.3數(shù)據(jù)結(jié)構(gòu)與程序的關(guān)系
說明各個數(shù)據(jù)結(jié)構(gòu)與訪問這些數(shù)據(jù)結(jié)構(gòu)的形式:
E.6系統(tǒng)出錯處理設(shè)計
E.6.1出錯信息
用一覽表的方式說朗每種可能的出錯或故障情況出現(xiàn)時,系統(tǒng)輸出信息的形式、含意及處理方法。
E.6.2補救措施
說明故障出現(xiàn)后可能采取的變通措施,包括:
a.后備技術(shù)說明準備采用的后備技術(shù),當原始系統(tǒng)數(shù)據(jù)萬一喪失時啟用的副本的建立和啟動的技術(shù),例如周期性地把磁盤信息記錄到磁帶上去就是對于磁盤媒體的一種后備技術(shù);
b.降效技術(shù)說明準備采用的后備技術(shù),使用另一個效率稍低的系統(tǒng)或方法來求得所需結(jié)果的某些局部,例如一個自動系統(tǒng)的降效技術(shù)可以是手工操作和數(shù)據(jù)的人工記錄;
c.恢復(fù)及再啟動技術(shù)說明將使用的恢復(fù)再啟動技術(shù),使軟件從故障點恢復(fù)執(zhí)行或使軟件從頭開始重新運行的方法。
E.6.3系統(tǒng)維護設(shè)計
說明為了系統(tǒng)維護的方便而在程序內(nèi)部設(shè)計中作出的安排,包括在程序中專門安排用于系統(tǒng)的檢查與維護的檢測點和專用模塊。各個程序之間的對應(yīng)關(guān)系,可采用如下的矩陣圖的形式;
附錄F
詳細設(shè)計說明書的編寫提示
F.1引言
F.1.1編寫目的
說明編寫這份詳細設(shè)計說明書的目的,指出預(yù)期的讀者。
F.1.2背景
說明:
a.待開發(fā)軟件系統(tǒng)的名稱;
b.本工程的任務(wù)提出者、開發(fā)者、用戶和運行該程序系統(tǒng)的計算中心。
F.1.3定義
列出本文件中用到專門術(shù)語的定義和外文首字母組詞的原詞組。
F.1.4參考資料
列出有關(guān)的參考資料,如:
a.本工程的經(jīng)核準的方案任務(wù)書或合同、上級機關(guān)的批文;
b.屬于本工程的其他已發(fā)表的文件;
c.本文件中各處引用到的文件資料,包括所要用到的軟件開發(fā)標準。列出這些文件的標題、文件編號、發(fā)表日期和出版單位,說明能夠取得這些文件的來源。
F.2程序系統(tǒng)的結(jié)構(gòu)
用一系列圖表列出本程序系統(tǒng)內(nèi)的每個程序〔包括每個模塊和子程序〕的名稱、標識符和它們之間的層次結(jié)構(gòu)關(guān)系。
F.3程序1〔標識符〕設(shè)計說明
從本章開始,逐個地給出各個層次中的每個程序的設(shè)計考慮。以下給出的提綱是針對一般情況的。對于一個具體的模塊,尤其是層次比較低的模塊或子程序,其很多條目的內(nèi)容往往與它所隸屬的上一層模塊的對應(yīng)條目的內(nèi)容相同,在這種情況下,只要簡單地說明這一點即可。
F.3.1程序描述
給出對該程序的簡要描述,主要說明安排設(shè)計本程序的目的意義,并且,還要說明本程序的特點〔如是常駐內(nèi)存還是非常駐?是否子程序?是可重人的還是不可重人的?有無覆蓋要求?是順序處理還是并發(fā)處理卜…..等〕。
F.3.2功能
說明該程序應(yīng)具有的功能,可采用IPO圖〔即輸入一處理一輸出圖〕的形式。
F.3.3性能
說明對該程序的全部性能要求,包括對精度、靈巧性和時間特性的要求。
F.3.4輸人項
給出對每一個輸入項的特性,包括名稱、標識、數(shù)據(jù)的類型和格式、數(shù)據(jù)值的有效范圍、輸入的方式。數(shù)量和頻度、輸入媒體、輸入數(shù)據(jù)的來源和平安保密條件等等。
F.3.5輸出項
給出對每一個輸出項的特性,包括名稱、標識、數(shù)據(jù)的類型和格式,數(shù)據(jù)值的有效范圍,輸出的形式、數(shù)量和頻度,輸出媒體、對輸出圖形及符號的說明、平安保密條件等等。
F.3.6算法
詳細說明本程序所選用的算法,具體的計算公式和計算步驟。
F.3.7流程邏輯
用圖表〔例如流程圖、判定表等〕輔以必要的說明來表示本程序的邏輯流程。
F.3.8接口
用圖的形式說明本程序所隸屬的上一層模塊及隸屬于本程序的下一層模塊、子程序,說明參數(shù)賦值和調(diào)用方式,說明與本程序相直接關(guān)聯(lián)的數(shù)據(jù)結(jié)構(gòu)〔數(shù)據(jù)庫、數(shù)據(jù)文卷〕。
F.3.9存儲分配
根據(jù)需要,說明本程序的存儲分配。
F.3.10注釋設(shè)計
說明準備在本程序中安排的注釋,如:
a.加在模塊首部的注釋;
b.加在各分枝點處的注釋;對各變量的功能、范圍、缺省條件等所加的注釋;
d.對使用的邏輯所加的注釋等等。
F.3.11限制條件
說明本程序運行中所受到的限制條件。
F.3.12測試方案
說明對本程序進行單體測試的方案,包括對測試的技術(shù)要求、輸入數(shù)據(jù)、預(yù)期結(jié)果、進度安排、人員職責、設(shè)備條件驅(qū)動程序及樁模塊等的規(guī)定。
F.3.13尚未解決的問題
說明在本程序的設(shè)計中尚未解決而設(shè)計者認為在軟件完成之前應(yīng)解決的問題。
F.4程序2〔標識符〕設(shè)計說明
用類似F.3的方式,說明第2個程序乃至第N個程序的設(shè)計考慮。
......
附錄G
數(shù)據(jù)庫設(shè)計說明書的編寫提示
G.1引言
G.1.1編寫目的
說明編寫這份數(shù)據(jù)庫設(shè)計說明書的目的,指出預(yù)期的讀者。
G.1.2背景
說明:
a.說明待開發(fā)的數(shù)據(jù)庫的名稱和使用此數(shù)據(jù)庫的軟件系統(tǒng)的名稱;
b.列出該軟件系統(tǒng)開發(fā)工程的任務(wù)提出者、用戶以及將安裝該軟件和這個數(shù)據(jù)庫的計算站〔中心〕。
G.1.3定義
列出本文件中用到的專門術(shù)語的定義、外文首字母組詞的原詞組。
G.1.4參考資料
列出有關(guān)的參考資料:
a.本工程的經(jīng)核準的方案任務(wù)書或合同、上級機關(guān)批文;
b.屬于本工程的其他已發(fā)表的文件;
c.本文件中各處引用到的文件資料,包括所要用到的軟件開發(fā)標準。
列出這些文件的標題、文件編號、發(fā)表日期和出版單位,說明能夠取得這些文件的來源。
G.2外部設(shè)計
G.2.1標識符和狀態(tài)
聯(lián)系用途,詳細說明用于唯一地標識該數(shù)據(jù)庫的代碼、名稱或標識符,附加的描述性信息亦要給出。如果該數(shù)據(jù)庫屬于尚在實驗中、尚在測試中或是暫時使用的,那么要說明這一特點及其有效
溫馨提示
- 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負責。
- 6. 下載文件中如有侵權(quán)或不適當內(nèi)容,請與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 《丙肝規(guī)范治療》課件
- 2025年呼和浩特貨運從業(yè)資格證年考試題目及答案
- 2025年通遼道路客貨運輸從業(yè)資格證模擬考試下載
- 情感教育在職業(yè)中專英語課堂教學中的作用
- 紫色插畫風小學故事分享會主題
- 培訓成果與計劃匯報模板
- 銀行產(chǎn)品創(chuàng)新訓練模板
- DeepSeek學習科普專題解析
- 2025年低溫巴氏乳項目合作計劃書
- 工裝內(nèi)裝冬季施工方案設(shè)計
- GB/T 4706.30-2024家用和類似用途電器的安全第30部分:廚房機械的特殊要求
- 食品安全管理制度可打印【7】
- 2024年山東省東營市中考數(shù)學試題 (原卷版)
- 2024全國能源行業(yè)火力發(fā)電集控值班員理論知識技能競賽題庫(多選題)
- 2024年山東新華書店集團限公司臨沂市縣分公司招聘錄取人員(高頻重點提升專題訓練)共500題附帶答案詳解
- 公司員工外派協(xié)議書范文
- 2024年四川省南充市中考物理試卷真題(含官方答案)
- 信息科技重大版 七年級上冊 互聯(lián)網(wǎng)應(yīng)用與創(chuàng)新 第二單元教學設(shè)計 互聯(lián)網(wǎng)原理
- 【基于PLC的停車場車位控制系統(tǒng)設(shè)計11000字(論文)】
- 手術(shù)患者手術(shù)部位標識制度
- 運輸安全生產(chǎn)知識培訓試卷
評論
0/150
提交評論