簡介本資源是一套面向計(jì)算機(jī)專業(yè)本科生的課程設(shè)計(jì)與畢業(yè)設(shè)計(jì)實(shí)踐項(xiàng)目聚焦基于SpringBoot的Java Web藥店管理系統(tǒng)開發(fā)適用于Java后端初學(xué)者鞏固Web開發(fā)全流程能力。壓縮包共包含多個(gè)核心文件涵蓋可直接運(yùn)行的完整源碼、數(shù)據(jù)庫初始化腳本db.sql、開題報(bào)告與論文文檔LW、系統(tǒng)說明文檔等類型涉及Java工程代碼、SQL腳本、Word技術(shù)文檔及純文本操作指南整體大小為15.96MB。已有67人下載學(xué)習(xí)體現(xiàn)了其在教學(xué)實(shí)踐場景中的實(shí)用價(jià)值。讀者可獲得從需求分析、SpringBootMyBatis/Security技術(shù)選型、前后端交互實(shí)現(xiàn)到庫存管理、訂單處理、用戶權(quán)限控制等真實(shí)業(yè)務(wù)模塊的完整參考所有代碼經(jīng)驗(yàn)證可本地一鍵運(yùn)行配套文檔清晰說明環(huán)境配置與啟動(dòng)步驟極大降低上手門檻是理解企業(yè)級(jí)Java Web系統(tǒng)架構(gòu)與開發(fā)規(guī)范的優(yōu)質(zhì)入門范例。 這幾年幫人看課設(shè)畢設(shè)項(xiàng)目Spring Boot Java Web 方向的藥店管理系統(tǒng)幾乎是每個(gè)學(xué)期都會(huì)遇到的高頻題目。這個(gè)題一聽很普通但每個(gè)人拿到的需求差別其實(shí)很大有的只要求最基礎(chǔ)的增刪改查有的要求帶上完整的進(jìn)銷存、庫存預(yù)警、效期提醒還有的把會(huì)員積分、統(tǒng)計(jì)報(bào)表和 Excel 導(dǎo)出全部算進(jìn)去。我在這類項(xiàng)目上前前后后迭代過好幾版也踩了不少坑今天就把完整的設(shè)計(jì)思路、技術(shù)選型、數(shù)據(jù)庫表結(jié)構(gòu)、核心業(yè)務(wù)實(shí)現(xiàn)以及交付時(shí)源碼和 LW論文/設(shè)計(jì)文檔怎么組織一次性講清楚。如果你正在做這個(gè)題或者想深入理解一個(gè)進(jìn)銷存系統(tǒng)的完整鏈路這篇內(nèi)容可以直接拿來當(dāng)參考。1. 為什么選藥店管理系統(tǒng)從課題價(jià)值到答辯風(fēng)險(xiǎn)都替你算了一遍1.1 藥店管理系統(tǒng)到底在解決什么問題藥店日常經(jīng)營里最煩的不是賣藥而是庫存對(duì)不上。今天入庫了一批感冒藥前臺(tái)賣了幾盒有人在盤點(diǎn)時(shí)又發(fā)現(xiàn)幾盒過期了如果靠 Excel 登記很容易漏記、錯(cuò)記。藥品的效期、批次、供應(yīng)商批次對(duì)賬、會(huì)員積分全是細(xì)節(jié)。藥店管理系統(tǒng)本質(zhì)是一個(gè)進(jìn)銷存系統(tǒng)核心是管理藥品從“采購”到“入庫”到“銷售出庫”再到“庫存盤點(diǎn)”的完整生命周期。除此之外還牽扯到供應(yīng)商資料、會(huì)員檔案、價(jià)格管理、臨期藥品提醒和經(jīng)營數(shù)據(jù)統(tǒng)計(jì)。把這些業(yè)務(wù)搬到線上讓每一次入庫、銷售都有據(jù)可查庫存數(shù)量所有角色看到的是一致的這就是系統(tǒng)最基礎(chǔ)的價(jià)值。1.2 為什么這個(gè)題在課設(shè)畢設(shè)里性價(jià)比高一個(gè)適合做課設(shè)/畢設(shè)的題目要滿足三點(diǎn)需求清晰、技術(shù)復(fù)雜度適中、有足夠的擴(kuò)展空間。藥店管理系統(tǒng)恰好三點(diǎn)都占。第一需求清晰。進(jìn)銷存是管理信息系統(tǒng)里的經(jīng)典業(yè)務(wù)模型每個(gè)老師都能理解描述起來不需要太多額外背景。第二業(yè)務(wù)關(guān)系豐富。雖然體量不大但涉及用戶、藥品、供應(yīng)商、采購單、銷售單、庫存流水、會(huì)員等實(shí)體一對(duì)多、多對(duì)多關(guān)系都有數(shù)據(jù)庫設(shè)計(jì)部分可以有內(nèi)容。第三擴(kuò)展空間大。你可以在基礎(chǔ)功能上疊加近效期提醒、庫存預(yù)警、銷售趨勢分析、會(huì)員積分、導(dǎo)出報(bào)表甚至對(duì)接微信小程序隨便挑一個(gè)都能寫成亮點(diǎn)。這題比純論壇系統(tǒng)、純博客系統(tǒng)更容易體現(xiàn)工程化思維也是一個(gè)比較穩(wěn)妥的選擇。1.3 答辯老師最愛問的幾個(gè)問題要先想好這個(gè)題被問到的概率最高的三個(gè)問題提前準(zhǔn)備一下答辯基本不會(huì)冷場。第一個(gè)藥品效期是怎么管理的你的答案要點(diǎn)是藥品表里有 expiry_date 字段查詢時(shí)用 SQL 把當(dāng)前日期到到期日之間不足 90 天的記錄篩出來列表里用顏色標(biāo)記銷售時(shí)還可以做二次校驗(yàn)。第二個(gè)庫存和銷售數(shù)據(jù)的一致性怎么保證答案是事務(wù)。每次扣減庫存和生成銷售記錄放在同一個(gè)事務(wù)里任何一步失敗就整體回滾同時(shí)用庫存流水表記錄每次變動(dòng)隨時(shí)可以追溯。第三個(gè)為什么用 Spring Boot 而不是傳統(tǒng)的 SSH 或 SSM答案要點(diǎn)是 Spring Boot 基于 Spring Boot 生態(tài)內(nèi)嵌 Tomcat不需要額外部署外部容器配置簡化適合快速迭代而且已經(jīng)成為 Java Web 開發(fā)的主流選擇。把這三個(gè)問題答順了答辯老師就會(huì)覺得你確實(shí)做過項(xiàng)目而不只是把 PPT 背了一遍。2. 需求拆解先別急著寫代碼把角色和流程理清楚2.1 角色劃分不同人看到的界面和功能不一樣藥店管理系統(tǒng)不是一個(gè)所有人都能操作所有功能的系統(tǒng)。最常見的角色有三種。系統(tǒng)管理員負(fù)責(zé)系統(tǒng)基礎(chǔ)配置包括用戶管理、藥品字典維護(hù)、供應(yīng)商審核、數(shù)據(jù)統(tǒng)計(jì)和日志查看。店員的日常操作是前臺(tái)售藥、退藥、會(huì)員登記以及查看自己的銷售記錄。采購員負(fù)責(zé)供應(yīng)商管理、采購單創(chuàng)建和到貨入庫。如果系統(tǒng)做得再細(xì)一點(diǎn)還可以增加一個(gè)店長角色能看門店的經(jīng)營報(bào)表和利潤分析但不能修改基礎(chǔ)數(shù)據(jù)。角色的意義不只是菜單顯示不同更重要的是后端接口要有對(duì)應(yīng)的權(quán)限控制。比如店員界面不應(yīng)該出現(xiàn)進(jìn)貨價(jià)和利潤統(tǒng)計(jì)哪怕是接口被猜到也要能攔截下來否則做權(quán)限管理就沒有意義。2.2 功能模塊清單先畫清楚再開發(fā)在動(dòng)手寫代碼之前我會(huì)先列一張功能模塊表把每個(gè)模塊的功能點(diǎn)和說明寫清楚。這張表既可以指導(dǎo)開發(fā)后面寫 LW 文檔時(shí)也能直接復(fù)用。模塊功能點(diǎn)說明藥品管理藥品增刪改查、藥品分類、近效期篩選藥品編碼唯一名稱、規(guī)格、廠家、批準(zhǔn)文號(hào)必填庫存管理入庫、銷售出庫、盤點(diǎn)、庫存預(yù)警、流水查詢所有庫存變動(dòng)必須寫流水可追溯采購管理采購單登記、審核、到貨入庫一張采購單可以包含多個(gè)藥品銷售管理前臺(tái)售藥、銷售單查詢、退貨銷售時(shí)實(shí)時(shí)校驗(yàn)庫存和效期供應(yīng)商管理供應(yīng)商增刪改查包含聯(lián)系人、電話、地址、合作狀態(tài)會(huì)員管理會(huì)員發(fā)卡、積分管理、消費(fèi)記錄會(huì)員按手機(jī)號(hào)唯一標(biāo)識(shí)系統(tǒng)管理用戶管理、角色管理、操作日志管理員專用控制權(quán)限統(tǒng)計(jì)報(bào)表日/月銷售統(tǒng)計(jì)、低庫存、近效期、導(dǎo)出給店長和管理員看經(jīng)營數(shù)據(jù)2.3 核心業(yè)務(wù)流程采購入庫和前臺(tái)銷售是兩條主線整個(gè)系統(tǒng)最核心的兩條業(yè)務(wù)鏈路一條是“采購入庫”另一條是“前臺(tái)銷售”。采購入庫的流程是采購員選擇供應(yīng)商和藥品生成采購單藥品到貨后核對(duì)數(shù)量提交入庫系統(tǒng)自動(dòng)增加對(duì)應(yīng)藥品的庫存同時(shí)寫一條入庫類型的庫存流水記錄本次變動(dòng)前后數(shù)量。前臺(tái)銷售的流程是收銀員把顧客需要的藥品逐一加入銷售列表確認(rèn)數(shù)量后收款提交系統(tǒng)校驗(yàn)庫存和效期通過后扣減庫存、寫銷售流水、生成銷售主單和銷售明細(xì)單。如果顧客是會(huì)員還要同步累加積分。這兩條鏈路幾乎涵蓋了系統(tǒng)所有核心邏輯。代碼實(shí)現(xiàn)時(shí)先把這兩條流程跑通其他模塊基本都是在這兩條鏈路外圍做增刪改查。2.4 非功能性需求校驗(yàn)、權(quán)限和日志課設(shè)系統(tǒng)同學(xué)容易忽略非功能性需求但答辯加分往往靠這些點(diǎn)。后端入?yún)⒁鲂ｒ?yàn)比如庫存數(shù)量不能為負(fù)數(shù)、銷售數(shù)量不能大于庫存、藥品編碼不能重復(fù)。普通店員不能訪問成本價(jià)和利潤相關(guān)接口這個(gè)必須做。藥品改價(jià)、盤庫存這類操作要記錄操作人和操作時(shí)間方便追溯。3. 技術(shù)選型Spring Boot Java Web 的方案怎么定才穩(wěn)3.1 為什么 Spring Boot 成了課設(shè)“標(biāo)準(zhǔn)答案”以前做 Java Web 課設(shè)最常寫的是 SSM 整合就是在 Spring Spring MVC MyBatis 的基礎(chǔ)上手動(dòng)配一堆 XML 文件。Spring 的 applicationContext.xml、Spring MVC 的 dispatcher-servlet.xml、MyBatis 的 mybatis-config.xml哪個(gè)配置寫錯(cuò)一點(diǎn)項(xiàng)目啟動(dòng)就會(huì)直接報(bào)錯(cuò)對(duì)新手極其不友好。Spring Boot 帶來的最大改變是“約定大于配置”。它不僅把 SSM 的整合過程自動(dòng)完成還內(nèi)嵌了 Tomcat開發(fā)時(shí)直接啟動(dòng) main 方法就能看到效果部署時(shí)一個(gè) java -jar 命令就能跑。課設(shè)演示的時(shí)候再也不用先裝 Tomcat、改 server.xml、把 war 包手動(dòng)拷進(jìn) webapps體驗(yàn)上的提升非常明顯。從技術(shù)本質(zhì)上說Spring Boot 仍然是 Java Web 技術(shù)棧底層還是 Spring MVC只不過把繁瑣的配置收進(jìn)去了。在論文里寫“基于 Spring Boot 的 Java Web 系統(tǒng)”完全站得住腳。3.2 ORM 選 MyBatis-Plus單表不用寫 SQL復(fù)雜查詢又留得住持久層框架推薦 MyBatis-Plus理由非常簡單單表的增刪改查可以直接繼承 BaseMapper自帶 selectById、insert、updateById 等方法連 SQL 都不用寫。分頁查詢有官方分頁插件邏輯刪除和字段自動(dòng)填充都能配置。更重要的是MyBatis-Plus 沒有把自定義 SQL 的能力封死。統(tǒng)計(jì)報(bào)表、庫存預(yù)警這類需要多表聯(lián)查的復(fù)雜 SQL仍然可以寫在 Mapper XML 里由自己控制。這一點(diǎn)對(duì)課設(shè)項(xiàng)目很關(guān)鍵因?yàn)楹芏喔邇r(jià)值的模塊恰好是那些手寫 SQL 的地方。3.3 前端方案Thymeleaf Bootstrap 優(yōu)先Vue 按需選擇前端有兩種主流方案。第一種是服務(wù)端渲染Spring Boot Thymeleaf Bootstrap。頁面由 Controller 直接返回Thymeleaf 模板負(fù)責(zé)渲染數(shù)據(jù)Bootstrap 負(fù)責(zé)樣式。優(yōu)點(diǎn)是工程結(jié)構(gòu)簡單不需要 Node.js 環(huán)境啟動(dòng)后端就能看到一個(gè)完整的管理后臺(tái)特別適合單人開發(fā)。缺點(diǎn)是頁面交互比較傳統(tǒng)要實(shí)現(xiàn)復(fù)雜的前端效果會(huì)比較吃力。第二種是前后端分離Spring Boot 提供 REST API前端用 Vue3 Element Plus 搭后臺(tái)。界面確實(shí)更現(xiàn)代但這意味著你要同時(shí)維護(hù)兩套工程還要處理跨域、Token 鑒權(quán)、構(gòu)建環(huán)境等問題。如果對(duì) Node 和 Vue 不熟答辯現(xiàn)場很容易被環(huán)境問題卡住。我的建議課設(shè)項(xiàng)目優(yōu)先選 Thymeleaf Bootstrap穩(wěn)定不翻車。如果你確實(shí)想讓系統(tǒng)看起來有亮點(diǎn)可以做一個(gè) Vue 管理頁作為擴(kuò)展但至少保證后端 API 能用 Postman 完整演示這樣即使前端出問題也有補(bǔ)救空間。3.4 環(huán)境版本搭配別為了新版犧牲穩(wěn)定性我見過很多項(xiàng)目用最新的 Spring Boot 3.x結(jié)果 JDK 版本不夠直接啟動(dòng)失敗最后又回退。給你一個(gè)我長期在用的穩(wěn)定組合組件推薦版本備注JDK1.8 或 11學(xué)校電腦兼容性最好不要用 17Spring Boot2.7.x功能穩(wěn)定資料多MyBatis-Plus3.5.x3.5 以后對(duì) Boot2 支持良好MySQL5.7 或 8.0兩者都可以8.0 注意驅(qū)動(dòng)差異Maven3.6配合 IDEA 使用IDEA2022.3社區(qū)版也夠用數(shù)據(jù)庫驅(qū)動(dòng)如果用的是 MySQL 8.0記得在連接串里加 serverTimezoneAsia/Shanghai否則很容易踩時(shí)區(qū)問題。3.5 再說一下“LW”和源碼壓縮包的事標(biāo)題里的 LW 在課設(shè)圈里一般指“論文”或“設(shè)計(jì)文檔”也就是除了源碼之外還要交付的文檔材料。一個(gè)完整的課程設(shè)計(jì)/畢業(yè)設(shè)計(jì)交付物通常包含源碼、數(shù)據(jù)庫腳本、LW 文檔、演示視頻壓縮包命名里帶上日期或者版本號(hào)。源碼可運(yùn)行是底線文檔規(guī)范是加分項(xiàng)兩個(gè)都不能忽視。4. 數(shù)據(jù)庫設(shè)計(jì)這幾張表是怎么一步步定下來的4.1 藥品表藥店系統(tǒng)的心臟藥品表是整個(gè)系統(tǒng)最重要的表字段需要認(rèn)真設(shè)計(jì)。我用的核心字段如下字段說明id主鍵自增drug_code藥品編碼唯一索引common_name通用名比如“阿莫西林膠囊”trade_name商品名比如“再林”specification規(guī)格比如“0.25g*24?！眜nit單位盒/瓶/袋manufacturer生產(chǎn)廠家approval_number批準(zhǔn)文號(hào)國藥準(zhǔn)字purchase_price進(jìn)貨價(jià)DECIMAL(10,2)sale_price零售價(jià)DECIMAL(10,2)stock_quantity當(dāng)前庫存數(shù)量stock_lower_limit庫存下限低于這個(gè)值預(yù)警stock_upper_limit庫存上限expiry_date有效期至category_id藥品分類deleted邏輯刪除標(biāo)記進(jìn)貨價(jià)和零售價(jià)必須分開字段因?yàn)檫@兩個(gè)價(jià)格的可見人群不同。進(jìn)貨價(jià)用于成本核算由管理員維護(hù)店員界面不展示。批準(zhǔn)文號(hào)字段在答辯時(shí)能體現(xiàn)你對(duì)藥品行業(yè)的理解千萬別丟掉。4.2 用戶、角色、供應(yīng)商表用戶表 userid、username、password、real_name、phone、role_id、status。密碼不能存明文用 BCrypt 加密。角色表 roleid、role_name、role_key、description。管理員角色 key 是 admin店員是 clerk采購員是 purchaser。用戶直接掛 role_id不需要把權(quán)限系統(tǒng)做太復(fù)雜但角色要存在數(shù)據(jù)庫里不能寫死在代碼里。供應(yīng)商表 supplierid、supplier_name、contact_person、phone、address、status、remark。采購入庫時(shí)必須關(guān)聯(lián)供應(yīng)商保證采購數(shù)據(jù)能夠?qū)~。4.3 采購主單和采購明細(xì)為什么要拆兩張表采購單設(shè)計(jì)成主單 明細(xì)兩張表這是課設(shè)里非常值得講的部分。采購主表 purchase_orderid、order_no、supplier_id、total_amount、status待入庫/已入庫/已取消、create_time、create_by。采購明細(xì)表 purchase_order_itemid、order_id、drug_id、quantity、purchase_price、subtotal。為什么不把采購信息全部塞到一張表里因?yàn)橐粡埐少弳慰赡馨?5 種甚至 20 種藥品如果都放在一行同一張單的藥品會(huì)被拆成多行數(shù)據(jù)里就會(huì)大量重復(fù)單號(hào)查詢單據(jù)時(shí)還要處理重復(fù)。主單管理訂單整體信息明細(xì)管理每個(gè)藥品的條目一次采購單生成多條明細(xì)邊界非常清晰。后續(xù)做供應(yīng)商對(duì)賬、進(jìn)貨總額統(tǒng)計(jì)都能直接通過 order_id 關(guān)聯(lián)查詢。4.4 銷售主單和銷售明細(xì)訂單模型的常見設(shè)計(jì)銷售表和采購表結(jié)構(gòu)類似。銷售主表 sale_orderid、order_no、member_id、total_amount、pay_type現(xiàn)金/微信/支付寶、status、create_time、create_by。銷售明細(xì)表 sale_order_itemid、order_id、drug_id、quantity、sale_price、subtotal。這里要注意的是 member_id 允許為空因?yàn)榉菚?huì)員顧客也可以買藥。如果做退貨業(yè)務(wù)可以在主單上加 status 字段區(qū)分正常和退貨退貨時(shí)重新生成一條負(fù)數(shù)的庫存流水表示庫存回補(bǔ)。4.5 庫存流水表整個(gè)系統(tǒng)的賬本庫存流水表 stock_record 是容易被忽略但很關(guān)鍵的一張表。字段包括id、drug_id、change_type1 入庫、2 銷售扣減、3 報(bào)損、4 盤點(diǎn)調(diào)整、change_quantity正數(shù)增加負(fù)數(shù)減少、before_quantity、after_quantity、biz_no關(guān)聯(lián)的采購單號(hào)或銷售單號(hào)、create_time、create_by。有了這張表你可以隨時(shí)回答“某盒藥到底什么時(shí)候進(jìn)的、什么時(shí)候賣的、賣給了哪筆單子”這些問題。沒有流水?dāng)?shù)據(jù)庫里只剩一個(gè)當(dāng)前庫存數(shù)字連對(duì)賬都做不了。這也是答辯時(shí)一個(gè)可靠的亮點(diǎn)拿出庫存流水的時(shí)候老師會(huì)覺得你不是在寫玩具。4.6 會(huì)員表和用戶表分開會(huì)員表 memberid、card_no、name、phone、points、create_time。會(huì)員是藥店面向消費(fèi)者的客戶檔案用戶表是操作系統(tǒng)的人兩個(gè)模型必須分開。會(huì)員等級(jí)和積分可以先用一個(gè)字段存點(diǎn)數(shù)后續(xù)要擴(kuò)展等級(jí)再加一個(gè) level 字段就行。4.7 表設(shè)計(jì)的一些取舍外鍵字段邏輯關(guān)聯(lián)保留但不要在大表之間強(qiáng)制建物理外鍵約束。課設(shè)階段測試數(shù)據(jù)非常頻繁物理外鍵容易導(dǎo)致刪除失敗、導(dǎo)入順序報(bào)錯(cuò)。邏輯外鍵的意思是在代碼和 SQL 中通過 JOIN 來保證關(guān)系由業(yè)務(wù)層控制完整性不依賴數(shù)據(jù)庫約束。金額字段一律用 DECIMAL(10,2)不要用 DOUBLE 或 FLOAT浮點(diǎn)數(shù)在計(jì)算金額時(shí)會(huì)有精度損失。所有業(yè)務(wù)表都加 deleted 字段實(shí)現(xiàn)邏輯刪除這是 MyBatis-Plus 的標(biāo)配也方便論文里寫“系統(tǒng)支持?jǐn)?shù)據(jù)恢復(fù)”。5. 從零搭建項(xiàng)目把 Spring Boot 項(xiàng)目骨架搭起來5.1 創(chuàng)建項(xiàng)目和引入依賴打開 IDEANew Project 選擇 Spring InitializrJava 版本選 8依賴先勾選 Spring Web、MySQL Driver、Validation、Thymeleaf。生成之后在 pom.xml 里手動(dòng)加 MyBatis-Plus 和 Lombok。pom.xml 核心依賴長這樣dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency5.2 application.yml 配置配置文件是最容易出錯(cuò)的位置尤其是數(shù)據(jù)庫連接串。server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/pharmacy?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 thymeleaf: cache: false mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0這里要重點(diǎn)說一下 map-underscore-to-camel-case 的作用。數(shù)據(jù)庫字段一般是 create_time 下劃線風(fēng)格Java 實(shí)體類是 createTime 駝峰風(fēng)格這個(gè)配置打開之后 MyBatis 會(huì)自動(dòng)完成映射不用手寫 resultMap。邏輯刪除配置則保證調(diào)用 deleteById 時(shí)執(zhí)行的是 UPDATE deleted 1 而不是物理刪除。5.3 分包結(jié)構(gòu)一眼能看懂的工程我習(xí)慣用下面這個(gè)結(jié)構(gòu)com.example.pharmacy ├── config ├── controller ├── entity ├── mapper ├── service ├── service.impl ├── dto ├── vo └── commoncontroller 放接口入口service 放業(yè)務(wù)邏輯mapper 放數(shù)據(jù)庫訪問entity 放表映射實(shí)體common 放統(tǒng)一返回結(jié)果和異常處理。不要把業(yè)務(wù)邏輯堆在 controller 里否則 Service 層沒有內(nèi)容論文里寫“業(yè)務(wù)層設(shè)計(jì)”會(huì)非常虛。5.4 統(tǒng)一返回結(jié)果和全局異常處理前端頁面或者接口調(diào)用方如果每次接收的數(shù)據(jù)結(jié)構(gòu)都不一樣聯(lián)調(diào)就是災(zāi)難。定義一個(gè) Result 類全系統(tǒng)統(tǒng)一返回格式public class ResultT { private Integer code; private String message; private T data; public static T ResultT success(T data) { ResultT r new Result(); r.code 200; r.message ok; r.data data; return r; } public static T ResultT error(String message) { ResultT r new Result(); r.code 500; r.message message; return r; } }全局異常處理用 RestControllerAdvice 統(tǒng)一捕獲業(yè)務(wù)異常和未知異常避免把異常堆棧直接返回給前端。課設(shè)里的前端頁面如果直接暴露異常堆棧觀感很差而且有信息泄露風(fēng)險(xiǎn)。5.5 一個(gè)完整的藥品分頁查詢接口示例ControllerGetMapping(/drug/page) public ResultIPageDrug page(RequestParam(defaultValue 1) int page, RequestParam(defaultValue 10) int size, RequestParam(required false) String keyword) { return Result.success(drugService.pageQuery(page, size, keyword)); }Service 實(shí)現(xiàn)public IPageDrug pageQuery(int page, int size, String keyword) { PageDrug p new Page(page, size); LambdaQueryWrapperDrug wrapper Wrappers.lambdaQuery(); if (StringUtils.hasText(keyword)) { wrapper.like(Drug::getCommonName, keyword) .or().like(Drug::getTradeName, keyword); } return drugMapper.selectPage(p, wrapper); }這個(gè)接口同時(shí)支持分頁和關(guān)鍵字模糊搜索可以覆蓋藥品列表頁的全部需求。注意分頁插件需要在配置類里注冊(cè) MybatisPlusInterceptor加上 PaginationInnerInterceptor否則 selectPage 只能查出所有數(shù)據(jù)分頁不生效。6. 庫存與銷售課設(shè)里最值得寫進(jìn)論文的核心實(shí)現(xiàn)6.1 入庫操作為什么必須放在同一個(gè)事務(wù)里采購入庫涉及三步保存采購主單、更新藥品庫存、寫庫存流水。任何一個(gè)環(huán)節(jié)失敗都會(huì)造成庫存數(shù)據(jù)不一致。舉個(gè)例子如果保存采購單成功但更新庫存時(shí)報(bào)錯(cuò)數(shù)據(jù)庫里就會(huì)有一個(gè)“已入庫”狀態(tài)的采購單實(shí)際藥品數(shù)量卻沒有增加。再比如庫存已經(jīng)更新了但流水沒寫成將來對(duì)賬時(shí)完全說不清這個(gè)庫存是怎么來的。解決辦法是在 Service 方法上加 Transactional(rollbackFor Exception.class)讓三個(gè)操作要么全部成功要么全部回滾。事務(wù)是數(shù)據(jù)庫保證一致性的基礎(chǔ)也是答辯時(shí)必講的技術(shù)點(diǎn)。核心邏輯可以寫成這樣Transactional(rollbackFor Exception.class) public void purchaseStock(PurchaseOrder order, ListPurchaseOrderItem items) { purchaseOrderMapper.insert(order); for (PurchaseOrderItem item : items) { Drug drug drugMapper.selectById(item.getDrugId()); Integer before drug.getStockQuantity(); drug.setStockQuantity(before item.getQuantity()); drugMapper.updateById(drug); stockRecordMapper.insert(new StockRecord( item.getDrugId(), 1, item.getQuantity(), before, drug.getStockQuantity(), order.getOrderNo() )); } }6.2 銷售扣庫存并發(fā)情況下怎么避免超賣銷售最容易出的問題是并發(fā)扣庫存。如果兩個(gè)收銀員同時(shí)賣出同一盒藥庫存就剩 1 盒系統(tǒng)讀到兩個(gè)“庫存為 1”各自都執(zhí)行減 1最后庫存變成 -1實(shí)際卻賣出了 2 盒。解決思路是讓扣庫存的操作變成原子性的并且只有條件滿足時(shí)才執(zhí)行。比較常用的方式是樂觀鎖在 drug 表加一個(gè) version 字段扣庫存時(shí)使用帶條件的 updateUPDATE drug SET stock_quantity stock_quantity - #{quantity}, version version 1 WHERE id #{drugId} AND stock_quantity #{quantity} AND version #{version}如果 update 返回的影響行數(shù)為 0說明庫存不足或者版本號(hào)已變化業(yè)務(wù)層立刻拋出“庫存不足或操作沖突”提示收銀員刷新重試。這種方式在課設(shè)項(xiàng)目里已經(jīng)足夠可靠而且代碼量很小。6.3 庫存流水before 和 after 的妙用庫存流水的 before_quantity 和 after_quantity 字段初看是冗余的因?yàn)橥ㄟ^當(dāng)前庫存反推也能算出來。實(shí)際用起來會(huì)發(fā)現(xiàn)這對(duì)字段在數(shù)據(jù)核對(duì)時(shí)非常有用。比如某天盤點(diǎn)發(fā)現(xiàn)庫存少了 3 盒如果有流水可以按時(shí)間把每筆變動(dòng)列出來快速定位是哪筆操作出了問題。如果沒有流水就只能憑記憶找原因。把 before 和 after 帶上之后流水本身就是一條完整的審計(jì)鏈。寫入順序要注意先更新 drug 表的庫存再插入 stock_record流水里的 after_quantity 必須等于更新后的最新庫存。這兩個(gè)操作必須在同一個(gè)事務(wù)里否則會(huì)出現(xiàn)“流水寫了但庫存沒更新”的情況。6.4 近效期提醒用 SQL 把快過期藥品篩出來藥品效期是藥店業(yè)務(wù)里的剛需。查詢 90 天內(nèi)即將到期的藥品SELECT * FROM drug WHERE expiry_date BETWEEN CURDATE() AND DATE_ADD(CURDATE(), INTERVAL 90 DAY) AND deleted 0 ORDER BY expiry_date ASC這條 SQL 可以直接用在藥品列表頁的“近效期”Tab 中。更完整一點(diǎn)的做法是在銷售時(shí)增加效期校驗(yàn)如果藥品距離到期日不足 30 天前端彈窗提示收銀員確認(rèn)后二次放行。6.5 庫存預(yù)警低于下限自動(dòng)提醒庫存預(yù)警的 SQL 非常簡單SELECT * FROM drug WHERE stock_quantity stock_lower_limit AND deleted 0但要在首頁把它做成一個(gè)統(tǒng)計(jì)數(shù)據(jù)卡片比如“缺貨藥品 6 種”“近效期藥品 3 種”“今日銷售額 12800 元”這樣管理員打開系統(tǒng)第一眼就能看到異常情況。這三個(gè)數(shù)字看起來簡單實(shí)際上要做三張統(tǒng)計(jì) SQL分別查銷售總額、低庫存數(shù)量和近效期數(shù)量。寫完這三個(gè)接口首頁的展示效果立刻不一樣。6.6 統(tǒng)計(jì)報(bào)表和導(dǎo)出 Excel日?qǐng)?bào)表統(tǒng)計(jì)按自然日分組SELECT DATE(create_time) AS day, SUM(total_amount) AS amount FROM sale_order WHERE status 1 GROUP BY DATE(create_time) ORDER BY day DESC報(bào)表展示用折線圖或者柱狀圖可以用一個(gè)輕量級(jí)的圖表庫 ECharts通過 Thymeleaf 模板把數(shù)據(jù)拼到 JS 變量里渲染。導(dǎo)出功能推薦引入 EasyExcel 依賴寫一個(gè)導(dǎo)出接口把報(bào)表數(shù)據(jù)轉(zhuǎn)為 Excel 文件響應(yīng)給前端下載。這個(gè)功能不復(fù)雜但演示效果非常好是課設(shè)項(xiàng)目里一個(gè)性價(jià)比很高的亮點(diǎn)。7. 排錯(cuò)實(shí)錄課設(shè)跑不起來的常見原因我已經(jīng)幫你踩過一遍7.1 數(shù)據(jù)庫連接失敗被時(shí)區(qū)問題卡住最常見的報(bào)錯(cuò)是“Communications link failure”或者時(shí)區(qū)相關(guān)的異常。原因是連接串里沒有配置 serverTimezoneMySQL 8.0 的驅(qū)動(dòng)要求明確指定時(shí)區(qū)。解決辦法就是加上 serverTimezoneAsia/Shanghai。還有一種情況是密碼錯(cuò)誤報(bào)“Access denied for user rootlocalhost”要把 application.yml 里密碼改成你自己本機(jī)的數(shù)據(jù)庫密碼不要直接照抄網(wǎng)上配置。7.2 控制臺(tái)中文亂碼中文亂碼一般是字符集不統(tǒng)一造成的。確認(rèn)三處設(shè)置數(shù)據(jù)庫連接串里帶上 characterEncodingutf8數(shù)據(jù)庫表結(jié)構(gòu)默認(rèn)字符集是 utf8mb4IDE 的 File Encoding 全部改成 UTF-8。如果是頁面亂碼還要確認(rèn)前端模板文件頭部有meta charsetUTF-8。7.3 前端提交日期參數(shù)報(bào) 400前臺(tái)頁面用表單提交一個(gè)日期字符串比如“2024-05-20 14:30”后端用 Date 類型接收時(shí)Spring MVC 默認(rèn)不認(rèn)識(shí)這個(gè)格式會(huì)直接返回 400。解決辦法是在實(shí)體類的日期字段上加上 DateTimeFormat(pattern yyyy-MM-dd HH:mm:ss)。如果是通過 JSON 傳輸要改用 JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8)。這兩個(gè)注解容易搞混我每次都會(huì)檢查一下。7.4 MyBatis-Plus 自動(dòng)填充不生效如果實(shí)體類里有 createTime 和 updateTime并且加了 TableField(fill FieldFill.INSERT)但插入數(shù)據(jù)后這兩個(gè)字段是 null原因是你沒有配置 MetaObjectHandler。自動(dòng)填充需要一個(gè)處理器在插入時(shí)自動(dòng) set 創(chuàng)建時(shí)間和修改時(shí)間。Component public class MyMetaObjectHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } }配置了之后createTime 和 updateTime 就會(huì)自動(dòng)維護(hù)不需要每個(gè) Service 方法手動(dòng) set。7.5 靜態(tài)資源 404頁面樣式全丟了Spring Boot 的默認(rèn)靜態(tài)資源路徑是 classpath:/static/模板頁面放在 classpath:/templates/ 下。Thymeleaf 頁面里引用 CSS 時(shí)要用 th:href{/css/style.css}或者寫成 /css/style.css 絕對(duì)路徑不要用相對(duì)路徑否則從不同 URL 進(jìn)入頁面時(shí)路徑會(huì)亂掉。7.6 啟動(dòng)報(bào)端口占用啟動(dòng)時(shí)如果提示“Port 8080本文還有配套的精品資源點(diǎn)擊獲取