上门预约系统广泛应用于家政服务、维修安装、医疗护理、上门美容等场景。表面看是“选时间 + 下单”，但在实际开发中，涉及时间冲突校验、人员排班、订单状态流转、多角色协同等一系列复杂问题。
本文以开源上门预约系统源码为视角，拆解核心功能模块，并结合实际开发中的技术选型思路，展示关键实现代码，帮助你理解一套可落地的上门预约系统是如何设计与实现的。
一、上门预约系统的整体架构设计
典型的上门预约系统采用前后端分离架构，后端围绕“预约 + 服务 + 人员”展开。
系统角色
- 用户端：选择服务、预约时间、下单支付
- 服务人员端：查看排班、接单、服务确认
- 管理后台：服务配置、人员管理、订单调度
后端核心服务划分
- 预约订单服务
- 服务与价格服务
- 人员排班服务
- 时间冲突校验服务
- 消息通知服务
技术选型通常为：
- 后端：Spring Boot / Spring Cloud
- 数据库：MySQL
- 缓存：Redis
- 消息：RabbitMQ
- 时间处理：Java Time API
二、核心模块一：预约订单模块
预约订单是系统的核心数据载体。
预约订单表核心字段
CREATE TABLE appointment_order (
id BIGINT PRIMARY KEY,
user_id BIGINT,
service_id BIGINT,
staff_id BIGINT,
appoint_time DATETIME,
duration INT,
status VARCHAR(20),
create_time DATETIME
);
预约状态枚举设计
public enum AppointmentStatus {
CREATED, // 已创建
CONFIRMED, // 已确认
SERVING, // 服务中
FINISHED, // 已完成
CANCELED // 已取消
}
创建预约订单示例
@Transactional
public AppointmentOrder createAppointment(CreateAppointmentRequest req) {
AppointmentOrder order = new AppointmentOrder();
order.setUserId(req.getUserId());
order.setServiceId(req.getServiceId());
order.setStaffId(req.getStaffId());
order.setAppointTime(req.getAppointTime());
order.setDuration(req.getDuration());
order.setStatus(AppointmentStatus.CREATED);
order.setCreateTime(LocalDateTime.now());
appointmentMapper.insert(order);
return order;
}
三、核心模块二：时间冲突校验机制
时间冲突是上门预约系统中最关键、最容易出问题的地方。
冲突校验核心逻辑
public boolean hasTimeConflict(Long staffId,
LocalDateTime startTime,
LocalDateTime endTime) {
int count = appointmentMapper.countConflict(
staffId, startTime, endTime
);
return count > 0;
}
SQL 冲突判断示例：
SELECT COUNT(1)
FROM appointment_order
WHERE staff_id = #{
staffId}
AND status IN ('CREATED','CONFIRMED','SERVING')
AND appoint_time < #{
endTime}
AND DATE_ADD(appoint_time, INTERVAL duration MINUTE) > #{
startTime};
设计要点
- 冲突判断必须在事务中完成
- 只校验“有效状态”的订单
- 这是防止超卖的关键逻辑
四、核心模块三：人员排班与可预约时间段
为了提升用户体验，系统通常会提前计算可预约时间段。
排班数据结构示例
public class StaffSchedule {
private Long staffId;
private LocalTime workStart;
private LocalTime workEnd;
}
计算可预约时间段逻辑
public List<LocalDateTime> getAvailableSlots(
StaffSchedule schedule, LocalDate date) {
List<LocalDateTime> slots = new ArrayList<>();
LocalDateTime start = LocalDateTime.of(date, schedule.getWorkStart());
LocalDateTime end = LocalDateTime.of(date, schedule.getWorkEnd());
while (start.plusMinutes(60).isBefore(end)) {
slots.add(start);
start = start.plusMinutes(60);
}
return slots;
}
技术选型思路
- 排班规则存数据库
- 可预约时间实时计算或缓存
- 避免硬编码时间规则
五、核心模块四：状态流转与消息通知
预约系统中的状态变化需要同步通知多个角色。
状态变更发送消息
public void sendAppointmentMessage(AppointmentOrder order) {
rabbitTemplate.convertAndSend(
"appointment.exchange",
"appointment.status",
order
);
}
消费消息处理通知
@RabbitListener(queues = "appointment.queue")
public void handleAppointment(AppointmentOrder order) {
// 通知用户、服务人员
}
优势
- 状态变更与通知解耦
- 提高系统稳定性
- 易扩展短信、站内信、推送
六、核心模块五：多角色权限控制
不同角色在系统中的操作权限严格不同。
权限校验示例
public void checkStaffPermission(Long staffId, AppointmentOrder order) {
if (!staffId.equals(order.getStaffId())) {
throw new RuntimeException("无权限操作该订单");
}
}
设计原则
- 服务端做强校验
- 前端控制仅作体验优化
- 防止越权操作
七、开源上门预约系统的扩展方向
一套成熟的开源上门预约系统源码，通常预留以下扩展点：
- 多服务组合预约
- 多人员协同服务
- 服务区域与距离限制
- 动态定价与高峰加价
- SaaS 多租户支持
这些能力都建立在清晰的模块拆分和稳定的核心设计之上。
结语
开源上门预约系统源码的价值，不只是功能完整，而是是否具备清晰的业务边界、合理的技术选型和可持续扩展能力。
如果你正在做上门预约系统的二次开发、源码选型或技术方案设计，以上模块拆解与实现思路，基本可以直接作为参考蓝本使用。
