[FEAT] 구매 관리 api 구현

build.gradle

@@ -5,7 +5,7 @@ plugins {
 }
 
 group = 'com.sampoom'
-version = '0.0.1-SNAPSHOT'
+version = '1.0.0'
 description = 'Demo project for Spring Boot'
 
 java {

src/main/java/com/sampoom/purchase/api/purchase/controller/PurchaseController.java

@@ -0,0 +1,66 @@
+package com.sampoom.purchase.api.purchase.controller;
+
+import com.sampoom.purchase.api.purchase.dto.PurchaseOrderRequestDto;
+import com.sampoom.purchase.api.purchase.dto.PurchaseOrderResponseDto;
+import com.sampoom.purchase.api.purchase.entity.OrderStatus;
+import com.sampoom.purchase.api.purchase.entity.UrgencyLevel;
+import com.sampoom.purchase.api.purchase.service.PurchaseService;
+import com.sampoom.purchase.common.response.ApiResponse;
+import com.sampoom.purchase.common.response.PageResponseDto;
+import com.sampoom.purchase.common.response.SuccessStatus;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+@Tag(name = "Purchase", description = "Purchase 관련 API 입니다.")
+@RestController
+@RequiredArgsConstructor
+public class PurchaseController {
+
+    private final PurchaseService purchaseService;
+
+    @Operation(summary = "자재 주문 생성", description = "공장에 필요한 자재 주문을 생성합니다.")
+    @PostMapping()
+    public ResponseEntity<ApiResponse<PurchaseOrderResponseDto>> createMaterialOrder(
+            @RequestBody PurchaseOrderRequestDto requestDto) {
+        return ApiResponse.success(SuccessStatus.CREATED,
+                purchaseService.createMaterialOrder(requestDto));
+    }
+
+
+
+    @Operation(summary = "자재 주문 취소", description = "주문을 취소 처리합니다.")
+    @PatchMapping("/{orderId}/cancel")
+    public ResponseEntity<ApiResponse<PurchaseOrderResponseDto>> cancelOrder(
+            @PathVariable Long orderId) {
+        return ApiResponse.success(SuccessStatus.OK, purchaseService.cancelOrder(orderId));
+    }
+
+    @Operation(summary = "자재 주문 삭제", description = "주문을 삭제합니다(소프트 삭제).")
+    @DeleteMapping("/{orderId}")
+    public ResponseEntity<ApiResponse<Void>> deleteOrder(
+            @PathVariable Long orderId) {
+        purchaseService.deleteOrder(orderId);
+        return ApiResponse.success_only(SuccessStatus.OK);
+    }
+
+    @Operation(summary = "자재 주문 단건 조회", description = "특정 자재 주문의 상세를 조회합니다.")
+    @GetMapping("/{orderId}")
+    public ResponseEntity<ApiResponse<PurchaseOrderResponseDto>> getOrder(
+            @PathVariable Long orderId) {
+        return ApiResponse.success(SuccessStatus.OK, purchaseService.getOrder(orderId));
+    }
+
+    @Operation(summary = "자재 주문 목록 조회", description = "주문 상태 필터와 검색(자재명/자재코드/주문코드), 긴급도 필터로 목록을 조회합니다.")
+    @GetMapping()
+    public ResponseEntity<ApiResponse<PageResponseDto<PurchaseOrderResponseDto>>> getOrders(
+            @RequestParam(required = false) OrderStatus status,
+            @RequestParam(required = false) UrgencyLevel urgency,
+            @RequestParam(required = false) String query,
+            @RequestParam(defaultValue = "0") int page,
+            @RequestParam(defaultValue = "10") int size) {
+        return ApiResponse.success(SuccessStatus.OK, purchaseService.getOrders(status, urgency, query, page, size));
+    }
+}

src/main/java/com/sampoom/purchase/api/purchase/dto/PurchaseOrderItemDto.java

@@ -0,0 +1,31 @@
+package com.sampoom.purchase.api.purchase.dto;
+
+import com.sampoom.purchase.api.purchase.entity.PurchaseOrderItem;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class PurchaseOrderItemDto {
+    private String materialCode;
+    private String materialName;
+    private String unit;
+    private Long quantity;
+    private BigDecimal unitPrice;
+
+    public static PurchaseOrderItemDto from(PurchaseOrderItem item) {
+        return PurchaseOrderItemDto.builder()
+                .materialCode(item.getMaterialCode())
+                .materialName(item.getMaterialName())
+                .unit(item.getUnit())
+                .quantity(item.getQuantity())
+                .unitPrice(item.getUnitPrice())
+                .build();
+    }
+}

src/main/java/com/sampoom/purchase/api/purchase/dto/PurchaseOrderRequestDto.java

@@ -0,0 +1,27 @@
+package com.sampoom.purchase.api.purchase.dto;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDate;
+import java.util.List;
+
+@Getter
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class PurchaseOrderRequestDto {
+    private Long factoryId;
+    private String factoryName;
+
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    private LocalDate requiredAt;
+
+    private String requesterName; // 요청자 이름 추가
+
+    private List<PurchaseOrderItemDto> items;
+}

src/main/java/com/sampoom/purchase/api/purchase/dto/PurchaseOrderResponseDto.java

@@ -0,0 +1,54 @@
+package com.sampoom.purchase.api.purchase.dto;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.sampoom.purchase.api.purchase.entity.OrderStatus;
+import com.sampoom.purchase.api.purchase.entity.PurchaseOrder;
+import com.sampoom.purchase.api.purchase.entity.PurchaseOrderItem;
+import com.sampoom.purchase.api.purchase.entity.UrgencyLevel;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.stream.Collectors;
+
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
+@Builder
+public class PurchaseOrderResponseDto {
+    private Long id;
+    private String orderCode;
+    private LocalDateTime orderAt;
+
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    private LocalDate requiredAt; // 날짜만
+
+    private Long factoryId;
+    private String factoryName;
+    private String requesterName;
+    private UrgencyLevel urgency;
+    private BigDecimal expectedAmount;
+    private OrderStatus status;
+    private List<PurchaseOrderItemDto> items;
+
+    public static PurchaseOrderResponseDto from(PurchaseOrder order, List<PurchaseOrderItem> orderItems) {
+        return PurchaseOrderResponseDto.builder()
+                .id(order.getId())
+                .status(order.getStatus())
+                .orderCode(order.getCode())
+                .orderAt(order.getOrderAt())
+                .requiredAt(order.getRequiredAt())
+                .factoryId(order.getFactoryId())
+                .factoryName(order.getFactoryName())
+                .requesterName(order.getRequesterName())
+                .urgency(order.getUrgency())
+                .expectedAmount(order.getExpectedAmount())
+                .items(orderItems.stream().map(PurchaseOrderItemDto::from).collect(Collectors.toList()))
+                .build();
+    }
+}

src/main/java/com/sampoom/purchase/api/purchase/entity/OrderStatus.java

@@ -0,0 +1,8 @@
+package com.sampoom.purchase.api.purchase.entity;
+
+
+public enum OrderStatus {
+    ORDERED,    // 주문됨
+    RECEIVED,    // 입고됨
+    CANCELED   // 발주 취소됨
+}

src/main/java/com/sampoom/purchase/api/purchase/entity/PurchaseOrder.java

@@ -0,0 +1,69 @@
+package com.sampoom.purchase.api.purchase.entity;
+
+import com.sampoom.purchase.common.entitiy.SoftDeleteEntity;
+import com.sampoom.purchase.common.exception.BadRequestException;
+import com.sampoom.purchase.common.response.ErrorStatus;
+import jakarta.persistence.*;
+import lombok.*;
+import org.hibernate.annotations.SQLDelete;
+import org.hibernate.annotations.SQLRestriction;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Entity
+@Getter
+@Table(name = "purchase_order")
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+@SQLDelete(sql = "UPDATE purchase_order SET deleted = true, deleted_at = now() WHERE purchase_order_id = ?")
+@SQLRestriction("deleted = false")
+public class PurchaseOrder extends SoftDeleteEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "purchase_order_id")
+    private Long id;
+
+    private String code;
+    private LocalDateTime orderAt;
+    private LocalDateTime receivedAt;
+    private LocalDateTime canceledAt;
+    private LocalDate requiredAt;
+
+
+    @Enumerated(EnumType.STRING)
+    private OrderStatus status;
+
+
+    private Long factoryId;
+
+    private String factoryName;
+
+    @Enumerated(EnumType.STRING)
+    private UrgencyLevel urgency; // 긴급도
+
+    private String requesterName;  // 요청자 이름
+
+    @Column(precision = 19, scale = 2)
+    private BigDecimal expectedAmount; // 예상 금액
+
+    public void receive() {
+        if (this.status != OrderStatus.ORDERED) {
+            throw new BadRequestException(ErrorStatus.ORDER_ALREADY_PROCESSED);
+        }
+        this.status = OrderStatus.RECEIVED;
+        this.receivedAt = LocalDateTime.now();
+    }
+
+    public void cancel() {
+
+        if (this.status != OrderStatus.ORDERED) {
+            throw new BadRequestException(ErrorStatus.ORDER_ALREADY_PROCESSED);
+        }
+        this.status = OrderStatus.CANCELED;
+        this.canceledAt = LocalDateTime.now();
+    }
+}

