¶ 사용자관리 기능
사용자관리 기능은 사용자 기본정보를 조회, 등록, 수정, 삭제하기 위해 사용한다. 사용자 ID, 사용자명, 부서, 연락처, 이메일, 사용여부를 관리하며 권한관리와 권한신청 기능의 기준 사용자 정보로 사용된다.
¶ 관련화면 및 수행메뉴얼
¶ 사용자 목록조회
| Action URL | Controller method | QueryID |
|---|---|---|
조회 /ias/user/userList.do |
UserPageController.userList |
selectUserList, selectUserCnt |
조회 /api/v1/user/list |
UserApiController.getUserList |
selectUserList, selectUserCnt |
상세이동 /ias/user/userDetail.do?userId={userId} |
UserPageController.userDetail |
selectUserDetail |
사용자 목록은 상태, 부서코드, 사용자명 또는 사용자ID 조건으로 조회한다. 목록 화면에서는 상세조회만 직접 제공한다.
조회 : 상태, 부서코드, 사용자명 또는 사용자ID를 입력한 뒤 조회 버튼을 클릭하여 사용자 목록을 조회한다.
초기화 : 검색조건을 초기 상태로 되돌린다.
상세 : 목록의 상세 버튼을 클릭하여 사용자 상세조회 화면으로 이동한다.
¶ 사용자 상세조회
| Action URL | Controller method | QueryID |
|---|---|---|
상세조회 /ias/user/userDetail.do?userId={userId} |
UserPageController.userDetail |
selectUserDetail |
상세조회 /api/v1/user/{userId} |
UserApiController.getUser |
selectUserDetail |
사용자 상세조회 화면은 사용자 고유 ID, 사용자 ID, 부서정보, 연락처, 감사정보를 단건으로 조회한다.
목록 : 사용자 목록조회 화면으로 이동한다.
¶ 사용자 등록
| Action URL | Controller method | QueryID |
|---|---|---|
등록화면 /ias/user/userRegist.do |
UserPageController.userRegist |
N/A |
부서선택 팝업 /ias/dept/deptSelectPopup.do?target=deptCd |
DeptPageController.deptSelectPopup |
N/A |
저장 /api/v1/user |
UserApiController.createUser |
insertUser |
사용자 등록 화면에서는 사용자 ID, 사용자명, 이메일, 연락처, 사용여부, 부서를 입력해 저장한다. 부서 선택은 부서 선택 팝업으로 수행한다.
- 사용자 ID는 필수이며 최대 100자다.
- 사용자명은 필수이며 최대 200자다.
- 이메일은 화면에서 필수 입력이며 이메일 형식이어야 한다.
- 사용여부는
Y,N만 허용한다. - 동일한 사용자ID가 이미 존재하면 등록할 수 없다.
부서선택 : 부서 선택 버튼을 클릭하여 부서 선택 팝업을 연다.
목록 : 사용자 목록조회 화면으로 이동한다.
저장 : 입력한 사용자 정보를 저장한다.
¶ 사용자 수정
| Action URL | Controller method | QueryID |
|---|---|---|
수정화면 /ias/user/userModify.do?userId={userId} |
UserPageController.userModify |
selectUserDetail |
부서선택 팝업 /ias/dept/deptSelectPopup.do?target=deptCd |
DeptPageController.deptSelectPopup |
N/A |
수정 /api/v1/user/{userId} |
UserApiController.updateUser |
updateUser |
사용자 수정 화면에서는 기존 사용자 정보를 조회한 뒤 수정 저장한다. 사용자 ID는 읽기 전용이며 변경하지 않는다.
- 존재하지 않는 사용자ID는 수정할 수 없다.
- 사용자명은 필수다.
- 이메일은 화면에서 필수 입력이며 이메일 형식이어야 한다.
부서선택 : 부서 선택 버튼을 클릭하여 부서 선택 팝업을 연다.
목록 : 사용자 목록조회 화면으로 이동한다.
저장 : 수정한 사용자 정보를 저장한다.
¶ 사용자 삭제
| Action URL | Controller method | QueryID |
|---|---|---|
삭제 /api/v1/user/{userId} |
UserApiController.deleteUser |
deleteUserRoleMappings, deleteUser |
사용자 삭제는 현재 화면에 별도 삭제 버튼을 제공하지 않으며 삭제 API로 수행한다. 삭제 시 연결된 사용자 권한 매핑 정보가 함께 정리된다.
- 존재하지 않는 사용자ID는 삭제할 수 없다.
삭제 : 사용자ID 기준으로 삭제 API를 호출해 사용자 정보를 삭제한다.
¶ 관련 리소스
¶ 클래스
| 유형 | 대상소스명 | 비고 |
|---|---|---|
| Controller | src/main/java/allforland/ias/user/web/UserPageController.java |
사용자관리 화면 요청을 처리하는 컨트롤러 클래스 |
| API Controller | src/main/java/allforland/ias/user/web/UserApiController.java |
사용자관리 API 요청을 처리하는 컨트롤러 클래스 |
| Service | src/main/java/allforland/ias/user/service/UserService.java |
사용자관리 서비스 인터페이스 |
| ServiceImpl | src/main/java/allforland/ias/user/service/impl/UserServiceImpl.java |
사용자관리 서비스 구현 클래스 |
| Mapper | src/main/java/allforland/ias/user/mapper/UserMapper.java |
사용자관리 데이터 처리 Mapper 인터페이스 |
| VO | src/main/java/allforland/ias/user/vo/UserVO.java |
사용자관리 VO 클래스 |
| DTO | src/main/java/allforland/ias/user/web/dto/UserRequestDTO.java |
사용자 등록/수정 요청 DTO 클래스 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/user/userList.jsp |
사용자 목록조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/user/userDetail.jsp |
사용자 상세조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/user/userRegist.jsp |
사용자 등록 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/user/userModify.jsp |
사용자 수정 페이지 |
| Query XML | src/main/resources/mapper/user/UserMapper.xml |
사용자 조회 및 저장 Query XML |
| SQL | docker/postgres/init/01-schema.sql |
사용자 테이블 생성을 위한 스키마 SQL |
| SQL | docker/postgres/init/02-data.sql |
사용자 기본데이터 적재 SQL |
¶ 클래스 다이어그램
¶ 테이블
| 테이블명 | 테이블명(영문) | 비고 |
|---|---|---|
| 사용자 정보 | afias."user" |
사용자 기본정보를 관리하는 기준 테이블 |