Admin Dashboard 비즈니스 통합 계획

날짜: 2025-12-04 목표: 인프라 모니터링 → 비즈니스 관리 도구 확장

현재 상태

기존 기능 (4개 탭)

대시보드: CPU/메모리/디스크/업타임
컨테이너: Docker 관리, 로그 조회
서비스: Nginx 상태, Git 활동
로그: 시스템 로그

문제점

main_db 미연결 (user/team/robeing 데이터 접근 불가)
admin_routes.py 1053줄 (권장 300줄 초과)
비즈니스 기능 전무

개선 계획

1. FastAPI 계층 분리

현재: admin_routes.py 1053줄 (모든 로직 혼재)

목표 구조:

backend/
├── routers/
│   ├── system.py      # 기존 기능 (~300줄)
│   ├── users.py       # 사용자/팀 관리
│   └── robeings.py    # 로빙/스킬 관리
├── services/
│   ├── user_service.py
│   └── robeing_service.py
└── state/
    ├── user_repository.py    # main_db 연결
    └── robeing_repository.py

원칙: router → service → repository (311_FastAPI_구조_원칙.md)

2. 신규 탭 3개

탭 1: 사용자/팀

테이블: user/team 목록, 검색/필터
컬럼: email, name, metadata(nickname/position), is_active, last_login_at
액션: 편집(metadata), 상세(OAuth 상태), 비활성화
통계: 총 사용자, 활성 사용자, 팀별 분포

탭 2: 로빙

테이블: robeing 목록 (team, name, level)
시각화: 레이더 차트(5개 stats), 레벨 분포
통계: 총 로빙, 평균 레벨, 팀별 활동량

탭 3: 스킬/의도

대시보드: 의도 분류 통계, 스킬 실행 횟수
차트: 시간대별 히트맵, 의도 분포 파이
테이블: rb_news, team_document, ir_deck_evaluations

3. 성능 최적화

병렬 처리: asyncio.gather()로 다중 DB 조회 동시 실행 페이지네이션: limit/offset (기본 50건)

구현 단계

admin_routes.py → routers/system.py 분리
Repository/Service 레이어 생성
main_db 연결 추가
3개 신규 router 추가
Frontend 3개 탭 추가

참고

311_FastAPI_구조_원칙.md
troubleshooting/251117_admin_dashboard_standard_deployment_refactoring.md

2.2 KiB Raw Blame History