feat: 주문 상점 전환 POST API를 추가하다

src/main/java/in/koreatech/koin/domain/shop/model/shop/Shop.java

@@ -335,4 +335,8 @@ public void cancelDelete() {
     public String getFullAddress() {
         return String.join(" ", this.address, this.addressDetail);
     }
+
+    public boolean isOwner(Integer ownerId) {
+        return this.owner != null && this.owner.getId().equals(ownerId);
+    }
 }

src/main/java/in/koreatech/koin/domain/shoptoOrderable/controller/ShopToOrderableApi.java

@@ -0,0 +1,39 @@
+package in.koreatech.koin.domain.shoptoOrderable.controller;
+
+import static in.koreatech.koin.domain.user.model.UserType.OWNER;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+
+import in.koreatech.koin.domain.shoptoOrderable.dto.ShopToOrderableRequest;
+import in.koreatech.koin.global.auth.Auth;
+import in.koreatech.koin.global.code.ApiResponseCode;
+import in.koreatech.koin.global.code.ApiResponseCodes;
+import in.koreatech.koin.global.duplicate.DuplicateGuard;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.security.SecurityRequirement;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+
+@Tag(name = "(Normal) Shop To Orderable Request: 주문 서비스 가입 요청", description = "사장님이 주문 서비스 가입을 요청하기위한 API")
+public interface ShopToOrderableApi {
+
+    @ApiResponseCodes({
+        ApiResponseCode.OK,
+        ApiResponseCode.ILLEGAL_ARGUMENT,
+        ApiResponseCode.FORBIDDEN_USER_TYPE,
+        ApiResponseCode.NOT_FOUND_USER,
+        ApiResponseCode.NOT_FOUND_SHOP,
+    })
+    @Operation(summary = "사장님 주문 서비스 가입 요청")
+    @SecurityRequirement(name = "Jwt Authentication")
+    @PostMapping("/owner/shops/{shopId}/orderable-requests")
+    @DuplicateGuard(key = "#ownerId + ':' + #shopId + ':' + #request.toString()", timeoutSeconds = 300)
+    ResponseEntity<Void> createOrderableRequest(
+        @Auth(permit = {OWNER}) Integer ownerId,
+        @PathVariable Integer shopId,
+        @RequestBody @Valid ShopToOrderableRequest request
+    );
+}

src/main/java/in/koreatech/koin/domain/shoptoOrderable/controller/ShopToOrderableController.java

@@ -0,0 +1,38 @@
+package in.koreatech.koin.domain.shoptoOrderable.controller;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import in.koreatech.koin.domain.shoptoOrderable.dto.ShopToOrderableRequest;
+import in.koreatech.koin.domain.shoptoOrderable.service.ShopToOrderableService;
+import in.koreatech.koin.global.duplicate.DuplicateGuard;
+import lombok.RequiredArgsConstructor;
+
+import static in.koreatech.koin.domain.user.model.UserType.OWNER;
+
+import org.springframework.web.bind.annotation.RequestBody;
+
+import in.koreatech.koin.global.auth.Auth;
+import jakarta.validation.Valid;
+
+//Todo: ShopToOrderable 이라는 명칭은 임시임 추후 변경
+@RestController
+@RequiredArgsConstructor
+public class ShopToOrderableController implements ShopToOrderableApi {
+
+    private final ShopToOrderableService shopToOrderableService;
+
+    @PostMapping("/owner/shops/{shopId}/orderable-requests")
+    @DuplicateGuard(key = "#ownerId + ':' + #shopId + ':' + #request.toString()", timeoutSeconds = 300)
+    public ResponseEntity<Void> createOrderableRequest(
+        @Auth(permit = {OWNER}) Integer ownerId,
+        @PathVariable Integer shopId,
+        @RequestBody @Valid ShopToOrderableRequest request
+    ) {
+        shopToOrderableService.createOrderableRequest(ownerId, request, shopId);
+        return ResponseEntity.status(HttpStatus.CREATED).build();
+    }
+}

