feat : 보물 캡슐 찾기 기능 추가

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/entity/Capsule.java

@@ -63,13 +63,13 @@ public class Capsule extends BaseEntity {
     private Address address;
 
     @OneToMany(mappedBy = "capsule", cascade = CascadeType.ALL, orphanRemoval = true)
-    private List<Image> images = new ArrayList<>();
+    private final List<Image> images = new ArrayList<>();
 
     @OneToMany(mappedBy = "capsule", cascade = CascadeType.ALL, orphanRemoval = true)
-    private List<Video> videos = new ArrayList<>();
+    private final List<Video> videos = new ArrayList<>();
 
     @OneToMany(mappedBy = "capsule", cascade = CascadeType.ALL, orphanRemoval = true)
-    private List<GroupCapsuleOpen> groupCapsuleOpens = new ArrayList<>();
+    private final List<GroupCapsuleOpen> groupCapsuleOpens = new ArrayList<>();
 
     @ManyToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "group_id")

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/capsule/CapsuleQueryRepository.java

@@ -0,0 +1,32 @@
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.capsule;
+
+import java.util.List;
+import org.locationtech.jts.geom.Polygon;
+import site.timecapsulearchive.core.domain.capsule.entity.CapsuleType;
+import site.timecapsulearchive.core.domain.capsule.generic_capsule.data.dto.NearbyARCapsuleSummaryDto;
+import site.timecapsulearchive.core.domain.capsule.generic_capsule.data.dto.NearbyCapsuleSummaryDto;
+
+public interface CapsuleQueryRepository {
+
+    List<NearbyARCapsuleSummaryDto> findARCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
+        final Long memberId,
+        final Polygon mbr,
+        final CapsuleType capsuleType
+    );
+
+    List<NearbyCapsuleSummaryDto> findCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
+        final Long memberId,
+        final Polygon mbr,
+        final CapsuleType capsuleType
+    );
+
+    List<NearbyCapsuleSummaryDto> findFriendsCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
+        final List<Long> friendIds,
+        final Polygon mbr
+    );
+
+    List<NearbyARCapsuleSummaryDto> findFriendsARCapsulesByCurrentLocation(
+        final List<Long> friendIds,
+        final Polygon mbr
+    );
+}

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/CapsuleQueryRepository.java → backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/capsule/CapsuleQueryRepositoryImpl.java

@@ -1,4 +1,4 @@
-package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository;
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.capsule;
 
 import static site.timecapsulearchive.core.domain.capsule.entity.QCapsule.capsule;
 import static site.timecapsulearchive.core.domain.capsuleskin.entity.QCapsuleSkin.capsuleSkin;
@@ -20,7 +20,7 @@
 
 @Repository
 @RequiredArgsConstructor
