¶ 시스템관리 기능
시스템관리 기능은 공통관리의 기준 시스템 정보를 등록, 조회, 수정, 삭제하기 위해 사용한다. 시스템 코드, 시스템명, 시스템 URL, 사용기간, 사용여부를 관리하며 메뉴와 약관 같은 하위 관리기능의 기준값으로 사용된다.
¶ 관련화면 및 수행메뉴얼
¶ 시스템 목록조회
| Action URL | Controller method | QueryID |
|---|---|---|
조회 /ias/sys/sysList.do |
SysPageController.sysList |
selectSysList, selectSysListCnt |
조회 /api/v1/sys/list |
SysApiController.getSysList |
selectSysList, selectSysListCnt |
전체조회 /api/v1/sys/all |
SysApiController.getAllSysList |
selectAllSysList |
등록화면 /ias/sys/sysRegist.do |
SysPageController.sysRegist |
N/A |
목록선택 /ias/sys/sysDetail.do?sysCd={sysCd} |
SysPageController.sysDetail |
selectSysDetail |
시스템 목록은 페이징 조회되며 검색조건은 시스템명 또는 시스템코드, 사용여부에 대해 수행된다.
조회 : 상단의 검색조건을 입력한 뒤 조회 버튼을 클릭하여 시스템 목록을 조회한다.
초기화 : 검색조건을 초기 상태로 되돌린다.
등록 : 등록 버튼을 클릭하여 시스템 등록 화면으로 이동한다.
상세 : 목록의 상세 버튼을 클릭하여 시스템 상세조회 화면으로 이동한다.
수정 : 목록의 수정 버튼을 클릭하여 시스템 수정 화면으로 이동한다.
삭제 : 목록의 삭제 버튼을 클릭하여 시스템 삭제를 수행한다.
¶ 시스템 상세조회
| Action URL | Controller method | QueryID |
|---|---|---|
상세조회 /ias/sys/sysDetail.do?sysCd={sysCd} |
SysPageController.sysDetail |
selectSysDetail |
상세조회 /api/v1/sys/{sysCd} |
SysApiController.getSys |
selectSysDetail |
수정화면 /ias/sys/sysModify.do?sysCd={sysCd} |
SysPageController.sysModify |
selectSysDetail |
시스템 상세조회 화면은 시스템코드 기준 단건 정보를 조회하며 등록/수정 감사정보까지 함께 확인할 수 있다.
목록 : 시스템 목록조회 화면으로 이동한다.
수정 : 수정 버튼 클릭 시 시스템 수정 화면으로 이동한다.
삭제 : 삭제 버튼 클릭 시 삭제 여부를 확인한 뒤 삭제 처리한다.
¶ 시스템 등록
| Action URL | Controller method | QueryID |
|---|---|---|
등록화면 /ias/sys/sysRegist.do |
SysPageController.sysRegist |
N/A |
저장 /api/v1/sys |
SysApiController.createSys |
insertSys |
시스템 등록 화면에서는 시스템코드, 시스템명, 시스템 URL, 사용여부, 사용 시작일, 사용 종료일, 시스템 설명을 입력해 저장한다.
- 시스템코드는 필수이며 최대 20자다.
- 시스템명은 필수이며 최대 200자다.
- 사용여부는
Y,N만 허용한다. - 동일한 시스템코드가 이미 존재하면 등록할 수 없다.
목록 : 시스템 목록조회 화면으로 이동한다.
저장 : 입력한 시스템 정보를 저장 처리한다.
¶ 시스템 수정
| Action URL | Controller method | QueryID |
|---|---|---|
수정화면 /ias/sys/sysModify.do?sysCd={sysCd} |
SysPageController.sysModify |
selectSysDetail |
수정 /api/v1/sys/{sysCd} |
SysApiController.updateSys |
updateSys |
시스템 수정 화면에서는 기존 시스템 정보를 조회한 뒤 수정 저장한다. 시스템코드는 읽기 전용이며 변경하지 않는다.
- 존재하지 않는 시스템코드는 수정할 수 없다.
목록 : 시스템 목록조회 화면으로 이동한다.
저장 : 수정한 시스템 정보를 저장 처리한다.
¶ 시스템 삭제
| Action URL | Controller method | QueryID |
|---|---|---|
삭제 /api/v1/sys/{sysCd} |
SysApiController.deleteSys |
countMenuBySysCd, countTrmsBySysCd, deleteSys |
시스템 삭제는 목록조회 화면 또는 상세조회 화면에서 수행할 수 있다. 삭제 전 연결된 메뉴 또는 약관 정보 존재 여부를 검사하며, 연관 데이터가 있으면 삭제할 수 없다.
- 연결된 메뉴가 있으면 삭제할 수 없다.
- 연결된 약관이 있으면 삭제할 수 없다.
- 존재하지 않는 시스템코드는 삭제할 수 없다.
선택 : 목록 화면의 삭제 버튼 또는 상세 화면의 삭제 버튼을 선택한다.
삭제 : 삭제 확인 후 시스템 정보를 삭제 처리한다.
¶ 관련 리소스
¶ 클래스
| 유형 | 대상소스명 | 비고 |
|---|---|---|
| Controller | src/main/java/allforland/ias/sys/web/SysPageController.java |
시스템관리 화면 요청을 처리하는 컨트롤러 클래스 |
| API Controller | src/main/java/allforland/ias/sys/web/SysApiController.java |
시스템관리 API 요청을 처리하는 컨트롤러 클래스 |
| Service | src/main/java/allforland/ias/sys/service/SysService.java |
시스템관리를 위한 서비스 인터페이스 |
| ServiceImpl | src/main/java/allforland/ias/sys/service/impl/SysServiceImpl.java |
시스템관리를 위한 서비스 구현 클래스 |
| Mapper | src/main/java/allforland/ias/sys/mapper/SysMapper.java |
시스템관리를 위한 데이터 처리 Mapper 인터페이스 |
| VO | src/main/java/allforland/ias/sys/vo/SysVO.java |
시스템관리를 위한 VO 클래스 |
| DTO | src/main/java/allforland/ias/sys/web/dto/SysRequestDTO.java |
시스템 등록/수정 요청 DTO 클래스 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/sys/sysList.jsp |
시스템 목록조회를 위한 JSP 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/sys/sysDetail.jsp |
시스템 상세조회를 위한 JSP 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/sys/sysRegist.jsp |
시스템 등록을 위한 JSP 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/sys/sysModify.jsp |
시스템 수정을 위한 JSP 페이지 |
| Query XML | src/main/resources/mapper/sys/SysMapper.xml |
시스템 조회/등록/수정/삭제를 위한 Query XML |
| SQL | docker/postgres/init/01-schema.sql |
시스템관리 테이블 생성을 위한 스키마 SQL |
| SQL | docker/postgres/init/02-data.sql |
시스템 기본데이터 적재 SQL |
¶ 클래스 다이어그램
¶ 테이블
| 테이블명 | 테이블명(영문) | 비고 |
|---|---|---|
| 시스템 정보 | afias.sys |
시스템 기본정보를 관리하는 기준 테이블 |