src/main/java/in/koreatech/koin/domain/shoptoOrderable/dto/ShopToOrderableRequest.java

@@ -0,0 +1,63 @@
+package in.koreatech.koin.domain.shoptoOrderable.dto;
+
+import static io.swagger.v3.oas.annotations.media.Schema.RequiredMode.REQUIRED;
+
+import com.fasterxml.jackson.databind.PropertyNamingStrategies.SnakeCaseStrategy;
+import com.fasterxml.jackson.databind.annotation.JsonNaming;
+
+import in.koreatech.koin.domain.shoptoOrderable.model.ShopToOrderableDeliveryOption;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+
+@JsonNaming(SnakeCaseStrategy.class)
+public record ShopToOrderableRequest(
+
+    @Schema(description = "최소 주문 금액", example = "5000", requiredMode = REQUIRED)
+    @NotNull(message = "최소 주문 금액은 필수입니다.")
+    @Min(value = 0, message = "최소 주문 금액은 0원 이상이어야 합니다.")
+    Integer minimumOrderAmount,
+
+    @Schema(description = "포장 가능 여부", example = "true", requiredMode = REQUIRED)
+    @NotNull(message = "포장 가능 여부는 필수입니다.")
+    Boolean isTakeout,
+
+    @Schema(description = "배달 옵션 (CAMPUS/OUTSIDE/BOTH)", example = "BOTH", requiredMode = REQUIRED)
+    @NotNull(message = "배달 옵션은 필수입니다.")
+    ShopToOrderableDeliveryOption deliveryOption,
+
+    @Schema(description = "교내 배달팁", example = "1000", requiredMode = REQUIRED)
+    @NotNull(message = "교내 배달팁은 필수입니다.")
+    @Min(value = 0, message = "교내 배달팁은 0원 이상이어야 합니다.")
+    Integer campusDeliveryTip,
+
+    @Schema(description = "교외 배달팁", example = "2000", requiredMode = REQUIRED)
+    @NotNull(message = "교외 배달팁은 필수입니다.")
+    @Min(value = 0, message = "교외 배달팁은 0원 이상이어야 합니다.")
+    Integer offCampusDeliveryTip,
+
+    @Schema(description = "사업자 등록증 URL", example = "https://example.com/business_license.jpg", requiredMode = REQUIRED)
+    @NotBlank(message = "사업자 등록증 URL은 필수입니다.")
+    String businessLicenseUrl,
+
+    @Schema(description = "영업 신고증 URL", example = "https://example.com/business_certificate.jpg", requiredMode = REQUIRED)
+    @NotBlank(message = "영업 신고증 URL은 필수입니다.")
+    String businessCertificateUrl,
+
+    @Schema(description = "통장 사본 URL", example = "https://example.com/bank_copy.jpg", requiredMode = REQUIRED)
+    @NotBlank(message = "통장 사본 URL은 필수입니다.")
+    String bankCopyUrl,
+
+    @Schema(description = "은행명", example = "국민은행", requiredMode = REQUIRED)
+    @NotBlank(message = "은행명은 필수입니다.")
+    @Size(max = 10, message = "은행명은 10자 이하여야 합니다.")
+    String bank,
+
+    @Schema(description = "계좌번호", example = "123-456-789", requiredMode = REQUIRED)
+    @NotBlank(message = "계좌번호는 필수입니다.")
+    @Size(max = 20, message = "계좌번호는 20자 이하여야 합니다.")
+    String accountNumber
+) {
+}

src/main/java/in/koreatech/koin/domain/shoptoOrderable/model/ShopToOrderable.java

