🚀[기능개선][홈] AI 추천 문제 새로고침 세션 내 중복 제외

[Cassiiopeia]

📝 현재 문제점

• 홈 화면의 AI 추천 문제 새로고침 버튼을 눌러도 매번 동일한 문제가 반환된다.
• Qdrant 벡터 검색은 동일한 쿼리 벡터(오답 패턴)에서 항상 같은 Top-K 결과를 반환하기 때문이다.
• 새로고침 버튼의 UX 목적("다른 문제 보고 싶다")과 실제 동작이 불일치한다.

🛠️ 해결 방안 / 제안 기능

• 새로고침 버튼을 누를 때마다 이번 세션에서 이미 추천된 문제를 excludeQuestionUuids로 API에 전달하여 중복 제외한다.
• 브라우저 새로고침 시 자연스럽게 초기화된다(React state 초기화).
• 세션 내 중복만 제외하며, 이미 푼 문제 전체 영구 제외는 범위 밖이다(문제 고갈 방지).

⚙️ 작업 내용

• 백엔드: QuestionController — excludeQuestionUuid(단수) → excludeQuestionUuids(복수 List) 변경
• 백엔드: RecommendationService — mustNotIds에 리스트 전체 추가
• 프론트: src/api/questions.ts — excludeQuestionUuids 배열 반복 append 직렬화
• 프론트: src/hooks/useHome.ts — useRecommendations(excludeUuids) 파라미터 추가, queryKey에 포함
• 프론트: src/pages/Home.tsx — seenUuids state 추가, 응답 도착 시 누적, 새로고침 시 전달

🙋‍♂️ 담당자

• 백엔드: 서새찬
• 프론트엔드: 서새찬
• 디자인: -

[Cassiiopeia]

Guide by SUH-LAB

브랜치

20260424_#284_AI_추천_문제_새로고침_세션_내_중복_제외

커밋 메시지

AI 추천 문제 새로고침 세션 내 중복 제외 : feat : {변경 사항에 대한 설명} https://github.com/passQL-Lab/passQL/issues/284

[Cassiiopeia]

구현 완료 리포트

변경 사항

백엔드

• QuestionRepository: findRandomActiveExcludingList() 쿼리 추가 (복수 UUID 제외, CAST(question_uuid AS varchar) NOT IN (:excludeUuids) 패턴)
• QuestionService: getRecommendations() 시그니처 UUID → List<UUID>로 변경, DailyChallenge 자동 제외 유지
• RecommendationService: recommend() / tryAiRecommend() 시그니처 변경, AI mustNotIds에 리스트 전체 추가
• QuestionController: @RequestParam 단수 → 복수 List로 변경, String→UUID 변환 처리

프론트엔드

• src/api/questions.ts: fetchRecommendations에 excludeQuestionUuids?: string[] 파라미터 추가, 동일 키 반복 append 직렬화
• src/hooks/useHome.ts: useRecommendations(excludeUuids) 파라미터 추가, queryKey에 포함
• src/pages/Home.tsx: seenUuids state 추가, 추천 결과 도착 시 UUID 누적, 새로고침 시 제외 목록으로 전달

PR

#286

동작 방식

[github-actions]

🗑️ Preview 환경 삭제 완료!

항목	값
컨테이너	passql-pr-284
상태	삭제됨

다시 배포하려면: @suh-lab server deploy

---

🤖 이 댓글은 PR/Issue Preview 시스템에 의해 자동 생성되었습니다.

[github-actions]

🗑️ Preview 환경 삭제 완료!

항목	값
컨테이너	passql-ai-pr-284
상태	삭제됨

다시 배포하려면: @suh-lab server deploy

---

🤖 이 댓글은 PR/Issue Preview 시스템에 의해 자동 생성되었습니다.