开源上门预约系统源码

上门预约系统的本质，并不是"选个时间下单"，而是一个对有限资源进行时间段占用与调度的系统。

只要这个模型设计清楚，无论是家政、维修、护理还是上门培训，系统都能稳定运行并持续扩展。

本文从源码设计角度出发，讲清一套开源上门预约系统在核心模块上的实现思路，并通过关键代码示例，说明系统是如何解决并发预约、时间冲突和状态流转问题的。

一、上门预约系统的核心模型抽象

在源码层面，预约系统可以抽象为三类核心对象：

Service（服务）：做什么
Resource（资源）：谁来做（服务人员、设备）
TimeSlot（时间段）：什么时候做

只要这三者关系清晰，业务就不会乱。

核心实体简化示例

java 复制代码

class Service {
    Long id;
    String name;
    Integer duration; // 服务时长（分钟）
}

class Resource {
    Long id;
    String name;
    boolean enabled;
}

class TimeSlot {
    LocalDateTime start;
    LocalDateTime end;
}

二、预约单的资源占用设计

预约订单并不是简单的一条记录，而是一次资源在时间段内的占用行为。

预约订单核心字段设计

java 复制代码

CREATE TABLE appointment (
    id BIGINT PRIMARY KEY,
    service_id BIGINT,
    resource_id BIGINT,
    start_time DATETIME,
    end_time DATETIME,
    status VARCHAR(20),
    version INT,
    create_time DATETIME
);

start_time + end_time 明确资源占用区间
version 用于并发控制
status 控制占用是否有效

三、并发预约下的时间冲突校验

真正的难点在于：多个用户同时预约同一资源同一时间。

冲突判断规则

任意两个预约时间段只要发生重叠，就视为冲突

SQL 冲突判断示例

sql 复制代码

SELECT COUNT(1)
FROM appointment
WHERE resource_id = #{resourceId}
AND status IN ('CREATED','CONFIRMED')
AND start_time < #{endTime}
AND end_time > #{startTime};

服务层校验代码

java 复制代码

public void checkTimeConflict(
        Long resourceId,
        LocalDateTime start,
        LocalDateTime end) {

    int conflict = appointmentMapper.countConflict(
        resourceId, start, end
    );
    if (conflict > 0) {
        throw new RuntimeException("该时间段已被预约");
    }
}

这一层必须放在事务内执行，否则一定会超卖。

四、并发安全：乐观锁 + 状态控制

为了避免高并发下重复占用资源，系统通常采用乐观锁机制。

更新预约状态示例

java 复制代码

UPDATE appointment
SET status = 'CONFIRMED',
    version = version + 1
WHERE id = #{id}
AND version = #{version};

Java 代码处理

java 复制代码

public void confirmAppointment(Appointment appt) {
    int updated = appointmentMapper.confirm(
        appt.getId(), appt.getVersion()
    );
    if (updated == 0) {
        throw new RuntimeException("预约状态已变更，请重试");
    }
}

这种设计可以有效防止：

重复确认
并发取消与确认冲突

五、可预约时间段的动态计算

系统不应该写死"几点可以预约"，而是动态计算。

可预约时间生成逻辑

java 复制代码

public List<TimeSlot> generateSlots(
        LocalDate date,
        LocalTime start,
        LocalTime end,
        int duration) {

    List<TimeSlot> slots = new ArrayList<>();
    LocalDateTime cursor = LocalDateTime.of(date, start);

    while (cursor.plusMinutes(duration).isBefore(
            LocalDateTime.of(date, end))) {

        slots.add(new TimeSlot(
            cursor,
            cursor.plusMinutes(duration)
        ));
        cursor = cursor.plusMinutes(duration);
    }
    return slots;
}

再结合已有预约进行过滤，即可得到最终可选时间。

六、预约状态流转设计

状态是系统稳定运行的"安全阀"。

状态枚举示例

java 复制代码

public enum AppointmentStatus {
    CREATED,     // 已创建
    CONFIRMED,   // 已确认
    SERVING,     // 服务中
    FINISHED,    // 已完成
    CANCELED     // 已取消
}

状态流转校验

java 复制代码

public void changeStatus(
        Appointment appt,
        AppointmentStatus target) {

    if (appt.getStatus() == CANCELED) {
        throw new RuntimeException("已取消的预约不可操作");
    }
    appt.setStatus(target);
}

七、解耦设计：异步通知与扩展能力

预约系统中，业务处理 ≠ 通知处理。

发送预约事件

java 复制代码

rabbitTemplate.convertAndSend(
    "appointment.event.exchange",
    "appointment.status",
    appointment
);

后续可以无侵入扩展：

短信通知
服务人员提醒
超时自动取消

八、为什么开源上门预约系统要这样设计

这套设计思路有三个核心优势：

预约逻辑可复用：换行业不换核心
并发安全可控：避免时间超卖
扩展成本低：新规则不推翻旧结构

真正靠谱的开源上门预约系统源码，看的是这些底层设计是否经得起业务增长。

结语

开源上门预约系统源码的价值，不在页面有多复杂，而在于预约模型是否严谨、并发是否安全、结构是否可扩展。

如果一套源码把"资源 + 时间 + 状态"这三件事处理清楚，那么无论面对什么上门服务场景，都能稳定支撑业务长期发展。