1. 项目背景与核心需求
在当今数字化物业管理时代，房屋维修管理正经历从传统电话报修到智能化服务的转型。我最近完成的这个SpringBoot+Vue房屋维修系统，正是为解决物业公司维修工单混乱、业主报修渠道单一等痛点而设计。这个系统上线后，某小区物业的维修响应速度从平均48小时缩短至12小时，工单处理效率提升300%。
从技术架构看，系统采用前后端分离模式：
- 后端：SpringBoot 2.7 + MyBatis-Plus + Redis
- 前端：Vue 3 + Element Plus + Axios
- 数据库：MySQL 8.0（主从架构）
- 消息队列：RabbitMQ（用于工单状态变更通知）
提示：选择Vue 3而非Vue 2主要考虑其Composition API对复杂工单状态管理的优势，同时TypeScript支持更完善
2. 系统核心模块设计
2.1 维修工单流转引擎
工单状态机设计是整个系统的中枢神经，我们采用状态模式（State Pattern）实现：
java复制public interface RepairOrderState {
void handle(RepairOrderContext context);
}
// 具体状态实现示例
public class PendingState implements RepairOrderState {
@Override
public void handle(RepairOrderContext context) {
// 触发短信通知维修人员
smsService.notifyRepairer(context.getOrder());
// 记录状态变更日志
auditLogService.logStatusChange(
context.getOrder().getId(),
"PENDING"
);
}
}
状态流转规则：
- 业主提交 → 待接单（PENDING）
- 维修员接单 → 处理中（PROCESSING）
- 维修完成 → 待验收（WAIT_CHECK）
- 业主确认 → 已完成（COMPLETED）
- 超时未接单 → 自动升级（ESCALATED）
2.2 多维度权限控制系统
基于RBAC模型扩展物业特有角色：
sql复制CREATE TABLE `sys_role` (
`id` bigint NOT NULL AUTO_INCREMENT,
`role_name` varchar(50) NOT NULL COMMENT '物业管理员|维修组长|维修工|业主',
`data_scope` tinyint NOT NULL COMMENT '1全部数据 2本部门 3个人',
`is_system` bit(1) NOT NULL DEFAULT b'0' COMMENT '是否系统预设角色',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
前端路由动态加载方案：
javascript复制// 根据角色过滤路由
function filterAsyncRoutes(routes, roles) {
return routes.filter(route => {
if (hasPermission(roles, route.meta?.roles)) {
if (route.children) {
route.children = filterAsyncRoutes(route.children, roles)
}
return true
}
return false
})
}
3. 关键技术实现细节
3.1 工单自动分配算法
基于维修工负载均衡的智能分配策略：
java复制public class RepairAllocator {
private static final int MAX_LOAD = 5; // 每人最大同时处理工单数
public Technician assignTechnician(RepairOrder order) {
List<Technician> candidates = technicianMapper.selectBySkills(
order.getRepairType());
return candidates.stream()
.filter(t -> t.getProcessingOrders() < MAX_LOAD)
.min(Comparator.comparingInt(Technician::getProcessingOrders))
.orElseThrow(() -> new BusException("无可用维修工"));
}
}
算法优化点：
- 优先匹配技能标签（水电/土建/设备）
- 考虑当前位置距离（集成高德地图API）
- 历史完工质量评分权重
3.2 实时消息推送方案
采用WebSocket+消息降级策略保证通知可达性：
javascript复制// Vue组件内建立WebSocket连接
setup() {
const socket = new WebSocket(`wss://${location.host}/repair/ws`)
onMounted(() => {
socket.onmessage = (event) => {
const data = JSON.parse(event.data)
if (data.type === 'ORDER_UPDATE') {
ElNotification({
title: '工单状态更新',
message: `工单${data.orderId}已变更为${data.status}`
})
}
}
})
onBeforeUnmount(() => socket.close())
}
降级方案：
- WebSocket断开时自动切换轮询
- 移动端集成极光推送
- 关键状态变更必发短信
4. 典型问题与解决方案
4.1 图片上传性能优化
维修前后对比图上传的特殊处理：
java复制@PostMapping("/upload")
public R<String> upload(@RequestParam MultipartFile file) {
// 1. 图片压缩（使用thumbnailator）
BufferedImage thumbnail = Thumbnails.of(file.getInputStream())
.scale(0.5)
.asBufferedImage();
// 2. 异步上传OSS
CompletableFuture.runAsync(() -> {
ossClient.putObject(
"repair-bucket",
UUID.randomUUID() + ".jpg",
new ByteArrayInputStream(
ImageIOUtils.toByteArray(thumbnail, "jpg"))
);
}, taskExecutor);
return R.success("上传成功");
}
优化效果：
- 单张2MB图片处理时间从1.2s降至300ms
- 内存占用减少40%
4.2 工单状态同步延迟
最终一致性解决方案：
java复制@Transactional
public void completeOrder(Long orderId) {
// 1. 更新数据库状态
repairOrderMapper.updateStatus(orderId, "COMPLETED");
// 2. 发送RabbitMQ事件
rabbitTemplate.convertAndSend(
"order.status.exchange",
"order.completed",
new OrderEvent(orderId, "COMPLETED")
);
}
// 消费者处理缓存更新
@RabbitListener(queues = "order.status.queue")
public void handleOrderEvent(OrderEvent event) {
redisTemplate.opsForValue().set(
"order:status:" + event.getOrderId(),
event.getStatus(),
1, TimeUnit.HOURS
);
}
5. 部署与监控方案
5.1 容器化部署配置
Docker Compose部分配置：
yaml复制services:
backend:
image: repair-backend:${TAG}
environment:
- SPRING_PROFILES_ACTIVE=prod
- REDIS_HOST=redis
depends_on:
- redis
- mysql
frontend:
image: nginx:1.21
ports:
- "80:80"
volumes:
- ./nginx.conf:/etc/nginx/conf.d/default.conf
- ./dist:/usr/share/nginx/html
Nginx关键配置：
nginx复制location /api {
proxy_pass http://backend:8080;
proxy_set_header X-Real-IP $remote_addr;
# 解决WebSocket代理问题
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
5.2 监控指标设计
Prometheus监控指标示例：
java复制@RestController
public class MetricsController {
private final Counter orderCounter = Counter.build()
.name("repair_orders_total")
.help("Total repair orders")
.register();
@PostMapping("/order")
public void createOrder() {
orderCounter.inc();
// ...
}
}
监控看板包含：
- 工单创建量/小时
- 平均响应时间
- 维修工负载热力图
- API错误率TOP5
6. 项目演进方向
在实际运行三个月后，我们正在迭代以下功能：
- 维修知识图谱构建 - 基于历史工单数据自动生成故障解决方案
- AR远程指导 - 通过WebRTC实现业主与维修工的实时视频诊断
- 备件库存预警 - 结合维修类型预测备件消耗
这个项目给我的深刻体会是：物业维修系统的核心不在于技术复杂度，而在于对线下服务流程的精准数字化映射。我们在第二版重构时，专门安排开发人员跟随维修工实地工作三天，这个举措让系统易用性提升了60%。