시설관리

관리 > 기본설정 > 시설관리

1. 기능 개요

기관별 시설(공간 또는 사물함)의 목록을 조회하고, 신규 등록 및 수정을 관리하는 메뉴입니다. 시설 유형에 따라 필수 입력 항목이 동적으로 변경되며, 운영 가능 여부를 관리합니다.

2. 주요 기능 목록

* 조회: 기관코드(instCd)와 시설분류코드(opplcSeCd)를 조건으로 시설 목록을 조회합니다.
* 신규 등록: '신규등록' 버튼 클릭 시 폼을 초기화하고 기본값(운영 시작/종료일 등)을 설정합니다.
* 수정: 그리드에서 행을 선택하면 우측 패널에 상세 정보를 표시하고 수정할 수 있습니다.
* 동적 폼 제어:
* 시설 유형이 '공간(008)'인 경우: '공간명', '면적(opplcAr)' 입력, '사용금액(useAmt)' 숨김.
* 시설 유형이 '사물함(006)'인 경우: '사물함명', '사용금액(useAmt)' 입력, '면적(opplcAr)' 숨김.
* 저장: 폼 유효성 검사를 수행한 후 데이터를 저장합니다.

3. 비즈니스 규칙

* 시설 유형별 필드 유효성:
* opplcSeCd가 '008'(공간)일 때: opplcAr(면적)은 필수, useAmt(금액)는 선택.
* opplcSeCd가 '006'(사물함)일 때: useAmt(금액)는 필수, opplcAr(면적)은 선택.
* 기본값 자동 설정:
* 신규 등록 시 rntAvlYn(대관/대여 여부)은 기본값 'Y'로 설정됩니다.
* 운영 시작일(useBgnYmd)은 2023년 1월 1일, 종료일(useEndYmd)은 2030년 12월 31일로 기본 설정됩니다.
* 공간('008')인 경우 div1Cd는 '대관' 관련 코드로 자동 설정되며 비활성화됩니다.
* 사물함('006')인 경우 div1Cd는 '사물함' 관련 코드로 자동 설정되며 비활성화됩니다.
* 권한에 따른 필드 제어:
* 슈퍼 관리자(suAdmYn === 'Y')인 경우에만 instCd(기관코드) 수정이 가능합니다.
* 신규 등록 시 opplcSeCd(시설분류)는 항상 비활성화됩니다.
* 데이터 필터링: 조회 시 USE_AVL_YN이 'N'인 데이터는 제외됩니다.
* 운영 여부 판정: Oracle 기준, 현재 날짜가 use_bgn_ymd와 use_end_ymd 사이에 있을 경우 use_yn이 'Y'로 반환됩니다.

4. 연관 테이블

* COM053M: 운영시설정보 메인 테이블 (시설 ID, 이름, 분류, 위치, 면적, 금액, 운영 기간 등 저장)
* COM040M: 기관정보 테이블 (기관명 조회용 조인)
* COM033M: 카테고리 테이블 (DIV1, DIV2, DIV3 등 분류명 조회용 조인)
* COM032M: 공통코드 테이블 (시설분류, 위치구분, 위치, 층수 등의 코드명 조회용 조인)

5. 접근 권한

로그인 사용자 전체 (단, 슈퍼 관리자 권한에 따라 기관코드 수정 가능 여부 분기)

단말기관리

관리 > 기본설정 > 단말기관리

1. 기능 개요

단말기(디바이스)의 목록을 조회하고, 상세 정보를 수정하거나 논리적 삭제를 수행하는 관리 화면입니다. 신규 등록 기능은 UI 상에 버튼이 존재하나, 실제 폼 처리 로직은 별도 JSP(deviceMngInfoTab.jsp)에 위임되어 있으며, 현재 제공된 코드에서는 조회, 수정, 삭제가 주요 동작입니다.

2. 주요 기능 목록

