Repository navigation
[Feature] 댓글 어드민 API 개발 - #33
Conversation
Summary of ChangesHello @Jinyshin, I'm Gemini Code Assist1! 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은 어드민 사용자를 위한 댓글 관리 기능을 도입하고, 기존 댓글 조회 로직의 성능을 최적화하며, 전반적인 코드 품질과 일관성을 향상시키는 데 중점을 둡니다. 어드민은 모든 댓글과 신고된 댓글을 조회하고, 특정 댓글을 강제로 삭제할 수 있습니다. 또한, N+1 쿼리 문제를 해결하여 데이터베이스 부하를 줄이고, Google Java 스타일 가이드를 적용하여 코드 가독성을 높였습니다. Highlights
Using Gemini Code AssistThe 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
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 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. You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension. Footnotes
|
PR 리뷰전반적으로 잘 구현된 코드입니다. N+1 쿼리 최적화와 Mapper 계층 분리가 잘 되어있고, 에러 처리도 꼼꼼하게 되어있습니다. P2 (적극적으로 고려해주세요)
P3 (웬만하면 반영해주세요)
P4 (반영해도 좋고 넘어가도 좋습니다)
전반적으로 코드 품질이 우수하며, N+1 최적화와 Mapper 패턴 적용이 잘 되어있습니다. P2 항목들만 고려해주시면 더욱 견고한 코드가 될 것 같습니다. |
There was a problem hiding this comment.
Code Review
이번 PR은 어드민 댓글 관리 API를 구현하고 N+1 쿼리 문제를 해결하는 등 중요한 기능 추가와 개선을 포함하고 있네요. 전반적으로 코드 품질이 우수하며, 특히 fetch join을 활용한 N+1 문제 해결과 Mapper 계층 도입은 매우 좋은 접근 방식입니다.
몇 가지 개선점을 제안드립니다.
AdminCommentController에서 반복되는 권한 확인 로직은 성능 저하와 코드 중복을 야기할 수 있으므로, Spring Security의 기능을 활용하거나 AOP를 통해 중앙에서 처리하는 방식을 고려해보시면 좋겠습니다.- 댓글 강제 삭제 시 응답으로 반환되는 시간과 실제 데이터베이스에 기록되는 시간이 다를 수 있는 작은 불일치 문제를 수정하여 일관성을 높이는 것을 제안합니다.
이러한 부분들을 개선하면 코드의 유지보수성과 성능이 더욱 향상될 것입니다. 수고 많으셨습니다!
| /** | ||
| * ADMIN 권한 체크 | ||
| */ | ||
| private void checkAdminRole(Long userId) { | ||
| User user = userRepository.findById(userId) | ||
| .orElseThrow(() -> new BusinessException(ErrorCode.USER_NOT_FOUND)); | ||
|
|
||
| if (user.getRole() != Role.ADMIN) { | ||
| throw new BusinessException(ErrorCode.ADMIN_ACCESS_REQUIRED); | ||
| } | ||
| } |
There was a problem hiding this comment.
checkAdminRole 메서드가 컨트롤러의 모든 엔드포인트에서 반복적으로 호출되고 있습니다. 이는 코드 중복을 야기하며, 매번 데이터베이스 조회를 통해 사용자 역할을 확인하므로 비효율적입니다. 이 인가 로직은 더 효율적이고 깔끔하게 처리할 수 있습니다.
개선 제안:
- Spring Security 어노테이션 사용:
@EnableMethodSecurity를 설정하고, 컨트롤러나 각 메서드에@PreAuthorize("hasRole('ADMIN')")을 사용하여 선언적으로 권한을 검사할 수 있습니다. 이를 위해서는 JWT 검증 과정에서 사용자의 역할을GrantedAuthority로 변환하여Authentication객체에 포함해야 합니다. - AOP Aspect 활용: AOP를 사용하여 어드민 API에 대한 호출을 가로채 역할 검사를 수행하는 공통 로직을 만들 수 있습니다.
- 성능 개선: 성능을 위해, 사용자의 역할을 JWT 페이로드에 포함시키고
Authentication객체에 저장하여 매 요청마다 데이터베이스를 조회하는 것을 피하는 것이 좋습니다.
현재 구조에서 가장 간단하게 적용할 수 있는 방법은, 반복되는 로직을 별도의 컴포넌트나 서비스로 분리하여 중복을 제거하는 것입니다. 하지만 장기적으로는 Spring Security의 기능을 최대한 활용하는 방향을 권장합니다.
| return new AdminCommentDeleteResponse( | ||
| comment.getId(), | ||
| true, | ||
| LocalDateTime.now() | ||
| ); |
There was a problem hiding this comment.
forceDeleteComment 메서드에서 AdminCommentDeleteResponse를 생성할 때 LocalDateTime.now()를 사용하여 deletedAt 필드를 채우고 있습니다. 하지만 그 전에 호출되는 comment.delete() 메서드 내부에서도 deletedAt 필드를 LocalDateTime.now()로 설정하고 있습니다. 이로 인해 동일한 삭제 이벤트에 대해 두 개의 약간 다른 타임스탬프가 생성될 수 있습니다. 응답은 엔티티에 실제 기록된 삭제 시간을 반영해야 일관성이 유지됩니다.
comment.delete()가 호출된 후, 엔티티의 deletedAt 값을 사용하여 응답 객체를 생성하는 것을 제안합니다.
| return new AdminCommentDeleteResponse( | |
| comment.getId(), | |
| true, | |
| LocalDateTime.now() | |
| ); | |
| return new AdminCommentDeleteResponse( | |
| comment.getId(), | |
| true, | |
| comment.getDeletedAt() | |
| ); |
- 전체 댓글 조회 (페이징) - 신고된 댓글 조회 (신고 건수 내림차순) - 댓글 강제 삭제 (이유 로깅) - Admin 전용 DTO 및 Mapper 추가 - ReportedCommentProjection으로 신고 통계 효율적 조회 - 인증 실패 시 일관된 JSON 에러 응답 처리 ; Conflicts: ; src/main/java/com/ifu/ifu_server/domain/comment/service/CommentService.java
e8133ae to
7510184
Compare
PR 리뷰전체적으로 어드민 댓글 관리 API가 잘 구현되었습니다. N+1 쿼리 최적화와 신고 건수 집계 로직이 효과적으로 작성되었네요. P2 (적극적으로 고려해주세요)
P3 (웬만하면 반영해주세요)
P4 (반영해도 좋고 넘어가도 좋습니다)
|
- checkAdminRole 중복 제거 (Spring Security hasRole 활용) - AdminCommentController에서 UserRepository 의존성 제거 - 매 요청마다 발생하던 불필요한 DB 조회 제거로 성능 개선 - forceDeleteComment 응답에서 LocalDateTime.now() 대신 comment.getDeletedAt() 사용 - 댓글 조회 시 DRAFT 상태 질문에 대한 접근 차단 추가 - CommentRepository 코드 포맷팅 정리 (들여쓰기 통일)
PR 리뷰전반적으로 어드민 댓글 관리 API 구현이 잘 되어 있고, N+1 문제 해결을 위한 fetch join 활용도 적절합니다. 다만 몇 가지 개선이 필요한 부분이 있어 코멘트 남깁니다. P1 (꼭 반영해주세요)
P2 (적극적으로 고려해주세요)
P3 (웬만하면 반영해주세요)
P4 (반영해도 좋고 넘어가도 좋습니다)
긍정적인 부분: fetch join을 활용한 N+1 쿼리 최적화가 잘 되어 있고, 어드민 API의 응답 구조가 명확합니다. Swagger 문서화도 충실하게 작성되었습니다. |
- GROUP BY c (엔티티)를 명시적인 컬럼 나열로 변경 - Hibernate 특정 구현 의존성 제거 - MySQL ONLY_FULL_GROUP_BY 모드 호환성 확보 - 다른 JPA 구현체에서도 동작 보장
PR 리뷰전반적으로 어드민 댓글 관리 API가 잘 구현되었습니다. N+1 문제 해결과 권한 체크가 적절히 되어 있습니다. P2 (적극적으로 고려해주세요)
P3 (웬만하면 반영해주세요)
P4 (반영해도 좋고 넘어가도 좋습니다)
|
이전 PR merge 이후에 리뷰 반영하도록 하겠습니다.
🔗 Issue Link
close #20
🎯 What I Did
🔍 Review Points
CommentRepository의 fetch join 쿼리 동작 확인🧪 API Test Scenarios
테스트한 엔드포인트
GET /api/v1/admin/comments- 전체 댓글 목록 조회GET /api/v1/admin/comments/reports- 신고된 댓글 목록 조회DELETE /api/v1/admin/comments/{commentId}- 댓글 강제 삭제테스트 시나리오
정상 플로우
에러 케이스
ADMIN_ACCESS_REQUIRED(403)COMMENT_NOT_FOUND(404)COMMENT_ALREADY_DELETED(400)✅ Checklist
@Operation,@ApiResponse,@ApiErrorExample(s)등)🚀 Notes