簡(jiǎn)介這是一份基于Springboot與Vue開(kāi)發(fā)的學(xué)生心理咨詢?cè)u(píng)估系統(tǒng)面向Java畢業(yè)設(shè)計(jì)、課程設(shè)計(jì)與期末大作業(yè)人群核心涵蓋心理測(cè)評(píng)、咨詢記錄、評(píng)估結(jié)果管理等模塊。源碼已本地編譯并驗(yàn)證可運(yùn)行評(píng)審分達(dá)98分難度適中適合需要完整可演示項(xiàng)目參考的在校生。壓縮包為zip格式共444個(gè)文件大小約9.96MB。主要組成包括Java后端源碼、Vue前端頁(yè)面、SQL數(shù)據(jù)庫(kù)腳本、class編譯文件、XML/yml配置以及論文文檔此外還提供啟動(dòng)與打包批處理工具便于導(dǎo)入開(kāi)發(fā)工具后快速部署。目前已有139人學(xué)習(xí)下載。下載后可直接運(yùn)行前后端對(duì)照數(shù)據(jù)庫(kù)腳本、論文與項(xiàng)目結(jié)構(gòu)理解完整開(kāi)發(fā)流程從前端路由、后臺(tái)接口到心理咨詢業(yè)務(wù)建模均有對(duì)應(yīng)實(shí)現(xiàn)適合學(xué)習(xí)SpringbootVue整合開(kāi)發(fā)也為畢業(yè)設(shè)計(jì)答辯提供扎實(shí)素材。1. 學(xué)生心理咨詢?cè)u(píng)估系統(tǒng)的業(yè)務(wù)邊界與設(shè)計(jì)重心“學(xué)生心理咨詢?cè)u(píng)估系統(tǒng)”這個(gè)題目真正的技術(shù)難點(diǎn)不在咨詢預(yù)約流程也不在后臺(tái) CRUD而在“評(píng)估”兩個(gè)字上。評(píng)估意味著數(shù)據(jù)采集、量表計(jì)分、維度匯總和結(jié)果分檔這些邏輯要落到數(shù)據(jù)庫(kù)表設(shè)計(jì)和后端算法里前端則要解決動(dòng)態(tài)問(wèn)卷渲染和結(jié)果可視化的問(wèn)題。一個(gè)具備實(shí)際參考價(jià)值的畢業(yè)設(shè)計(jì)至少要打通“學(xué)生填寫(xiě)量表 → 系統(tǒng)自動(dòng)計(jì)分 → 心理咨詢師查看評(píng)估結(jié)果 → 生成咨詢記錄”這條完整鏈路。這個(gè)系統(tǒng)適合兩類(lèi)人來(lái)參考一類(lèi)是正在選畢業(yè)設(shè)計(jì)題目、需要快速理解前后端分離項(xiàng)目骨架的在校生另一類(lèi)是剛接觸企業(yè)級(jí) Java 開(kāi)發(fā)、想知道 Spring Boot 加 Vue 怎么把業(yè)務(wù)狀態(tài)管理做扎實(shí)的初級(jí)工程師。下文按工程落地順序展開(kāi)先立數(shù)據(jù)模型再寫(xiě)后端接口接著做前端頁(yè)面最后講評(píng)估算法和聯(lián)調(diào)手段整套方案可以直接作為項(xiàng)目初稿。2. Spring Boot 后端評(píng)估模塊的數(shù)據(jù)建模與核心接口2.1 數(shù)據(jù)表設(shè)計(jì)評(píng)估量表、評(píng)估記錄與結(jié)果表心理評(píng)估系統(tǒng)最核心的表不是學(xué)生表也不是咨詢記錄表而是“量表題目表”和“評(píng)估記錄表”。如果只做一張 student 表加一張 record 表評(píng)估結(jié)果就只能存一個(gè)總分后續(xù)做維度分析時(shí)必然要重構(gòu)數(shù)據(jù)庫(kù)。常見(jiàn)的表結(jié)構(gòu)設(shè)計(jì)如下表名用途關(guān)鍵字段student學(xué)生基本信息id, student_no, name, gender, grade, class_nameassessment_scale量表定義id, scale_name, description, dimension_count, statusassessment_question量表題目id, scale_id, dimension, question_text, question_type, sort_orderassessment_record評(píng)估記錄id, student_id, scale_id, status, total_score, create_time, finish_timeassessment_answer答題明細(xì)id, record_id, question_id, option_value, scoreassessment_result評(píng)估結(jié)果id, record_id, level, summary, suggest_text, counselor_idcounseling_record咨詢記錄id, student_id, assess_record_id, counselor_name, content, create_time這七張表里assessment_answer 是明細(xì)表存的是每道題的得分assessment_result 是結(jié)果表存評(píng)估分檔結(jié)論。分表拆開(kāi)的好處是后期可以按維度情緒狀態(tài)、人際關(guān)系、學(xué)業(yè)壓力等做聚合查詢而不只是看一個(gè)總分。2.1.1 建表語(yǔ)句的注意點(diǎn)注意評(píng)估記錄里不要用 student_id 做唯一約束因?yàn)橐粋€(gè)學(xué)生可以多次評(píng)估目的是跟蹤心理狀態(tài)變化趨勢(shì)。用(student_id, scale_id, status)加普通索引更合適查詢某學(xué)生最近一次評(píng)估記錄時(shí)走索引效率更高。2.2 核心接口的 RESTful 設(shè)計(jì)與代碼實(shí)現(xiàn)后端接口按照資源維度劃分端口統(tǒng)一前綴/api這是 Spring Boot 項(xiàng)目的常見(jiàn)約定。核心接口有這些POST /api/student // 新增學(xué)生 GET /api/student/{id} // 查詢學(xué)生信息 POST /api/assessment // 創(chuàng)建評(píng)估記錄 GET /api/assessment/{id} // 查詢?cè)u(píng)估詳情含題目 POST /api/assessment/submit // 提交評(píng)估答案 GET /api/assessment/result/{recordId} // 查看評(píng)估結(jié)果 POST /api/counseling // 創(chuàng)建咨詢記錄Controller 層用 Spring Boot 標(biāo)準(zhǔn)注解實(shí)現(xiàn)核心提交接口大致長(zhǎng)這樣RestController RequestMapping(/api/assessment) public class AssessmentController { Resource private AssessmentService assessmentService; PostMapping(/submit) public Result submit(RequestBody AssessmentSubmitDTO dto) { // 防止重復(fù)提交同一記錄只能提交一次 AssessmentRecord record assessmentService.getById(dto.getRecordId()); if (record null || !PENDING.equals(record.getStatus())) { return Result.error(記錄不存在或已提交); } // 計(jì)算維度分和總分 AssessmentResult result assessmentService.calculateScore(dto); return Result.success(result); } }邏輯說(shuō)明提交接口做了狀態(tài)校驗(yàn)只有 PENDING 狀態(tài)的記錄才能提交。calculateScore 方法內(nèi)部完成逐題得分累加、維度得分計(jì)算和分檔判斷事務(wù)由 Spring 統(tǒng)一管理確保答案表和結(jié)果表要么同時(shí)寫(xiě)入、要么同時(shí)回滾。2.2.1 跨域配置不能忘前后端分離項(xiàng)目聯(lián)調(diào)時(shí)最先遇到的就是跨域問(wèn)題常見(jiàn)做法是寫(xiě)一個(gè) WebMvcConfigurer 配置類(lèi)Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/api/**) .allowedOrigins(http://localhost:5173) .allowedMethods(GET, POST, PUT, DELETE) .allowCredentials(true) .maxAge(3600); } }參數(shù)說(shuō)明allowedOrigins 指向 Vue 開(kāi)發(fā)服務(wù)器的地址Vite 默認(rèn)端口是 5173allowCredentials(true) 表示允許攜帶 Cookie但此時(shí) allowedOrigins 不能寫(xiě)成*必須寫(xiě)具體地址這是常見(jiàn)的配置陷阱。2.3 關(guān)鍵參數(shù)配置事務(wù)、分頁(yè)與 Jackson 序列化Spring Boot 的配置集中在application.yml里幾個(gè)必調(diào)的參數(shù)spring: datasource: url: jdbc:mysql://localhost:3306/psych_assessment username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver jpa: hibernate: ddl-auto: update show-sql: true jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 server: port: 8080注意ddl-auto: update只適合開(kāi)發(fā)階段實(shí)體類(lèi)改了字段后表結(jié)構(gòu)會(huì)自動(dòng)同步但生產(chǎn)環(huán)境建議改成validate或直接用 Flyway 管理。show-sql 開(kāi)啟后可以在控制臺(tái)看到 Hibernate 生成的 SQL排查關(guān)聯(lián)查詢問(wèn)題時(shí)非常有幫助。3. Vue 前端心理咨詢頁(yè)面的組件拆分與路由配置3.1 前端路由與頁(yè)面結(jié)構(gòu)設(shè)計(jì)Vue 3 搭配 Vue Router 4 是當(dāng)前主流方案。頁(yè)面結(jié)構(gòu)按角色分成三類(lèi)學(xué)生端、咨詢師端、管理員端。路由配置放在router/index.js中const routes [ { path: /, component: Layout, redirect: /dashboard, children: [ { path: assessment, component: () import(/views/assessment/AssessmentList.vue), meta: { roles: [STUDENT] } }, { path: assessment/do/:recordId, component: () import(/views/assessment/DoAssessment.vue), meta: { roles: [STUDENT] } }, { path: counseling/records, component: () import(/views/counseling/RecordList.vue), meta: { roles: [COUNSELOR] } } ] } ] router.beforeEach((to, from, next) { const token localStorage.getItem(token) if (!token to.path ! /login) { next(/login) } else { next() } })路由守衛(wèi)邏輯說(shuō)明判斷本地是否存在 token 決定是否放行后面可以擴(kuò)展為從后端獲取用戶角色再和meta.roles做權(quán)限匹配。實(shí)際項(xiàng)目中角色一般存 Vuex 或 Pinia這里用 localStorage 做簡(jiǎn)化處理。3.2 動(dòng)態(tài)問(wèn)卷組件讓題目從數(shù)據(jù)庫(kù)渲染到頁(yè)面量表題目數(shù)量不是固定的因?yàn)椴煌牧勘眍}數(shù)不同所以前端不能寫(xiě)死表單要做一個(gè)動(dòng)態(tài)渲染組件。數(shù)據(jù)結(jié)構(gòu)上后端返回[{questionId, text, dimension, options: [{value, score}]}]前端用v-for遍歷渲染template div v-for(q, index) in questions :keyq.id classquestion-item div classquestion-title{{ index 1 }}. {{ q.text }}/div el-radio-group v-modelanswers[q.id] el-radio v-foropt in q.options :keyopt.value :labelopt.value {{ opt.label }} /el-radio /el-radio-group /div /template script setup import { ref } from vue const props defineProps({ questions: { type: Array, required: true } }) const answers ref({}) const emit defineEmits([submit]) function handleSubmit() { const answerList Object.keys(answers.value).map(questionId ({ questionId: Number(questionId), value: answers.value[questionId] })) emit(submit, answerList) } /script關(guān)鍵點(diǎn)說(shuō)明answers 用對(duì)象形式存儲(chǔ)key 是題目 ID提交時(shí)再轉(zhuǎn)換成后端要求的數(shù)組格式。這樣做的優(yōu)勢(shì)在于單選與多選都通用——多選時(shí) value 存數(shù)組即可。如果遇到量表題帶反向計(jì)分例如“我經(jīng)常感到煩躁”這類(lèi)負(fù)向表述評(píng)分邏輯在后端做前端只需要傳選項(xiàng)值。3.3 環(huán)境配置與 API 封裝Vite 代理解決聯(lián)調(diào)問(wèn)題開(kāi)發(fā)環(huán)境下前后端端口不同直接請(qǐng)求會(huì)產(chǎn)生跨域。常見(jiàn)做法是利用 Vite 的 proxy 配置代替后端 CORS// vite.config.js export default defineConfig({ plugins: [vue()], server: { port: 5173, proxy: { /api: { target: http://localhost:8080, changeOrigin: true } } } })配置后前端請(qǐng)求/api/assessment時(shí)Vite 開(kāi)發(fā)服務(wù)器會(huì)把請(qǐng)求轉(zhuǎn)發(fā)到后端的 8080 端口。瀏覽器里看到的還是同源請(qǐng)求跨域自然消失。api 封裝層用 axios 實(shí)例統(tǒng)一配置攔截器// src/api/request.js import axios from axios import { ElMessage } from element-plus const request axios.create({ baseURL: /api, timeout: 15000 }) request.interceptors.response.use( response response.data, error { ElMessage.error(error.response?.data?.message || 請(qǐng)求異常) return Promise.reject(error) } )響應(yīng)攔截器統(tǒng)一處理錯(cuò)誤提示業(yè)務(wù)代碼里不用每個(gè)請(qǐng)求都寫(xiě) catch這是 Vue 項(xiàng)目里最常見(jiàn)的落地寫(xiě)法。4. 評(píng)估結(jié)果的計(jì)算邏輯與關(guān)鍵參數(shù)設(shè)定4.1 維度得分與總分計(jì)算算法代碼示例評(píng)估算法是系統(tǒng)最容易被評(píng)審老師提問(wèn)的地方。以“90項(xiàng)癥狀清單SCL-90”為例它包含軀體化、強(qiáng)迫癥狀、人際關(guān)系敏感、抑郁、焦慮等 9 個(gè)維度。維度分 該維度所有題目得分之和 / 題目數(shù)量總分 所有題目得分之和。public AssessmentResult calculateScore(AssessmentSubmitDTO dto) { ListAssessmentAnswer answers dto.getAnswers(); ListAssessmentQuestion questions questionMapper.selectByScaleId(dto.getScaleId()); // 按維度分組 MapString, ListInteger dimensionScoreMap new HashMap(); for (AssessmentAnswer answer : answers) { AssessmentQuestion q questionMap.get(answer.getQuestionId()); dimensionScoreMap.computeIfAbsent(q.getDimension(), k - new ArrayList()) .add(answer.getScore()); } // 計(jì)算維度分和總分 MapString, Double dimAvg new HashMap(); double total 0; for (Map.EntryString, ListInteger entry : dimensionScoreMap.entrySet()) { double avg entry.getValue().stream() .mapToInt(Integer::intValue) .average().orElse(0); dimAvg.put(entry.getKey(), round(avg, 2)); total entry.getValue().stream().mapToInt(Integer::intValue).sum(); } // 分檔判斷以SCL-90常用閾值為參考 String level; if (total 160) { level NORMAL; } else if (total 200) { level MILD; } else if (total 250) { level MODERATE; } else { level SEVERE; } return buildResult(dto.getRecordId(), total, dimAvg, level); }實(shí)現(xiàn)說(shuō)明先把題目信息轉(zhuǎn)成 Map 結(jié)構(gòu)避免循環(huán)查庫(kù)然后遍歷答題明細(xì)按 dimension 字段分組最后用 stream 計(jì)算平均分并保留兩位小數(shù)。分檔閾值是業(yè)務(wù)參數(shù)最好從配置表讀取而不是硬編碼在代碼里——論文里可以寫(xiě)“閾值可配置”這是一個(gè)加分項(xiàng)。4.2 等級(jí)分檔的閾值設(shè)定與可視化分檔結(jié)果用雷達(dá)圖展示是最直觀的。ECharts 的 radar 配置項(xiàng)非常適合做多維評(píng)估可視化const option { radar: { indicator: [ { name: 軀體化, max: 4 }, { name: 強(qiáng)迫癥狀, max: 4 }, { name: 人際關(guān)系敏感, max: 4 }, { name: 抑郁, max: 4 }, { name: 焦慮, max: 4 } ], radius: 65% }, series: [{ type: radar, data: [{ value: dimensionScores, name: 當(dāng)前學(xué)生, areaStyle: { opacity: 0.2 } }] }] }圖表背后的產(chǎn)品邏輯是總分相同的兩個(gè)學(xué)生維度分布完全不同一個(gè)可能抑郁維度特別突出另一個(gè)是焦慮維度突出。雷達(dá)圖讓咨詢師一眼看出問(wèn)題集中區(qū)域這比單純看數(shù)字有說(shuō)服力得多。后端返回結(jié)果時(shí)要同時(shí)輸出維度和分?jǐn)?shù)前端直接交給 ECharts。4.3 隱私與權(quán)限邊界不同角色能看什么心理咨詢系統(tǒng)的數(shù)據(jù)非常敏感權(quán)限設(shè)計(jì)不能只做頁(yè)面隱藏后端接口也要做數(shù)據(jù)隔離。一個(gè)簡(jiǎn)單可行的方案是在 Service 層方法中校驗(yàn)當(dāng)前登錄用戶的信息可見(jiàn)權(quán)。Override public AssessmentResultVO getResult(Long recordId, Long currentUserId) { AssessmentRecord record assessmentRecordMapper.selectById(recordId); if (record null) { throw new BizException(記錄不存在); } // 學(xué)生只能看自己的報(bào)告 boolean isStudent currentUser.getRole().equals(STUDENT); if (isStudent !record.getStudentId().equals(currentUserId)) { throw new BizException(無(wú)權(quán)查看他人評(píng)估報(bào)告); } // 咨詢師可以看分配給自己的學(xué)生 return buildVO(record); }這里有一個(gè)論文中值得展開(kāi)的細(xì)節(jié)心理咨詢系統(tǒng)中學(xué)生不應(yīng)看到原始答案只應(yīng)看到總分和文字建議咨詢師能看到維度分管理員只能看統(tǒng)計(jì)報(bào)表不能看具體題目答案。用三行代碼加注釋就能說(shuō)清為什么這也是項(xiàng)目與普通 CRUD 拉開(kāi)差距的價(jià)值點(diǎn)。5. 從評(píng)估表到咨詢記錄狀態(tài)流轉(zhuǎn)校驗(yàn)與聯(lián)調(diào)手段5.1 評(píng)估狀態(tài)機(jī)PENDING、FINISHED、CONSULTED、ARCHIVED評(píng)估記錄不是提交完就結(jié)束了后續(xù)還會(huì)跟咨詢行為關(guān)聯(lián)。狀態(tài)機(jī)的設(shè)計(jì)如下?tīng)顟B(tài)觸發(fā)動(dòng)作說(shuō)明PENDING創(chuàng)建記錄學(xué)生開(kāi)始答題但未提交FINISHED提交答案并計(jì)算完成評(píng)估結(jié)果已生成CONSULTED咨詢師創(chuàng)建咨詢記錄已安排咨詢ARCHIVED管理員歸檔本學(xué)期數(shù)據(jù)封存狀態(tài)只能向前流轉(zhuǎn)不能回退。后端用枚舉類(lèi)定義狀態(tài)Service 層校驗(yàn)流轉(zhuǎn)合法性public enum AssessStatus { PENDING, FINISHED, CONSULTED, ARCHIVED; public boolean canTransitTo(AssessStatus target) { return switch (this) { case PENDING - target FINISHED; case FINISHED - target CONSULTED; case CONSULTED - target ARCHIVED; case ARCHIVED - false; }; } }使用 Java 17 的 switch 表達(dá)式邏輯緊湊。畢業(yè)設(shè)計(jì)論文里畫(huà)一張狀態(tài)圖再配合這段代碼評(píng)審老師基本不會(huì)追著問(wèn)“業(yè)務(wù)完整性”的問(wèn)題。5.2 提交接口的冪等性校驗(yàn)學(xué)生在答題頁(yè)面停留時(shí)間過(guò)長(zhǎng)提交時(shí)可能重復(fù)點(diǎn)擊或者網(wǎng)絡(luò)重試導(dǎo)致同一份答案提交兩次。實(shí)現(xiàn)冪等的最簡(jiǎn)單方案是在提交接口里檢查記錄狀態(tài)PENDING 才放行。上文 Controller 里已經(jīng)寫(xiě)了這個(gè)檢查但更嚴(yán)謹(jǐn)?shù)淖龇ㄊ墙o assessment_record 表加一張 answer_snapshot 字段提交時(shí)把整個(gè)答題 JSON 存進(jìn)去二次提交直接返回第一次的結(jié)果。ALTER TABLE assessment_record ADD COLUMN answer_snapshot JSON NULL COMMENT 答題快照防止重復(fù)提交;MySQL 5.7 以上支持 JSON 字段類(lèi)型配合JSON_CONTAINS可以做簡(jiǎn)單的內(nèi)容級(jí)校驗(yàn)但常規(guī)場(chǎng)景只要判斷狀態(tài)即可JSON 快照用于審計(jì)和數(shù)據(jù)追溯不參與業(yè)務(wù)校驗(yàn)。5.3 聯(lián)調(diào)驗(yàn)證的三個(gè)快捷手段第一次跑通全流程建議按下面三步走# 第一步啟動(dòng)后端確認(rèn) 8080 端口可用 mvn spring-boot:run # 第二步啟動(dòng)前端 Vite 開(kāi)發(fā)服務(wù)器 npm run dev # 第三步用 curl 驗(yàn)證后端接口 curl -X POST http://localhost:8080/api/student \ -H Content-Type: application/json \ -d {name:張三,studentNo:2024001,gender:MALE}聯(lián)調(diào)時(shí)最影響效率的是時(shí)區(qū)問(wèn)題和 JSON 序列化問(wèn)題。時(shí)區(qū)問(wèn)題表現(xiàn)為數(shù)據(jù)庫(kù)時(shí)間比北京時(shí)間早 8 小時(shí)處理方式是 JDBC 連接串加serverTimezoneAsia/Shanghai同時(shí) application.yml 里配置time-zone: GMT8。JSON 序列化問(wèn)題常見(jiàn)于 LocalDateTime 類(lèi)型返回給前端時(shí)變成數(shù)組處理方案是在實(shí)體字段上加JsonFormat(pattern yyyy-MM-dd HH:mm:ss)或全局配置 Jackson 的 JavaTimeModule。驗(yàn)證階段推薦開(kāi)一個(gè)瀏覽器頁(yè)面直接看 Network 面板關(guān)注三個(gè)關(guān)鍵指標(biāo)請(qǐng)求 URL、響應(yīng)狀態(tài)碼、響應(yīng)體結(jié)構(gòu)。前端報(bào) 400 說(shuō)明參數(shù)格式不對(duì)報(bào) 500 說(shuō)明后端業(yè)務(wù)異常報(bào) 401 說(shuō)明 token 失效。用 Vue 調(diào)試時(shí)可以在攔截器里加一行console.log(config.url)把每個(gè)請(qǐng)求的地址和參數(shù)打出來(lái)快速定位請(qǐng)求是否發(fā)到了正確的位置。本文還有配套的精品資源點(diǎn)擊獲取