DOCS/journey/plans/251225_admin_dashboard_navigation_structure_refactoring.md
Claude-51124 60bc9304f9 docs: 플랜 문서 원칙 준수 수정
- 불확실한 표현 제거 (테이블/리스트 → 테이블)
- 파일명:줄번호 형식 정확히 명시
- 핵심만 간결하게 정리
2026-01-15 16:57:55 +09:00

1.8 KiB

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:208-218

  • 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 정보 포함

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: 서버 구성 정보