feat : 쿠폰조회, 상세조회, 수정, 삭제 관리자 기능 구현

src/main/java/com/threestar/trainus/domain/coupon/admin/controller/AdminCouponController.java

@@ -2,25 +2,42 @@
 
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 import com.threestar.trainus.domain.coupon.admin.dto.CouponCreateRequestDto;
 import com.threestar.trainus.domain.coupon.admin.dto.CouponCreateResponseDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponDeleteResponseDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponDetailResponseDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponListResponseDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponListWrapperDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponUpdateRequestDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponUpdateResponseDto;
+import com.threestar.trainus.domain.coupon.admin.mapper.AdminCouponMapper;
 import com.threestar.trainus.domain.coupon.admin.service.AdminCouponService;
+import com.threestar.trainus.domain.coupon.user.entity.CouponCategory;
+import com.threestar.trainus.domain.coupon.user.entity.CouponStatus;
 import com.threestar.trainus.global.annotation.LoginUser;
 import com.threestar.trainus.global.unit.BaseResponse;
+import com.threestar.trainus.global.unit.PagedResponse;
 
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
 import lombok.RequiredArgsConstructor;
 
 @Tag(name = "관리자 쿠폰 API", description = "관리자 쿠폰 생성,수정 및 삭제 관련 API")
 @RestController
-@RequestMapping("/api/v1/coupons")
+@RequestMapping("/api/v1/admin/coupons")
 @RequiredArgsConstructor
 public class AdminCouponController {
 
@@ -35,4 +52,54 @@ public ResponseEntity<BaseResponse<CouponCreateResponseDto>> createCoupon(
 		CouponCreateResponseDto response = adminCouponService.createCoupon(request, loginUserId);
 		return BaseResponse.ok("쿠폰 생성이 완료되었습니다.", response, HttpStatus.OK);
 	}
+
+	@GetMapping
+	@Operation(summary = "쿠폰 목록 조회", description = "관리자가 쿠폰 목록을 조회")
+	public ResponseEntity<PagedResponse<CouponListWrapperDto>> getCoupons(
+		@RequestParam(defaultValue = "1") @Min(value = 1, message = "페이지는 1 이상이어야 합니다.")
+		@Max(value = 1000, message = "페이지는 1000 이하여야 합니다.") int page,
+		@RequestParam(defaultValue = "5") @Min(value = 1, message = "limit는 1 이상이어야 합니다.")
+		@Max(value = 100, message = "limit는 100 이하여야 합니다.") int limit,
+		@RequestParam(required = false) CouponStatus status,
+		@RequestParam(required = false) CouponCategory category,
+		@LoginUser Long loginUserId
+	) {
+		CouponListResponseDto couponsInfo = adminCouponService.getCoupons(page, limit, status, category, loginUserId);
+
+		CouponListWrapperDto coupons = AdminCouponMapper.toCouponListWrapperDto(couponsInfo);
+
+		return PagedResponse.ok("쿠폰 목록 조회 완료.", coupons, couponsInfo.totalCount(), HttpStatus.OK);
+	}
+
+	@GetMapping("/{couponId}")
+	@Operation(summary = "쿠폰 상세 조회", description = "관리자가 특정 쿠폰의 상세 정보를 조회")
+	public ResponseEntity<BaseResponse<CouponDetailResponseDto>> getCouponDetail(
+		@PathVariable Long couponId,
+		@LoginUser Long loginUserId
+	) {
+		CouponDetailResponseDto response = adminCouponService.getCouponDetail(couponId, loginUserId);
+		return BaseResponse.ok("쿠폰 상세 조회 완료", response, HttpStatus.OK);
+	}
+
+	@PatchMapping("/{couponId}")
+	@Operation(summary = "쿠폰 수정", description = "관리자가 쿠폰 정보를 수정")
+	public ResponseEntity<BaseResponse<CouponUpdateResponseDto>> updateCoupon(
+		@PathVariable Long couponId,
+		@Valid @RequestBody CouponUpdateRequestDto request,
+		@LoginUser Long loginUserId
+	) {
+		CouponUpdateResponseDto response = adminCouponService.updateCoupon(couponId, request, loginUserId);
+		return BaseResponse.ok("쿠폰 수정이 완료되었습니다.", response, HttpStatus.OK);
+	}
+
+	@DeleteMapping("/{couponId}")
+	@Operation(summary = "쿠폰 삭제", description = "관리자가 쿠폰을 삭제")
+	public ResponseEntity<BaseResponse<CouponDeleteResponseDto>> deleteCoupon(
+		@PathVariable Long couponId,
+		@LoginUser Long loginUserId
+	) {
+		CouponDeleteResponseDto response = adminCouponService.deleteCoupon(couponId, loginUserId);
+		return BaseResponse.ok("쿠폰 삭제가 완료되었습니다.", response, HttpStatus.OK);
+	}
+
 }

