最近整理手頭一個(gè)實(shí)驗(yàn)室排課項(xiàng)目把源碼、配套文檔、調(diào)試記錄全部捋了一遍打包成一個(gè)可以直接拿去用的完整工程。這個(gè)項(xiàng)目叫“基于JavaSSMDjango實(shí)驗(yàn)室排課系統(tǒng)”說白了就是從實(shí)驗(yàn)室教學(xué)管理中最煩人的排課問題入手做成一套集課程安排、實(shí)驗(yàn)室預(yù)約、課表查詢、教師學(xué)生管理于一體的系統(tǒng)。很多高校實(shí)驗(yàn)中心、職業(yè)技術(shù)學(xué)院實(shí)訓(xùn)室、培訓(xùn)機(jī)構(gòu)機(jī)房甚至一些做硬件實(shí)驗(yàn)的科研組都面臨著同樣的痛點(diǎn)實(shí)驗(yàn)課程多、實(shí)驗(yàn)室有限、時(shí)間沖突頻繁、臨時(shí)調(diào)課全靠人工協(xié)調(diào)。這套系統(tǒng)就是用來解決這些問題的同時(shí)它也是一份非常典型的信息管理系統(tǒng)課程設(shè)計(jì)/畢業(yè)設(shè)計(jì)項(xiàng)目源碼、論文、調(diào)試文檔、講解視頻都齊了適合正在做相關(guān)課題的開發(fā)者參考也適合想了解實(shí)驗(yàn)室預(yù)約管理業(yè)務(wù)邏輯的人閱讀。這套系統(tǒng)最讓我滿意的地方是它提供了兩個(gè)技術(shù)棧的實(shí)現(xiàn)思路。一是Java生態(tài)的SSM框架組合另外一個(gè)是Python的Django版本。兩者可以獨(dú)立運(yùn)行也可以互相參考。如果你正在糾結(jié)做Java方向還是Python方向的課設(shè)這個(gè)項(xiàng)目可以直接給你一套現(xiàn)成的對(duì)照答案。下面我把項(xiàng)目的需求拆解、技術(shù)選型、數(shù)據(jù)表設(shè)計(jì)、核心算法、調(diào)試部署、文檔寫作以及答辯講解思路完整展開把我在復(fù)現(xiàn)這個(gè)項(xiàng)目過程中踩過的坑和總結(jié)的經(jīng)驗(yàn)一并寫清楚。1. 需求先行實(shí)驗(yàn)室排課的核心痛點(diǎn)與角色權(quán)限很多第一次接觸排課系統(tǒng)的朋友上來就急吼吼地寫表、寫接口結(jié)果做到一半發(fā)現(xiàn)業(yè)務(wù)邏輯根本理不清。所以先別急著看代碼先把需求盤子端出來。1.1 實(shí)驗(yàn)教學(xué)的排課困局為什么需要專門做一套系統(tǒng)實(shí)驗(yàn)課和理論課最大的不同是它強(qiáng)依賴物理資源。理論課在普通教室只要有桌椅黑板就能上但實(shí)驗(yàn)課必須綁定實(shí)驗(yàn)室里的設(shè)備、儀器、軟件環(huán)境。比如計(jì)算機(jī)基礎(chǔ)實(shí)驗(yàn)室要求每臺(tái)機(jī)器裝好編譯環(huán)境單片機(jī)實(shí)驗(yàn)室要求有開發(fā)板化學(xué)實(shí)驗(yàn)室對(duì)通風(fēng)和藥品柜有要求。這些資源無(wú)法無(wú)限制擴(kuò)展只能在有限的空間內(nèi)做時(shí)間維度的調(diào)配。在沒有系統(tǒng)的年代實(shí)驗(yàn)課排課通?？縀xcel表格。每個(gè)人發(fā)一張共享表格你填一個(gè)格子我填一個(gè)格子一旦有人誤刪或者改錯(cuò)了時(shí)間后面全亂。更麻煩的是臨時(shí)調(diào)課。老師出差、設(shè)備維修、課表調(diào)整每次改動(dòng)都要在QQ群、微信群里反復(fù)通知最終確認(rèn)版分散在各個(gè)聊天記錄里根本找不到正本。這些痛點(diǎn)催生了實(shí)驗(yàn)室排課系統(tǒng)這個(gè)細(xì)分產(chǎn)品它把實(shí)驗(yàn)室、課程、教師、班級(jí)、時(shí)間片放在一個(gè)數(shù)據(jù)庫(kù)里通過程序自動(dòng)檢測(cè)沖突并給出一張清晰可查的課表。我接觸過不少做課設(shè)的同學(xué)他們一開始會(huì)把需求想象得非常復(fù)雜恨不得加上人臉識(shí)別、短信通知、大數(shù)據(jù)分析。但真正立項(xiàng)前要明白核心需求永遠(yuǎn)是最樸素的那幾個(gè)能不能快速排課、能不能避免沖突、能不能讓老師和學(xué)生方便地查到課表。這個(gè)項(xiàng)目在需求分析階段就穩(wěn)扎穩(wěn)打把主要功能鎖定在基礎(chǔ)但必須的范圍內(nèi)這也是它能保質(zhì)保量完成的原因。1.2 用戶角色拆解管理員、教師、學(xué)生到底要什么做信息管理系統(tǒng)最重要的就是搞清楚誰(shuí)會(huì)使用系統(tǒng)每個(gè)人會(huì)做什么。這套實(shí)驗(yàn)室排課系統(tǒng)設(shè)計(jì)了三個(gè)角色邏輯非常清晰。第一是管理員角色。管理員通常是實(shí)驗(yàn)中心的負(fù)責(zé)人或者實(shí)驗(yàn)室助理。他們的核心操作是維護(hù)實(shí)驗(yàn)室的基礎(chǔ)數(shù)據(jù)包括實(shí)驗(yàn)室名稱、類型、樓層位置、可容納人數(shù)、設(shè)備信息。同時(shí)要管理教師賬號(hào)、班級(jí)信息還要對(duì)排課結(jié)果做整體調(diào)整。最重要的是管理員需要處理教師提交的預(yù)約申請(qǐng)核實(shí)這個(gè)時(shí)間段實(shí)驗(yàn)室是否空閑批準(zhǔn)或者駁回。所以管理員端的功能權(quán)限覆蓋全系統(tǒng)界面入口也最多。第二是教師角色。教師是排課申請(qǐng)的主要發(fā)起方。他們的需求很直接我要在某個(gè)實(shí)驗(yàn)室上某門實(shí)驗(yàn)課希望選擇合適的時(shí)間段和教室。系統(tǒng)需要給教師提供可預(yù)約的實(shí)驗(yàn)室列表顯示剩余容量和時(shí)間可用性。教師在系統(tǒng)里提交申請(qǐng)后能隨時(shí)查看審批狀態(tài)也能看到自己名下已經(jīng)排好的課表。第三是學(xué)生角色。學(xué)生是整個(gè)業(yè)務(wù)的最終對(duì)象。嚴(yán)格說起來學(xué)生不做排課操作但學(xué)生需要知道哪門實(shí)驗(yàn)課在哪個(gè)實(shí)驗(yàn)室、哪一周開始上、上課地點(diǎn)在哪。所以學(xué)生端提供按班級(jí)查詢課表的功能即可。有些擴(kuò)展版還會(huì)加學(xué)生簽到、成績(jī)管理等模塊但本系統(tǒng)堅(jiān)持邊界清晰不做過多鋪陳。這種角色劃分對(duì)應(yīng)到數(shù)據(jù)庫(kù)設(shè)計(jì)中就是用戶表里加一個(gè)role字段通過權(quán)限框架控制菜單可見性和接口訪問范圍。在Java SSM版本里用攔截器或Shiro處理權(quán)限在Django版本里用自帶的認(rèn)證系統(tǒng)配合自定義裝飾器都是很成熟的做法。角色職責(zé)不模糊后面寫代碼才不會(huì)亂。1.3 核心業(yè)務(wù)流程從“申請(qǐng)實(shí)驗(yàn)室”到“生成課表”的完整鏈路完整業(yè)務(wù)流程可以梳理成一條主線。第一步管理員登錄系統(tǒng)先維護(hù)基礎(chǔ)數(shù)據(jù)包括實(shí)驗(yàn)室信息、實(shí)驗(yàn)課程信息、教師信息、班級(jí)信息。第二步教師登錄系統(tǒng)在可預(yù)約的實(shí)驗(yàn)室列表里選擇目標(biāo)實(shí)驗(yàn)室點(diǎn)擊某個(gè)空閑時(shí)間片填寫課程名稱、上課班級(jí)、上課周次提交預(yù)約申請(qǐng)。第三步管理員在審批列表里看到申請(qǐng)系統(tǒng)會(huì)自動(dòng)提示該時(shí)間片是否已被占用管理員確認(rèn)無(wú)誤后點(diǎn)擊通過。第四步系統(tǒng)根據(jù)審批通過的數(shù)據(jù)自動(dòng)生成課表教師和學(xué)生登錄后就能看到自己相關(guān)的課程安排。第五步如果發(fā)生調(diào)課需求教師可以發(fā)起調(diào)課申請(qǐng)管理員重新審批同時(shí)系統(tǒng)釋放原時(shí)間片。這條鏈路中隱藏著幾個(gè)關(guān)鍵設(shè)計(jì)點(diǎn)。其一是“時(shí)間片”這個(gè)概念。實(shí)驗(yàn)室不是全天候無(wú)限可用通常按照上午、下午、晚上劃分也可以細(xì)化為第幾節(jié)到第幾節(jié)。系統(tǒng)把一天分割成固定數(shù)量時(shí)間片每個(gè)實(shí)驗(yàn)室在每個(gè)時(shí)間片內(nèi)只能排一門課。其二是“重復(fù)規(guī)則”。很多實(shí)驗(yàn)課不是只上一次而是每周一次共八周。所以排課系統(tǒng)要支持按周次重復(fù)而不是生成單次事件。本系統(tǒng)提供了一個(gè)靈活的處理方式把排課記錄設(shè)計(jì)成“基礎(chǔ)排課周次字段”前端展示時(shí)按周次展開。這種方式比生成多條重復(fù)記錄更節(jié)省數(shù)據(jù)庫(kù)空間也更容易做調(diào)課操作。以上這些都是我復(fù)現(xiàn)項(xiàng)目時(shí)反復(fù)推敲過的地方。需求梳理清楚了后面的數(shù)據(jù)庫(kù)設(shè)計(jì)和編碼只是水到渠成的事。2. 技術(shù)選型與架構(gòu)設(shè)計(jì)JavaSSM和Django的組合邏輯看到項(xiàng)目名里的“JavaSSMDjango”時(shí)很多人會(huì)疑惑SSM不是Java框架嗎Django不是Python框架嗎怎么放一起了這個(gè)疑點(diǎn)非常正常。實(shí)際上這個(gè)標(biāo)題表達(dá)的是系統(tǒng)可以用兩種技術(shù)棧實(shí)現(xiàn)或者已經(jīng)提供了兩套可供選擇的代碼。這恰恰是這個(gè)項(xiàng)目有價(jià)值的地方。2.1 為什么會(huì)有JavaSSM和Django兩套實(shí)現(xiàn)技術(shù)選型背后的思考先說說SSM。SSM是Spring SpringMVC MyBatis的組合是Java后端開發(fā)里非常經(jīng)典的搭建方式。Spring負(fù)責(zé)依賴管理和事務(wù)控制SpringMVC負(fù)責(zé)接收HTTP請(qǐng)求并轉(zhuǎn)發(fā)給業(yè)務(wù)層MyBatis負(fù)責(zé)數(shù)據(jù)庫(kù)映射。這套組合在中國(guó)很多高校和中小型項(xiàng)目中應(yīng)用極廣因?yàn)樗奈臋n多、社區(qū)成熟、上手曲線相對(duì)平緩相對(duì)于重量級(jí)的Spring Boot來說SSM更透明更適合教學(xué)場(chǎng)景。用Java做排課系統(tǒng)可以利用強(qiáng)類型語(yǔ)言的優(yōu)勢(shì)把課程時(shí)間、實(shí)驗(yàn)室編號(hào)等業(yè)務(wù)邏輯做得更嚴(yán)謹(jǐn)同時(shí)MyBatis的SQL可以精細(xì)管理查詢尤其在處理課表這種復(fù)雜關(guān)聯(lián)查詢時(shí)有天然優(yōu)勢(shì)。再來看Django。Django是一個(gè)高度集成的Python Web框架自帶Admin后臺(tái)、ORM、用戶認(rèn)證、模板引擎。如果項(xiàng)目決策者更熟悉Python或者希望開發(fā)效率更高Django是絕佳選擇。它的ORM讓開發(fā)者不需要寫太多原生SQLAdmin后臺(tái)甚至可以直接用來管理實(shí)驗(yàn)室和預(yù)約記錄。對(duì)于實(shí)驗(yàn)室排課系統(tǒng)這種業(yè)務(wù)復(fù)雜度中規(guī)中矩的項(xiàng)目Django可以讓你以極少的代碼快速完成核心功能。那為什么兩者都要提供我的理解是不同學(xué)習(xí)背景的同學(xué)需要不同技術(shù)棧的參考。做Java課設(shè)的人可以專注研究SSM版本做Python課設(shè)的人可以直接用Django版本。同時(shí)兩份代碼的數(shù)據(jù)庫(kù)設(shè)計(jì)思路和業(yè)務(wù)邏輯是高度一致的這就形成了一個(gè)絕佳的對(duì)比學(xué)習(xí)素材。如果你有精力甚至可以把它改造成雙端微服務(wù)用Java提供一個(gè)管理接口用Python提供一個(gè)數(shù)據(jù)服務(wù)接口擴(kuò)展成一個(gè)跨語(yǔ)言教學(xué)案例。當(dāng)然那種復(fù)雜度超出課設(shè)范圍這里不展開。2.2 系統(tǒng)整體架構(gòu)前后端分離還是傳統(tǒng)MVC這套系統(tǒng)在架構(gòu)上選擇的是傳統(tǒng)服務(wù)端渲染MVC模式而不是前后端分離。這個(gè)選擇是由項(xiàng)目類型和使用場(chǎng)景決定的。實(shí)驗(yàn)室排課系統(tǒng)屬于典型的內(nèi)部業(yè)務(wù)管理系統(tǒng)用戶量不大并發(fā)不高更重要的是需要快速開發(fā)、易于部署。服務(wù)端渲染模式把頁(yè)面邏輯和業(yè)務(wù)邏輯放在一個(gè)工程里部署時(shí)只需在服務(wù)器上配置好Java容器或Python環(huán)境直接運(yùn)行即可。如果強(qiáng)行拆成Vue前后端分離不僅增加了跨域處理、Token鑒權(quán)、反向代理等復(fù)雜度還會(huì)讓整個(gè)項(xiàng)目體積翻倍對(duì)課設(shè)或者小型項(xiàng)目來說并不劃算。不過項(xiàng)目中也巧妙結(jié)合了Ajax局部更新。比如在課表頁(yè)面點(diǎn)擊不同周次查看課程時(shí)頁(yè)面不需要整體刷新而是通過異步請(qǐng)求獲取對(duì)應(yīng)的數(shù)據(jù)渲染到表格中。這種體驗(yàn)比傳統(tǒng)表單提交流暢很多代碼結(jié)構(gòu)也不算復(fù)雜。從分層角度看SSM版本分為Controller層、Service層、Dao層三層Django版本按照MTV模式分為模型、視圖、模板。兩層架構(gòu)的思想是相通的。Controller/視圖負(fù)責(zé)接收請(qǐng)求、校驗(yàn)權(quán)限、調(diào)用業(yè)務(wù)、返回頁(yè)面或JSONService層負(fù)責(zé)核心業(yè)務(wù)邏輯比如沖突檢測(cè)、課表生成Dao層/模型與數(shù)據(jù)庫(kù)交互。我在讀這套源碼時(shí)最看重的是Service層的清晰程度。只要業(yè)務(wù)邏輯不散落在Controller里后續(xù)擴(kuò)展和維護(hù)都會(huì)非常輕松。2.3 數(shù)據(jù)庫(kù)設(shè)計(jì)實(shí)驗(yàn)室、課程、排課關(guān)系模型數(shù)據(jù)庫(kù)設(shè)計(jì)是排課系統(tǒng)的靈魂我建議所有人在寫代碼之前先靜下心畫一遍ER圖。這套項(xiàng)目里涉及的核心數(shù)據(jù)表如下表名核心字段作用說明用戶表id, username, password, role, name, phone存儲(chǔ)管理員、教師、學(xué)生的賬號(hào)信息實(shí)驗(yàn)室表id, lab_name, location, capacity, lab_type, status存儲(chǔ)實(shí)驗(yàn)室的名稱、位置、容量、類型計(jì)算機(jī)/電子/化學(xué)等課程表id, course_name, credit, hours, course_type存儲(chǔ)課程基礎(chǔ)信息如實(shí)驗(yàn)課程名稱和學(xué)時(shí)班級(jí)表id, class_name, grade, major, class_size存儲(chǔ)班級(jí)信息排課時(shí)關(guān)聯(lián)上課班級(jí)時(shí)間片表id, start_time, end_time, period_index定義一天中的時(shí)間段如上午一二節(jié)、下午三四節(jié)排課表id, lab_id, course_id, teacher_id, class_id, time_slot_id, weeks, status核心業(yè)務(wù)表記錄某實(shí)驗(yàn)室某時(shí)間片安排的課程、教師、班級(jí)及周次預(yù)約表id, lab_id, teacher_id, time_slot_id, date, status, reason教師發(fā)起的臨時(shí)預(yù)約申請(qǐng)記錄和排課表有業(yè)務(wù)關(guān)聯(lián)但邏輯獨(dú)立這里重點(diǎn)講一下排課表的設(shè)計(jì)。排課表中的weeks字段存儲(chǔ)的是一個(gè)類似字符串的周次標(biāo)識(shí)比如“1-16周”或者“2,4,6,8周”。為了查詢簡(jiǎn)單在Django版本里可以直接用JSON或逗號(hào)分隔字符串存儲(chǔ)在SSM的MySQL版本里也可以用VARCHAR存儲(chǔ)。但這種方案在按周次展開課表時(shí)需要在Java代碼或模板中做字符串解析略麻煩。更規(guī)整的做法是再建一張排課周次子表每條排課記錄對(duì)應(yīng)多行每行一個(gè)周次。兩利相權(quán)取其重對(duì)于課設(shè)項(xiàng)目把周次處理放在代碼里的做法更直觀也更容易講解。如果追求健壯性可以考慮子表方式。還有一張預(yù)約表也要注意。預(yù)約表和排課表雖然有點(diǎn)像但業(yè)務(wù)語(yǔ)義不同排課表是管理員審批通過后的正式課程預(yù)約表是教師發(fā)起的臨時(shí)申請(qǐng)。正式課程在系統(tǒng)里是穩(wěn)定存在的數(shù)據(jù)臨時(shí)預(yù)約則是“申請(qǐng)-審批-結(jié)束”的流程實(shí)體。把兩者分開能避免狀態(tài)混亂也讓數(shù)據(jù)庫(kù)邏輯更好講清楚。2.4 關(guān)鍵技術(shù)點(diǎn)解析權(quán)限控制、事務(wù)管理與并發(fā)預(yù)約處理實(shí)驗(yàn)室排課在技術(shù)上真正有含金量的地方有三個(gè)權(quán)限控制、事務(wù)管理、并發(fā)預(yù)約。權(quán)限控制方面SSM版本中寫了攔截器對(duì)包含/admin/、/teacher/、/student/的URL做角色校驗(yàn)。登錄用戶在Session中保存user對(duì)象攔截器從Session中取出角色信息匹配不上就跳轉(zhuǎn)登錄頁(yè)或權(quán)限不足頁(yè)面。Django版本則利用自帶的login_required和自定義裝飾器role_required類似的功能但代碼更簡(jiǎn)潔。這里的核心思想是“后端必須校驗(yàn)”前端隱藏按鈕只是改善體驗(yàn)真正攔得住非法訪問的是后端的權(quán)限判斷。事務(wù)管理方面只要一次請(qǐng)求可能涉及多張數(shù)據(jù)表更新就必須考慮事務(wù)。比如教師提交排課申請(qǐng)時(shí)需要寫入排課記錄并更新實(shí)驗(yàn)室狀態(tài)如果第一步成功而第二步失敗數(shù)據(jù)就會(huì)不一致。SSM中通過在Service層方法上添加Transactional注解來實(shí)現(xiàn)一旦方法內(nèi)部拋出異常Spring會(huì)自動(dòng)回滾。Django里使用transaction.atomic()上下文管理器效果也是一樣的。這個(gè)設(shè)計(jì)點(diǎn)是答辯時(shí)很愿意問到的考點(diǎn)建議重點(diǎn)掌握。并發(fā)預(yù)約處理方面這是系統(tǒng)最容易被問倒的細(xì)節(jié)。如果兩個(gè)教師同一時(shí)間點(diǎn)擊同一個(gè)空閑實(shí)驗(yàn)室怎么辦數(shù)據(jù)庫(kù)層面的處理方式有兩種。第一種是悲觀鎖用SELECT ... FOR UPDATE將那條實(shí)驗(yàn)室時(shí)間片記錄鎖住另一個(gè)請(qǐng)求必須等待事務(wù)結(jié)束后才能讀取代價(jià)是并發(fā)性能下降但能保證100%不誤判。第二種是樂觀鎖在業(yè)務(wù)表增加一個(gè)版本號(hào)字段或狀態(tài)字段在更新時(shí)檢查狀態(tài)是否仍為“空閑”如果已經(jīng)被占用則更新影響行數(shù)為0代碼中提交失敗并提示用戶。這個(gè)項(xiàng)目采取了更簡(jiǎn)單的方案即在提交時(shí)再次查詢時(shí)間片狀態(tài)雖然做不到數(shù)據(jù)庫(kù)級(jí)別強(qiáng)一致但對(duì)課設(shè)場(chǎng)景已經(jīng)足夠。我認(rèn)為這是一個(gè)需要向面試官或答辯老師坦誠(chéng)說明的地方也可以作為擴(kuò)展優(yōu)化點(diǎn)提出如果要做高并發(fā)預(yù)約建議引入Redis分布式鎖或數(shù)據(jù)庫(kù)樂觀鎖版本字段。3. 核心模塊代碼實(shí)現(xiàn)課程安排、時(shí)間片沖突與預(yù)約管理需求分析和技術(shù)設(shè)計(jì)都是紙面功夫真正要落到代碼上才會(huì)發(fā)現(xiàn)各種細(xì)節(jié)。這一部分我摘出幾個(gè)關(guān)鍵功能的實(shí)現(xiàn)思路并附上核心代碼片段。3.1 基礎(chǔ)代碼結(jié)構(gòu)實(shí)體類、Dao層與Service層怎么組織先看SSM版本。項(xiàng)目結(jié)構(gòu)分成controller、service、dao、entity、interceptor、util等包。實(shí)體類對(duì)應(yīng)數(shù)據(jù)庫(kù)表表字段和Java類屬性一一映射。以排課記錄為例一個(gè)簡(jiǎn)化版的實(shí)體類類似這樣public class CourseSchedule { private Integer id; private Integer labId; private Integer courseId; private Integer teacherId; private Integer classId; private Integer timeSlotId; private String weeks; private String status; // getter/setter 略 }Dao層是一個(gè)Mapper接口加一個(gè)XML文件用于定義SQL。比如查詢某個(gè)實(shí)驗(yàn)室某個(gè)時(shí)間片是否被占用select idcountByLabAndTimeSlot resultTypeint SELECT COUNT(*) FROM course_schedule WHERE lab_id #{labId} AND time_slot_id #{timeSlotId} AND status approved /selectService層是最核心的部分它調(diào)用Dao層方法并組織業(yè)務(wù)流程。比如申請(qǐng)排課的Service方法邏輯為先校驗(yàn)教師身份是否合法、班級(jí)是否存在再校驗(yàn)時(shí)間片是否被占用都通過則插入排課記錄。Service層解決的是“業(yè)務(wù)規(guī)則”問題而不是簡(jiǎn)單的數(shù)據(jù)訪問所以必須把它和Dao層區(qū)分開。我見過很多初學(xué)者把業(yè)務(wù)邏輯寫在Controller里最后Controller動(dòng)輒幾百行改起來痛苦不堪。這套項(xiàng)目的代碼結(jié)構(gòu)是很標(biāo)準(zhǔn)的你可以照著它來練習(xí)分層設(shè)計(jì)。Django版本的結(jié)構(gòu)則更簡(jiǎn)潔。模型寫在models.py中一個(gè)類對(duì)應(yīng)一張表邏輯寫在views.py中外加需要序列化的數(shù)據(jù)通過Django模板變量傳遞。由于Django的ORM非常方便大多數(shù)查詢一行代碼就能寫完開發(fā)速度更快。但相對(duì)的動(dòng)態(tài)生成復(fù)雜課表HTML時(shí)模板標(biāo)簽會(huì)顯得有點(diǎn)繞。如果你熟悉Python列表推導(dǎo)和zip函數(shù)其實(shí)用視圖生成好二維課表數(shù)組再傳給模板是更清晰的方案。3.2 排課核心算法時(shí)間片分配與沖突檢測(cè)的實(shí)現(xiàn)要做出準(zhǔn)確的課表必須實(shí)現(xiàn)沖突檢測(cè)。簡(jiǎn)單說就是查詢某個(gè)實(shí)驗(yàn)室、某個(gè)時(shí)間片、某個(gè)周次下是否已經(jīng)存在記錄。因?yàn)榕耪n表中weeks是字符串存儲(chǔ)檢測(cè)時(shí)不能直接用SQL相等判斷。我在代碼里采用的做法是先把周次字符串拆成整數(shù)集合再通過遍歷比對(duì)傳入周次是否有交集。以Java實(shí)現(xiàn)為例public boolean isTimeSlotOccupied(Integer labId, Integer timeSlotId, String weeks) { ListCourseSchedule schedules scheduleDao.selectByLabAndTimeSlot(labId, timeSlotId); SetInteger targetWeeks parseWeeks(weeks); for (CourseSchedule s : schedules) { SetInteger existingWeeks parseWeeks(s.getWeeks()); if (!Collections.disjoint(targetWeeks, existingWeeks)) { return true; } } return false; } private SetInteger parseWeeks(String weeks) { SetInteger result new HashSet(); if (weeks null || weeks.isEmpty()) return result; String[] parts weeks.split(,); for (String part : parts) { if (part.contains(-)) { String[] bounds part.split(-); int start Integer.parseInt(bounds[0]); int end Integer.parseInt(bounds[1]); for (int i start; i end; i) result.add(i); } else { result.add(Integer.parseInt(part)); } } return result; }這算是一個(gè)小型但實(shí)用的算法片段。它把“第2-8周”這類字符串展開成具體周次集合然后通過求交集判斷兩個(gè)排課是否重疊。在Django版本中可以直接用Python的set結(jié)構(gòu)同樣實(shí)現(xiàn)邏輯完全一致。這種方式比單純比較字符串可靠得多因?yàn)椤?-10周”和“8-16周”在字符串層面不同但在周次層面有重疊只有展開后求交才能準(zhǔn)確判斷。課表生成的邏輯也很值得一提。常見需求是顯示某教師或某班級(jí)的每周課表最簡(jiǎn)單的實(shí)現(xiàn)是先確定這周對(duì)應(yīng)的周次數(shù)字然后篩選出排課表里weeks包含該周次的記錄再按實(shí)驗(yàn)室和星期組合成一個(gè)二維表。設(shè)計(jì)課表時(shí)通常會(huì)以“星期幾”和“節(jié)次時(shí)間片”為兩個(gè)維度。這里有個(gè)小技巧在數(shù)據(jù)庫(kù)里加一個(gè)day_of_week字段標(biāo)記每門實(shí)驗(yàn)課在一周內(nèi)的哪一天上課否則無(wú)法正確分布在周一到周五的單元格里。首次設(shè)計(jì)時(shí)我忽略了這一點(diǎn)導(dǎo)致課表無(wú)法生成這個(gè)經(jīng)驗(yàn)在后面調(diào)試部分會(huì)詳細(xì)講。3.3 實(shí)驗(yàn)室預(yù)約與審批流程實(shí)現(xiàn)預(yù)約審批流程在代碼中體現(xiàn)為狀態(tài)機(jī)流轉(zhuǎn)。預(yù)約表的status字段有“待審核”、“已通過”、“已駁回”三種狀態(tài)。教師提交預(yù)約時(shí)狀態(tài)自動(dòng)置為待審核。管理員看到待審核記錄后點(diǎn)擊通過或駁回。通過操作不僅僅是修改狀態(tài)一般還要連帶校驗(yàn)時(shí)間片是否被其他預(yù)約或正式排課占用。這套邏輯在兩個(gè)技術(shù)棧中的實(shí)現(xiàn)都大同小異。這里我給出一個(gè)SSM版本的Service層批準(zhǔn)預(yù)約方法核心是兩步操作Transactional public boolean approveAppointment(Integer appointmentId) { Appointment appointment appointmentDao.selectById(appointmentId); if (appointment null || !pending.equals(appointment.getStatus())) { return false; } boolean occupied scheduleService.isTimeSlotOccupied( appointment.getLabId(), appointment.getTimeSlotId(), appointment.getWeeks() ); if (occupied) { throw new BusinessException(該時(shí)間片已被占用審批失敗); } appointment.setStatus(approved); appointmentDao.updateStatus(appointment); // 同時(shí)生成一條正式排課記錄 CourseSchedule schedule new CourseSchedule(); schedule.setLabId(appointment.getLabId()); schedule.setCourseId(appointment.getCourseId()); schedule.setTeacherId(appointment.getTeacherId()); schedule.setClassId(appointment.getClassId()); schedule.setTimeSlotId(appointment.getTimeSlotId()); schedule.setWeeks(appointment.getWeeks()); schedule.setStatus(approved); scheduleDao.insert(schedule); return true; }注意這里的Transactional注解保證修改預(yù)約狀態(tài)和新增排課記錄兩個(gè)動(dòng)作要么全部成功要么全部回滾。我在很多課設(shè)源碼中看到有人把這兩步分開寫在Controller里沒有事務(wù)控制一旦第二次插入失敗預(yù)約狀態(tài)變?yōu)橐淹ㄟ^但排課表里卻沒有記錄這種錯(cuò)誤現(xiàn)場(chǎng)非常尷尬。希望大家在寫類似邏輯時(shí)一定記得事務(wù)。Django版本中事務(wù)上下文管理器會(huì)顯得更優(yōu)雅def approve_appointment(request, appointment_id): with transaction.atomic(): appointment Appointment.objects.select_for_update().get(idappointment_id) if appointment.status ! pending: return JsonResponse({code: 400, msg: 狀態(tài)錯(cuò)誤}) if check_time_slot_conflict(appointment.lab_id, appointment.time_slot, appointment.weeks): return JsonResponse({code: 400, msg: 時(shí)間片已被占用}) appointment.status approved appointment.save() CourseSchedule.objects.create(...) return JsonResponse({code: 200, msg: 審批成功})select_for_update()在Django中就是悲觀鎖實(shí)現(xiàn)讀的時(shí)候鎖住該行直到事務(wù)結(jié)束這樣可以進(jìn)一步避免并發(fā)審批同一個(gè)預(yù)約。雖然這個(gè)系統(tǒng)并發(fā)量低但把這兩個(gè)方法對(duì)照學(xué)習(xí)你對(duì)后臺(tái)事務(wù)和鎖的理解會(huì)加深一大截。3.4 可視化課表輸出前端頁(yè)面與導(dǎo)出系統(tǒng)的前端頁(yè)面不算花哨但功能完整。SSM版本使用JSP或者Thymeleaf模板繪制頁(yè)面Django版本使用Django模板。這里我給一個(gè)簡(jiǎn)化的課表渲染思路。在視圖中準(zhǔn)備一個(gè)5列周一到周五、多個(gè)時(shí)間段比如上午兩節(jié)、下午兩節(jié)、晚上一節(jié)的二維數(shù)組初始值為空字符串遍歷排課記錄根據(jù)dayOfWeek和timeSlotId放到數(shù)組對(duì)應(yīng)位置然后把數(shù)組傳到模板。模板側(cè)用雙層循環(huán)輸出一個(gè)簡(jiǎn)單的HTML表格即可。以下是一個(gè)類似邏輯的Python視圖示例def student_schedule(request): student_class request.user.student.class_id week int(request.GET.get(week, 1)) schedule_rows [] for time_slot in time_slots: row [] for day in range(1, 6): schedules CourseSchedule.objects.filter( class_idstudent_class, day_of_weekday, time_slottime_slot, statusapproved ) row.append(schedules.first()) schedule_rows.append({slot: time_slot, courses: row}) return render(request, schedule.html, {schedule_rows: schedule_rows})如果你需要把課表導(dǎo)出為Excel可以用Java的POI工具或者Python的openpyxl庫(kù)。這是一個(gè)加分項(xiàng)很多實(shí)驗(yàn)室的老師都希望拿到Excel文件存檔。在導(dǎo)出的過程中要特別注意表頭的合并單元格處理不要直接堆數(shù)據(jù)。我在一個(gè)實(shí)際項(xiàng)目中導(dǎo)出課表時(shí)最開始導(dǎo)出的文件表頭是亂的后來用了POI的合并區(qū)域接口才解決。這種細(xì)節(jié)在講解項(xiàng)目中能成為你的加分亮點(diǎn)。4. 從源碼到運(yùn)行環(huán)境配置、調(diào)試與部署全流程拿到源碼之后最怕的就是跑不起來。項(xiàng)目附帶調(diào)試文檔但我還是建議你按照下邊的流程親手走一遍尤其是遇到“本地能跑、換機(jī)器就崩”這種情況往往就是環(huán)境配置問題。4.1 環(huán)境準(zhǔn)備JDK、Maven、MySQL還是Python、Django先說SSM版本的運(yùn)行環(huán)境。本機(jī)需要安裝JDK 8或以上版本、Maven 3.6、MySQL 5.7然后使用一個(gè)支持Tomcat 8.5以上的IDE比如Eclipse或IntelliJ IDEA。SSM項(xiàng)目通常以war包形式部署到Tomcat所以本地調(diào)試時(shí)要先把項(xiàng)目打成war包或者直接在IDE中配置Tomcat運(yùn)行。配置數(shù)據(jù)庫(kù)時(shí)新建一個(gè)數(shù)據(jù)庫(kù)導(dǎo)入項(xiàng)目自帶的init.sql文件它包含了建表語(yǔ)句和初始數(shù)據(jù)。接著修改jdbc.properties中的數(shù)據(jù)庫(kù)用戶名和密碼。這個(gè)文件是配置連接的重中之重好多同學(xué)報(bào)錯(cuò)“數(shù)據(jù)庫(kù)連接失敗”就是因?yàn)檫@里的密碼跟本地MySQL不一致。同時(shí)建議設(shè)置useSSLfalse和characterEncodingutf8避免SSL警告和中文亂碼。Django版本的環(huán)境準(zhǔn)備相對(duì)輕量。安裝Python 3.8在項(xiàng)目目錄下執(zhí)行pip install -r requirements.txt python manage.py makemigrations python manage.py migrate python manage.py createsuperuser python manage.py runserver中間有個(gè)容易踩的坑如果requirements.txt沒有生成或缺失你需要手工安裝Django、mysqlclient等庫(kù)。Django默認(rèn)使用SQLite數(shù)據(jù)庫(kù)如果希望切換到MySQL需要修改settings.py中的DATABASES配置并確保mysqlclient庫(kù)安裝成功。而在Windows上安裝mysqlclient有時(shí)會(huì)報(bào)缺少編譯環(huán)境的錯(cuò)建議直接使用pip install mysqlclient之前先安裝好對(duì)應(yīng)版本的MySQL Connector/C或者干脆繼續(xù)用SQLite簡(jiǎn)單省事。4.2 調(diào)試文檔里那些坑常見錯(cuò)誤和解決方法我復(fù)現(xiàn)項(xiàng)目時(shí)把調(diào)試文檔里的幾個(gè)經(jīng)典錯(cuò)誤都試了一遍這些坑非常具有代表性列成速查表錯(cuò)誤現(xiàn)象原因解決辦法啟動(dòng)時(shí)報(bào)404訪問路徑不對(duì)context root不一致檢查Tomcat部署路徑確保項(xiàng)目名匹配數(shù)據(jù)庫(kù)亂碼頁(yè)面編碼和MySQL連接編碼不統(tǒng)一連接URL加characterEncodingutf8頁(yè)面統(tǒng)一UTF-8保存排課失敗提示外鍵約束外鍵字段傳入了不存在的主鍵值查看前端提交的labId或teacherId是否來自有效下拉列表Django找不到模板文件templates目錄路徑或名稱不對(duì)確認(rèn)項(xiàng)目設(shè)置中的DIRS正確模板文件放在應(yīng)用名下課表空白無(wú)課程數(shù)據(jù)查當(dāng)前課時(shí)沒有匹配weeks條件確認(rèn)傳入的周次數(shù)字和weeks字符串的解析邏輯一致提交排課后沒有反應(yīng)表單提交的URL綁定錯(cuò)誤檢查路由映射和方法注解/類名管理員登錄后跳回登錄頁(yè)Session失效或攔截器放行規(guī)則錯(cuò)誤檢查攔截器excludePathPatterns注意靜態(tài)資源放行其中最容易被忽視的是排課界面“選擇周次”和后臺(tái)解析邏輯不一致。比如前端選了“2-8周”提交字符串是“2-8周”而后端解析函數(shù)只按逗號(hào)拆不支持-范圍就會(huì)導(dǎo)致周次判斷全錯(cuò)。我在這套項(xiàng)目里專門寫了支持范圍和單周的解析方法這點(diǎn)非常實(shí)用你在二次開發(fā)時(shí)一定要留意。4.3 打包部署到服務(wù)器從本地到演示環(huán)境如果最終需要部署到云服務(wù)器或者專門的演示環(huán)境SSM版本有兩種方案。一種是直接把war包部署到Tomcat的webapps目錄下另一種是使用Spring Boot風(fēng)格的內(nèi)嵌Tomcat啟動(dòng)。本系統(tǒng)是標(biāo)準(zhǔn)SSM所以走傳統(tǒng)war包部署路線。首先要保證服務(wù)器安裝了JDK和Tomcat然后把項(xiàng)目執(zhí)行mvn clean package后生成的.war文件放進(jìn)Tomcat的webapps目錄啟動(dòng)Tomcat后會(huì)自動(dòng)解壓。之后用服務(wù)器IP加端口加項(xiàng)目名就能訪問。Django版本的部署可以用Gunicorn加Nginx也可以直接用python manage.py runserver 0.0.0.0:8000后者適合演示但性能較弱。建議部署時(shí)關(guān)閉調(diào)試模式把settings.py里的DEBUGFalse并配置ALLOWED_HOSTS為服務(wù)器的IP或域名同時(shí)用collectstatic收集靜態(tài)文件否則頁(yè)面樣式會(huì)全部丟失。Nginx配置中要設(shè)置靜態(tài)文件路徑轉(zhuǎn)發(fā)/api或/到Gunicorn監(jiān)聽的socket。這部分內(nèi)容我建議初學(xué)者用最簡(jiǎn)單的方案先用runserver跑通再研究Nginx。部署完成后一定要做一次完整的功能走查包括登錄不同角色、提交預(yù)約、審批、查看課表、導(dǎo)出表格。我在多次演示項(xiàng)目時(shí)發(fā)現(xiàn)很多問題并不是代碼邏輯錯(cuò)而是靜態(tài)資源路徑問題。比如JSP頁(yè)面引用的CSS和JS路徑帶上了項(xiàng)目名服務(wù)器直接部署在根路徑就正常部署在子路徑就失效。解決方式是在頁(yè)面中動(dòng)態(tài)獲取項(xiàng)目根路徑SSM中可以用${pageContext.request.contextPath}Django中則用{% static %}標(biāo)簽。5. 配套文檔與講解方法如何把項(xiàng)目做成自己的源碼能跑只是第一步真正要讓項(xiàng)目出彩還得學(xué)會(huì)使用配套的LW和調(diào)試文檔以及掌握一套有效的講解方法。5.1 源碼結(jié)構(gòu)與其對(duì)應(yīng)的“LW”怎么讀這里說的“LW”其實(shí)指的是畢業(yè)設(shè)計(jì)或課程設(shè)計(jì)對(duì)應(yīng)的論文/說明文檔。很多同學(xué)拿到項(xiàng)目之后只關(guān)注代碼能否運(yùn)行把文檔丟在一旁這是非?？上У?。論文結(jié)構(gòu)一般就是緒論、需求分析、系統(tǒng)設(shè)計(jì)、系統(tǒng)實(shí)現(xiàn)、系統(tǒng)測(cè)試、總結(jié)。這套項(xiàng)目里的文檔是配合源碼逐章寫的所以讀源碼時(shí)最好對(duì)照文檔章節(jié)來。文檔中最有價(jià)值的部分是需求分析和數(shù)據(jù)庫(kù)設(shè)計(jì)。需求分析章節(jié)會(huì)畫出用例圖和流程圖數(shù)據(jù)庫(kù)設(shè)計(jì)章節(jié)會(huì)給出E-R圖和表結(jié)構(gòu)說明。我在復(fù)現(xiàn)項(xiàng)目時(shí)就是先讀這些內(nèi)容再轉(zhuǎn)過頭看代碼。你會(huì)發(fā)現(xiàn)代碼里的每個(gè)Service方法都能在文檔里找到對(duì)應(yīng)的用例描述數(shù)據(jù)表之間的關(guān)系也能在E-R圖里邊一眼看明白。這種做法還有一個(gè)好處答辯時(shí)老師問“你這個(gè)表為什么這么設(shè)計(jì)”你可以直接引用文檔里的分析而不是臨場(chǎng)瞎編。如果你拿到的文檔是PDF或Word建議把它結(jié)構(gòu)化摘要成你自己的思維導(dǎo)圖。重點(diǎn)提煉出三個(gè)角色、七張表、一條主流程。有了這個(gè)思維導(dǎo)圖即使代碼忘得差不多了你也能在講解時(shí)保持邏輯清晰。5.2 給畢業(yè)設(shè)計(jì)答辯或項(xiàng)目匯報(bào)準(zhǔn)備的講解重點(diǎn)答辯時(shí)間通常只有五到八分鐘最忌諱照本宣科。我建議你按照以下順序組織講解第一用一句話概括你做了什么。比如“我開發(fā)了一個(gè)實(shí)驗(yàn)室排課系統(tǒng)它針對(duì)實(shí)驗(yàn)教學(xué)管理中教室資源沖突問題實(shí)現(xiàn)了在線申請(qǐng)、審批、排課和課表查詢功能?！钡诙v背景和痛點(diǎn)。說明傳統(tǒng)Excel排課的混亂之處引出系統(tǒng)解決的核心矛盾也就是時(shí)間、空間、人員三者匹配。第三講技術(shù)選型。說明你用的框架、數(shù)據(jù)庫(kù)和部署方式。如果你做的SSM版本可以強(qiáng)調(diào)MyBatis對(duì)復(fù)雜SQL的支持如果你做的Django版本可以強(qiáng)調(diào)ORM和Admin后臺(tái)帶來的開發(fā)效率。第四展示核心亮點(diǎn)。把沖突檢測(cè)算法和權(quán)限控制當(dāng)作亮點(diǎn)講順手展示一下事務(wù)注解。這是展示你代碼素養(yǎng)的最好時(shí)機(jī)。第五演示關(guān)鍵頁(yè)面。不要每個(gè)頁(yè)面都點(diǎn)一遍只需要走“教師提交排課申請(qǐng)-管理員審批-課表生成”這條主鏈路其他功能簡(jiǎn)單帶過。最后講測(cè)試數(shù)據(jù)和運(yùn)行效果。你準(zhǔn)備一兩組典型數(shù)據(jù)比如不同周次的排課記錄現(xiàn)場(chǎng)驗(yàn)證沖突提示效果會(huì)比空口白話好很多。5.3 二次開發(fā)思路從排課系統(tǒng)到實(shí)驗(yàn)室開放預(yù)約平臺(tái)如果你想讓這個(gè)項(xiàng)目顯得更有深度可以在此基礎(chǔ)上做一些二次開發(fā)擴(kuò)展。這里分享幾個(gè)低成本高回報(bào)的方向。一是增加實(shí)驗(yàn)課程庫(kù)維護(hù)。將課程表擴(kuò)展為“課程模板”包含實(shí)驗(yàn)項(xiàng)目名稱、所需時(shí)長(zhǎng)、所需設(shè)備類型。教師排課時(shí)只需選擇課程模板系統(tǒng)自動(dòng)匹配符合設(shè)備要求的實(shí)驗(yàn)室簡(jiǎn)化操作。二是增加智能推薦排課。根據(jù)教室容量、設(shè)備類型、教師空閑時(shí)間和班級(jí)課程偏好自動(dòng)推薦最優(yōu)時(shí)間片。這項(xiàng)功能可以用貪心算法或簡(jiǎn)單的打分規(guī)則實(shí)現(xiàn)并不需要機(jī)器學(xué)習(xí)。三是增加調(diào)課審批流程。教師發(fā)起調(diào)課后系統(tǒng)先釋放原時(shí)間片再對(duì)目標(biāo)時(shí)間片做占位鎖定管理員審批通過后更新排課記錄。這個(gè)操作涉及狀態(tài)流轉(zhuǎn)和時(shí)間片加鎖能再次體現(xiàn)你對(duì)并發(fā)控制的理解。四是增加可視化統(tǒng)計(jì)。統(tǒng)計(jì)每個(gè)實(shí)驗(yàn)室的使用率、每個(gè)教師的上課頻次、每門課程的總學(xué)時(shí)用ECharts畫出柱狀圖和餅圖。這些圖表放在論文的測(cè)試分析部分非常出彩也能提升項(xiàng)目的商業(yè)感。我在實(shí)際使用這套系統(tǒng)做二次開發(fā)練習(xí)時(shí)優(yōu)先實(shí)現(xiàn)了“根據(jù)實(shí)驗(yàn)室類型自動(dòng)過濾可選時(shí)間片”這一項(xiàng)。做法很簡(jiǎn)單在教師選擇實(shí)驗(yàn)室時(shí)先根據(jù)課程類型篩選實(shí)驗(yàn)室列表例如計(jì)算機(jī)類課程只能選擇computer類型實(shí)驗(yàn)室。這個(gè)改動(dòng)看起來很小卻讓演示流程順暢很多因?yàn)榇疝q老師很少會(huì)愿意看著你從一個(gè)全部實(shí)驗(yàn)室列表里慢慢翻找合適的教室。一些寫在最后的個(gè)人體會(huì)反復(fù)折騰這套實(shí)驗(yàn)室排課項(xiàng)目之后我最大的感受是信息管理系統(tǒng)的核心從來不是炫酷的界面而是對(duì)業(yè)務(wù)規(guī)則的理解和嚴(yán)謹(jǐn)?shù)臄?shù)據(jù)組織。實(shí)驗(yàn)室排課看似是一個(gè)小題目但它包含了角色權(quán)限、沖突檢測(cè)、事務(wù)處理、數(shù)據(jù)可視化等幾乎所有的后端基本功。不管是基于Java的SSM版本還是基于Python的Django版本只要把業(yè)務(wù)邏輯吃透換一個(gè)場(chǎng)景比如機(jī)房預(yù)約、會(huì)議室預(yù)訂、實(shí)訓(xùn)室管理都只是變一變表和字段的事。如果你正在做課設(shè)或者剛?cè)肼殘?chǎng)的項(xiàng)目積累這套系統(tǒng)的源碼和文檔確實(shí)值得靜下心來讀一遍。最后再說一個(gè)實(shí)用技巧做排課系統(tǒng)時(shí)一定要準(zhǔn)備充分的測(cè)試數(shù)據(jù)不要只造兩三條記錄就完事。我會(huì)生成一個(gè)學(xué)期的真實(shí)感數(shù)據(jù)比如五個(gè)實(shí)驗(yàn)室、十個(gè)班級(jí)、二十門課、每周排滿時(shí)間段然后用這些數(shù)據(jù)去跑沖突檢測(cè)和課表生成。數(shù)據(jù)量一上來頁(yè)面加載速度、SQL查詢效率、是否存在N1問題都會(huì)暴露出來。同樣一個(gè)排課系統(tǒng)有沒有真實(shí)數(shù)據(jù)支撐演示效果天差地別。這一條經(jīng)驗(yàn)適用于所有管理系統(tǒng)項(xiàng)目希望你能少走我之前走過的彎路。