@@ -0,0 +1,125 @@
+package in.koreatech.koin.domain.shoptoOrderable.model;
+
+import static lombok.AccessLevel.PROTECTED;
+
+import in.koreatech.koin.common.model.BaseEntity;
+import in.koreatech.koin.domain.shop.model.shop.Shop;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EnumType;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.Table;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+
+import java.time.LocalDateTime;
+
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Getter
+@Table(name = "shop_to_orderable")
+@NoArgsConstructor(access = PROTECTED)
+public class ShopToOrderable extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Integer id;
+
+    @NotNull
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "shop_id", nullable = false)
+    private Shop shop;
+
+    @NotNull
+    @Column(name = "minimum_order_amount", nullable = false)
+    private Integer minimumOrderAmount;
+
+    @Column(name = "is_takeout", nullable = false)
+    private Boolean isTakeout = false;
+
+    @NotNull
+    @Enumerated(EnumType.STRING)
+    @Column(name = "delivery_option", nullable = false)
+    private ShopToOrderableDeliveryOption deliveryOption;
+
+    @Column(name = "campus_delivery_tip", nullable = false)
+    private Integer campusDeliveryTip = 0;
+
+    @Column(name = "off_campus_delivery_tip", nullable = false)
+    private Integer offCampusDeliveryTip = 0;
+
+    @NotNull
+    @Column(name = "business_license_url", nullable = false)
+    private String businessLicenseUrl;
+
+    @NotNull
+    @Column(name = "business_certificate_url", nullable = false)
+    private String businessCertificateUrl;
+
+    @NotNull
+    @Column(name = "bank_copy_url", nullable = false)
+    private String bankCopyUrl;
+
+    @NotNull
+    @Size(max = 10)
+    @Column(name = "bank", length = 10, nullable = false)
+    private String bank;
+
+    @NotNull
+    @Size(max = 20)
+    @Column(name = "account_number", length = 20, nullable = false)
+    private String accountNumber;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "request_status", nullable = false)
+    private ShopToOrderableRequestStatus requestStatus = ShopToOrderableRequestStatus.PENDING;
+
+    @Column(name = "approved_at", columnDefinition = "TIMESTAMP")
+    private LocalDateTime approvedAt = null;
+
+    @Builder
+    public ShopToOrderable(
+        Shop shop,
+        Integer minimumOrderAmount,
+        Boolean isTakeout,
+        ShopToOrderableDeliveryOption deliveryOption,
+        Integer campusDeliveryTip,
+        Integer offCampusDeliveryTip,
+        String businessLicenseUrl,
+        String businessCertificateUrl,
+        String bankCopyUrl,
+        String bank,
+        String accountNumber
+    ) {
+        this.shop = shop;
+        this.minimumOrderAmount = minimumOrderAmount;
+        this.isTakeout = isTakeout;
+        this.deliveryOption = deliveryOption;
+        this.campusDeliveryTip = campusDeliveryTip;
+        this.offCampusDeliveryTip = offCampusDeliveryTip;
+        this.businessLicenseUrl = businessLicenseUrl;
+        this.businessCertificateUrl = businessCertificateUrl;
+        this.bankCopyUrl = bankCopyUrl;
+        this.bank = bank;
+        this.accountNumber = accountNumber;
+        this.approvedAt = null;
+    }
+
+    public void approveRequest() {
+        this.requestStatus = ShopToOrderableRequestStatus.APPROVED;
+        this.approvedAt = LocalDateTime.now();
+    }
+
+    public void rejectRequest() {
+        this.requestStatus = ShopToOrderableRequestStatus.REJECTED;
+    }
+}

src/main/java/in/koreatech/koin/domain/shoptoOrderable/model/ShopToOrderableDeliveryOption.java

@@ -0,0 +1,7 @@
+package in.koreatech.koin.domain.shoptoOrderable.model;
+
+public enum ShopToOrderableDeliveryOption {
+    CAMPUS,
+    OUTSIDE,
+    BOTH
+}

src/main/java/in/koreatech/koin/domain/shoptoOrderable/model/ShopToOrderableRequestStatus.java

@@ -0,0 +1,5 @@
+package in.koreatech.koin.domain.shoptoOrderable.model;
+
+public enum ShopToOrderableRequestStatus {
+    PENDING, APPROVED, REJECTED
+}

src/main/java/in/koreatech/koin/domain/shoptoOrderable/repository/ShopToOrderableRepository.java

