智慧運(yùn)維APP能源管理系統(tǒng) EMSV1 31概要設(shè)計(jì)說明書 V1.6

智慧運(yùn)維手機(jī)APPForEMSV1.31概要設(shè)計(jì)說明書V1.00智慧運(yùn)維手機(jī)APPForEMSV1.31概要設(shè)計(jì)說明書文件編號(hào)生效日期受控編號(hào)保密級(jí)別一級(jí)版本號(hào)V1.024563修改狀態(tài)總頁數(shù)43367正文附錄編制趙勝利審核批準(zhǔn)(版權(quán)所有,翻版必究)評(píng)審記錄對(duì)《智慧運(yùn)維手機(jī)APPForEMSV1.31概要設(shè)計(jì)說明書V1.00》的評(píng)審意見：上述問題修改驗(yàn)證后，由驗(yàn)證后，本文件即可發(fā)布。評(píng)審人員簽字：問題修改驗(yàn)證結(jié)果：驗(yàn)證人簽字：時(shí)間：

變更日志1，刪除了APP公共管理平臺(tái)側(cè)的概設(shè)內(nèi)容。2，細(xì)化了告警統(tǒng)計(jì)信息的分類和統(tǒng)計(jì)方法。3，增加了告警統(tǒng)計(jì)信息的推送功能。4，增加了告警列表篩選的交互說明。5，刪除了知識(shí)庫部功能。

目錄1引言 圖1，其中可分為登錄模塊、能耗模塊、告警模塊、“更多”模塊等4個(gè)模塊。其中登錄、能耗、告警等模塊數(shù)據(jù)來源于EMS1.31系統(tǒng)?！案唷蹦K中的APP版本更新、知識(shí)庫、關(guān)于頁面、天溯新聞/新產(chǎn)品動(dòng)態(tài)、意見反饋等功能是針對(duì)公司的全部所有客戶用戶，。任何客戶的這些功能的數(shù)據(jù)、這部分的接口服務(wù)等是部署于研發(fā)中心統(tǒng)一設(shè)立的公網(wǎng)服務(wù)器中，所有用戶的此部分?jǐn)?shù)據(jù)集中統(tǒng)一管理。同時(shí)此部分功能要管控未來多個(gè)移動(dòng)端產(chǎn)品。如EMS1.31APP、EMS1.32APP、eWay2.21APP、eWay2.3APP等。1、登錄模塊支持根據(jù)用戶的登錄名和密碼實(shí)現(xiàn)登錄功能，支持記住密碼，自動(dòng)登陸，在用戶第一次成功登錄后，再次重啟APP直接登錄陸，僅在用戶登出后，再次提示用戶登錄。2、能耗模塊能耗模塊主要用于展示能耗相關(guān)數(shù)據(jù)，主要包括：能耗總覽、能耗分析、KPI指標(biāo)。告警模塊告警模塊主要用于展示設(shè)備及系統(tǒng)產(chǎn)生的告警數(shù)據(jù)，使用能及時(shí)了解當(dāng)前設(shè)備及系統(tǒng)的運(yùn)行情況，便于管理人員及時(shí)定位處理設(shè)備故障?！案唷蹦K“更多”功能模塊是APP的附屬功能模塊，主要包括用戶登出、APP版本更新、天溯動(dòng)態(tài)、知識(shí)庫、關(guān)于頁面、意見反饋等。除登錄模塊是通過EMS1.31平臺(tái)實(shí)現(xiàn)外，剩余的模塊是均由APP公共管理平臺(tái)統(tǒng)一管理。圖1EMSV1.3APP功能需求2.3.2非功能需求（1）安全可靠千兆接入網(wǎng)絡(luò)，支持大規(guī)模并發(fā)數(shù)據(jù)流量接入;（2）對(duì)主要數(shù)據(jù)和功能進(jìn)行安全隔離；（3）具備統(tǒng)一的運(yùn)行監(jiān)管功能，對(duì)主要模塊的運(yùn)行狀態(tài)進(jìn)行統(tǒng)一監(jiān)管，要求具有良好的運(yùn)行監(jiān)測、負(fù)載監(jiān)控管理、流量監(jiān)控、故障分析和故障恢復(fù)能力；（4）智慧運(yùn)維，整體方案中數(shù)據(jù)處理協(xié)議和關(guān)鍵業(yè)務(wù)數(shù)據(jù)算法模塊支持升級(jí)替換，利于第三方接入和投資保護(hù)；（5）數(shù)據(jù)安全保護(hù)，支持安全加密，完善的數(shù)據(jù)備份和容災(zāi)備份方案。（6）響應(yīng)性能。在公網(wǎng)部署的情況下，平臺(tái)帶寬要求大于等于5M，最大連接數(shù)40臺(tái)。APP需盡量節(jié)省流量，需要在后臺(tái)的數(shù)據(jù)和頁面盡量減少流量的消耗，單頁面流量不大于2M。網(wǎng)絡(luò)正常情況下，單個(gè)頁面響應(yīng)速度不超過5S。更加詳細(xì)的功能需求，性能需求以及其他需求參見本項(xiàng)目的需求規(guī)格說明書。2.4條件與限制本文檔僅針對(duì)EMSV1.31APP的需求開發(fā)，本文檔中的“本APP”、“APP”等詞通指EMSV1.31APP系統(tǒng)。開發(fā)時(shí)間要求為2016.01-2016.04，即在2015年4月31日前完成規(guī)定任務(wù)的設(shè)計(jì)、研發(fā)和測試第一輪工作。3總體設(shè)計(jì)3.1設(shè)計(jì)原則由于APPforEMSV1.31的目標(biāo)是位為客戶的運(yùn)維人員提供一套有效的移動(dòng)端運(yùn)維管理工具，借助此工具能夠查詢到企業(yè)當(dāng)前的能耗使用狀態(tài)和設(shè)備產(chǎn)生的告警信息，同時(shí)能夠?qū)Ω婢M(jìn)行直接處理。因此本APP是一個(gè)應(yīng)用場景清晰、功能明確、實(shí)時(shí)性要求高的的移動(dòng)端能耗運(yùn)維管理利器，在開發(fā)本APP時(shí)，一定要在設(shè)計(jì)規(guī)劃階段進(jìn)行細(xì)致認(rèn)真的工作，確定APP的目標(biāo)，這樣才能保證APP構(gòu)建的順利進(jìn)行和規(guī)避不必要的風(fēng)險(xiǎn)。以下是在系統(tǒng)建設(shè)過程中所需要遵循的一些原則。除了這些之外，要考慮減少流量消耗，主要是接口設(shè)計(jì)中減少不必要的接口調(diào)用和冗余參數(shù)的傳輸。除了這些之外，要考慮減少流量消耗，主要是接口設(shè)計(jì)中減少不必要的接口調(diào)用和冗余參數(shù)的傳輸。3.1.1階段性

考慮到我司APP產(chǎn)品建設(shè)是一項(xiàng)長久的工程，因此系統(tǒng)建設(shè)可以分成多個(gè)階段來逐步實(shí)現(xiàn)?；谥暗腁PP系統(tǒng)已經(jīng)有一定的設(shè)計(jì)經(jīng)驗(yàn)積累，在此次開發(fā)的階段重點(diǎn)需要解決之前版本中的不足和缺憾，加以改善和解決。以達(dá)到此版本APP開發(fā)后能夠確定APP產(chǎn)品體系的明確和優(yōu)勢(shì)所在。隨著時(shí)間的推移及企業(yè)的發(fā)展，逐漸拓展新的移動(dòng)運(yùn)維需求，并將新的需求融入到APP體系中，從而最終實(shí)現(xiàn)一個(gè)可靠、可擴(kuò)展的APP產(chǎn)品。3.1.2先進(jìn)性

