這個(gè)需求我接到的時(shí)候第一反應(yīng)是又是那種表頭十幾列、業(yè)務(wù)邏輯繞三圈的改造。HIS系統(tǒng)里的檢驗(yàn)報(bào)告原本只管打印現(xiàn)在要開放成XHEDITOR在線編輯而且報(bào)告里那些自動(dòng)算好的公式也得跟著轉(zhuǎn)過去不能被當(dāng)成死文本丟掉。聽起來是個(gè)小功能拆開才發(fā)現(xiàn)涉及檢驗(yàn)報(bào)告的結(jié)構(gòu)梳理、公式解析、字符轉(zhuǎn)義、編輯器集成一整條鏈路。這篇就把我在實(shí)際項(xiàng)目里從設(shè)計(jì)到落地的完整過程寫出來方案選型、數(shù)據(jù)結(jié)構(gòu)、核心代碼、踩坑排查都在里面正在做同類改造的同行可以直接參考。1. 先把需求掰開揉碎檢驗(yàn)報(bào)告里的公式到底是什么1.1 一份檢驗(yàn)報(bào)告單通常包含什么處理這種需求的第一步永遠(yuǎn)不是寫代碼而是搞清楚數(shù)據(jù)長(zhǎng)什么樣。常規(guī)的檢驗(yàn)報(bào)告單至少包含四塊內(nèi)容。第一塊是患者與標(biāo)本信息姓名、性別、年齡、科室、標(biāo)本類型、采樣時(shí)間。第二塊是檢驗(yàn)項(xiàng)目的明細(xì)結(jié)果每一項(xiàng)包含項(xiàng)目名稱、結(jié)果值、單位、參考區(qū)間、異常標(biāo)志這部分是報(bào)告的主體。第三塊是計(jì)算項(xiàng)目比如陰離子間隙AG、肌酐清除率CCr、BMI之類它們不是儀器直接測(cè)出來的而是由多個(gè)檢驗(yàn)結(jié)果通過公式算出來的。第四塊是審核信息包括檢驗(yàn)醫(yī)師的簽字、審核備注、報(bào)告解釋性文字。從系統(tǒng)實(shí)現(xiàn)角度看前兩塊數(shù)據(jù)在報(bào)告模板里是動(dòng)態(tài)填充的后兩塊是需要人工參與維護(hù)的內(nèi)容。在線編輯功能要解決的核心問題就是讓第二塊和第三塊既能自動(dòng)計(jì)算又能被人工調(diào)整調(diào)整之后仍然保持正確的格式和公式關(guān)系。這里有個(gè)很容易被忽略的點(diǎn)報(bào)告單上的公式不是一個(gè)值而是一個(gè)計(jì)算過程。比如AG Na - (Cl- HCO3-)如果只把結(jié)果值傳過去技師想改一下Na的值A(chǔ)G不會(huì)跟著變整個(gè)報(bào)告就失真了。所以需求拆解出來之后底線是兩條第一公式的展示形態(tài)要保留計(jì)算過程第二公式的結(jié)果值要能隨原始數(shù)據(jù)變化。1.2 檢驗(yàn)公式的三種典型形態(tài)在HIS系統(tǒng)里檢驗(yàn)公式大致分三類處理方式完全不同。第一類是算術(shù)運(yùn)算型也是最常見的。AG、CCr、GFR、BMI、LDL-C估算都是通過加減乘除計(jì)算出來的。這類公式的特點(diǎn)是參數(shù)明確、算法固定適合用表達(dá)式解析器動(dòng)態(tài)求值。第二類是條件判斷型比如根據(jù)某個(gè)指標(biāo)是否超標(biāo)來生成異常標(biāo)志、決定報(bào)告提示語(yǔ)。報(bào)告單上常見的↑↓箭頭、加粗提示、危急值標(biāo)記都算這一類。它們本質(zhì)上不是算術(shù)公式而是規(guī)則判斷在HTML層面往往體現(xiàn)為樣式切換或者文案拼接。第三類是文本拼裝型比如該患者HbA1c偏高建議結(jié)合血糖結(jié)果綜合評(píng)估這類解釋性語(yǔ)句。以前的做法是在后端寫死在模板里現(xiàn)在要支持在線編輯這類文本就必須開放出來變成可改寫的富文本內(nèi)容。搞清楚這三種類型后面做方案設(shè)計(jì)才不會(huì)走偏。算術(shù)型需要真正的公式引擎支持條件判斷型需要規(guī)則渲染文本拼裝型則需要編輯器層面的自由度。1.3 需求邊界什么必須在線編輯什么保持離線在線編輯不是把整個(gè)報(bào)告都放開那會(huì)讓HIS系統(tǒng)的嚴(yán)謹(jǐn)性崩掉。實(shí)際項(xiàng)目里需要?jiǎng)澢宄吔?。必須在線編輯的內(nèi)容是報(bào)告描述區(qū)域、計(jì)算結(jié)果區(qū)域的格式化調(diào)整、備注信息的增刪改。這些內(nèi)容與患者本次檢驗(yàn)結(jié)果直接相關(guān)技師在審核時(shí)需要微調(diào)而且需要所見即所得。不能放開的內(nèi)容是患者基本信息、檢驗(yàn)項(xiàng)目名稱、單位、參考區(qū)間這些由LIS系統(tǒng)或儀器下發(fā)的數(shù)據(jù)。這些屬于質(zhì)量控制范圍如果在編輯器里被改了溯源就出問題了。我的做法是把這些字段在編輯器初始化之前全部用占位符替換掉編輯器里只能看到渲染后的占位符文本不能直接編輯。另外還需要明確一點(diǎn)編輯器的定位是人工干預(yù)通道不是數(shù)據(jù)錄入主通道。主數(shù)據(jù)永遠(yuǎn)來自檢驗(yàn)流程編輯器的改動(dòng)要記錄日志、要可追溯。沒有這條約束后面驗(yàn)收的時(shí)候會(huì)被人質(zhì)疑數(shù)據(jù)可信度。2. 方案選型三條路線試下來說說取舍2.1 路線一后端全部算完直接吐HTML給編輯器當(dāng)展示殼這個(gè)方案最直覺后端拿到檢驗(yàn)結(jié)果把公式算好整個(gè)報(bào)告渲染成一段HTML字符串丟給XHEDITOR加載。編輯器看起來是能編輯了但本質(zhì)上是看一張靜態(tài)網(wǎng)頁(yè)。試過之后發(fā)現(xiàn)了明顯問題。技師在編輯器里改了某個(gè)指標(biāo)的解釋文字保存拿到的是一整段HTML我又沒法從這段HTML里反推出哪些是原始數(shù)據(jù)、哪些是人工改動(dòng)。下一次重打報(bào)告同樣的內(nèi)容又得重新生成。更麻煩的是報(bào)告里某個(gè)結(jié)果值被人工修正過但下一次檢驗(yàn)數(shù)據(jù)一刷新修正值直接被覆蓋了。這個(gè)方案適合演示不適合生產(chǎn)。它致命的缺陷是把數(shù)據(jù)和展示揉成了一團(tuán)丟了結(jié)構(gòu)化信息后面的版本管理、數(shù)據(jù)核驗(yàn)全都做不了。2.2 路線二公式占位符加字典替換編輯器做兜底微調(diào)這個(gè)方案是從模板引擎的思路里借鑒過來的也是我最終的選型。核心思路是報(bào)告模板里不寫死數(shù)值而是保留占位符比如檢驗(yàn)結(jié)果占位符寫成${GLU}公式計(jì)算項(xiàng)寫成${AG}。后端在把內(nèi)容交給編輯器之前先做一輪占位符替換把${GLU}替換成真實(shí)的血糖值把${AG}替換成AG的完整計(jì)算過程和結(jié)果。這樣編輯器里看到的是一份完整的報(bào)告但底層數(shù)據(jù)結(jié)構(gòu)里仍然保留了公式定義的引用關(guān)系。這個(gè)方案的好處是邊界清晰。占位符替換是單向的從數(shù)據(jù)到展示編輯器保存回來的HTML會(huì)再做一次逆向解析把人工改過的部分和原始數(shù)據(jù)部分分離。人工修改的區(qū)域記錄成覆蓋層下次刷新數(shù)據(jù)時(shí)可以選擇保留覆蓋還是重新計(jì)算。這里要注意一個(gè)細(xì)節(jié)占位符本身的設(shè)計(jì)要避開HTML轉(zhuǎn)義陷阱。我當(dāng)時(shí)用的是雙大括號(hào)風(fēng)格方便正則匹配也能避免和CSS里的花括號(hào)語(yǔ)法沖突。2.3 路線三前端引入公式引擎全部動(dòng)態(tài)計(jì)算這個(gè)方案聽起來最“先進(jìn)”把公式定義下發(fā)到瀏覽器XHEDITOR內(nèi)部插入一段計(jì)算腳本用戶在界面上改一個(gè)數(shù)值公式結(jié)果立即聯(lián)動(dòng)刷新。實(shí)話說純前端做這個(gè)完全可行有很多現(xiàn)成的表達(dá)式解析庫(kù)能用。但在HIS這種環(huán)境里我最終沒有選它原因有兩個(gè)。第一是安全邊界問題。檢驗(yàn)報(bào)告的公式計(jì)算如果全部交給前端相當(dāng)于把部分業(yè)務(wù)邏輯轉(zhuǎn)移到瀏覽器端執(zhí)行后端對(duì)數(shù)據(jù)正確性的控制力會(huì)變?nèi)酢Ｈf(wàn)一前端腳本被篡改或者版本不一致報(bào)告結(jié)果就會(huì)出偏差這在醫(yī)療場(chǎng)景里是沒法接受的。第二是兼容性成本。醫(yī)院的環(huán)境比一般企業(yè)復(fù)雜得多很多科室的瀏覽器還是老版本部分客戶端甚至是內(nèi)網(wǎng)專用終端。把復(fù)雜的表達(dá)式解析邏輯放在前端等于給自己埋了一堆兼容性雷。所以路線三只被我用來做“預(yù)覽聯(lián)動(dòng)”就是技師在編輯器里臨時(shí)改數(shù)值時(shí)用前端腳本做一個(gè)即時(shí)預(yù)覽效果。真正落庫(kù)、真正打印的報(bào)告結(jié)果仍然由后端統(tǒng)一下發(fā)。2.4 為什么XHEDITOR在這個(gè)場(chǎng)景里夠用很多同行會(huì)問為什么不用更流行的編輯器。在這個(gè)項(xiàng)目里選XHEDITOR不是因?yàn)樗δ茏钊且驗(yàn)樗鼊偤脻M足場(chǎng)景需求輕量、可定制工具欄、有源碼模式、和舊系統(tǒng)的jQuery技術(shù)棧兼容。檢驗(yàn)報(bào)告在線編輯需要的核心能力其實(shí)只有幾個(gè)段落加粗、文字換行、上下標(biāo)處理、表格插入、源碼查看。前四個(gè)XHEDITOR原生支持最后一個(gè)源碼模式特別關(guān)鍵——技師可以把通過其他途徑規(guī)范的HTML直接貼進(jìn)源碼區(qū)省去來回格式兼容的麻煩。另一個(gè)重要原因是環(huán)境約束。HIS系統(tǒng)往往跑在內(nèi)網(wǎng)甚至專網(wǎng)環(huán)境很多外網(wǎng)資源無(wú)法加載。XHEDITOR這個(gè)體積小、無(wú)強(qiáng)依賴的編輯器適合放到內(nèi)網(wǎng)靜態(tài)資源目錄不需要外網(wǎng)CDN也不依賴復(fù)雜的打包工具鏈。對(duì)醫(yī)療信息化場(chǎng)景來說有時(shí)候“剛好夠用”“容易部署”比“功能強(qiáng)大”更重要。3. 落地實(shí)現(xiàn)從模板結(jié)構(gòu)到公式回顯的完整鏈路3.1 模板與公式的數(shù)據(jù)表設(shè)計(jì)數(shù)據(jù)表設(shè)計(jì)是要先做好的地基。我在項(xiàng)目里建了兩張核心表一張存報(bào)告模板一張存公式定義。報(bào)告模板表的關(guān)鍵字段如下CREATE TABLE report_template ( id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT 模板ID, template_code VARCHAR(64) NOT NULL COMMENT 模板編碼對(duì)應(yīng)檢驗(yàn)類別, template_name VARCHAR(128) COMMENT 模板名稱, content_html MEDIUMTEXT COMMENT 模板正文含占位符, version_no INT DEFAULT 1 COMMENT 版本號(hào), status TINYINT DEFAULT 1 COMMENT 狀態(tài)1啟用0停用, create_time DATETIME, update_time DATETIME ) COMMENT 檢驗(yàn)報(bào)告模板表;公式定義表的設(shè)計(jì)要能支撐表達(dá)式解析和動(dòng)態(tài)求值CREATE TABLE report_formula ( id BIGINT PRIMARY KEY AUTO_INCREMENT, formula_code VARCHAR(64) NOT NULL COMMENT 公式編碼如AG、CCr, formula_name VARCHAR(128) COMMENT 公式名稱, formula_expr VARCHAR(512) NOT NULL COMMENT 計(jì)算公式如Na-(ClHCO3), result_unit VARCHAR(32) COMMENT 結(jié)果單位, decimal_places INT DEFAULT 2 COMMENT 保留小數(shù)位數(shù), status TINYINT DEFAULT 1, create_time DATETIME ) COMMENT 檢驗(yàn)報(bào)告公式定義表;這里有個(gè)細(xì)節(jié)想強(qiáng)調(diào)公式編碼要跟報(bào)告模板里的占位符約定一致。比如模板里寫${AG}公式表里的formula_code就存AG。前端渲染時(shí)按規(guī)則把所有占位符找出來到公式表里去匹配對(duì)應(yīng)定義匹配不到的直接報(bào)錯(cuò)避免出現(xiàn)報(bào)告上某個(gè)位置空白。至于原始檢驗(yàn)結(jié)果數(shù)據(jù)一般直接存在檢驗(yàn)結(jié)果明細(xì)表里結(jié)構(gòu)大致是檢驗(yàn)申請(qǐng)?zhí)?、?xiàng)目編碼、結(jié)果值、單位、參考上下限。公式計(jì)算時(shí)通過申請(qǐng)?zhí)柲玫疆?dāng)次檢驗(yàn)的全部結(jié)果值再用項(xiàng)目編碼去匹配公式參數(shù)。3.2 公式表達(dá)式的存儲(chǔ)與解析公式表達(dá)式存的是帶項(xiàng)目編碼的文本比如AG Na - (Cl HCO3)其中Na、Cl、HCO3是檢驗(yàn)項(xiàng)目的編碼。解析要解決兩個(gè)問題一是把中綴表達(dá)式轉(zhuǎn)成可計(jì)算的格式二是從檢驗(yàn)結(jié)果集合里按項(xiàng)目編碼取到對(duì)應(yīng)的值。最穩(wěn)妥的做法是把表達(dá)式拆成token用經(jīng)典的中綴轉(zhuǎn)后綴算法求值。我把這個(gè)過程整理成三步。第一步詞法分析。把字符串拆成操作數(shù)、運(yùn)算符、括號(hào)三類token。這里要注意項(xiàng)目編碼可能包含字母數(shù)字和特殊字符例如HDL-C、LDL-C中間有橫線拆token的時(shí)候容易把減號(hào)當(dāng)成運(yùn)算符。解決的辦法是維護(hù)一個(gè)項(xiàng)目編碼字典解析時(shí)優(yōu)先按字典里的最長(zhǎng)匹配去識(shí)別操作數(shù)。第二步中綴轉(zhuǎn)后綴。用棧處理運(yùn)算符優(yōu)先級(jí)把表達(dá)式轉(zhuǎn)成逆波蘭式避免括號(hào)嵌套帶來的優(yōu)先級(jí)混亂。這個(gè)算法是編譯原理里的基礎(chǔ)內(nèi)容實(shí)現(xiàn)起來并不復(fù)雜。第三步求值。遍歷后綴表達(dá)式遇到操作數(shù)就從結(jié)果集合里取數(shù)值壓棧遇到運(yùn)算符就從棧里彈出兩個(gè)數(shù)值計(jì)算計(jì)算完再入棧。最終棧里剩下的就是結(jié)果。核心的Java實(shí)現(xiàn)大致是這樣public class FormulaEvaluator { private MapString, BigDecimal resultMap; public FormulaEvaluator(MapString, BigDecimal resultMap) { this.resultMap resultMap; } public BigDecimal evaluate(String expression) { ListString tokens tokenize(expression); ListString rpn infixToRpn(tokens); DequeBigDecimal stack new ArrayDeque(); for (String token : rpn) { if (isOperator(token)) { BigDecimal b stack.pop(); BigDecimal a stack.pop(); stack.push(applyOperator(a, b, token)); } else { BigDecimal val resultMap.get(token); if (val null) { throw new FormulaException(缺少參數(shù): token); } stack.push(val); } } return stack.pop(); } }實(shí)際使用時(shí)還需要給每個(gè)公式配置小數(shù)位數(shù)和結(jié)果單位。AG默認(rèn)保留1位小數(shù)CCr這種通常保留2位。小數(shù)位配置在公式表里統(tǒng)一管理避免前端展示層臨時(shí)格式化時(shí)出現(xiàn)不一致。這里有一個(gè)容易踩的坑檢驗(yàn)結(jié)果里有些項(xiàng)目是負(fù)數(shù)有些項(xiàng)目可能為0。求值的時(shí)候如果某個(gè)參數(shù)結(jié)果為空直接拋出異常比靜默返回0更安全。因?yàn)闄z驗(yàn)報(bào)告上的公式為空會(huì)讓臨床醫(yī)生困惑寧可讓技師看到明確報(bào)錯(cuò)也不能讓錯(cuò)誤數(shù)據(jù)悄悄出現(xiàn)。3.3 后端計(jì)算、替換與轉(zhuǎn)義的順序模板渲染這塊順序很重要順序錯(cuò)了渲染結(jié)果就會(huì)出問題。我最終采用的渲染順序是先做公式計(jì)算再做占位符替換最后做HTML轉(zhuǎn)義。公式計(jì)算要在占位符替換之前完成因?yàn)楣秸嘉环鎿Q時(shí)需要的是計(jì)算結(jié)果值而公式定義里嵌套的那些項(xiàng)目編碼占位符又是從模板里提取的。實(shí)際操作時(shí)我是先從模板HTML中用正則把所有${...}提取出來過濾出公式類型的占位符逐個(gè)調(diào)用FormulaEvaluator計(jì)算得到一個(gè)計(jì)算結(jié)果Map。然后第二次掃描模板把普通結(jié)果占位符和公式占位符統(tǒng)一替換。轉(zhuǎn)義這一步要格外小心。檢驗(yàn)結(jié)果里經(jīng)常出現(xiàn)單位符號(hào)、上下標(biāo)、正負(fù)號(hào)直接替換進(jìn)去會(huì)被瀏覽器當(dāng)成HTML標(biāo)簽解析。比如結(jié)果值里的大于號(hào)小于號(hào)尤其是0.1這種表示低于檢測(cè)下限的結(jié)果如果不轉(zhuǎn)義HTML結(jié)構(gòu)直接就被破壞了。我的處理是把結(jié)果值替換進(jìn)模板時(shí)統(tǒng)一經(jīng)過一個(gè)安全封裝方法public static String safeValue(String rawValue) { return StringEscapeUtils.escapeHtml4(rawValue); }這里有一個(gè)關(guān)鍵限制只對(duì)替代進(jìn)去的數(shù)值做轉(zhuǎn)義模板本身保留原樣。也就是說技術(shù)人員設(shè)計(jì)模板時(shí)可以寫合法的HTML結(jié)構(gòu)而動(dòng)態(tài)數(shù)據(jù)進(jìn)來時(shí)統(tǒng)一做安全檢查防止值里混入非預(yù)期內(nèi)容。替換完成后的這段HTML就是交給XHEDITOR加載的內(nèi)容。此時(shí)編輯器里看到的報(bào)告公式結(jié)果是真實(shí)計(jì)算出來的格式是正常的數(shù)據(jù)部分也限制了可修改范圍。3.4 XHEDITOR初始化與編輯內(nèi)容保存XHEDITOR的集成本身不復(fù)雜但有幾個(gè)配置項(xiàng)要想清楚。初始化代碼如下function initReportEditor() { var editor $(#reportContent).xhEditor({ tools: Cut,Copy,Paste,|,Bold,Italic,Underline,StrikeThrough,|,Superscript,Subscript,|,Removeformat,|,InsertTable,|,Source, skin: office2003, loadCSS: /static/css/report_print.css }); editor.loadContent(initialHtml); window.reportEditor editor; }工具欄配置需要根據(jù)檢驗(yàn)報(bào)告的實(shí)際編輯場(chǎng)景裁剪。下標(biāo)Superscript和上標(biāo)Subscript必須保留檢驗(yàn)報(bào)告里經(jīng)常用到化學(xué)式和單位例如H?O、×10?/L。表格插入要保留因?yàn)橛行﹫?bào)告需要臨時(shí)加兩列表格做補(bǔ)充說明。鏈接和圖片上傳建議去掉內(nèi)網(wǎng)環(huán)境不需要而且圖片可能會(huì)破壞報(bào)告的打印排版。獲取編輯內(nèi)容和保存的代碼function saveReport() { var editorHtml window.reportEditor.getSource(); var postData { applyNo: applyNo, templateCode: templateCode, editedHtml: editorHtml }; // 發(fā)送到后端保存 }這里推薦用getSource()拿源碼而不是getHtml()。因?yàn)闄z驗(yàn)報(bào)告里有些手工調(diào)整的格式比如特殊縮進(jìn)、行內(nèi)樣式只有源碼模式能精確保存下來。拿到的源碼在后端還需要做一次反向解析把人工編輯產(chǎn)生的覆蓋層數(shù)據(jù)和原始占位符對(duì)應(yīng)的動(dòng)態(tài)數(shù)據(jù)分開存儲(chǔ)。保存后還有一步校驗(yàn)把提交回來的HTML里的動(dòng)態(tài)數(shù)據(jù)區(qū)域重新檢查一遍確保沒有出現(xiàn)被篡改的檢驗(yàn)數(shù)值。這一步用CSS選擇器把動(dòng)態(tài)數(shù)據(jù)區(qū)標(biāo)識(shí)出來白名單校驗(yàn)即可。4. 實(shí)操中的典型問題與排查心得4.1 特殊符號(hào)亂碼與上下標(biāo)錯(cuò)位第一個(gè)讓我卡住兩天的問題是化學(xué)符號(hào)和單位上下標(biāo)的顯示錯(cuò)亂。報(bào)告顯示μmol/L時(shí)μ這個(gè)希臘字母在某些編輯器里會(huì)被吞成亂碼H?O的下標(biāo)2在別的編輯器里又會(huì)變成普通文本。后來排查發(fā)現(xiàn)根因有兩層。第一層是字符編碼頁(yè)面整體字符集必須統(tǒng)一成UTF-8數(shù)據(jù)庫(kù)連接串里也要顯式聲明字符編碼。第二層是轉(zhuǎn)換規(guī)則檢驗(yàn)結(jié)果字符串里如果出現(xiàn)了Unicode上下標(biāo)字符例如U2082下標(biāo)2在進(jìn)入HTML前要統(tǒng)一轉(zhuǎn)換為sub標(biāo)簽否則瀏覽器會(huì)顯示異常。處理方案是做一個(gè)預(yù)處理方法掃描結(jié)果字符串把上標(biāo)和下標(biāo)Unicode字符映射成對(duì)應(yīng)的HTML標(biāo)簽包裹。映射表寫清楚所有常用上標(biāo)和下標(biāo)字符覆蓋化學(xué)式和單位常見場(chǎng)景。另外乘號(hào)×、正負(fù)號(hào)±、大于等于這些符號(hào)在HTML里要保存為命名實(shí)體times;、plusmn;、ge;直接用UTF-8字符在某些瀏覽器和老打印控件下會(huì)出現(xiàn)渲染異常。這條經(jīng)驗(yàn)讓我把報(bào)告的字符表做了全面檢測(cè)凡是進(jìn)入HTML的文本統(tǒng)一走一個(gè)字符標(biāo)準(zhǔn)化方法。4.2 空值、零值和精度問題檢驗(yàn)結(jié)果不是每次都有值。有些項(xiàng)目沒做有些項(xiàng)目低于檢測(cè)下限有些項(xiàng)目?jī)x器沒有報(bào)數(shù)這些空值場(chǎng)景在公式計(jì)算時(shí)特別容易出問題。我定的規(guī)則是公式計(jì)算時(shí)參數(shù)為空或非法值直接拋錯(cuò)并在報(bào)告上顯示公式參數(shù)缺失由檢驗(yàn)技師確定原因。絕不默認(rèn)為0。為什么不能默認(rèn)0因?yàn)?會(huì)經(jīng)過運(yùn)算變成一個(gè)看似合理的數(shù)字比如分母為0時(shí)計(jì)算結(jié)果無(wú)窮大還是0語(yǔ)義完全不同臨床醫(yī)生會(huì)誤解為真實(shí)測(cè)量結(jié)果。精度問題上我踩過一次坑。有些結(jié)果值本身是浮點(diǎn)型運(yùn)算后出現(xiàn)0.9999999這種長(zhǎng)尾。這個(gè)在展示上會(huì)讓人懷疑系統(tǒng)有bug。解決方案是采用BigDecimal運(yùn)算在公式表里配置每類公式的舍入位數(shù)最終結(jié)果統(tǒng)一由后端格式化后在替換進(jìn)HTML。前端不做任何精度處理避免兩端規(guī)則不統(tǒng)一導(dǎo)致不同步。4.3 報(bào)告模板版本管理與編輯日志在線編輯放開之后馬上面臨一個(gè)新問題模板改錯(cuò)了怎么辦技師把某個(gè)提示語(yǔ)寫壞了或者格式調(diào)亂了需要能恢復(fù)到之前的狀態(tài)。模板本身要有版本號(hào)。每次內(nèi)容保存如果檢測(cè)到模板結(jié)構(gòu)變化生成一個(gè)新版本舊版本進(jìn)入歷史列表。這個(gè)設(shè)計(jì)實(shí)現(xiàn)起來成本不高兩張表加一個(gè)復(fù)制邏輯但價(jià)值非常大。編輯日志也是必須的。誰(shuí)在什么時(shí)間改了哪個(gè)報(bào)告、改了什么內(nèi)容都要留痕。這里不需要記錄全量HTML只記錄diff信息或者只記錄編輯前后版本號(hào)再加上操作人、操作時(shí)間就夠用了。醫(yī)療信息系統(tǒng)對(duì)可追溯性的要求決定了這個(gè)功能不是可有可無(wú)的。4.4 外部粘貼內(nèi)容導(dǎo)致的樣式污染技師從Word或者網(wǎng)頁(yè)里復(fù)制一段說明文字進(jìn)編輯器這看起來是個(gè)普通操作但在XHEDITOR環(huán)境下會(huì)引起麻煩。Word粘貼的內(nèi)容會(huì)帶大量?jī)?nèi)聯(lián)樣式和無(wú)效標(biāo)簽例如span stylemso-spacerun:yes渲染出來格式混亂打印時(shí)更加失控。排查時(shí)的現(xiàn)象是整個(gè)報(bào)告多了一堆不規(guī)則的縮進(jìn)、奇怪的間距部分文字字號(hào)忽大忽小。分析后確認(rèn)是Word粘貼內(nèi)容帶的樣式和報(bào)告模板的CSS沖突。解決方案是在保存時(shí)做一次HTML清洗把白名單之外的全部屬性過濾掉。保留的標(biāo)簽只有p、br、span、b、strong、i、sub、sup、table、tr、td屬性只保留colspan、rowspan、width、height幾個(gè)必要項(xiàng)。清洗前在源碼模式里去掉Word粘貼那段XML頭信息效果會(huì)更好。這個(gè)清洗函數(shù)本身不復(fù)雜但字段相當(dāng)考驗(yàn)細(xì)心建議收集一批真實(shí)粘貼場(chǎng)景的HTML慢慢積累過濾規(guī)則一次做完美不太現(xiàn)實(shí)。5. 一點(diǎn)項(xiàng)目落地后的體會(huì)這套方案做完回過頭來看自己當(dāng)時(shí)的第一反應(yīng)其實(shí)低估了這類需求的復(fù)雜度。檢驗(yàn)報(bào)告在線編輯這個(gè)事表面上是給HIS加一個(gè)富文本編輯器實(shí)際上是打破了過去報(bào)告內(nèi)容由后端統(tǒng)一生成的單一路徑。只要編輯器介入就會(huì)牽出數(shù)據(jù)邊界、公式解析、版本控制、安全轉(zhuǎn)義這一整串問題。我最初的方案選了最簡(jiǎn)單粗暴的后端整段渲染結(jié)果被反反復(fù)復(fù)的需求調(diào)整打臉最后回到占位符加替換的思路才真正跑通。我在實(shí)際項(xiàng)目里獲得的最大教訓(xùn)是醫(yī)療信息化系統(tǒng)的改動(dòng)任何功能都同時(shí)存在系統(tǒng)正確性和數(shù)據(jù)可溯源性兩個(gè)評(píng)價(jià)標(biāo)準(zhǔn)。在線編輯功能好不好用是體驗(yàn)問題但動(dòng)過的數(shù)據(jù)能不能追回來、算出來的結(jié)果有沒有依據(jù)是質(zhì)量問題。所以那些看起來增加工作量的事情——反向解析、編輯日志、模板版本——一個(gè)都不能省。最后再分享一個(gè)小技巧在XHEDITOR初始化之前預(yù)留一個(gè)初始內(nèi)容快照保存時(shí)如果編輯后的內(nèi)容與快照完全一致就不用寫數(shù)據(jù)庫(kù)。這個(gè)優(yōu)化雖然很小但能過濾掉大量只打開了沒改的無(wú)效操作歷史數(shù)據(jù)干凈了后面追查改動(dòng)記錄會(huì)輕松很多。