* 단말기 목록 조회: 기관 코드(instCd)를 기준으로 삭제되지 않은 단말기 목록을 조회합니다.
* 조회 조건 필터: 단말기명, 설명, 유형, 장소, 사용 여부, 최종 인증일, 수정일, 기관, 고유번호 등으로 필터링 가능합니다.
* 단말기 정보 수정: 선택된 단말기의 이름, 설명, 사용 여부, 장소 등을 수정하고 수정자 정보를 기록합니다.
* 단말기 삭제(논리적 삭제): 단말기 상태를 삭제(Y)로 변경하며, 배너 노출 장소 테이블(com020t)에서 해당 단말기 고유번호를 제거합니다.
* 신규 등록 준비: '신규' 버튼 클릭 시 그리드 행 추가 및 폼 초기화(모드 'I', 기관코드, 생성자 설정)를 수행합니다.

3. 비즈니스 규칙

* 데이터 접근 제한: 조회 및 수정/삭제 시 반드시 현재 로그인한 사용자의 기관 코드(instCd)와 일치하는 데이터만 처리됩니다.
* 논리적 삭제: 실제 데이터 삭제(DB 삭제)가 아닌, del_yn 필드를 'Y'로 변경하여 삭제 처리합니다.
* 배너 연동 삭제: 단말기를 삭제할 경우, 배너 설정 테이블(com020t)의 exp_places 배열에서 해당 단말기 고유번호(serialNumber)를 자동으로 제거합니다.
* 수정 이력 추적: 수정 시 현재 시간(current_timestamp)과 수정자 ID(updUsr)를 자동 기록합니다.
* 신규 등록 중 제한: 신규 등록 모드(mod: "I") 진입 시 다른 행 선택이 비활성화되며, 저장 또는 취소 전까지는 다른 데이터를 선택할 수 없습니다.
* 기본값 자동 설정: 신규 등록 시 기관 코드(instCd)와 생성자(crtUsr)는 세션 정보에서 자동으로 채워집니다.

4. 연관 테이블

* device_info_master: 단말기 기본 정보(이름, 설명, 고유번호, 사용여부, 등록/수정일 등)를 저장하는 메인 테이블.
* com032m: 단말기 유형 코드 목록을 조회하기 위한 코드 테이블 (code_id: 'API001').
* com053m: 단말기 설치 장소(장소명) 정보를 조회하기 위한 테이블.
* cus010m (또는 CUS310M): 사용자(생성자, 수정자) 이름을 조회하기 위한 회원/사용자 테이블.
* com040m: 기관(기관명) 정보를 조회하기 위한 테이블.
* com020t: 배너 노출 장소 설정 테이블. 단말기 삭제 시 exp_places 배열에서 해당 단말기 번호를 제거하는 대상 테이블.

5. 접근 권한

로그인 사용자 전체 (세션에서 loginVO를 참조하여 기관 코드 및 사용자 ID를 추출하여 사용하므로, 로그인된 모든 사용자가 해당 기관의 데이터에 접근 가능함. 별도의 별도 권한 체크 로직은 코드 상에서 확인되지 않음)

IP관리

관리 > 기본설정 > IP관리

1. 기능 개요

관리자가 시스템 접근을 허용하거나 제한할 특정 IP 주소와 적용 대상(적용지점)을 관리하는 기능입니다. 신규 IP 등록 시 중복 체크를 수행하며, 기존 등록된 IP 정보의 조회, 수정, 삭제를 지원합니다.

2. 주요 기능 목록

* 조회: IP 주소 및 적용지점 코드를 조건으로 검색하여 목록을 표시합니다.
* 신규 등록: IP 주소와 적용지점을 입력하여 새로운 접근 권한 규칙을 추가합니다.
* 중복 확인: 등록 또는 수정 시, 동일한 적용지점에 이미 등록된 IP가 있는지 확인합니다.
* 삭제: 선택된 IP 접근 권한 규칙을 삭제합니다.
* 수정: 기존 IP 정보의 사용 여부 등 상세 내용을 수정합니다 (IP 주소와 적용지점 코드는 수정 불가).

3. 비즈니스 규칙

* 중복 방지: 동일한 instCd(기관코드) 및 trgtSeCd(적용지점 코드)에 대해 동일한 ipAddr(IP 주소)가 중복 등록될 수 없습니다.
* 고정값 유지: IP 주소(ipAddr)와 적용지점 코드(trgtSeCd)는 등록 후 수정할 수 없으며, 조회 시 비활성화 처리됩니다.
* 기관 격리: 각 기관(instCd)별로 IP 관리 데이터가 분리되어 관리됩니다.
* 인증 필수: 모든 API 요청은 인증된 관리자 계정(LoginVO)을 필요로 하며, 미인증 사용자는 접근이 거부됩니다.