作為支撐公司EMS產(chǎn)品線移動(dòng)端運(yùn)維需要的重要APP版本，在APP的設(shè)計(jì)過程中，還必須強(qiáng)調(diào)先進(jìn)性。保證APP未來的生命力，能夠滿足一定時(shí)間段內(nèi)用戶運(yùn)維的需要。3.1.3低流量消耗

為方便用戶運(yùn)維人員實(shí)時(shí)運(yùn)維需要，APP會(huì)在多種網(wǎng)絡(luò)環(huán)境下使用，因此APP不宜消耗太多流量，APP與服務(wù)器之間通訊盡量簡化，減少非必要的數(shù)據(jù)傳輸。3.1.43高性能

作為一套實(shí)時(shí)操作的APP產(chǎn)品，需要達(dá)到較高的性能要求。已能才能較好支撐用戶運(yùn)維人員的實(shí)時(shí)運(yùn)維需要。3.1.54易用性

為便于不同類型用戶的使用，APP風(fēng)格確定為簡潔、大方。每個(gè)頁面展示一個(gè)主題內(nèi)容。字體字號(hào)美觀大氣，易于辨認(rèn)。操作路徑不宜過深。3.1.65安全性

由于移動(dòng)設(shè)備往往能有效標(biāo)記用戶的身份，因此APP的安全性尤為重要。設(shè)計(jì)時(shí)必須考慮各種場景下的安全信息。安全性是整個(gè)APP正常發(fā)展的基礎(chǔ)保障。3.1.76穩(wěn)定性若APP本身如果不穩(wěn)定，經(jīng)常崩潰、退出，則用戶必定會(huì)產(chǎn)生極大抵觸情緒，所以APP的穩(wěn)定是APP產(chǎn)品成功的命脈所在。3.2總體結(jié)構(gòu)系統(tǒng)整體分為3層，其中數(shù)據(jù)層的功能是持久化存儲(chǔ)各模塊的數(shù)據(jù)。平臺(tái)處理層分為兩部分，一部分是APP公共管理平臺(tái)，由我司運(yùn)維部（市場部）進(jìn)行管理維護(hù)。提供APP版本管理、常見問題管理、APP用戶意見反饋管理等。另一部分是客戶企業(yè)內(nèi)的EMS1.31平臺(tái)，主要提供APP用戶的登錄、登出、能耗模塊查詢、告警模塊查詢處理等功能。業(yè)務(wù)展現(xiàn)層的功能為，從移動(dòng)APP端提供輔助客戶運(yùn)維人員的能耗查詢界面、告警查詢處理界面、APP版本升級(jí)、意見反饋、常見問題獲取等功能，為用戶提供專業(yè)的運(yùn)維工具和APP輔助功能。3.3總體方案 總體方案如上圖所示，結(jié)構(gòu)較為清晰。APP通過無線網(wǎng)絡(luò)（2G/3G/4G/WIFI）訪問服務(wù)器中的API。由于APP公共管理平臺(tái)的接口要保持一致性和可訪問性，同時(shí)鑒于無法確定的保持某公網(wǎng)環(huán)境可持續(xù)用于APP公共管理平臺(tái)，此處做出以下處理方案。首先搭建我司APP統(tǒng)一的APP管理平臺(tái)，假如約定放在“10.xx.xx.56”服務(wù)器的6000端口上。其次在我司官網(wǎng)域名下開啟二級(jí)域名地址用于部署一個(gè)服務(wù)接口，用于提供可用APP公共管理平臺(tái)可用的最新地址。當(dāng)APP分發(fā)時(shí)，APP默認(rèn)與約定的“10.xx.xx.56”地址的6000端口建立連接，如果可用，則進(jìn)行關(guān)聯(lián)。如果發(fā)現(xiàn)無響應(yīng)或返回錯(cuò)誤信息，則嘗試連接開啟的公司官網(wǎng)特定二級(jí)域名下的特定接口服務(wù)，根據(jù)其返回最新的可用的APP公共管理平臺(tái)地址，并覆蓋寫入原有默認(rèn)的地址。3.4模塊功能APPforEMSV1.31功能實(shí)現(xiàn)包含兩部分：一部分是APP側(cè)，另一部分是平臺(tái)側(cè)。平臺(tái)側(cè)分兩部分，一部分是EMS1.31平臺(tái)，另一部分是由公司統(tǒng)一維護(hù)的APP公共管理平臺(tái)。APP中的其中用戶登錄、能耗、告警、用戶登出由EMS1.31平臺(tái)實(shí)現(xiàn)提供服務(wù)。APP版本更新、公司產(chǎn)品推介、FAQ知識(shí)庫、意見反饋等功能由由公司統(tǒng)一維護(hù)的一個(gè)APP后臺(tái)公共管理系統(tǒng)平臺(tái)提供服務(wù)支撐。本說明書包含這部分APP側(cè)的概設(shè)和APP公共管理平臺(tái)部分的概設(shè)，以及APP需要EMS1.31提供的部分內(nèi)容。針對(duì)不同網(wǎng)絡(luò)條件下的APP可用性狀況、APP用戶權(quán)限管理等跨模塊的概設(shè)，放在第一部分公共模塊中描述。詳功能模塊主要分為APP側(cè)和平臺(tái)側(cè)。詳情請(qǐng)參考以下內(nèi)容。3.4.1公共模塊APP在不同網(wǎng)絡(luò)條件下的APP網(wǎng)絡(luò)訪問處理情況、APP用戶權(quán)限管理、APP公共管理平臺(tái)訪問的合法性驗(yàn)證等跨模塊的設(shè)計(jì)方案，都在此處說明。1.

APP網(wǎng)絡(luò)訪問：我公司EMS1.31系統(tǒng)最終部署于客戶企業(yè)的網(wǎng)絡(luò)環(huán)境中?？蛻羝髽I(yè)的網(wǎng)絡(luò)訪問狀況可能很復(fù)雜。部署在客戶企業(yè)網(wǎng)絡(luò)中的EMS1.31系統(tǒng)，會(huì)出現(xiàn)三種情況：只能通過外網(wǎng)地址訪問、只能通過內(nèi)網(wǎng)地址訪問、即可通過外網(wǎng)訪問又可通過內(nèi)網(wǎng)訪問，但有時(shí)只有一種網(wǎng)絡(luò)訪問有效。

另外，APP從功能方面分，會(huì)出現(xiàn)四種網(wǎng)絡(luò)情況：僅能訪問APP公共管理平臺(tái)、僅能訪問EMS1.31平臺(tái)、既能訪問APP公共管理平臺(tái)和EMS1.31平臺(tái)、同時(shí)無法訪問APP公共管理平臺(tái)和EMS1.31平臺(tái)。APP需要面對(duì)在各種網(wǎng)絡(luò)環(huán)境情況，訪問APP公共管理平臺(tái)和訪問EMS1.31系統(tǒng)相互不影響。2.

APP用戶權(quán)限管理：根據(jù)安全需要，針對(duì)不同用戶組，能夠訪問的功能不同。不同用戶組對(duì)APP的權(quán)限在EMS1.31系統(tǒng)進(jìn)行配置。用戶登錄APP后僅能查看有權(quán)限訪問的模塊。3.APP公共管理平臺(tái)訪問合法性驗(yàn)證：由于APP的用戶是客戶企業(yè)EMS1.31平臺(tái)中的。APP訪問APP公共管理平臺(tái)時(shí)，無法進(jìn)行單個(gè)用戶驗(yàn)證。但此處需要對(duì)訪問合法性做驗(yàn)證。設(shè)計(jì)方案1.

