feat: 발주 기반 입고 생성 기능 구현

src/main/java/com/almang/inventory/global/api/SuccessMessage.java

@@ -46,6 +46,9 @@ public enum SuccessMessage {
     GET_ORDER_ITEM_SUCCESS("발주 아이템 조회 성공"),
     UPDATE_ORDER_ITEM_SUCCESS("발주 아이템 수정 성공"),
     DELETE_ORDER_SUCCESS("발주 삭제 성공"),
+
+    // RECEIPT
+    CREATE_RECEIPT_FROM_ORDER_SUCCESS("발주 기반 입고 생성 성공"),
     ;
 
     private final String message;

src/main/java/com/almang/inventory/global/exception/ErrorCode.java

@@ -44,6 +44,9 @@ public enum ErrorCode {
     VENDOR_CHANGE_NOT_ALLOWED(HttpStatus.FORBIDDEN, "해당 발주를 변경할 수 없습니다."),
     ORDER_ITEM_NOT_FOUND(HttpStatus.NOT_FOUND, "발주 상품을 찾을 수 없습니다."),
     ORDER_ITEM_ACCESS_DENIED(HttpStatus.FORBIDDEN, "해당 발주의 발주 항목이 아닙니다."),
+
+    // RECEIPT
+    RECEIPT_CREATION_NOT_ALLOWED_FROM_ORDER(HttpStatus.BAD_REQUEST, "해당 발주 상태에서는 입고를 생성할 수 없습니다."),
     ;
 
     private final HttpStatus httpStatus;

src/main/java/com/almang/inventory/receipt/controller/ReceiptController.java

@@ -0,0 +1,40 @@
+package com.almang.inventory.receipt.controller;
+
+import com.almang.inventory.global.api.ApiResponse;
+import com.almang.inventory.global.api.SuccessMessage;
+import com.almang.inventory.global.security.principal.CustomUserPrincipal;
+import com.almang.inventory.receipt.dto.response.ReceiptResponse;
+import com.almang.inventory.receipt.service.ReceiptService;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+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;
+
+@Slf4j
+@RestController
+@RequestMapping("/api/v1/receipt")
+@RequiredArgsConstructor
+@Tag(name = "Receipt", description = "입고 관련 API")
+public class ReceiptController {
+
+    private final ReceiptService receiptService;
+
+    @PostMapping("/from-order/{orderId}")
+    public ResponseEntity<ApiResponse<ReceiptResponse>> createReceiptFromOrder(
+            @PathVariable Long orderId,
+            @AuthenticationPrincipal CustomUserPrincipal userPrincipal
+    ) {
+        Long userId = userPrincipal.getId();
+        log.info("[ReceiptController] 발주 기반 입고 생성 요청 - userId: {}, orderId: {}", userId, orderId);
+        ReceiptResponse response = receiptService.createReceiptFromOrder(orderId, userId);
+
+        return ResponseEntity.ok(
+                ApiResponse.success(SuccessMessage.CREATE_RECEIPT_FROM_ORDER_SUCCESS.getMessage(), response)
+        );
+    }
+}

src/main/java/com/almang/inventory/receipt/domain/Receipt.java

@@ -0,0 +1,77 @@
+package com.almang.inventory.receipt.domain;
+
+import com.almang.inventory.global.entity.BaseTimeEntity;
+import com.almang.inventory.order.domain.Order;
+import com.almang.inventory.store.domain.Store;
+import jakarta.persistence.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+import lombok.*;
+
+@Entity
+@Table(name = "receipts")
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+public class Receipt extends BaseTimeEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "receipt_id")
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "store_id", nullable = false)
+    private Store store;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "order_id", nullable = false)
+    private Order order;
+
+    @Column(name = "receipt_date", nullable = false)
+    private LocalDate receiptDate;
+
+    @Column(name = "total_box_count", nullable = false)
+    private Integer totalBoxCount;
+
+    @Column(name = "total_weight_g", precision = 8, scale = 3)
+    private BigDecimal totalWeightG;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "status", nullable = false)
+    private ReceiptStatus status;
+
+    @Column(name = "is_activate", nullable = false)
+    private boolean activated;
+
+    @OneToMany(mappedBy = "receipt", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
+    private List<ReceiptItem> items = new ArrayList<>();
+
+    public void addItem(ReceiptItem item) {
+        items.add(item);
+        item.setReceipt(this);
+    }
+
+    public void updateTotalBoxCount(Integer totalBoxCount) {
+        if (totalBoxCount != null) {
+            this.totalBoxCount = totalBoxCount;
+        }
+    }
+
+    public void updateTotalWeightG(BigDecimal totalWeightG) {
+        this.totalWeightG = totalWeightG;
+    }
+
+    public void updateReceiptStatus(ReceiptStatus status) {
+        this.status = status;
+    }
+
+    public void deactivate() {
+        this.activated = false;
+        this.status = ReceiptStatus.CANCELED;
+    }
+}

src/main/java/com/almang/inventory/receipt/domain/ReceiptItem.java

