feat(home): AI 캐릭터 부족분을 랜덤 보충한다

2026-07-22 22:14:26 +09:00
parent 075ca88f01
commit a0bf71be47
10 changed files with 230 additions and 4 deletions
--- a/docs/20260709_메인_홈_추천_AI캐릭터_스냅샷/prd.md
+++ b/docs/20260709_메인_홈_추천_AI캐릭터_스냅샷/prd.md
@@ -21,6 +21,7 @@
 - 팔로우 증가 수는 전날 발생한 AI 캐릭터 신규 팔로우 수로 계산한다.
 - 신규 부스트는 `ChatCharacter.createdAt` 기준으로 10일 이내 1.15, 20일 이내 1.10, 30일 이내 1.05, 그 외 1.0을 적용한다.
 - 홈 통합 조회와 AI 캐릭터 전체보기 조회는 최신 AI 캐릭터 스냅샷의 점수순 결과를 사용한다.
+- 홈 통합 조회는 최신 스냅샷 상세 조회 결과가 20개 미만이면 스냅샷 캐릭터를 제외한 활성 AI 캐릭터 랜덤 조회로 부족분을 채운다.

 ---

@@ -117,11 +118,14 @@
  - 사용자들이 친 전체 채팅 수
 - 스냅샷 정렬은 점수 내림차순, 동일 점수면 더 늦게 생성된 캐릭터를 우선한다.
 - 조회 시점에도 비활성 또는 노출 제한 캐릭터는 제외한다.
+- 홈 통합 조회에서 스냅샷 상세 조회 결과가 20개 미만이면 이미 조회한 스냅샷 캐릭터 id를 제외하고 활성 AI 캐릭터를 랜덤으로 조회해 부족분을 뒤에 붙인다.

 #### Edge Cases
 - 스냅샷에는 존재하지만 조회 시점에 캐릭터 또는 `creatorMember`가 비활성화된 경우 응답에서 제외한다.
 - fallback refresh 후에도 최신 스냅샷이 없으면 기존 홈 추천 API 동작과 동일하게 빈 배열을 반환한다.
 - 상세 조회 결과가 스냅샷 저장 개수보다 적어도 홈 조회 전체는 성공 처리한다.
+- 랜덤 보충 후보가 부족하면 중복 없이 조회 가능한 AI 캐릭터만 반환한다.
+- 빈 스냅샷 refresh 완료 marker가 있거나 전체보기 paging 조회이면 랜덤 보충을 적용하지 않는다.

 ### Feature E. 스냅샷 없음 fallback refresh