260707_2

.agent/backend.md

@@ -260,5 +260,11 @@
 * **엔드포인트:** `GET /api/dashboard/admin/resources?days=30` (SYSTEM_ADMIN 전용, 범위 1~90일)
 * **응답:**
   - `current`: 요청 시점 실시간 계측값 (그래프 미저장)
-  - `history`: `system_resources` 테이블의 최근 N일 시계열 (그래프 렌더링용)
+  - `history`: `system_resources` 테이블의 최근 N일 시계열 (그래프 렌더링용, **다운샘플링 적용**)
   - `stats`: 활성 사용자/프로젝트/저장소 지표
+* **다운샘플링 (조회 시):**
+  - 30일 원본은 약 21,600점(2분 간격) → 그대로 전송 시 페이로드 과다(~4MB)
+  - SQL에서 시간버킷 평균으로 축소: `bucket = max(120초, days*86400 / 300)` → 최대 약 300점
+  - `GROUP BY FLOOR(UNIX_TIMESTAMP(timestamp) / bucket)` + `AVG(...)`로 집계
+  - 계측 간격(2분)보다 버킷이 작으면 원본 해상도 유지 (하루 이하 조회 시)
+  - 효과: 30일 조회 페이로드 ~4MB → ~55KB 수준