[PROD] fix(#135),feat(#138): 통계 쿼리 버그 수정 및 관리자 Qna 페이지네이션 적용

[yeonchaepark]

• 실배포 PR 입니다.

• 관련 PR

  • fix(#135): 통계 쿼리 첫 번째 시도 필터링 버그 수정 (isFirst 추가) #137
  • feat(#138): 관리자 qna 페이지네이션 적용 #139

• 주의 사항

  • 프론트 배포와 동시 배포 진행 (관련 PR 내용)

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 통계 데이터의 정확성을 높이기 위한 중요한 버그 수정과 관리자 Q&A 기능의 사용자 경험을 개선하기 위한 페이지네이션 기능을 도입합니다. 통계 쿼리는 이제 퀴즈의 첫 시도만을 기반으로 데이터를 집계하여 더 신뢰할 수 있는 분석을 제공하며, 관리자는 페이지네이션을 통해 문의 목록을 보다 효율적으로 탐색하고 관리할 수 있습니다.

Highlights

• 통계 쿼리 버그 수정: SolveHistoryStatisticsRepository의 통계 쿼리가 첫 시도(first attempt)만 정확히 반영하도록 수정되었습니다. 기존에는 중복 시도도 통계에 포함될 수 있었으나, 이제 isFirst 필드를 사용하여 첫 시도만 집계합니다.
• 관리자 Q&A 페이지네이션 적용: 관리자 문의 조회 기능에 페이지네이션이 추가되어 대량의 문의를 효율적으로 관리할 수 있게 되었습니다.
• SolveHistory 엔티티 개선: SolveHistory 엔티티에 isFirst 필드가 추가되어, 퀴즈 풀이 기록이 첫 시도인지 여부를 명시적으로 저장합니다.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request implements pagination for the admin inquiry listing, updating the controller, DTOs, and repository to leverage Spring Data JPA's Page and Pageable for inquiry retrieval. It also introduces an isFirst flag in the SolveHistory entity to differentiate initial quiz attempts from re-attempts, and updates all relevant daily, hourly, and topic-based statistics services and repositories to exclusively process these first attempts. Feedback includes a suggestion to align the opening brace style in AdminReadInquiriesController with the project's existing code conventions for better readability.

[gemini-code-assist]

메서드 선언부의 여는 중괄호 { 위치가 파일 내 다른 메서드(toResponse)와 일관되지 않아 코드 가독성을 해칠 수 있습니다.

프로젝트 전반의 코드 스타일 일관성을 위해 여는 중괄호를 메서드 시그니처와 같은 줄에 배치하는 것을 권장합니다. 또한, 42번째 줄의 { 앞에는 불필요한 공백이 있습니다. 일관된 스타일은 코드를 더 쉽게 읽고 유지보수하는 데 도움이 됩니다.

        @ModelAttribute AdminReadInquiriesRequest request) {

References

1. 프로젝트의 기존 코드 스타일과 일관성을 유지해야 합니다. 이 경우, 파일 내 다른 메서드와 중괄호 위치 스타일이 일치하지 않아 유지보수성을 저해할 수 있습니다. ^(link)