整定單在轉(zhuǎn)協(xié)同平臺的設(shè)計與實現(xiàn)

周耀龍 曾偉 計榮榮 單禹 陳科 張波

(國網(wǎng)浙江省電力有限公司檢修分公司，浙江杭州 311121)

整定單對于設(shè)備的正常運(yùn)行起著決定性作用，研究如何實現(xiàn)整定單關(guān)鍵數(shù)據(jù)的正確性驗證、如何實現(xiàn)大量整定單的電子化歸檔管理、如何實現(xiàn)整定單的編審批在線協(xié)同、如何實現(xiàn)整定單的快捷統(tǒng)一查詢等，有助于改善或解決整定單在傳統(tǒng)方式下的編審批效率低下、數(shù)據(jù)低級錯誤無法察覺等問題。

1 功能介紹

1.1 整定單在線創(chuàng)建

根據(jù)表單內(nèi)關(guān)鍵信息自動匹配模板，填入數(shù)據(jù)，其中，間隔類型、整定單編號將自動填充。平臺采用前后端分離技術(shù)，充分利用客戶端計算資源，有效減輕服務(wù)器負(fù)擔(dān)，提高系統(tǒng)整體效率。同時，平臺設(shè)置多種字段驗證規(guī)則，提交數(shù)據(jù)時，首先進(jìn)行表單驗證，避免低級數(shù)據(jù)錯誤，只有前端驗證通過后才向后端傳送數(shù)據(jù)。隨后，后端將快速生成整定單文件，使前端在線預(yù)覽。其中，整定單編號是唯一的，創(chuàng)建相同整定單編號的數(shù)據(jù)將丟棄，后端返回錯誤信息提示用戶修改數(shù)據(jù)。

1.2 整定單在線審批

設(shè)置校核、審核、批準(zhǔn)三級審閱流程。審閱過程結(jié)合數(shù)字簽名算法，采用JWT-TOKEN 認(rèn)證方式，實現(xiàn)各環(huán)節(jié)人員鑒權(quán)，保證認(rèn)證環(huán)節(jié)的安全性和不可抵賴性。流程通過將自動在整定單內(nèi)加入審閱人電子簽名，并支持審閱批注。

1.3 整定單在線檢索查閱

提供根據(jù)字段精準(zhǔn)搜索、關(guān)鍵詞模糊搜索（便于整定單的快速查詢）兩種檢索方式。詳情頁含整定單預(yù)覽、下載及打印、模板預(yù)覽、下載及打印、關(guān)聯(lián)數(shù)據(jù)展示（包括CT 變比、間隔類型、設(shè)備型號等所有數(shù)據(jù)）、流程信息展示（包括整定單目前流程狀態(tài)、各流程環(huán)節(jié)的審閱人、審閱時間及審閱批注等）等。

2 實現(xiàn)方式

2.1 技術(shù)棧

平臺采用目前最新技術(shù)棧，基于COOL-ADMIN 后臺管理框架（MIT 許可證）,采用TYPESCRIPT 作為全棧開發(fā)語言。前端采用VUE3-VITE，UI 采用Element Plus、后端采用NODE、數(shù)據(jù)庫采用MYSQL、數(shù)據(jù)庫操作采用TYPEORM。

2.2 架構(gòu)

充分運(yùn)用最新的技術(shù)棧，以模塊化、高復(fù)用、風(fēng)格化、精簡化為目標(biāo)構(gòu)建代碼。運(yùn)用VSCODE 代碼編輯器下ESLINT 實時代碼檢查，實現(xiàn)全局代碼的正確性核對；運(yùn)用TYPESCRIPT 相對JAVASCRIPT 新增的強(qiáng)類型、接口、類、繼承特性；運(yùn)用VUE3相對VUE2 新增的組合式API、響應(yīng)式等特性，更好地實現(xiàn)前端組件的高復(fù)用率；運(yùn)用TYPEORM 實現(xiàn)以最高效的方式編寫高質(zhì)量的、松耦合的、可擴(kuò)展的、可維護(hù)的應(yīng)用程序；運(yùn)用VITE 技術(shù)實現(xiàn)面向現(xiàn)代瀏覽器的原生模塊系統(tǒng)ESModule 按需編譯，極大加快編譯速度，提高開發(fā)效率；同時以同一種語言進(jìn)行全棧開發(fā)，代碼風(fēng)格統(tǒng)一。

