包括技術(shù)標(biāo)和商務(wù)標(biāo)兩部分。
上面幾份文檔,是項(xiàng)目前期準(zhǔn)備時(shí)需要的,是側(cè)重于售前方面的;而下面的文檔是軟件開發(fā)過程中必不可少的,我們按開發(fā)工作的時(shí)間順序一一介紹。
5、《需求分析說明書》
對(duì)于軟件開發(fā)來說,《需求分析說明書》就好像是蓋樓時(shí)所用的圖紙,是最重要的文檔,由項(xiàng)目經(jīng)理對(duì)客戶相關(guān)部門進(jìn)行業(yè)務(wù)調(diào)研后編寫,語言側(cè)重于從業(yè)務(wù)的角度描述功能需求。內(nèi)容涉及三大部分,其一,編寫目的、背景、目標(biāo)任務(wù)等公共性語言;其二,功能性需求,將業(yè)務(wù)梳理成幾大功能模塊,一級(jí)功能下細(xì)分二級(jí)功能,依次類推,將最終細(xì)化的功能按描述、輸入、處理和輸出進(jìn)行詳細(xì)描述;其三,非功能性需求,包括性能、處理能力、進(jìn)度、界面設(shè)計(jì)和運(yùn)行環(huán)境的規(guī)定。
6、《數(shù)據(jù)庫設(shè)計(jì)說明書》
我是做數(shù)據(jù)庫出身,因此這部分的工作也是由我這個(gè)項(xiàng)目經(jīng)理來做,根據(jù)《需求分析說明書》在Erwin建模工具中設(shè)計(jì)好邏輯模型和物理模型,然后將其整理到此文檔中,文檔還包含數(shù)據(jù)庫所有的表結(jié)構(gòu)和相關(guān)的字段說明。
7、《概要設(shè)計(jì)說明書》
說實(shí)話,在我做過的項(xiàng)目中,沒有編寫過此文檔,因?yàn)槲矣X得《需求分析說明書》和《詳細(xì)設(shè)計(jì)說明書》就足矣了。甚至如果項(xiàng)目簡(jiǎn)單或時(shí)間緊急,《詳細(xì)設(shè)計(jì)說明書》都會(huì)省略:)。
8、《詳細(xì)設(shè)計(jì)說明書》
主要包含兩部分內(nèi)容,其一,體系結(jié)構(gòu)的設(shè)計(jì),也就是項(xiàng)目所采用的幾層架構(gòu),以及層與層之間的通信機(jī)制,還有就是基礎(chǔ)框架所采用的技術(shù);其二,是本文檔的核心部分,包括每個(gè)細(xì)分模塊的詳細(xì)設(shè)計(jì)說明,包括程序描述、功能、性能、輸入項(xiàng)、輸出項(xiàng)、算法、流程邏輯、接口、存儲(chǔ)分配、注釋設(shè)計(jì)、限制條件、測(cè)試計(jì)劃和尚未解決的問題等內(nèi)容。本說明書對(duì)項(xiàng)目所采用的技術(shù)和接口都做了詳細(xì)的規(guī)定,是指導(dǎo)程序員開發(fā)的直接工具。但需要說明的是,很多項(xiàng)目由于時(shí)間原因,都忽略了此說明書的編寫,包括本人目前在做的項(xiàng)目也是如此,因此本文檔并不是必須的。但如果作為給客戶的交付物,需要在項(xiàng)目完成后補(bǔ)全。
9、《計(jì)劃進(jìn)度》
這個(gè)不用多說,由項(xiàng)目經(jīng)理編寫,實(shí)現(xiàn)對(duì)項(xiàng)目進(jìn)度的嚴(yán)格把控,是項(xiàng)目必須的文檔,可用project編寫。
10、《測(cè)試用例》
測(cè)試用例(Test Case)目前沒有經(jīng)典的定義。比較通常的說法是:指對(duì)一項(xiàng)特定的軟件產(chǎn)品進(jìn)行測(cè)試任務(wù)的描述,體現(xiàn)測(cè)試方案、方法、技術(shù)和策略。內(nèi)容包括測(cè)試目標(biāo)、測(cè)試環(huán)境、輸入數(shù)據(jù)、測(cè)試步驟、預(yù)期結(jié)果、測(cè)試腳本等,并形成文檔。它是將軟件測(cè)試的行為活動(dòng)做一個(gè)科學(xué)化的組織歸納.目的是能夠?qū)④浖y(cè)試的行為轉(zhuǎn)化成可管理的模式;同時(shí)測(cè)試用例也是將測(cè)試具體量化的方法之一。由此可見,《測(cè)試用例》非常重要,是對(duì)項(xiàng)目或產(chǎn)品質(zhì)量的嚴(yán)格保證,但由于測(cè)試人員和項(xiàng)目組的規(guī)范性、時(shí)間進(jìn)度等限制,本文檔在本地區(qū)的實(shí)際項(xiàng)目中也很少應(yīng)用,至少我認(rèn)識(shí)的很多測(cè)試人員中,只有極少數(shù)的項(xiàng)目中會(huì)編寫此文檔。
11、《測(cè)試結(jié)果》
在項(xiàng)目開發(fā)階段使用,也就是交付客戶之前。文檔為Excel格式,并提供關(guān)鍵字段的數(shù)據(jù)篩選,內(nèi)容包括描述、缺陷類型(Bug、需求)、開發(fā)人員、狀態(tài)、關(guān)閉時(shí)間、所屬模塊、提交人、解決人、備注等。其中狀態(tài)包含提交、解決和確認(rèn)解決,測(cè)試人員將問題提交(紅色),當(dāng)程序員解決后就置為解決(黃色),測(cè)試人員再次確認(rèn)無誤后,就修改狀態(tài)為確認(rèn)解決(綠色),并且添寫關(guān)閉時(shí)間。
12、《需求變更文檔》
產(chǎn)品交付客戶之后使用。任何一個(gè)好軟件,不是