🌟 Feature : 월 별 생성된 하이라이트 조회 - 캘린더형

[tkv00]

🍀 이슈 번호

• 🌟 Feature : 월 별 생성된 하이라이트 조회 - 캘린더형 #222

---

✅ 작업 사항

• year/month 파라미터로 해당 월 날짜 범위 계산 #223

---

public record DateTimeRange(LocalDateTime start,LocalDateTime end) {}

• 특정 월의 시작일~종료일 범위를 명확하게 관리하기 위해 레코드 타입으로 정의하였습니다.

@Override
public DateTimeRange getMonthDateTimeRange(int year, int month) {
   LocalDate startDate = LocalDate.of(year, month, 1);
   LocalDate endDate = startDate.withDayOfMonth(startDate.lengthOfMonth());

   LocalDateTime start = startDate.atStartOfDay();
   LocalDateTime end = endDate.atTime(23, 59, 59);
   return new DateTimeRange(start,end);
}

• 전달받은 연도/월 기준으로 정확한 월간 범위를 계산합니다.

@Override
public void isValidDateRange(int year, int month) {
    if(year>MAX_YEAR || year<MIN_YEAR) throw new CustomException(ErrorCode.INVALID_YEAR);
    if (month<JANUARY || month>DECEMBER) throw new CustomException(ErrorCode.INVALID_MONTH);
}

• 웹계층에서 파라미터로 입력받는 연도와 월의 유효성 검증을 실시합니다.
• 연도의 범위는 2000~2100 사이의 값만을 허용합니다.

---

• 조회 결과를 날짜별로 그룹핑해서 Map 형태로 변환 #224

public record HighlightCalendarResponse(
        @NotNull Integer year,
        @NotNull Integer month,
        @NotNull List<HighlightCalendarDaysResponse> days
) {}

• 최종 반환 DTO를 확인하면 위와 같은 형태입니다.

DTO 조립 방식

• JPQL의 DTO Projection 방식을 이용하는데 있어 List형태를 쿼리문으로 한 번에 가져오는데 한계가 명확하여 아래와 같은 순서로 DTO를 조립하도록 설계했습니다.

1. Flat 데이터 조회

   • fetchFlatHighlights를 통해 해당 월의 모든 하이라이트 영상을 조회합니다.
   • 반환 타입: List<HighlightInfoResponse>

2. TreeMap을 활용한 날짜 기준 그룹핑

   TreeMap를 사용한 이유?
   일반적인 HashMap 같은 경우 key값의 순서를 보장할 수 없습니다. 따라서, key값인 date를 오름차순으로 반 환하지 못하거나 오름차순으로 반환하려고 한다면 Key를 다시 정렬해야 하는 번거로움을 줄이기 위해 Key 순서를 보장하는 자료구조인 TreeMap를 사용했습니다.

   • key: LocalDate
   • value: 해당 날짜의 하이라이트 목록

3. Mapper를 통한 DTO 변환

   • TreeMap<LocalDate, List<HighlightInfoResponse>>→ List<HighlightCalendarDaysResponse>로 매핑

4. 최종 DTO 조립

   • HighlightCalendarResponse 형태로 최종 반환 객체를 구성합니다.

---

변경 사항

1. HighlightEntity - is_selected 컬럼 삭제

삭제 이유 : 기존 하이라이트가 생성 되었을 때 2개의 하이라이트 영상을 선택하는 플로우에서 전체 하이라이트 영상을 저장하고 게시물을 올리기 전에 선택하는 플로우로 변경.

2. Highlight API - /api/highlight/select 삭제

삭제 이유 : 상기 플로우 변경에 따라 선택 API 또한 삭제하였습니다.

3. HighlightQueryRepository - fetchPeriodHighlight GROUP BY 추가

• 🌟 Feature : 이 주/이 달의 인기 하이라이트 영상 조회 #221 에서 작성된 쿼리문에서 COUNT 집계함수를 사용하는데 여기서 이제 GROUP BY를 사용하지 않아 prod 환경에서 API 호출 시 오류발생을 확인하였고 GROUP BY를 통해 해결.

---

---

⌨ 기타

[pjs1710]

고생하셨습니다🔥

[github-actions]

Test Coverage Report

Overall Project	65.95% -4.24%	🍏
Files changed	0.34%	❌

File	Coverage
HighlightFactory.java	100%	🍏
RankingReader.java	100%	🍏
HighlightValidatorImpl.java	72.66% -17.97%	❌
HighlightHelperImpl.java	61.96% -32.61%	❌
HighlightCommandServiceImpl.java	40%	🍏
HighlightMapperImpl.java	39.29% -60.71%	❌
HighlightQueryController.java	37.93% -37.93%	❌
HighlightUtilImpl.java	27% -50.63%	❌
HighlightManager.java	25.56% -47.78%	❌
HighlightCommandController.java	0%	🍏
HighlightCalendarDaysResponse.java	0%	❌
DateTimeRange.java	0%	❌
HighlightCalendarResponse.java	0%	❌