-public class CapsuleQueryRepository {
+public class CapsuleQueryRepositoryImpl implements CapsuleQueryRepository {
 
     private final JPAQueryFactory jpaQueryFactory;
 
@@ -104,8 +104,8 @@ public List<NearbyCapsuleSummaryDto> findCapsuleSummaryDtosByCurrentLocationAndC
      * @return 범위 내에 조회된 캡슐들의 요약 정보들을 반환한다.
      */
     public List<NearbyCapsuleSummaryDto> findFriendsCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
-        List<Long> friendIds,
-        Polygon mbr
+        final List<Long> friendIds,
+        final Polygon mbr
     ) {
         return jpaQueryFactory
             .select(
@@ -136,8 +136,8 @@ private BooleanExpression ST_Contains(Polygon mbr, ComparablePath<Point> point)
      * @return 범위 내에 조회된 캡슐들의 요약 정보들을 반환한다.
      */
     public List<NearbyARCapsuleSummaryDto> findFriendsARCapsulesByCurrentLocation(
-        List<Long> friendIds,
-        Polygon mbr
+        final List<Long> friendIds,
+        final Polygon mbr
     ) {
         return jpaQueryFactory
             .select(

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/CapsuleRepository.java → backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/capsule/CapsuleRepository.java

@@ -1,4 +1,4 @@
-package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository;
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.capsule;
 
 import java.util.Optional;
 import org.springframework.data.jpa.repository.Modifying;
@@ -7,16 +7,23 @@
 import org.springframework.data.repository.query.Param;
 import site.timecapsulearchive.core.domain.capsule.entity.Capsule;
 
-public interface CapsuleRepository extends Repository<Capsule, Long> {
+public interface CapsuleRepository extends Repository<Capsule, Long>, CapsuleQueryRepository {
 
     Capsule save(Capsule capsule);
 
+    void delete(Capsule capsule);
+
     @Query("select c from Capsule c where c.id = :capsuleId and c.member.id = :memberId")
     Optional<Capsule> findCapsuleByMemberIdAndCapsuleId(
         @Param("memberId") Long memberId,
         @Param("capsuleId") Long capsuleId
     );
 
+    @Query("select c from Capsule c join fetch c.images where c.id = :capsuleId")
+    Optional<Capsule> findCapsuleWithImageByCapsuleId(
+        @Param("capsuleId") Long capsuleId
+    );
+
     @Modifying(clearAutomatically = true)
     @Query("UPDATE Capsule c SET c.isOpened = true WHERE c.id = :capsuleId and c.member.id = :memberId")
     int updateIsOpenedTrue(

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/image/ImageQueryRepository.java

@@ -0,0 +1,9 @@
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.image;
+
+import java.util.List;
+import site.timecapsulearchive.core.domain.capsule.entity.Image;
+
+public interface ImageQueryRepository {
+
+    void bulkSave(final List<Image> images);
+}

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/ImageQueryRepository.java → backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/image/ImageQueryRepositoryImpl.java

@@ -1,4 +1,4 @@
-package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository;
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.image;
 
 import java.sql.PreparedStatement;
 import java.sql.SQLException;
@@ -14,7 +14,7 @@
 
 @Repository
 @RequiredArgsConstructor
-public class ImageQueryRepository {
+public class ImageQueryRepositoryImpl implements ImageQueryRepository {
 
     private final JdbcTemplate jdbcTemplate;
 

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/ImageRepository.java → backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/image/ImageRepository.java

@@ -1,9 +1,9 @@
-package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository;
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.image;
 
 import org.springframework.data.repository.Repository;
 import site.timecapsulearchive.core.domain.capsule.entity.Image;
 
-public interface ImageRepository extends Repository<Image, Long> {
+public interface ImageRepository extends Repository<Image, Long>, ImageQueryRepository {
 
     void save(Image newImage);
 }

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/video/VideoQueryRepository.java

@@ -0,0 +1,9 @@
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.video;
+
+import java.util.List;
+import site.timecapsulearchive.core.domain.capsule.entity.Video;
+
+public interface VideoQueryRepository {
+
+    void bulkSave(final List<Video> videos);
+}

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/VideoQueryRepository.java → backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/video/VideoQueryRepositoryImpl.java

@@ -1,4 +1,4 @@
-package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository;
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.video;
 
 import java.sql.PreparedStatement;
 import java.sql.SQLException;
@@ -14,7 +14,7 @@
 
 @Repository
 @RequiredArgsConstructor
-public class VideoQueryRepository {
+public class VideoQueryRepositoryImpl implements VideoQueryRepository {
 
     private final JdbcTemplate jdbcTemplate;
 

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/VideoRepository.java → backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/repository/video/VideoRepository.java

@@ -1,9 +1,9 @@
-package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository;
+package site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.video;
 
 import org.springframework.data.repository.Repository;
 import site.timecapsulearchive.core.domain.capsule.entity.Video;
 
-public interface VideoRepository extends Repository<Video, Long> {
+public interface VideoRepository extends Repository<Video, Long>, VideoQueryRepository {
 
     void save(Video video);
 }

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/service/CapsuleService.java

@@ -13,8 +13,7 @@
 import site.timecapsulearchive.core.domain.capsule.generic_capsule.data.dto.CoordinateRangeDto;
 import site.timecapsulearchive.core.domain.capsule.generic_capsule.data.dto.NearbyARCapsuleSummaryDto;
 import site.timecapsulearchive.core.domain.capsule.generic_capsule.data.dto.NearbyCapsuleSummaryDto;
-import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.CapsuleQueryRepository;
-import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.CapsuleRepository;
+import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.capsule.CapsuleRepository;
 import site.timecapsulearchive.core.domain.capsuleskin.entity.CapsuleSkin;
 import site.timecapsulearchive.core.domain.friend.repository.member_friend.MemberFriendRepository;
 import site.timecapsulearchive.core.domain.member.entity.Member;
@@ -25,7 +24,6 @@
 @Transactional(readOnly = true)
 public class CapsuleService {
 
-    private final CapsuleQueryRepository capsuleQueryRepository;
     private final CapsuleRepository capsuleRepository;
     private final MemberFriendRepository memberFriendRepository;
     private final GeoTransformManager geoTransformManager;
@@ -49,7 +47,7 @@ public List<NearbyARCapsuleSummaryDto> findARCapsuleByCurrentLocationAndCapsuleT
 
         final Polygon mbr = geoTransformManager.getDistanceMBROf3857(point, dto.distance());
 
-        return capsuleQueryRepository.findARCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
+        return capsuleRepository.findARCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
             memberId, mbr, capsuleType);
     }
 
@@ -63,7 +61,7 @@ public List<NearbyCapsuleSummaryDto> findCapsuleByCurrentLocationAndCapsuleType(
 
         final Polygon mbr = geoTransformManager.getDistanceMBROf3857(point, dto.distance());
 
-        return capsuleQueryRepository.findCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
+        return capsuleRepository.findCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
             memberId, mbr, capsuleType);
     }
 
@@ -116,7 +114,7 @@ public List<NearbyCapsuleSummaryDto> findFriendsCapsulesByCurrentLocation(
 
         final List<Long> friendIds = memberFriendRepository.findFriendIdsByOwnerId(memberId);
 
-        return capsuleQueryRepository.findFriendsCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
+        return capsuleRepository.findFriendsCapsuleSummaryDtosByCurrentLocationAndCapsuleType(
             friendIds,
             mbr
         );
@@ -140,7 +138,7 @@ public List<NearbyARCapsuleSummaryDto> findFriendsARCapsulesByCurrentLocation(
 
         final List<Long> friendIds = memberFriendRepository.findFriendIdsByOwnerId(memberId);
 
-        return capsuleQueryRepository.findFriendsARCapsulesByCurrentLocation(
+        return capsuleRepository.findFriendsARCapsulesByCurrentLocation(
             friendIds,
             mbr
         );

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/service/ImageService.java

@@ -6,15 +6,15 @@
 import org.springframework.transaction.annotation.Transactional;
 import site.timecapsulearchive.core.domain.capsule.entity.Capsule;
 import site.timecapsulearchive.core.domain.capsule.entity.Image;
-import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.ImageQueryRepository;
+import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.image.ImageRepository;
 import site.timecapsulearchive.core.domain.member.entity.Member;
 import site.timecapsulearchive.core.infra.s3.data.dto.S3Directory;
 
 @Service
 @RequiredArgsConstructor
 public class ImageService {
 
-    private final ImageQueryRepository imageQueryRepository;
+    private final ImageRepository imageRepository;
 
     @Transactional
     public void bulkSave(final List<String> fileNames, final Capsule capsule, final Member member) {
@@ -23,7 +23,7 @@ public void bulkSave(final List<String> fileNames, final Capsule capsule, final
                 .map(fileName -> S3Directory.CAPSULE.generateFullPath(member.getId(), fileName))
                 .toList();
 
-            imageQueryRepository.bulkSave(Image.createOf(fullFileNames, capsule, member));
+            imageRepository.bulkSave(Image.createOf(fullFileNames, capsule, member));
         }
     }
 

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/generic_capsule/service/VideoService.java

@@ -6,15 +6,15 @@
 import org.springframework.transaction.annotation.Transactional;
 import site.timecapsulearchive.core.domain.capsule.entity.Capsule;
 import site.timecapsulearchive.core.domain.capsule.entity.Video;
-import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.VideoQueryRepository;
+import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.video.VideoRepository;
 import site.timecapsulearchive.core.domain.member.entity.Member;
 import site.timecapsulearchive.core.infra.s3.data.dto.S3Directory;
 
 @Service
 @RequiredArgsConstructor
 public class VideoService {
 
-    private final VideoQueryRepository videoQueryRepository;
+    private final VideoRepository videoRepository;
 
     @Transactional
     public void bulkSave(final List<String> fileNames, final Capsule capsule, final Member member) {
@@ -23,7 +23,7 @@ public void bulkSave(final List<String> fileNames, final Capsule capsule, final
                 .map(fileName -> S3Directory.CAPSULE.generateFullPath(member.getId(), fileName))
                 .toList();
 
-            videoQueryRepository.bulkSave(Video.createOf(fullFileNames, capsule, member));
+            videoRepository.bulkSave(Video.createOf(fullFileNames, capsule, member));
         }
     }
 

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/group_capsule/service/GroupCapsuleService.java

@@ -12,13 +12,12 @@
 import site.timecapsulearchive.core.domain.capsule.entity.Capsule;
 import site.timecapsulearchive.core.domain.capsule.entity.CapsuleType;
 import site.timecapsulearchive.core.domain.capsule.exception.CapsuleNotFondException;
-import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.CapsuleRepository;
+import site.timecapsulearchive.core.domain.capsule.generic_capsule.repository.capsule.CapsuleRepository;
 import site.timecapsulearchive.core.domain.capsule.group_capsule.data.dto.GroupCapsuleCreateRequestDto;
 import site.timecapsulearchive.core.domain.capsule.group_capsule.data.dto.GroupCapsuleDetailDto;
 import site.timecapsulearchive.core.domain.capsule.group_capsule.data.dto.GroupCapsuleOpenStateDto;
 import site.timecapsulearchive.core.domain.capsule.group_capsule.data.dto.GroupCapsuleSummaryDto;
 import site.timecapsulearchive.core.domain.capsule.group_capsule.data.dto.GroupMemberCapsuleOpenStatusDto;
-import site.timecapsulearchive.core.domain.capsule.group_capsule.data.dto.MyGroupCapsuleDto;
 import site.timecapsulearchive.core.domain.capsule.group_capsule.repository.GroupCapsuleOpenQueryRepository;
 import site.timecapsulearchive.core.domain.capsule.group_capsule.repository.GroupCapsuleQueryRepository;
 import site.timecapsulearchive.core.domain.capsuleskin.entity.CapsuleSkin;

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/treasure_capsule/api/TreasureCapsuleApi.java

@@ -0,0 +1,46 @@
+package site.timecapsulearchive.core.domain.capsule.treasure_capsule.api;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.enums.ParameterIn;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import io.swagger.v3.oas.annotations.security.SecurityRequirement;
+import org.springframework.http.ResponseEntity;
+import site.timecapsulearchive.core.global.common.response.ApiSpec;
+import site.timecapsulearchive.core.global.error.ErrorResponse;
+
+public interface TreasureCapsuleApi {
+
+    @Operation(
+        summary = "보물 캡슐 개봉",
+        description = "사용자는 보물 캡슐을 개봉할 수 있다.",
+        security = {@SecurityRequirement(name = "user_token")},
+        tags = {"secret capsule"}
+    )
+    @ApiResponses(value = {
+        @ApiResponse(
+            responseCode = "202",
+            description = "처리 시작"
+        ),
+        @ApiResponse(
+            responseCode = "500",
+            description = "보물 캡슐 찾기 실패 예외",
+            content = @Content(schema = @Schema(implementation = ErrorResponse.class))
+        ),
+        @ApiResponse(
+            responseCode = "500",
+            description = "외부 API 요청 실패",
+            content = @Content(schema = @Schema(implementation = ErrorResponse.class))
+        )
+    })
+    ResponseEntity<ApiSpec<String>> openTreasureCapsule(
+        Long memberId,
+
+        @Parameter(in = ParameterIn.PATH, description = "개봉할 보물 캡슐 아이디", required = true)
+        Long capsuleId
+    );
+
+}

backend/core/src/main/java/site/timecapsulearchive/core/domain/capsule/treasure_capsule/api/TreasureCapsuleController.java

@@ -0,0 +1,35 @@
+package site.timecapsulearchive.core.domain.capsule.treasure_capsule.api;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.core.annotation.AuthenticationPrincipal;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import site.timecapsulearchive.core.domain.capsule.treasure_capsule.service.TreasureCapsuleService;
+import site.timecapsulearchive.core.global.common.response.ApiSpec;
+import site.timecapsulearchive.core.global.common.response.SuccessCode;
+
+@RestController
+@RequestMapping("/treasure-capsules")
+@RequiredArgsConstructor
+public class TreasureCapsuleController implements TreasureCapsuleApi {
+
+    private final TreasureCapsuleService treasureCapsuleService;
+
+    @Override
+    @PostMapping("/{capsule_id}/open")
+    public ResponseEntity<ApiSpec<String>> openTreasureCapsule(
+        @AuthenticationPrincipal final Long memberId,
+        @PathVariable(value = "capsule_id") final Long capsuleId
+    ) {
+        treasureCapsuleService.openTreasureCapsule(memberId, capsuleId);
+
+        return ResponseEntity.ok(
+            ApiSpec.empty(
+                SuccessCode.SUCCESS
+            )
+        );
+    }
+}