@k2works/claude-code-booster 4.7.0 → 4.8.0

package/lib/assets/docs/article/practical-database-design/part4/chapter22.md

@@ -1,965 +1,965 @@
-# 第22章：生産管理システムの全体像
-
-本章から第4部「生産管理システム」の解説に入ります。まず、生産管理システムのスコープと、関連する組織の役割分担について解説します。
-
----
-
-## 22.1 生産管理システムのスコープ
-
-生産管理システムは、製造業における「モノづくり」の全工程を管理するシステムです。販売管理システムからの受注情報を起点として、生産計画の立案から製品の完成、在庫管理に至るまでの一連の業務プロセスを管理します。
-
-### システム全体像
-
-```plantuml
-@startuml
-
-title 生産管理システムの全体像
-
-rectangle "販売管理" as sales
-rectangle "生産管理" as production {
-    rectangle "生産計画" as plan
-    rectangle "購買管理" as purchase
-    rectangle "製造管理" as manufacturing
-    rectangle "在庫管理" as inventory
-    rectangle "品質管理" as quality
-    rectangle "原価管理" as cost
-}
-rectangle "財務会計" as finance
-
-sales --> plan : 受注情報
-plan --> purchase : 購買オーダ
-plan --> manufacturing : 製造オーダ
-purchase --> inventory : 入荷
-manufacturing --> inventory : 完成品
-manufacturing --> quality : 検査依頼
-quality --> inventory : 合格品
-inventory --> sales : 出荷
-cost --> finance : 原価情報
-
-@enduml
-```
-
-### ユースケース図
-
-生産管理システム全体のユースケースは以下の通りです。
-
-```plantuml
-@startuml
-left to right direction
-skinparam packageStyle rectangle
-skinparam linetype ortho
-title 生産管理システム ユースケース図
-
-actor 営業担当者 as sales
-actor 生産管理担当者 as planner
-actor 購買担当者 as buyer
-actor 製造担当者 as worker
-actor 品質管理担当者 as qa
-actor 倉庫担当者 as warehouse
-
-rectangle 生産管理システム {
-    usecase "生産計画立案" as UC_PLAN
-    usecase "所要量展開(MRP)" as UC_MRP
-    usecase "発注管理" as UC_ORDER
-    usecase "入荷・検収管理" as UC_RECEIVE
-    usecase "製造指示" as UC_WORK
-    usecase "製造実績報告" as UC_RESULT
-    usecase "在庫管理" as UC_INVENTORY
-    usecase "品質管理" as UC_QUALITY
-    usecase "原価管理" as UC_COST
-}
-
-sales -- UC_PLAN
-planner -- UC_PLAN
-planner -- UC_MRP
-buyer -- UC_ORDER
-buyer -- UC_RECEIVE
-worker -- UC_WORK
-worker -- UC_RESULT
-warehouse -- UC_INVENTORY
-warehouse -- UC_RECEIVE
-qa -- UC_QUALITY
-qa -- UC_RECEIVE
-planner -- UC_COST
-@enduml
-```
-
-### 生産計画（MPS・MRP）
-
-生産計画は、販売計画や受注情報に基づいて、何をいつまでにどれだけ生産するかを決定する業務です。
-
-```plantuml
-@startuml
-
-state "生産計画業務" as Planning {
-    state "販売計画確認" as SalesPlan
-    state "MPS作成" as MPS
-    state "MRP実行" as MRP
-    state "計画調整" as Adjust
-    state "計画確定" as Confirm
-
-    [*] --> SalesPlan
-    SalesPlan --> MPS : 需要情報
-    MPS --> MRP : 基準生産計画
-    MRP --> Adjust : 所要量展開
-    Adjust --> Confirm : 調整完了
-    Adjust --> MRP : 再計算
-    Confirm --> [*]
-}
-
-@enduml
-```
-
-| 項目 | 説明 |
-|---|---|
-| MPS（基準生産計画） | 製品レベルの生産計画。何をいつまでにいくつ作るか |
-| MRP（所要量展開） | BOM を使って部品・材料レベルまで展開。必要数量と時期を算出 |
-| 主なデータ | オーダ情報、所要情報、引当情報 |
-
-### 購買管理（発注・入荷・検収）
-
-購買管理は、生産に必要な部品・材料を外部から調達する業務です。
-
-```plantuml
-@startuml
-
-state "購買管理業務" as Purchasing {
-    state "発注" as Order {
-        state "発注登録" as OrderCreate
-        state "発注確定" as OrderConfirm
-    }
-    state "入荷" as Receive {
-        state "入荷登録" as ReceiveCreate
-        state "受入検査" as Inspection
-    }
-    state "検収" as Accept {
-        state "検収登録" as AcceptCreate
-        state "在庫計上" as StockIn
-    }
-
-    [*] --> OrderCreate
-    OrderCreate --> OrderConfirm
-    OrderConfirm --> ReceiveCreate : 入荷
-    ReceiveCreate --> Inspection
-    Inspection --> AcceptCreate : 合格
-    Inspection --> ReceiveCreate : 不合格（返品）
-    AcceptCreate --> StockIn
-    StockIn --> [*]
-}
-
-@enduml
-```
-
-| 項目 | 説明 |
-|---|---|
-| 目的 | 生産に必要な部品・材料を適切なタイミングで調達 |
-| 入力 | MRP からの購買オーダ、発注依頼 |
-| 出力 | 発注書、入荷伝票、検収伝票 |
-| 主なデータ | 発注データ、入荷受入データ、検収データ |
-
-### 工程管理（製造指示・製造実績）
-
-工程管理は、製造オーダに基づいて製造作業を指示し、実績を収集する業務です。
-
-```plantuml
-@startuml
-
-state "工程管理業務" as Process {
-    state "製造指示" as Instruction {
-        state "作業指示作成" as WorkOrder
-        state "ピッキング" as Picking
-    }
-    state "製造作業" as Work {
-        state "工程作業" as Operation
-        state "工程検査" as ProcessInspection
-    }
-    state "製造実績" as Result {
-        state "完成報告" as Complete
-        state "工数報告" as LaborReport
-    }
-
-    [*] --> WorkOrder
-    WorkOrder --> Picking
-    Picking --> Operation
-    Operation --> ProcessInspection
-    ProcessInspection --> Operation : 不合格
-    ProcessInspection --> Complete : 合格
-    Complete --> LaborReport
-    LaborReport --> [*]
-}
-
-@enduml
-```
-
-| 項目 | 説明 |
-|---|---|
-| 目的 | 製造オーダを効率的に実行し、実績を正確に記録 |
-| 入力 | 製造オーダ、工程表、BOM |
-| 出力 | 作業指示書、ピッキングリスト、完成報告書 |
-| 主なデータ | 作業指示データ、完成実績データ、工数実績データ |
-
-### 在庫管理（受払・在庫状態）
-
-在庫管理は、部品・材料・製品の在庫数量と状態を管理する業務です。
-
-```plantuml
-@startuml
-
-state "在庫管理業務" as Inventory {
-    state "入庫" as StockIn
-    state "出庫" as StockOut
-    state "在庫照会" as Query
-    state "棚卸" as Count
-
-    [*] --> StockIn : 入荷・完成
-    [*] --> StockOut : 払出・出荷
-    [*] --> Query : 参照
-    [*] --> Count : 定期棚卸
-
-    StockIn --> [*]
-    StockOut --> [*]
-    Query --> [*]
-    Count --> [*]
-}
-
-@enduml
-```
-
-| 項目 | 説明 |
-|---|---|
-| 目的 | 在庫の正確な把握と適正在庫の維持 |
-| 主な機能 | 在庫照会、受払管理、棚卸、在庫調整 |
-| 主なデータ | 在庫データ、払出データ、棚卸データ |
-
-### 品質管理（受入検査・出荷検査・トレーサビリティ）
-
-品質管理は、製品の品質を確保するための検査と履歴管理を行う業務です。
-
-| 検査種別 | タイミング | 目的 |
-|---|---|---|
-| 受入検査 | 入荷時 | 購入品の品質確認 |
-| 工程検査 | 製造中 | 工程ごとの品質確認 |
-| 出荷検査 | 出荷前 | 最終製品の品質確認 |
-
-### 製造原価管理（標準原価・実際原価・配賦）
-
-製造原価管理は、製品の製造にかかったコストを計算・管理する業務です。
-
-| 原価要素 | 説明 |
-|---|---|
-| 材料費 | 直接材料費、間接材料費 |
-| 労務費 | 直接労務費、間接労務費 |
-| 製造間接費 | 減価償却費、光熱費、間接労務費等 |
-
-### マスタ情報とトランザクション情報
-
-生産管理システムのデータは、大きく「マスタ情報」と「トランザクション情報」に分類されます。
-
-| 分類 | 説明 | 例 |
-|-----|------|-----|
-| **マスタ情報** | 基本的に変更が少ない、システムの基盤となるデータ | 品目マスタ、BOM、取引先マスタ、工程マスタ |
-| **トランザクション情報** | 日々の業務で発生するデータ | 発注データ、製造実績、在庫移動 |
-
----
-
-## 22.2 生産組織の役割分担
-
-生産管理システムに関わる組織は複数あり、それぞれが異なる役割を担っています。
-
-### 組織構成
-
-```plantuml
-@startuml
-
-package "生産管理に関わる組織" {
-    rectangle "営業部" as Sales #LightBlue {
-        Sales : ・受注情報の連携
-        Sales : ・納期調整
-        Sales : ・出荷指示
-    }
-
-    rectangle "生産管理部" as ProdMgmt #LightGreen {
-        ProdMgmt : ・生産計画立案
-        ProdMgmt : ・MRP 実行
-        ProdMgmt : ・進捗管理
-        ProdMgmt : ・原価管理
-    }
-
-    rectangle "製造部" as Manufacturing #LightYellow {
-        Manufacturing : ・製造作業
-        Manufacturing : ・完成報告
-        Manufacturing : ・工数報告
-    }
-
-    rectangle "購買部" as Purchasing #LightPink {
-        Purchasing : ・発注管理
-        Purchasing : ・納期管理
-        Purchasing : ・仕入先管理
-    }
-
-    rectangle "外注部" as Outsource #LightCoral {
-        Outsource : ・外注発注
-        Outsource : ・支給品管理
-        Outsource : ・外注進捗管理
-    }
-
-    rectangle "資材倉庫" as MaterialWH #Lavender {
-        MaterialWH : ・入荷受入
-        MaterialWH : ・部材払出
-        MaterialWH : ・在庫管理
-    }
-
-    rectangle "製品倉庫" as ProductWH #LightCyan {
-        ProductWH : ・完成品入庫
-        ProductWH : ・出荷作業
-        ProductWH : ・在庫管理
-    }
-}
-
-@enduml
-```
-
-### 営業部
-
-営業部は、得意先との接点を持ち、受注情報を生産管理に連携します。
-
-| 業務 | 責務 | 主な操作 |
-|---|---|---|
-| 受注連携 | 受注情報の生産計画への連携 | 受注データ登録 |
-| 納期調整 | 生産計画に基づく納期回答 | 納期回答、納期変更 |
-| 出荷指示 | 製品倉庫への出荷依頼 | 出荷指示登録 |
-
-### 生産管理部
-
-生産管理部は、生産計画の立案から進捗管理、原価管理までを担当します。
-
-| 業務 | 責務 | 主な操作 |
-|---|---|---|
-| 生産計画 | MPS・MRP の立案と調整 | 計画登録、所要量展開 |
-| 進捗管理 | 製造進捗の監視と対応 | 進捗照会、遅延アラート |
-| 原価管理 | 製造原価の計算と分析 | 原価計算、差異分析 |
-
-### 製造部
-
-製造部は、実際の製造作業を担当します。
-
-| 業務 | 責務 | 主な操作 |
-|---|---|---|
-| 製造作業 | 作業指示に基づく製造 | 作業実施 |
-| 完成報告 | 完成数量の報告 | 完成実績登録 |
-| 工数報告 | 作業時間の報告 | 工数実績登録 |
-
-### 購買部
-
-購買部は、部品・材料の外部調達を担当します。
-
-| 業務 | 責務 | 主な操作 |
-|---|---|---|
-| 発注 | 仕入先への発注 | 発注登録、注文書発行 |
-| 納期管理 | 入荷予定の管理 | 納期確認、督促 |
-| 仕入先管理 | 仕入先情報の管理 | 仕入先評価 |
-
-### 外注部
-
-外注部は、外注加工の管理を担当します。
-
-| 業務 | 責務 | 主な操作 |
-|---|---|---|
-| 外注発注 | 外注先への加工依頼 | 外注発注登録 |
-| 支給品管理 | 外注先への支給品管理 | 支給登録、消費確認 |
-| 進捗管理 | 外注作業の進捗管理 | 進捗確認、督促 |
-
-### 資材倉庫
-
-資材倉庫は、部品・材料の物理的な管理を担当します。
-
-| 業務 | 責務 | 主な操作 |
-|---|---|---|
-| 入荷受入 | 購入品の受入と検品 | 入荷登録、検品 |
-| 部材払出 | 製造への部材供給 | 払出登録、ピッキング |
-| 在庫管理 | 在庫数量の管理 | 棚卸、在庫調整 |
-
-### 製品倉庫
-
-製品倉庫は、完成品の物理的な管理を担当します。
-
-| 業務 | 責務 | 主な操作 |
-|---|---|---|
-| 完成品入庫 | 製造からの完成品受入 | 入庫登録 |
-| 出荷作業 | 得意先への出荷 | 出荷登録、配送手配 |
-| 在庫管理 | 製品在庫の管理 | 棚卸、在庫調整 |
-
-### 業務フローと各部門の責務
-
-各部門がどのタイミングで業務に関与するかを、全体フローで示します。
-
-```plantuml
-@startuml
-title 生産管理システムの全体フロー
-
-|営業部|
-start
-:受注情報;
-
-|生産管理部|
-:生産計画立案;
-:MRP実行;
-fork
-:購買オーダ;
-fork again
-:製造オーダ;
-fork end
-
-|購買部|
-:発注登録;
-
-|システム|
-:発注データ;
-:注文書;
-
-|資材倉庫|
-:入荷受入;
-:受入検査;
-
-|購買部|
-:検収登録;
-
-|システム|
-fork
-:検収データ;
-fork again
-:在庫データ（入庫）;
-fork end
-
-|生産管理部|
-:作業指示作成;
-
-|システム|
-:作業指示データ;
-:作業指示書;
-:ピッキングリスト;
-
-|資材倉庫|
-:部材払出;
-
-|製造部|
-:製造作業;
-:完成報告;
-:工数報告;
-
-|システム|
-fork
-:完成実績データ;
-fork again
-:工数実績データ;
-fork again
-:在庫データ（完成品入庫）;
-fork end
-
-|製品倉庫|
-:完成品入庫;
-
-|営業部|
-:出荷指示;
-
-|製品倉庫|
-:出荷作業;
-
-|システム|
-:出荷データ;
-
-stop
-
-@enduml
-```
-
-### 部門間の連携ポイント
-
-```plantuml
-@startuml
-
-rectangle "営業部" as Sales
-rectangle "生産管理部" as ProdMgmt
-rectangle "製造部" as Manufacturing
-rectangle "購買部" as Purchasing
-rectangle "外注部" as Outsource
-rectangle "資材倉庫" as MaterialWH
-rectangle "製品倉庫" as ProductWH
-
-Sales --> ProdMgmt : 受注情報
-ProdMgmt --> Purchasing : 購買オーダ
-ProdMgmt --> Manufacturing : 製造オーダ
-ProdMgmt --> Outsource : 外注オーダ
-
-Purchasing --> MaterialWH : 入荷予定
-Outsource --> MaterialWH : 支給指示
-
-MaterialWH --> Manufacturing : 部材供給
-Manufacturing --> ProductWH : 完成品
-
-ProductWH --> Sales : 出荷可能報告
-
-Manufacturing --> ProdMgmt : 進捗報告
-Outsource --> ProdMgmt : 外注進捗
-
-@enduml
-```
-
-| 連携元 | 連携先 | 連携内容 |
-|---|---|---|
-| 営業部 | 生産管理部 | 受注情報、納期要望 |
-| 生産管理部 | 購買部 | 購買オーダ |
-| 生産管理部 | 製造部 | 製造オーダ、作業指示 |
-| 生産管理部 | 外注部 | 外注オーダ |
-| 購買部 | 資材倉庫 | 入荷予定情報 |
-| 外注部 | 資材倉庫 | 支給指示 |
-| 資材倉庫 | 製造部 | 部材供給 |
-| 製造部 | 製品倉庫 | 完成品 |
-| 製造部 | 生産管理部 | 進捗報告 |
-| 製品倉庫 | 営業部 | 出荷可能報告 |
-
----
-
-## 22.3 生産管理システムのアーキテクチャ
-
-本節では、生産管理システム（PMS: Production Management System）のプロジェクト構成とアーキテクチャについて解説します。
-
-### プロジェクト構成
-
-生産管理システムは `apps/pms` ディレクトリ以下に構築します。
-
-```
-apps/pms/
-├── backend/
-│   ├── build.gradle.kts               # Gradle ビルド設定（Kotlin DSL）
-│   ├── settings.gradle.kts            # Gradle 設定
-│   ├── config/                        # 品質管理ツール設定
-│   │   ├── checkstyle/
-│   │   │   └── checkstyle.xml
-│   │   ├── pmd/
-│   │   │   └── ruleset.xml
-│   │   └── spotbugs/
-│   │       └── exclude.xml
-│   │
-│   └── src/
-│       ├── main/
-│       │   ├── java/com/example/pms/
-│       │   │   │
-│       │   │   ├── domain/            # ドメイン層（純粋なビジネスロジック）
-│       │   │   │   ├── model/         # ドメインモデル（エンティティ、値オブジェクト）
-│       │   │   │   │   ├── master/    # マスタ関連
-│       │   │   │   │   └── transaction/ # トランザクション関連
-│       │   │   │   ├── type/          # 基本型（通貨、単位、数量等）
-│       │   │   │   └── exception/     # ドメイン例外
-│       │   │   │
-│       │   │   ├── application/       # アプリケーション層
-│       │   │   │   ├── port/
-│       │   │   │   │   ├── in/        # Input Port（ユースケースIF）
-│       │   │   │   │   └── out/       # Output Port（リポジトリIF）
-│       │   │   │   └── service/       # Application Service（ユースケース実装）
-│       │   │   │
-│       │   │   ├── infrastructure/    # インフラストラクチャ層
-│       │   │   │   ├── in/            # Input Adapter
-│       │   │   │   │   └── rest/      # REST API Controller
-│       │   │   │   ├── out/           # Output Adapter
-│       │   │   │   │   └── persistence/ # 永続化（MyBatis Mapper）
-│       │   │   │   └── config/        # 設定クラス
-│       │   │   │
-│       │   │   └── Application.java   # メインクラス
-│       │   │
-│       │   └── resources/
-│       │       ├── application.yml    # アプリケーション設定
-│       │       ├── db/migration/      # Flyway マイグレーション
-│       │       └── mapper/            # MyBatis XML マッパー
-│       │
-│       └── test/
-│           ├── java/com/example/pms/
-│           │   ├── testsetup/         # テスト基盤クラス
-│           │   │   └── BaseIntegrationTest.java
-│           │   ├── domain/            # ドメイン層テスト
-│           │   ├── application/       # アプリケーション層テスト
-│           │   └── infrastructure/    # インフラ層テスト
-│           │
-│           └── resources/
-│               └── application-test.yml
-│
-└── docker-compose.yml                 # Docker 構成
-```
-
-**各レイヤーの責務：**
-
-| レイヤー | 責務 |
-|---|---|
-| Domain 層 | ビジネスルールとドメインモデル（外部技術に非依存） |
-| Application 層 | ユースケースの実装とオーケストレーション |
-| Infrastructure 層 | 外部技術との接続（DB、Web 等） |
-
-### ヘキサゴナルアーキテクチャ（ポート&アダプター）
-
-生産管理システムは、ヘキサゴナルアーキテクチャ（Ports and Adapters）を採用します。このアーキテクチャにより、ビジネスロジックを外部の技術的関心事から分離し、テスト容易性と保守性を高めます。
-
-```plantuml
-@startuml
-!define HEXAGON(name) hexagon name
-
-skinparam hexagon {
-    BackgroundColor<<domain>> LightBlue
-    BackgroundColor<<port>> LightGreen
-    BackgroundColor<<adapter>> LightYellow
-}
-
-package "生産管理システム" {
-    ' ドメイン（中心）
-    hexagon "ドメイン\n(Domain)" <<domain>> as Domain {
-    }
-    note bottom of Domain
-        エンティティ
-        値オブジェクト
-        集約
-        ドメインサービス
-    end note
-
-    ' 入力ポート
-    rectangle "入力ポート\n(Input Ports)" <<port>> as InputPort {
-    }
-    note left of InputPort
-        ユースケース
-        インターフェース
-    end note
-
-    ' 出力ポート
-    rectangle "出力ポート\n(Output Ports)" <<port>> as OutputPort {
-    }
-    note right of OutputPort
-        リポジトリ
-        インターフェース
-    end note
-
-    ' プライマリアダプター
-    rectangle "プライマリアダプター\n(Primary Adapters)" <<adapter>> as PrimaryAdapter {
-    }
-    note top of PrimaryAdapter
-        REST API
-        GraphQL
-        CLI
-    end note
-
-    ' セカンダリアダプター
-    rectangle "セカンダリアダプター\n(Secondary Adapters)" <<adapter>> as SecondaryAdapter {
-    }
-    note bottom of SecondaryAdapter
-        PostgreSQL
-        Redis
-        外部 API
-    end note
-}
-
-PrimaryAdapter --> InputPort
-InputPort --> Domain
-Domain --> OutputPort
-OutputPort --> SecondaryAdapter
-
-@enduml
-```
-
-#### ドメイン（中心）
-
-ドメインはシステムの中心に位置し、ビジネスロジックを実装します。
-
-```
-domain/
-├── model/                       # ドメインモデル
-│   ├── master/                  # マスタ関連
-│   │   ├── Item.java            # 品目
-│   │   ├── Bom.java             # 部品構成表
-│   │   ├── WorkCalendar.java    # カレンダ
-│   │   ├── Location.java        # 場所
-│   │   └── Supplier.java        # 取引先
-│   ├── planning/                # 計画関連
-│   │   ├── ProductionPlan.java  # 生産計画
-│   │   ├── Order.java           # オーダ
-│   │   └── Requirement.java     # 所要
-│   ├── purchasing/              # 購買関連
-│   │   ├── PurchaseOrder.java   # 発注
-│   │   ├── Receiving.java       # 入荷受入
-│   │   └── Acceptance.java      # 検収
-│   ├── manufacturing/           # 製造関連
-│   │   ├── WorkOrder.java       # 作業指示
-│   │   ├── Completion.java      # 完成実績
-│   │   └── LaborReport.java     # 工数実績
-│   └── inventory/               # 在庫関連
-│       ├── Stock.java           # 在庫
-│       └── Issue.java           # 払出
-├── type/                        # 基本型
-│   ├── Money.java               # 通貨
-│   ├── Quantity.java            # 数量
-│   └── ItemCode.java            # 品目コード
-└── exception/                   # ドメイン例外
-    └── DomainException.java
-```
-
-#### ポート（入力ポート・出力ポート）
-
-ポートは、ドメインと外部世界との境界を定義するインターフェースです。
-
-| ポート種別 | 役割 | 例 |
-|---|---|---|
-| 入力ポート | 外部からの要求を受け付ける | ユースケースインターフェース |
-| 出力ポート | 外部リソースへのアクセスを抽象化 | リポジトリインターフェース |
-
-```java
-// 入力ポート（ユースケースインターフェース）
-public interface ExecuteMrpUseCase {
-    MrpResult execute(MrpCommand command);
-}
-
-// 出力ポート（リポジトリインターフェース）
-public interface ItemRepository {
-    void save(Item item);
-    Optional<Item> findByCode(ItemCode code);
-    List<Item> findAll();
-}
-```
-
-#### アダプター（プライマリ・セカンダリ）
-
-アダプターは、ポートの実装を提供し、外部技術とドメインを接続します。
-
-| アダプター種別 | 役割 | 例 |
-|---|---|---|
-| プライマリアダプター | 外部からの入力を処理 | REST コントローラ、CLI |
-| セカンダリアダプター | 外部リソースへの出力を処理 | DB リポジトリ実装、外部 API クライアント |
-
-```
-infrastructure/
-├── in/                          # Input Adapter（プライマリアダプター）
-│   └── rest/                    # REST API
-│       ├── controller/
-│       │   ├── ItemController.java
-│       │   ├── BomController.java
-│       │   └── MrpController.java
-│       ├── dto/
-│       │   ├── ItemRequest.java
-│       │   └── ItemResponse.java
-│       └── exception/
-│           └── RestExceptionHandler.java
-├── out/                         # Output Adapter（セカンダリアダプター）
-│   └── persistence/             # 永続化
-│       ├── mapper/              # MyBatis Mapper
-│       │   └── ItemMapper.java
-│       ├── repository/          # Repository実装
-│       │   └── ItemRepositoryImpl.java
-│       └── typehandler/         # 型ハンドラ
-│           └── ItemTypeEnumHandler.java
-└── config/                      # 設定クラス
-    ├── DatabaseConfig.java
-    └── WebConfig.java
-```
-
-#### 依存性の方向と依存性逆転の原則
-
-ヘキサゴナルアーキテクチャでは、すべての依存性がドメインに向かいます。
-
-```plantuml
-@startuml
-skinparam rectangle {
-    BackgroundColor<<domain>> LightBlue
-    BackgroundColor<<app>> LightGreen
-    BackgroundColor<<infra>> LightYellow
-    BackgroundColor<<pres>> LightPink
-}
-
-rectangle "Presentation\n(プレゼンテーション層)" <<pres>> as Pres
-rectangle "Application\n(アプリケーション層)" <<app>> as App
-rectangle "Domain\n(ドメイン層)" <<domain>> as Domain
-rectangle "Infrastructure\n(インフラストラクチャ層)" <<infra>> as Infra
-
-Pres --> App
-App --> Domain
-Infra --> Domain
-
-note right of Domain
-    依存性逆転の原則（DIP）
-    ・ドメインはインターフェースを定義
-    ・インフラは実装を提供
-    ・依存の方向は常にドメインへ
-end note
-
-@enduml
-```
-
-### ドメイン駆動設計の適用
-
-#### 集約とリポジトリ
-
-生産管理システムの主要な集約を以下に示します。
-
-```plantuml
-@startuml
-!define AGGREGATE(name) rectangle name <<aggregate>>
-!define ENTITY(name) class name <<entity>>
-!define VALUE(name) class name <<value>>
-
-skinparam class {
-    BackgroundColor<<aggregate>> LightBlue
-    BackgroundColor<<entity>> LightGreen
-    BackgroundColor<<value>> LightYellow
-}
-
-package "品目集約" {
-    ENTITY(Item) {
-        +itemCode: ItemCode
-        +itemName: String
-        +itemType: ItemType
-        +unitCode: String
-        +leadTime: Integer
-    }
-
-    VALUE(ItemCode) {
-        +value: String
-    }
-
-    VALUE(ItemType) {
-        +value: String
-    }
-
-    Item --> ItemCode
-    Item --> ItemType
-}
-
-package "BOM集約" {
-    ENTITY(Bom) {
-        +parentItemCode: ItemCode
-        +childItemCode: ItemCode
-        +requiredQuantity: Quantity
-        +effectiveFrom: LocalDate
-        +effectiveTo: LocalDate
-    }
-
-    VALUE(Quantity) {
-        +value: BigDecimal
-    }
-
-    Bom --> Quantity
-}
-
-@enduml
-```
-
-| 集約 | ルートエンティティ | 主な責務 |
-|---|---|---|
-| 品目集約 | Item | 品目情報の管理 |
-| BOM 集約 | Bom | 部品構成の管理 |
-| オーダ集約 | Order | 生産・購買オーダの管理 |
-| 作業指示集約 | WorkOrder | 製造指示の管理 |
-| 在庫集約 | Stock | 在庫数量の管理 |
-
-#### ドメインサービス
-
-複数の集約をまたぐビジネスロジックは、ドメインサービスとして実装します。
-
-```java
-// MRP ドメインサービス
-public class MrpDomainService {
-
-    public List<Requirement> explodeRequirements(
-            Item item,
-            Quantity requiredQty,
-            LocalDate requiredDate,
-            BomRepository bomRepository) {
-
-        List<Bom> children = bomRepository.findChildren(item.getItemCode());
-
-        return children.stream()
-            .map(bom -> new Requirement(
-                bom.getChildItemCode(),
-                requiredQty.multiply(bom.getRequiredQuantity()),
-                requiredDate.minusDays(item.getLeadTime())
-            ))
-            .collect(Collectors.toList());
-    }
-}
-```
-
-#### アプリケーションサービス
-
-ユースケースの実装は、アプリケーションサービスとして実装します。
-
-```java
-@Service
-@RequiredArgsConstructor
-public class MrpApplicationService implements ExecuteMrpUseCase {
-
-    private final ItemRepository itemRepository;
-    private final BomRepository bomRepository;
-    private final OrderRepository orderRepository;
-    private final MrpDomainService mrpDomainService;
-
-    @Override
-    @Transactional
-    public MrpResult execute(MrpCommand command) {
-        // 1. 対象品目の取得
-        Item item = itemRepository.findByCode(command.getItemCode())
-            .orElseThrow(() -> new ItemNotFoundException(command.getItemCode()));
-
-        // 2. 所要量展開
-        List<Requirement> requirements = mrpDomainService.explodeRequirements(
-            item, command.getQuantity(), command.getRequiredDate(), bomRepository);
-
-        // 3. オーダ生成
-        List<Order> orders = requirements.stream()
-            .map(this::createOrder)
-            .collect(Collectors.toList());
-
-        orders.forEach(orderRepository::save);
-
-        return new MrpResult(orders);
-    }
-}
-```
-
-### API 設計
-
-#### RESTful API の基本方針
-
-| 方針 | 説明 |
-|---|---|
-| リソース指向 | URL はリソースを表現（動詞ではなく名詞） |
-| HTTP メソッド | GET（取得）、POST（作成）、PUT（更新）、DELETE（削除） |
-| ステータスコード | 200（成功）、201（作成）、400（クライアントエラー）、404（未検出）、500（サーバーエラー） |
-
-#### エンドポイント設計
-
-| エンドポイント | メソッド | 説明 |
-|---|---|---|
-| `/api/items` | GET | 品目一覧取得 |
-| `/api/items/{code}` | GET | 品目詳細取得 |
-| `/api/items` | POST | 品目登録 |
-| `/api/items/{code}` | PUT | 品目更新 |
-| `/api/bom/{parentCode}` | GET | BOM 展開（子品目一覧） |
-| `/api/mrp/execute` | POST | MRP 実行 |
-| `/api/orders` | GET | オーダ一覧取得 |
-| `/api/orders/{id}` | GET | オーダ詳細取得 |
-| `/api/work-orders` | GET | 作業指示一覧取得 |
-| `/api/stock/{locationCode}/{itemCode}` | GET | 在庫照会 |
-
----
-
-## まとめ
-
-本章では、生産管理システムの全体像について解説しました。
-
-1. **生産管理システムのスコープ**
-   - 生産計画（MPS・MRP）、購買管理、工程管理、在庫管理、品質管理、原価管理
-   - マスタ情報とトランザクション情報の分類
-
-2. **生産組織の役割分担**
-   - 営業部・生産管理部・製造部・購買部・外注部・資材倉庫・製品倉庫
-   - 各部門の責務と連携ポイント
-
-3. **生産管理システムのアーキテクチャ**
-   - ヘキサゴナルアーキテクチャ（ポート&アダプター）
-   - ドメイン駆動設計の適用
-   - RESTful API の設計方針
-
-次章では、品目マスタや BOM（部品構成表）などのマスタ情報の設計について詳しく解説します。
+# 第22章：生産管理システムの全体像
+
+本章から第4部「生産管理システム」の解説に入ります。まず、生産管理システムのスコープと、関連する組織の役割分担について解説します。
+
+---
+
+## 22.1 生産管理システムのスコープ
+
+生産管理システムは、製造業における「モノづくり」の全工程を管理するシステムです。販売管理システムからの受注情報を起点として、生産計画の立案から製品の完成、在庫管理に至るまでの一連の業務プロセスを管理します。
+
+### システム全体像
+
+```plantuml
+@startuml
+
+title 生産管理システムの全体像
+
+rectangle "販売管理" as sales
+rectangle "生産管理" as production {
+    rectangle "生産計画" as plan
+    rectangle "購買管理" as purchase
+    rectangle "製造管理" as manufacturing
+    rectangle "在庫管理" as inventory
+    rectangle "品質管理" as quality
+    rectangle "原価管理" as cost
+}
+rectangle "財務会計" as finance
+
+sales --> plan : 受注情報
+plan --> purchase : 購買オーダ
+plan --> manufacturing : 製造オーダ
+purchase --> inventory : 入荷
+manufacturing --> inventory : 完成品
+manufacturing --> quality : 検査依頼
+quality --> inventory : 合格品
+inventory --> sales : 出荷
+cost --> finance : 原価情報
+
+@enduml
+```
+
+### ユースケース図
+
+生産管理システム全体のユースケースは以下の通りです。
+
+```plantuml
+@startuml
+left to right direction
+skinparam packageStyle rectangle
+skinparam linetype ortho
+title 生産管理システム ユースケース図
+
+actor 営業担当者 as sales
+actor 生産管理担当者 as planner
+actor 購買担当者 as buyer
+actor 製造担当者 as worker
+actor 品質管理担当者 as qa
+actor 倉庫担当者 as warehouse
+
+rectangle 生産管理システム {
+    usecase "生産計画立案" as UC_PLAN
+    usecase "所要量展開(MRP)" as UC_MRP
+    usecase "発注管理" as UC_ORDER
+    usecase "入荷・検収管理" as UC_RECEIVE
+    usecase "製造指示" as UC_WORK
+    usecase "製造実績報告" as UC_RESULT
+    usecase "在庫管理" as UC_INVENTORY
+    usecase "品質管理" as UC_QUALITY
+    usecase "原価管理" as UC_COST
+}
+
+sales -- UC_PLAN
+planner -- UC_PLAN
+planner -- UC_MRP
+buyer -- UC_ORDER
+buyer -- UC_RECEIVE
+worker -- UC_WORK
+worker -- UC_RESULT
+warehouse -- UC_INVENTORY
+warehouse -- UC_RECEIVE
+qa -- UC_QUALITY
+qa -- UC_RECEIVE
+planner -- UC_COST
+@enduml
+```
+
+### 生産計画（MPS・MRP）
+
+生産計画は、販売計画や受注情報に基づいて、何をいつまでにどれだけ生産するかを決定する業務です。
+
+```plantuml
+@startuml
+
+state "生産計画業務" as Planning {
+    state "販売計画確認" as SalesPlan
+    state "MPS作成" as MPS
+    state "MRP実行" as MRP
+    state "計画調整" as Adjust
+    state "計画確定" as Confirm
+
+    [*] --> SalesPlan
+    SalesPlan --> MPS : 需要情報
+    MPS --> MRP : 基準生産計画
+    MRP --> Adjust : 所要量展開
+    Adjust --> Confirm : 調整完了
+    Adjust --> MRP : 再計算
+    Confirm --> [*]
+}
+
+@enduml
+```
+
+| 項目 | 説明 |
+|---|---|
+| MPS（基準生産計画） | 製品レベルの生産計画。何をいつまでにいくつ作るか |
+| MRP（所要量展開） | BOM を使って部品・材料レベルまで展開。必要数量と時期を算出 |
+| 主なデータ | オーダ情報、所要情報、引当情報 |
+
+### 購買管理（発注・入荷・検収）
+
+購買管理は、生産に必要な部品・材料を外部から調達する業務です。
+
+```plantuml
+@startuml
+
+state "購買管理業務" as Purchasing {
+    state "発注" as Order {
+        state "発注登録" as OrderCreate
+        state "発注確定" as OrderConfirm
+    }
+    state "入荷" as Receive {
+        state "入荷登録" as ReceiveCreate
+        state "受入検査" as Inspection
+    }
+    state "検収" as Accept {
+        state "検収登録" as AcceptCreate
+        state "在庫計上" as StockIn
+    }
+
+    [*] --> OrderCreate
+    OrderCreate --> OrderConfirm
+    OrderConfirm --> ReceiveCreate : 入荷
+    ReceiveCreate --> Inspection
+    Inspection --> AcceptCreate : 合格
+    Inspection --> ReceiveCreate : 不合格（返品）
+    AcceptCreate --> StockIn
+    StockIn --> [*]
+}
+
+@enduml
+```
+
+| 項目 | 説明 |
+|---|---|
+| 目的 | 生産に必要な部品・材料を適切なタイミングで調達 |
+| 入力 | MRP からの購買オーダ、発注依頼 |
+| 出力 | 発注書、入荷伝票、検収伝票 |
+| 主なデータ | 発注データ、入荷受入データ、検収データ |
+
+### 工程管理（製造指示・製造実績）
+
+工程管理は、製造オーダに基づいて製造作業を指示し、実績を収集する業務です。
+
+```plantuml
+@startuml
+
+state "工程管理業務" as Process {
+    state "製造指示" as Instruction {
+        state "作業指示作成" as WorkOrder
+        state "ピッキング" as Picking
+    }
+    state "製造作業" as Work {
+        state "工程作業" as Operation
+        state "工程検査" as ProcessInspection
+    }
+    state "製造実績" as Result {
+        state "完成報告" as Complete
+        state "工数報告" as LaborReport
+    }
+
+    [*] --> WorkOrder
+    WorkOrder --> Picking
+    Picking --> Operation
+    Operation --> ProcessInspection
+    ProcessInspection --> Operation : 不合格
+    ProcessInspection --> Complete : 合格
+    Complete --> LaborReport
+    LaborReport --> [*]
+}
+
+@enduml
+```
+
+| 項目 | 説明 |
+|---|---|
+| 目的 | 製造オーダを効率的に実行し、実績を正確に記録 |
+| 入力 | 製造オーダ、工程表、BOM |
+| 出力 | 作業指示書、ピッキングリスト、完成報告書 |
+| 主なデータ | 作業指示データ、完成実績データ、工数実績データ |
+
+### 在庫管理（受払・在庫状態）
+
+在庫管理は、部品・材料・製品の在庫数量と状態を管理する業務です。
+
+```plantuml
+@startuml
+
+state "在庫管理業務" as Inventory {
+    state "入庫" as StockIn
+    state "出庫" as StockOut
+    state "在庫照会" as Query
+    state "棚卸" as Count
+
+    [*] --> StockIn : 入荷・完成
+    [*] --> StockOut : 払出・出荷
+    [*] --> Query : 参照
+    [*] --> Count : 定期棚卸
+
+    StockIn --> [*]
+    StockOut --> [*]
+    Query --> [*]
+    Count --> [*]
+}
+
+@enduml
+```
+
+| 項目 | 説明 |
+|---|---|
+| 目的 | 在庫の正確な把握と適正在庫の維持 |
+| 主な機能 | 在庫照会、受払管理、棚卸、在庫調整 |
+| 主なデータ | 在庫データ、払出データ、棚卸データ |
+
+### 品質管理（受入検査・出荷検査・トレーサビリティ）
+
+品質管理は、製品の品質を確保するための検査と履歴管理を行う業務です。
+
+| 検査種別 | タイミング | 目的 |
+|---|---|---|
+| 受入検査 | 入荷時 | 購入品の品質確認 |
+| 工程検査 | 製造中 | 工程ごとの品質確認 |
+| 出荷検査 | 出荷前 | 最終製品の品質確認 |
+
+### 製造原価管理（標準原価・実際原価・配賦）
+
+製造原価管理は、製品の製造にかかったコストを計算・管理する業務です。
+
+| 原価要素 | 説明 |
+|---|---|
+| 材料費 | 直接材料費、間接材料費 |
+| 労務費 | 直接労務費、間接労務費 |
+| 製造間接費 | 減価償却費、光熱費、間接労務費等 |
+
+### マスタ情報とトランザクション情報
+
+生産管理システムのデータは、大きく「マスタ情報」と「トランザクション情報」に分類されます。
+
+| 分類 | 説明 | 例 |
+|-----|------|-----|
+| **マスタ情報** | 基本的に変更が少ない、システムの基盤となるデータ | 品目マスタ、BOM、取引先マスタ、工程マスタ |
+| **トランザクション情報** | 日々の業務で発生するデータ | 発注データ、製造実績、在庫移動 |
+
+---
+
+## 22.2 生産組織の役割分担
+
+生産管理システムに関わる組織は複数あり、それぞれが異なる役割を担っています。
+
+### 組織構成
+
+```plantuml
+@startuml
+
+package "生産管理に関わる組織" {
+    rectangle "営業部" as Sales #LightBlue {
+        Sales : ・受注情報の連携
+        Sales : ・納期調整
+        Sales : ・出荷指示
+    }
+
+    rectangle "生産管理部" as ProdMgmt #LightGreen {
+        ProdMgmt : ・生産計画立案
+        ProdMgmt : ・MRP 実行
+        ProdMgmt : ・進捗管理
+        ProdMgmt : ・原価管理
+    }
+
+    rectangle "製造部" as Manufacturing #LightYellow {
+        Manufacturing : ・製造作業
+        Manufacturing : ・完成報告
+        Manufacturing : ・工数報告
+    }
+
+    rectangle "購買部" as Purchasing #LightPink {
+        Purchasing : ・発注管理
+        Purchasing : ・納期管理
+        Purchasing : ・仕入先管理
+    }
+
+    rectangle "外注部" as Outsource #LightCoral {
+        Outsource : ・外注発注
+        Outsource : ・支給品管理
+        Outsource : ・外注進捗管理
+    }
+
+    rectangle "資材倉庫" as MaterialWH #Lavender {
+        MaterialWH : ・入荷受入
+        MaterialWH : ・部材払出
+        MaterialWH : ・在庫管理
+    }
+
+    rectangle "製品倉庫" as ProductWH #LightCyan {
+        ProductWH : ・完成品入庫
+        ProductWH : ・出荷作業
+        ProductWH : ・在庫管理
+    }
+}
+
+@enduml
+```
+
+### 営業部
+
+営業部は、得意先との接点を持ち、受注情報を生産管理に連携します。
+
+| 業務 | 責務 | 主な操作 |
+|---|---|---|
+| 受注連携 | 受注情報の生産計画への連携 | 受注データ登録 |
+| 納期調整 | 生産計画に基づく納期回答 | 納期回答、納期変更 |
+| 出荷指示 | 製品倉庫への出荷依頼 | 出荷指示登録 |
+
+### 生産管理部
+
+生産管理部は、生産計画の立案から進捗管理、原価管理までを担当します。
+
+| 業務 | 責務 | 主な操作 |
+|---|---|---|
+| 生産計画 | MPS・MRP の立案と調整 | 計画登録、所要量展開 |
+| 進捗管理 | 製造進捗の監視と対応 | 進捗照会、遅延アラート |
+| 原価管理 | 製造原価の計算と分析 | 原価計算、差異分析 |
+
+### 製造部
+
+製造部は、実際の製造作業を担当します。
+
+| 業務 | 責務 | 主な操作 |
+|---|---|---|
+| 製造作業 | 作業指示に基づく製造 | 作業実施 |
+| 完成報告 | 完成数量の報告 | 完成実績登録 |
+| 工数報告 | 作業時間の報告 | 工数実績登録 |
+
+### 購買部
+
+購買部は、部品・材料の外部調達を担当します。
+
+| 業務 | 責務 | 主な操作 |
+|---|---|---|
+| 発注 | 仕入先への発注 | 発注登録、注文書発行 |
+| 納期管理 | 入荷予定の管理 | 納期確認、督促 |
+| 仕入先管理 | 仕入先情報の管理 | 仕入先評価 |
+
+### 外注部
+
+外注部は、外注加工の管理を担当します。
+
+| 業務 | 責務 | 主な操作 |
+|---|---|---|
+| 外注発注 | 外注先への加工依頼 | 外注発注登録 |
+| 支給品管理 | 外注先への支給品管理 | 支給登録、消費確認 |
+| 進捗管理 | 外注作業の進捗管理 | 進捗確認、督促 |
+
+### 資材倉庫
+
+資材倉庫は、部品・材料の物理的な管理を担当します。
+
+| 業務 | 責務 | 主な操作 |
+|---|---|---|
+| 入荷受入 | 購入品の受入と検品 | 入荷登録、検品 |
+| 部材払出 | 製造への部材供給 | 払出登録、ピッキング |
+| 在庫管理 | 在庫数量の管理 | 棚卸、在庫調整 |
+
+### 製品倉庫
+
+製品倉庫は、完成品の物理的な管理を担当します。
+
+| 業務 | 責務 | 主な操作 |
+|---|---|---|
+| 完成品入庫 | 製造からの完成品受入 | 入庫登録 |
+| 出荷作業 | 得意先への出荷 | 出荷登録、配送手配 |
+| 在庫管理 | 製品在庫の管理 | 棚卸、在庫調整 |
+
+### 業務フローと各部門の責務
+
+各部門がどのタイミングで業務に関与するかを、全体フローで示します。
+
+```plantuml
+@startuml
+title 生産管理システムの全体フロー
+
+|営業部|
+start
+:受注情報;
+
+|生産管理部|
+:生産計画立案;
+:MRP実行;
+fork
+:購買オーダ;
+fork again
+:製造オーダ;
+fork end
+
+|購買部|
+:発注登録;
+
+|システム|
+:発注データ;
+:注文書;
+
+|資材倉庫|
+:入荷受入;
+:受入検査;
+
+|購買部|
+:検収登録;
+
+|システム|
+fork
+:検収データ;
+fork again
+:在庫データ（入庫）;
+fork end
+
+|生産管理部|
+:作業指示作成;
+
+|システム|
+:作業指示データ;
+:作業指示書;
+:ピッキングリスト;
+
+|資材倉庫|
+:部材払出;
+
+|製造部|
+:製造作業;
+:完成報告;
+:工数報告;
+
+|システム|
+fork
+:完成実績データ;
+fork again
+:工数実績データ;
+fork again
+:在庫データ（完成品入庫）;
+fork end
+
+|製品倉庫|
+:完成品入庫;
+
+|営業部|
+:出荷指示;
+
+|製品倉庫|
+:出荷作業;
+
+|システム|
+:出荷データ;
+
+stop
+
+@enduml
+```
+
+### 部門間の連携ポイント
+
+```plantuml
+@startuml
+
+rectangle "営業部" as Sales
+rectangle "生産管理部" as ProdMgmt
+rectangle "製造部" as Manufacturing
+rectangle "購買部" as Purchasing
+rectangle "外注部" as Outsource
+rectangle "資材倉庫" as MaterialWH
+rectangle "製品倉庫" as ProductWH
+
+Sales --> ProdMgmt : 受注情報
+ProdMgmt --> Purchasing : 購買オーダ
+ProdMgmt --> Manufacturing : 製造オーダ
+ProdMgmt --> Outsource : 外注オーダ
+
+Purchasing --> MaterialWH : 入荷予定
+Outsource --> MaterialWH : 支給指示
+
+MaterialWH --> Manufacturing : 部材供給
+Manufacturing --> ProductWH : 完成品
+
+ProductWH --> Sales : 出荷可能報告
+
+Manufacturing --> ProdMgmt : 進捗報告
+Outsource --> ProdMgmt : 外注進捗
+
+@enduml
+```
+
+| 連携元 | 連携先 | 連携内容 |
+|---|---|---|
+| 営業部 | 生産管理部 | 受注情報、納期要望 |
+| 生産管理部 | 購買部 | 購買オーダ |
+| 生産管理部 | 製造部 | 製造オーダ、作業指示 |
+| 生産管理部 | 外注部 | 外注オーダ |
+| 購買部 | 資材倉庫 | 入荷予定情報 |
+| 外注部 | 資材倉庫 | 支給指示 |
+| 資材倉庫 | 製造部 | 部材供給 |
+| 製造部 | 製品倉庫 | 完成品 |
+| 製造部 | 生産管理部 | 進捗報告 |
+| 製品倉庫 | 営業部 | 出荷可能報告 |
+
+---
+
+## 22.3 生産管理システムのアーキテクチャ
+
+本節では、生産管理システム（PMS: Production Management System）のプロジェクト構成とアーキテクチャについて解説します。
+
+### プロジェクト構成
+
+生産管理システムは `apps/pms` ディレクトリ以下に構築します。
+
+```
+apps/pms/
+├── backend/
+│   ├── build.gradle.kts               # Gradle ビルド設定（Kotlin DSL）
+│   ├── settings.gradle.kts            # Gradle 設定
+│   ├── config/                        # 品質管理ツール設定
+│   │   ├── checkstyle/
+│   │   │   └── checkstyle.xml
+│   │   ├── pmd/
+│   │   │   └── ruleset.xml
+│   │   └── spotbugs/
+│   │       └── exclude.xml
+│   │
+│   └── src/
+│       ├── main/
+│       │   ├── java/com/example/pms/
+│       │   │   │
+│       │   │   ├── domain/            # ドメイン層（純粋なビジネスロジック）
+│       │   │   │   ├── model/         # ドメインモデル（エンティティ、値オブジェクト）
+│       │   │   │   │   ├── master/    # マスタ関連
+│       │   │   │   │   └── transaction/ # トランザクション関連
+│       │   │   │   ├── type/          # 基本型（通貨、単位、数量等）
+│       │   │   │   └── exception/     # ドメイン例外
+│       │   │   │
+│       │   │   ├── application/       # アプリケーション層
+│       │   │   │   ├── port/
+│       │   │   │   │   ├── in/        # Input Port（ユースケースIF）
+│       │   │   │   │   └── out/       # Output Port（リポジトリIF）
+│       │   │   │   └── service/       # Application Service（ユースケース実装）
+│       │   │   │
+│       │   │   ├── infrastructure/    # インフラストラクチャ層
+│       │   │   │   ├── in/            # Input Adapter
+│       │   │   │   │   └── rest/      # REST API Controller
+│       │   │   │   ├── out/           # Output Adapter
+│       │   │   │   │   └── persistence/ # 永続化（MyBatis Mapper）
+│       │   │   │   └── config/        # 設定クラス
+│       │   │   │
+│       │   │   └── Application.java   # メインクラス
+│       │   │
+│       │   └── resources/
+│       │       ├── application.yml    # アプリケーション設定
+│       │       ├── db/migration/      # Flyway マイグレーション
+│       │       └── mapper/            # MyBatis XML マッパー
+│       │
+│       └── test/
+│           ├── java/com/example/pms/
+│           │   ├── testsetup/         # テスト基盤クラス
+│           │   │   └── BaseIntegrationTest.java
+│           │   ├── domain/            # ドメイン層テスト
+│           │   ├── application/       # アプリケーション層テスト
+│           │   └── infrastructure/    # インフラ層テスト
+│           │
+│           └── resources/
+│               └── application-test.yml
+│
+└── docker-compose.yml                 # Docker 構成
+```
+
+**各レイヤーの責務：**
+
+| レイヤー | 責務 |
+|---|---|
+| Domain 層 | ビジネスルールとドメインモデル（外部技術に非依存） |
+| Application 層 | ユースケースの実装とオーケストレーション |
+| Infrastructure 層 | 外部技術との接続（DB、Web 等） |
+
+### ヘキサゴナルアーキテクチャ（ポート&アダプター）
+
+生産管理システムは、ヘキサゴナルアーキテクチャ（Ports and Adapters）を採用します。このアーキテクチャにより、ビジネスロジックを外部の技術的関心事から分離し、テスト容易性と保守性を高めます。
+
+```plantuml
+@startuml
+!define HEXAGON(name) hexagon name
+
+skinparam hexagon {
+    BackgroundColor<<domain>> LightBlue
+    BackgroundColor<<port>> LightGreen
+    BackgroundColor<<adapter>> LightYellow
+}
+
+package "生産管理システム" {
+    ' ドメイン（中心）
+    hexagon "ドメイン\n(Domain)" <<domain>> as Domain {
+    }
+    note bottom of Domain
+        エンティティ
+        値オブジェクト
+        集約
+        ドメインサービス
+    end note
+
+    ' 入力ポート
+    rectangle "入力ポート\n(Input Ports)" <<port>> as InputPort {
+    }
+    note left of InputPort
+        ユースケース
+        インターフェース
+    end note
+
+    ' 出力ポート
+    rectangle "出力ポート\n(Output Ports)" <<port>> as OutputPort {
+    }
+    note right of OutputPort
+        リポジトリ
+        インターフェース
+    end note
+
+    ' プライマリアダプター
+    rectangle "プライマリアダプター\n(Primary Adapters)" <<adapter>> as PrimaryAdapter {
+    }
+    note top of PrimaryAdapter
+        REST API
+        GraphQL
+        CLI
+    end note
+
+    ' セカンダリアダプター
+    rectangle "セカンダリアダプター\n(Secondary Adapters)" <<adapter>> as SecondaryAdapter {
+    }
+    note bottom of SecondaryAdapter
+        PostgreSQL
+        Redis
+        外部 API
+    end note
+}
+
+PrimaryAdapter --> InputPort
+InputPort --> Domain
+Domain --> OutputPort
+OutputPort --> SecondaryAdapter
+
+@enduml
+```
+
+#### ドメイン（中心）
+
+ドメインはシステムの中心に位置し、ビジネスロジックを実装します。
+
+```
+domain/
+├── model/                       # ドメインモデル
+│   ├── master/                  # マスタ関連
+│   │   ├── Item.java            # 品目
+│   │   ├── Bom.java             # 部品構成表
+│   │   ├── WorkCalendar.java    # カレンダ
+│   │   ├── Location.java        # 場所
+│   │   └── Supplier.java        # 取引先
+│   ├── planning/                # 計画関連
+│   │   ├── ProductionPlan.java  # 生産計画
+│   │   ├── Order.java           # オーダ
+│   │   └── Requirement.java     # 所要
+│   ├── purchasing/              # 購買関連
+│   │   ├── PurchaseOrder.java   # 発注
+│   │   ├── Receiving.java       # 入荷受入
+│   │   └── Acceptance.java      # 検収
+│   ├── manufacturing/           # 製造関連
+│   │   ├── WorkOrder.java       # 作業指示
+│   │   ├── Completion.java      # 完成実績
+│   │   └── LaborReport.java     # 工数実績
+│   └── inventory/               # 在庫関連
+│       ├── Stock.java           # 在庫
+│       └── Issue.java           # 払出
+├── type/                        # 基本型
+│   ├── Money.java               # 通貨
+│   ├── Quantity.java            # 数量
+│   └── ItemCode.java            # 品目コード
+└── exception/                   # ドメイン例外
+    └── DomainException.java
+```
+
+#### ポート（入力ポート・出力ポート）
+
+ポートは、ドメインと外部世界との境界を定義するインターフェースです。
+
+| ポート種別 | 役割 | 例 |
+|---|---|---|
+| 入力ポート | 外部からの要求を受け付ける | ユースケースインターフェース |
+| 出力ポート | 外部リソースへのアクセスを抽象化 | リポジトリインターフェース |
+
+```java
+// 入力ポート（ユースケースインターフェース）
+public interface ExecuteMrpUseCase {
+    MrpResult execute(MrpCommand command);
+}
+
+// 出力ポート（リポジトリインターフェース）
+public interface ItemRepository {
+    void save(Item item);
+    Optional<Item> findByCode(ItemCode code);
+    List<Item> findAll();
+}
+```
+
+#### アダプター（プライマリ・セカンダリ）
+
+アダプターは、ポートの実装を提供し、外部技術とドメインを接続します。
+
+| アダプター種別 | 役割 | 例 |
+|---|---|---|
+| プライマリアダプター | 外部からの入力を処理 | REST コントローラ、CLI |
+| セカンダリアダプター | 外部リソースへの出力を処理 | DB リポジトリ実装、外部 API クライアント |
+
+```
+infrastructure/
+├── in/                          # Input Adapter（プライマリアダプター）
+│   └── rest/                    # REST API
+│       ├── controller/
+│       │   ├── ItemController.java
+│       │   ├── BomController.java
+│       │   └── MrpController.java
+│       ├── dto/
+│       │   ├── ItemRequest.java
+│       │   └── ItemResponse.java
+│       └── exception/
+│           └── RestExceptionHandler.java
+├── out/                         # Output Adapter（セカンダリアダプター）
+│   └── persistence/             # 永続化
+│       ├── mapper/              # MyBatis Mapper
+│       │   └── ItemMapper.java
+│       ├── repository/          # Repository実装
+│       │   └── ItemRepositoryImpl.java
+│       └── typehandler/         # 型ハンドラ
+│           └── ItemTypeEnumHandler.java
+└── config/                      # 設定クラス
+    ├── DatabaseConfig.java
+    └── WebConfig.java
+```
+
+#### 依存性の方向と依存性逆転の原則
+
+ヘキサゴナルアーキテクチャでは、すべての依存性がドメインに向かいます。
+
+```plantuml
+@startuml
+skinparam rectangle {
+    BackgroundColor<<domain>> LightBlue
+    BackgroundColor<<app>> LightGreen
+    BackgroundColor<<infra>> LightYellow
+    BackgroundColor<<pres>> LightPink
+}
+
+rectangle "Presentation\n(プレゼンテーション層)" <<pres>> as Pres
+rectangle "Application\n(アプリケーション層)" <<app>> as App
+rectangle "Domain\n(ドメイン層)" <<domain>> as Domain
+rectangle "Infrastructure\n(インフラストラクチャ層)" <<infra>> as Infra
+
+Pres --> App
+App --> Domain
+Infra --> Domain
+
+note right of Domain
+    依存性逆転の原則（DIP）
+    ・ドメインはインターフェースを定義
+    ・インフラは実装を提供
+    ・依存の方向は常にドメインへ
+end note
+
+@enduml
+```
+
+### ドメイン駆動設計の適用
+
+#### 集約とリポジトリ
+
+生産管理システムの主要な集約を以下に示します。
+
+```plantuml
+@startuml
+!define AGGREGATE(name) rectangle name <<aggregate>>
+!define ENTITY(name) class name <<entity>>
+!define VALUE(name) class name <<value>>
+
+skinparam class {
+    BackgroundColor<<aggregate>> LightBlue
+    BackgroundColor<<entity>> LightGreen
+    BackgroundColor<<value>> LightYellow
+}
+
+package "品目集約" {
+    ENTITY(Item) {
+        +itemCode: ItemCode
+        +itemName: String
+        +itemType: ItemType
+        +unitCode: String
+        +leadTime: Integer
+    }
+
+    VALUE(ItemCode) {
+        +value: String
+    }
+
+    VALUE(ItemType) {
+        +value: String
+    }
+
+    Item --> ItemCode
+    Item --> ItemType
+}
+
+package "BOM集約" {
+    ENTITY(Bom) {
+        +parentItemCode: ItemCode
+        +childItemCode: ItemCode
+        +requiredQuantity: Quantity
+        +effectiveFrom: LocalDate
+        +effectiveTo: LocalDate
+    }
+
+    VALUE(Quantity) {
+        +value: BigDecimal
+    }
+
+    Bom --> Quantity
+}
+
+@enduml
+```
+
+| 集約 | ルートエンティティ | 主な責務 |
+|---|---|---|
+| 品目集約 | Item | 品目情報の管理 |
+| BOM 集約 | Bom | 部品構成の管理 |
+| オーダ集約 | Order | 生産・購買オーダの管理 |
+| 作業指示集約 | WorkOrder | 製造指示の管理 |
+| 在庫集約 | Stock | 在庫数量の管理 |
+
+#### ドメインサービス
+
+複数の集約をまたぐビジネスロジックは、ドメインサービスとして実装します。
+
+```java
+// MRP ドメインサービス
+public class MrpDomainService {
+
+    public List<Requirement> explodeRequirements(
+            Item item,
+            Quantity requiredQty,
+            LocalDate requiredDate,
+            BomRepository bomRepository) {
+
+        List<Bom> children = bomRepository.findChildren(item.getItemCode());
+
+        return children.stream()
+            .map(bom -> new Requirement(
+                bom.getChildItemCode(),
+                requiredQty.multiply(bom.getRequiredQuantity()),
+                requiredDate.minusDays(item.getLeadTime())
+            ))
+            .collect(Collectors.toList());
+    }
+}
+```
+
+#### アプリケーションサービス
+
+ユースケースの実装は、アプリケーションサービスとして実装します。
+
+```java
+@Service
+@RequiredArgsConstructor
+public class MrpApplicationService implements ExecuteMrpUseCase {
+
+    private final ItemRepository itemRepository;
+    private final BomRepository bomRepository;
+    private final OrderRepository orderRepository;
+    private final MrpDomainService mrpDomainService;
+
+    @Override
+    @Transactional
+    public MrpResult execute(MrpCommand command) {
+        // 1. 対象品目の取得
+        Item item = itemRepository.findByCode(command.getItemCode())
+            .orElseThrow(() -> new ItemNotFoundException(command.getItemCode()));
+
+        // 2. 所要量展開
+        List<Requirement> requirements = mrpDomainService.explodeRequirements(
+            item, command.getQuantity(), command.getRequiredDate(), bomRepository);
+
+        // 3. オーダ生成
+        List<Order> orders = requirements.stream()
+            .map(this::createOrder)
+            .collect(Collectors.toList());
+
+        orders.forEach(orderRepository::save);
+
+        return new MrpResult(orders);
+    }
+}
+```
+
+### API 設計
+
+#### RESTful API の基本方針
+
+| 方針 | 説明 |
+|---|---|
+| リソース指向 | URL はリソースを表現（動詞ではなく名詞） |
+| HTTP メソッド | GET（取得）、POST（作成）、PUT（更新）、DELETE（削除） |
+| ステータスコード | 200（成功）、201（作成）、400（クライアントエラー）、404（未検出）、500（サーバーエラー） |
+
+#### エンドポイント設計
+
+| エンドポイント | メソッド | 説明 |
+|---|---|---|
+| `/api/items` | GET | 品目一覧取得 |
+| `/api/items/{code}` | GET | 品目詳細取得 |
+| `/api/items` | POST | 品目登録 |
+| `/api/items/{code}` | PUT | 品目更新 |
+| `/api/bom/{parentCode}` | GET | BOM 展開（子品目一覧） |
+| `/api/mrp/execute` | POST | MRP 実行 |
+| `/api/orders` | GET | オーダ一覧取得 |
+| `/api/orders/{id}` | GET | オーダ詳細取得 |
+| `/api/work-orders` | GET | 作業指示一覧取得 |
+| `/api/stock/{locationCode}/{itemCode}` | GET | 在庫照会 |
+
+---
+
+## まとめ
+
+本章では、生産管理システムの全体像について解説しました。
+
+1. **生産管理システムのスコープ**
+   - 生産計画（MPS・MRP）、購買管理、工程管理、在庫管理、品質管理、原価管理
+   - マスタ情報とトランザクション情報の分類
+
+2. **生産組織の役割分担**
+   - 営業部・生産管理部・製造部・購買部・外注部・資材倉庫・製品倉庫
+   - 各部門の責務と連携ポイント
+
+3. **生産管理システムのアーキテクチャ**
+   - ヘキサゴナルアーキテクチャ（ポート&アダプター）
+   - ドメイン駆動設計の適用
+   - RESTful API の設計方針
+
+次章では、品目マスタや BOM（部品構成表）などのマスタ情報の設計について詳しく解説します。