1. 從單體HIS到SaaS門診系統(tǒng)這波重構(gòu)到底解決了什么我早年在做診所信息化的時(shí)候最頭疼的就是“每家診所一套系統(tǒng)”這種搞法。今天這家要加個(gè)中藥庫明天那家要改個(gè)計(jì)費(fèi)規(guī)則每次都是改一處代碼、發(fā)一個(gè)新版、運(yùn)維直接崩潰。到后來我徹底想明白一件事醫(yī)療軟件要走下去必須從“項(xiàng)目定制”轉(zhuǎn)向“產(chǎn)品化 多租戶”。而我最近在深耕的一套SaaS門診系統(tǒng)源碼技術(shù)棧選的就是后端SpringBoot、前端Vue.js——這套組合做出來的東西不光是能給門診用更是一套可以反復(fù)交付的“醫(yī)療數(shù)字化解決方案”。很多朋友一聽到“醫(yī)療系統(tǒng)”就心里發(fā)怵覺得又是HIS又是LIS又是PACS復(fù)雜度直接拉滿。確實(shí)醫(yī)院級(jí)的信息系統(tǒng)是很重但門診這個(gè)場(chǎng)景其實(shí)非常適合用SaaS模式切入。原因很直觀門診的業(yè)務(wù)流程相對(duì)標(biāo)準(zhǔn)——掛號(hào)、分診、醫(yī)生接診、開方、收費(fèi)、發(fā)藥、復(fù)診環(huán)環(huán)相扣但又不像三甲醫(yī)院那樣存在極其復(fù)雜的會(huì)診、手術(shù)、病區(qū)流轉(zhuǎn)。把這一套核心流程做扎實(shí)做成多租戶可配置的產(chǎn)品一家診所從部署到上線可以壓縮到一周以內(nèi)而且后續(xù)的升級(jí)維護(hù)都在云端完成不用再背著電腦去現(xiàn)場(chǎng)改Bug。這篇文章不打算寫那種“本項(xiàng)目基于XX技術(shù)實(shí)現(xiàn)了XX功能”的套話我就直接以這套系統(tǒng)的源碼設(shè)計(jì)為線索把SaaS門診系統(tǒng)的架構(gòu)思路、SpringBootVue.js落地時(shí)的關(guān)鍵決策、多租戶怎么設(shè)計(jì)、以及我從實(shí)際項(xiàng)目中踩過的坑都翻出來講一遍。如果你正準(zhǔn)備在醫(yī)療信息化領(lǐng)域選型或者你已經(jīng)拿到一套類似的源碼想二次開發(fā)這篇文章應(yīng)該能幫你省掉不少試錯(cuò)時(shí)間。2. 為什么偏偏是SpringBoot Vue.js選型邏輯拆給你看2.1 后端SpringBoot不是因?yàn)樗鸲且驗(yàn)樗笆⌒摹贬t(yī)療系統(tǒng)的后端有個(gè)很明顯的特點(diǎn)并發(fā)量不會(huì)特別大但事務(wù)一致性要求極高。門診高峰期也就幾百號(hào)人同時(shí)在掛號(hào)、開單、繳費(fèi)這點(diǎn)壓力對(duì)現(xiàn)代后端框架來說都是小場(chǎng)面。真正難的是業(yè)務(wù)規(guī)則復(fù)雜、數(shù)據(jù)關(guān)系緊密、權(quán)限模型細(xì)膩。比如一位患者掛了號(hào)之后醫(yī)生工作站要能立刻看到他的候診狀態(tài)還要能拉出歷史病歷收費(fèi)窗口要能根據(jù)醫(yī)生開的處方自動(dòng)計(jì)算醫(yī)保統(tǒng)籌和個(gè)人自付部分——這些操作橫跨多個(gè)表、多個(gè)服務(wù)對(duì)事務(wù)和可靠性的要求是“一條都不能錯(cuò)”。SpringBoot在這個(gè)場(chǎng)景里幾乎是量身定做的。它把Spring生態(tài)里那些繁瑣的XML配置全部干掉用自動(dòng)配置把數(shù)據(jù)源、事務(wù)管理、Web層全部串起來。我接手這套源碼時(shí)的第一感受就是工程結(jié)構(gòu)非常干凈controller、service、mapper、entity分層清晰甚至不用看文檔憑類名就能定位到某段業(yè)務(wù)邏輯。再加上spring-boot-starter-validation參數(shù)校驗(yàn)、spring-boot-starter-security做登錄鑒權(quán)這些基礎(chǔ)能力全部是開箱即用的我可以在核心業(yè)務(wù)上多花精力而不是和一堆配置搏斗。還有個(gè)點(diǎn)是SpringBoot的內(nèi)嵌Tomcat。傳統(tǒng)WAR包部署要裝獨(dú)立的Tomcat、調(diào)JVM參數(shù)、配數(shù)據(jù)源麻煩得很。內(nèi)嵌容器直接java -jar一條命令就能起服務(wù)在門診這種IT力量薄弱的場(chǎng)景里特別實(shí)用——很多小診所連個(gè)專職運(yùn)維都沒有你把一個(gè)可執(zhí)行Jar包扔上去配好數(shù)據(jù)庫就行省心。2.2 前端Vue.js讓醫(yī)生和護(hù)士愿意用系統(tǒng)的關(guān)鍵說句可能得罪人的話很多醫(yī)療系統(tǒng)的失敗不是功能不夠而是界面太丑、操作太繞。門診醫(yī)生一天要看幾十上百個(gè)號(hào)如果開個(gè)處方要點(diǎn)七八次鼠標(biāo)他寧可手寫。所以前端框架的選型直接決定了系統(tǒng)最后是被天天用還是被丟在角落里吃灰。Vue.js在這一塊的優(yōu)勢(shì)是漸進(jìn)式、組件化、上手平滑。它的響應(yīng)式數(shù)據(jù)綁定讓我在寫醫(yī)護(hù)工作臺(tái)時(shí)非常舒服當(dāng)醫(yī)生選中一個(gè)患者右側(cè)的“歷史病歷”“過敏史”“近期檢驗(yàn)結(jié)果”面板自動(dòng)刷新這些聯(lián)動(dòng)如果用原生jQuery去寫能寫到你懷疑人生但Vue里這就是幾個(gè)響應(yīng)式變量和計(jì)算屬性的事。再加上vue-router做頁面路由vuex或pinia做全局狀態(tài)管理整個(gè)門診工作臺(tái)——從候診大屏到醫(yī)生接診頁再到收費(fèi)劃價(jià)頁——可以拆成幾十個(gè)獨(dú)立組件每個(gè)組件只管自己的事。我做這套系統(tǒng)的前端時(shí)還特別注意了一個(gè)細(xì)節(jié)操作反饋速度。醫(yī)生點(diǎn)擊“保存處方”之后如果超過一秒沒反應(yīng)就會(huì)焦慮。Vue的異步更新機(jī)制配合SpringBoot的接口響應(yīng)在局域網(wǎng)環(huán)境下基本能做到毫秒級(jí)反饋。配合Element UI這類組件庫表格、表單、日期選擇器這些醫(yī)療界面里的高頻控件都能快速搭建。2.3 組合起來看API驅(qū)動(dòng)的前后端分離是SaaS化的地基選SpringBootVue.js不只是為了開發(fā)效率更是因?yàn)檫@對(duì)組合天然就是前后端分離 純API交互的樣板。前端項(xiàng)目跑在Nginx上通過HTTP請(qǐng)求訪問后端RESTful接口。這一層分離對(duì)SaaS模式至關(guān)重要——我可以在不改前端代碼的情況下隨時(shí)調(diào)整后端服務(wù)反過來我可以給不同的租戶不同診所提供不同的前端主題但后端服務(wù)還是同一套。拿這套源碼里最典型的交互場(chǎng)景舉例醫(yī)生在Vue前端開完處方點(diǎn)擊保存后前端通過axios發(fā)送一個(gè)包含患者ID、醫(yī)生ID、藥品明細(xì)、用量用法的JSON對(duì)象到/api/prescription/save接口。后端SpringBoot用RequestBody接收事務(wù)性地寫入處方主表、處方明細(xì)表、收費(fèi)記錄表然后返回一個(gè)完整的收費(fèi)單對(duì)象。前端拿到之后直接跳轉(zhuǎn)到收費(fèi)頁面。整個(gè)過程就是一個(gè)清清楚楚的“請(qǐng)求-響應(yīng)”閉環(huán)完全符合當(dāng)前SaaS產(chǎn)品的技術(shù)審美。3. 回到業(yè)務(wù)本身SaaS門診系統(tǒng)的核心模塊是怎么設(shè)計(jì)和落地的3.1 門診業(yè)務(wù)的完整閉環(huán)掛號(hào)、分診、接診、收費(fèi)、藥房一套能真正給門診用的系統(tǒng)業(yè)務(wù)流程必須閉環(huán)。我常說如果一張流程圖跑不通“患者進(jìn)門到拿藥出門”那這個(gè)系統(tǒng)就是樣子貨。這套源碼里的核心模塊我是按下面的流程拆的掛號(hào)收銀臺(tái)是患者進(jìn)入門診的第一站。這里要支持兩種模式一是現(xiàn)場(chǎng)掛號(hào)患者給錢或刷醫(yī)?？ǖ怯浕拘畔⒍穷A(yù)約掛號(hào)患者在微信公眾號(hào)或小程序上提前約好號(hào)源到院后直接簽到。源碼里把這兩條路徑都打通了掛號(hào)成功后會(huì)自動(dòng)進(jìn)入分診隊(duì)列在候診大屏上滾動(dòng)顯示。醫(yī)生工作站是整個(gè)系統(tǒng)中使用頻率最高、也最考驗(yàn)交互設(shè)計(jì)的模塊。醫(yī)生在這里看到自己的待診列表一個(gè)個(gè)叫號(hào)然后快速錄入主訴、現(xiàn)病史、診斷開出處方或檢驗(yàn)檢查單。這套源碼的處方設(shè)計(jì)支持西藥、中成藥、中藥飲片三種類型因?yàn)槲以趯?shí)際走訪中發(fā)現(xiàn)很多門診其實(shí)是中西醫(yī)結(jié)合的。中藥飲片要能自動(dòng)算帖數(shù)、劑量西藥要有庫存聯(lián)動(dòng)——這些細(xì)節(jié)不做到位醫(yī)生很快就會(huì)棄用。收費(fèi)結(jié)算窗口接住醫(yī)生開出的單據(jù)進(jìn)行劃價(jià)。這里最核心的是醫(yī)保和自費(fèi)的組合支付邏輯雖然各地醫(yī)保政策千差萬別但基礎(chǔ)框架是相近的醫(yī)保能報(bào)銷的部分走醫(yī)保賬戶不能報(bào)銷的走自費(fèi)。源碼里用一個(gè)可配置的“收費(fèi)規(guī)則引擎”處理這部分不同租戶可以通過后臺(tái)配置不同的報(bào)銷比例和計(jì)費(fèi)項(xiàng)目不用改代碼。藥房發(fā)藥模塊按收費(fèi)狀態(tài)自動(dòng)生成待發(fā)藥清單藥師核對(duì)后執(zhí)行發(fā)藥操作庫存自動(dòng)扣減。當(dāng)庫存低于閾值時(shí)系統(tǒng)會(huì)自動(dòng)生成采購建議單避免門診出現(xiàn)“處方開了藥房卻沒藥”的尷尬。3.2 患者檔案與健康數(shù)據(jù)的沉淀價(jià)值很多門診老板一開始對(duì)這個(gè)不敏感但真正用起來之后會(huì)發(fā)現(xiàn)患者檔案才是系統(tǒng)最值錢的部分。這次看病的病歷、診斷、用藥下次再來時(shí)直接調(diào)取醫(yī)生幾秒鐘就能掌握患者的歷史情況。這套源碼里的患者管理模塊支持完整的檔案生命周期基礎(chǔ)信息、家庭成員關(guān)系、過敏史、既往病史、歷次就診記錄、歷次處方明細(xì)、檢驗(yàn)報(bào)告——全部結(jié)構(gòu)化存儲(chǔ)。這里我建議你在二次開發(fā)時(shí)要特別關(guān)注數(shù)據(jù)清洗和去重?，F(xiàn)場(chǎng)掛號(hào)時(shí)很多患者手寫字跡潦草身份證號(hào)填錯(cuò)的情況時(shí)有發(fā)生。源碼里有一個(gè)患者檢索的“模糊精確”雙模式匹配身份證號(hào)碼作為唯一索引姓名的同音字通過拼音索引來輔助匹配。不要小看這個(gè)功能我有一次在客戶現(xiàn)場(chǎng)就遇到過一個(gè)患者半個(gè)月內(nèi)用三個(gè)不同手機(jī)號(hào)掛了三次號(hào)如果沒有患者合并功能他的病歷就永遠(yuǎn)都是碎片化的。3.3 數(shù)據(jù)統(tǒng)計(jì)與運(yùn)營報(bào)表給院長看的“駕駛艙”門診系統(tǒng)的使用者不只有醫(yī)生護(hù)士還有門診的經(jīng)營者。他們最關(guān)心的是今天收了多少錢哪個(gè)醫(yī)生貢獻(xiàn)最大哪些藥品消耗最快本月的復(fù)診率是多少這套源碼內(nèi)置了一套統(tǒng)計(jì)報(bào)表模塊從掛號(hào)量、收費(fèi)金額、科室分布、醫(yī)生工作量、藥品消耗等維度進(jìn)行匯總并以圖表形式展示。不過我必須坦白說一句源碼自帶的統(tǒng)計(jì)報(bào)表通常是“通版”的真要滿足某個(gè)門診的個(gè)性化需求二次開發(fā)是躲不掉的。比如有家中醫(yī)診所的老板跟我說他想看的是“每個(gè)節(jié)氣前后特定方劑的使用趨勢(shì)”這就要在處方明細(xì)表上做更細(xì)粒度的聚合。用SpringBoot配合MyBatis-Plus的Wrapper查詢構(gòu)造器這種定制查詢寫起來不算難前端用Vue的echarts組件渲染趨勢(shì)圖半天就能交付一個(gè)新報(bào)表。4. SaaS化的靈魂多租戶架構(gòu)和可配置能力到底怎么設(shè)計(jì)4.1 多租戶數(shù)據(jù)隔離字段隔離還是獨(dú)立庫SaaS系統(tǒng)和普通單機(jī)版系統(tǒng)的本質(zhì)區(qū)別在于一套代碼同時(shí)服務(wù)多個(gè)診所租戶而彼此的數(shù)據(jù)絕對(duì)隔離。我見過很多“假SaaS”——只是簡(jiǎn)單地把幾個(gè)客戶部署在同一個(gè)服務(wù)器上數(shù)據(jù)混一起全靠代碼里where client_id ?來過濾。這種做法在數(shù)據(jù)量小的時(shí)候看不出問題但只要某個(gè)租戶的數(shù)據(jù)量暴漲或者查詢條件寫漏了一個(gè)租戶ID就會(huì)發(fā)生嚴(yán)重的數(shù)據(jù)越權(quán)事故。在醫(yī)療場(chǎng)景里患者數(shù)據(jù)泄露是原則性問題。這套源碼的做法是共享數(shù)據(jù)庫、共享表結(jié)構(gòu)、租戶ID字段行級(jí)隔離。每一張業(yè)務(wù)表都有一個(gè)tenant_id字段當(dāng)請(qǐng)求進(jìn)來時(shí)后端先通過Token識(shí)別出當(dāng)前是哪個(gè)租戶然后把這個(gè)租戶ID自動(dòng)拼接到所有SQL查詢條件里。SpringBoot里我是通過一個(gè)攔截器 MyBatis攔截器的組合實(shí)現(xiàn)的請(qǐng)求進(jìn)入Controller之前先解析租戶信息存入ThreadLocalMyBatis執(zhí)行SQL時(shí)自動(dòng)追加租戶條件。這樣業(yè)務(wù)代碼里完全不用手動(dòng)寫租戶過濾改起來也不容易出錯(cuò)。但我要提醒你行級(jí)隔離不是唯一的方案那種把每一個(gè)租戶獨(dú)立成一個(gè)數(shù)據(jù)庫的“庫隔離”方案在數(shù)據(jù)安全上更讓人放心適合對(duì)數(shù)據(jù)隔離有強(qiáng)合規(guī)要求的大型醫(yī)療集團(tuán)。它的缺點(diǎn)是運(yùn)維成本高每次升級(jí)都要對(duì)幾十個(gè)庫執(zhí)行腳本。早期做SaaS建議先采用字段隔離模式等客戶量上去了再考慮升級(jí)粒度。4.2 租戶可配置性從診所名稱到收費(fèi)項(xiàng)目的動(dòng)態(tài)定制SaaS產(chǎn)品能不能賣出去很大程度上取決于可配置性。我接觸過的門診規(guī)模從“夫妻店”到“五十人診所”都有他們的需求差異非常大有的需要“醫(yī)生排班”有的需要“線上復(fù)診”有的需要“體質(zhì)辨識(shí)”如果每個(gè)需求都要?jiǎng)哟a那和做外包項(xiàng)目有什么區(qū)別所以在源碼設(shè)計(jì)中我把一批高頻變化的需求做成了“配置項(xiàng)”。診所管理員登錄后臺(tái)可以自己改診所名稱、Logo、科室列表、醫(yī)生排班規(guī)則、收費(fèi)項(xiàng)目及價(jià)格、打印小票的格式、甚至掛號(hào)單上顯示的文字。這些配置統(tǒng)一存放在一張tenant_config表里前端Vue在登錄后拉取當(dāng)前租戶的配置渲染出不同的界面和流程。這個(gè)設(shè)計(jì)讓同一套源碼交付到十家門診能呈現(xiàn)出十種不同的使用形態(tài)但核心代碼紋絲不動(dòng)。4.3 基于SpringBoot實(shí)現(xiàn)一個(gè)極簡(jiǎn)的多租戶攔截器這一段我直接給你看一段實(shí)操代碼。下面的TenantInterceptor是請(qǐng)求入口處的租戶解析邏輯非常簡(jiǎn)單但非常關(guān)鍵。Component public class TenantInterceptor implements HandlerInterceptor { private static final ThreadLocalString TENANT_CONTEXT new ThreadLocal(); Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { // 1. 從請(qǐng)求頭中獲取租戶標(biāo)識(shí) String tenantId request.getHeader(X-Tenant-ID); if (StringUtils.hasText(tenantId)) { TENANT_CONTEXT.set(tenantId); } else { // 2. 如果請(qǐng)求頭沒有嘗試從Token中解析 String token request.getHeader(Authorization); if (token ! null token.startsWith(Bearer )) { // JWT解析邏輯省略這里假設(shè)從claims中拿到tenantId tenantId JwtUtils.parseTenant(token); TENANT_CONTEXT.set(tenantId); } } return true; } Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) { // 3. 請(qǐng)求處理完成后必須清理ThreadLocal否則線程池復(fù)用會(huì)串租戶 TENANT_CONTEXT.remove(); } public static String getCurrentTenantId() { return TENANT_CONTEXT.get(); } }然后在MyBatis層面配置一個(gè)攔截器在執(zhí)行SQL之前自動(dòng)把租戶條件拼進(jìn)去。這一步我用的是MyBatis-Plus的TenantLineInnerInterceptor它可以直接指定需要忽略租戶條件的表比如租戶配置表本身非常方便。Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new TenantLineInnerInterceptor(new TenantLineHandler() { Override public Expression getTenantId() { return new StringValue(TenantInterceptor.getCurrentTenantId()); } Override public String getTenantIdColumn() { return tenant_id; } Override public boolean ignoreTable(String tableName) { // 租戶配置表不需要追加租戶條件 return tenant_config.equalsIgnoreCase(tableName); } })); return interceptor; }這段代碼是你做SaaS二次開發(fā)時(shí)最容易踩坑的地方。最大的坑就是忘記清理ThreadLocal。在SpringBoot默認(rèn)的Tomcat線程池中線程是會(huì)復(fù)用的上一個(gè)請(qǐng)求沒清理的租戶ID會(huì)“傳染”到下一個(gè)請(qǐng)求輕則數(shù)據(jù)串了重則患者信息泄露。我最初犯過這個(gè)錯(cuò)排查了一整天才定位到問題。請(qǐng)務(wù)必確保afterCompletion里執(zhí)行remove()。5. 前端Vue.js在門診系統(tǒng)里的實(shí)戰(zhàn)經(jīng)驗(yàn)?zāi)切┡c“業(yè)務(wù)感”相關(guān)的事5.1 醫(yī)護(hù)工作臺(tái)的組件化拆解前端的組件化不只是一個(gè)技術(shù)概念它直接關(guān)系到后續(xù)功能迭代的速度。這套門診系統(tǒng)我按角色拆成了幾個(gè)大頁面收銀臺(tái)、醫(yī)生工作臺(tái)、藥房工作臺(tái)、管理后臺(tái)每個(gè)大頁面又拆成更細(xì)的組件。比如醫(yī)生工作臺(tái)里有PatientQueue候診隊(duì)列、MedicalRecordForm病歷錄入、PrescriptionPanel處方開立、PastRecordsDrawer歷史病歷抽屜。這里有個(gè)經(jīng)驗(yàn)不要過度抽象。醫(yī)療業(yè)務(wù)中有大量領(lǐng)域術(shù)語組件命名要貼近業(yè)務(wù)而不是貼近技術(shù)。我曾經(jīng)見過有人把患者列表組件命名為ListContainer.vue三個(gè)月后自己都忘了這是干什么的。用PatientQueue.vue這種命名哪怕你半年不看代碼掃一眼文件名就能重新上手。另一個(gè)經(jīng)驗(yàn)是路由守衛(wèi)和權(quán)限控制必須前置。門診系統(tǒng)里有醫(yī)生、護(hù)士、藥師、管理員、收銀員等好幾個(gè)角色不同角色的菜單和按鈕權(quán)限都不一樣。在Vue里我統(tǒng)一在router.beforeEach中做登錄態(tài)校驗(yàn)和角色路由過濾并且用自定義指令v-permission來控制單個(gè)按鈕的顯隱。后端接口同樣要做鑒權(quán)前端控制UI只是體驗(yàn)問題后端鑒權(quán)才是安全問題——這兩件事缺一不可。5.2 處方開立頁一個(gè)反直覺但很好用的交互設(shè)計(jì)處方開立是整個(gè)系統(tǒng)交互最密集的頁面。一開始我把藥品搜索框、常用藥列表、購物車式藥品明細(xì)區(qū)、用法用量選擇器全部放在同一個(gè)平鋪頁面里結(jié)果醫(yī)生反饋說“太花眼睛累”。后來我做了個(gè)調(diào)整用藥法用量用簡(jiǎn)明的Tab分段選擇器常用藥單獨(dú)一個(gè)小側(cè)欄歷史處方一鍵復(fù)制。醫(yī)生給一個(gè)復(fù)診患者開藥時(shí)最多只需要三步選中患者點(diǎn)擊“復(fù)制上次處方”修改用量保存。這個(gè)改動(dòng)給了我一個(gè)很重要的啟發(fā)門診系統(tǒng)的前端設(shè)計(jì)師不能只追求美觀要追求“肌肉記憶”。醫(yī)生每天重復(fù)操作幾百次界面布局的位置應(yīng)該保持高度穩(wěn)定。所以我在做這套Vue前端時(shí)把維護(hù)一套穩(wěn)定的布局規(guī)范看得比做花哨動(dòng)效重要得多。Element UI的默認(rèn)樣式雖然談不上驚艷但它組件間的一致性非常好這對(duì)高強(qiáng)度高頻操作的工具型系統(tǒng)是非常加分的。5.3 Vue項(xiàng)目打包后如何優(yōu)雅地放進(jìn)SpringBoot這是一個(gè)我被問過非常多遍的問題開發(fā)時(shí)前后端分離但很多小門診沒有獨(dú)立服務(wù)器希望能把前端打包后的靜態(tài)文件直接放到SpringBoot的src/main/resources/static目錄里讓后端統(tǒng)一對(duì)外提供服務(wù)。我在這套源碼里就是這么做的。前端項(xiàng)目根目錄下配置vue.config.js設(shè)置publicPath: ./然后執(zhí)行npm run build。構(gòu)建產(chǎn)物dist目錄下的所有文件直接復(fù)制到SpringBoot的resources/static目錄。這樣啟動(dòng)SpringBoot后訪問http://ip:8080就能直接打開登錄頁后端API則統(tǒng)一掛在/api前綴下。在SpringBoot的application.yml里加一段配置避免前端路由和接口沖突spring: mvc: static-path-pattern: /** web: resources: static-locations: classpath:/static/需要注意Vue Router的History模式需要后端做回退支持。比如用戶手動(dòng)刷新/prescription/12這個(gè)路徑時(shí)后臺(tái)如果沒有對(duì)應(yīng)Controller就會(huì)返回404。在SpringBoot里我加了一個(gè)WebMvcConfigurer把非/api開頭的所有路徑都轉(zhuǎn)發(fā)到index.htmlOverride public void addViewControllers(ViewControllerRegistry registry) { registry.addViewController(/{path:[^\\.]*}).setViewName(forward:/index.html); }這個(gè)配置做完刷新問題就解決了。如果你用的是Hash模式則不受此影響但URL里會(huì)帶個(gè)#號(hào)那個(gè)看起來不太專業(yè)能走History模式就盡量走History。6. 源碼落地實(shí)操從拿到代碼到本地跑起來6.1 環(huán)境準(zhǔn)備清單與版本踩坑說明無論你在什么渠道獲得這套SaaS門診系統(tǒng)源碼第一步做的都一樣先把基礎(chǔ)環(huán)境夯實(shí)在一個(gè)已知可用的版本組合上。我在做這套系統(tǒng)時(shí)用的環(huán)境如下JDK 8實(shí)際上Spring Boot 2.7.x在JDK 8下運(yùn)行最穩(wěn)如果用JDK 17部分老版本依賴會(huì)有兼容性問題Maven 3.6MySQL 5.7 或 MySQL 8.0推薦8.0但注意com.mysql.cj.jdbc.Driver參數(shù)和時(shí)區(qū)設(shè)置Node.js 14Vue前端構(gòu)建需要我用的Vue CLI 5.xRedis如果你拿到的是帶驗(yàn)證碼或帶Session共享的版本就需要Redis我最想提醒的是版本陷阱。SpringBoot在3.0之后做了一次大升級(jí)底層是Jakarta命名空間很多老源碼基于javax命名空間寫的直接升級(jí)SpringBoot 3.x會(huì)大量報(bào)錯(cuò)。如果你拿到的源碼是基于SpringBoot 2.x的老老實(shí)實(shí)用JDK 8 Maven 3.6這套組合不要一上來就追求“越新越好”。6.2 數(shù)據(jù)庫初始化和核心配置步驟拿到源碼后我建議你按下面這個(gè)順序操作建庫在MySQL中創(chuàng)建一個(gè)數(shù)據(jù)庫比如saas_clinic_db字符集選utf8mb4排序規(guī)則選utf8mb4_general_ci。千萬不要用utf8否則遇到生僻字或特殊符號(hào)會(huì)報(bào)錯(cuò)。導(dǎo)入SQL腳本源碼的sql目錄下通常有init.sql、data.sql、demo_data.sql之類的文件把初始化腳本按順序?qū)?。注意看腳本里是否含有INSERT INTO ... tenant_config ...這類演示數(shù)據(jù)這種數(shù)據(jù)對(duì)于一個(gè)演示環(huán)境來說非常好用。修改后端配置打開application.yml或application-dev.yml改數(shù)據(jù)源連接。重點(diǎn)檢查時(shí)區(qū)配置MySQL連接串里必須加serverTimezoneAsia/Shanghai否則時(shí)間字段會(huì)差8小時(shí)。spring: datasource: url: jdbc:mysql://localhost:3306/saas_clinic_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver啟動(dòng)后端在項(xiàng)目根目錄執(zhí)行mvn spring-boot:run或用IDE直接啟動(dòng)Application類?？吹絊tarted Application in xx seconds日志后后端服務(wù)就起來了。構(gòu)建前端進(jìn)入web或frontend目錄看源碼結(jié)構(gòu)有的叫ui先npm install安裝依賴然后npm run serve以開發(fā)模式啟動(dòng)。瀏覽器訪問localhost:8080Vue默認(rèn)端口看vue.config.js配置如果后端跑在8080端口而前端要代理記得在vue.config.js里配置devServer.proxy把/api轉(zhuǎn)發(fā)到后端。6.3 首次使用時(shí)的租戶初始化這一步程序員最容易忽略這是我覺得最需要單拎出來講的一步。SaaS系統(tǒng)第一次打開時(shí)你需要有一個(gè)“超級(jí)管理員”去創(chuàng)建第一個(gè)租戶第一家診所然后才能談得上登錄。源碼中一般會(huì)內(nèi)置一個(gè)sys_admin賬號(hào)并在啟動(dòng)時(shí)自動(dòng)創(chuàng)建平臺(tái)管理員。你需要用它去后臺(tái)創(chuàng)建第一個(gè)診所錄入診所名稱、執(zhí)業(yè)許可證號(hào)、默認(rèn)科室、默認(rèn)收費(fèi)項(xiàng)目等然后系統(tǒng)會(huì)為這個(gè)租戶生成一個(gè)tenant_id。這個(gè)租戶ID一定要妥善記錄。前端登錄頁上一般會(huì)讓用戶選擇“所屬診所”或輸入“診所編碼”本質(zhì)就是在告訴后端“我要以哪個(gè)租戶身份登錄”。這里常有開發(fā)者在測(cè)試時(shí)直接在后端Mock了一個(gè)tenant_id1結(jié)果換一臺(tái)機(jī)器聯(lián)調(diào)就忘了配置導(dǎo)致前端始終無法獲取數(shù)據(jù)。如果你在本地聯(lián)調(diào)時(shí)發(fā)現(xiàn)接口返回401或數(shù)據(jù)為空先檢查請(qǐng)求頭里有沒有正確傳遞租戶標(biāo)識(shí)。7. 上線實(shí)戰(zhàn)中的高頻問題排查與性能優(yōu)化7.1 門診高峰期“卡頓”的真相與對(duì)策SaaS門診系統(tǒng)在客戶現(xiàn)場(chǎng)跑起來之后最大的性能考驗(yàn)就是上午9點(diǎn)到11點(diǎn)的就診高峰。很多人一遇到卡頓就懷疑是服務(wù)器配置不夠其實(shí)絕大部分情況不是這樣。我用這套源碼排查過的慢接口里最常見的原因是N1查詢問題列表頁查出100位患者后循環(huán)查詢每位患者的最近一條就診記錄產(chǎn)生了101條SQL耗時(shí)飆升到好幾秒。解決辦法也不復(fù)雜用MyBatis的關(guān)聯(lián)查詢或批量查詢代替循環(huán)查庫。比如醫(yī)生工作臺(tái)待診列表一次性查出所有候診患者再用IN語句一次查出他們的最近就診時(shí)間和主訴信息最后在Java內(nèi)存中做匹配。改完之后接口響應(yīng)時(shí)間基本能控制在200毫秒以內(nèi)。另一個(gè)容易被忽視的點(diǎn)是前端表格的分頁。不要一次性把某個(gè)月的全部掛號(hào)記錄List出來前端再怎么懶加載都救不了數(shù)據(jù)量大的接口。后端用MyBatis-Plus的Page分頁前端用el-pagination配合每頁20條體驗(yàn)會(huì)非常流暢。7.2 數(shù)據(jù)準(zhǔn)確性金額不一致的“元兇”排查思路收費(fèi)金額不一致是門診系統(tǒng)最敏感的問題。一套客戶現(xiàn)場(chǎng)的系統(tǒng)如果統(tǒng)計(jì)報(bào)表和實(shí)際收費(fèi)差了五毛錢老板就會(huì)對(duì)系統(tǒng)失去信任。這類問題一般有三個(gè)來源一是浮點(diǎn)數(shù)精度。金額計(jì)算不能用double或float必須用BigDecimal并且統(tǒng)一保留兩位小數(shù)。二是并發(fā)更新。比如兩個(gè)窗口同時(shí)對(duì)同一張?zhí)幏絾巫鐾速M(fèi)操作就可能出現(xiàn)重復(fù)退費(fèi)。解決方案是給關(guān)鍵單據(jù)狀態(tài)加樂觀鎖version字段更新時(shí)校驗(yàn)版本號(hào)。三是數(shù)據(jù)庫事務(wù)邊界問題。我在代碼評(píng)審時(shí)經(jīng)常發(fā)現(xiàn)有人把insert和update分散在不同方法里沒有放在同一個(gè)Transactional中。一旦中途拋異常數(shù)據(jù)就會(huì)處于半完成狀態(tài)對(duì)賬自然對(duì)不上。7.3 常用問題速查表癥狀可能原因處理辦法前端能打開但登錄后接口全部401請(qǐng)求頭缺少Token或租戶標(biāo)識(shí)檢查Axios攔截器是否自動(dòng)添加Authorization和X-Tenant-ID啟動(dòng)報(bào)Table doesnt exist數(shù)據(jù)庫腳本未完整導(dǎo)入重新按順序?qū)隨QL腳本注意字符集中文亂碼數(shù)據(jù)源連接沒有指定characterEncodingutf8在JDBC URL中追加characterEncodingutf8時(shí)間字段相差8小時(shí)時(shí)區(qū)配置錯(cuò)誤JDBC URL追加serverTimezoneAsia/Shanghai接口響應(yīng)慢N1查詢或缺少索引啟用MyBatis SQL日志分析慢語句對(duì)tenant_id patient_id建立聯(lián)合索引部署到服務(wù)器后前端白屏靜態(tài)資源路徑不對(duì)確認(rèn)publicPath: ./已設(shè)置圖片使用相對(duì)路徑部署后刷新子路由404Vue Router History模式未做回退按上文配置轉(zhuǎn)發(fā)到index.html7.4 一套可以“抄作業(yè)”的ID生成與雪花算法實(shí)踐最后補(bǔ)一個(gè)很實(shí)際的點(diǎn)醫(yī)療系統(tǒng)里掛號(hào)單號(hào)、處方單號(hào)、收費(fèi)流水號(hào)這些編號(hào)會(huì)頻繁出現(xiàn)在打印小票和跨系統(tǒng)對(duì)接的場(chǎng)景中格式必須統(tǒng)一而且不能重復(fù)。很多新手會(huì)直接在Java里用UUID.randomUUID().toString().substring(0, 16)當(dāng)單號(hào)但UUID是字符串且無序放到數(shù)據(jù)庫索引上性能不好打印出來也不好看。我在這套源碼里用的是雪花算法支持下的自定義單號(hào)生成器。有人會(huì)擔(dān)心雪花算法在分布式部署下時(shí)鐘回?fù)軙?huì)產(chǎn)生重復(fù)ID我的處理比較簡(jiǎn)單在單號(hào)里拼接一段業(yè)務(wù)前綴和日期。比如收費(fèi)流水號(hào)格式為SF yyyyMMdd 6位自增序列每天重置一次再配合數(shù)據(jù)庫唯一索引兜底。這樣既保證了可讀性也避免了并發(fā)沖突而且運(yùn)營人員在Excel里按單號(hào)排序時(shí)非常方便。如果你拿到的源碼里沒有這個(gè)邏輯自己寫一個(gè)IdGenerator組件也不難——只要保證“時(shí)間戳 自增序列 隨機(jī)緩沖位”的結(jié)構(gòu)就能滿足門診場(chǎng)景下的絕大多數(shù)需求。8. 基于這套源碼還能往哪些方向擴(kuò)展8.1 從門診到診所連鎖向標(biāo)準(zhǔn)化集團(tuán)管理演進(jìn)單店SaaS門診系統(tǒng)是一塊敲門磚。一旦客戶從一家診所變成三家、五家連鎖你對(duì)系統(tǒng)的掌控能力就直接決定了這個(gè)客戶能跟你走多遠(yuǎn)。我在這套源碼基礎(chǔ)上做的第一個(gè)擴(kuò)展就是連鎖版本在租戶之上再加一個(gè)group_id集團(tuán)ID總部可查看旗下所有門店的營收、復(fù)診率、藥品庫存周轉(zhuǎn)等匯總數(shù)據(jù)各門店之間則保持?jǐn)?shù)據(jù)隔離和獨(dú)立運(yùn)營。這個(gè)擴(kuò)展從代碼上講改動(dòng)并不大——業(yè)務(wù)表加個(gè)group_id字段報(bào)表層增加按門店聚合的路由——但商業(yè)價(jià)值完全不同客單價(jià)和客戶粘性都會(huì)明顯提升。8.2 線上線下一體化預(yù)約、問診、電子處方流轉(zhuǎn)門診未來的核心競(jìng)爭(zhēng)力不只是“到店看病”而是線上線下一體化。我在擴(kuò)展時(shí)最常見的需求是患者通過公眾號(hào)預(yù)約掛號(hào)、在線查看報(bào)告、在線繳費(fèi)醫(yī)生在接診后可以生成電子處方慢病復(fù)診患者甚至可以通過視頻問診完成開藥藥品直接快遞到家。這些需求的落地路徑非常清晰公眾號(hào)或小程序端通過OAuth2對(duì)接SpringBoot后端走同一套API只是多了一層H5或小程序前端Vue.js后臺(tái)管理端則天然適合做運(yùn)營人員的工作臺(tái)。在這個(gè)方向里接口設(shè)計(jì)一定要堅(jiān)持RESTful風(fēng)格和無狀態(tài)Token鑒權(quán)這樣后續(xù)接App、接小程序、接第三方平臺(tái)都會(huì)非常從容。8.3 與醫(yī)保接口、檢驗(yàn)檢查設(shè)備對(duì)接的規(guī)范化建議做醫(yī)療系統(tǒng)繞不開的一個(gè)話題是外部接口對(duì)接。但醫(yī)保接口各地標(biāo)準(zhǔn)不同LIS和PACS設(shè)備的通信協(xié)議更是五花八門。我的建議是不要在源碼的主流程里硬編碼對(duì)接邏輯而是把外部接口抽象成一個(gè)ExternalService層用策略模式去適配不同的廠商協(xié)議再把對(duì)接配置寫到tenant_config表里按租戶激活。這樣做的好處是你在A省上線時(shí)寫的醫(yī)保適配代碼不會(huì)污染到B省客戶的業(yè)務(wù)流某個(gè)診所的某臺(tái)檢驗(yàn)設(shè)備沒能對(duì)接成功也只會(huì)影響那一個(gè)租戶的功能不會(huì)拖垮整個(gè)系統(tǒng)。我做這套SaaS門診系統(tǒng)時(shí)最想留給你的一句話如果只讓我選一條經(jīng)驗(yàn)來總結(jié)那就是醫(yī)療系統(tǒng)的核心不是“能做出來”而是“能一直穩(wěn)定地跑下去”。在門診現(xiàn)場(chǎng)系統(tǒng)宕機(jī)十分鐘就會(huì)造成患者積壓、醫(yī)生抱怨、前臺(tái)手忙腳亂。SpringBoot和Vue.js這套組合當(dāng)然不是唯一的選項(xiàng)但它是我實(shí)操下來穩(wěn)定性、團(tuán)隊(duì)招聘難度、生態(tài)成熟度這三個(gè)維度上平衡得最好的一套。我見過太多項(xiàng)目死于過度設(shè)計(jì)——一開始就上微服務(wù)、上了K8s、搞了多機(jī)房容災(zāi)結(jié)果連一個(gè)門診的日常業(yè)務(wù)都跑不順。從單體SpringBoot開始從一套干干凈凈的Vue.js前端開始把業(yè)務(wù)流程吃透把多租戶隔離做扎實(shí)等業(yè)務(wù)體量真正需要時(shí)再橫向擴(kuò)展這才是做SaaS醫(yī)療產(chǎn)品最務(wù)實(shí)的路徑。希望這篇實(shí)操筆記能幫你少走一點(diǎn)我走過的彎路。