仪表盘与指标

业务分析、系统健康、时间范围、下载成功口径以及缺失数据的解释。

两类数据分开读

/admin/overview 展示业务分析和系统健康。API 分别为 /api/v1/admin/dashboard/business 与 /api/v1/admin/dashboard/system。它们都是管理员接口；看板是读模型，不是身份、文件、配额或对象状态的最终写入权威。

业务事件经 Analytics Worker 投影到读模型，因此数据可能延迟。刷新图表不代表后台事件已经处理完成，也不应从暂时缺失的曲线推断业务数据丢失。

range 支持 today、7d 和 30d，按 Asia/Shanghai 日历日期解释，结束时间为本次响应生成时间。today 从当地午夜开始，7d 包括今天和之前 6 个日历日，30d 包括今天和之前 29 个日历日。

它们不是固定向前滚动的 24、168、720 小时窗口。比较两个响应时同时检查实际起止时刻、时区和数据覆盖范围；不要只比较按钮文字。

**Successful Download** 只有 Storage 完成完整对象字节响应后才计入。申请或消费 Download Ticket 不算一次完整成功下载。

而分享记录的 downloadCount 在成功签发分享票据时就增加。因此分享次数限制已经减一、看板成功下载仍为零，可能是下载未完成，二者并不必然矛盾。见分享。

Committed Storage Bytes 是 Core 完成版本确认后计入配额的字节。Physical Object Bytes 是存储层对象占用，可能包含历史版本和暂时未协调完成的对象；不要要求两个指标始终相等。

System Health 使用 available、partial、unavailable 表达数据源可用性。只有部分来源能回答时，某些字段保留 null。没有 Prometheus 数据不等于 CPU 为零、服务健康或故障已经修复。

Freshness 描述最新处理事实以及延迟；Coverage 描述从何时起有可靠观测及其缺口。数据很新仍可能历史覆盖不足，覆盖很长也可能当前处理延迟。业务指标为 null 或覆盖不完整时应保留未知状态，不应改成零补齐图表。

先区分 401/403 权限错误、503 服务错误，以及成功响应中的 partial/null。随后由运营者检查 analytics-worker、数据库、Prometheus 和 Core 的相关状态。报告包含选择的 range、时间、可用性和脱敏错误即可；不要依据看板独自修改文件或配额事实。