第22章 規(guī)格書與模板
? ? ? ?將前述所有章節(jié)的交付物成果進(jìn)行匯總，形成一套包括各個階段的分析與設(shè)計資料的規(guī)格書，建立起軟件工程的各個階段與交付物的關(guān)聯(lián)關(guān)系。
22.1 需求調(diào)研
22.1.1 交付資料說明
????????需求調(diào)研階段的成果匯總為需求調(diào)研資料匯總，也就是將所有的調(diào)研成果匯總成冊，主要內(nèi)容如下（不限于此）。
????????（1）背景資料：通過從客戶的網(wǎng)站、印刷資料、人員交流等方式獲得的客戶相關(guān)資料。
????????（2）問卷資料：調(diào)研前向客戶發(fā)出的問卷。
????????（3）現(xiàn)狀構(gòu)成圖：客戶提供的或是根據(jù)客戶現(xiàn)狀繪制的業(yè)務(wù)框架圖、流程圖等。
????????（4）訪談記錄：用文字記錄的客戶需求（目標(biāo)／業(yè)務(wù)／功能需求、難度、痛點等）。
????????（5）既存表單：收集客戶日常用各類報表、單據(jù)以及分析資料等（電子、紙質(zhì)）。
????????（6）需求4件套：針對部分已知的功能需求做的詳細(xì)記錄。其中，（3）～（6）項為需求分析階段的正式輸入資料。
22.1.2 圖——現(xiàn)狀構(gòu)成圖
????????現(xiàn)狀構(gòu)成圖包括業(yè)務(wù)和管理兩個方面的內(nèi)容
????????1．現(xiàn)狀構(gòu)成圖
? ? ? ? 記錄客戶現(xiàn)狀的模型主要有兩類，即：
? ? ? ? （1）業(yè)務(wù)類（業(yè)務(wù)架構(gòu)模型）：框架圖、分解圖和流程圖；
? ? ? ? （2）管理類（管理架構(gòu)圖）
????????2．現(xiàn)狀構(gòu)成圖一覽
????????對于收集和繪制的現(xiàn)狀構(gòu)成進(jìn)行整理，形成現(xiàn)狀構(gòu)成圖一覽
22.1.3 文——訪談記錄
????????文字記錄的資料重點有調(diào)研前的問卷和訪談記錄兩類。
????????1．需求調(diào)研問卷（模板）問卷模板可以采用兩種形式，一種是以填寫為主，另外一種是以選擇為主。根據(jù)內(nèi)容判斷采用哪一種
????????2．訪談記錄一覽（模板）訪談記錄用的模板與記錄一覽可合為一體，形成訪談記錄一覽。
22.1.4 表——既存表單
????????1．資料收集
????????將收集到的原始資料在現(xiàn)場進(jìn)行分析，并給出關(guān)系分析圖。
????????2．既存表單一覽
????????將收集到的既存表單匯總成一覽
22.1.5 需求4件套
????????在現(xiàn)場對既存表單等進(jìn)行詳細(xì)記錄（采用需求4件套的形式）
22.2 需求分析
22.2.1 交付資料說明
????????需求調(diào)研階段的交付物是需求規(guī)格說明書，也就是將所有的調(diào)研成果匯總成冊，主要的內(nèi)容如下（不限于此）。
????????（1）需求規(guī)格說明書／解決方案。
????????（2）功能需求一覽。
????????（3）需求調(diào)研資料匯總：需求調(diào)研的階段成果。
????????（4）需求分析過程資料：目標(biāo)需求→業(yè)務(wù)需求→功能需求的轉(zhuǎn)換過程記錄。
????????其中，（1）～（3）項為概要設(shè)計階段的正式輸入資料；（4）為參考資料，它的轉(zhuǎn)換結(jié)果已經(jīng)歸入到功能需求一覽中。
22.2.2 需求規(guī)格說明書
????????需求工程的結(jié)束是以完成需求規(guī)格說明書為標(biāo)志的。需求規(guī)格說明書是基于需求調(diào)研和分析的成果匯總而成的，它是客戶和軟件開發(fā)者雙方之間關(guān)于待開發(fā)系統(tǒng)的共同認(rèn)知，它是后續(xù)系統(tǒng)的設(shè)計、開發(fā)以及驗收的依據(jù)。一般來說，需求規(guī)格說明書中要包含對軟件和硬件兩方面的要求，由于本書的主題是分析與設(shè)計，因此只涉及在需求工程中講到的內(nèi)容和成果。另外，需求規(guī)格說明書對于不同的軟件企業(yè)有不同形式的模板，但不論是什么樣的模板，處于模板核心位置的都是需求工程中介紹到的內(nèi)容。這部分內(nèi)容是客戶投資信息化系統(tǒng)的核心需求，也是后續(xù)設(shè)計工程中主要的設(shè)計對象，是帶來最大客戶價值的部分。以下需求規(guī)格說明書的框架中主要包括與軟件的業(yè)務(wù)設(shè)計、應(yīng)用設(shè)計相關(guān)的需求。這個框架僅作為參考，實際使用時需要另行加入其他部分（包括：技術(shù)、硬件）的內(nèi)容。需求規(guī)格說明書至少要包含4個核心部分，各部分的重點如下。
????????第一部分 引言：所有需要在事前聲明的內(nèi)容，如前言、原則、定義、范圍等信息。
????????第二部分 背景：直接來源于客戶的主觀信息，如背景、現(xiàn)狀、目標(biāo)、期望等信息。
????????第三部分 需求：對需求的綜合描述，這些內(nèi)容是設(shè)計工程的輔助參考信息。
????????第四部分 功能：對需求分析成果的羅列，它們是設(shè)計工程的主要依據(jù)信息。
????????注：需求規(guī)格說明書與設(shè)計規(guī)格書的區(qū)別
????????需求規(guī)格說明書是需求工程完成時的交付物，這個階段只是對需求進(jìn)行了梳理、匯集、分析，但是并未對需求按照軟件設(shè)計的標(biāo)準(zhǔn)進(jìn)行設(shè)計。它是設(shè)計規(guī)格書的輸入。設(shè)計工程的設(shè)計規(guī)格書是對需求規(guī)格說明書的內(nèi)容按照軟件設(shè)計標(biāo)準(zhǔn)進(jìn)行的設(shè)計成果。它是對后續(xù)技術(shù)設(shè)計、開發(fā)的輸入。
22.2.3 解決方案
????????解決方案，重點是針對有“定制”的需求做出的特殊說明，項目整體是定制的對象，也可以是項目中某個部分內(nèi)容的是定制的。解決方案的重點在于說明：
????????（1）客戶最為關(guān)心的內(nèi)容，如創(chuàng)新、難點、痛點、高價值的功能等。
????????（2）開發(fā)者比其他同行的優(yōu)越之處。
????????（3）對客戶需求的解決思路、對客戶價值的認(rèn)知、設(shè)計思路／理念等。
????????解決方案與需求規(guī)格說明書兩者的區(qū)別如下。
????????（1）需求規(guī)格說明書是對需求的“規(guī)格”級說明，而且是全面詳細(xì)的。而解決方案是針對咨詢結(jié)果做出的“概要”級說明，只對客戶關(guān)心的重點進(jìn)行說明。
????????（2）兩者形成的時間順序，通常是先有解決方案（作為原則性的粗稿），在獲得客戶認(rèn)可后，再進(jìn)行深入調(diào)研之后，再繼續(xù)做出需求規(guī)格說明書。特殊情況下，也可以是在有了需求規(guī)格說明書后，從中抽取部分內(nèi)容形成解決方案，向客戶介紹他們特別關(guān)心的內(nèi)容。
22.2.4 功能需求一覽
????????需求分析完成后，最重要的輸出之一就是功能需求一覽，這個表給出了需要開發(fā)的功能需求參考，也是后期在設(shè)計、開發(fā)時判斷工作量、難度、資源以及進(jìn)度計劃的主要參考依據(jù)。
22.3 概要設(shè)計
22.3.1 交付資料說明
????????進(jìn)入設(shè)計工程后，第一階段的設(shè)計就是概要設(shè)計，概要設(shè)計階段的交付物概要設(shè)計規(guī)格書中包括三層的內(nèi)容：架構(gòu)、功能和數(shù)據(jù)，主要內(nèi)容包括以下三種。
????????（1）架構(gòu)概要規(guī)格書：業(yè)務(wù)架構(gòu)圖（拓?fù)鋱D、分層圖、框架圖、分解圖、流程圖）。
????????（2）功能概要規(guī)格書：功能的分類與分類圖、功能的規(guī)劃與關(guān)聯(lián)圖、業(yè)務(wù)功能一覽等。
????????（3）數(shù)據(jù)概要規(guī)格書：數(shù)據(jù)規(guī)劃、編號標(biāo)準(zhǔn)、數(shù)據(jù)標(biāo)準(zhǔn)、主數(shù)據(jù)。
22.3.2 架構(gòu)概要規(guī)格書
????????1．理念、主線與標(biāo)準(zhǔn)
????????架構(gòu)的概要設(shè)計包括整體設(shè)計的理念、主線，以及各類交付物的標(biāo)準(zhǔn)和規(guī)范。理念：設(shè)計師對系統(tǒng)的頂層設(shè)計的構(gòu)想、方向。主線：以價值為目標(biāo)，串聯(lián)起達(dá)成目標(biāo)的功能。標(biāo)準(zhǔn)：架構(gòu)模型在架構(gòu)設(shè)計中需要遵循的要求。
????????2．業(yè)務(wù)架構(gòu)圖
????????架構(gòu)圖主要采用5種模型。
????????3．業(yè)務(wù)架構(gòu)圖一覽
????????將完成的業(yè)務(wù)架構(gòu)圖匯總成業(yè)務(wù)架構(gòu)圖一覽
22.3.3 功能概要規(guī)格書
????????功能概要規(guī)格書主要包括兩個資料：一是功能關(guān)聯(lián)圖，二是業(yè)務(wù)功能一覽。
????????1．功能關(guān)聯(lián)圖
????????按區(qū)、線、點等進(jìn)行功能規(guī)則，繪制功能關(guān)聯(lián)圖。
????????2．業(yè)務(wù)功能一覽
????????業(yè)務(wù)功能一覽可以根據(jù)內(nèi)容的多少和復(fù)雜度，將業(yè)務(wù)功能全部歸為一個表（包括：活動、字典、看板和表單），也可以按照不同的業(yè)務(wù)功能各成一表。
????????1）業(yè)務(wù)功能一覽（合成）
????????合成的業(yè)務(wù)功能一覽
????????2）業(yè)務(wù)功能一覽（業(yè)務(wù)功能類別）
????????按不同業(yè)務(wù)功能劃分的業(yè)務(wù)功能一覽
????????活動功能一覽
????????字典功能一覽
????????看板功能一覽
????????表單功能一覽
22.3.4 數(shù)據(jù)概要規(guī)格書
????????1．?dāng)?shù)據(jù)規(guī)劃圖
????????數(shù)據(jù)規(guī)劃主要分為三個粒度：整體、領(lǐng)域和模塊
????????2．?dāng)?shù)據(jù)標(biāo)準(zhǔn)
????????（1）業(yè)務(wù)編號的標(biāo)準(zhǔn)：用文字說明編制標(biāo)準(zhǔn)。
????????（2）業(yè)務(wù)數(shù)據(jù)的標(biāo)準(zhǔn)：用文字說明編制標(biāo)準(zhǔn)。
????????（3）主數(shù)據(jù)的選擇：用文字或表說明選擇標(biāo)準(zhǔn)和結(jié)果。
22.4 詳細(xì)設(shè)計
22.4.1 交付資料說明
????????詳細(xì)設(shè)計階段的交付物詳細(xì)設(shè)計規(guī)格書的內(nèi)容包括三層的內(nèi)容：架構(gòu)、功能和數(shù)據(jù)，以及業(yè)務(wù)用例。
????????（1）業(yè)務(wù)流程規(guī)格書：業(yè)務(wù)流程的詳細(xì)設(shè)計（流程5件套）。
????????（2）業(yè)務(wù)功能規(guī)格書：業(yè)務(wù)功能的詳細(xì)設(shè)計（業(yè)務(wù)4件套）。
????????（3）業(yè)務(wù)數(shù)據(jù)規(guī)格書：包括數(shù)據(jù)關(guān)系表、數(shù)據(jù)模型（關(guān)聯(lián)圖、勾稽圖、數(shù)據(jù)線）等。
????????（4）業(yè)務(wù)用例：對概要、詳細(xì)和管理設(shè)計成果的驗證用例。
22.4.2 流程詳細(xì)規(guī)格書
????????業(yè)務(wù)流程的詳細(xì)設(shè)計成果是業(yè)務(wù)流程規(guī)格書（流程5件套）
22.4.3 功能詳細(xì)規(guī)格書
????????對于業(yè)務(wù)功能（活動、字典、看板和表單）的描述是基于需求工程的“需求4件套”進(jìn)行的詳細(xì)設(shè)計，形成“業(yè)務(wù)4件套”。
22.4.4 數(shù)據(jù)詳細(xì)規(guī)格書
????????數(shù)據(jù)的詳細(xì)設(shè)計成果主要有兩個：一是數(shù)據(jù)表關(guān)系圖，二是數(shù)據(jù)模型。
????????1．?dāng)?shù)據(jù)表關(guān)系圖
????????2．?dāng)?shù)據(jù)模型
22.4.5 業(yè)務(wù)用例
????????對概要設(shè)計、詳細(xì)設(shè)計以及管理設(shè)計的成果，用業(yè)務(wù)用例的方式進(jìn)行驗證。主要模板有兩個，一是用例導(dǎo)圖，二是用例數(shù)據(jù)推演表
22.5 應(yīng)用設(shè)計
22.5.1 交付資料說明
????????應(yīng)用設(shè)計階段的交付物應(yīng)用設(shè)計規(guī)格書的內(nèi)容包括三層的內(nèi)容：架構(gòu)、功能和數(shù)據(jù)，以及應(yīng)用用例。
????????（1）架構(gòu)應(yīng)用規(guī)格書：業(yè)務(wù)流程機(jī)制、業(yè)務(wù)架構(gòu)的轉(zhuǎn)換等。
????????（2）功能應(yīng)用規(guī)格書：對業(yè)務(wù)組件的設(shè)計（組件4件套），業(yè)務(wù)組件一覽。
????????（3）數(shù)據(jù)應(yīng)用規(guī)格書：數(shù)據(jù)復(fù)用、數(shù)據(jù)共享、數(shù)據(jù)格式轉(zhuǎn)換（文字→數(shù)字）。
????????（4）應(yīng)用用例：對應(yīng)用設(shè)計成果的驗證用例。
22.5.2 架構(gòu)應(yīng)用規(guī)格書
????????架構(gòu)的應(yīng)用設(shè)計的成果主要分為兩類：一是對業(yè)務(wù)架構(gòu)圖的轉(zhuǎn)換，二是架構(gòu)層面的各類“機(jī)制”圖設(shè)計。
????????1．業(yè)務(wù)架構(gòu)圖的轉(zhuǎn)換
????????2．架構(gòu)的機(jī)制設(shè)計圖
????????架構(gòu)的機(jī)制設(shè)計圖根據(jù)項目的復(fù)雜度而定，不是必做的內(nèi)容
22.5.3 功能應(yīng)用規(guī)格書
????????對于業(yè)務(wù)組件的描述是基于功能的詳細(xì)設(shè)計“業(yè)務(wù)4件套”進(jìn)行的應(yīng)用設(shè)計，形成“組件業(yè)務(wù)4件套”。
22.5.4 數(shù)據(jù)應(yīng)用規(guī)格書
????????數(shù)據(jù)的應(yīng)用設(shè)計的成果主要根據(jù)系統(tǒng)的內(nèi)容而定，不是必需的，例如可以設(shè)計數(shù)據(jù)的復(fù)用機(jī)制、數(shù)據(jù)的共享機(jī)制，以及數(shù)據(jù)的轉(zhuǎn)換機(jī)制等內(nèi)容
22.5.5 應(yīng)用用例
????????對應(yīng)用設(shè)計以及管理設(shè)計的成果，用應(yīng)用用例的方式進(jìn)行驗證。主要模板有兩個，一是應(yīng)用用例導(dǎo)圖，二是數(shù)據(jù)關(guān)系圖
