主数据平台 1.5.0：用 Claude Code 把统计大屏做成可交付的工程实践

任务：新增统计大屏

数据契约：
1. GET /api/dashboard/overview 返回 overview、successRate、requestCount
2. GET /api/dashboard/logs 支持 startTime、endTime、status 参数
3. GET /api/dashboard/rankings 返回按请求量排序的前十项

验收条件：
1. 空数据时页面显示明确的空状态，不出现 NaN
2. 接口失败时保留页面布局，并显示可重试提示
3. 时间范围变化后，所有图表使用同一个查询范围
4. 大屏首次加载只请求必要数据，避免重复请求

请先阅读项目中的：
- 前端路由和统计页面目录
- 后端控制器、服务层和数据访问层
- 现有接口响应格式
- 与请求日志相关的表结构或查询代码

本次只实现统计大屏的数据读取和展示，不修改认证、用户权限和基础表结构。
请先输出：
1. 现有代码结构
2. 可复用的接口或组件
3. 需要新增的文件
4. 可能影响性能的查询
确认方案后再修改代码。

请检查本次统计大屏改动：
- 是否存在重复请求或未清理的定时器
- 是否处理 loading、空数据和接口错误
- 是否把用户输入直接拼接进查询条件
- 是否为时间范围和排序参数设置了边界
- 是否有明显的 N+1 查询风险
只报告具体文件、代码位置和修复建议，不要进行无关重构。

from datetime import datetime, timedelta


def normalize_range(start_time: datetime | None,
                    end_time: datetime | None) -> tuple[datetime, datetime]:
    end = end_time or datetime.utcnow()
    start = start_time or end - timedelta(hours=24)

    if start >= end:
        raise ValueError("start_time must be earlier than end_time")
    if end - start > timedelta(days=31):
        raise ValueError("time range cannot exceed 31 days")

    return start, end


def build_dashboard_query(start_time, end_time, status=None):
    start, end = normalize_range(start_time, end_time)
    filters = ["created_at >= :start_time", "created_at < :end_time"]
    params = {"start_time": start, "end_time": end}

    if status:
        filters.append("status = :status")
        params["status"] = status

    where_clause = " AND ".join(filters)
    return {
        "where": where_clause,
        "params": params,
        "group_by": "endpoint",
        "order_by": "request_count DESC",
        "limit": 10,
    }

export async function loadDashboard(range) {
  const params = new URLSearchParams({
    startTime: range.start.toISOString(),
    endTime: range.end.toISOString(),
  });

  const response = await fetch(`/api/dashboard/overview?${params}`);
  if (!response.ok) {
    throw new Error(`dashboard request failed: ${response.status}`);
  }

  const data = await response.json();
  return {
    overview: data.overview ?? {},
    successRate: Array.isArray(data.successRate) ? data.successRate : [],
    requestCount: Array.isArray(data.requestCount) ? data.requestCount : [],
  };
}

请为统计大屏生成测试用例，至少包括：
1. 默认时间范围加载成功
2. 返回空数组和 null 字段
3. 后端返回 401、403、500
4. 用户快速连续切换时间范围
5. 请求尚未完成时再次刷新页面
6. 排行数据少于 10 项
每个用例写出前置条件、操作、预期结果。