Feature/bundle

[kitechoi]

Pull Request

💡 PR 요약

이 PR에서 작업한 내용을 간단히 설명해주세요

보따리 최초 생성 API를 개발하였습니다.

JWT 기반 사용자 인증을 추가하여, 현재 로그인한 사용자 정보를 활용하도록 하였습니다.

최초 생성된 보따리에는 보따리명 외에도 선물객체들, 선물이미지 관련 데이터들이 포함됩니다.

🔍 주요 변경사항

구체적인 변경 내용을 설명해주세요

• POST /api/v1/bundles 보따리 최초 생성 API 구현
• UserService.getCurrentActiveUser() 메서드 접근 제한자 변경 (private → public)
• BundleService.createBundle() JWT 기반 사용자 인증을 통해 유저 ID 저장
• BundleServiceTest 테스트 코드 작성 ([@mock](https://github.com/mock)을 활용하여 사용자 인증 Mocking)
• 테스트용 JWT 토큰 생성 유틸리티 (TestJwtTokenProvider) 추가
• 선물 엔티티, dto 등 기본 구조
• 선물 이미지 엔티티, dto 등 기본 구조

🔗 연관된 이슈

관련 이슈를 링크해주세요 (예: #이슈번호)

📸 스크린샷 (선택)

UI 변경사항이 있다면 스크린샷을 첨부해주세요

✅ 체크리스트

• [🔺] 테스트 코드를 작성하였나요? -> 선물객체들, 선물이미지 관련 데이터들 포함 전 테스트 코드만 작성됨
• 관련 문서를 업데이트하였나요?
• Breaking Change가 있나요?
• 코드 포맷팅과 린트 검사를 완료하였나요?

🙏 리뷰어 참고사항

리뷰어가 특별히 봐주었으면 하는 부분이 있다면 작성해주세요

• UserService.getCurrentActiveUser() 메서드를 public으로 변경하여 현재 로그인한 사용자를 가져오는 방식을 적용했습니다.이 방식이 적절한지, 더 좋은 대안이 있는지 리뷰 요청드립니다.
• API 요청 시 JWT 인증을 기본적으로 요구하도록 설정했는데, 그래서 스웨거에서는 테스트가 불가하며 단위 테스트만 통과한 상황입니다.
• 보따리생성 단위Test에서 jwt 토큰도 발급받고 스웨거에서 그 토큰을 사용할 수 있길 바랐는데, 403 에러가 뜨는 걸 보니 안 되나 봅니다. 앞으로 어떻게 테스트하면 좋을지 고민이네요
• BundleService의 BundleResponse createBundle 어떤 응답을 반환하는 게 적합할지. 현재는 (보따리 + 선물 + 이미지)라는 모든 데이터를 반환 중.

📋 추가 컨텍스트 (선택)

PR에 대한 추가적인 설명이나 컨텍스트가 있다면 작성해주세요

[TaskerJang]

1. getCurrentActiveUser() 메서드 관련

현재 방식은 작동은 하지만, 인증 관련 책임을 분리하는 것이 더 좋습니다

@Service
@RequiredArgsConstructor
public class AuthenticationService {
    
    /**
     * 현재 인증된 사용자 정보를 가져오는 메서드
     */
    public User getCurrentUser() {
        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
        if (authentication == null || !authentication.isAuthenticated()) {
            throw new UnauthorizedException("인증되지 않은 사용자입니다.");
        }
        
        String userId = authentication.getName();
        return userRepository.findById(Long.valueOf(userId))
            .orElseThrow(() -> new UserNotFoundException("사용자를 찾을 수 없습니다."));
    }
}

// 사용 예시
@Service
@RequiredArgsConstructor
public class BundleService {
    private final AuthenticationService authenticationService;
    
    public BundleResponse createBundle(BundleRequest request) {
        User currentUser = authenticationService.getCurrentUser();
        // 이런식으로 써도 괜찮을 거 같습니다.
    }
}

2. 테스트 관련

TestJwtTokenProvider를 활용해서 다음과 같이 개발 환경용 토큰 발급 API를 구현하면 될거 같습니다.

@Profile("dev")  // 개발 환경에서만 활성화
@RestController
@RequestMapping("/api/test")
@RequiredArgsConstructor
public class TestAuthController {
    
    @GetMapping("/token")
    public ResponseEntity<Map<String, String>> getTestToken() {
        String token = TestJwtTokenProvider.generateTestToken("test-user");
        return ResponseEntity.ok(Map.of("token", token));
    }
}

그리고 SecurityConfig에서 이 테스트 엔드포인트에 대한 접근을 허용해주면 됩니다:

.requestMatchers("/api/test/token").permitAll()

이렇게 하면 개발 환경에서 /api/test/token을 호출하여 테스트용 토큰을 받고
받은 토큰을 Swagger UI의 Authorize 버튼을 통해 설정한 후 API 테스트를 진행할 수 있습니다.

3. BundleResponse 최적화

현재처럼 모든 데이터를 반환하는 것보다는, 용도에 맞게 응답을 분리하는 것을 추천드립니다.