用能計(jì)費(fèi)系統(tǒng)概要設(shè)計(jì)說(shuō)明書(shū)目錄一、引言 51.1、編寫(xiě)目的 51.2、背景 51.3、假定和約束 51.4、定義 51.5、參考資料 6二、總體設(shè)計(jì) 72.1、需求規(guī)定 72.1.1、功能主角 72.2、系統(tǒng)結(jié)構(gòu) 72.2.1、系統(tǒng)網(wǎng)絡(luò)架構(gòu) 72.2.2、邏輯分層模型 82.2.3、系統(tǒng)數(shù)據(jù)業(yè)務(wù)流程 92.3、運(yùn)行環(huán)境 102.3.1、軟件要求 102.3.2、硬件要求 102.3.3、網(wǎng)絡(luò)要求 102.4、開(kāi)發(fā)規(guī)范 102.4.1、代碼編寫(xiě)規(guī)范 10三、接口設(shè)計(jì) 10四、數(shù)據(jù)庫(kù)設(shè)計(jì) 114.1、數(shù)據(jù)表設(shè)計(jì) 11充繳異常記錄（TE_PAYMENT_PAYRECORD）: 11五、模塊概要設(shè)計(jì) 125.1、充值及異常處理功能 12WQJ用能計(jì)費(fèi)系統(tǒng)軟件V1.18概要設(shè)計(jì)說(shuō)明書(shū)第5頁(yè)共14頁(yè)一、引言1.1、編寫(xiě)目的本文檔是對(duì)用能計(jì)費(fèi)系統(tǒng)軟件V1.18的要求進(jìn)行詳細(xì)分析和討論后得出的概要設(shè)計(jì)說(shuō)明書(shū)，旨在明確系統(tǒng)的總體和接口設(shè)計(jì)，以及各模塊中較重要業(yè)務(wù)的流程和對(duì)象的設(shè)計(jì)。通過(guò)本概要設(shè)計(jì)說(shuō)明書(shū)，可以了解到用能計(jì)費(fèi)系統(tǒng)軟件V1.18的功能邊界、設(shè)計(jì)思路、模塊設(shè)計(jì)等。本文檔面向的讀者是：用能計(jì)費(fèi)系統(tǒng)軟件V1.18項(xiàng)目組開(kāi)發(fā)人員、測(cè)試人員、QA。1.2、背景項(xiàng)目名稱(chēng)：用能計(jì)費(fèi)系統(tǒng)(WQJ)V1.18立項(xiàng)單位：研發(fā)中心開(kāi)發(fā)單位：用能計(jì)費(fèi)系統(tǒng)項(xiàng)目組背景概述：WQJV1.17版本提供了相對(duì)齊全的用能計(jì)費(fèi)功能，如首頁(yè)展示、充值繳費(fèi)、賬戶(hù)管理、參數(shù)設(shè)置、查詢(xún)、異態(tài)用戶(hù)、告警管理和日志管理功能。但費(fèi)用充值功能在網(wǎng)絡(luò)異常時(shí)，會(huì)導(dǎo)致充值已下裝至儀表，而平臺(tái)因網(wǎng)絡(luò)原因，無(wú)法接收到通訊管理機(jī)的返回幀，界面顯示充值失敗，而實(shí)際上是已經(jīng)充值上，給客戶(hù)造成誤解。1.3、假定和約束本設(shè)計(jì)文檔只涉及產(chǎn)品部提供的需求說(shuō)明書(shū)闡述部分的功能開(kāi)發(fā)，不涉及用能計(jì)費(fèi)系統(tǒng)（WQJ）V1.18開(kāi)發(fā)過(guò)程中自行消化的功能需求。1.4、定義下表列出本報(bào)告中專(zhuān)門(mén)術(shù)語(yǔ)的定義、英文縮寫(xiě)詞的原詞組和意義、項(xiàng)目組內(nèi)達(dá)成一致意見(jiàn)的專(zhuān)用詞匯，同時(shí)繼承全部的先前過(guò)程中定義過(guò)的詞匯。詞匯名稱(chēng)詞匯含義備注1.5、參考資料編號(hào)資料名稱(chēng)說(shuō)明二、總體設(shè)計(jì)2.1、需求規(guī)定2.1.1、功能主角充值功能當(dāng)用戶(hù)頁(yè)面操作充值或扣費(fèi)時(shí)，將充值或扣費(fèi)的金額發(fā)送到設(shè)備，返回該設(shè)備的響應(yīng)結(jié)果。充值異常確認(rèn)處理當(dāng)充值異常時(shí)，客戶(hù)經(jīng)過(guò)人工排查（通過(guò)一段時(shí)間觀(guān)察表的余額或現(xiàn)場(chǎng)人工確認(rèn)），確認(rèn)充值記錄表中對(duì)應(yīng)的記錄。2.2、系統(tǒng)結(jié)構(gòu)2.2.1、系統(tǒng)網(wǎng)絡(luò)架構(gòu)圖2.2.1系統(tǒng)網(wǎng)絡(luò)架構(gòu)圖系統(tǒng)采用C/S+B/S架構(gòu)，其中計(jì)量集抄部分延用原有的C/S架構(gòu)，用能計(jì)費(fèi)部分采用全新的B/S架構(gòu)。系統(tǒng)模型主要分五層結(jié)構(gòu)進(jìn)行設(shè)計(jì)。圖2.2.1系統(tǒng)網(wǎng)絡(luò)架構(gòu)中，數(shù)據(jù)采集層包含了前置機(jī)、集中器和終端儀表等設(shè)備，終端儀表包括電能表、水表和其他類(lèi)型的計(jì)量?jī)x表，負(fù)責(zé)對(duì)用戶(hù)用能情況進(jìn)行計(jì)量統(tǒng)計(jì)，集中器屬于中間設(shè)備負(fù)責(zé)將大量終端儀表通訊進(jìn)行匯集并通過(guò)統(tǒng)一的通訊通道上送計(jì)量數(shù)據(jù)，前置機(jī)類(lèi)似集中器，負(fù)責(zé)將終端計(jì)量設(shè)備的數(shù)據(jù)進(jìn)行匯總和協(xié)議轉(zhuǎn)換，然后上送到系統(tǒng)平臺(tái)。圖中系統(tǒng)平臺(tái)層包含了系統(tǒng)平臺(tái)的服務(wù)器，分別有NTS-9000主服務(wù)器和NTS-9000備服務(wù)器，以及相應(yīng)的配件，如短信貓、UPS等，主要負(fù)責(zé)將前置機(jī)上送的數(shù)據(jù)進(jìn)行分析處理并進(jìn)行數(shù)據(jù)存儲(chǔ)。圖中B/S三層就是業(yè)務(wù)功能的設(shè)備配置，根據(jù)需要配置若干的工作站和辦公電腦，提供用戶(hù)進(jìn)行使用操作。2.2.2、邏輯分層模型圖2.2.2邏輯分層模型圖 對(duì)應(yīng)2.2.1節(jié)的系統(tǒng)網(wǎng)絡(luò)架構(gòu)，我們可以將軟件系統(tǒng)的邏輯劃分成五層模型，各模型層間相互邏輯依賴(lài)又相互松耦合。五層模型分別是界面展示層、業(yè)務(wù)邏輯層、應(yīng)用服務(wù)層、系統(tǒng)平臺(tái)層和數(shù)據(jù)采集層。該項(xiàng)目應(yīng)用服務(wù)采用B/S架構(gòu)設(shè)計(jì)，其中前三層是專(zhuān)門(mén)根據(jù)相應(yīng)應(yīng)用產(chǎn)品的業(yè)務(wù)需求開(kāi)發(fā)，隨系統(tǒng)架構(gòu)的不同，實(shí)現(xiàn)也不同，在預(yù)付費(fèi)系統(tǒng)軟件V1.0中為C/S架構(gòu)，在用能計(jì)費(fèi)系統(tǒng)軟件V1.1中為B/S架構(gòu)。界面表示層是將登陸信息、用戶(hù)賬戶(hù)信息、充值繳費(fèi)功能、遠(yuǎn)程遙控功能、參數(shù)設(shè)置功能、查詢(xún)功能等用能計(jì)費(fèi)的業(yè)務(wù)功能展示在界面上，本項(xiàng)目中具體為用HTML5語(yǔ)言編寫(xiě)的WEB頁(yè)面及相應(yīng)的CSS和JS腳本；業(yè)務(wù)邏輯層是將實(shí)時(shí)庫(kù)中獲取到的能源用量、余額、賬戶(hù)信息、查詢(xún)結(jié)果等數(shù)據(jù)進(jìn)行邏輯轉(zhuǎn)換、封裝、篩選，并負(fù)責(zé)將封裝好的業(yè)務(wù)數(shù)據(jù)傳遞給界面表示層，以及將用戶(hù)提交的充值繳費(fèi)、遠(yuǎn)程控制、參數(shù)設(shè)置等操作命令轉(zhuǎn)達(dá)給應(yīng)用服務(wù)層，本項(xiàng)目中具體為C#.NET開(kāi)發(fā)的DLL類(lèi)型的程序模塊；應(yīng)用服務(wù)層是將充值繳費(fèi)、遠(yuǎn)程控制、參數(shù)設(shè)置等操作直接與系統(tǒng)平臺(tái)層進(jìn)行交互的服務(wù)集，本項(xiàng)目中為VC++編寫(xiě)的常駐服務(wù)模塊；第四層系統(tǒng)平臺(tái)層是整個(gè)完整系統(tǒng)的基礎(chǔ)，負(fù)責(zé)系統(tǒng)集成、數(shù)據(jù)存儲(chǔ)、協(xié)議轉(zhuǎn)換等通用性服務(wù)，屬于基礎(chǔ)性服務(wù)，本項(xiàng)目中采用通用的NTS-9000系統(tǒng)平臺(tái)實(shí)現(xiàn)；第五層數(shù)據(jù)采集層是負(fù)責(zé)計(jì)量集抄、原始數(shù)據(jù)采集服務(wù)，只要通訊協(xié)議使用統(tǒng)一的MMIJK，可兼容任意型號(hào)的前置機(jī)，目前已具備預(yù)付費(fèi)計(jì)費(fèi)功能的前置機(jī)有NTS-161和NTS-900C。2.2.3、系統(tǒng)數(shù)據(jù)業(yè)務(wù)流程圖2.2.3系統(tǒng)數(shù)據(jù)業(yè)務(wù)流程 系統(tǒng)數(shù)據(jù)業(yè)務(wù)流路徑主要是由終端采集設(shè)備進(jìn)行計(jì)量集抄后將數(shù)據(jù)上送到后臺(tái)端的系統(tǒng)平臺(tái)，有系統(tǒng)平臺(tái)執(zhí)行原始數(shù)據(jù)的協(xié)議解析、數(shù)據(jù)分析、數(shù)據(jù)存儲(chǔ)處理，這些存儲(chǔ)的數(shù)據(jù)由計(jì)費(fèi)應(yīng)用服務(wù)相關(guān)程序進(jìn)行提取、二次分析和運(yùn)算后，提供給B/S的業(yè)務(wù)邏輯層進(jìn)行數(shù)據(jù)交互，最終由業(yè)務(wù)邏輯層封裝后展示到WEB網(wǎng)頁(yè)中。從圖2.2.3的系統(tǒng)數(shù)據(jù)業(yè)務(wù)流程中可以很清晰的看出，前面2.2.2中設(shè)計(jì)的五層模型結(jié)構(gòu)。2.3、運(yùn)行環(huán)境2.3.1、軟件要求服務(wù)器操作系統(tǒng)：WindowsServer2008企業(yè)版服務(wù)器數(shù)據(jù)庫(kù)：SQLServer2008企業(yè)版服務(wù)器必選組件：IIS7.0服務(wù)器必選組件：.NETFramework4.0服務(wù)器輔助軟件：MicrosoftOffice2003客戶(hù)機(jī)瀏覽器：Chrome、Firefox2.3.2、硬件要求服務(wù)器CPU：≥雙核2.0服務(wù)器內(nèi)存：≥4G服務(wù)器硬盤(pán)：≥1T配件：串口短信貓SIMCOMMOD9001C2.3.3、網(wǎng)絡(luò)要求物理網(wǎng)絡(luò)：100M/1000M以太網(wǎng)絡(luò)短信貓：RS232串口、USB口2.4、開(kāi)發(fā)規(guī)范2.4.1、代碼編寫(xiě)規(guī)范 VC代碼編寫(xiě)要求符合《VC編程規(guī)范-00.doc》 VC界面設(shè)計(jì)要求符合《VC界面設(shè)計(jì)規(guī)范080812-00.doc》三、接口設(shè)計(jì)無(wú)四、數(shù)據(jù)庫(kù)設(shè)計(jì)4.1、數(shù)據(jù)表設(shè)計(jì)充繳異常記錄（TE_PAYMENT_PAYRECORD）:序號(hào)字段名類(lèi)型長(zhǎng)度描述約束1IDINT4索引、標(biāo)識(shí)主鍵2OPERATIONTIMEDATETIME8操作時(shí)間3DEVICEIDSMALLINT2設(shè)備索引外鍵4PAYCOUNTFLOAT4繳費(fèi)金額5OPERATERVARCHAR32操作者6COMPUTERNAMEVARCHAR64操作電腦7ACOUNTCODEIDVARCHAR64賬號(hào)五、模塊概要設(shè)計(jì)5.1、充值及異常處理功能5.1.1、功能描述充值功能當(dāng)用戶(hù)頁(yè)面操作充值或扣費(fèi)時(shí)，將充值或扣費(fèi)的金額發(fā)送到設(shè)備，返回該設(shè)備的響應(yīng)結(jié)果。充值異常確認(rèn)處理當(dāng)充值異常時(shí)，客戶(hù)經(jīng)過(guò)人工排查（通過(guò)一段時(shí)間觀(guān)察表的余額或現(xiàn)場(chǎng)人工確認(rèn)），確認(rèn)充值記錄表中對(duì)應(yīng)的記錄。5.1.2充值業(yè)務(wù)流程如下圖所示，ＷＥＢ端發(fā)起充值請(qǐng)求，ＷＥＢＳＥＲＶＩＣＥ服務(wù)接收到充值命令后，經(jīng)平臺(tái)組包后下至通訊管理機(jī)，最終費(fèi)用下裝至儀表。儀表返回報(bào)文經(jīng)通訊管理機(jī)／后臺(tái)／ＷＥＢＳＥＲＶＩＥ將結(jié)果返回給ＷＥＢ端，并最終顯示充值結(jié)果。其中為防止網(wǎng)絡(luò)異常，導(dǎo)致通訊管理機(jī)返回的報(bào)文丟失或是報(bào)文超時(shí)收到，后臺(tái)誤判充值失敗，使用戶(hù)產(chǎn)生誤解。通訊時(shí)延做可配置；當(dāng)通訊超時(shí)后，如經(jīng)過(guò)２０秒（可配置成幾次進(jìn)行輪詢(xún)，每一個(gè)固定時(shí)延，比如5S一次）點(diǎn)抄設(shè)備的余額并與充值前余額進(jìn)行比較，如差值等于充值金額，判斷充值成功，返回界面。否則返回充值異常。當(dāng)充值異常時(shí)，ＷＥＢ端彈出對(duì)話(huà)框（充值成功或充值失敗或充值異常，如是充值異常，讓用戶(hù)選擇是立即確認(rèn)或是稍后確認(rèn)，跳轉(zhuǎn)至沖繳記錄頁(yè)面進(jìn)行查詢(xún)）。立即確認(rèn)則更新計(jì)費(fèi)操作記錄表及充繳記錄。如是稍后確認(rèn)，則生成一條異常沖繳記錄至沖繳異常記錄表，用戶(hù)通過(guò)查詢(xún)充繳記錄表（不同沖繳異常記錄表，沖繳記錄表只有成功的），當(dāng)發(fā)現(xiàn)查詢(xún)時(shí)間內(nèi)有記錄為充值異常時(shí)，用戶(hù)通過(guò)人工排查，確認(rèn)是否充值成功，如果確認(rèn)則更新計(jì)費(fèi)操作記錄表及充繳記錄。、頁(yè)面設(shè)計(jì)在充值繳費(fèi)界面，點(diǎn)擊充值后，當(dāng)是異常時(shí)，當(dāng)充值異常時(shí)，ＷＥＢ端彈出對(duì)話(huà)框（充值成功或充值失敗或充值異常，如是充值異常，讓用戶(hù)選擇是立即確認(rèn)或是稍后確認(rèn)，如是稍后確認(rèn)跳轉(zhuǎn)至沖繳記錄頁(yè)面進(jìn)行查詢(xún)）。立即確認(rèn)則更新計(jì)費(fèi)操作記錄表及充繳記錄。如下所示，通過(guò)查詢(xún)可獲取某房間充值記錄，當(dāng)沖繳中有充值異常時(shí)，客戶(hù)通過(guò)人工排查方式，確認(rèn)充值是成功的，可點(diǎn)擊查詢(xún)中的充值