【項(xiàng)目管理知識】軟件文檔計算機(jī)軟件質(zhì)量保證計劃規(guī)范

1、軟件文檔 :計算機(jī)軟件質(zhì)量保證計劃規(guī)范1 主題內(nèi)容與適用范圍本規(guī)范規(guī)定了在制訂軟件質(zhì)量保證計劃時應(yīng)該遵循的統(tǒng)一的基本要求。本規(guī)范適用于軟件特別是重要軟件的質(zhì)量保證計劃的制訂工作。對于非重 要軟件或已經(jīng)開發(fā)好的軟件，可以采用本規(guī)范規(guī)定的要求的子集。2 引用標(biāo)準(zhǔn)GB/T11457軟件工程術(shù)語GB8566計算機(jī)軟件開發(fā)規(guī)范GB8567計算機(jī)軟件產(chǎn)品開發(fā)文件編制指南GB/T12505計算機(jī)軟件配置管理計劃規(guī)范3 術(shù)語面給出本規(guī)范中用到的一些術(shù)語的定義，其他術(shù)語的定義按GB/T11457。3.1 項(xiàng)目委托單位 projectentrustorganization項(xiàng)目委托單位是指為產(chǎn)品開發(fā)提供資金并通常也

2、是（但有時也未必）確定 產(chǎn)品需求的單位或個人。3.2 項(xiàng)目承辦單位 projectundertakingorganization項(xiàng)目承辦單位是指為項(xiàng)目委托單位開發(fā)、購置或選用軟件產(chǎn)品的單位或個 人。3.3 軟件開發(fā)單位 softwaredevelopmentorganization軟件開發(fā)單位是指直接或間接受項(xiàng)目委托單位委托而直接負(fù)責(zé)開發(fā)軟件的 單位或個人。3.4 用戶 user用戶是指實(shí)際使用軟件來完成某項(xiàng)計算、控制或數(shù)據(jù)處理等任務(wù)的單位或 個人。3.5 軟件 software軟件是指計算機(jī)程序及其有關(guān)的數(shù)據(jù)和文檔，也包括固化了的程序。3.6 重要軟件 criticalsoftware重要軟

3、件是指它的故障會影響到人身安全會導(dǎo)致重大經(jīng)濟(jì)損失或社會損失 的軟件。3.7 軟件生存周期 softwarelifecycle軟件生存周期是指從系統(tǒng)設(shè)計對計算機(jī)軟件系統(tǒng)提出應(yīng)用需求開始，經(jīng)過 開發(fā)，產(chǎn)生一個滿足需求的計算機(jī)軟件系統(tǒng)，然后投入運(yùn)行，直至該軟件系統(tǒng) 退役為止。其間經(jīng)歷系統(tǒng)分析與軟件定義、軟件開發(fā)以及系統(tǒng)的運(yùn)行與維護(hù)第 三個階段。其中軟件開發(fā)階段一般又劃分成需求分析、概要設(shè)計、詳細(xì)設(shè)計、 編碼與單元測試、組裝與系統(tǒng)測試以及安裝與驗(yàn)收等六個階段。3.8 驗(yàn)證 verification驗(yàn)證是指確定軟件開發(fā)周期中的一個給定階段的產(chǎn)品是否達(dá)到上一階段確 立的需求的過程。3.9 確認(rèn) valid

4、ation確認(rèn)是指在軟件開發(fā)過程結(jié)束時對軟件進(jìn)行評價以確定它是否和軟件需求 相一致的過程。3.10 測試 testing測試是指通過執(zhí)行程序來有意識地發(fā)現(xiàn)程序中的設(shè)計錯誤和編碼錯誤的過 程。測試是驗(yàn)證和確認(rèn)的手段之一。3.11 軟件質(zhì)量 softwarequality軟件質(zhì)量是指軟件產(chǎn)品中能滿足給定需求的各種特性的總和。這些特性稱 做質(zhì)量特性，它包括功能度、可靠性、易使用性、時間經(jīng)濟(jì)性、資源經(jīng)濟(jì)性、 可維護(hù)性和可移植性等。3.12 質(zhì)量保證 qualityassurance質(zhì)量保證是指為使軟件產(chǎn)品符合規(guī)定需求所進(jìn)行的一系列有計劃的必要工 作。4 軟件質(zhì)量保證計劃編制大綱項(xiàng)目承辦單位（或軟件開發(fā)