src/main/java/com/threestar/trainus/domain/coupon/admin/dto/CouponCreateRequestDto.java

@@ -26,7 +26,7 @@ public record CouponCreateRequestDto(
 	Integer minOrderPrice,
 
 	@NotNull(message = "쿠폰 상태는 필수입니다")
-	CouponStatus status,
+	CouponStatus status, //TODO : 일단은 내가 상태설정하게 두고, 리팩토링때 스케줄러로 처리하도록 변경
 
 	@Min(value = 1, message = "수량은 1개 이상이어야 합니다")
 	Integer quantity,

src/main/java/com/threestar/trainus/domain/coupon/admin/dto/CouponDeleteResponseDto.java

@@ -0,0 +1,13 @@
+package com.threestar.trainus.domain.coupon.admin.dto;
+
+import java.time.LocalDateTime;
+
+/**
+ * 쿠폰 삭제 응답 DTO
+ */
+public record CouponDeleteResponseDto(
+	Long couponId,
+	String couponName,
+	LocalDateTime deletedAt
+) {
+}

src/main/java/com/threestar/trainus/domain/coupon/admin/dto/CouponDetailResponseDto.java

@@ -0,0 +1,26 @@
+package com.threestar.trainus.domain.coupon.admin.dto;
+
+import java.time.LocalDateTime;
+
+import com.threestar.trainus.domain.coupon.user.entity.CouponCategory;
+import com.threestar.trainus.domain.coupon.user.entity.CouponStatus;
+
+/**
+ * 쿠폰 상세 조회 응답 DTO
+ */
+public record CouponDetailResponseDto(
+	Long id,
+	String couponName,
+	LocalDateTime expirationDate,
+	String discountPrice,
+	Integer minOrderPrice,
+	CouponStatus status,
+	Integer quantity,
+	CouponCategory couponCategory,
+	LocalDateTime couponOpenAt,
+	LocalDateTime couponDeadlineAt,
+	LocalDateTime createdAt,
+	LocalDateTime updatedAt,
+	Integer issuedCount
+) {
+}

src/main/java/com/threestar/trainus/domain/coupon/admin/dto/CouponListItemDto.java

@@ -0,0 +1,25 @@
+package com.threestar.trainus.domain.coupon.admin.dto;
+
+import java.time.LocalDateTime;
+
+import com.threestar.trainus.domain.coupon.user.entity.CouponCategory;
+import com.threestar.trainus.domain.coupon.user.entity.CouponStatus;
+
+/**
+ * 개별의 쿠폰 정보
+ */
+public record CouponListItemDto(
+	Long couponId,
+	String couponName,
+	LocalDateTime expirationDate,
+	String discountPrice,
+	Integer minOrderPrice,
+	LocalDateTime createdAt,
+	LocalDateTime updatedAt,
+	CouponStatus status,
+	Integer quantity,
+	CouponCategory category,
+	LocalDateTime couponOpenAt,
+	LocalDateTime couponDeadlineAt
+) {
+}

src/main/java/com/threestar/trainus/domain/coupon/admin/dto/CouponListResponseDto.java

@@ -0,0 +1,9 @@
+package com.threestar.trainus.domain.coupon.admin.dto;
+
+import java.util.List;
+
+public record CouponListResponseDto(
+	Integer totalCount,
+	List<CouponListItemDto> couponList
+) {
+}

src/main/java/com/threestar/trainus/domain/coupon/admin/dto/CouponListWrapperDto.java

@@ -0,0 +1,8 @@
+package com.threestar.trainus.domain.coupon.admin.dto;
+
+import java.util.List;
+
+public record CouponListWrapperDto(
+	List<CouponListItemDto> coupons
+) {
+}

src/main/java/com/threestar/trainus/domain/coupon/admin/dto/CouponUpdateRequestDto.java

@@ -0,0 +1,32 @@
+package com.threestar.trainus.domain.coupon.admin.dto;
+
+import java.time.LocalDateTime;
+
+import com.threestar.trainus.domain.coupon.user.entity.CouponCategory;
+import com.threestar.trainus.domain.coupon.user.entity.CouponStatus;
+
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.Size;
+
+/**
+ * 쿠폰 수정 요청 DTO
+ * 일반쿠폰(NORMAL): 수량은 프론트에서 비활성화, 백엔드에서 자동으로 null 처리
+ * 선착순쿠폰(OPEN_RUN): 수량 필수 입력
+ */
+public record CouponUpdateRequestDto(
+
+	@Size(max = 45, message = "쿠폰명은 45자 이하여야 합니다")
+	String couponName,
+
+	CouponStatus status,
+
+	@Min(value = 1, message = "수량은 1개 이상이어야 합니다")
+	Integer quantity,
+
+	CouponCategory category,
+
+	LocalDateTime couponOpenAt,
+
+	LocalDateTime couponDeadlineAt
+) {
+}

src/main/java/com/threestar/trainus/domain/coupon/admin/dto/CouponUpdateResponseDto.java

@@ -0,0 +1,20 @@
+package com.threestar.trainus.domain.coupon.admin.dto;
+
+import java.time.LocalDateTime;
+
+import com.threestar.trainus.domain.coupon.user.entity.CouponCategory;
+import com.threestar.trainus.domain.coupon.user.entity.CouponStatus;
+
+/**
+ * 쿠폰 수정 응답 DTO
+ */
+public record CouponUpdateResponseDto(
+	String couponName,
+	CouponStatus status,
+	Integer quantity,
+	CouponCategory category,
+	LocalDateTime couponOpenAt,
+	LocalDateTime couponDeadlineAt,
+	LocalDateTime updatedAt
+) {
+}

src/main/java/com/threestar/trainus/domain/coupon/admin/mapper/AdminCouponMapper.java

@@ -1,7 +1,15 @@
 package com.threestar.trainus.domain.coupon.admin.mapper;
 
+import org.springframework.data.domain.Page;
+
 import com.threestar.trainus.domain.coupon.admin.dto.CouponCreateRequestDto;
 import com.threestar.trainus.domain.coupon.admin.dto.CouponCreateResponseDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponDeleteResponseDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponDetailResponseDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponListItemDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponListResponseDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponListWrapperDto;
+import com.threestar.trainus.domain.coupon.admin.dto.CouponUpdateResponseDto;
 import com.threestar.trainus.domain.coupon.user.entity.Coupon;
 
 public class AdminCouponMapper {
@@ -31,4 +39,72 @@ public static CouponCreateResponseDto toCreateResponseDto(Coupon coupon) {
 			coupon.getCreatedAt()
 		);
 	}
+
+	public static CouponListItemDto toCouponListItemDto(Coupon coupon) {
+		return new CouponListItemDto(
+			coupon.getId(),
+			coupon.getName(),
+			coupon.getExpirationDate(),
+			coupon.getDiscountPrice(),
+			coupon.getMinOrderPrice(),
+			coupon.getCreatedAt(),
+			coupon.getUpdatedAt(),
+			coupon.getStatus(),
+			coupon.getQuantity(),
+			coupon.getCategory(),
+			coupon.getOpenAt(),
+			coupon.getCloseAt()
+		);
+	}
+
+	public static CouponListResponseDto toCouponListResponseDto(Page<Coupon> couponPage) {
+		return new CouponListResponseDto(
+			(int)couponPage.getTotalElements(),
+			couponPage.getContent().stream()
+				.map(AdminCouponMapper::toCouponListItemDto)
+				.toList()
+		);
+	}
+
+	public static CouponDetailResponseDto toCouponDetailResponseDto(Coupon coupon, Integer issuedCount) {
+		return new CouponDetailResponseDto(
+			coupon.getId(),
+			coupon.getName(),
+			coupon.getExpirationDate(),
+			coupon.getDiscountPrice(),
+			coupon.getMinOrderPrice(),
+			coupon.getStatus(),
+			coupon.getQuantity(),
+			coupon.getCategory(),
+			coupon.getOpenAt(),
+			coupon.getCloseAt(),
+			coupon.getCreatedAt(),
+			coupon.getUpdatedAt(),
+			issuedCount
+		);
+	}
+
+	public static CouponUpdateResponseDto toCouponUpdateResponseDto(Coupon coupon) {
+		return new CouponUpdateResponseDto(
+			coupon.getName(),
+			coupon.getStatus(),
+			coupon.getQuantity(),
+			coupon.getCategory(),
+			coupon.getOpenAt(),
+			coupon.getCloseAt(),
+			coupon.getUpdatedAt()
+		);
+	}
+
+	public static CouponDeleteResponseDto toCouponDeleteResponseDto(Coupon coupon) {
+		return new CouponDeleteResponseDto(
+			coupon.getId(),
+			coupon.getName(),
+			coupon.getDeletedAt()
+		);
+	}
+
+	public static CouponListWrapperDto toCouponListWrapperDto(CouponListResponseDto couponsInfo) {
+		return new CouponListWrapperDto(couponsInfo.couponList());
+	}
 }