APP網(wǎng)絡(luò)訪問：為APP配置兩個(gè)地址（內(nèi)網(wǎng)地址、外網(wǎng)地址）鏈接EMS1.31平臺(tái)。如果用戶登錄時(shí)僅配置了一個(gè)地址，則只使用此地址鏈接EMS1.31平臺(tái)。如果同時(shí)配置了內(nèi)網(wǎng)和外網(wǎng)地址，APP初次鏈接默認(rèn)采用內(nèi)網(wǎng)地址鏈接，如果不通，嘗試切換外網(wǎng)地址，如果也不通進(jìn)行提示。在APP工作過程中，如果發(fā)現(xiàn)當(dāng)前地址不可用，則嘗試切換另一地址，如果新地址可用則將新地址設(shè)為默認(rèn)地址。對(duì)于可能出現(xiàn)的EMS1.31平臺(tái)和APP公共管理平臺(tái)不可用情況，APP實(shí)現(xiàn)過程中仔細(xì)判斷網(wǎng)絡(luò)情況，對(duì)于接口無法訪問時(shí)，友好提示，確保頁面展示正常。在網(wǎng)絡(luò)不可用時(shí)，APP各功能模塊之間切換不影響。2.

APP用戶權(quán)限管理：APP用戶的訪問權(quán)限來由后臺(tái)進(jìn)行配置。用戶首次登錄APP時(shí)，后臺(tái)接口返回當(dāng)前用戶可訪問的所有頁面id，APP根據(jù)頁面id進(jìn)行動(dòng)態(tài)展示。對(duì)于只顯示用戶有權(quán)限訪問的頁面。數(shù)據(jù)權(quán)限由EMS1.31平臺(tái)控制，僅返回用戶有權(quán)限訪問的數(shù)據(jù)。對(duì)于告警處理等操作權(quán)限，亦由平臺(tái)返回標(biāo)識(shí)控制。2.

APP公共管理平臺(tái)訪問合法性驗(yàn)證：APP用戶主要是客戶企業(yè)EMS1.31平臺(tái)內(nèi)的用戶。考慮到各局點(diǎn)用戶分散，持續(xù)保持一致性代價(jià)較大，APP公共管理平臺(tái)做單個(gè)用戶的驗(yàn)證。但為了驗(yàn)證請(qǐng)求合法性，每次請(qǐng)求時(shí)附上加密的“客戶代碼”，服務(wù)器端獲取請(qǐng)求后解碼客戶代碼，如果能找到匹配的客戶代碼，即表示屬于合法的APP請(qǐng)求。3.4.1APP側(cè)用戶登錄模塊是用戶使用本APP的第一步。用戶登錄模塊包括服務(wù)器配置、用戶登錄、用戶引導(dǎo)三個(gè)功能。每個(gè)功能的詳細(xì)信息如下：1.

服務(wù)器配置：此功能幫助用戶連接到其所屬客戶的EMS系統(tǒng)中。EMS1x系統(tǒng)是部署到客戶企業(yè)環(huán)境中的，用戶首次使用APP時(shí)需配置其要連接的服務(wù)器信息。配置完畢后，后期默認(rèn)使用第一次配置的服務(wù)器信息，除非用戶主動(dòng)修改配置信息。配置完成后對(duì)配置結(jié)果進(jìn)行提示，如“服務(wù)器地址無效”或“服務(wù)器配置成功，歡迎進(jìn)入XX智能運(yùn)維系統(tǒng)”。服務(wù)器配置有兩個(gè)地址，分別是公網(wǎng)地址、內(nèi)網(wǎng)地址。默認(rèn)連接內(nèi)網(wǎng)，如果不通嘗試連接公網(wǎng)。如果還不通，進(jìn)行網(wǎng)絡(luò)異常提示。2.

用戶登錄：此功能是用戶使用APP的權(quán)限驗(yàn)證部分。用戶在登錄界面輸入用戶名、密碼然后點(diǎn)擊登錄按鈕，系統(tǒng)將用戶驗(yàn)證信息發(fā)給服務(wù)器進(jìn)行驗(yàn)證；（信息加密，返回token）。3.用戶引導(dǎo)：此功能是對(duì)配置后首次使用本APP的用戶進(jìn)行使用方法介紹。用戶引導(dǎo)通過蒙板和高亮區(qū)域?qū)χ攸c(diǎn)功能進(jìn)行介紹，方便客戶快速了解相關(guān)功能入口；需求用例圖如下：1.

人性化。在配置完、用戶輸入密碼、登陸后對(duì)用戶操作進(jìn)行提示。如配置完成后提示用戶是否配置成功，若配置失敗，提示失敗原因等。配置完成后反饋用戶是否配置成功，未配置成功的返回原因。為便于用戶使用，用戶首次登錄后，在APP關(guān)閉再進(jìn)入的時(shí)候不再進(jìn)行登錄。2.

安全性。敏感信息如：用戶名、密碼等均進(jìn)行加密后傳輸。用戶獲取數(shù)據(jù)均帶上token信息，服務(wù)器端進(jìn)行驗(yàn)證。用戶登出后刪除服務(wù)器端token信息。登錄模塊的總體流程圖如下：1.

服務(wù)器配置功能，為方便對(duì)用戶配置信息進(jìn)行校驗(yàn)，WEB平臺(tái)預(yù)留默認(rèn)的配置信息確認(rèn)接口。同時(shí)為了今后版本考慮，增加版本確認(rèn)信息。2.

用戶登錄功能，用戶名、密碼信息進(jìn)行加密后傳輸（采用MD5方法加密）。為了便于用戶直接使用不必每次都登錄，登錄成功后返回token信息。此信息持久化存入web平臺(tái)中。隨后用戶每次申請(qǐng)數(shù)據(jù)均附帶上此token信息。對(duì)于沒有token的屏蔽訪問。3.

使用引導(dǎo)在用戶完成配置后首次登錄時(shí)顯示。4.

為了對(duì)用戶進(jìn)行行為進(jìn)行記錄，用戶的APP登錄操作記入日志信息。日志包含用戶名、登錄時(shí)間、登錄的IP等信息。用戶登錄模塊是用戶使用本APP的第一步。用戶登錄模塊包括服務(wù)器配置、用戶登錄、用戶引導(dǎo)三個(gè)功能。每個(gè)功能的詳細(xì)信息如下：1.

服務(wù)器配置：此功能幫助用戶連接到其所屬客戶的EMS系統(tǒng)中。EMS1x系統(tǒng)是部署到客戶企業(yè)環(huán)境中的，用戶首次使用APP時(shí)需配置其要連接的服務(wù)器信息。配置完畢后，后期默認(rèn)使用第一次配置的服務(wù)器信息，除非用戶主動(dòng)修改配置信息。配置完成后對(duì)配置結(jié)果進(jìn)行提示，如“服務(wù)器地址無效”或“服務(wù)器配置成功，歡迎進(jìn)入XX智能運(yùn)維系統(tǒng)”。服務(wù)器配置有兩個(gè)地址，分別是公網(wǎng)地址、內(nèi)網(wǎng)地址。默認(rèn)連接內(nèi)網(wǎng)，如果不通嘗試連接公網(wǎng)。如果還不通，進(jìn)行網(wǎng)絡(luò)異常提示。2.

用戶登錄：此功能是用戶使用APP的權(quán)限驗(yàn)證部分。用戶在登錄界面輸入用戶名、密碼然后點(diǎn)擊登錄按鈕，系統(tǒng)將用戶驗(yàn)證信息發(fā)給服務(wù)器進(jìn)行驗(yàn)證；（信息加密，返回token）。3.用戶引導(dǎo)：此功能是對(duì)配置后首次使用本APP的用戶進(jìn)行使用方法介紹。用戶引導(dǎo)通過蒙板和高亮區(qū)域?qū)χ攸c(diǎn)功能進(jìn)行介紹，方便客戶快速了解相關(guān)功能入口；需求用例圖如下：1.

