🖥️ 관리자 화면(Admin Panel) 필수 기능 설계 명세표

※ 이 파일을 Excel에서 [파일] -> [열기]로 실행하거나, 표 전체를 복사하여 Excel 시트에 붙여넣으시면 서식과 셀 구조가 그대로 유지되어 열립니다.

대분류 메뉴명 상세 기능 명세 추가 고려사항 (고급 기능)
프로젝트 관리 프로젝트 등록 및 설정 신규 현장/공구의 생성 및 수정, 프로젝트별 용량 제한(storage_byte) 설정 및 잠금 토글(is_active) 관리 비공개/보안(Secret) 폴더에 대한 일반 사용자의 접근 신청 결재 및 임시 승인 처리
프로젝트 관리 실시간 배너 공지 대시보드 상단 마르퀴 띠배너 공지사항(banner_notice) 등록 및 소켓 기반 실시간 송출 제어 배너 공지 예약 노출 설정 및 노출/송출 이력 관리
사용자 권한 관리 사용자 계정 제어 사용자 계정 등록, 정보(부서/직급) 수정, 비밀번호 재설정 및 퇴사자 계정 잠금(is_resigned) 처리 외부 SSO(Sentinel) 계정 연동 및 중복 로그인 차단 옵션 관리
사용자 권한 관리 프로젝트 권한 배정 현장별 참여 유저 목록 배정 및 권한 등급(Master/Sub-Master/Worker/Viewer) 마우스 클릭 지정 폴더 수준의 세부 접근 제어 리스트(ACL) 추가 연동
서버 및 리소스 모니터링 용량 분석 현황 현장별 누적 스토리지 사용량, 남은 용량 및 파일/폴더 개수 대시보드 시각화 스토리지 임계값(예: 90%) 도달 시 관리자 자동 경고 알림
서버 및 리소스 모니터링 압축 다운로드 관리 비동기 폴더 압축 다운로드(BullMQ) 작업의 진행 현황 모니터링 및 대기열 제어 임시 보존 기간이 지난 압축 임시파일 자동/일괄 영구 삭제를 통한 디스크 확보
시스템 감사 및 통계 감사 로그 조회 파일 삭제, 이동, 다운로드 등 민감한 조작 행위(tb_log)의 날짜/유저/활동별 필터 검색 감사 로그 이력 보고서 인쇄 및 엑셀 백업 다운로드
시스템 감사 및 통계 행동 분석 및 통계 사용자 UI 클릭 로그(tb_click_log) 기반 최다 접근 메뉴 및 최다 조회 도면/문서 사용 현황 분석 AI 요약 서비스(Gemini API) 호출 제한량(Quota) 관리 및 비용 통제
실시간 접속자 실시간 접속 현황 현재 소켓 연결된 동시 접속 유저 목록 및 접속 IP와 현재 탐색 중인 아카이브 경로 실시간 표출 특정 유저 강제 소켓 연결 끊기(Kick) 기능
시스템 환경 및 정책 관리 보관 및 삭제 정책 설정 기존 pageRenderer.js에 하드코딩된 '최소 유지 파일 개수(3개)' 및 '보존 기간(15일)' 임계치를 DB화하여, 관리자 화면에서 프로젝트별/글로벌 동적 설정 기능 제공 tb_project 테이블에 limit_file_count 및 limit_days 컬럼을 연동하여 프론트엔드가 변경된 기준값으로 실시간 바인딩되도록 API 구조 개선