기관정보

시스템 > 기본설정 > 기관정보

1. 기능 개요

'시스템 > 기본설정 > 기관정보' 메뉴는 조직 또는 기관의 기본 정보를 조회, 추가, 수정, 삭제(논리적 삭제)할 수 있는 관리 화면입니다. 기관명, 대표자명, 연락처 등 상세 정보를 입력하고 노출 여부를 설정하여 시스템 내 기관 데이터를 관리합니다.

2. 주요 기능 목록

* 기관 목록 조회: 기관명(검색어)을 조건으로 기관 목록을 조회합니다.
* 기관 추가: 신규 기관 정보를 입력하여 등록합니다.
* 기관 수정: 기존 기관의 상세 정보(대표자, 연락처, 주소, 세금 신고 여부 등)를 수정합니다.
* 기관 삭제: 선택된 기관 정보를 논리적 삭제 처리합니다.
* 필터링: 그리드에서 대표자명, 전화번호, 이메일, 노출 여부 등에 대한 필터링 기능을 제공합니다.

3. 비즈니스 규칙

* 검색 조건: 기관명(instNm)이 입력된 경우, 해당 문자열이 포함된 기관을 부분 일치 검색합니다.
* 삭제 처리: 삭제 버튼 클릭 시 실제 데이터가 물리적으로 삭제되지 않으며, isDeleteYn 필드를 통해 논리적 삭제 상태가 관리됩니다. 삭제된 항목은 수정 모드에서 삭제 버튼이 활성화됩니다.
* 날짜 포맷팅: 개업일(opbizYmd) 및 폐업일(clsbizYmd)은 데이터베이스에서 YYYYMMDD 형식으로 저장되나, 화면에서는 YYYY-MM-DD 형식으로 변환하여 표시합니다.
* 전화번호 포맷팅: 전화번호(instTelno) 및 팩스번호(fxno)는 정규식을 통해 XXX-XXXX-XXXX 형식으로 자동 포맷팅되어 조회됩니다.
* NULL 처리: 사업자등록번호(brno) 및 통신판매업신고번호(crno)가 빈 문자열인 경우 데이터베이스에는 NULL로 저장됩니다.
* 조회 정렬: 조회 결과는 생성일(crt_dt) 내림차순으로 정렬됩니다.

4. 연관 테이블

* COM040M: 기관 기본 정보가 저장되는 주요 테이블입니다. 기관 코드, 명칭, 대표자, 연락처, 주소, 세금 신고 여부, 노출 여부 등 모든 기관 관련 속성을 포함합니다.

5. 접근 권한

로그인 사용자 전체 (코드상 별도의 권한 체크 로직이 명시되어 있지 않으나, /admin/ 경로이므로 일반적으로 관리자 권한이 필요함)

기관부서관리

부서관리

시스템 > 기본설정 > 부서관리

1. 기능 개요

'시스템 > 기본설정 > 부서관리' 메뉴는 조직의 부서 정보를 계층적 트리 구조로 조회하고, 부서 및 소속 인원의 등록, 수정, 삭제 등 전체 생명주기를 관리하는 기능입니다.

2. 주요 기능 목록

* 부서 목록 조회: 기관명, 부서명 조건으로 검색 및 트리(TreeGrid) 형태로 계층 구조 표시
* 부서 등록/수정: 부서 코드, 상위 부서, 사용 시작/종료일, 사용 여부 등 정보 관리
* 부서 삭제: 선택된 부서 및 해당 소속 인원 정보 일괄 삭제
* 소속 인원 관리: 선택된 부서에 소속된 직원 목록 조회 및 관리(코드 주석 처리됨)
* 상위 부서 콤보박스: 현재 선택된 부서를 기준으로 계층별 들여쓰기가 적용된 상위 부서 목록 자동 생성

3. 비즈니스 규칙

* 트리 구조 데이터 처리: 서버에서 전달된 평면 데이터(resultList)를 클라이언트 측 buildTree 함수를 통해 ID와 Parent ID 기반으로 트리 구조로 변환하여 렌더링합니다.
* 상위 부서 자동 세팅: 새 부서를 등록할 때, 현재 트리에서 선택된 행의 deptCd가 있다면 해당 부서를 자동으로 상위 부서(upprDeptCd)로 설정합니다.
* 레벨 기반 들여쓰기: 상위 부서 콤보박스 표시 시, getLevel 함수를 통해 부모 노드를 순회하며 깊이를 계산하고, 해당 레벨만큼 들여쓰기( )와 트리 아이콘(└ )을 적용하여 가독성을 높입니다.
* 데이터 정렬: 공통 코드 조회 시 ID 기준으로 오름차순 정렬(localeCompare)하여 콤보박스 데이터를 표시합니다.
* 기본값 설정: 부서 등록 시 '사용시작일'은 현재 날짜(new Date())로 기본 설정되며, 수정 모드(mod)는 'N'으로 초기화됩니다.

4. 연관 테이블

* 부서 정보 테이블 (추정): deptMngtService를 통해 접근하며, 부서 코드(deptCd), 상위 부서 코드(upprDeptCd), 부서명(deptNm), 기관 코드(instCd), 사용 여부(useAvlYn), 사용 기간(useBgnYmd, useEndYmd) 등을 포함하는 것으로 보입니다.
* 부서 소속 인원 테이블 (추정): DeptUsrMngtList 관련 서비스 메서드(SaveDeptUsrMngtList, DeleteDeptUsrMngtList)가 존재하여, 부서와 사용자 간의 매핑 정보를 저장하는 테이블이 존재합니다.
* 공통 코드 테이블 (Com043M): Com043MRepository 및 CmnCodeMngDAO를 통해 기관 정보 등 공통 코드 데이터를 조회합니다.

5. 접근 권한

* 로그인한 전체 사용자 (코드상 별도의 권한 체크 로직이나 어노테이션이 명시되어 있지 않음)