人性化。在配置完、用戶輸入密碼、登陸后對(duì)用戶操作進(jìn)行提示。如配置完成后提示用戶是否配置成功，若配置失敗，提示失敗原因等。配置完成后反饋用戶是否配置成功，未配置成功的返回原因。為便于用戶使用，用戶首次登錄后，在APP關(guān)閉再進(jìn)入的時(shí)候不再進(jìn)行登錄。2.

安全性。敏感信息如：用戶名、密碼等均進(jìn)行加密后傳輸。用戶獲取數(shù)據(jù)均帶上token信息，服務(wù)器端進(jìn)行驗(yàn)證。用戶登出后刪除服務(wù)器端token信息。登錄模塊的總體流程圖如下：1.

服務(wù)器配置功能，為方便對(duì)用戶配置信息進(jìn)行校驗(yàn)，WEB平臺(tái)預(yù)留默認(rèn)的配置信息確認(rèn)接口。為了同時(shí)為了今后多版本管理需要考慮，增加版本確認(rèn)信息。2.

用戶登錄功能，用戶名、密碼信息進(jìn)行加密后傳輸（采用MD5方法加密）。為了便于用戶直接使用不必每次都登錄，登錄成功后返回token信息。此信息持久化存入web平臺(tái)中。隨后用戶每次申請(qǐng)數(shù)據(jù)均附帶上此token信息。對(duì)于沒有token的屏蔽訪問。3.

使用引導(dǎo)在用戶完成配置后首次登錄時(shí)顯示。用戶登錄后服務(wù)器返回當(dāng)前用戶是否是第一次使用此版本，是，則進(jìn)行使用引導(dǎo)，不是，則直接跳過。4.

為了對(duì)用戶進(jìn)行行為進(jìn)行記錄，用戶的APP登錄操作記入日志信息。日志包含用戶名、登錄時(shí)間、登錄的IP等信息。能耗數(shù)據(jù)是用戶了解其企業(yè)能耗使用情況的重要依據(jù)。能耗模塊主要用于展示能耗相關(guān)數(shù)據(jù)，包括：能耗總覽、能耗分析、KPI指標(biāo)。每個(gè)功能的詳細(xì)信息如下：1.

能耗總覽：此功能提供用戶查看當(dāng)月能耗的匯總信息。包括當(dāng)月能耗占比信息和當(dāng)月能耗總覽信息。當(dāng)月能耗占比信息包括：當(dāng)月能耗數(shù)據(jù)、當(dāng)月各分項(xiàng)能耗數(shù)據(jù)（電、水、氣等能耗）、當(dāng)月各分項(xiàng)能耗的占比圖（顯示百分比數(shù)據(jù)）。當(dāng)月能耗總覽包括：、相對(duì)上月同期的增加/減少（為0時(shí)，不顯示向上向下箭頭）。 能源類型根據(jù)系統(tǒng)配置展示。2.

能耗分析：此功能方便用戶查看近期企業(yè)能耗使用的趨勢(shì)信息。用戶能夠根據(jù)時(shí)間、類型、業(yè)態(tài)、區(qū)域、能耗類型等對(duì)能耗數(shù)據(jù)進(jìn)行過濾。時(shí)間支持年、月。并同時(shí)能夠查看當(dāng)前篩選條件下的同比、環(huán)比數(shù)據(jù)。3.KPI指標(biāo)：此功能提供查看用戶企業(yè)能源消耗相關(guān)KPI數(shù)據(jù)，方便用戶掌握其能耗的關(guān)鍵指標(biāo)；KPI包含能耗KPI和分項(xiàng)能耗KPI?？偰芎腒PI包括：總能耗定額KPI值（單位TCE，未配置顯示N/A）、總能耗實(shí)際消耗值（單位TCE）、總能耗剩余值（單位TCE，未配置顯示N/A）、實(shí)際消耗百分比（小數(shù)點(diǎn)后保留兩位）、能耗同比；分項(xiàng)能耗KPI包括：分項(xiàng)能耗的定額KPI值（未配置顯示N/A），實(shí)際消耗值、剩余值（未配置顯示N/A）、實(shí)際消耗百分比（小數(shù)點(diǎn)后保留兩位）、能耗同比能源消耗速度。 由于定額KPI可能未配置，此頁面是否顯示，根據(jù)EMS1.31平臺(tái)配置顯示與否。平臺(tái)配置APP的能耗模塊是否顯示KPI頁面。需求用例圖如下：1.

人性化。為便于用戶查看能耗的總體、分項(xiàng)信息、趨勢(shì)信息等，此部分信息主要采用圖表展示方法。包含環(huán)形圖、柱狀圖、儀表圖等。由于此部分主要是信息查看，此處采用數(shù)據(jù)模塊方式展示查看數(shù)據(jù)的關(guān)系：告警模塊是用戶運(yùn)維人員了解其企業(yè)設(shè)備運(yùn)行狀況的重要功能。告警模塊主要用于對(duì)當(dāng)日客戶企業(yè)設(shè)備運(yùn)行的異常信息進(jìn)行管理，通過此模塊能夠查看告警總覽、告警列表、告警詳情，并對(duì)告警進(jìn)行處理等。每個(gè)功能的詳細(xì)信息如下：1.

告警總覽：展示告警統(tǒng)計(jì)數(shù)據(jù)，包括：今日新增告警數(shù)、今日新增告警已處理數(shù)、告警待處理總量、告警回復(fù)總數(shù)量；顯示今日新增的告警數(shù)量、今日新增告警中已處理的數(shù)量，便于客戶運(yùn)維人員總體了解今日設(shè)備運(yùn)行狀況。今日新增告警數(shù)：從今日凌晨零點(diǎn)開始，到當(dāng)前時(shí)間，所產(chǎn)生的告警的總數(shù)；今日新增告警已處理數(shù)：對(duì)今日新增的告警，同時(shí)狀態(tài)為已處理的告警總數(shù)；告警待處理總量：正在告警的總數(shù)+告警類型為（診斷告警/一般告警的發(fā)生態(tài)信息），告警狀態(tài)為已確認(rèn)的告警總數(shù)告警恢復(fù)總量：全部告警的已恢復(fù)態(tài)信息狀態(tài)的告警總數(shù)。2.

