peixue-dev/Archive/peidu-temp-files/docs/🔍家长端日历功能问题诊断-2026-01-24.md

🔍 家长端日历功能问题诊断

诊断时间: 2026-01-24
问题描述: 家长端日历功能无法显示数据，之前可以看到日历上显示待上课的数量、已完成服务的数量，下方会显示订单，点击订单显示订单详情

---

🔍 问题分析

1. 后端API问题

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

问题1：订单状态筛选错误

// ❌ 当前代码：只查询状态为 2, 3, 4 的订单
queryWrapper.in("status", Arrays.asList(2, 3, 4)) // 待服务、服务中、已完成

实际订单状态定义：

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

问题：

• 缺少状态 1（待接单/已支付）的订单
• 家长支付后的订单状态是 1，但日历不显示

问题2：统计数据状态映射错误

// ❌ 当前代码
stats.put("pendingCount", orders.stream().filter(o -> 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());

问题：

• pendingCount 应该包含状态 1 和 2（待接单 + 待服务）
• 统计数据不准确

问题3：用户ID硬编码

// ❌ Controller中硬编码
private Long getCurrentUserId() {
    return 1L;  // 固定返回用户ID 1
}

问题：

• 所有用户看到的都是用户ID=1的数据
• 无法显示当前登录用户的订单

2. 前端问题

文件: peidu/uniapp/src/user-package/pages/calendar/index.vue

问题1：日历组件缺失

<calendar 
  :scheduleData="scheduleData" 
  role="parent"
  @date-select="handleDateSelect"
  @month-change="handleMonthChange"
  @schedule-click="handleScheduleClick"
/>

问题：

• 引用了 @/components/calendar/calendar.vue 组件
• 但这个组件可能不存在或有问题

问题2：API调用路径

const res = await calendarApi.getAppointments(startDate, endDate)

需要检查：

• calendarApi 是否正确定义
• API路径是否正确

---

✅ 修复方案

1. 修复后端订单状态筛选

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

修复 getAppointments 方法

@Override
public List<AppointmentVO> getAppointments(Long userId, LocalDate startDate, LocalDate endDate) {
    log.info("查询用户预约记录, userId: {}, startDate: {}, endDate: {}", userId, startDate, endDate);
    
    // ✅ 修复：包含所有有效状态的订单（1-待接单, 2-待服务, 3-服务中, 4-已完成）
    QueryWrapper<Order> queryWrapper = new QueryWrapper<>();
    queryWrapper.eq("user_id", userId)
               .ge("service_date", startDate)
               .le("service_date", endDate)
               .in("status", Arrays.asList(1, 2, 3, 4)) // ✅ 增加状态1
               .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());
}

修复 getDailyServices 方法

@Override
public List<ServiceDetailVO> getDailyServices(Long userId, LocalDate date) {
    log.info("查询指定日期的服务详情, userId: {}, date: {}", userId, date);
    
    // ✅ 修复：包含所有有效状态
    QueryWrapper<Order> queryWrapper = new QueryWrapper<>();
    queryWrapper.eq("user_id", userId)
               .eq("service_date", date)
               .in("status", Arrays.asList(1, 2, 3, 4)) // ✅ 增加状态1
               .eq("deleted", 0)
               .orderByAsc("time_slot");
    
    List<Order> orders = orderMapper.selectList(queryWrapper);
    
    log.info("查询到 {} 条服务记录", orders.size());
    
    return orders.stream()
            .map(this::convertToServiceDetailVO)
            .collect(Collectors.toList());
}

修复 getMonthlyStats 方法

@Override
public Map<String, Object> getMonthlyStats(Long userId, Integer year, Integer month) {
    log.info("查询当月预约统计, userId: {}, year: {}, month: {}", userId, year, month);
    
    LocalDate startDate = LocalDate.of(year, month, 1);
    LocalDate endDate = startDate.plusMonths(1).minusDays(1);
    
    QueryWrapper<Order> queryWrapper = new QueryWrapper<>();
    queryWrapper.eq("user_id", userId)
               .ge("service_date", startDate)
               .le("service_date", endDate)
               .eq("deleted", 0);
    
    List<Order> orders = orderMapper.selectList(queryWrapper);
    
    // ✅ 修复：正确统计各状态数量
    Map<String, Object> stats = new HashMap<>();
    stats.put("totalCount", orders.size());
    // 待服务 = 待接单(1) + 待服务(2)
    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;
}

2. 修复用户ID获取

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

/**
 * 获取当前用户ID
 * ✅ 从请求头或token中获取
 */
private Long getCurrentUserId() {
    // 方案1：从请求头获取
    HttpServletRequest request = 
        ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes())
        .getRequest();
    String userIdStr = request.getHeader("userId");
    if (userIdStr != null) {
        return Long.parseLong(userIdStr);
    }
    
    // 方案2：从session获取
    Object userInfo = request.getSession().getAttribute("userInfo");
    if (userInfo != null) {
        // 根据实际UserInfo类结构获取ID
        return ((UserInfo) userInfo).getId();
    }
    
    // 默认返回1（仅用于测试）
    log.warn("无法获取当前用户ID，使用默认值1");
    return 1L;
}

3. 修复状态文本映射

/**
 * 获取状态文本
 * ✅ 修复状态映射
 */
private String getStatusText(Integer status) {
    switch (status) {
        case 0: return "待支付";
        case 1: return "待接单";      // ✅ 修复：已支付，等待陪伴员接单
        case 2: return "待服务";      // ✅ 修复：已接单，等待服务
        case 3: return "服务中";
        case 4: return "已完成";
        case -1: return "已取消";
        case -2: return "退款中";
        case -3: return "已退款";
        default: return "未知状态";
    }
}

---

📋 需要修改的文件

1. 后端

   • peidu/backend/src/main/java/com/peidu/service/impl/CalendarServiceImpl.java

     • 修复 getAppointments 方法的状态筛选
     • 修复 getDailyServices 方法的状态筛选
     • 修复 getMonthlyStats 方法的统计逻辑
     • 修复 getStatusText 方法的状态映射

   • peidu/backend/src/main/java/com/peidu/controller/CalendarController.java

     • 修复 getCurrentUserId 方法，从请求中获取真实用户ID

2. 前端（需要进一步检查）

   • 检查 @/components/calendar/calendar.vue 组件是否存在
   • 检查 @/api/index.js 中的 calendarApi 定义

---

🧪 测试步骤

1. 修复后端代码

   cd peidu/backend
   mvn clean compile
   

2. 重启后端服务

3. 测试API

   • 访问 /api/calendar/appointments?startDate=2026-01-01&endDate=2026-01-31
   • 检查返回的订单是否包含状态1的订单

4. 测试前端

   • 登录家长端
   • 进入日历页面
   • 检查是否显示订单数据
   • 点击日期查看详情
   • 点击订单跳转到详情页

---

🎯 预期效果

修复后，家长端日历应该：

1. ✅ 显示所有已支付的订单（状态 1, 2, 3, 4）
2. ✅ 日历上显示每天的订单数量
3. ✅ 统计数据正确显示（总数、待服务、已完成）
4. ✅ 点击日期显示当天的订单列表
5. ✅ 点击订单跳转到订单详情页
6. ✅ 每个用户只看到自己的订单数据

---

📝 注意事项

1. 订单状态定义要统一：确保前后端对订单状态的理解一致
2. 用户ID获取：需要根据实际的认证方式调整
3. 日历组件：如果组件不存在，需要创建或使用第三方组件
4. 数据权限：确保用户只能看到自己的订单数据