@@ -0,0 +1,92 @@
+package com.almang.inventory.receipt.domain;
+
+import com.almang.inventory.global.entity.BaseTimeEntity;
+import com.almang.inventory.product.domain.Product;
+import jakarta.persistence.*;
+import java.math.BigDecimal;
+import lombok.*;
+
+@Entity
+@Table(name = "receipt_items")
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+public class ReceiptItem extends BaseTimeEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "receipt_item_id") // ERD 기준: PK 컬럼명 id
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "receipt_id", nullable = false)
+    private Receipt receipt;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "product_id", nullable = false)
+    private Product product;
+
+    @Column(name = "box_count")
+    private Integer boxCount;
+
+    @Column(name = "measured_weight", precision = 8, scale = 3)
+    private BigDecimal measuredWeight;
+
+    @Column(name = "expected_quantity", precision = 8, scale = 3)
+    private BigDecimal expectedQuantity;
+
+    @Column(name = "actual_quantity")
+    private Integer actualQuantity;
+
+    @Column(name = "unit_price")
+    private Integer unitPrice;
+
+    @Column(name = "amount")
+    private Integer amount;
+
+    @Column(name = "error_rate", precision = 6, scale = 3)
+    private BigDecimal errorRate;
+
+    @Column(name = "note", columnDefinition = "TEXT")
+    private String note;
+
+    public void setReceipt(Receipt receipt) {
+        this.receipt = receipt;
+    }
+
+    public void update(
+            Integer boxCount,
+            BigDecimal measuredWeight,
+            BigDecimal expectedQuantity,
+            Integer actualQuantity,
+            Integer unitPrice,
+            BigDecimal errorRate,
+            String note
+    ) {
+        if (boxCount != null) {
+            this.boxCount = boxCount;
+        }
+        if (measuredWeight != null) {
+            this.measuredWeight = measuredWeight;
+        }
+        if (expectedQuantity != null) {
+            this.expectedQuantity = expectedQuantity;
+        }
+        if (actualQuantity != null) {
+            this.actualQuantity = actualQuantity;
+        }
+        if (unitPrice != null) {
+            this.unitPrice = unitPrice;
+        }
+        if (errorRate != null) {
+            this.errorRate = errorRate;
+        }
+        if (note != null) {
+            this.note = note;
+        }
+        if (this.actualQuantity != null && this.unitPrice != null) {
+            this.amount = this.actualQuantity * this.unitPrice;
+        }
+    }
+}

src/main/java/com/almang/inventory/receipt/domain/ReceiptStatus.java

@@ -0,0 +1,7 @@
+package com.almang.inventory.receipt.domain;
+
+public enum ReceiptStatus {
+    PENDING,
+    CONFIRMED,
+    CANCELED
+}

src/main/java/com/almang/inventory/receipt/dto/response/ReceiptItemResponse.java

@@ -0,0 +1,32 @@
+package com.almang.inventory.receipt.dto.response;
+
+import com.almang.inventory.receipt.domain.ReceiptItem;
+import java.math.BigDecimal;
+
+public record ReceiptItemResponse(
+        Long receiptItemId,
+        Long receiptId,
+        Long productId,
+        Integer boxCount,
+        BigDecimal measuredWeight,
+        BigDecimal expectedQuantity,
+        Integer actualQuantity,
+        Integer amount,
+        BigDecimal errorRate,
+        String note
+) {
+    public static ReceiptItemResponse from(ReceiptItem receiptItem) {
+        return new ReceiptItemResponse(
+                receiptItem.getId(),
+                receiptItem.getReceipt().getId(),
+                receiptItem.getProduct().getId(),
+                receiptItem.getBoxCount(),
+                receiptItem.getMeasuredWeight(),
+                receiptItem.getExpectedQuantity(),
+                receiptItem.getActualQuantity(),
+                receiptItem.getAmount(),
+                receiptItem.getErrorRate(),
+                receiptItem.getNote()
+        );
+    }
+}

src/main/java/com/almang/inventory/receipt/dto/response/ReceiptResponse.java

@@ -0,0 +1,35 @@
+package com.almang.inventory.receipt.dto.response;
+
+import com.almang.inventory.receipt.domain.Receipt;
+import com.almang.inventory.receipt.domain.ReceiptStatus;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.List;
+
+public record ReceiptResponse(
+        Long receiptId,
+        Long storeId,
+        Long orderId,
+        LocalDate receiptDate,
+        Integer totalBoxCount,
+        BigDecimal totalWeightG,
+        ReceiptStatus status,
+        boolean activated,
+        List<ReceiptItemResponse> receiptItems
+) {
+    public static ReceiptResponse from(Receipt receipt) {
+        return new ReceiptResponse(
+                receipt.getId(),
+                receipt.getStore().getId(),
+                receipt.getOrder().getId(),
+                receipt.getReceiptDate(),
+                receipt.getTotalBoxCount(),
+                receipt.getTotalWeightG(),
+                receipt.getStatus(),
+                receipt.isActivated(),
+                receipt.getItems().stream()
+                        .map(ReceiptItemResponse::from)
+                        .toList()
+        );
+    }
+}

src/main/java/com/almang/inventory/receipt/repository/ReceiptRepository.java

@@ -0,0 +1,7 @@
+package com.almang.inventory.receipt.repository;
+
+import com.almang.inventory.receipt.domain.Receipt;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+public interface ReceiptRepository extends JpaRepository<Receipt, Long> {
+}