2.3 界面設(shè)計

由圖1 所示，布局含左側(cè)菜單欄、頂部信息欄和主體三部分。其中，菜單欄通過鑒權(quán)實現(xiàn)動態(tài)展現(xiàn)；頂部信息欄包含導(dǎo)航條和標(biāo)簽頁，并展現(xiàn)當(dāng)前用戶名；主體呈現(xiàn)數(shù)據(jù)表，每行記錄含操作欄，并提供檢索。菜單上，劃分工作臺、資源庫、系統(tǒng)管理、任務(wù)管理共4 個一級菜單。其中，工作臺下的二級菜單包括：我的模板、我的整定單、待校核整定單、已校核整定單、待審核整定單、已審核整定單、待批準(zhǔn)整定單、已批準(zhǔn)整定單共8 個，根據(jù)用戶的權(quán)限顯示其中部分二級菜單；資源庫下的二級菜單包括：模板庫、整定單庫共2 個，提供平臺數(shù)據(jù)庫內(nèi)所有的整定單與模板記錄；系統(tǒng)管理下的二級菜單權(quán)限管理下配置3 個三級菜單，分別為用戶列表（用于管理平臺用戶）、菜單列表（用于配置每個菜單可見用戶組）、角色列表（用于管理平臺用戶組，即權(quán)限的集合）。

圖1 主界面

2.4 安全性設(shè)計

由于本平臺采用前后端分離的架構(gòu)，服務(wù)器對于API 請求的安全性作出更高的要求。如圖2 所示，為平臺不同使用者賦予不同的操作權(quán)限，菜單欄僅顯示與本用戶組相關(guān)的菜單，表格的操作欄僅展現(xiàn)具備權(quán)限按鈕，后端響應(yīng)函數(shù)對于字段已設(shè)置驗證規(guī)則。此外，登錄頁面加入驗證碼，從而避免暴力破解。

圖2 角色配置

2.5 數(shù)據(jù)表設(shè)計

數(shù)據(jù)表字段包括：ID（NUMBER 類型，自動生成）、整定單編號（字段名：SERIESNUMBER，STRING 類型，唯一）、模板（字段名：TEMPLATE，STRING 類型）、整定單（字段名：FILE，STRING類型）、編寫人（字段名：USERWRITE，STRING 類型）、編寫日期（字段名：DATEWRITE，STRING 類型）、編寫備注（字段名：DESCWRITE，STRING 類型）、校核人（字段名：USERCHECK，STRING 類型）、校核日期（字段名：DATECHECK，STRING 類型）、校核備注（字段名：DESCCHECK，STRING 類型）、審核人（字段名：USERVERIFY，STRING 類型）、審核日期（字段名：DATEVERIFY，STRING 類型）、 審核備注（字段名：DESCVERIFY，STRING 類型）、狀態(tài)（字段名：STATUS，STRING類型）、調(diào)度編號（字段名：NUMBER，STRING 類型）、間隔類型（字段名：TYPE，STRING 類型）、地區(qū)（字段名：DISTRICT，STRING 類型）、變電站（字段名：SUBSTATION，STRING 類型）、電壓等級（字段名：VOLTAGE，STRING 類型）、是否為模板（字段名：ISTEMPLATE，BOOLEAN 類型）、設(shè)備廠家（字段名：MANUFACTURER，STRING 類型）、設(shè)備型號（字段名：MODEL，STRING 類型）、軟件版本（字段名：VERSION，STRING 類型）、校驗碼（字段名：CRC，STRING 類型）、CT 變比（字段名：CT，STRING 類型）、PT 變比（字段名：PT，STRING 類型）等、創(chuàng)建時間（TIMESTAMP 類型，自動生成）、修改時間（TIMESTAMP 類型，自動生成）。

