@k2works/claude-code-booster 6.1.0 → 6.3.0

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

@@ -1,2114 +0,0 @@
----
-type: Article
-title: "第8章：調達管理の設計"
-description: "販売管理システムにおいて、商品の仕入れを管理する調達業務は事業継続の基盤となります。"
-tags: [article, practical-database-design, part2]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-30T08:34:28Z }
----
-
-# 第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)