peixue-dev/Archive/peidu-temp-files/docs/✅预约与日历数据统一-后端接口完成-2026-01-24.md

✅ 预约与日历数据统一 - 后端接口完成

日期: 2026-01-24
状态: ✅ 后端接口已完成
下一步: 修改前端页面

---

📝 已完成的修改

1. CalendarService 接口

文件: peidu/backend/src/main/java/com/peidu/service/CalendarService.java

新增方法:

/**
 * 获取用户的所有预约记录（不限日期）
 */
List<AppointmentVO> getAllAppointments(Long userId);

/**
 * 获取用户的所有预约统计（不限日期）
 */
Map<String, Object> getAllStats(Long userId);

---

2. CalendarServiceImpl 实现类

文件: peidu/backend/src/main/java/com/peidu/service/impl/CalendarServiceImpl.java

实现方法:

getAllAppointments - 获取所有预约记录

@Override
public List<AppointmentVO> getAllAppointments(Long userId) {
    log.info("查询用户所有预约记录, userId: {}", userId);
    
    QueryWrapper<Order> queryWrapper = new QueryWrapper<>();
    queryWrapper.eq("user_id", userId)
               .in("status", Arrays.asList(1, 2, 3, 4))  // 待接单、待服务、服务中、已完成
               .eq("deleted", 0)
               .orderByAsc("service_date", "time_slot");
    
    List<Order> orders = orderMapper.selectList(queryWrapper);
    
    log.info("查询到 {} 条订单记录", orders.size());
    
    return orders.stream()
            .map(this::convertToAppointmentVO)
            .collect(Collectors.toList());
}

特点:

• ✅ 不限制日期范围，查询所有订单
• ✅ 只查询有效状态的订单（1,2,3,4）
• ✅ 按服务日期和时间段排序

getAllStats - 获取所有预约统计

@Override
public Map<String, Object> getAllStats(Long userId) {
    log.info("查询用户所有预约统计, userId: {}", userId);
    
    QueryWrapper<Order> queryWrapper = new QueryWrapper<>();
    queryWrapper.eq("user_id", userId)
               .eq("deleted", 0);
    
    List<Order> orders = orderMapper.selectList(queryWrapper);
    
    Map<String, Object> stats = new HashMap<>();
    stats.put("totalCount", orders.size());
    stats.put("pendingCount", orders.stream()
            .filter(o -> o.getStatus() == 1 || o.getStatus() == 2)
            .count());
    stats.put("ongoingCount", orders.stream()
            .filter(o -> o.getStatus() == 3)
            .count());
    stats.put("completedCount", orders.stream()
            .filter(o -> o.getStatus() == 4)
            .count());
    
    return stats;
}

返回数据:

• totalCount: 总订单数
• pendingCount: 待服务数（状态1+2）
• ongoingCount: 服务中数（状态3）
• completedCount: 已完成数（状态4）

---

3. CalendarController 控制器

文件: peidu/backend/src/main/java/com/peidu/controller/CalendarController.java

新增接口:

GET /api/calendar/all-appointments

@GetMapping("/all-appointments")
@ApiOperation("获取所有预约记录（不限日期）")
public Result<List<AppointmentVO>> getAllAppointments(
        javax.servlet.http.HttpServletRequest request) {
    
    Long userId = getCurrentUserId(request);
    List<AppointmentVO> appointments = calendarService.getAllAppointments(userId);
    
    log.info("查询到 {} 条预约记录", appointments.size());
    return Result.success(appointments);
}

接口说明:

• 请求方式: GET
• 路径: /api/calendar/all-appointments
• 参数: 无（从请求中获取userId）
• 返回: 所有预约记录列表

GET /api/calendar/all-stats

@GetMapping("/all-stats")
@ApiOperation("获取所有预约统计（不限日期）")
public Result<Object> getAllStats(
        javax.servlet.http.HttpServletRequest request) {
    
    Long userId = getCurrentUserId(request);
    Object stats = calendarService.getAllStats(userId);
    
    return Result.success(stats);
}

接口说明:

• 请求方式: GET
• 路径: /api/calendar/all-stats
• 参数: 无（从请求中获取userId）
• 返回: 统计数据对象

---

🧪 接口测试

测试1: 获取所有预约记录

请求:

GET /api/calendar/all-appointments
Authorization: Bearer {token}

预期响应:

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": 1,
      "orderNo": "ORD20260124120616006",
      "serviceDate": "2026-01-28",
      "timeSlot": "14:00-16:00",
      "serviceType": "陪伴服务",
      "serviceName": "数字辅导",
      "status": 1,
      "statusText": "待接单"
    },
    // ... 更多订单
  ]
}

测试2: 获取所有预约统计

请求:

GET /api/calendar/all-stats
Authorization: Bearer {token}

预期响应:

{
  "code": 200,
  "message": "success",
  "data": {
    "totalCount": 62,
    "pendingCount": 62,
    "ongoingCount": 0,
    "completedCount": 0
  }
}

---

📊 数据对比

修改前:

接口	查询范围	返回数量
/api/calendar/appointments	当前月份	6条
/api/calendar/monthly-stats	当前月份	6条

修改后:

接口	查询范围	返回数量
/api/calendar/appointments	当前月份	6条
/api/calendar/all-appointments	所有月份	62条 ✅
/api/calendar/monthly-stats	当前月份	6条
/api/calendar/all-stats	所有月份	62条 ✅

---

🎯 下一步操作

1. 编译后端代码

cd peidu/backend
mvn clean compile

2. 重启后端服务

# 停止现有服务
# 启动新服务

3. 测试新接口

使用Postman或浏览器测试:

• GET http://localhost:8080/api/calendar/all-appointments
• GET http://localhost:8080/api/calendar/all-stats

4. 修改前端页面

需要修改的文件:

• peidu/uniapp/src/user-package/pages/calendar/index.vue
• peidu/uniapp/src/api/index.js (添加新的API方法)

---

📝 前端修改计划

1. 添加API方法

// api/index.js
export const calendarApi = {
  // 现有方法
  getAppointments(startDate, endDate) {
    return request({
      url: '/api/calendar/appointments',
      method: 'get',
      params: { startDate, endDate }
    })
  },
  
  // 新增方法
  getAllAppointments() {
    return request({
      url: '/api/calendar/all-appointments',
      method: 'get'
    })
  },
  
  getAllStats() {
    return request({
      url: '/api/calendar/all-stats',
      method: 'get'
    })
  }
}

2. 修改日历页面

添加视图切换:

• 月视图: 显示当前月份的订单
• 全部视图: 显示所有订单

添加统计信息:

• 本月课时: 当前月份订单数
• 全部课时: 所有订单数

---

✅ 完成清单

• 修改 CalendarService 接口
• 实现 CalendarServiceImpl 方法
• 添加 CalendarController 接口
• 编译后端代码
• 测试新接口
• 修改前端API方法
• 修改前端日历页面
• 测试前端功能

---

🔍 注意事项

1. 用户ID获取

确保 getCurrentUserId() 方法能正确获取用户ID:

private Long getCurrentUserId(javax.servlet.http.HttpServletRequest request) {
    Object userIdObj = request.getAttribute("userId");
    if (userIdObj != null) {
        return Long.valueOf(userIdObj.toString());
    }
    
    Object teacherIdObj = request.getAttribute("teacherId");
    if (teacherIdObj != null) {
        return Long.valueOf(teacherIdObj.toString());
    }
    
    log.warn("无法从请求中获取用户ID");
    return 1L; // 默认值
}

2. 订单状态

当前查询的状态:

• 1: 待接单（已支付）
• 2: 待服务（已接单）
• 3: 服务中
• 4: 已完成

不包括:

• 0: 待支付
• -1: 已取消
• -2: 退款中
• -3: 已退款

3. 性能考虑

如果订单数量很大，建议:

• 添加分页功能
• 添加缓存机制
• 优化查询条件

---

完成时间: 2026-01-24
修改人员: Kiro AI Assistant
状态: ✅ 后端接口已完成，等待编译测试

🎉 后端接口已完成！现在可以编译并测试新接口了！