# Admin Dashboard 네비게이션 구조 리팩토링 계획

**날짜**: 2025-12-25
**상태**: 부분 완료

---

## 계획 요약

시스템 메뉴 하위 구조 도입으로 정보 계층 명확화 및 서버별 관리 구조 개선

### 주요 변경사항
- 시스템 메뉴 하위 4개 메뉴 추가 (51123 서버, 51124 서버, 전체 컨테이너, 전체 서비스)
- 기존 컨테이너/51124 모니터 메뉴 제거 및 통합
- 포트 사용 현황, 컨테이너 재시작 기능 추가

---

## 완료된 작업

- → 상세: `troubleshooting/251225_admin_dashboard_navigation_structure_refactoring.md`
- → PostgreSQL/Neo4j TCP 헬스체크: `troubleshooting/260115_postgresql_neo4j_tcp_healthcheck.md`

---

## 남은 작업

### 서버별 서비스 상태 구분 API 구현
**파일**: `admin-dashboard/backend/services/system_service.py`, `admin-dashboard/frontend/modules/system.js`
- `get_services_status()`에 `server: Optional[str] = None` 파라미터 추가
- 서버별 필터링: 51123 서버(nginx, gitea, backend, postgresql, neo4j, auth-server), 51124 서버(rb8001, skill-email, robeing-monitor, ChromaDB)
- 프론트엔드: `loadSystem51123()`, `loadSystem51124()`가 서버별 API 호출하도록 수정
- 서비스 상태 표시 형식: 카드 형식(`service-grid`) → 목록 형식(테이블/리스트)으로 변경, `response_time_ms`, `check_method`, `host`, `timestamp` 정보 포함

### Nginx 상태 API 개선
**파일**: `admin-dashboard/backend/routers/system.py:97-133`
- `get_nginx_status()` 응답에 `config_valid` 필드 추가
- `sudo nginx -t` 결과를 `config_valid`에 반영
- 프론트엔드: `app.js:1104`에서 `nginxStatusResponse.config_valid` 참조 중

---

## 참고

- `251204_admin_dashboard_business_integration.md`: 비즈니스 통합 계획
- `310_전체_시스템_구조_컨테이너와_마이크로서비스.md`: 서버 구성 정보