@@ -0,0 +1,15 @@
+package in.koreatech.koin.domain.shoptoOrderable.repository;
+
+import in.koreatech.koin.domain.shoptoOrderable.model.ShopToOrderable;
+import in.koreatech.koin.domain.shoptoOrderable.model.ShopToOrderableRequestStatus;
+
+import org.springframework.data.repository.Repository;
+
+public interface ShopToOrderableRepository extends Repository<ShopToOrderable, Integer> {
+
+    ShopToOrderable save(ShopToOrderable shopToOrderable);
+
+    boolean existsByShopId(Integer shopId);
+
+    boolean existsByShopIdAndRequestStatus(Integer shopId, ShopToOrderableRequestStatus requestStatus);
+}

src/main/java/in/koreatech/koin/domain/shoptoOrderable/service/ShopToOrderableService.java

@@ -0,0 +1,66 @@
+package in.koreatech.koin.domain.shoptoOrderable.service;
+
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import in.koreatech.koin.domain.shop.model.shop.Shop;
+import in.koreatech.koin.domain.shop.repository.shop.ShopRepository;
+import in.koreatech.koin.domain.shoptoOrderable.dto.ShopToOrderableRequest;
+import in.koreatech.koin.domain.shoptoOrderable.model.ShopToOrderable;
+import in.koreatech.koin.domain.shoptoOrderable.repository.ShopToOrderableRepository;
+import in.koreatech.koin.global.exception.CustomException;
+import lombok.RequiredArgsConstructor;
+
+import static in.koreatech.koin.domain.shoptoOrderable.model.ShopToOrderableRequestStatus.*;
+import static in.koreatech.koin.global.code.ApiResponseCode.*;
+
+@Service
+@RequiredArgsConstructor
+public class ShopToOrderableService {
+
+    private final ShopToOrderableRepository shopToOrderableRepository;
+    private final ShopRepository shopRepository;
+
+    @Transactional
+    public void createOrderableRequest(Integer ownerId, ShopToOrderableRequest request, Integer shopId) {
+        Shop shop = shopRepository.getById(shopId);
+
+        validateShopOwner(shop, ownerId);
+        validateDuplicateRequest(shop);
+
+        ShopToOrderable shopToOrderable = ShopToOrderable.builder()
+            .shop(shop)
+            .minimumOrderAmount(request.minimumOrderAmount())
+            .isTakeout(request.isTakeout())
+            .deliveryOption(request.deliveryOption())
+            .campusDeliveryTip(request.campusDeliveryTip())
+            .offCampusDeliveryTip(request.offCampusDeliveryTip())
+            .businessLicenseUrl(request.businessLicenseUrl())
+            .businessCertificateUrl(request.businessCertificateUrl())
+            .bankCopyUrl(request.bankCopyUrl())
+            .bank(request.bank())
+            .accountNumber(request.accountNumber())
+            .build();
+
+        shopToOrderableRepository.save(shopToOrderable);
+    }
+
+    private void validateShopOwner(Shop shop, Integer ownerId) {
+        // 가게 사장님인지 확인
+        if (!shop.isOwner(ownerId)) {
+            throw CustomException.of(FORBIDDEN_SHOP_OWNER, "ownerId: " + ownerId + ", shopId: " + shop.getId());
+        }
+    }
+
+    private void validateDuplicateRequest(Shop shop) {
+        // 이미 신청한 내역이 있는지 확인
+        if (shopToOrderableRepository.existsByShopIdAndRequestStatus(shop.getId(), PENDING)) {
+            throw CustomException.of(DUPLICATE_REQUESTED_ORDERABLE_SHOP, "shopId: " + shop.getId());
+        }
+
+        // 이미 주문가능 상점인지 확인
+        if (shopToOrderableRepository.existsByShopIdAndRequestStatus(shop.getId(), APPROVED)) {
+            throw CustomException.of(DUPLICATE_ORDERABLE_SHOP, "shopId: " + shop.getId());
+        }
+    }
+}