1. 项目背景与核心价值
高校资产管理一直是校园后勤工作的重点难点。传统模式下，师生报修需要填写纸质单据或电话联系后勤部门，维修进度无法实时追踪，管理人员难以统筹分配任务。这套基于微信小程序的资产维修管理系统，正是为了解决这些痛点而生。
我在实际开发中发现，系统最核心的价值在于三点：
- 流程透明化：从报修到评价全流程线上可视，师生能随时查看进度
- 响应效率提升：智能派单机制让维修任务平均响应时间缩短60%
- 数据沉淀：所有维修记录形成结构化数据库，为设备生命周期管理提供依据
2. 技术架构设计解析
2.1 整体技术选型
系统采用经典的三层架构：
- 前端：微信小程序（跨平台+免安装）
- 后端：Spring Boot 2.7 + MyBatis Plus
- 数据库：MySQL 8.0
选择这套技术栈主要基于以下考量：
- 微信小程序天然适合校园场景，无需额外安装APP
- Spring Boot的自动配置特性大幅减少XML配置
- MyBatis Plus提供的Lambda查询方式比传统MyBatis更简洁
- MySQL 8.0对JSON字段的原生支持便于存储维修图片等多媒体信息
2.2 关键架构决策
2.2.1 混合身份认证方案
// 微信登录与账号密码登录并存 public class LoginController { @PostMapping("/login") public Result login(@RequestBody LoginDTO dto) { if (dto.getLoginType() == LoginType.WECHAT) { return wechatService.wechatLogin(dto.getCode()); } else { return accountService.passwordLogin(dto); } } }2.2.2 维修状态机设计
采用状态模式实现维修流程控制：
待接单 → 已接单 → 维修中 → 已完成 → 已评价 ↓ ↓ 取消 维修异常3. 核心功能实现细节
3.1 微信小程序端关键技术点
3.1.1 图片上传优化
// 采用微信原生API实现多图上传 wx.chooseImage({ count: 3, sizeType: ['compressed'], success: (res) => { res.tempFilePaths.forEach((path) => { wx.uploadFile({ url: API.upload, filePath: path, name: 'file', formData: { 'type': 'repair' } }) }) } })3.1.2 实时通知方案
- 使用WebSocket实现状态变更推送
- 结合模板消息发送微信服务通知
3.2 后台管理系统关键技术
3.2.1 智能派单算法
// 基于距离优先的派单逻辑 public Repairer assignRepairer(RepairOrder order) { return repairerService.list() .stream() .filter(r -> r.getSkills().contains(order.getDeviceType())) .min(Comparator.comparing(r -> DistanceUtil.calculate(r.getLocation(), order.getLocation()) )) .orElseThrow(() -> new BusinessException("暂无可用维修人员")); }3.2.2 数据统计模块
采用ECharts实现多维数据分析：
- 设备故障类型分布
- 维修响应时长趋势
- 维修人员KPI统计
4. 数据库设计精要
4.1 核心表结构设计
4.1.1 维修工单表（repair_order）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | bigint | 主键 |
| device_id | varchar | 设备编号 |
| fault_type | int | 故障类型 |
| images | json | 故障图片 |
| status | tinyint | 工单状态 |
4.1.2 评价表（evaluation）
CREATE TABLE `evaluation` ( `id` bigint NOT NULL AUTO_INCREMENT, `order_id` bigint NOT NULL, `score` tinyint DEFAULT 5, `content` varchar(500) DEFAULT '', `images` json DEFAULT NULL, PRIMARY KEY (`id`), UNIQUE KEY `uk_order` (`order_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;4.2 索引优化方案
- 为repair_order表的status字段添加普通索引
- 在evaluation表建立(order_id)的唯一索引
- 对device表的location字段建立空间索引
5. 开发实战经验分享
5.1 踩坑记录与解决方案
5.1.1 微信登录会话失效
问题现象：iOS设备频繁要求重新登录 解决方案：调整session有效期从7天改为30天，并增加心跳检测
5.1.2 并发派单冲突
问题现象：同一订单被分配给多个维修人员 解决方案：采用乐观锁机制
@Transactional public boolean acceptOrder(Long orderId, Long repairerId) { RepairOrder order = orderMapper.selectById(orderId); if (order.getStatus() != Status.PENDING) { return false; } order.setStatus(Status.ACCEPTED); order.setRepairerId(repairerId); return orderMapper.updateById(order) > 0; }5.2 性能优化实践
- 图片处理：
- 小程序端压缩后再上传
- 服务端生成缩略图
- 列表查询：
- 采用分页查询避免全表扫描
- 对常用查询字段建立组合索引
- 缓存策略：
- 维修人员信息缓存24小时
- 设备类型数据永久缓存
6. 项目部署指南
6.1 环境准备清单
- 服务器配置：
- CPU：4核以上
- 内存：8GB以上
- 系统：CentOS 7.6+
- 软件依赖：
- JDK 1.8
- MySQL 8.0
- Redis 6.x
- Nginx 1.18+
6.2 部署步骤
- 数据库初始化：
mysql -uroot -p < schema.sql mysql -uroot -p < data.sql- 后端服务部署：
nohup java -jar repair-system.jar \ --spring.profiles.active=prod \ > /var/log/repair.log 2>&1 &- 微信小程序发布：
- 配置合法域名
- 提交微信审核
- 灰度发布验证
7. 项目扩展方向
- 物联网集成：对接设备传感器实现故障预警
- 智能诊断：基于历史数据构建故障知识图谱
- 移动端扩展：开发维修人员专用APP增强功能
在实际开发过程中，我发现维修流程的状态管理是最容易出问题的环节。建议后续开发者可以采用工作流引擎（如Activiti）来替代现有的硬编码状态控制，这样既能提高系统的灵活性，也便于流程的调整和优化。
