(선택) Transaction 활용

[KAPUIST]

📋 프로젝트 기본 세팅

역할 인가 Middleware

인증을 통과한 후 접근 권한을 검증합니다.

1. 요청 정보

   • [x] 사용자 정보는 인증 Middleware(req.user)를 통해서 전달 받습니다.
   • [x] 허용 역할은 Middleware 사용 시 배열로 전달 받습니다.

   app.patch(
     '/resume/:id/status',
     requireRoles(['**RECRUITER'**]), 
     (req, res, next) => {
       // TODO: 지원 상태 변경 API
     }
   );

2. 유효성 검증 및 에러 처리

   • [x] 허용 된 역할이 아닌 경우 - “접근 권한이 없습니다.”

3. 반환 정보

   • [x] 반환없이 다음 동작을 진행합니다.

이력서 지원 상태 변경 API (🔐 AccessToken 인증, 역할 인가 필요)

⚠️ 이력서 로그 저장을 위한 스키마 정의가 필요합니다.

채용 담당자가 지원자의 이력서 지원 상태를 변경하고, 이때 이력서 로그를 함께 생성합니다.

1. 요청 정보
   • [x] 사용자 정보는 인증 Middleware(req.user)를 통해서 전달 받습니다.
   • [x] 이력서 ID를 Path Parameters(req.params)로 전달 받습니다.
   • [x] 지원 상태, 사유를 Request Body(**req.body**)로 전달 받습니다.
2. 유효성 검증 및 에러 처리
   • [x] 지원 상태가 없는 경우 - “변경하고자 하는 지원 상태를 입력해 주세요.”
   • [x] 사유가 없는 경우 - “지원 상태 변경 사유를 입력해 주세요.”
   • [x] 유효하지 않은 지원 상태를 입력 한 경우 - “유효하지 않은 지원 상태입니다.”
   • [x] 이력서 정보가 없는 경우 - “이력서가 존재하지 않습니다.”
3. 비즈니스 로직(데이터 처리)
   • [x] 이력서 정보 수정과 이력서 로그 생성을 Transaction으로 묶어서 실행합니다.
4. 반환 정보
   • [x] 생성 된 이력서 로그 정보(이력서 로그 ID, 채용 담당자 ID, 이력서 ID, 예전 상태, 새로운 상태, 사유, 생성일시)를 반환합니다.

이력서 로그 목록 조회 API (🔐 AccessToken 인증, 역할 인가 필요)

채용 담당자가 이력서 로그(지원 상태 변경 이력) 목록을 조회합니다.

1. 요청 정보
   • [x] 이력서 ID를 Path Parameters(req.params)로 전달 받습니다.
2. 유효성 검증 및 에러 처리
   • [x] 일치하는 값이 없는 경우 - 빈 배열(**[]**)을 반환합니다. (StatusCode: 200)
3. 비즈니스 로직(데이터 처리)
   • [x] 생성일시 기준 최신순으로 조회합니다.
   • [x] 채용 담당자 ID가 아닌 채용 담당자 이름을 반환하기 위해 스키마에 정의 한 Relation을 활용해 조회합니다.
4. 반환 정보
   • [x] 조회 한 이력서 로그 정보(이력서 로그 ID, 채용 담당자 이름, 이력서 ID, 예전 상태, 새로운 상태, 사유, 생성일시) 목록을 반환합니다.