2.6 整定單編號生成算法

編號由電壓等級、地區(qū)、變電站名稱、特征碼、編制日期等要素構(gòu)成。例如5SXCH-5555-210809，5 代表為500kV（電壓等級），SX 為紹興的首字母（地區(qū)），CH 為春暉首字母（變電站名稱），5555 為特征碼（由調(diào)度命名及間隔類型決定），210809 代表2021 年8 月9 日（編制日期）。

技術(shù)上，漢字首字母的提取采用PYFL 依賴，時間提取采用DAYJS 依賴，特征碼運(yùn)用正則表達(dá)式生成。如表1 所示，以集合形式存儲，方便后期快速修改。對于無法唯一匹配的特征碼，將提示用戶手動修改。

表1 主要特征碼正則表

2.7 整定單生成算法

新改擴(kuò)建工程中，變電站同期新上的測控多采用同一型號，整定值基本一致。為實現(xiàn)同一類型整定單批量快速創(chuàng)建，平臺內(nèi)所有的模板和整定單均可復(fù)用，且支持模板自定義。技術(shù)上，運(yùn)用DOCXTEMPLATER 依賴。原理上，實現(xiàn)文檔內(nèi)關(guān)鍵詞的替換（如“{電壓等級}”等）。實現(xiàn)效果如圖3 所示。具體的，算法寫在后端，重寫服務(wù)的默認(rèn)ADD 與UPDATE 方法，在方法中加入生成函數(shù)。再新增用于響應(yīng)審閱請求的服務(wù)，也加入該生成函數(shù)。邏輯上，生成函數(shù)內(nèi)首先讀取請求的ID，根據(jù)ID 在數(shù)據(jù)庫中查詢記錄，得到記錄后分解出關(guān)聯(lián)的模板（字段為TEMPLATE）以及其余數(shù)據(jù)（如CT 等），再讀取模板文件，傳入替換的數(shù)據(jù)，將生成的整定單文件存于后端的PUBLIC 對外公開，轉(zhuǎn)換路徑后最終再存于記錄中的整定單（字段為FILE）中即可。

圖3 整定單模板（左）與整定單生成文件（右）

2.8 整定單在線預(yù)覽實現(xiàn)方式

為提高用戶體驗實現(xiàn)了“可見即可得”，技術(shù)上集成KKFILEVIEW 插件。該插件提供API 接口，傳入URL 即可實現(xiàn)DOCX 格式轉(zhuǎn)PDF 和PNG，引入IFRAME 在線預(yù)覽，并支持標(biāo)簽、打印、查詢等功能，如圖4 所示。具體的，在DOCKER 中運(yùn)行KKFILEVIEW 鏡像，本地調(diào)試環(huán)節(jié)下將會暴露在127.0.0.1:8012，其API 采用GET 方式獲取參數(shù)，格式為：127.0.0.1:8012/onlinePreview?url=encodeURIComponent（Base64.encode（url）），即采用GET 請求方式，并在url 參數(shù)處傳入經(jīng)BASE64 編碼后的整定單URL 再進(jìn)行URI 編碼。不接受127.0.0.1 域名的URL，故在啟動前端時需要yarn dev—host，使平臺暴露在192.168.x.x域名下。此時KKVIEWFILE 將把DOCX 轉(zhuǎn)為PNG 圖片格式提供在線預(yù)覽，可在GET 請求中再傳入&officePreviewType=pdf，即轉(zhuǎn)為PDF 格式提供預(yù)覽。最后，在前端加入IFRAME 組件，其SRC 參數(shù)綁定上述結(jié)合后的URL 即可。

