1. 項(xiàng)目概述學(xué)校設(shè)備報(bào)修系統(tǒng)是校園信息化建設(shè)中的重要一環(huán)。傳統(tǒng)的紙質(zhì)報(bào)修流程存在效率低下、進(jìn)度不透明、統(tǒng)計(jì)困難等問(wèn)題?；赟pringBoot和微信小程序的報(bào)修系統(tǒng)能夠?qū)崿F(xiàn)以下核心價(jià)值師生可隨時(shí)隨地進(jìn)行設(shè)備報(bào)修維修人員能實(shí)時(shí)接收工單通知管理人員可監(jiān)控維修進(jìn)度和統(tǒng)計(jì)分析實(shí)現(xiàn)報(bào)修流程的數(shù)字化和可視化這個(gè)畢業(yè)設(shè)計(jì)項(xiàng)目采用前后端分離架構(gòu)前端微信小程序使用uni-app框架開發(fā)后端SpringBoot 2.7 MySQL 8.0接口RESTful API設(shè)計(jì)2. 技術(shù)選型解析2.1 后端技術(shù)棧選擇SpringBoot作為后端框架主要基于以下考慮快速開發(fā)自動(dòng)配置、起步依賴簡(jiǎn)化了SSM框架的整合生態(tài)豐富Spring生態(tài)有完善的解決方案易于部署內(nèi)嵌Tomcat打包即運(yùn)行適合教學(xué)社區(qū)資源豐富便于學(xué)生理解關(guān)鍵依賴dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version2.2.2/version /dependency2.2 前端技術(shù)方案采用uni-app開發(fā)微信小程序的優(yōu)勢(shì)跨平臺(tái)一套代碼可編譯到多個(gè)平臺(tái)開發(fā)效率基于Vue語(yǔ)法學(xué)習(xí)成本低組件豐富uni-ui提供大量現(xiàn)成組件調(diào)試方便HBuilderX提供完善工具鏈小程序頁(yè)面結(jié)構(gòu)示例pages/ index/ // 首頁(yè) repair/ // 報(bào)修頁(yè) my/ // 個(gè)人中心 components/ // 公共組件3. 數(shù)據(jù)庫(kù)設(shè)計(jì)3.1 核心表結(jié)構(gòu)用戶表(user)CREATE TABLE user ( id int NOT NULL AUTO_INCREMENT, openid varchar(50) DEFAULT NULL COMMENT 微信openid, username varchar(20) DEFAULT NULL, role tinyint DEFAULT 0 COMMENT 0-學(xué)生 1-維修員 2-管理員, phone varchar(11) DEFAULT NULL, PRIMARY KEY (id), UNIQUE KEY idx_openid (openid) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;報(bào)修單表(repair_order)CREATE TABLE repair_order ( id int NOT NULL AUTO_INCREMENT, user_id int DEFAULT NULL, device_type varchar(20) DEFAULT NULL COMMENT 設(shè)備類型, location varchar(50) DEFAULT NULL COMMENT 故障地點(diǎn), description text COMMENT 故障描述, images varchar(255) DEFAULT NULL COMMENT 圖片URL多個(gè)用逗號(hào)分隔, status tinyint DEFAULT 0 COMMENT 0-待處理 1-已接單 2-已完成 3-已評(píng)價(jià), create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;3.2 索引優(yōu)化為提高查詢效率需要建立以下索引報(bào)修單狀態(tài)索引ALTER TABLE repair_order ADD INDEX idx_status (status);用戶報(bào)修記錄索引ALTER TABLE repair_order ADD INDEX idx_user (user_id);4. 核心功能實(shí)現(xiàn)4.1 微信登錄流程前端獲取codeuni.login({ provider: weixin, success: function (res) { console.log(res.code); } });后端處理登錄PostMapping(/login) public Result login(String code) { // 1. 使用code獲取openid String openid wechatService.getOpenid(code); // 2. 查詢或創(chuàng)建用戶 User user userService.findOrCreate(openid); // 3. 生成JWT token String token JwtUtil.generate(user.getId()); return Result.success(token); }4.2 報(bào)工單提交前端表單關(guān)鍵代碼template view uni-forms :modelform uni-forms-item label設(shè)備類型 namedeviceType uni-data-select v-modelform.deviceType :localdatadeviceTypes/ /uni-forms-item uni-forms-item label故障描述 namedescription textarea v-modelform.description/ /uni-forms-item uni-file-picker limit3 successuploadSuccess/ /uni-forms /view /template后端接口實(shí)現(xiàn)PostMapping(/repair) public Result submitRepair(RequestBody RepairDTO dto, RequestHeader(Authorization) String token) { // 1. 驗(yàn)證token Integer userId JwtUtil.verify(token); // 2. 構(gòu)建工單實(shí)體 RepairOrder order new RepairOrder(); order.setUserId(userId); order.setDeviceType(dto.getDeviceType()); order.setDescription(dto.getDescription()); order.setImages(String.join(,, dto.getImages())); // 3. 保存到數(shù)據(jù)庫(kù) repairService.save(order); // 4. 通知維修人員 notifyService.sendNewOrderNotice(order.getId()); return Result.success(); }5. 系統(tǒng)特色功能5.1 維修進(jìn)度推送采用微信訂閱消息實(shí)現(xiàn)狀態(tài)變更通知配置消息模板用戶提交報(bào)修時(shí)訂閱消息狀態(tài)變更時(shí)觸發(fā)推送后端推送實(shí)現(xiàn)public void sendStatusChangeNotice(Integer orderId) { RepairOrder order repairService.getById(orderId); String openid userService.getOpenid(order.getUserId()); WxMpTemplateMessage message WxMpTemplateMessage.builder() .toUser(openid) .templateId(TEMPLATE_ID) .data(Arrays.asList( new WxMpTemplateData(thing1, order.getDeviceType()), new WxMpTemplateData(phrase2, getStatusText(order.getStatus())), new WxMpTemplateData(date3, new SimpleDateFormat(yyyy-MM-dd HH:mm).format(new Date())) )) .build(); wxMpService.getTemplateMsgService().sendTemplateMsg(message); }5.2 數(shù)據(jù)統(tǒng)計(jì)看板管理員后臺(tái)使用ECharts實(shí)現(xiàn)數(shù)據(jù)可視化按設(shè)備類型統(tǒng)計(jì)故障分布按時(shí)間維度統(tǒng)計(jì)報(bào)修量維修員接單響應(yīng)時(shí)間分析關(guān)鍵SQL-- 按周統(tǒng)計(jì)報(bào)修量 SELECT DATE_FORMAT(create_time,%Y-%u) AS week, COUNT(*) AS count FROM repair_order GROUP BY week ORDER BY week;6. 部署方案6.1 后端部署推薦使用Docker部署SpringBoot應(yīng)用FROM openjdk:11-jre COPY target/repair-system.jar /app.jar EXPOSE 8080 ENTRYPOINT [java,-jar,/app.jar]啟動(dòng)命令docker build -t repair-system . docker run -d -p 8080:8080 --name repair repair-system6.2 小程序發(fā)布流程開發(fā)環(huán)境配置{ miniprogramRoot: ./unpackage/dist/dev/mp-weixin, appid: 你的小程序APPID, setting: { urlCheck: false } }生產(chǎn)環(huán)境構(gòu)建npm run build:mp-weixin通過(guò)微信開發(fā)者工具上傳代碼7. 常見問(wèn)題解決7.1 微信登錄失敗可能原因及解決方案AppID配置錯(cuò)誤檢查application.yml中的wechat配置確保小程序后臺(tái)配置的服務(wù)器域名正確code失效確保前端獲取code后立即調(diào)用后端接口code有效期5分鐘不可重復(fù)使用7.2 圖片上傳問(wèn)題典型錯(cuò)誤處理大小限制小程序端限制單張圖片不超過(guò)2M可使用uni.compressImage壓縮圖片格式問(wèn)題只允許jpg/png格式前端需做格式校驗(yàn)uni.chooseImage({ count: 3, sizeType: [compressed], sourceType: [album, camera], success: (res) { // 處理選中的圖片 } });8. 項(xiàng)目擴(kuò)展方向智能分配根據(jù)維修員位置和技能自動(dòng)分配工單知識(shí)庫(kù)建立常見故障解決方案庫(kù)評(píng)價(jià)系統(tǒng)增加維修服務(wù)評(píng)價(jià)機(jī)制數(shù)據(jù)大屏可視化展示全校設(shè)備運(yùn)行狀況實(shí)現(xiàn)自動(dòng)分配的邏輯示例public void autoAssignOrder(Integer orderId) { RepairOrder order getById(orderId); // 1. 獲取附近維修員 ListRepairman repairmen repairmanService.findNearby( order.getLocation(), 1000); // 1公里范圍內(nèi) // 2. 篩選有相關(guān)技能的維修員 repairmen repairmen.stream() .filter(r - r.getSkills().contains(order.getDeviceType())) .sorted(Comparator.comparing(Repairman::getCurrentOrders)) .collect(Collectors.toList()); // 3. 分配工單 if(!repairmen.isEmpty()) { assignOrder(orderId, repairmen.get(0).getId()); } }