UI/UX Screen Specification

① 주요 UI 컴포넌트

• 스토리지 KPI 카드: 전체 현장의 총 한도 용량 대비 누적 사용 용량 실시간 합산 표시 (예: 💾 9.70 GB / 20 GB).
• 접속자 KPI 카드: 현재 소켓 서버 연결 세션 수 노출.
• 압축작업 KPI 카드: Redis(BullMQ) 내 대기중인 압축 건수.
• 현장별 스토리지 사용 현황: 각 프로젝트 ID/명칭, 게이지바 및 사용량 정보(GB / 백분율% / 파일수량개) 동시 렌더링.

② 실시간 접속 현황 테이블 사양

① 프로젝트 목록 테이블 사양 (좌측 카드)

출력 컬럼: NO | 프로젝트 ID | 현장명 | 카테고리 | 용량 제한(GB) | 상태 | 관리(수정/삭제)

• 행 클릭 시, 우측의 '참여 권한 사용자 목록'이 해당 프로젝트 정보로 자동 리바인딩됩니다.
• 삭제 제한: 관련 테이블(tb_data, tb_official_doc_file, tb_banner_notice 등)에 현장 ID 사용 이력이 있으면 삭제 불가능하며 경고 메시지가 발생합니다.
• 신규 프로젝트 등록 및 수정 모달 (projectModalOverlay): 프로젝트 ID(수정 시 Readonly), 프로젝트명, 단축명, 카테고리 Select, 스토리지 제한(GB), 상태를 편집합니다.

② 참여 권한 사용자 목록 (우측 카드 - 병합 영역)

출력 컬럼: NO | 사용자 ID | 이름 | 부서/직급 | 권한 등급 | 작업(배정제외)

• 권한 등급 변경: 인라인 셀렉터(Admin, Sub-Master, Worker, Viewer)로 권한 레벨 즉시 업데이트.
• 사용자 배정 추가 팝업 모달 (assignModalOverlay): 현재 현장에 미배정된 사용자들을 체크박스로 다중 선택하여 일괄 추가합니다. 또한 목록 선택식을 지원하기 위해 우측 하단 배정 대기 목록에서도 '즉시 배정' 단축 버튼을 제공합니다.

① 배너 공지 등록 폼

• 입력 필드: 대상 프로젝트 선택(특정 현장 또는 전체 현장 'all' 매핑), 등록일(임의 편집 지원), 시작일, 종료일, 공지 자막 텍스트.
• 송출 등록 제출 시, 오늘 일자와 비교하여 즉시 이력에 추가되고 상태 배지가 실시간 부여됩니다.

② 이력 목록 필터 및 이력 테이블

• 검색 필터: 송출 상태(전체, 송출중, 예약됨, 만료) 및 등록일(from ~ to) 날짜 범위 지정 검색.
• 테이블 명세: NO | 등록일 | 대상 프로젝트 | 공지 내용 | 시작일 | 종료일 | 송출 상태 | 작업
• 송출 중지 통제: 아직 기간이 유효한 행(송출중, 예약됨)에만 [송출 중지] 버튼이 노출 및 활성화되며, 이미 만료된 이력은 [중지 완료] 비활성 텍스트로 대체하여 이중 제어를 차단합니다.

① 사용자 계정 목록 (좌측 카드)

출력 컬럼: NO | 아이디 | 이름 | 소속/직급 | 그룹 | 상태 | 관리(수정/삭제)

• 행 클릭 시, 해당 사용자가 참여하고 있는 프로젝트 리스트가 우측 카드에 즉시 바인딩됩니다.
• 삭제 제한: 권한 테이블(tb_permission)에 현장 배정/참여 권한 정보가 등록되어 있으면 삭제가 불가능하며 경고 메시지가 발생합니다.
• 사용자 등록 및 수정 모달 (userModalOverlay): 아이디(수정 시 Readonly), 패스워드, 이름, 회사명, 부서, 직급, 권한 그룹 지정 select, 재직 상태(재직/퇴직잠금) 지정.

② 권한부여 프로젝트 목록 (우측 카드)

출력 컬럼: NO | 프로젝트 ID | 프로젝트명 | 부여 권한 등급

① 감사 로그 목록 사양

출력 컬럼: NO | 일시 | 프로젝트 | 사용자 ID | 접속 IP | 조작 액션 | 조작 대상 경로(코드박스 스타일)

• 필터링 항목: 사용자 ID 검색 입력란, 조작 액션 Dropdown, 검색 기능.

① 시스템 공통 자동 삭제 정책 설정 폼 [글로벌 정책 공통화]

• 입력 필드: 정책 활성화 여부(Toggle/Select), 최소 유지 파일 개수 기준(숫자 입력), 자동 삭제 제한 기한(일) (숫자 입력).
• 글로벌 통합: 기존의 프로젝트 개별 Dropdown은 완전히 배제하고, 전체 현장에 동일하게 일괄 반영합니다.

② 보존 정책 실시간 요약 (Dynamic Summary)

• 폼의 입력값을 변경하는 즉시 요약 영역 텍스트가 시나리오 문구로 동적 조합되어 나타납니다.
• 예: "현재 전체 공통 설정에 따라, 각 현장의 보관 파일 수가 100개 미만이고 30일이 지나면 자동 삭제 배치 스케줄러가 작동합니다."

③ 자동 삭제 처리 이력 테이블 사양

출력 컬럼: NO | 자동 처리 일자 | 프로젝트 ID | 삭제 처리 폴더 경로 | 적용 기준 | 처리 결과(성공 배지)

• 정책 값 저장 완료 시 이력 로그의 대상 프로젝트 ID 자리에는 'SYSTEM'이 기입됩니다.

① 대분류 코드 마스터 (상단 카드)

출력 컬럼: NO | 대분류 코드 | 대분류 코드명 | 사용 | 관리(수정/삭제)

• 행을 선택(click)하면 해당 행이 하이라이트(selected)되며, 하단의 세부 코드 그리드가 동적으로 새로고침됩니다.
• 대분류 등록 및 수정 모달 (codeMasterModalOverlay): 대분류 코드, 명칭, 사용여부, 비고 설명 입력.

② 세부 소분류 코드 목록 (하단 카드)

출력 컬럼: NO | 소분류 코드 | 조합 코드 (base_code) | 코드 명칭 | 정렬 순서 | 사용 | 관리(수정/삭제)

• 유효성 방어 차단: 상단 대분류 테이블에서 행을 클릭하여 선택하지 않은 상태에서는 하단의 [➕ 세부코드 등록] 버튼이 강제 비활성화(disabled)되며, 팝업 접근 시 안내 팝업 및 경고 텍스트("상단에서 대분류 코드를 선택해 주세요.")를 노출합니다.
• 조합 코드(base_code): 소분류 생성 완료 제출 시, 대분류코드_소분류코드 형태로 자동 결합되어 저장됩니다.
• 삭제 제한 (RESTRICT): 마스터 대분류 코드를 삭제할 경우, 하위 세부 코드(code_detail)가 존재하면 대분류 삭제가 차단되고 경고 메시지를 노출합니다. (세부 코드가 먼저 삭제되어 비어있을 때만 대분류 삭제 가능)