5、單位）中負(fù)責(zé)軟件質(zhì)量保證的機(jī)構(gòu)或個人，必 須制訂一個包括以下各章內(nèi)容的軟件質(zhì)量保證計劃（以下簡稱計劃）。各章應(yīng) 以所給出的順序排列；如果某章中沒有相應(yīng)的內(nèi)容，則在該章標(biāo)題之后必須注 明“本章無內(nèi)容 ”的字樣，并附上相應(yīng)的理由；如果需要，可以在后面增加章 條；如果某些材料已經(jīng)出現(xiàn)在其他文檔中，則在該計劃中應(yīng)引用那些文檔。計 劃的封面必須標(biāo)明計劃名和該計劃所屬的項(xiàng)目名，并必須由項(xiàng)目委托單位和項(xiàng) 目承辦單位（或軟件開發(fā)單位）的代表共同簽字、批準(zhǔn)。計劃的目次是：引言管理文檔標(biāo)準(zhǔn)、條例和約定評審和檢查軟件配置管理工具、技術(shù)和方法媒體控制對供貨單位的控制記錄的收集、維護(hù)和保存面給出軟件質(zhì)量保證計劃的各個章

6、條必須具有的內(nèi)容。4.1 引言4.1.1 目的本條必須指出特定的軟件質(zhì)量保證計劃的具體目的。還必須指出該計劃所 針對的軟件項(xiàng)目（及其所屬的各個子項(xiàng)目）的名稱和用途。4.1.2 定義和縮寫詞本條應(yīng)該列出計劃正文中需要解釋的而在GB/T11457中尚未包含的術(shù)語的定義，必要時，還要給出這些定義的英文單詞及其縮寫詞。4.1.3 參考資料本條必須列出計劃正文中所引用資料的名稱、代號、編號、出版機(jī)構(gòu)和出 版年月。4.2 管理必須描述負(fù)責(zé)軟件質(zhì)量保證的機(jī)構(gòu)，任務(wù)及其有關(guān)的職責(zé)。4.2.1 機(jī)構(gòu)本條必須描述與軟件質(zhì)量保證有關(guān)的機(jī)構(gòu)的組成。還必須清楚地描述來自 項(xiàng)目委托單位、項(xiàng)目承辦單位、軟件開發(fā)單位或用戶中

7、負(fù)責(zé)軟件質(zhì)量保證的各 個成員在機(jī)構(gòu)中的西相互關(guān)系。4.2.2 任務(wù)本條必須描述計劃所涉及的軟件生存周期中有關(guān)階段的任務(wù)，特別要把重 點(diǎn)放在描述這些階段所應(yīng)進(jìn)行的軟件質(zhì)量保證活動上。4.2.3 職責(zé)本條必須指明軟件質(zhì)量保證計劃中規(guī)定的每一個任務(wù)的負(fù)責(zé)單位或成員的 責(zé)任。4.3 文檔必須列出在該軟件的開發(fā)、驗(yàn)證與確認(rèn)以及使用與維護(hù)等階段中需要編制 的文檔，并描述對文檔進(jìn)行評審與檢查的準(zhǔn)則。為了確保軟件的實(shí)現(xiàn)滿足需求，至少需要下列基本文檔：4.3.1.1 軟件需求規(guī)格說明書 softwarerequirementsspecification軟件需求規(guī)格說明書必須清楚、準(zhǔn)確地描述軟件的每一個基本需求（

