WQJ用能計(jì)費(fèi)系統(tǒng)軟件概要設(shè)計(jì)說明書

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