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

周耀龍 曾偉 計(jì)榮榮 單禹 陳科 張波

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

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

1 功能介紹

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

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

1.2 整定單在線審批

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

1.3 整定單在線檢索查閱

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

2 實(shí)現(xiàn)方式

2.1 技術(shù)棧

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

2.2 架構(gòu)

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

2.3 界面設(shè)計(jì)

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

圖1 主界面

2.4 安全性設(shè)計(jì)

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

圖2 角色配置

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

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

2.6 整定單編號(hào)生成算法

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

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

表1 主要特征碼正則表

2.7 整定單生成算法

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

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

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

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

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

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

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

3 測(cè)試

3.1 兼容性

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

3.2 響應(yīng)速度

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

4 效益與成果

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

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

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

5 結(jié)論

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