src/main/java/com/sampoom/purchase/api/purchase/entity/PurchaseOrderItem.java

@@ -0,0 +1,34 @@
+package com.sampoom.purchase.api.purchase.entity;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.math.BigDecimal;
+
+@Entity
+@Getter
+@Table(name = "purchase_order_item")
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+public class PurchaseOrderItem {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "purchase_order_item_id")
+    private Long id;
+
+    private Long quantity;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "purchase_order_id")
+    private PurchaseOrder purchaseOrder;
+
+    private String materialCode;
+
+    private String materialName;
+
+    private String unit;
+
+    @Column(precision = 19, scale = 2)
+    private BigDecimal unitPrice;
+}

src/main/java/com/sampoom/purchase/api/purchase/entity/UrgencyLevel.java

@@ -0,0 +1,8 @@
+package com.sampoom.purchase.api.purchase.entity;
+
+public enum UrgencyLevel {
+    HIGH,
+    MEDIUM,
+    LOW
+}
+

src/main/java/com/sampoom/purchase/api/purchase/repository/PurchaseOrderItemRepository.java

@@ -0,0 +1,11 @@
+package com.sampoom.purchase.api.purchase.repository;
+
+import com.sampoom.purchase.api.purchase.entity.PurchaseOrderItem;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+public interface PurchaseOrderItemRepository extends JpaRepository<PurchaseOrderItem, Long> {
+    List<PurchaseOrderItem> findByPurchaseOrderId(Long purchaseOrderId);
+    List<PurchaseOrderItem> findByPurchaseOrderIdIn(List<Long> orderIds);
+}