告警列表：此功能方便運(yùn)維人員查看今日發(fā)生的所有告警信息。每條告警信息包含：告警時(shí)間、告警狀態(tài)、告警內(nèi)容、告警等級(jí)、告警模塊項(xiàng)、告警類型項(xiàng)圖標(biāo)等內(nèi)容。告警列表默認(rèn)按照告警時(shí)間倒序排序。運(yùn)維人員可根據(jù)告警模塊、告警狀態(tài)、告警等級(jí)（范圍）、告警類型、告警時(shí)間（范圍）進(jìn)行過濾，同時(shí)能夠根據(jù)告警類型、告警等級(jí)、告警時(shí)間進(jìn)行排序。3.告警詳情：告警詳情是告警列表中每一天告警記錄的詳細(xì)信息，包含了一條告警的最詳細(xì)內(nèi)容，主要有：告警對(duì)象、告警項(xiàng)、告警信息、歸屬模塊、告警性質(zhì)、告警等級(jí)、告警狀態(tài)、告警時(shí)間、告警區(qū)域等。4.告警歷史信息：告警歷史信息是記錄每條告警的歷史處理信息，包括告警時(shí)間、告警狀態(tài)、告警信息、備注等。此功能方便運(yùn)維人員查看單條告警的歷史處理情況。5.告警處理：告警處理功能是為運(yùn)維人員提供的告警處理工具。通過告警處理功能，運(yùn)維人員能夠使用APP直接對(duì)告警進(jìn)行處理。消除了用戶必須在電腦端操作的限制。告警處理針對(duì)手機(jī)端處理還是PC端處理進(jìn)行區(qū)分。 EMS.131平臺(tái)端返回告警列表數(shù)據(jù)，并標(biāo)記用戶是否有操作權(quán)限。告警處理狀態(tài)變化有以下3條路徑：正在告警已確認(rèn)（確認(rèn)操作）已處理（處理操作）正在告警已處理（直接處理操作）已處理已確認(rèn)（撤銷處理操作）6.告警處理操作記錄：告警處理是用戶企業(yè)運(yùn)維的重要工作，運(yùn)維人員每次對(duì)告警的處理操作進(jìn)行記錄，內(nèi)容包括：處理操作時(shí)間、告警狀態(tài)、告警信息、操作終端、操作人、告警處理文字。時(shí)間、處理前后的告警狀態(tài)、處理人員。7.告警處理權(quán)限控制：本APP用戶主要分：客戶企業(yè)的管理人員和運(yùn)維人員。此處的處理功能僅對(duì)運(yùn)維人員開啟。對(duì)于管理人員僅提供查看告警信息。8.告警推送：為了保持告警總覽信息的實(shí)時(shí)性和告警有變化時(shí)進(jìn)行提醒，AP告警統(tǒng)計(jì)信息P采用websocket推送方式實(shí)現(xiàn)與服務(wù)器實(shí)時(shí)同步的功能與服務(wù)器長連接實(shí)現(xiàn)告警推送功能。01APP在運(yùn)行期間，收到新通知后，會(huì)以震動(dòng)的方式提示用戶，并在對(duì)應(yīng)的數(shù)據(jù)項(xiàng)上以紅點(diǎn)展示。告警推送通知以用戶賬號(hào)為接收單元。通知的數(shù)據(jù)需要由后臺(tái)先進(jìn)行篩選統(tǒng)計(jì)匯總。；

02時(shí)間計(jì)算方式為統(tǒng)計(jì)方法：以當(dāng)前用戶前用戶上一次刷新統(tǒng)計(jì)告警數(shù)據(jù)的時(shí)間為起始時(shí)間，在此時(shí)間之后發(fā)生產(chǎn)生的告警統(tǒng)計(jì)項(xiàng)目的為新告警數(shù)據(jù)，經(jīng)過后臺(tái)篩選后作為通知推送給用戶由后臺(tái)統(tǒng)計(jì)并推送給前臺(tái)，并標(biāo)記處是否有更新，是否進(jìn)行提示等。；

03告警通知展示方式為：在告警首頁上展示新數(shù)據(jù)提示，展示包括：在今日所有新增的告警數(shù)、今日新增告警已處理數(shù)、告警的待處理總數(shù)、告警的恢復(fù)總數(shù)的數(shù)字上，以紅點(diǎn)展示統(tǒng)計(jì)數(shù)據(jù)項(xiàng)的右上側(cè)顯示紅色標(biāo)記。某項(xiàng)數(shù)據(jù)產(chǎn)生更新，則有此標(biāo)記表示。如果在上次統(tǒng)計(jì)返回后，用戶查看了相應(yīng)的列表項(xiàng)，且沒有產(chǎn)生新的數(shù)據(jù)，則不顯示此標(biāo)記。如果此次統(tǒng)計(jì)時(shí)間內(nèi)有新數(shù)據(jù)產(chǎn)生，則手機(jī)進(jìn)行震動(dòng)提示。；

04后臺(tái)篩選方式為：后臺(tái)根據(jù)配置文件，對(duì)推送的告警進(jìn)行篩選，篩選條件根據(jù)告警模塊、告警項(xiàng)和告警等級(jí)進(jìn)行篩選，需要根據(jù)不同用戶做配置，不同權(quán)限的用戶的篩選條件可能不同；

05由告警統(tǒng)計(jì)進(jìn)入告警列表入口的告警通知處理方式為：進(jìn)入告警列表頁面時(shí)根據(jù)當(dāng)前入口項(xiàng)目的篩選條件，顯示相應(yīng)的告警列表內(nèi)容。當(dāng)有新數(shù)據(jù)產(chǎn)生提示時(shí)，點(diǎn)擊進(jìn)入新頁面后，根據(jù)點(diǎn)擊按鈕，做條件篩選，在頁面最上方展示新數(shù)據(jù)；

權(quán)限管理告警配置功能：此功能是是否保持告警推送。默認(rèn)選中，表示保持推送，APP實(shí)時(shí)和服務(wù)器同步此處的告警統(tǒng)計(jì)信息。如果取消，則APP斷開與服務(wù)器聯(lián)系。管理人員（沒有告警處理權(quán)限）的需求用例圖如下：運(yùn)維人員（有告警處理權(quán)限）的需求用例圖如下：1.

人性化。告警篩選條件較多，為了最大化的方便用戶進(jìn)行篩選操作，篩選操作分為兩個(gè)入口為便于用戶查看能耗的總體、分項(xiàng)信息、趨勢(shì)信息等，此部分信息主要采用圖表展示方法。包含環(huán)形圖、柱狀圖、儀表圖等：普通篩選和綜合篩選。普通篩選是展示所有篩選條件，給用戶逐一選擇的篩選功能。普通篩選的篩選條件是完整的，用戶可以通過此功能精確的定位到需要告警范圍中。綜合篩選，只有一個(gè)關(guān)鍵字輸入框。APP啟動(dòng)時(shí)，從服務(wù)器獲取所有可用的篩選條件，存于本地。當(dāng)用戶在關(guān)鍵字輸入框中輸入關(guān)鍵字時(shí)，程序自動(dòng)搜索所有匹配用戶輸入關(guān)鍵字的篩選條件值，以下拉項(xiàng)方式呈現(xiàn)給用戶。用戶可直接選擇某一篩選條件值。。選擇完一個(gè)篩選條件值后，用戶可以繼續(xù)輸入關(guān)鍵詞，程序繼續(xù)自動(dòng)搜索除了已選的篩選條件外的其它條件值，給用戶選擇。用戶可以依此選擇多個(gè)條件，單擊搜索按鈕進(jìn)行查詢。32.

安全性。告警處理是用戶企業(yè)運(yùn)維的重要工作，運(yùn)維人員每次對(duì)告警的處理操作進(jìn)行記錄，內(nèi)容包括：處理時(shí)間、處理前后的告警狀態(tài)、處理人員。此部分涉及若干頁面的數(shù)據(jù)和部分功能模塊的數(shù)據(jù)，其關(guān)系參考下圖：告警處理邏輯部分較為復(fù)雜，其主要處理流程如下參考下圖：“更多”模塊是當(dāng)前登錄用戶的信息以及本APP相關(guān)的功能。主要包括用戶登出、APP版本更新信息、公司天溯動(dòng)態(tài)產(chǎn)品推介、FAQ、意見反饋等功能。用戶登出功能是在用戶企業(yè)服務(wù)器中實(shí)現(xiàn)。其它功能需要APP連接統(tǒng)一的公網(wǎng)服務(wù)器。每個(gè)功能的詳細(xì)信息如下：1.

用戶登出：本功能用于切換當(dāng)前登錄用戶。在用戶登錄時(shí)，服務(wù)器會(huì)生成token信息用于標(biāo)識(shí)唯一用戶。當(dāng)用戶登出時(shí)，服務(wù)器刪除此token信息以及相應(yīng)的session數(shù)據(jù)。2.

