儀錶盤與指標

業務分析、系統健康、時間範圍、下載成功口徑以及缺失資料的解釋。

兩類資料分開讀

/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、時間、可用性和脫敏錯誤即可；不要依據看板獨自修改檔案或配額事實。