@k2works/claude-code-booster 3.2.1 → 3.3.1

package/lib/assets/docs/article/practical-database-design/part2/chapter08.md

@@ -0,0 +1,2105 @@
+# 第8章：調達管理の設計
+
+販売管理システムにおいて、商品の仕入れを管理する調達業務は事業継続の基盤となります。本章では、発注から入荷・検収、仕入計上までの一連の調達業務フローに対応したデータベース設計と実装を行います。
+
+## 調達管理の全体像
+
+調達管理は「発注 → 入荷 → 検収 → 仕入計上」という一連のフローで構成されます。
+
+```plantuml
+@startuml
+
+title 調達管理フロー
+
+|調達部|
+start
+:在庫確認;
+:発注依頼;
+note right
+  在庫不足や
+  受注に基づく発注
+end note
+
+|購買部|
+:発注書作成;
+:仕入先選定;
+:発注確定;
+:注文書発行;
+
+|仕入先|
+:受注確認;
+:商品出荷;
+
+|倉庫部|
+:入荷受入;
+:入荷検品;
+
+if (検品OK?) then (yes)
+  :入荷確定;
+  |経理部|
+  :仕入計上;
+  :買掛金計上;
+else (no)
+  |倉庫部|
+  :返品処理;
+endif
+
+stop
+
+@enduml
+```
+
+### 調達管理で扱うデータ
+
+| データ | 説明 |
+|-------|------|
+| **発注データ** | 仕入先への発注情報（発注数量、希望納期） |
+| **発注明細** | 発注に含まれる商品明細 |
+| **入荷データ** | 仕入先からの入荷情報 |
+| **入荷明細** | 入荷に含まれる検品情報 |
+| **仕入データ** | 検収確定後の仕入情報（買掛金発生） |
+
+---
+
+## 8.1 発注業務の DB 設計
+
+### 調達の4つのパターン
+
+発注業務には、目的に応じて4つのパターンがあります。
+
+```plantuml
+@startuml
+
+title 調達の4つのパターン
+
+rectangle "在庫補充発注" #CCFFCC {
+  card "安全在庫を下回った\n場合の自動発注" as p1
+}
+
+rectangle "受注連動発注" #CCCCFF {
+  card "受注に基づく\n紐付け発注" as p2
+}
+
+rectangle "計画発注" #FFFFCC {
+  card "販売計画に基づく\n定期発注" as p3
+}
+
+rectangle "スポット発注" #FFCCCC {
+  card "臨時の\n追加発注" as p4
+}
+
+note bottom of p1
+  在庫管理と連携
+  発注点を下回ったら自動発注
+end note
+
+note bottom of p2
+  受注データと紐付け
+  納期に合わせて発注
+end note
+
+note bottom of p3
+  月次・週次など
+  計画に基づく発注
+end note
+
+note bottom of p4
+  緊急対応
+  臨時の追加発注
+end note
+
+@enduml
+```
+
+| パターン | 説明 | トリガー |
+|---------|------|---------|
+| **在庫補充発注** | 安全在庫を下回った場合の自動発注 | 在庫数量 < 発注点 |
+| **受注連動発注** | 受注に基づく紐付け発注 | 受注登録時 |
+| **計画発注** | 販売計画に基づく定期発注 | 月次・週次計画 |
+| **スポット発注** | 臨時の追加発注 | 手動 |
+
+### 発注データ・発注明細データの構造
+
+#### 発注データの ER 図
+
+```plantuml
+@startuml
+
+title 発注関連テーブル
+
+entity 発注データ {
+  ID <<PK>>
+  --
+  発注番号 <<UK>>
+  仕入先コード <<FK>>
+  発注日
+  希望納期
+  発注ステータス
+  発注担当者コード
+  発注合計金額
+  税額
+  バージョン
+  備考
+  作成日時
+  更新日時
+}
+
+entity 発注明細データ {
+  ID <<PK>>
+  --
+  発注番号 <<FK>>
+  発注行番号
+  商品コード <<FK>>
+  発注数量
+  発注単価
+  発注金額
+  入荷予定日
+  入荷済数量
+  残数量
+  備考
+}
+
+entity 仕入先マスタ {
+  取引先コード <<PK>>
+  --
+  仕入先名
+  支払条件コード
+  締日
+  支払サイト
+}
+
+entity 商品マスタ {
+  商品コード <<PK>>
+  --
+  商品名
+  仕入単価
+  標準仕入先コード
+}
+
+発注データ ||--o{ 発注明細データ : 発注番号
+仕入先マスタ ||--o{ 発注データ : 仕入先コード
+商品マスタ ||--o{ 発注明細データ : 商品コード
+
+@enduml
+```
+
+### 発注ステータスの定義
+
+```plantuml
+@startuml
+
+title 発注ステータス遷移図
+
+[*] --> 作成中
+
+作成中 --> 確定 : 発注確定
+
+確定 --> 一部入荷 : 一部入荷
+確定 --> 入荷完了 : 全量入荷
+
+一部入荷 --> 入荷完了 : 残量入荷
+
+入荷完了 --> [*]
+
+作成中 --> 取消 : 取消
+確定 --> 取消 : 取消（入荷前）
+
+取消 --> [*]
+
+@enduml
+```
+
+| ステータス | 説明 |
+|-----------|------|
+| **作成中** | 発注データ作成中、編集可能 |
+| **確定** | 発注確定、注文書発行済み |
+| **一部入荷** | 一部の商品が入荷済み |
+| **入荷完了** | 全商品が入荷済み |
+| **取消** | 発注がキャンセルされた状態 |
+
+### 仕入先マスタとの連携
+
+仕入先マスタは、発注先の情報を管理します。
+
+```plantuml
+@startuml
+
+title 仕入先マスタの構造
+
+entity 仕入先マスタ {
+  取引先コード <<PK>>
+  --
+  仕入先名
+  仕入先名カナ
+  郵便番号
+  住所
+  電話番号
+  FAX番号
+  担当者名
+  メールアドレス
+  支払条件コード <<FK>>
+  締日
+  支払サイト
+  取引開始日
+  取引状態
+  備考
+  作成日時
+  更新日時
+}
+
+entity 支払条件マスタ {
+  支払条件コード <<PK>>
+  --
+  支払条件名
+  締日
+  支払月
+  支払日
+}
+
+entity 商品マスタ {
+  商品コード <<PK>>
+  --
+  標準仕入先コード <<FK>>
+  仕入単価
+}
+
+仕入先マスタ }o--|| 支払条件マスタ
+仕入先マスタ ||--o{ 商品マスタ : 標準仕入先
+
+@enduml
+```
+
+### マイグレーション：発注関連テーブルの作成
+
+<details>
+<summary>V013__create_purchase_order_tables.sql</summary>
+
+```sql
+-- src/main/resources/db/migration/V013__create_purchase_order_tables.sql
+
+-- 発注ステータス
+CREATE TYPE 発注ステータス AS ENUM ('作成中', '確定', '一部入荷', '入荷完了', '取消');
+
+-- 倉庫マスタ
+CREATE TABLE "倉庫マスタ" (
+    "倉庫コード" VARCHAR(20) PRIMARY KEY,
+    "倉庫名" VARCHAR(100) NOT NULL,
+    "倉庫名カナ" VARCHAR(200),
+    "郵便番号" VARCHAR(10),
+    "住所" VARCHAR(200),
+    "電話番号" VARCHAR(20),
+    "有効フラグ" BOOLEAN DEFAULT TRUE,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新者名" VARCHAR(50)
+);
+
+-- 発注データ
+CREATE TABLE "発注データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "発注番号" VARCHAR(20) UNIQUE NOT NULL,
+    "仕入先コード" VARCHAR(20) NOT NULL,
+    "仕入先枝番" VARCHAR(10) DEFAULT '00',
+    "発注日" DATE NOT NULL,
+    "希望納期" DATE,
+    "発注ステータス" 発注ステータス DEFAULT '作成中' NOT NULL,
+    "発注担当者コード" VARCHAR(20),
+    "発注合計金額" DECIMAL(15, 2) DEFAULT 0,
+    "税額" DECIMAL(15, 2) DEFAULT 0,
+    "備考" TEXT,
+    "バージョン" INTEGER DEFAULT 1 NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "作成者" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新者" VARCHAR(50),
+    CONSTRAINT "fk_発注_仕入先"
+        FOREIGN KEY ("仕入先コード", "仕入先枝番") REFERENCES "仕入先マスタ"("仕入先コード", "仕入先枝番")
+);
+
+-- 発注明細データ
+CREATE TABLE "発注明細データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "発注ID" INTEGER NOT NULL,
+    "発注行番号" INTEGER NOT NULL,
+    "商品コード" VARCHAR(20) NOT NULL,
+    "発注数量" DECIMAL(15, 2) NOT NULL,
+    "発注単価" DECIMAL(15, 2) NOT NULL,
+    "発注金額" DECIMAL(15, 2) NOT NULL,
+    "入荷予定日" DATE,
+    "入荷済数量" DECIMAL(15, 2) DEFAULT 0,
+    "残数量" DECIMAL(15, 2),
+    "備考" TEXT,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "fk_発注明細_発注"
+        FOREIGN KEY ("発注ID") REFERENCES "発注データ"("ID") ON DELETE CASCADE,
+    CONSTRAINT "fk_発注明細_商品"
+        FOREIGN KEY ("商品コード") REFERENCES "商品マスタ"("商品コード"),
+    CONSTRAINT "uk_発注明細_発注_行" UNIQUE ("発注ID", "発注行番号")
+);
+
+-- 残数量の自動計算トリガー
+CREATE OR REPLACE FUNCTION update_purchase_order_remaining()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW."残数量" := NEW."発注数量" - COALESCE(NEW."入荷済数量", 0);
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_発注明細_残数量更新
+    BEFORE INSERT OR UPDATE ON "発注明細データ"
+    FOR EACH ROW
+    EXECUTE FUNCTION update_purchase_order_remaining();
+
+-- インデックス
+CREATE INDEX "idx_発注データ_仕入先コード" ON "発注データ"("仕入先コード");
+CREATE INDEX "idx_発注データ_発注日" ON "発注データ"("発注日");
+CREATE INDEX "idx_発注データ_ステータス" ON "発注データ"("発注ステータス");
+CREATE INDEX "idx_発注明細_商品コード" ON "発注明細データ"("商品コード");
+
+-- テーブルコメント
+COMMENT ON TABLE "倉庫マスタ" IS '倉庫情報を管理するテーブル';
+COMMENT ON TABLE "発注データ" IS '発注ヘッダ情報を管理するテーブル';
+COMMENT ON TABLE "発注明細データ" IS '発注明細情報を管理するテーブル';
+COMMENT ON COLUMN "発注データ"."バージョン" IS '楽観ロック用バージョン番号';
+```
+
+</details>
+
+### 発注エンティティの実装
+
+<details>
+<summary>発注ステータス ENUM</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/purchase/PurchaseOrderStatus.java
+package com.example.sms.domain.model.purchase;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum PurchaseOrderStatus {
+    DRAFT("作成中"),
+    CONFIRMED("確定"),
+    PARTIALLY_RECEIVED("一部入荷"),
+    COMPLETED("入荷完了"),
+    CANCELLED("取消");
+
+    private final String displayName;
+
+    /**
+     * 表示名から発注ステータスを取得する.
+     *
+     * @param displayName 表示名
+     * @return 発注ステータス
+     */
+    public static PurchaseOrderStatus fromDisplayName(String displayName) {
+        for (PurchaseOrderStatus status : values()) {
+            if (status.displayName.equals(displayName)) {
+                return status;
+            }
+        }
+        throw new IllegalArgumentException("不正な発注ステータス: " + displayName);
+    }
+
+    /**
+     * 確定可能かどうか.
+     *
+     * @return 確定可能な場合true
+     */
+    public boolean canConfirm() {
+        return this == DRAFT;
+    }
+
+    /**
+     * 入荷登録可能かどうか.
+     *
+     * @return 入荷登録可能な場合true
+     */
+    public boolean canReceive() {
+        return this == CONFIRMED || this == PARTIALLY_RECEIVED;
+    }
+
+    /**
+     * 取消可能かどうか.
+     *
+     * @return 取消可能な場合true
+     */
+    public boolean canCancel() {
+        return this == DRAFT || this == CONFIRMED;
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>発注エンティティ</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/purchase/PurchaseOrder.java
+package com.example.sms.domain.model.purchase;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@SuppressWarnings("PMD.RedundantFieldInitializer")
+public class PurchaseOrder {
+    private Integer id;
+    private String purchaseOrderNumber;
+    private String supplierCode;
+    @Builder.Default
+    private String supplierBranchNumber = "00";
+    private LocalDate orderDate;
+    private LocalDate desiredDeliveryDate;
+    @Builder.Default
+    private PurchaseOrderStatus status = PurchaseOrderStatus.DRAFT;
+    private String purchaserCode;
+    @Builder.Default
+    private BigDecimal totalAmount = BigDecimal.ZERO;
+    @Builder.Default
+    private BigDecimal taxAmount = BigDecimal.ZERO;
+    private String remarks;
+    private LocalDateTime createdAt;
+    private String createdBy;
+    private LocalDateTime updatedAt;
+    private String updatedBy;
+
+    /** 楽観ロック用バージョン. */
+    @Builder.Default
+    private Integer version = 1;
+
+    @Builder.Default
+    private List<PurchaseOrderDetail> details = new ArrayList<>();
+
+    /**
+     * 発注合計金額を再計算する
+     */
+    public void recalculateTotalAmount() {
+        if (details != null && !details.isEmpty()) {
+            this.totalAmount = details.stream()
+                    .map(PurchaseOrderDetail::getOrderAmount)
+                    .reduce(BigDecimal.ZERO, BigDecimal::add);
+            // 消費税10%
+            this.taxAmount = this.totalAmount.multiply(new BigDecimal("0.10"));
+        }
+    }
+
+    /**
+     * 全明細が入荷完了かどうか
+     */
+    public boolean isAllReceived() {
+        if (details == null || details.isEmpty()) {
+            return false;
+        }
+        return details.stream()
+                .allMatch(d -> d.getRemainingQuantity().compareTo(BigDecimal.ZERO) == 0);
+    }
+
+    /**
+     * 一部入荷があるかどうか
+     */
+    public boolean hasPartialReceipt() {
+        if (details == null || details.isEmpty()) {
+            return false;
+        }
+        return details.stream()
+                .anyMatch(d -> d.getReceivedQuantity().compareTo(BigDecimal.ZERO) > 0
+                        && d.getRemainingQuantity().compareTo(BigDecimal.ZERO) > 0);
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>発注明細エンティティ</summary>
+
+```java
+// src/main/java/com/example/sales/domain/model/purchase/PurchaseOrderDetail.java
+package com.example.sms.domain.model.purchase;
+
+import lombok.Builder;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@Builder
+public class PurchaseOrderDetail {
+    private Integer id;
+    private String purchaseOrderNumber;
+    private Integer lineNumber;
+    private String productCode;
+    private BigDecimal orderQuantity;
+    private BigDecimal unitPrice;
+    private BigDecimal orderAmount;
+    private LocalDate expectedDeliveryDate;
+    private BigDecimal receivedQuantity;
+    private BigDecimal remainingQuantity;
+    private String remarks;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+
+    /**
+     * 発注金額を計算する
+     */
+    public void calculateOrderAmount() {
+        this.orderAmount = this.orderQuantity.multiply(this.unitPrice);
+    }
+
+    /**
+     * 残数量を計算する
+     */
+    public void calculateRemainingQuantity() {
+        this.remainingQuantity = this.orderQuantity
+                .subtract(this.receivedQuantity != null ? this.receivedQuantity : BigDecimal.ZERO);
+    }
+
+    /**
+     * 入荷可能数量かどうか
+     */
+    public boolean canReceive(BigDecimal quantity) {
+        return quantity.compareTo(BigDecimal.ZERO) > 0
+                && quantity.compareTo(this.remainingQuantity) <= 0;
+    }
+}
+```
+
+</details>
+
+### 発注サービスの実装
+
+<details>
+<summary>発注サービス</summary>
+
+```java
+// src/main/java/com/example/sales/application/service/PurchaseOrderService.java
+package com.example.sms.application.service;
+
+import com.example.sms.application.port.out.*;
+import com.example.sms.domain.model.purchase.*;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Optional;
+
+@Service
+@RequiredArgsConstructor
+public class PurchaseOrderService {
+
+    private final PurchaseOrderRepository purchaseOrderRepository;
+
+    /**
+     * 発注番号を生成する
+     */
+    private String generatePurchaseOrderNumber(LocalDate orderDate) {
+        String prefix = "PO-" + orderDate.format(
+                DateTimeFormatter.ofPattern("yyyyMM")) + "-";
+        Optional<String> latestNumber = purchaseOrderRepository
+                .findLatestPurchaseOrderNumber(prefix + "%");
+
+        int sequence = 1;
+        if (latestNumber.isPresent()) {
+            String latest = latestNumber.get();
+            int currentSequence = Integer.parseInt(
+                    latest.substring(latest.length() - 4));
+            sequence = currentSequence + 1;
+        }
+
+        return prefix + String.format("%04d", sequence);
+    }
+
+    /**
+     * 発注を作成する
+     */
+    @Transactional
+    public PurchaseOrder createPurchaseOrder(PurchaseOrderCreateCommand command) {
+        String purchaseOrderNumber = generatePurchaseOrderNumber(command.getOrderDate());
+
+        // 発注ヘッダを作成
+        PurchaseOrder purchaseOrder = PurchaseOrder.builder()
+                .purchaseOrderNumber(purchaseOrderNumber)
+                .supplierCode(command.getSupplierCode())
+                .orderDate(command.getOrderDate())
+                .desiredDeliveryDate(command.getDesiredDeliveryDate())
+                .status(PurchaseOrderStatus.DRAFT)
+                .purchaserCode(command.getPurchaserCode())
+                .remarks(command.getRemarks())
+                .totalAmount(BigDecimal.ZERO)
+                .taxAmount(BigDecimal.ZERO)
+                .build();
+
+        // 発注明細を作成
+        List<PurchaseOrderDetail> details = new ArrayList<>();
+        int lineNumber = 0;
+
+        for (var detailCommand : command.getDetails()) {
+            lineNumber++;
+            BigDecimal orderAmount = detailCommand.getOrderQuantity()
+                    .multiply(detailCommand.getUnitPrice());
+
+            PurchaseOrderDetail detail = PurchaseOrderDetail.builder()
+                    .purchaseOrderNumber(purchaseOrderNumber)
+                    .lineNumber(lineNumber)
+                    .productCode(detailCommand.getProductCode())
+                    .orderQuantity(detailCommand.getOrderQuantity())
+                    .unitPrice(detailCommand.getUnitPrice())
+                    .orderAmount(orderAmount)
+                    .expectedDeliveryDate(detailCommand.getExpectedDeliveryDate())
+                    .receivedQuantity(BigDecimal.ZERO)
+                    .remainingQuantity(detailCommand.getOrderQuantity())
+                    .remarks(detailCommand.getRemarks())
+                    .build();
+
+            details.add(detail);
+        }
+
+        purchaseOrder.setDetails(details);
+        purchaseOrder.recalculateTotalAmount();
+
+        // データベースに保存
+        purchaseOrderRepository.save(purchaseOrder);
+
+        return purchaseOrder;
+    }
+
+    /**
+     * 発注を確定する
+     */
+    @Transactional
+    public void confirmPurchaseOrder(String purchaseOrderNumber) {
+        PurchaseOrder purchaseOrder = findByPurchaseOrderNumber(purchaseOrderNumber)
+                .orElseThrow(() -> new IllegalArgumentException(
+                        "発注が見つかりません: " + purchaseOrderNumber));
+
+        if (!purchaseOrder.getStatus().canConfirm()) {
+            throw new IllegalStateException(
+                    "この発注は確定できません。現在のステータス: " +
+                    purchaseOrder.getStatus().getDisplayName());
+        }
+
+        purchaseOrderRepository.updateStatus(
+                purchaseOrderNumber, PurchaseOrderStatus.CONFIRMED);
+    }
+
+    /**
+     * 発注を取消する
+     */
+    @Transactional
+    public void cancelPurchaseOrder(String purchaseOrderNumber) {
+        PurchaseOrder purchaseOrder = findByPurchaseOrderNumber(purchaseOrderNumber)
+                .orElseThrow(() -> new IllegalArgumentException(
+                        "発注が見つかりません: " + purchaseOrderNumber));
+
+        if (!purchaseOrder.getStatus().canCancel()) {
+            throw new IllegalStateException(
+                    "この発注は取消できません。現在のステータス: " +
+                    purchaseOrder.getStatus().getDisplayName());
+        }
+
+        purchaseOrderRepository.updateStatus(
+                purchaseOrderNumber, PurchaseOrderStatus.CANCELLED);
+    }
+
+    /**
+     * 発注番号で検索する
+     */
+    public Optional<PurchaseOrder> findByPurchaseOrderNumber(String purchaseOrderNumber) {
+        return purchaseOrderRepository.findByPurchaseOrderNumber(purchaseOrderNumber);
+    }
+
+    /**
+     * 未完了の発注を検索する
+     */
+    public List<PurchaseOrder> findPendingOrders() {
+        return purchaseOrderRepository.findPendingOrders();
+    }
+}
+```
+
+</details>
+
+---
+
+## 8.2 入荷・検収業務の DB 設計
+
+### 入荷業務フローの理解
+
+入荷業務は、発注した商品を受け取り、検品して仕入計上する業務です。
+
+```plantuml
+@startuml
+
+title 入荷・検収の業務フロー
+
+|倉庫部|
+start
+:入荷受入;
+note right
+  発注に紐づく
+  入荷を登録
+end note
+
+:入荷検品;
+
+if (検品OK?) then (yes)
+  :入荷確定;
+  |経理部|
+  :仕入計上;
+  note right
+    仕入データ作成
+    買掛金発生
+  end note
+else (no)
+  |倉庫部|
+  :返品処理;
+  note right
+    不良品の返送
+  end note
+endif
+
+|購買部|
+:発注残管理;
+note right
+  入荷数量を反映
+  ステータス更新
+end note
+
+stop
+
+@enduml
+```
+
+### 入荷データの構造
+
+#### 入荷・仕入データの ER 図
+
+```plantuml
+@startuml
+
+title 入荷・仕入関連テーブル
+
+entity 発注データ {
+  ID <<PK>>
+  --
+  発注番号
+  仕入先コード
+  発注ステータス
+}
+
+entity 入荷データ {
+  ID <<PK>>
+  --
+  入荷番号 <<UK>>
+  発注番号 <<FK>>
+  仕入先コード <<FK>>
+  入荷日
+  入荷ステータス
+  入荷担当者コード
+  倉庫コード <<FK>>
+  バージョン
+  備考
+  作成日時
+  更新日時
+}
+
+entity 入荷明細データ {
+  ID <<PK>>
+  --
+  入荷番号 <<FK>>
+  入荷行番号
+  発注行番号
+  商品コード <<FK>>
+  入荷数量
+  検品数量
+  合格数量
+  不合格数量
+  入荷単価
+  入荷金額
+  備考
+}
+
+entity 仕入データ {
+  ID <<PK>>
+  --
+  仕入番号 <<UK>>
+  入荷番号 <<FK>>
+  仕入先コード <<FK>>
+  仕入日
+  仕入合計金額
+  税額
+  バージョン
+  備考
+  作成日時
+  更新日時
+}
+
+entity 仕入明細データ {
+  ID <<PK>>
+  --
+  仕入番号 <<FK>>
+  仕入行番号
+  商品コード <<FK>>
+  仕入数量
+  仕入単価
+  仕入金額
+  備考
+}
+
+発注データ ||--o{ 入荷データ : 発注番号
+入荷データ ||--o{ 入荷明細データ : 入荷番号
+入荷データ ||--o| 仕入データ : 入荷番号
+仕入データ ||--o{ 仕入明細データ : 仕入番号
+
+@enduml
+```
+
+### 入荷ステータスの定義
+
+```plantuml
+@startuml
+
+title 入荷ステータス遷移図
+
+[*] --> 入荷待ち
+
+入荷待ち --> 検品中 : 検品開始
+
+検品中 --> 検品完了 : 検品終了
+
+検品完了 --> 仕入計上済 : 仕入計上
+
+仕入計上済 --> [*]
+
+検品中 --> 返品 : 全量不合格
+
+返品 --> [*]
+
+@enduml
+```
+
+| ステータス | 説明 |
+|-----------|------|
+| **入荷待ち** | 入荷データ登録済み、検品前 |
+| **検品中** | 検品作業中 |
+| **検品完了** | 検品完了、仕入計上待ち |
+| **仕入計上済** | 仕入データ作成済み |
+| **返品** | 全量返品処理 |
+
+### 検収（仕入計上）処理
+
+検収処理では、検品完了後に合格数量分を仕入として計上します。
+
+```plantuml
+@startuml
+
+title 検収処理のフロー
+
+start
+
+:入荷検品完了;
+
+:合格数量の確定;
+note right
+  入荷数量
+  - 不合格数量
+  = 合格数量
+end note
+
+if (合格数量 > 0?) then (yes)
+  :仕入データ作成;
+  note right
+    仕入番号採番
+    仕入明細作成
+    合計金額計算
+  end note
+
+  :買掛金計上;
+  note right
+    仕入先別に
+    買掛金残高更新
+  end note
+
+  :在庫計上;
+  note right
+    倉庫在庫に
+    合格数量を加算
+  end note
+else (no)
+endif
+
+if (不合格数量 > 0?) then (yes)
+  :返品処理;
+  note right
+    不合格品を
+    仕入先に返送
+  end note
+else (no)
+endif
+
+:入荷ステータス更新;
+
+stop
+
+@enduml
+```
+
+### 諸口品目の扱い
+
+諸口品目（雑品、消耗品など）は、商品マスタに登録せずに直接入力する品目です。
+
+```plantuml
+@startuml
+
+title 諸口品目の処理
+
+rectangle "通常品目" #CCFFCC {
+  card "商品マスタから\n商品コードで参照" as normal
+  card "在庫管理対象" as stock
+}
+
+rectangle "諸口品目" #FFFFCC {
+  card "商品コード = 'MISC'\n品名を直接入力" as misc
+  card "在庫管理対象外" as nostock
+}
+
+note bottom of normal
+  商品マスタの情報を使用
+  - 商品名
+  - 仕入単価
+  - 在庫数量管理
+end note
+
+note bottom of misc
+  発注時に入力
+  - 品名（自由入力）
+  - 単価（自由入力）
+  - 在庫管理しない
+end note
+
+@enduml
+```
+
+### マイグレーション：入荷・仕入関連テーブルの作成
+
+<details>
+<summary>V014__create_receiving_tables.sql</summary>
+
+```sql
+-- src/main/resources/db/migration/V014__create_receiving_tables.sql
+
+-- 入荷ステータス
+CREATE TYPE 入荷ステータス AS ENUM ('入荷待ち', '検品中', '検品完了', '仕入計上済', '返品');
+
+-- 入荷データ
+CREATE TABLE "入荷データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "入荷番号" VARCHAR(20) UNIQUE NOT NULL,
+    "発注ID" INTEGER NOT NULL,
+    "仕入先コード" VARCHAR(20) NOT NULL,
+    "仕入先枝番" VARCHAR(10) DEFAULT '00',
+    "入荷日" DATE NOT NULL,
+    "入荷ステータス" 入荷ステータス DEFAULT '入荷待ち' NOT NULL,
+    "入荷担当者コード" VARCHAR(20),
+    "倉庫コード" VARCHAR(20) NOT NULL,
+    "備考" TEXT,
+    "バージョン" INTEGER DEFAULT 1 NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "作成者" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新者" VARCHAR(50),
+    CONSTRAINT "fk_入荷_発注"
+        FOREIGN KEY ("発注ID") REFERENCES "発注データ"("ID"),
+    CONSTRAINT "fk_入荷_仕入先"
+        FOREIGN KEY ("仕入先コード", "仕入先枝番") REFERENCES "仕入先マスタ"("仕入先コード", "仕入先枝番"),
+    CONSTRAINT "fk_入荷_倉庫"
+        FOREIGN KEY ("倉庫コード") REFERENCES "倉庫マスタ"("倉庫コード")
+);
+
+-- 入荷明細データ
+CREATE TABLE "入荷明細データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "入荷ID" INTEGER NOT NULL,
+    "入荷行番号" INTEGER NOT NULL,
+    "発注明細ID" INTEGER NOT NULL,
+    "商品コード" VARCHAR(20) NOT NULL,
+    "入荷数量" DECIMAL(15, 2) NOT NULL,
+    "検品数量" DECIMAL(15, 2) DEFAULT 0,
+    "合格数量" DECIMAL(15, 2) DEFAULT 0,
+    "不合格数量" DECIMAL(15, 2) DEFAULT 0,
+    "入荷単価" DECIMAL(15, 2) NOT NULL,
+    "入荷金額" DECIMAL(15, 2) NOT NULL,
+    "備考" TEXT,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "fk_入荷明細_入荷"
+        FOREIGN KEY ("入荷ID") REFERENCES "入荷データ"("ID") ON DELETE CASCADE,
+    CONSTRAINT "fk_入荷明細_発注明細"
+        FOREIGN KEY ("発注明細ID") REFERENCES "発注明細データ"("ID"),
+    CONSTRAINT "fk_入荷明細_商品"
+        FOREIGN KEY ("商品コード") REFERENCES "商品マスタ"("商品コード"),
+    CONSTRAINT "uk_入荷明細_入荷_行" UNIQUE ("入荷ID", "入荷行番号")
+);
+
+-- 仕入データ（検収確定後に作成）
+CREATE TABLE "仕入データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "仕入番号" VARCHAR(20) UNIQUE NOT NULL,
+    "入荷ID" INTEGER NOT NULL,
+    "仕入先コード" VARCHAR(20) NOT NULL,
+    "仕入先枝番" VARCHAR(10) DEFAULT '00',
+    "仕入日" DATE NOT NULL,
+    "仕入合計金額" DECIMAL(15, 2) NOT NULL,
+    "税額" DECIMAL(15, 2) NOT NULL,
+    "備考" TEXT,
+    "バージョン" INTEGER DEFAULT 1 NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "作成者" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新者" VARCHAR(50),
+    CONSTRAINT "fk_仕入_入荷"
+        FOREIGN KEY ("入荷ID") REFERENCES "入荷データ"("ID"),
+    CONSTRAINT "fk_仕入_仕入先"
+        FOREIGN KEY ("仕入先コード", "仕入先枝番") REFERENCES "仕入先マスタ"("仕入先コード", "仕入先枝番")
+);
+
+-- 仕入明細データ
+CREATE TABLE "仕入明細データ" (
+    "ID" SERIAL PRIMARY KEY,
+    "仕入ID" INTEGER NOT NULL,
+    "仕入行番号" INTEGER NOT NULL,
+    "商品コード" VARCHAR(20) NOT NULL,
+    "仕入数量" DECIMAL(15, 2) NOT NULL,
+    "仕入単価" DECIMAL(15, 2) NOT NULL,
+    "仕入金額" DECIMAL(15, 2) NOT NULL,
+    "備考" TEXT,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    CONSTRAINT "fk_仕入明細_仕入"
+        FOREIGN KEY ("仕入ID") REFERENCES "仕入データ"("ID") ON DELETE CASCADE,
+    CONSTRAINT "fk_仕入明細_商品"
+        FOREIGN KEY ("商品コード") REFERENCES "商品マスタ"("商品コード"),
+    CONSTRAINT "uk_仕入明細_仕入_行" UNIQUE ("仕入ID", "仕入行番号")
+);
+
+-- インデックス
+CREATE INDEX "idx_入荷データ_発注ID" ON "入荷データ"("発注ID");
+CREATE INDEX "idx_入荷データ_入荷日" ON "入荷データ"("入荷日");
+CREATE INDEX "idx_入荷データ_ステータス" ON "入荷データ"("入荷ステータス");
+CREATE INDEX "idx_入荷明細_発注明細ID" ON "入荷明細データ"("発注明細ID");
+CREATE INDEX "idx_仕入データ_仕入先コード" ON "仕入データ"("仕入先コード");
+CREATE INDEX "idx_仕入データ_仕入日" ON "仕入データ"("仕入日");
+
+-- テーブルコメント
+COMMENT ON TABLE "入荷データ" IS '入荷ヘッダ情報を管理するテーブル';
+COMMENT ON TABLE "入荷明細データ" IS '入荷明細・検品情報を管理するテーブル';
+COMMENT ON TABLE "仕入データ" IS '仕入ヘッダ情報を管理するテーブル';
+COMMENT ON TABLE "仕入明細データ" IS '仕入明細情報を管理するテーブル';
+COMMENT ON COLUMN "入荷データ"."バージョン" IS '楽観ロック用バージョン番号';
+COMMENT ON COLUMN "仕入データ"."バージョン" IS '楽観ロック用バージョン番号';
+```
+
+</details>
+
+### 入荷エンティティの実装
+
+<details>
+<summary>入荷ステータス ENUM</summary>
+
+```java
+// src/main/java/com/example/sales/domain/model/purchase/ReceivingStatus.java
+package com.example.sms.domain.model.purchase;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum ReceivingStatus {
+    WAITING("入荷待ち"),
+    INSPECTING("検品中"),
+    INSPECTION_COMPLETED("検品完了"),
+    PURCHASE_RECORDED("仕入計上済"),
+    RETURNED("返品");
+
+    private final String displayName;
+
+    /**
+     * 表示名から入荷ステータスを取得する.
+     *
+     * @param displayName 表示名
+     * @return 入荷ステータス
+     */
+    public static ReceivingStatus fromDisplayName(String displayName) {
+        for (ReceivingStatus status : values()) {
+            if (status.displayName.equals(displayName)) {
+                return status;
+            }
+        }
+        throw new IllegalArgumentException("不正な入荷ステータス: " + displayName);
+    }
+
+    /**
+     * 検品開始可能かどうか.
+     *
+     * @return 検品開始可能な場合true
+     */
+    public boolean canStartInspection() {
+        return this == WAITING;
+    }
+
+    /**
+     * 仕入計上可能かどうか.
+     *
+     * @return 仕入計上可能な場合true
+     */
+    public boolean canRecordPurchase() {
+        return this == INSPECTION_COMPLETED;
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>入荷エンティティ</summary>
+
+```java
+// src/main/java/com/example/sales/domain/model/purchase/Receiving.java
+package com.example.sms.domain.model.purchase;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Receiving {
+    private Integer id;
+    private String receivingNumber;
+    private String purchaseOrderNumber;
+    private String supplierCode;
+    private LocalDate receivingDate;
+    private ReceivingStatus status;
+    private String receiverCode;
+    private String warehouseCode;
+    private String remarks;
+    private LocalDateTime createdAt;
+    private String createdBy;
+    private LocalDateTime updatedAt;
+    private String updatedBy;
+
+    // 楽観ロック用バージョン
+    @Builder.Default
+    private Integer version = 1;
+
+    // リレーション
+    @Builder.Default
+    private List<ReceivingDetail> details = new ArrayList<>();
+}
+```
+
+</details>
+
+<details>
+<summary>入荷明細エンティティ</summary>
+
+```java
+// src/main/java/com/example/sales/domain/model/purchase/ReceivingDetail.java
+package com.example.sms.domain.model.purchase;
+
+import lombok.Builder;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@Builder
+public class ReceivingDetail {
+    private Integer id;
+    private String receivingNumber;
+    private Integer lineNumber;
+    private Integer purchaseOrderLineNumber;
+    private String productCode;
+    private BigDecimal receivingQuantity;
+    private BigDecimal inspectedQuantity;
+    private BigDecimal acceptedQuantity;
+    private BigDecimal rejectedQuantity;
+    private BigDecimal unitPrice;
+    private BigDecimal amount;
+    private String remarks;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+
+    /**
+     * 検品を完了する
+     */
+    public void completeInspection(BigDecimal acceptedQty, BigDecimal rejectedQty) {
+        this.inspectedQuantity = acceptedQty.add(rejectedQty);
+        this.acceptedQuantity = acceptedQty;
+        this.rejectedQuantity = rejectedQty;
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>仕入エンティティ</summary>
+
+```java
+// src/main/java/com/example/sales/domain/model/purchase/Purchase.java
+package com.example.sms.domain.model.purchase;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Purchase {
+    private Integer id;
+    private String purchaseNumber;
+    private String receivingNumber;
+    private String supplierCode;
+    private LocalDate purchaseDate;
+    private BigDecimal totalAmount;
+    private BigDecimal taxAmount;
+    private String remarks;
+    private LocalDateTime createdAt;
+    private String createdBy;
+    private LocalDateTime updatedAt;
+    private String updatedBy;
+
+    // 楽観ロック用バージョン
+    @Builder.Default
+    private Integer version = 1;
+
+    // リレーション
+    @Builder.Default
+    private List<PurchaseDetail> details = new ArrayList<>();
+
+    /**
+     * 仕入合計金額を再計算
+     */
+    public void recalculateTotalAmount() {
+        if (details != null && !details.isEmpty()) {
+            this.totalAmount = details.stream()
+                    .map(PurchaseDetail::getPurchaseAmount)
+                    .reduce(BigDecimal.ZERO, BigDecimal::add);
+            this.taxAmount = this.totalAmount.multiply(new BigDecimal("0.10"));
+        }
+    }
+}
+```
+
+</details>
+
+### 入荷・仕入サービスの実装
+
+<details>
+<summary>入荷サービス</summary>
+
+```java
+// src/main/java/com/example/sales/application/service/ReceivingService.java
+package com.example.sms.application.service;
+
+import com.example.sms.application.port.out.*;
+import com.example.sms.domain.model.purchase.*;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Optional;
+
+@Service
+@RequiredArgsConstructor
+public class ReceivingService {
+
+    private final ReceivingRepository receivingRepository;
+    private final PurchaseOrderRepository purchaseOrderRepository;
+    private final PurchaseRepository purchaseRepository;
+    private final InventoryRepository inventoryRepository;
+    private final AccountsPayableRepository accountsPayableRepository;
+
+    /**
+     * 入荷を登録する
+     */
+    @Transactional
+    public Receiving createReceiving(ReceivingCreateCommand command) {
+        // 発注の存在確認
+        PurchaseOrder purchaseOrder = purchaseOrderRepository
+                .findByPurchaseOrderNumber(command.getPurchaseOrderNumber())
+                .orElseThrow(() -> new IllegalArgumentException(
+                        "発注が見つかりません: " + command.getPurchaseOrderNumber()));
+
+        if (!purchaseOrder.getStatus().canReceive()) {
+            throw new IllegalStateException(
+                    "この発注は入荷登録できません。現在のステータス: " +
+                    purchaseOrder.getStatus().getDisplayName());
+        }
+
+        String receivingNumber = generateReceivingNumber(command.getReceivingDate());
+
+        Receiving receiving = Receiving.builder()
+                .receivingNumber(receivingNumber)
+                .purchaseOrderNumber(command.getPurchaseOrderNumber())
+                .supplierCode(purchaseOrder.getSupplierCode())
+                .receivingDate(command.getReceivingDate())
+                .status(ReceivingStatus.WAITING)
+                .receiverCode(command.getReceiverCode())
+                .warehouseCode(command.getWarehouseCode())
+                .remarks(command.getRemarks())
+                .build();
+
+        List<ReceivingDetail> details = new ArrayList<>();
+        int lineNumber = 0;
+
+        for (var detailCommand : command.getDetails()) {
+            lineNumber++;
+            BigDecimal amount = detailCommand.getReceivingQuantity()
+                    .multiply(detailCommand.getUnitPrice());
+
+            ReceivingDetail detail = ReceivingDetail.builder()
+                    .receivingNumber(receivingNumber)
+                    .lineNumber(lineNumber)
+                    .purchaseOrderLineNumber(detailCommand.getPurchaseOrderLineNumber())
+                    .productCode(detailCommand.getProductCode())
+                    .receivingQuantity(detailCommand.getReceivingQuantity())
+                    .inspectedQuantity(BigDecimal.ZERO)
+                    .acceptedQuantity(BigDecimal.ZERO)
+                    .rejectedQuantity(BigDecimal.ZERO)
+                    .unitPrice(detailCommand.getUnitPrice())
+                    .amount(amount)
+                    .remarks(detailCommand.getRemarks())
+                    .build();
+
+            details.add(detail);
+        }
+
+        receiving.setDetails(details);
+        receivingRepository.save(receiving);
+
+        return receiving;
+    }
+
+    /**
+     * 検品を完了する
+     */
+    @Transactional
+    public void completeInspection(String receivingNumber,
+                                    List<InspectionResult> results) {
+        Receiving receiving = findByReceivingNumber(receivingNumber)
+                .orElseThrow(() -> new IllegalArgumentException(
+                        "入荷が見つかりません: " + receivingNumber));
+
+        for (InspectionResult result : results) {
+            receivingRepository.updateInspectionResult(
+                    receivingNumber,
+                    result.getLineNumber(),
+                    result.getAcceptedQuantity(),
+                    result.getRejectedQuantity()
+            );
+        }
+
+        receivingRepository.updateStatus(
+                receivingNumber, ReceivingStatus.INSPECTION_COMPLETED);
+    }
+
+    /**
+     * 仕入計上する
+     */
+    @Transactional
+    public Purchase recordPurchase(String receivingNumber) {
+        Receiving receiving = findByReceivingNumber(receivingNumber)
+                .orElseThrow(() -> new IllegalArgumentException(
+                        "入荷が見つかりません: " + receivingNumber));
+
+        if (!receiving.getStatus().canRecordPurchase()) {
+            throw new IllegalStateException(
+                    "この入荷は仕入計上できません。現在のステータス: " +
+                    receiving.getStatus().getDisplayName());
+        }
+
+        String purchaseNumber = generatePurchaseNumber(LocalDate.now());
+
+        // 仕入データを作成
+        Purchase purchase = Purchase.builder()
+                .purchaseNumber(purchaseNumber)
+                .receivingNumber(receivingNumber)
+                .supplierCode(receiving.getSupplierCode())
+                .purchaseDate(LocalDate.now())
+                .build();
+
+        List<PurchaseDetail> purchaseDetails = new ArrayList<>();
+        int lineNumber = 0;
+
+        for (ReceivingDetail receivingDetail : receiving.getDetails()) {
+            if (receivingDetail.getAcceptedQuantity().compareTo(BigDecimal.ZERO) > 0) {
+                lineNumber++;
+                BigDecimal purchaseAmount = receivingDetail.getAcceptedQuantity()
+                        .multiply(receivingDetail.getUnitPrice());
+
+                PurchaseDetail purchaseDetail = PurchaseDetail.builder()
+                        .purchaseNumber(purchaseNumber)
+                        .lineNumber(lineNumber)
+                        .productCode(receivingDetail.getProductCode())
+                        .purchaseQuantity(receivingDetail.getAcceptedQuantity())
+                        .unitPrice(receivingDetail.getUnitPrice())
+                        .purchaseAmount(purchaseAmount)
+                        .build();
+
+                purchaseDetails.add(purchaseDetail);
+
+                // 在庫を増加
+                inventoryRepository.increaseQuantity(
+                        receiving.getWarehouseCode(),
+                        receivingDetail.getProductCode(),
+                        receivingDetail.getAcceptedQuantity()
+                );
+            }
+        }
+
+        purchase.setDetails(purchaseDetails);
+        purchase.recalculateTotalAmount();
+        purchaseRepository.save(purchase);
+
+        // 発注残を更新
+        updatePurchaseOrderReceivedQuantity(receiving);
+
+        // 入荷ステータスを更新
+        receivingRepository.updateStatus(
+                receivingNumber, ReceivingStatus.PURCHASE_RECORDED);
+
+        // 買掛金を計上
+        accountsPayableRepository.increaseBalance(
+                receiving.getSupplierCode(),
+                purchase.getTotalAmount().add(purchase.getTaxAmount())
+        );
+
+        return purchase;
+    }
+
+    private void updatePurchaseOrderReceivedQuantity(Receiving receiving) {
+        for (ReceivingDetail detail : receiving.getDetails()) {
+            purchaseOrderRepository.updateReceivedQuantity(
+                    receiving.getPurchaseOrderNumber(),
+                    detail.getPurchaseOrderLineNumber(),
+                    detail.getAcceptedQuantity()
+            );
+        }
+
+        // 発注のステータスを更新
+        PurchaseOrder purchaseOrder = purchaseOrderRepository
+                .findByPurchaseOrderNumber(receiving.getPurchaseOrderNumber())
+                .orElseThrow();
+
+        if (purchaseOrder.isAllReceived()) {
+            purchaseOrderRepository.updateStatus(
+                    receiving.getPurchaseOrderNumber(),
+                    PurchaseOrderStatus.COMPLETED
+            );
+        } else if (purchaseOrder.hasPartialReceipt()) {
+            purchaseOrderRepository.updateStatus(
+                    receiving.getPurchaseOrderNumber(),
+                    PurchaseOrderStatus.PARTIALLY_RECEIVED
+            );
+        }
+    }
+
+    public Optional<Receiving> findByReceivingNumber(String receivingNumber) {
+        return receivingRepository.findByReceivingNumber(receivingNumber);
+    }
+
+    private String generateReceivingNumber(LocalDate receivingDate) {
+        String prefix = "RCV-" + receivingDate.format(
+                DateTimeFormatter.ofPattern("yyyyMM")) + "-";
+        Optional<String> latestNumber = receivingRepository
+                .findLatestReceivingNumber(prefix + "%");
+
+        int sequence = 1;
+        if (latestNumber.isPresent()) {
+            String latest = latestNumber.get();
+            int currentSequence = Integer.parseInt(
+                    latest.substring(latest.length() - 4));
+            sequence = currentSequence + 1;
+        }
+
+        return prefix + String.format("%04d", sequence);
+    }
+
+    private String generatePurchaseNumber(LocalDate purchaseDate) {
+        String prefix = "PUR-" + purchaseDate.format(
+                DateTimeFormatter.ofPattern("yyyyMM")) + "-";
+        Optional<String> latestNumber = purchaseRepository
+                .findLatestPurchaseNumber(prefix + "%");
+
+        int sequence = 1;
+        if (latestNumber.isPresent()) {
+            String latest = latestNumber.get();
+            int currentSequence = Integer.parseInt(
+                    latest.substring(latest.length() - 4));
+            sequence = currentSequence + 1;
+        }
+
+        return prefix + String.format("%04d", sequence);
+    }
+}
+```
+
+</details>
+
+---
+
+## 8.3 リレーションと楽観ロックの設計
+
+### N+1 問題とその解決
+
+発注データは、発注（ヘッダ）→ 発注明細の2層構造を持ちます。入荷データも入荷 → 入荷明細の親子関係があります。これらのデータを効率的に取得するための設計を行います。
+
+```plantuml
+@startuml
+
+title N+1 問題の発生パターン
+
+rectangle "N+1 問題（非効率）" #FFCCCC {
+  card "1. 発注ヘッダ取得\n  SELECT * FROM 発注データ\n  (1回)" as q1
+  card "2. 各発注の明細取得\n  SELECT * FROM 発注明細データ\n  WHERE 発注番号 = ?\n  (N回)" as q2
+}
+
+rectangle "解決策：JOINによる一括取得" #CCFFCC {
+  card "1回のJOINクエリで\n全データを取得\n  SELECT po.*, pod.*\n  FROM 発注データ po\n  LEFT JOIN 発注明細データ pod ON ..." as sol
+}
+
+q1 --> q2 : N件
+note right of q2
+  10件の発注があれば
+  合計11回のクエリ発行
+end note
+
+@enduml
+```
+
+### MyBatis ネストした ResultMap による関連付け
+
+<details>
+<summary>発注データのリレーション設定（PurchaseOrderMapper.xml）</summary>
+
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.example.sms.infrastructure.out.persistence.mapper.PurchaseOrderMapper">
+
+    <!-- 発注（ヘッダ）の ResultMap -->
+    <resultMap id="PurchaseOrderWithDetailsResultMap"
+               type="com.example.sms.domain.model.purchase.PurchaseOrder">
+        <id property="id" column="po_id"/>
+        <result property="purchaseOrderNumber" column="po_発注番号"/>
+        <result property="supplierCode" column="po_仕入先コード"/>
+        <result property="orderDate" column="po_発注日"/>
+        <result property="desiredDeliveryDate" column="po_希望納期"/>
+        <result property="status" column="po_発注ステータス"
+                typeHandler="com.example.sms.infrastructure.out.persistence.typehandler.PurchaseOrderStatusTypeHandler"/>
+        <result property="purchaserCode" column="po_発注担当者コード"/>
+        <result property="totalAmount" column="po_発注合計金額"/>
+        <result property="taxAmount" column="po_税額"/>
+        <result property="remarks" column="po_備考"/>
+        <result property="version" column="po_バージョン"/>
+        <result property="createdAt" column="po_作成日時"/>
+        <result property="updatedAt" column="po_更新日時"/>
+        <!-- 発注明細との1:N関連 -->
+        <collection property="details"
+                    ofType="com.example.sms.domain.model.purchase.PurchaseOrderDetail"
+                    resultMap="PurchaseOrderDetailNestedResultMap"/>
+    </resultMap>
+
+    <!-- 発注明細のネスト ResultMap -->
+    <resultMap id="PurchaseOrderDetailNestedResultMap"
+               type="com.example.sms.domain.model.purchase.PurchaseOrderDetail">
+        <id property="id" column="pod_id"/>
+        <result property="purchaseOrderNumber" column="pod_発注番号"/>
+        <result property="lineNumber" column="pod_発注行番号"/>
+        <result property="productCode" column="pod_商品コード"/>
+        <result property="orderQuantity" column="pod_発注数量"/>
+        <result property="unitPrice" column="pod_発注単価"/>
+        <result property="orderAmount" column="pod_発注金額"/>
+        <result property="expectedDeliveryDate" column="pod_入荷予定日"/>
+        <result property="receivedQuantity" column="pod_入荷済数量"/>
+        <result property="remainingQuantity" column="pod_残数量"/>
+        <result property="remarks" column="pod_備考"/>
+    </resultMap>
+
+    <!-- JOIN による一括取得クエリ -->
+    <select id="findWithDetailsByPurchaseOrderNumber"
+            resultMap="PurchaseOrderWithDetailsResultMap">
+        SELECT
+            po."ID" AS po_id,
+            po."発注番号" AS po_発注番号,
+            po."仕入先コード" AS po_仕入先コード,
+            po."発注日" AS po_発注日,
+            po."希望納期" AS po_希望納期,
+            po."発注ステータス" AS po_発注ステータス,
+            po."発注担当者コード" AS po_発注担当者コード,
+            po."発注合計金額" AS po_発注合計金額,
+            po."税額" AS po_税額,
+            po."備考" AS po_備考,
+            po."バージョン" AS po_バージョン,
+            po."作成日時" AS po_作成日時,
+            po."更新日時" AS po_更新日時,
+            pod."ID" AS pod_id,
+            pod."発注番号" AS pod_発注番号,
+            pod."発注行番号" AS pod_発注行番号,
+            pod."商品コード" AS pod_商品コード,
+            pod."発注数量" AS pod_発注数量,
+            pod."発注単価" AS pod_発注単価,
+            pod."発注金額" AS pod_発注金額,
+            pod."入荷予定日" AS pod_入荷予定日,
+            pod."入荷済数量" AS pod_入荷済数量,
+            pod."残数量" AS pod_残数量,
+            pod."備考" AS pod_備考
+        FROM "発注データ" po
+        LEFT JOIN "発注明細データ" pod
+            ON po."発注番号" = pod."発注番号"
+        WHERE po."発注番号" = #{purchaseOrderNumber}
+        ORDER BY pod."発注行番号"
+    </select>
+
+</mapper>
+```
+
+</details>
+
+### リレーション設定のポイント
+
+| 設定項目 | 説明 |
+|---------|------|
+| `<collection>` | 1:N 関連のマッピング |
+| `<id>` | 主キーの識別（MyBatis が重複排除に使用） |
+| `resultMap` | ネストした ResultMap の参照 |
+| エイリアス（AS） | カラム名の重複を避けるためのプレフィックス |
+| `ORDER BY` | コレクションの順序を保証 |
+
+### 楽観ロック（Optimistic Locking）の実装
+
+複数ユーザーが同時に発注データや入荷データを編集する場合、データの整合性を保つために楽観ロックを実装します。
+
+```plantuml
+@startuml
+
+title 楽観ロックの動作シーケンス
+
+actor "購買担当A" as userA
+actor "購買担当B" as userB
+database "発注テーブル" as db
+
+userA -> db : SELECT（version=1）
+userB -> db : SELECT（version=1）
+userA -> userA : 画面で編集
+userB -> userB : 画面で編集
+userA -> db : UPDATE WHERE version=1\n→ version=2 に更新
+db -> userA : 更新成功（1行）
+userB -> db : UPDATE WHERE version=1
+db -> userB : 更新失敗（0行）\n楽観ロック例外
+
+note right of userB
+  再読み込みを促す
+  エラーメッセージ表示
+end note
+
+@enduml
+```
+
+### バージョンカラムによる同時更新制御
+
+<details>
+<summary>楽観ロック対応の MyBatis Mapper</summary>
+
+```xml
+<!-- 楽観ロック対応の更新（バージョンチェック付き） -->
+<update id="updateWithOptimisticLock"
+        parameterType="com.example.sms.domain.model.purchase.PurchaseOrder">
+    UPDATE "発注データ"
+    SET
+        "仕入先コード" = #{supplierCode},
+        "発注日" = #{orderDate},
+        "希望納期" = #{desiredDeliveryDate},
+        "発注ステータス" = #{status,
+            typeHandler=com.example.sms.infrastructure.out.persistence.typehandler.PurchaseOrderStatusTypeHandler}::発注ステータス,
+        "発注担当者コード" = #{purchaserCode},
+        "発注合計金額" = #{totalAmount},
+        "税額" = #{taxAmount},
+        "備考" = #{remarks},
+        "更新日時" = CURRENT_TIMESTAMP,
+        "バージョン" = "バージョン" + 1
+    WHERE "発注番号" = #{purchaseOrderNumber}
+    AND "バージョン" = #{version}
+</update>
+
+<!-- 楽観ロック対応の削除 -->
+<delete id="deleteWithOptimisticLock">
+    DELETE FROM "発注データ"
+    WHERE "発注番号" = #{purchaseOrderNumber}
+    AND "バージョン" = #{version}
+</delete>
+```
+
+</details>
+
+<details>
+<summary>Repository 実装：楽観ロック対応</summary>
+
+```java
+// src/main/java/com/example/sms/infrastructure/out/persistence/repository/PurchaseOrderRepositoryImpl.java
+package com.example.sms.infrastructure.out.persistence.repository;
+
+import com.example.sms.application.port.out.PurchaseOrderRepository;
+import com.example.sms.domain.exception.OptimisticLockException;
+import com.example.sms.domain.model.purchase.PurchaseOrder;
+import com.example.sms.domain.model.purchase.PurchaseOrderDetail;
+import com.example.sms.infrastructure.out.persistence.mapper.PurchaseOrderMapper;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.Optional;
+
+/**
+ * 発注リポジトリ実装.
+ */
+@Repository
+@RequiredArgsConstructor
+public class PurchaseOrderRepositoryImpl implements PurchaseOrderRepository {
+
+    private final PurchaseOrderMapper purchaseOrderMapper;
+
+    @Override
+    public void save(PurchaseOrder purchaseOrder) {
+        purchaseOrderMapper.insertHeader(purchaseOrder);
+        if (purchaseOrder.getDetails() != null) {
+            for (PurchaseOrderDetail detail : purchaseOrder.getDetails()) {
+                detail.setPurchaseOrderId(purchaseOrder.getId());
+                purchaseOrderMapper.insertDetail(detail);
+            }
+        }
+    }
+
+    @Override
+    public Optional<PurchaseOrder> findByPurchaseOrderNumber(String purchaseOrderNumber) {
+        return purchaseOrderMapper.findByPurchaseOrderNumber(purchaseOrderNumber);
+    }
+
+    @Override
+    public Optional<PurchaseOrder> findWithDetailsByPurchaseOrderNumber(String purchaseOrderNumber) {
+        return Optional.ofNullable(purchaseOrderMapper.findWithDetailsByPurchaseOrderNumber(purchaseOrderNumber));
+    }
+
+    /**
+     * 楽観ロック対応の更新.
+     * @throws OptimisticLockException 他のユーザーによって更新された場合
+     */
+    @Override
+    @Transactional
+    public void update(PurchaseOrder purchaseOrder) {
+        int updatedCount = purchaseOrderMapper.updateWithOptimisticLock(purchaseOrder);
+
+        if (updatedCount == 0) {
+            // バージョン不一致または削除済み
+            Integer currentVersion = purchaseOrderMapper.findVersionById(purchaseOrder.getId());
+            if (currentVersion == null) {
+                throw new OptimisticLockException("発注", purchaseOrder.getId());
+            } else {
+                throw new OptimisticLockException("発注", purchaseOrder.getId(),
+                        purchaseOrder.getVersion(), currentVersion);
+            }
+        }
+
+        purchaseOrderMapper.deleteDetailsByPurchaseOrderId(purchaseOrder.getId());
+        if (purchaseOrder.getDetails() != null) {
+            for (PurchaseOrderDetail detail : purchaseOrder.getDetails()) {
+                detail.setPurchaseOrderId(purchaseOrder.getId());
+                purchaseOrderMapper.insertDetail(detail);
+            }
+        }
+    }
+
+    @Override
+    public void deleteById(Integer id) {
+        purchaseOrderMapper.deleteById(id);
+    }
+
+    @Override
+    public void deleteAll() {
+        purchaseOrderMapper.deleteAll();
+    }
+}
+```
+
+</details>
+
+### 楽観ロックのテスト
+
+<details>
+<summary>楽観ロックのテストコード</summary>
+
+```java
+@Nested
+@DisplayName("楽観ロック")
+class OptimisticLocking {
+
+    @Test
+    @DisplayName("同じバージョンで更新できる")
+    void canUpdateWithSameVersion() {
+        var purchaseOrder = createPurchaseOrder("PO-2025-0001", LocalDate.of(2025, 1, 15));
+        purchaseOrderRepository.save(purchaseOrder);
+
+        var fetched = purchaseOrderRepository.findByPurchaseOrderNumber("PO-2025-0001").get();
+        fetched.setStatus(PurchaseOrderStatus.CONFIRMED);
+        purchaseOrderRepository.update(fetched);
+
+        var updated = purchaseOrderRepository.findByPurchaseOrderNumber("PO-2025-0001").get();
+        assertThat(updated.getStatus()).isEqualTo(PurchaseOrderStatus.CONFIRMED);
+        assertThat(updated.getVersion()).isEqualTo(2);
+    }
+
+    @Test
+    @DisplayName("異なるバージョンで更新すると楽観ロック例外が発生する")
+    void throwsExceptionWhenVersionMismatch() {
+        var purchaseOrder = createPurchaseOrder("PO-2025-0002", LocalDate.of(2025, 1, 15));
+        purchaseOrderRepository.save(purchaseOrder);
+
+        var poA = purchaseOrderRepository.findByPurchaseOrderNumber("PO-2025-0002").get();
+        var poB = purchaseOrderRepository.findByPurchaseOrderNumber("PO-2025-0002").get();
+
+        poA.setStatus(PurchaseOrderStatus.CONFIRMED);
+        purchaseOrderRepository.update(poA);
+
+        poB.setStatus(PurchaseOrderStatus.CANCELLED);
+        assertThatThrownBy(() -> purchaseOrderRepository.update(poB))
+                .isInstanceOf(OptimisticLockException.class)
+                .hasMessageContaining("他のユーザーによって更新されています");
+    }
+
+    @Test
+    @DisplayName("削除されたエンティティを更新すると楽観ロック例外が発生する")
+    void throwsExceptionWhenEntityDeleted() {
+        var purchaseOrder = createPurchaseOrder("PO-2025-0003", LocalDate.of(2025, 1, 15));
+        purchaseOrderRepository.save(purchaseOrder);
+
+        var fetched = purchaseOrderRepository.findByPurchaseOrderNumber("PO-2025-0003").get();
+        purchaseOrderRepository.deleteById(fetched.getId());
+
+        fetched.setStatus(PurchaseOrderStatus.CONFIRMED);
+        assertThatThrownBy(() -> purchaseOrderRepository.update(fetched))
+                .isInstanceOf(OptimisticLockException.class)
+                .hasMessageContaining("既に削除されています");
+    }
+}
+```
+
+</details>
+
+### 楽観ロックのベストプラクティス
+
+| ポイント | 説明 |
+|---------|------|
+| **バージョンカラム** | INTEGER 型で十分（オーバーフローは現実的に発生しない） |
+| **WHERE 条件** | 必ず `AND "バージョン" = #{version}` を含める |
+| **インクリメント** | `"バージョン" = "バージョン" + 1` でアトミックに更新 |
+| **例外処理** | 更新件数が0の場合は楽観ロック例外をスロー |
+| **エラーメッセージ** | ユーザーにわかりやすいメッセージで再読み込みを促す |
+
+---
+
+## 第8章のまとめ
+
+本章では、調達管理の核心部分である発注・入荷・仕入処理について学びました。
+
+### 学んだこと
+
+1. **調達パターンの理解**
+   - 在庫補充発注、受注連動発注、計画発注、スポット発注
+
+2. **発注データの構造**
+   - ヘッダ・明細構造
+   - 発注ステータス管理
+   - 仕入先マスタとの連携
+
+3. **入荷・検収処理**
+   - 入荷検品のフロー
+   - 合格/不合格数量の管理
+   - 仕入計上と買掛金発生
+
+4. **諸口品目の扱い**
+   - 商品マスタに登録しない品目の処理
+
+5. **リレーションと楽観ロック**
+   - N+1 問題の回避
+   - 同時更新の競合制御
+
+### 調達管理の ER 図（全体像）
+
+```plantuml
+@startuml
+
+title 調達管理のER図
+
+entity 仕入先マスタ {
+  取引先コード <<PK>>
+  --
+  仕入先名
+  締日
+  支払サイト
+}
+
+entity 発注データ {
+  ID <<PK>>
+  --
+  発注番号
+  仕入先コード <<FK>>
+  発注日
+  希望納期
+  発注ステータス
+  発注合計金額
+  税額
+  バージョン
+}
+
+entity 発注明細データ {
+  ID <<PK>>
+  --
+  発注番号 <<FK>>
+  発注行番号
+  商品コード <<FK>>
+  発注数量
+  発注単価
+  入荷済数量
+  残数量
+}
+
+entity 入荷データ {
+  ID <<PK>>
+  --
+  入荷番号
+  発注番号 <<FK>>
+  仕入先コード <<FK>>
+  入荷日
+  入荷ステータス
+  倉庫コード <<FK>>
+  バージョン
+}
+
+entity 入荷明細データ {
+  ID <<PK>>
+  --
+  入荷番号 <<FK>>
+  入荷行番号
+  商品コード <<FK>>
+  入荷数量
+  合格数量
+  不合格数量
+}
+
+entity 仕入データ {
+  ID <<PK>>
+  --
+  仕入番号
+  入荷番号 <<FK>>
+  仕入先コード <<FK>>
+  仕入日
+  仕入合計金額
+  税額
+  バージョン
+}
+
+entity 仕入明細データ {
+  ID <<PK>>
+  --
+  仕入番号 <<FK>>
+  仕入行番号
+  商品コード <<FK>>
+  仕入数量
+  仕入単価
+}
+
+entity 商品マスタ {
+  商品コード <<PK>>
+  --
+  商品名
+  仕入単価
+}
+
+entity 倉庫マスタ {
+  倉庫コード <<PK>>
+  --
+  倉庫名
+}
+
+仕入先マスタ ||--o{ 発注データ
+発注データ ||--o{ 発注明細データ
+商品マスタ ||--o{ 発注明細データ
+発注データ ||--o{ 入荷データ
+入荷データ ||--o{ 入荷明細データ
+入荷データ ||--o| 仕入データ
+仕入データ ||--o{ 仕入明細データ
+倉庫マスタ ||--o{ 入荷データ
+
+@enduml
+```
+
+### 次章の予告
+
+第9章では、在庫管理の設計に進みます。倉庫別・商品別の在庫管理、引当処理、棚卸業務のデータベース設計と実装を行います。
+
+---
+
+[← 第7章：債権管理の設計](./chapter07.md) | [第9章：在庫管理の設計 →](./chapter09.md)