版本檢查：由于Android和IOS平臺(tái)對(duì)APP管理的差異，Android平臺(tái)和IOS平臺(tái)的版本升級(jí)功能管理。此模塊功能適用于Android平臺(tái)。IOS平臺(tái)由于Appleappstore統(tǒng)一管理，IOS版本的APP將刪除不含此功能。版本檢查提供了用戶統(tǒng)一的APP升級(jí)渠道。為了保持用戶使用的APP及時(shí)更新，由研發(fā)中心維護(hù)一個(gè)統(tǒng)一的APP升級(jí)服務(wù)。每次用戶使用時(shí)APP首先訪問升級(jí)服務(wù)，如有新版本可用，則提示用戶下載。用戶也可以主動(dòng)訪問“檢查升級(jí)”功能。APP保持大版本共存，小版本升級(jí)替換的模式。即不同的客戶可能使用不同大版本。如祿口機(jī)場使用EMS1.2APP，華西醫(yī)院使用EMS1.31APP、衛(wèi)計(jì)委使用eWay2.21APP；祿口機(jī)場存在從APPEMS1.2.1603041升級(jí)到APPEMS1.2.1607011，衛(wèi)計(jì)委從APPeWay2.21.1603171升級(jí)到APPeWay2.21.1605201等。3.關(guān)于頁面：APP的關(guān)于頁面包含：公司名稱、聯(lián)系電話、官方微博、官方微信、APP當(dāng)前版本號(hào)等信息。43.公司產(chǎn)品推介天溯動(dòng)態(tài)：此功能是對(duì)我司及我司產(chǎn)品介紹的廣告性質(zhì)的模塊。用于向用戶介紹我司產(chǎn)品的最新的進(jìn)展、亮點(diǎn)等。客戶的APP使用人員能通過此功能了解到我司產(chǎn)品的最新信息。由于此頁面更新頻繁，此頁面采用H5靜態(tài)頁面實(shí)現(xiàn)，部署與APP公共平臺(tái)系統(tǒng)特定路徑中，用戶訪問此功能時(shí)，APP訪問服務(wù)器調(diào)取此頁面展示給用戶。天溯動(dòng)態(tài)具有主動(dòng)提示功能功能。當(dāng)產(chǎn)生新的有效期內(nèi)的新聞時(shí)，APP通過標(biāo)記提示有新內(nèi)容，引導(dǎo)用戶及時(shí)查看。54.FAQ：常見問題列表知識(shí)庫模塊，是對(duì)用戶使用經(jīng)常遇到的問題、專業(yè)術(shù)語等的問答形式的介紹是對(duì)行業(yè)一些專業(yè)知識(shí)介紹、展示的模塊。通過此功能，用戶能夠查看學(xué)習(xí)、查看到常見問題分類、行業(yè)的一些專業(yè)知識(shí)常見問題、，常見問題的解答等以輔助提升其工作。知識(shí)庫內(nèi)容包括：標(biāo)題、內(nèi)容、分類、標(biāo)簽字段。其中內(nèi)容是圖文混排形式。知識(shí)庫列表支持按照標(biāo)簽、分類、標(biāo)題進(jìn)行模糊篩選。565.意見反饋：為了和用戶保持直接接觸，從而了解到實(shí)際用戶使用APP過程中的感受和意見，專門開發(fā)了此功能。用戶通過此功能提交意見。后臺(tái)管理人員可以對(duì)用戶提出的意見進(jìn)行反饋或解釋。針對(duì)用戶提出較多的修改建議，可列入下版本的修改需求單中。67.是否推送配置項(xiàng)：針對(duì)APP此配置是針對(duì)告警項(xiàng)是否保持推送功能，。增加一個(gè)配置選項(xiàng)。此選項(xiàng)默認(rèn)選中，選中狀態(tài)表示保持推送，不選中表示不保持推送。7.連接合法性驗(yàn)證：APP用戶的驗(yàn)證，考慮到各局點(diǎn)用戶分散，持續(xù)保持一致性代價(jià)較大，APP公共管理平臺(tái)不做單個(gè)用戶的驗(yàn)證。但為了驗(yàn)證請(qǐng)求合法性，每次請(qǐng)求時(shí)附上“加密的當(dāng)前客戶的客戶代碼”，服務(wù)器端獲取請(qǐng)求后解碼客戶代碼，如果能找到匹配的客戶代碼，即表示屬于合法的APP請(qǐng)求。在意見反饋、提交訪問統(tǒng)計(jì)信息功能時(shí)，APP會(huì)附帶提交所屬的客戶代碼、客戶名稱（指企業(yè)客戶）、用戶id等，公共管理平臺(tái)可以通過這些信息區(qū)分哪個(gè)局點(diǎn)、用戶。針對(duì)用戶經(jīng)常提出的非修改的問題，可以定時(shí)收集并篩選其中典型的問題，列入FAQ中。用戶登出功能需求用例圖如下：APP版本更新用例圖如下：用戶查看我司產(chǎn)品推介天溯動(dòng)態(tài)相關(guān)用例圖如下：用戶訪問FAQ知識(shí)庫需求用例：（圖-1）用戶反饋APP意見的需求用例圖：1.

可持續(xù)。由于版本檢查、FAQ知識(shí)庫獲取、意見反饋、APP用戶訪問統(tǒng)計(jì)信息等功能是跨客戶跨版本的模塊，通過需通過APP公共管理平臺(tái)實(shí)現(xiàn)，因此必須保持此平臺(tái)的可持續(xù)訪問性。1.

APP公共管理平臺(tái)的連接方案。搭建APP統(tǒng)一APP管理平臺(tái)：假如設(shè)定APP統(tǒng)一的APP管理平臺(tái)放在“10.xx.xx.56”服務(wù)器的6000端口上。2.

