# 数据接口映射与运行策略

当前页面使用 `data.json` 模拟统一快照接口。真实接口建议返回 `version`、`generatedAt`、`health`、`metrics`、`trend`、`regions`、`pipeline` 和 `alerts`。

- 轮询：默认 30 秒；新请求开始前使用 `AbortController` 取消旧请求。
- 缓存：成功快照写入本地缓存；断线时明确标记“断线缓存”，不能显示为实时数据。
- 重试：生产环境使用指数退避与抖动，恢复后校验数据版本。
- 鉴权：登录、角色和指标权限必须由服务端校验，隐藏前端模块不是权限控制。
- WebSocket：仅在确有秒级事件要求时使用；实现心跳、断线重连、消息序号和缺口补拉。
- 异常：零值、无数据、加载中、权限不足和接口错误应使用不同状态码与界面文案。
- 大量明细：后端聚合，明细分页或虚拟化；趋势接口根据屏幕时间跨度抽样。