8、功 能、性能、設(shè)計約束和屬性）和外部界面。必須把每一個需求規(guī)定成能夠通過 預(yù)先定義的方法（例如檢查、分析、演示或測試等）被客觀地驗(yàn)證與確認(rèn)的形 式。軟件需求規(guī)格說明書的詳細(xì)格式按 GB8567。4.3.1.2 軟件設(shè)計說明書 softwaredesigndescription軟件設(shè)計說明書應(yīng)該包括軟件概要設(shè)計說明和軟件詳細(xì)設(shè)計說明兩部分。其概要設(shè)計部分必須描述所設(shè)計軟件的總體結(jié)構(gòu)、外部接口、各個主要部件的 功能與數(shù)據(jù)結(jié)構(gòu)以及各主要部件之間的接口；必要時還必須對主要部件的每一 個子部件進(jìn)行描述。其詳細(xì)設(shè)計部分必須給出每一個基本部件的功能、算法和 過程描述。軟件設(shè)計說明書的詳細(xì)格式按 GB8567

9、。4.3.1.3 軟件驗(yàn)證與確認(rèn)計劃 softwareverificationandvalidationplan軟件驗(yàn)證與確認(rèn)計劃必須描述所采用的軟件驗(yàn)證和確認(rèn)方法（例如評審、 檢查、分析、演示或測試等），以用來難軟件需求規(guī)格說明書中的需求是否已 由軟件設(shè)計說明書描述的設(shè)計實(shí)現(xiàn)；軟件設(shè)計說明書表達(dá)的設(shè)計是否已由編碼 實(shí)現(xiàn)。軟件驗(yàn)證與確認(rèn)計劃還可用來確認(rèn)編碼的執(zhí)行是否與軟件需求規(guī)格說明書中所規(guī)定的需求相一致。軟件驗(yàn)證與確認(rèn)計劃的詳細(xì)格式按GB8567中的測試計劃的格式。4.3.1.4 軟件難和確認(rèn)報告 softwareverificationandvalidationreport軟件驗(yàn)證與確認(rèn)報

10、告必須描述軟件驗(yàn)證與確認(rèn)計劃的執(zhí)行結(jié)果。這里必須 包括軟件質(zhì)量保證計劃所需要的所有評審、檢查和測試的結(jié)果。軟件驗(yàn)證與確 認(rèn)報告的詳細(xì)格式按GB8567中的測試報告的格式。4.3.1.5用戶文檔 userdocumentation用戶文檔（例如手冊、指南等）必須指明成功運(yùn)行該軟件所需要的數(shù)據(jù)、 控制命令以及運(yùn)行條件等；必須指明所有的出錯信息、含義及其修改方法；還 必須描述將用戶發(fā)現(xiàn)的錯誤或問題通知項(xiàng)目承辦單位（或軟件開發(fā)單位）或項(xiàng)目委托單位的方法。用戶文檔的詳細(xì)格式按GB8567。 4.3.2 其他文檔除基本文檔外，還應(yīng)包括下列文檔：a.項(xiàng)目實(shí)施計劃（其中可包括軟件配置管理計劃，但在必要時也可單

11、獨(dú)制訂該計劃）：其詳細(xì)格式按 GB8567。b.項(xiàng)目進(jìn)展報表：其詳細(xì)格式可參考本規(guī)范附錄 B （參考件）中有關(guān)項(xiàng)目 進(jìn)展報表的各項(xiàng)規(guī)定。C.項(xiàng)目開發(fā)各個階段的評審報表：其詳細(xì)格式可參考本規(guī)范附錄C （參考 件）中有關(guān)項(xiàng)目階段評審表的各項(xiàng)規(guī)定。d.項(xiàng)目開發(fā)總結(jié)：其詳細(xì)格式按 GB8567。4.4 標(biāo)準(zhǔn)、條例和約定必須列出軟件開發(fā)過程中要用到的標(biāo)準(zhǔn)、條例和約定，并列出監(jiān)督和保證 書執(zhí)行的措施。必須規(guī)定所要進(jìn)行的技術(shù)和管理兩方面的評審和檢查工作，并編制或引用 有關(guān)的評審和檢查堆積以及通過與否的技術(shù)準(zhǔn)則。至少要進(jìn)行下列各項(xiàng)評審和 檢查工作：4.5.1 軟件需求評審 softwarerequiremen

