사용자 활동 API 명세 업데이트 및 V2 작업

[Hwangseoeun]

😉 연관 이슈

Resolves #248

🧑‍💻 수행 작업

• 참여중인 특정 챌린지 그룹 활동 통계 조회 API, 사용자의 활동 통계 및 작성한 인증 목록 전체 조회 API 내 dailyTodoStats를 별도의 api로 분리
• 사용자의 활동 통계 및 작성한 인증 목록 전체 조회 API의 필드 값 네이밍 수정
  ( 정렬 방식과는 상관없이 공통된 응답 필드를 가지도록 수정 )

📢 참고 사항

X

Summary by CodeRabbit

릴리스 노트

• 새로운 기능

  • 사용자 활동 조회 V2 API 추가: 챌린지 그룹 활동 요약, 인증 목록 조회(페이지 네이션 지원), 인증 통계 조회

• 문서

  • V2 API 엔드포인트 완전 문서화

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

사용자 활동 API V2 엔드포인트 세 개를 추가하고, 그룹화된 인증 관련 DTO를 통합하며, V1 컨트롤러를 새 DTO로 업데이트하고, V2 응답 객체를 도입합니다.

Changes

Cohort / File(s)	변경 사항
문서화 src/docs/asciidoc/index.adoc, src/docs/asciidoc/memberactivity/member-activity-v2.adoc	V2 Member Activity API 문서 추가 및 인덱스에 포함 (3개 엔드포인트: get-my-challenge-group-activity-summary-v2, get-my-certifications-v2, get-my-certification-stats-v2)
V2 API 계층 src/main/java/site/dogether/memberactivity/controller/v2/MemberActivityControllerV2.java, src/main/java/site/dogether/memberactivity/controller/v2/dto/response/GetMyChallengeGroupActivitySummaryApiResponseV2.java, src/main/java/site/dogether/memberactivity/controller/v2/dto/response/GetMyCertificationsApiResponseV2.java, src/main/java/site/dogether/memberactivity/controller/v2/dto/response/GetMyCertificationStatsApiResponseV2.java	V2 컨트롤러 신규 추가 (3개 엔드포인트) 및 각 엔드포인트 응답 DTO 정의
V1 API 업데이트 src/main/java/site/dogether/memberactivity/controller/v1/MemberActivityControllerV1.java, src/main/java/site/dogether/memberactivity/controller/v1/dto/response/GetMyActivityStatsAndCertificationsApiResponseV1.java, src/main/java/site/dogether/memberactivity/controller/v1/dto/response/GetMyChallengeGroupActivityStatsApiResponseV1.java	DTO 타입 통합: GroupedCertificationsDto 사용, 필드명 변경 (totalCertificatedCount → certificatedCount 등)
서비스 계층 src/main/java/site/dogether/memberactivity/service/MemberActivityService.java	메서드 이름 변경 (getMyCertificationStats → getMyTotalCertificationStats), 반환 타입 변경, 오버로드 메서드 추가 (getCertifications), 새 DTO 타입 도입 (GroupedCertificationsDto, GroupedCertificationsResultDto)
서비스 DTO 통합 src/main/java/site/dogether/memberactivity/service/dto/GroupedCertificationsDto.java, src/main/java/site/dogether/memberactivity/service/dto/GroupedCertificationsResultDto.java, src/main/java/site/dogether/memberactivity/service/dto/MyCertificationStatsDto.java, src/main/java/site/dogether/memberactivity/service/dto/CertificationsGroupedByGroupCreatedAtDto.java, src/main/java/site/dogether/memberactivity/service/dto/MyCertificationStatsInChallengeGroupDto.java	CertificationsGroupedByCertificatedAtDto를 GroupedCertificationsDto로 이름 변경 (createdAt → groupedBy), CertificationsGroupedByGroupCreatedAtDto 삭제, MyCertificationStatsInChallengeGroupDto 삭제, MyCertificationStatsDto 필드명 변경
테스트 src/test/java/site/dogether/docs/memberactivity/v1/MemberActivityControllerV1DocsTest.java, src/test/java/site/dogether/docs/memberactivity/v2/MemberActivityControllerV2DocsTest.java, src/test/java/site/dogether/memberactivity/service/MemberActivityServiceTest.java	V1 테스트 업데이트 (새 DTO 타입 사용), V2 테스트 신규 추가 (3개 엔드포인트), 서비스 테스트 DTO 타입 변경

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related PRs

• MemberActivity 관련 API 리팩토링 #243: 멤버 활동 API 리팩토링의 연속 작업으로, 동일한 서비스 및 DTO 계층(MemberActivityService, 그룹화된 인증 DTO 및 응답 매핑)을 수정합니다.
• api 명세 문서 내 path variable 설명 추가 #246: V1 API 문서 테스트 파일(MemberActivityControllerV1DocsTest.java)을 동일하게 수정하므로 관련이 있습니다.

Suggested reviewers

• kelly6bf

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}