全棧開發(fā)實踐)
1. 藥品管理系統(tǒng)技術(shù)架構(gòu)解析這套藥品管理系統(tǒng)的技術(shù)選型采用了當前主流的SpringBoot后端Vue前端MySQL數(shù)據(jù)庫全棧方案這種組合在中小型企業(yè)管理系統(tǒng)中具有顯著優(yōu)勢。后端使用SpringBoot 2.7.x版本構(gòu)建RESTful API前端采用Vue 3組合式API開發(fā)數(shù)據(jù)庫選用MySQL 8.0社區(qū)版三者通過axios進行數(shù)據(jù)交互。提示系統(tǒng)默認使用Java 11運行環(huán)境Node.js 16.x進行前端構(gòu)建開發(fā)工具推薦IntelliJ IDEA VS Code組合1.1 后端技術(shù)棧深度剖析SpringBoot作為后端框架提供了完整的藥品業(yè)務(wù)邏輯實現(xiàn)采用分層架構(gòu)設(shè)計controller-service-dao集成Spring Security實現(xiàn)RBAC權(quán)限控制使用MyBatis-Plus 3.5.x進行數(shù)據(jù)庫操作通過Hutool工具包處理藥品編碼生成采用Lombok減少樣板代碼藥品管理的核心接口包括RestController RequestMapping(/api/drug) public class DrugController { Autowired private DrugService drugService; PostMapping(/add) public Result addDrug(Valid RequestBody DrugDTO dto) { return drugService.addDrug(dto); } GetMapping(/batch/{batchNo}) public Result getByBatch(PathVariable String batchNo) { return drugService.getByBatch(batchNo); } }1.2 前端技術(shù)方案詳解Vue前端采用如下技術(shù)方案基于Vue 3 TypeScript開發(fā)使用Element Plus作為UI組件庫通過Vue Router實現(xiàn)路由管理采用Pinia進行狀態(tài)管理集成ECharts實現(xiàn)藥品庫存可視化藥品入庫表單的關(guān)鍵實現(xiàn)template el-form :modelform :rulesrules refformRef el-form-item label藥品名稱 propname el-input v-modelform.name / /el-form-item el-form-item label生產(chǎn)批號 propbatchNo el-input v-modelform.batchNo / /el-form-item /el-form /template script setup langts const form reactive({ name: , batchNo: }) const rules { name: [{ required: true, message: 請輸入藥品名稱 }], batchNo: [{ pattern: /^[A-Z0-9]{8}$/, message: 批號格式不正確 }] } /script1.3 數(shù)據(jù)庫設(shè)計要點MySQL數(shù)據(jù)庫設(shè)計遵循藥品管理業(yè)務(wù)特點CREATE TABLE drug ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主鍵, code varchar(20) NOT NULL COMMENT 藥品編碼, name varchar(50) NOT NULL COMMENT 藥品名稱, spec varchar(30) NOT NULL COMMENT 規(guī)格, unit varchar(10) NOT NULL COMMENT 單位, batch_no varchar(20) NOT NULL COMMENT 生產(chǎn)批號, manufacturer varchar(100) NOT NULL COMMENT 生產(chǎn)廠家, price decimal(10,2) NOT NULL COMMENT 單價, stock int NOT NULL DEFAULT 0 COMMENT 庫存數(shù)量, expire_date date NOT NULL COMMENT 有效期至, status tinyint NOT NULL DEFAULT 1 COMMENT 狀態(tài)(1-正常 0-停用), PRIMARY KEY (id), UNIQUE KEY idx_code (code), KEY idx_batch (batch_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT藥品信息表;2. 系統(tǒng)核心功能實現(xiàn)2.1 藥品全生命周期管理系統(tǒng)實現(xiàn)了從采購到報廢的完整藥品管理流程采購入庫支持Excel批量導(dǎo)入、掃碼槍錄入庫存管理實時庫存監(jiān)控、效期預(yù)警提前30天處方發(fā)藥與HIS系統(tǒng)對接的處方處理模塊退藥處理完整的退藥審批流程報損報廢藥品損耗記錄與原因分析庫存預(yù)警的核心邏輯實現(xiàn)public ListDrug checkExpireWarning() { LocalDate warningDate LocalDate.now().plusDays(30); return drugMapper.selectList(new QueryWrapperDrug() .lt(expire_date, warningDate) .gt(stock, 0) .eq(status, 1)); }2.2 智能預(yù)警系統(tǒng)系統(tǒng)內(nèi)置多種預(yù)警機制庫存下限預(yù)警可配置閾值近效期藥品預(yù)警藥品配伍禁忌提醒處方用量超標提醒特殊藥品雙人審核提醒預(yù)警配置表示例CREATE TABLE warning_config ( id int NOT NULL AUTO_INCREMENT, type varchar(20) NOT NULL COMMENT 預(yù)警類型, threshold varchar(50) NOT NULL COMMENT 閾值, notify_type varchar(20) NOT NULL COMMENT 通知方式, is_active tinyint(1) NOT NULL DEFAULT 1, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;2.3 統(tǒng)計報表模塊系統(tǒng)提供多維度的統(tǒng)計分析功能藥品出入庫統(tǒng)計日/月/季度/年處方藥品使用排名供應(yīng)商供貨分析醫(yī)師開藥習慣分析藥品效期分布圖使用ECharts實現(xiàn)的庫存統(tǒng)計前端代碼async function initStockChart() { const res await getDrugStockStats() const chart echarts.init(document.getElementById(chart)) chart.setOption({ tooltip: { trigger: item }, series: [{ type: pie, data: res.data.map(item ({ value: item.stock, name: item.name })) }] }) }3. 系統(tǒng)部署與運行指南3.1 環(huán)境準備與配置后端環(huán)境要求JDK 11Maven 3.6MySQL 8.0Redis 6.x可選用于緩存前端環(huán)境要求Node.js 16.xnpm 8.x 或 yarn 1.22數(shù)據(jù)庫配置示例application.ymlspring: datasource: url: jdbc:mysql://localhost:3306/drug_db?useSSLfalse username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver jpa: show-sql: true hibernate: ddl-auto: update3.2 項目啟動流程后端啟動步驟導(dǎo)入Maven依賴修改數(shù)據(jù)庫配置執(zhí)行SQL初始化腳本運行主類DrugApplication前端啟動步驟# 安裝依賴 npm install # 開發(fā)模式運行 npm run dev # 生產(chǎn)構(gòu)建 npm run build3.3 常見部署問題解決MySQL連接失敗檢查MySQL服務(wù)是否啟動驗證用戶名密碼是否正確確認數(shù)據(jù)庫drug_db已創(chuàng)建前端跨域問題// vue.config.js module.exports { devServer: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } }頁面空白問題檢查dist目錄是否正確部署確認Nginx配置了正確的root路徑查看瀏覽器控制臺報錯信息4. 系統(tǒng)二次開發(fā)指南4.1 代碼結(jié)構(gòu)與擴展點項目采用標準Maven多模塊結(jié)構(gòu)drug-system ├── drug-admin -- 后臺管理模塊 ├── drug-common -- 公共模塊 ├── drug-generator -- 代碼生成器 └── drug-web -- 前端模塊核心擴展點設(shè)計自定義注解DrugLog實現(xiàn)操作日志全局異常處理器DrugExceptionHandler可插拔的藥品驗證接口DrugValidator可配置的審批流程引擎4.2 典型功能擴展示例添加新藥品類型支持數(shù)據(jù)庫添加type字段后端DTO和Entity添加對應(yīng)屬性前端表單增加類型選擇器在藥品服務(wù)中添加類型處理邏輯對接醫(yī)保系統(tǒng)public interface MedicalInsuranceService { boolean checkReimbursement(String drugCode); BigDecimal getReimbursementRate(String drugCode); } Service public class MedicalInsuranceServiceImpl implements MedicalInsuranceService { Override public boolean checkReimbursement(String drugCode) { // 調(diào)用醫(yī)保系統(tǒng)API } }4.3 性能優(yōu)化建議數(shù)據(jù)庫優(yōu)化為高頻查詢字段添加索引使用連接池配置HikariCP推薦對大表進行分表分庫前端優(yōu)化啟用組件懶加載使用keep-alive緩存常用組件對大數(shù)據(jù)表格進行虛擬滾動緩存策略Cacheable(value drug, key #code) public Drug getByCode(String code) { return drugMapper.selectByCode(code); } CacheEvict(value drug, key #drug.code) public void updateDrug(Drug drug) { drugMapper.updateById(drug); }5. 項目實戰(zhàn)經(jīng)驗分享5.1 開發(fā)中的典型問題藥品編碼沖突解決方案采用類型前綴日期序列號的復(fù)合編碼規(guī)則實現(xiàn)代碼public String generateDrugCode(String type) { String date LocalDate.now().format(DateTimeFormatter.BASIC_ISO_DATE); long seq redisTemplate.opsForValue().increment(drug:seq: date); return type date String.format(%04d, seq); }效期計算誤差發(fā)現(xiàn)直接使用new Date()存在時區(qū)問題修復(fù)統(tǒng)一使用LocalDate處理日期并發(fā)庫存更新方案采用樂觀鎖機制Update(update drug set stock stock - #{qty}, version version 1 where code #{code} and version #{version}) int reduceStockWithLock(Param(code) String code, Param(qty) int qty, Param(version) int version);5.2 安全性最佳實踐接口安全防護啟用Spring Security配置CSRF防護實現(xiàn)接口限流數(shù)據(jù)安全措施敏感字段加密存儲如價格操作日志完整記錄定期數(shù)據(jù)備份權(quán)限控制實現(xiàn)PreAuthorize(hasRole(PHARMACIST) || hasRole(ADMIN)) PostMapping(/adjust) public Result adjustStock(RequestBody AdjustDTO dto) { return stockService.adjust(dto); }5.3 項目演進方向微服務(wù)化改造將庫存、采購、處方拆分為獨立服務(wù)采用Spring Cloud Alibaba體系引入Sentinel進行流量控制智能化升級集成藥品圖像識別添加智能補貨預(yù)測開發(fā)移動端盤點功能生態(tài)對接擴展對接醫(yī)保結(jié)算系統(tǒng)連接供應(yīng)商ERP集成電子處方平臺 SpringBoot+Vue藥品管理系統(tǒng)全棧開發(fā)實踐
1. 藥品管理系統(tǒng)技術(shù)架構(gòu)解析這套藥品管理系統(tǒng)的技術(shù)選型采用了當前主流的SpringBoot后端Vue前端MySQL數(shù)據(jù)庫全棧方案這種組合在中小型企業(yè)管理系統(tǒng)中具有顯著優(yōu)勢。后端使用SpringBoot 2.7.x版本構(gòu)建RESTful API前端采用Vue 3組合式API開發(fā)數(shù)據(jù)庫選用MySQL 8.0社區(qū)版三者通過axios進行數(shù)據(jù)交互。提示系統(tǒng)默認使用Java 11運行環(huán)境Node.js 16.x進行前端構(gòu)建開發(fā)工具推薦IntelliJ IDEA VS Code組合1.1 后端技術(shù)棧深度剖析SpringBoot作為后端框架提供了完整的藥品業(yè)務(wù)邏輯實現(xiàn)采用分層架構(gòu)設(shè)計controller-service-dao集成Spring Security實現(xiàn)RBAC權(quán)限控制使用MyBatis-Plus 3.5.x進行數(shù)據(jù)庫操作通過Hutool工具包處理藥品編碼生成采用Lombok減少樣板代碼藥品管理的核心接口包括RestController RequestMapping(/api/drug) public class DrugController { Autowired private DrugService drugService; PostMapping(/add) public Result addDrug(Valid RequestBody DrugDTO dto) { return drugService.addDrug(dto); } GetMapping(/batch/{batchNo}) public Result getByBatch(PathVariable String batchNo) { return drugService.getByBatch(batchNo); } }1.2 前端技術(shù)方案詳解Vue前端采用如下技術(shù)方案基于Vue 3 TypeScript開發(fā)使用Element Plus作為UI組件庫通過Vue Router實現(xiàn)路由管理采用Pinia進行狀態(tài)管理集成ECharts實現(xiàn)藥品庫存可視化藥品入庫表單的關(guān)鍵實現(xiàn)template el-form :modelform :rulesrules refformRef el-form-item label藥品名稱 propname el-input v-modelform.name / /el-form-item el-form-item label生產(chǎn)批號 propbatchNo el-input v-modelform.batchNo / /el-form-item /el-form /template script setup langts const form reactive({ name: , batchNo: }) const rules { name: [{ required: true, message: 請輸入藥品名稱 }], batchNo: [{ pattern: /^[A-Z0-9]{8}$/, message: 批號格式不正確 }] } /script1.3 數(shù)據(jù)庫設(shè)計要點MySQL數(shù)據(jù)庫設(shè)計遵循藥品管理業(yè)務(wù)特點CREATE TABLE drug ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主鍵, code varchar(20) NOT NULL COMMENT 藥品編碼, name varchar(50) NOT NULL COMMENT 藥品名稱, spec varchar(30) NOT NULL COMMENT 規(guī)格, unit varchar(10) NOT NULL COMMENT 單位, batch_no varchar(20) NOT NULL COMMENT 生產(chǎn)批號, manufacturer varchar(100) NOT NULL COMMENT 生產(chǎn)廠家, price decimal(10,2) NOT NULL COMMENT 單價, stock int NOT NULL DEFAULT 0 COMMENT 庫存數(shù)量, expire_date date NOT NULL COMMENT 有效期至, status tinyint NOT NULL DEFAULT 1 COMMENT 狀態(tài)(1-正常 0-停用), PRIMARY KEY (id), UNIQUE KEY idx_code (code), KEY idx_batch (batch_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT藥品信息表;2. 系統(tǒng)核心功能實現(xiàn)2.1 藥品全生命周期管理系統(tǒng)實現(xiàn)了從采購到報廢的完整藥品管理流程采購入庫支持Excel批量導(dǎo)入、掃碼槍錄入庫存管理實時庫存監(jiān)控、效期預(yù)警提前30天處方發(fā)藥與HIS系統(tǒng)對接的處方處理模塊退藥處理完整的退藥審批流程報損報廢藥品損耗記錄與原因分析庫存預(yù)警的核心邏輯實現(xiàn)public ListDrug checkExpireWarning() { LocalDate warningDate LocalDate.now().plusDays(30); return drugMapper.selectList(new QueryWrapperDrug() .lt(expire_date, warningDate) .gt(stock, 0) .eq(status, 1)); }2.2 智能預(yù)警系統(tǒng)系統(tǒng)內(nèi)置多種預(yù)警機制庫存下限預(yù)警可配置閾值近效期藥品預(yù)警藥品配伍禁忌提醒處方用量超標提醒特殊藥品雙人審核提醒預(yù)警配置表示例CREATE TABLE warning_config ( id int NOT NULL AUTO_INCREMENT, type varchar(20) NOT NULL COMMENT 預(yù)警類型, threshold varchar(50) NOT NULL COMMENT 閾值, notify_type varchar(20) NOT NULL COMMENT 通知方式, is_active tinyint(1) NOT NULL DEFAULT 1, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;2.3 統(tǒng)計報表模塊系統(tǒng)提供多維度的統(tǒng)計分析功能藥品出入庫統(tǒng)計日/月/季度/年處方藥品使用排名供應(yīng)商供貨分析醫(yī)師開藥習慣分析藥品效期分布圖使用ECharts實現(xiàn)的庫存統(tǒng)計前端代碼async function initStockChart() { const res await getDrugStockStats() const chart echarts.init(document.getElementById(chart)) chart.setOption({ tooltip: { trigger: item }, series: [{ type: pie, data: res.data.map(item ({ value: item.stock, name: item.name })) }] }) }3. 系統(tǒng)部署與運行指南3.1 環(huán)境準備與配置后端環(huán)境要求JDK 11Maven 3.6MySQL 8.0Redis 6.x可選用于緩存前端環(huán)境要求Node.js 16.xnpm 8.x 或 yarn 1.22數(shù)據(jù)庫配置示例application.ymlspring: datasource: url: jdbc:mysql://localhost:3306/drug_db?useSSLfalse username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver jpa: show-sql: true hibernate: ddl-auto: update3.2 項目啟動流程后端啟動步驟導(dǎo)入Maven依賴修改數(shù)據(jù)庫配置執(zhí)行SQL初始化腳本運行主類DrugApplication前端啟動步驟# 安裝依賴 npm install # 開發(fā)模式運行 npm run dev # 生產(chǎn)構(gòu)建 npm run build3.3 常見部署問題解決MySQL連接失敗檢查MySQL服務(wù)是否啟動驗證用戶名密碼是否正確確認數(shù)據(jù)庫drug_db已創(chuàng)建前端跨域問題// vue.config.js module.exports { devServer: { proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } }頁面空白問題檢查dist目錄是否正確部署確認Nginx配置了正確的root路徑查看瀏覽器控制臺報錯信息4. 系統(tǒng)二次開發(fā)指南4.1 代碼結(jié)構(gòu)與擴展點項目采用標準Maven多模塊結(jié)構(gòu)drug-system ├── drug-admin -- 后臺管理模塊 ├── drug-common -- 公共模塊 ├── drug-generator -- 代碼生成器 └── drug-web -- 前端模塊核心擴展點設(shè)計自定義注解DrugLog實現(xiàn)操作日志全局異常處理器DrugExceptionHandler可插拔的藥品驗證接口DrugValidator可配置的審批流程引擎4.2 典型功能擴展示例添加新藥品類型支持數(shù)據(jù)庫添加type字段后端DTO和Entity添加對應(yīng)屬性前端表單增加類型選擇器在藥品服務(wù)中添加類型處理邏輯對接醫(yī)保系統(tǒng)public interface MedicalInsuranceService { boolean checkReimbursement(String drugCode); BigDecimal getReimbursementRate(String drugCode); } Service public class MedicalInsuranceServiceImpl implements MedicalInsuranceService { Override public boolean checkReimbursement(String drugCode) { // 調(diào)用醫(yī)保系統(tǒng)API } }4.3 性能優(yōu)化建議數(shù)據(jù)庫優(yōu)化為高頻查詢字段添加索引使用連接池配置HikariCP推薦對大表進行分表分庫前端優(yōu)化啟用組件懶加載使用keep-alive緩存常用組件對大數(shù)據(jù)表格進行虛擬滾動緩存策略Cacheable(value drug, key #code) public Drug getByCode(String code) { return drugMapper.selectByCode(code); } CacheEvict(value drug, key #drug.code) public void updateDrug(Drug drug) { drugMapper.updateById(drug); }5. 項目實戰(zhàn)經(jīng)驗分享5.1 開發(fā)中的典型問題藥品編碼沖突解決方案采用類型前綴日期序列號的復(fù)合編碼規(guī)則實現(xiàn)代碼public String generateDrugCode(String type) { String date LocalDate.now().format(DateTimeFormatter.BASIC_ISO_DATE); long seq redisTemplate.opsForValue().increment(drug:seq: date); return type date String.format(%04d, seq); }效期計算誤差發(fā)現(xiàn)直接使用new Date()存在時區(qū)問題修復(fù)統(tǒng)一使用LocalDate處理日期并發(fā)庫存更新方案采用樂觀鎖機制Update(update drug set stock stock - #{qty}, version version 1 where code #{code} and version #{version}) int reduceStockWithLock(Param(code) String code, Param(qty) int qty, Param(version) int version);5.2 安全性最佳實踐接口安全防護啟用Spring Security配置CSRF防護實現(xiàn)接口限流數(shù)據(jù)安全措施敏感字段加密存儲如價格操作日志完整記錄定期數(shù)據(jù)備份權(quán)限控制實現(xiàn)PreAuthorize(hasRole(PHARMACIST) || hasRole(ADMIN)) PostMapping(/adjust) public Result adjustStock(RequestBody AdjustDTO dto) { return stockService.adjust(dto); }5.3 項目演進方向微服務(wù)化改造將庫存、采購、處方拆分為獨立服務(wù)采用Spring Cloud Alibaba體系引入Sentinel進行流量控制智能化升級集成藥品圖像識別添加智能補貨預(yù)測開發(fā)移動端盤點功能生態(tài)對接擴展對接醫(yī)保結(jié)算系統(tǒng)連接供應(yīng)商ERP集成電子處方平臺