12、tsreview在軟件需求分析階段結(jié)束后必須進(jìn)行軟件需求評審，以確保在軟件需求規(guī) 格說明書中所規(guī)定的各項(xiàng)需求的合適性。4.5.2 概要設(shè)計評審 preliminarydesignreview在軟件概要設(shè)計結(jié)束后必須進(jìn)行概要設(shè)計評審，以評價軟件設(shè)計說明書中 所描述的軟件概要設(shè)計的總體結(jié)構(gòu)、外部接口、主要部件功能分配、全局?jǐn)?shù)據(jù) 結(jié)構(gòu)以及各主要部件之間的接口等方面的合適性。4.5.3 詳細(xì)設(shè)計評審 detaileddesignreview在軟件詳細(xì)設(shè)計階段結(jié)束后必須進(jìn)行詳細(xì)設(shè)計評審，以確定軟件設(shè)計說明 書中所描述的詳細(xì)設(shè)計在功能、算法和過程描述等方面的合適性。4.5.4 軟件驗(yàn)證與確認(rèn)評審 soft

13、wareverificationandvalidationreview在制訂軟件驗(yàn)證與確認(rèn)計劃之后要對它進(jìn)行評審，以評價軟件驗(yàn)證與確認(rèn)計劃中所規(guī)定的驗(yàn)證與確認(rèn)方法的合適性與完整性。4.5.5 功能檢查 functionalaudit在軟件釋放前，要對軟件進(jìn)行功能檢查，以確認(rèn)已經(jīng)滿足在軟件需求規(guī)格 說明書中規(guī)定的所有需求。4.5.6 物理檢查 physicalaudit在驗(yàn)收軟件前，要對軟件進(jìn)行物理檢查，以驗(yàn)證程序和文檔已經(jīng)一致并已做好了交付的準(zhǔn)備。在軟件驗(yàn)收時，要允許用戶或用戶所委托的專家對所要驗(yàn)收的軟件進(jìn)行設(shè)計抽樣的綜合檢查，以驗(yàn)證代碼和設(shè)計文檔的一致性、接口規(guī)格說明之間的一致性（硬件和軟件

14、）、設(shè)計實(shí)現(xiàn)和功能需求的一致性、功能需求和測試描述的致性。4.5.8 管理評審managementreviews要對計劃的執(zhí)行情況定期（或按階段）進(jìn)行管理評審；這些評審必須由獨(dú)立于被評審單位的機(jī)構(gòu)或授權(quán)的第三方主持進(jìn)行。4.6 軟件配置管理必須編制有關(guān)軟件配置管理的條款，或引用按照GB/T12505單獨(dú)制訂的文檔。在這些條款或文檔中，必須規(guī)定用于標(biāo)識軟件產(chǎn)品、控制和實(shí)現(xiàn)軟件的修改、記錄和報告修改實(shí)現(xiàn)的狀態(tài)以及評審和檢查配置管理工作等四方面的活動。還必須規(guī)定用以維護(hù)和存儲軟件受控版本的方法和設(shè)施；必須規(guī)定對所發(fā)現(xiàn)的軟件問題進(jìn)行報告、追蹤和解決的步驟，并指出實(shí)現(xiàn)報告、追蹤和解決軟件問題的機(jī)構(gòu)及其職責(zé)。4.7 工具、技術(shù)和方法必須指明用以支持特定軟件項(xiàng)目質(zhì)量保證工作的工具、技術(shù)和方法，指出它們的目的，描述它們的用途。4.8 媒體控制必須指出保護(hù)計算機(jī)程序物理媒體的方法和設(shè)施，以免非法