src/main/java/com/sampoom/purchase/api/purchase/repository/PurchaseOrderRepository.java

@@ -0,0 +1,28 @@
+package com.sampoom.purchase.api.purchase.repository;
+
+import com.sampoom.purchase.api.purchase.entity.OrderStatus;
+import com.sampoom.purchase.api.purchase.entity.PurchaseOrder;
+import com.sampoom.purchase.api.purchase.entity.UrgencyLevel;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+import java.util.Optional;
+
+public interface PurchaseOrderRepository extends JpaRepository<PurchaseOrder, Long> {
+
+    @Query("select distinct po from PurchaseOrder po left join PurchaseOrderItem i on i.purchaseOrder = po " +
+            "where (:status is null or po.status = :status) " +
+            "and (:urgency is null or po.urgency = :urgency) " +
+            "and (:query is null or :query = '' or lower(po.code) like lower(concat('%', :query, '%')) " +
+            "or lower(i.materialCode) like lower(concat('%', :query, '%')) " +
+            "or lower(i.materialName) like lower(concat('%', :query, '%')))" )
+    Page<PurchaseOrder> search(@Param("status") OrderStatus status,
+                               @Param("urgency") UrgencyLevel urgency,
+                               @Param("query") String query,
+                               Pageable pageable);
+
+    Optional<PurchaseOrder> findTopByCodeStartingWithOrderByCodeDesc(String prefix);
+}