圖4 整定單在線預(yù)覽

2.9 角色設(shè)置與權(quán)限分配

平臺共設(shè)置5 種角色，分別為編制人、校核人、審核人、批準(zhǔn)人、管理員。其中，編制人分配整定單的查詢、新增、修改權(quán)限（僅在整定單為該用戶編制且流程在“編制完成”方可生效，其余情況均為禁用態(tài)），工作臺菜單提供“我的模板”和“我的整定單”；校核人分配整定單的查詢、校核權(quán)限，工作臺菜單提供“待校核整定單”和“已校核整定單”；審核人分配整定單的查詢、審核權(quán)限，工作臺菜單提供“待審核整定單”和“已審核整定單”；批準(zhǔn)人分配整定單的查詢、批準(zhǔn)權(quán)限，工作臺菜單提供“待批準(zhǔn)整定單”和“已批準(zhǔn)整定單”；管理員開發(fā)所有權(quán)限及菜單。所有用戶開放資源庫下的“整定單庫”、“模板庫”菜單及查詢權(quán)限。

3 測試

3.1 兼容性

在部分系統(tǒng)及瀏覽器（操作系統(tǒng)：WINDOWS 10、MAC 10.14.1；瀏覽器：CHROME、EDGE）下測試，程序運(yùn)行正常。

3.2 響應(yīng)速度

首次加載與渲染總用時125ms，加載完成后其余頁面打開時間18ms。路由緩存的應(yīng)用，使得再次打開同頁面達(dá)到秒開。

4 效益與成果

整定單在線協(xié)同平臺的應(yīng)用使整定單的編審批全過程實時性大為提升。傳統(tǒng)的全流程多為單線流程，審閱時多遇到因時間問題導(dǎo)致某環(huán)節(jié)的阻塞，紙質(zhì)文件在傳閱過程中也存在丟失的風(fēng)險。在各環(huán)節(jié)當(dāng)面審閱通過后，最后還需將文件掃描成電子文件，所有的數(shù)據(jù)不便檢索。傳統(tǒng)方式的流程過于復(fù)雜，且流程實時性欠佳。而平臺打通整定單從無到有全過程，所有流程均在同一平臺下進(jìn)行，數(shù)據(jù)自動存于數(shù)據(jù)庫，運(yùn)用模糊搜索使得檢索效率極高，且實現(xiàn)自動歸檔，極大方便后期管理。采用模板化的整定單創(chuàng)建方式，僅需修改少量數(shù)據(jù)即可生成，且已有多種表單驗證方式，杜絕低級數(shù)據(jù)錯誤的發(fā)生。

在經(jīng)濟(jì)性方面，可將平臺部署于省公司服務(wù)器，無需額外的服務(wù)器硬件搭建開銷。基礎(chǔ)框架采用MIT 開源協(xié)議，不存在版權(quán)開銷。二次開發(fā)后，可進(jìn)行軟件著作權(quán)登記以及專利保護(hù)。

從自主可控性而言，平臺由公司職工開發(fā)維護(hù)，對平臺的運(yùn)作與配置熟悉，可提供快速的平臺技術(shù)支撐。不依賴已有系統(tǒng)，數(shù)據(jù)完全在控。

5 結(jié)論

整定單在線協(xié)同平臺極大方便了整定單編審批、歸檔管理、內(nèi)容檢索等。通過項目的不斷迭代，已融合目前最新的技術(shù)棧。運(yùn)用更精簡的代碼，實現(xiàn)更完善的功能，構(gòu)建更友好美觀的用戶界面。相比國網(wǎng)公司原有的資料檢索平臺，本平臺不管功能性、運(yùn)行速度、還是界面美觀性等各方面均處于絕對優(yōu)勢。后期通過公司內(nèi)試運(yùn)行，解決更多生產(chǎn)管理實際痛點(diǎn)。