API / QueryRepository Map 작성 기준

원본: C:\Users\eunse\localRep\HARUON_Refectoring\src\main\java\com\haruon\groupware\**\controller, rest, mapper
리팩터링 방향:
- React REST API
- Hexagonal Architecture
- JPA/JPQL QueryRepository Adapter
목록, 검색, 통계, 화면 조합 DTO: application/{domain}/required/*QueryRepository
JPQL 구현 위치: adapter/persistence/*QueryRepositoryAdapter

REST API 초안

인증

Method	URL	설명	권한	Request	Response	주요 예외
POST	`./auth/login`	로그인	permitAll	`LoginRequest`	`LoginResponse`	`INVALID_CREDENTIALS`, `INACTIVE_EMP`
POST	`./auth/reissue`	access token 재발급	permitAll(refresh cookie)	없음	`TokenResponse`	`INVALID_REFRESH_TOKEN`
POST	`./auth/logout`	로그아웃	authenticated	없음	없음	`UNAUTHORIZED`
GET	`./auth/me/param={}`	현재 로그인 사용자 조회	authenticated	없음	`CurrentUserResponse`	`UNAUTHORIZED`

사원/부서/공통

Method	URL	설명	권한	Request	Response	주요 예외
POST	`./users`	사원 self 등록	permitAll	`EmpRegisterRequest`	없음	`DUPLICATE_LOGIN_ID`, `DUPLICATE_EMP_NO`, `INVALID_REQUEST`
GET	`./users/me/param={}`	개인정보 조회	EMPLOYEE	String empNo	`EmpInfoResponse`	`UNAUTHORIZED`
PATCH	`./users/me`	자기 개인정보 수정	EMPLOYEE	`EmpUpdateRequestBySelf`	없음	`EMP_NOT_FOUND`, `INVALID_PASSWORD`
PATCH	`./users/me/files`	자기 사원 파일 추가/교체	EMPLOYEE	`EmpFileReplaceParam`	없음	`UNSUPPORTED_FILE_EXTENSION`, `FILE_SIZE_LIMIT_EXCEEDED`
PATCH	`./users/me/files/{fileId}/active-status`	자기 사원 파일 활성 상태 변경	EMPLOYEE	`EmpFileStatusChangeParam`	없음	`FILE_NOT_FOUND`
DELETE	`./users/me/files/{fileId}`	자기 사원 파일 삭제	EMPLOYEE	없음	없음	`FILE_NOT_FOUND`
GET	`./users/param={deptId,status,keyword,page,size}`	사원 목록 조회	HR 또는 DEPT_MANAGER	없음	`PageResponse<EmpSummaryResponse>`	`ACCESS_DENIED`
GET	`./users/new/param={page,size}`	신규 등록 사원 목록 조회	HR	없음	`PageResponse<EmpSummaryResponse>`	`ACCESS_DENIED`
GET	`./users/{empId}/profile-file/param={}`	사원 프로필 파일 조회	authenticated	없음	`FileResponse`	`FILE_NOT_FOUND`
GET	`./users/{empId}/sign-file/param={}`	사원 서명 파일 조회	authenticated	없음	`FileResponse`	`FILE_NOT_FOUND`

근태/휴가 현황

Method	URL	설명	권한	Request	Response	주요 예외
GET	`./attendances/me/param={yearMonth}`	내 월별 근태 조회	EMPLOYEE	없음	`List<AttendanceResponse>`	없음
GET	`./attendances/depts/{deptId}/param={yearMonth}`	부서 월별 근태 조회	DEPT_MANAGER	없음	`List<AttendanceResponse>`	`DEPARTMENT_MISMATCH`
POST	`./attendances/check-in`	출근 기록	EMPLOYEE	`CheckInRequest`	없음	`DUPLICATE_ATTENDANCE`
PATCH	`./attendances/check-out`	퇴근 기록	EMPLOYEE	`CheckOutRequest`	없음	`CHECK_IN_RECORD_NOT_FOUND`
PATCH	`./emp-leaves/{empId}/special-grant-days`	특별휴가 조정	HR	`LeaveGrantAdjustRequest`	없음	`EMP_ANNUAL_LEAVE_NOT_FOUND`
PATCH	`./emp-leaves/{empId}/compensatory-grant-days`	대체휴무 조정	HR	`LeaveGrantAdjustRequest`	없음	`EMP_ANNUAL_LEAVE_NOT_FOUND`

기안/결재

Method	URL	설명	권한	Request	Response	주요 예외
GET	`./drafts/mine/param={keyword,page,size}`	내 기안함 조회	EMPLOYEE	없음	`PageResponse<DraftSummaryResponse>`	없음
GET	`./drafts/approvals/param={keyword,page,size}`	결재함 조회	EMPLOYEE	없음	`PageResponse<DraftSummaryResponse>`	없음
POST	`./drafts/general`	일반 기안 임시 작성	EMPLOYEE	`CommonDraftCreateRequest`	없음	`APPROVAL_LINE_REQUIRED`
POST	`./drafts/general/submissions`	일반 기안 작성 후 상신	EMPLOYEE	`CommonDraftCreateRequest`	없음	`APPROVAL_LINE_REQUIRED`
PATCH	`./drafts/general/{draftId}`	일반 기안 수정	EMPLOYEE	`CommonDraftUpdateRequest`	없음	`DRAFT_NOT_FOUND`
POST	`./drafts/{draftId}/approvals`	기안 승인	EMPLOYEE	`ApprovalProcessRequest`	없음	`ACCESS_DENIED`
POST	`./drafts/{draftId}/rejections`	기안 반려	EMPLOYEE	`RejectRequest`	없음	`ACCESS_DENIED`
DELETE	`./drafts/{draftId}/files/{fileId}`	기안 첨부파일 제거	EMPLOYEE	없음	없음	`FILE_NOT_FOUND`

게시판