1. 프로젝트 개요

• 프로젝트명 : HRBANK
• 프로젝트 목표 : 기업의 인적자원(HumanResource)를 체계적으로 관리,모니터링하기 위한 HR Manage System을 구현
• 핵심 기능
  • 부서관리
    • 부서 등록, 수정 및 삭제
    • 직원 소속 부서 조회
      • 조건에 따른 조회 및 정렬
  • 직원관리
    • 직원 등록,수정,삭제
    • 직원 조회
      • 조건에 따른 조회 및 정렬
      • 직원 정보 통계
  • 직원 이력 관리
    • 직원 정보수정이력 관리
      • 입사,휴직,퇴직,직급변경 등 직원정보 변경 히스토리 생성
      • 단일직원 혹은 조건으로 검색한 직원의 히스토리 목록 조회
  • 데이터 백업
    • BATCH를 통한 정기적인 데이터 백업
    • 사용자의 요청에 따른 수동 백업
    • 백업된 데이터를 파일로 저장
  • 파일 입출력
    • 사용자 사진, 백업 데이터 입출력 등 파일 입출력을 제어
  • 대시보드
    • 직원 통계
    • 직원이력 통계
    • 백업관리 등 요약정보를 한 페이지로 노출

2. 담당한 작업

• 역할 : 부서 관리 도메인 구현
  • 부서 생성
  • 부서 수정
  • 부서 삭제
  • 부서 조회
    • 이름,설립일에 따른 오름/내림차순의 4가지 정렬 방식 적용
    • 커서 방식의 무한 스크롤 페이지네이션 구현
    • 이름, 설명에 대한 검색조회 기능 구현

3. 기술적 성과

• 더미 데이터 작성 후 신규 데이터 추가 ,삭제 등 작업시 index 오류 발견
• 데이터베이스 내부적으로 저장된 index값과 데이터 간의 불일치로 인한 문제 확인
• index의 sequence값을 현재 입력된 값에 맞추어 초기화하여 해결

SELECT setval(
  pg_get_serial_sequence('departments', 'id'),
  (SELECT COALESCE(MAX(id), 1) FROM departments)
);

4. 문제점 및 해결 과정

1) Dto 필드명 오기입으로 인한 프론트 연동불가 문제

• 문제: 부서관리 메뉴 진입시 Response값은 정상적으로 조회되나 페이지가 표시되지 않는 에러 발생

  

• 원인 분석

  • 잘못된 필드명 기입

    package com.ohgiraffers.hrbank.dto.response;
    
    import java.util.List;
    
    public record DepartmentPageResponse<T>(
        /* List<T> contents,  문제의 코드*/
        List<T> content, /* 수정된 코드 */
        String nextCursor,
        Long nextIdAfter,
        int size,
        long totalElements,
        boolean hasNext
    ){}
    

  • content 필드를 반환해야 하나 contents로 반환하여 문제 발생

  해결방법

  • 제공된 Swagger 명세를 참고하여 필드명 확인

    

  배운 점

  • API명세를 꼼꼼하게 확인하지 않으면 프론트엔드와 연동이 안 될 수 있음
  • 서로 주고받는 필드,변수명은 정확해야 함.

2) 부서별 조건조회 시 tatalElements 미반환