4. 연관 테이블

* SYS040 (가정): IP 접근 권한 관리 테이블. IP 주소, 적용지점 코드, 사용 여부, 생성/수정 일자 및 사용자 정보를 저장합니다. (SQL 매퍼의 sys040 별칭 및 컬럼 패턴 추정)
* COM094 (코드 테이블): 적용지점 구분 코드 목록을 정의하는 코드 테이블입니다.

5. 접근 권한

로그인한 관리자 전체 (단, KwsUserDetailsHelper를 통해 인증된 사용자만 API 접근 가능)

기타비용 항목관리

관리 > 기본설정 > 기타비용 항목관리

1. 기능 개요

'관리 > 기본설정 > 기타비용 항목관리' 메뉴는 기관별(또는 부서별) 수입/지출 항목 코드를 관리하는 기능입니다. 사용자가 항목을 추가, 수정, 삭제할 수 있으며, 조회 조건에 따라 항목 목록을 필터링하고 상세 정보를 편집할 수 있습니다.

2. 주요 기능 목록

* 목록 조회: 기관 코드(instCd)를 기준으로 기타비용 항목 목록을 조회합니다.
* 검색/필터:
* 조회 조건으로 기관 코드(instCd)를 선택하여 목록을 갱신합니다.
* 그리드 내에서 '수입/지출', '항목명', '사용상태' 컬럼에 대한 필터링 기능을 제공합니다.
* 추가 (Create): '추가' 버튼을 클릭하여 새 항목 등록 모드를 활성화합니다.
* 수정 (Read/Update): 그리드 행을 선택하면 우측 패널에 해당 항목의 상세 정보를 표시하며 수정이 가능합니다.
* 삭제 (Delete): 그리드 행의 '삭제' 버튼을 클릭하여 해당 항목을 삭제합니다. 삭제 전 확인 대화상자가 표시됩니다.
* 편집 취소/닫기: 우측 편집 패널의 닫기 버튼을 클릭하여 편집 모드를 종료합니다.

3. 비즈니스 규칙

* 기관별 분리 관리: 데이터는 기관 코드(instCd)별로 구분되어 조회 및 관리됩니다.
* 항목 코드 수정 불가: 기존에 등록된 항목(mod가 'Y'인 경우)의 항목 코드(itmCd)는 수정할 수 없으며 비활성화됩니다. 신규 추가(mod가 'N') 시에만 코드 입력이 가능합니다.
* 삭제 권한 및 확인:
* 삭제 버튼 클릭 시 "삭제 하시겠습니까?"라는 확인 대화상자가 표시됩니다.
* 삭제 요청 시 instCd와 itmCd를 파라미터로 전달하여 서버에 삭제 요청을 보냅니다.
* 에디터 상태 관리:
* 편집 패널을 닫을 때, 현재 편집 중인 항목의 상태(mod)가 'N'(신규 추가 중)인 경우 그리드에서 해당 임시 행을 제거합니다.
* 기존 데이터('Y')를 편집 중일 경우 닫기 시 데이터는 유지됩니다.
* 초기화 로직: 삭제 또는 추가 버튼 클릭 시 편집 폼(editForm)의 값이 초기화됩니다.

4. 연관 테이블

* 기타비용 항목 관리 테이블 (추정):
* 주요 컬럼: instCd (기관코드), itmCd (항목코드), ioCdNm (수입/지출 구분), itmNm (항목명), itmAmt (금액), useYnNm (사용여부), itmDesc (항목설명), mod (수정구분/신규구분)
* 용도: 기타비용 항목의 기본 정보 및 상태 관리.
* 공통 코드 테이블 (추정):
* 용도: ioCdNm(수입/지출 구분), useYnNm(사용상태) 등의 코드 목록을 조회하는 데 사용됨 (codeIdList, codeList 참조).

5. 접근 권한

* 로그인 사용자 전체 (단, 기관 코드 입력 필드가 일반 사용자의 경우 readOnly 및 disabled 처리됨)
* 코드 내 suAdmYn !== 'Y' 조건을 통해 특정 관리자 권한(suAdmYn이 'Y')이 없는 사용자는 기관 코드 수정을 제한하는 것으로 보입니다.