Refactor: 파티 조회 시 거리 정보 반환 및 API 개선 #

[milowon]

📝 상세 내용

• 파티 조회 API에서 사용자 위치 기반 거리 정보 반환 기능 추가
• PartyController API 경로 슬래시 누락 수정
• 위도/경도 검증 로직 및 null 체크 개선
• Swagger API 문서 보완

Summary by CodeRabbit

릴리스 노트

• 새로운 기능

  • 파티 검색 시 위도·경도 정보를 선택적으로 제공하여 각 파티까지의 거리 정보 확인 가능
  • 내 주최 파티 및 참여 중인 파티 목록에서 거리 기반 정보 제공

• 문서화

  • API 엔드포인트에 대한 문서화 확대로 더 명확한 서비스 사용 정보 제공

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

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

이 PR은 정당 관련 API 엔드포인트에 위치 기반 거리 계산 기능을 추가하고, 메서드 시그니처를 정리하며, Swagger 문서화를 확장합니다. PartyController의 경로 매핑이 수정되고(선행 슬래시 추가), UserController와 PartyController의 엔드포인트가 선택적 위도/경도 파라미터를 받도록 변경되며, PartyCardResponse에는 사용자 좌표를 받아 거리를 계산하는 새로운 팩토리 메서드가 추가됩니다. PartyService는 위치 검증 로직을 단순화하고, 거리 계산을 중앙화하며, null 거리값 처리를 개선합니다.

Sequence Diagram(s)

sequenceDiagram
    participant Client
    participant UserController
    participant UserService
    participant PartyCardResponse
    participant DistanceCalculator
    participant Database

    Client->>UserController: GET /user/hosting-parties?latitude=X&longitude=Y
    UserController->>UserService: getHostingParties(userId, latitude, longitude)
    UserService->>Database: Query hosting parties by userId
    Database-->>UserService: List<Party>
    
    loop for each Party
        UserService->>PartyCardResponse: from(party, currentParticipants, userLat, userLon)
        PartyCardResponse->>DistanceCalculator: calculate distance
        DistanceCalculator-->>PartyCardResponse: distance value
        PartyCardResponse-->>UserService: PartyCardResponse with distance
    end
    
    UserService-->>UserController: List<PartyCardResponse> with distances
    UserController-->>Client: HTTP 200 + PartyCardResponse list

Loading

Possibly related PRs

• Refactor: 파티 조회 시 거리 정보 반환 및 API 개선 #124: 동일한 파일들(PartyController, PartyService, PartyCardResponse, UserController, UserService)에서 경로 수정, 거리 기능 추가, 메서드 시그니처 변경 등 동일한 코드 레벨의 변경을 수행합니다.
• Hotfix : 파티 생성, 조회시 거리 계산 로직 반영  #60: PartyController와 PartyService, PartyCardResponse의 동일한 클래스들에서 거리 계산 및 사용자 위치 처리 로직을 수정합니다.
• Hotfix : 파티 상세 조회에서 유저 좌표 입력 request param 방식으로 변경  #61: 정당 상세 조회에서 userLat/userLon 파라미터를 받도록 업데이트하고 PartyService.validateLocation 시그니처를 변경합니다.

Suggested labels

refactor

✨ Finishing touches

• 📝 Generate docstrings

---

---

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d17d8a4 and 8da39b7.

📒 Files selected for processing (5)

• src/main/java/ita/tinybite/domain/party/controller/PartyController.java
• src/main/java/ita/tinybite/domain/party/dto/response/PartyCardResponse.java
• src/main/java/ita/tinybite/domain/party/service/PartyService.java
• src/main/java/ita/tinybite/domain/user/controller/UserController.java
• src/main/java/ita/tinybite/domain/user/service/UserService.java

_{✏️ Tip: You can disable this entire section by setting review_details to false in your review settings.}

---

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.}