創(chuàng)建APP統(tǒng)一管理平臺(tái)最新地址的接口服務(wù)：在我司官網(wǎng)域名下開啟二級(jí)域名地址，部署一個(gè)服務(wù)接口。用于提供可用APP公共管理平臺(tái)可用的最新地址。當(dāng)APP分發(fā)時(shí)，APP默認(rèn)與約定的“10.xx.xx.56”地址的6000端口建立連接，如果可用，則進(jìn)行關(guān)聯(lián)。如果發(fā)現(xiàn)無響應(yīng)或返回錯(cuò)誤信息，則嘗試連接開啟的公司官網(wǎng)特定二級(jí)域名下的特定接口服務(wù)，根據(jù)其返回最新的可用的APP公共管理平臺(tái)地址，并覆蓋寫入原有默認(rèn)的地址。詳細(xì)見以下圖示。 24. APP獲取天溯動(dòng)態(tài)通知提示的流程圖如下：3.4.2平臺(tái)側(cè)用戶登錄模塊主要包括登錄驗(yàn)證、驗(yàn)證碼、密碼加密的功能APP登錄、登出的驗(yàn)證功能有EMS1.31平臺(tái)實(shí)現(xiàn)。登錄驗(yàn)證輸入用戶名和密碼判斷用戶名是否存在；密碼是否正確；兩個(gè)都匹配則登錄成功，加載APP版本管理和意見反饋模塊；否則提示登錄失敗平臺(tái)根據(jù)APP調(diào)用登錄接口時(shí)提交的用戶名和加密的密碼，訪問數(shù)據(jù)庫用戶表讀取相應(yīng)用戶名的記錄到內(nèi)存，判斷APP版本是否當(dāng)前EMS平臺(tái)的APP版本，匹配則判斷用戶名、密碼是否正確。正確，返回相應(yīng)信息（token、是否首次登錄、客戶企業(yè)ID、客戶企業(yè)名稱等，具體參考接口）。如果首次登錄，則修改相應(yīng)值。生成token，并持久化存儲(chǔ)于DB中。失敗，則提示失敗原因（用戶名不存在、密碼錯(cuò)誤、APP版本不匹配等）。APP登錄流程接口用戶名驗(yàn)證碼用戶登錄時(shí)必須輸入驗(yàn)證碼：如果輸入錯(cuò)誤，刷新驗(yàn)證碼，提示驗(yàn)證碼錯(cuò)誤；否則在用戶名和密碼都輸入正確的情況下才可以登錄系統(tǒng)。密碼加密登出用戶登錄密碼以MD5加密方式存儲(chǔ)于數(shù)據(jù)庫中。APP用戶登錄時(shí)先由APP客戶端對(duì)用戶密碼進(jìn)行MD5加密，先對(duì)用戶輸入的密碼進(jìn)行MD5計(jì)算再傳輸至服務(wù)端，由服務(wù)器進(jìn)行判斷驗(yàn)證服務(wù)器收到用戶登出的請(qǐng)求，刪除此用戶session數(shù)據(jù)、token等，返回消息，然后再進(jìn)行數(shù)據(jù)庫字段內(nèi)容的比較判斷密碼是否正確。由于Android和IOS平臺(tái)對(duì)APP管理的差異，此APP版本管理只管理Android版本的APP。IOS版本APP由Appleappstore統(tǒng)一管理。APP版本管理是維護(hù)APP版本升級(jí)的重要內(nèi)容功能。主要實(shí)現(xiàn)的功能有：增加最新的添加APP版本信息、啟用APP版本信息、設(shè)置升級(jí)更新特定版本的客戶、。停用APP版本信息等。APP版本管理能夠?qū)Χ鄠€(gè)大版本進(jìn)行管理。如并行存在EMS1.31APP、eWay2.21APP，每個(gè)大版本以下發(fā)布可升級(jí)的小版本。如發(fā)布了EMS1.31APP1603201版本，它能是EMS1.31APP的16年3月20日發(fā)布的第一個(gè)更新版本，能升級(jí)EMS1.31APP此日期前發(fā)布的版本。（1）增加添加APP版本信息：平臺(tái)用戶能夠?qū)PP版本進(jìn)行管理，同時(shí)能可以指定可升級(jí)此APP版本適用的客戶。。（2）添加用戶：登錄ID、密碼、用戶名、添加日期、所屬部門等。（32）編輯APP版本信息用戶：管理員可以對(duì)APP版本信息用戶信息進(jìn)行編輯。編輯內(nèi)容不包括用戶密碼。（43）啟用/停用APP版本信息用戶：停用/啟用功能用于暫?；蚧謴?fù)相應(yīng)用戶的平臺(tái)使用權(quán)限停用的租戶將不允許登錄平臺(tái)開啟或停止此APP版本的更新推送。平臺(tái)APP版本管理和APP更新步驟圖發(fā)布新版本流程：新版APP開發(fā)測試完成（對(duì)應(yīng)發(fā)布新APP版本）>在APP管理平臺(tái)的APP版本管理模塊增加一條新的APP版本記錄（因?yàn)橐獙?duì)APP進(jìn)行升級(jí)管理，需要記錄每一次的版本信息。APP檢查更新時(shí)，提交APP當(dāng)前版本信息，服務(wù)器進(jìn)行對(duì)比判斷并返回是否有更新，如有則返回新版APP路徑，供客戶端下載）>部署新版APP安裝包（將新版APP安裝包放置于某路徑下，并將此路徑錄入第二步中的記錄中，供手機(jī)端遠(yuǎn)程下載）。天溯動(dòng)態(tài)功能，實(shí)現(xiàn)共分兩部分：提示功能和公司及產(chǎn)品介紹內(nèi)容本身。為了靈活兼容各種需求場景，此處采用提示和內(nèi)容分離的方式實(shí)現(xiàn)。（一）動(dòng)態(tài)提示管理，此功能是每次修改天溯動(dòng)態(tài)后，需向APP用戶進(jìn)行的提示的管理功能。提示管理功能包括新增提示、編輯提示、刪除提示、查詢提示。（1）新增提示：一個(gè)提示的字段有：提示代碼、提示開始日期、提示結(jié)束日期。（2）編輯提示：每條提示的編輯功能。（3）刪除提示：對(duì)無效的提示、錯(cuò)誤的提示進(jìn)行刪除。（二）公司產(chǎn)品推介天溯動(dòng)態(tài)，動(dòng)態(tài)信息是公司客戶展示我司的形象面貌、最新產(chǎn)品動(dòng)態(tài)的窗口。鑒于此頁面可能更新頻繁，固此頁面主要在服務(wù)器端實(shí)現(xiàn)。此頁面采用純H5靜態(tài)頁面方式實(shí)現(xiàn)，不屬于平臺(tái)系統(tǒng)的特定路徑下。用戶查看此功能時(shí)，遠(yuǎn)程訪問此頁面展示給用戶。（1）公司產(chǎn)品推介首頁：包括我司公司介紹、產(chǎn)品介紹兩個(gè)模塊的簡單介紹和入口。（2）公司詳情介紹：展示向客戶提供的我司相關(guān)的信息，圖文并茂。（3）最新產(chǎn)品介紹：展示我司最新的產(chǎn)品規(guī)劃、軟硬件產(chǎn)品最新的成果等。FAQ知識(shí)庫管理是對(duì)APP用戶經(jīng)常遇到的問題的匯總信息能源運(yùn)維行業(yè)的專業(yè)知識(shí)、經(jīng)驗(yàn)知識(shí)匯總的知識(shí)庫管理模塊。主要實(shí)現(xiàn)的功能有：常見問題知識(shí)查詢、知識(shí)添加、常見問題知識(shí)編輯、常見問題知識(shí)刪除等。不同版本具有不同的知識(shí)庫。（1）知識(shí)常見問題查詢：平臺(tái)用戶能夠查詢知識(shí)常見問題。支持按照所屬版本、知識(shí)問題類型、知識(shí)標(biāo)簽、知識(shí)標(biāo)題問題關(guān)鍵字、解答關(guān)鍵字知識(shí)內(nèi)容等進(jìn)行查詢。支持模糊查詢。（2）添加知識(shí)常見問題：平臺(tái)用戶能夠添加知識(shí)常見問題。常見問題主要包括知識(shí)問題類型、知識(shí)標(biāo)簽、知識(shí)問題標(biāo)題、知識(shí)內(nèi)容問題解答、知識(shí)問題排序等。知識(shí)內(nèi)容是圖文混合模式，采用HTML編輯控件實(shí)現(xiàn)。（3）編輯知識(shí)常見問題：平臺(tái)用戶能編輯已有的知識(shí)加常見問題內(nèi)容。（4）刪除知識(shí)常見問題：平臺(tái)用戶能夠?qū)Σ恍枰闹R(shí)常見問題進(jìn)行刪除。意見反饋管理是對(duì)APP用戶反饋使用意見的管理模塊。主要實(shí)現(xiàn)的功能有：APP用戶反饋意見的查詢、回復(fù)APP用戶的反饋、導(dǎo)出用戶反饋、標(biāo)記用戶反饋等功能。意見反饋區(qū)分版本及客戶。（1）查詢反饋意見：平臺(tái)用戶能夠查詢用戶反饋意見。支持按照平臺(tái)版本、反饋時(shí)間、反饋人、問題類型、關(guān)鍵字等進(jìn)行查詢。支持模糊查詢。（2）回復(fù)用戶反饋問題：平臺(tái)用戶能夠?qū)τ脩舴答佇畔⑦M(jìn)行回復(fù)，此回復(fù)內(nèi)容可被反饋的用戶查看。（3）導(dǎo)出用戶反饋及回復(fù)：為了更好的分析用戶反饋意見，平臺(tái)支持對(duì)用戶反饋信息的導(dǎo)出功能。（4）標(biāo)記重要反饋信息：平臺(tái)用戶可以對(duì)重要的反饋意見進(jìn)行標(biāo)記，以方便后續(xù)匯總和管理。用戶管理是APP公共管理平臺(tái)用戶的管理模塊。基本功能包括用戶查詢、添加用戶、用戶資料修改、用戶刪除、修改用戶密碼等功能。（1）查詢用戶：管理員通過輸入查詢條件進(jìn)行檢索，得到查詢結(jié)果，即符合查詢條件的用戶列表。支持模糊查詢。（2）添加用戶：登錄ID、密碼、用戶名、添加日期、所屬部門等。（3）編輯用戶：管理員可以對(duì)用戶信息進(jìn)行編輯。編輯內(nèi)容不包括用戶密碼。（4）啟用/停用用戶：停用/啟用功能用于暫?；蚧謴?fù)相應(yīng)用戶的平臺(tái)使用權(quán)限停用的租戶將不允許登錄平臺(tái)。APP頁面用戶訪問統(tǒng)計(jì)信息查詢頁面，是用戶使用APP在各頁面停留時(shí)長的統(tǒng)計(jì)信息匯總頁面。此功能是為產(chǎn)品經(jīng)理團(tuán)隊(duì)開發(fā)，方便產(chǎn)品經(jīng)理團(tuán)隊(duì)了解APP用戶使用APP個(gè)頁面的頻率及時(shí)長的信息。支持查詢每個(gè)用戶的在某個(gè)頁面使用時(shí)長和訪問頻次、所有用戶在不同頁面的訪問時(shí)長和訪問頻次等。（1）查詢單個(gè)用戶的使用信息：查詢每個(gè)用戶的在某個(gè)頁面使用時(shí)長和訪問頻次。（2）查詢所有用戶的使用信息：統(tǒng)計(jì)顯示所有用戶在不同頁面的訪問時(shí)長和訪問頻次等。4接口設(shè)計(jì)4.1外部接口4.1.1版本更新檢查接口后續(xù)細(xì)化，下同后續(xù)細(xì)化，下同4.1.2獲取天溯動(dòng)態(tài)的更新提示服務(wù)4.1.3查詢新聞列表接口同步到其它列表接口同步到其它列表接口4.1.4獲取新聞詳情接口4.1.2獲取公司及產(chǎn)品的推介服務(wù)此接口不是非數(shù)據(jù)接口。公司產(chǎn)品推介服務(wù)主要是HTML5以圖文并茂的靜態(tài)頁面方式實(shí)現(xiàn)公司產(chǎn)品介紹的頁面。部署與APP公共平臺(tái)的特定路徑中。由APP遠(yuǎn)程訪問。主要包括首頁、公司介紹頁、公司最新產(chǎn)品介紹頁三部分。4.1.3獲取知識(shí)分類接口4.1.432獲取某分類下的FAQ知識(shí)分類列表接口4.1.43獲取某分類下FAQ列表接口4.1.5查詢知識(shí)庫列表接口4.1.654獲取某FAQ知識(shí)的詳情接口4.1.5765提交反饋意見接口新增數(shù)據(jù)用POST。PUT一般用來修改數(shù)據(jù)新增數(shù)據(jù)用POST。PUT一般用來修改數(shù)據(jù)4.1.6獲取反饋意見列表接口同步到其它列表接口同步到其它列表接口4.1.7876獲取反饋意見回復(fù)接口4.1.8987提交用戶頁面訪問時(shí)長接口新增數(shù)據(jù)用POST，PUT一般用來修改數(shù)據(jù)新增數(shù)據(jù)用POST，PUT一般用來修改數(shù)據(jù)4.1.910關(guān)于頁面接口4.2內(nèi)部接口4.2.1配置服務(wù)器信息接口4.2.2用戶登錄接口4.2.3用戶登出接口4.2.4獲取當(dāng)月能耗總覽信息能源能耗占比數(shù)據(jù)接口4.2.5獲取KPI信息接口4.2.65獲取區(qū)域樹/業(yè)態(tài)樹接口4.2.765獲取當(dāng)月能耗分析數(shù)據(jù)接口4.2.76獲取當(dāng)月能耗KPI數(shù)據(jù)接口4.2.8獲取告警處理統(tǒng)計(jì)接口（實(shí)時(shí)）4.2.8獲取告警篩選條件接口4.2.987獲取告警列表數(shù)據(jù)接口同步到其它列表接口同步到其它列表接口4.2.1098獲取告警詳情及歷史處理信息接口4.2.11獲取告警歷史處理信息接口4.2.12告警操作（確認(rèn)、處理、撤銷，單個(gè)/批量）接口4.2.1029告警確認(rèn)接口4.2.1130告警處理接口4.2.1124告警處理撤銷接口5數(shù)據(jù)結(jié)構(gòu)設(shè)計(jì)5.1EMS1.31側(cè)數(shù)據(jù)庫設(shè)計(jì)本APP的數(shù)據(jù)庫跟隨EMS1.31數(shù)據(jù)庫設(shè)計(jì)，本文檔不包含此部分內(nèi)容。由于我司存在多個(gè)產(chǎn)品線、版本并行存在的情況，將會(huì)出現(xiàn)多個(gè)版本的APP應(yīng)用到不同的客戶企業(yè)中。因此EMS平臺(tái)需要包含當(dāng)前客戶的行業(yè)（如醫(yī)療）；平臺(tái)版本（如EMS1.31）、客戶編碼（如TAYG）、客戶名稱（如天安云谷）、APP版本（如EMS1.31APP）等信息。由于定額KPI可能未配置，此頁面是否顯示，根據(jù)EMS1.31平臺(tái)配置顯示與否。平臺(tái)配置APP的能耗模塊是否顯示KPI頁面。修改修改為判斷APP用戶是否首次登錄，需要在EMS1.3用戶表中增加APP登錄標(biāo)記（APP_LOING，BIT，Default0）。如用戶在APP上登錄過，則改變狀態(tài)(值為1)。5.2公共平臺(tái)側(cè)數(shù)據(jù)庫設(shè)計(jì)5.2.1用戶表（TB_USER）序號(hào)字段名類型長度描述約束1IDINT4索引、標(biāo)識(shí)主鍵2USERIDVARCHAR40用戶登錄ID唯一性約束3USERNAMEVARCHAR40用戶名4PASSWORDVARCHAR40密碼5ADDDATEDATETIME10用戶添加日期6ENABLEDbit1是否啟用5.2.2APP版本管理表（TB_APP_VERSION）序號(hào)字段名類型長度描述約束1IDINT4索引、標(biāo)識(shí)主鍵2APPNAMEVARCHAR40APP的名稱MAIN_VERSIONVARCHAR20APP所屬產(chǎn)品版本，如EMS1.31、eWay2.21等APP版本UPDATE_VERSIONVARCHAR20升級(jí)版本，如1603201（規(guī)則：年月日+序號(hào)）CUSTOMCODEVARCHAR20適用客戶（升級(jí)此版本的客戶企業(yè)代碼）URLVARCHAR20此APP的獲取路徑STATUSVARCHAR100APP狀態(tài)（待啟用、已啟用、已停用）5.2.3APP天溯動(dòng)態(tài)提示表（TB_NEWS_NOTIFICATION）序號(hào)字段名類型長度描述約束1IDINT4索引、標(biāo)識(shí)主鍵2UPDATECODEVARCHAR40更新代碼（依次增大）3BEGINDATEDATETIME提示開始時(shí)間4ENDDATEDATETIME提示結(jié)束時(shí)間5.2.34常見問題知識(shí)表（TB_FAQKNOWLEDGE）序號(hào)字段名類型長度描述約束1IDINT4索引、標(biāo)識(shí)主鍵2QUESTIONTITLEVARCHAR40問題內(nèi)容知識(shí)標(biāo)題ANSWER