docs(content): 최근 댓글 오디오 중복 저장 정책을 문서화한다

This commit is contained in:
2026-07-12 16:30:56 +09:00
parent 6da2378b29
commit fda51e6e52
2 changed files with 43 additions and 2 deletions

View File

@@ -146,6 +146,7 @@
- 최근 7일 댓글 데이터를 기반으로 최종 점수를 산출한다.
- 데이터가 없으면 섹션을 표시하지 않도록 빈 배열로 내려준다.
- 최대 5개를 표시한다.
- 스냅샷 저장 후보에 같은 크리에이터의 오디오가 여러 개 있으면 최근 댓글 많은 오디오 점수가 가장 높은 1개만 저장한다.
- 오디오별 가장 최신 댓글 1개의 본문과 글쓴이 프로필 이미지를 함께 내려준다.
#### Edge Cases
@@ -285,6 +286,7 @@ data class CommentedAudioResponse(
- New & Hot lazy 보강은 스냅샷 row가 없을 때 Redis marker 기준 KST 날짜별 1회만 시도하고, 보강 후 후보가 0개인 정상 상황에서는 같은 날짜의 다음 조회가 전체 refresh를 반복하지 않는다.
- 공통 오디오 카드 응답의 `isOriginalSeries`는 시리즈 미소속 오디오이면 클라이언트 편의를 위해 `false`로 내려준다.
- 무료/포인트/추천 오디오처럼 서로 다른 추천 섹션에 같은 콘텐츠가 동시에 포함되어도 서버에서 중복 제거하지 않는다.
- `mostCommentedAudios` 스냅샷 저장은 같은 크리에이터의 오디오를 최대 1개만 포함한다. 같은 크리에이터 후보가 여러 개이면 `findMostCommentedSnapshots`의 최근 댓글 많은 오디오 점수가 가장 높은 후보를 남기고, `AudioRecommendationSnapshotRefreshService.replaceMostCommentedSnapshots`는 그 결과만 저장한다.
---