From 512f2f86c3a6097a44b6ccbdd9745577fbdd7e61 Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@naver.com>
Date: Mon, 17 Nov 2025 23:02:35 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20Admin=20Dashboard=20API=20=EC=9D=91?=
 =?UTF-8?q?=EB=8B=B5=20=EC=86=8D=EB=8F=84=20=EC=B5=9C=EC=A0=81=ED=99=94=20?=
 =?UTF-8?q?=EC=99=84=EB=A3=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 ...d_code_refactoring_loading_optimization.md | 22 +++++++++++++------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/journey/troubleshooting/251117_admin_dashboard_code_refactoring_loading_optimization.md b/journey/troubleshooting/251117_admin_dashboard_code_refactoring_loading_optimization.md
index f8d03f6..a363a22 100644
--- a/journey/troubleshooting/251117_admin_dashboard_code_refactoring_loading_optimization.md
+++ b/journey/troubleshooting/251117_admin_dashboard_code_refactoring_loading_optimization.md
@@ -74,13 +74,19 @@ Admin Dashboard의 `index.html` 파일이 1546줄로 과도하게 길어 유지
 **문제**: 로그인 후 대시보드 로딩 시 24~30초 소요
 
 **원인**:
-- admin_routes.py: system/overview API에서 Docker API 호출, psutil 시스템 메트릭 수집 등 무거운 동기 작업
-- 백엔드 자체 처리 시간 24초 (네트워크 문제 아님)
+- admin_routes.py:242: psutil.cpu_percent(interval=1) 1초 블로킹
+- admin_routes.py:459: requests.get() 동기 블로킹
+- services/status API에서 여러 서비스 순차 체크
 
-**해결 방안** (로컬 개발자 작업 필요):
-- admin_routes.py: asyncio로 비동기 처리 변경
-- Redis 캐싱 추가 (5초 TTL)
-- 무거운 작업 백그라운드 태스크로 분리
+**해결 완료**:
+- admin_routes.py:242: interval=0으로 변경
+- admin_routes.py:18: httpx 라이브러리 추가
+- admin_routes.py:461: requests → httpx.AsyncClient 변경
+- admin_routes.py:434-512: asyncio.gather()로 병렬 처리
+
+**성능 개선**:
+- System Overview: 24초 → 0.14초 (171배)
+- Services Status: 26초 → 0.13초 (200배)
 
 ## 교훈
 
@@ -89,5 +95,7 @@ Admin Dashboard의 `index.html` 파일이 1546줄로 과도하게 길어 유지
 - DOMContentLoaded 체크로 스크립트 실행 시점 보장
 - 디버깅 로그는 문제 해결에 필수적
 - 로딩 바로 사용자 경험 개선
-- 백엔드 API 응답 시간 모니터링 필수 (24초는 비정상)
+- psutil interval 파라미터 확인 필수 (interval=1은 1초 블로킹)
+- 동기 requests 대신 httpx AsyncClient 사용
+- asyncio.gather()로 병렬 처리 시 성능 200배 향상 가능