npm - @k2works/claude-code-booster - Versions diffs - 4.13.0 → 4.14.0 - Mend

@k2works/claude-code-booster 4.13.0 → 4.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (751) hide show

package/lib/assets/docs/article/practical-database-design/part4/chapter23.md CHANGED Viewed

@@ -1,2069 +1,2069 @@
-# 第23章：マスタ情報の設計
-本章では、生産管理システムの基盤となるマスタ情報を設計します。ヘキサゴナルアーキテクチャ（ポート＆アダプターパターン）を採用し、ドメイン層がインフラストラクチャ層に依存しない設計とします。
-## アーキテクチャの概要
-```plantuml
-@startuml
-title ヘキサゴナルアーキテクチャ
-package "Application Layer" {
-  package "port/out" {
-    interface UnitRepository
-    interface ItemRepository
-    interface BomRepository
-    interface WorkCalendarRepository
-    interface LocationRepository
-    interface SupplierRepository
-    interface DepartmentRepository
-    interface StaffRepository
-    interface ProcessRepository
-    interface ProcessRouteRepository
-    interface UnitPriceRepository
-    interface DefectRepository
-  }
-}
-package "Domain Layer" {
-  package "model" {
-    class Unit
-    class Item
-    class ItemCategory
-    class Bom
-    class BomExplosion
-    class WorkCalendar
-    class DateType
-    class Location
-    class LocationType
-    class Supplier
-    class SupplierType
-    class Department
-    class Staff
-    class Process
-    class ProcessRoute
-    class UnitPrice
-    class Defect
-  }
-}
-package "Infrastructure Layer" {
-  package "out/persistence" {
-    package "mapper" {
-      interface UnitMapper
-      interface ItemMapper
-      interface BomMapper
-      interface WorkCalendarMapper
-      interface LocationMapper
-      interface SupplierMapper
-      interface DepartmentMapper
-      interface StaffMapper
-      interface ProcessMapper
-      interface ProcessRouteMapper
-      interface UnitPriceMapper
-      interface DefectMapper
-    }
-    package "repository" {
-      class UnitRepositoryImpl
-      class ItemRepositoryImpl
-      class BomRepositoryImpl
-      class WorkCalendarRepositoryImpl
-      class LocationRepositoryImpl
-      class SupplierRepositoryImpl
-      class DepartmentRepositoryImpl
-      class StaffRepositoryImpl
-      class ProcessRepositoryImpl
-      class ProcessRouteRepositoryImpl
-      class UnitPriceRepositoryImpl
-      class DefectRepositoryImpl
-    }
-    package "typehandler" {
-      class ItemCategoryTypeHandler
-      class DateTypeTypeHandler
-      class LocationTypeTypeHandler
-      class SupplierTypeTypeHandler
-    }
-  }
-}
-ItemRepository <|.. ItemRepositoryImpl
-ItemRepositoryImpl --> ItemMapper
-ItemRepositoryImpl --> Item
-@enduml
-```
-### パッケージ構成
-```
-src/main/java/com/example/pms/
-├── application/                    # アプリケーション層
-│   └── port/
-│       └── out/                   # Output Port（リポジトリインターフェース）
-│           ├── UnitRepository.java
-│           ├── ItemRepository.java
-│           ├── BomRepository.java
-│           ├── WorkCalendarRepository.java
-│           ├── LocationRepository.java
-│           ├── SupplierRepository.java
-│           ├── DepartmentRepository.java
-│           ├── StaffRepository.java
-│           ├── ProcessRepository.java
-│           ├── ProcessRouteRepository.java
-│           ├── UnitPriceRepository.java
-│           └── DefectRepository.java
-├── domain/                         # ドメイン層（純粋なビジネスロジック）
-│   └── model/                     # ドメインモデル
-│       ├── unit/
-│       │   └── Unit.java
-│       ├── item/
-│       │   ├── Item.java
-│       │   └── ItemCategory.java
-│       ├── bom/
-│       │   ├── Bom.java
-│       │   └── BomExplosion.java
-│       ├── calendar/
-│       │   ├── WorkCalendar.java
-│       │   └── DateType.java
-│       ├── location/
-│       │   ├── Location.java
-│       │   └── LocationType.java
-│       ├── supplier/
-│       │   ├── Supplier.java
-│       │   └── SupplierType.java
-│       ├── department/
-│       │   └── Department.java
-│       ├── staff/
-│       │   └── Staff.java
-│       ├── process/
-│       │   ├── Process.java
-│       │   └── ProcessRoute.java
-│       ├── unitprice/
-│       │   └── UnitPrice.java
-│       └── defect/
-│           └── Defect.java
-├── infrastructure/                 # インフラストラクチャ層
-│   └── out/
-│       └── persistence/
-│           ├── mapper/            # MyBatis Mapper
-│           │   ├── UnitMapper.java
-│           │   ├── ItemMapper.java
-│           │   ├── BomMapper.java
-│           │   ├── WorkCalendarMapper.java
-│           │   ├── LocationMapper.java
-│           │   ├── SupplierMapper.java
-│           │   ├── DepartmentMapper.java
-│           │   ├── StaffMapper.java
-│           │   ├── ProcessMapper.java
-│           │   ├── ProcessRouteMapper.java
-│           │   ├── UnitPriceMapper.java
-│           │   └── DefectMapper.java
-│           ├── repository/        # Repository実装
-│           │   ├── UnitRepositoryImpl.java
-│           │   ├── ItemRepositoryImpl.java
-│           │   ├── BomRepositoryImpl.java
-│           │   ├── WorkCalendarRepositoryImpl.java
-│           │   ├── LocationRepositoryImpl.java
-│           │   ├── SupplierRepositoryImpl.java
-│           │   ├── DepartmentRepositoryImpl.java
-│           │   ├── StaffRepositoryImpl.java
-│           │   ├── ProcessRepositoryImpl.java
-│           │   ├── ProcessRouteRepositoryImpl.java
-│           │   ├── UnitPriceRepositoryImpl.java
-│           │   └── DefectRepositoryImpl.java
-│           └── typehandler/       # TypeHandler
-│               ├── ItemCategoryTypeHandler.java
-│               ├── DateTypeTypeHandler.java
-│               ├── LocationTypeTypeHandler.java
-│               └── SupplierTypeTypeHandler.java
-└── config/
-    └── FlywayConfig.java
-```
----
-## 23.1 品目マスタの設計
-品目マスタは、生産管理システムで扱う「モノ」（製品、部品、材料など）の情報を管理する、最も基本的なマスタです。
-### 品目とは
-生産管理における「品目」とは、管理対象となるすべての「モノ」を指します。
-| 品目区分 | 説明 | 例 |
-|---------|------|-----|
-| **製品** | 最終的に販売する完成品 | パソコン、スマートフォン |
-| **半製品** | 途中まで完成した製品 | 組立済みの基板 |
-| **中間品** | 製造工程の中間生成物 | 加工済み部品 |
-| **部品** | 製品を構成する部品 | ネジ、コネクタ |
-| **材料** | 加工に使用する材料 | 鋼材、プラスチック |
-| **原料** | 化学反応などの元となる原料 | 化学薬品 |
-| **資材** | 製造を支援する資材 | 梱包材、ラベル |
-### 品目マスタに必要な情報
-```plantuml
-@startuml
-title 品目マスタおよび関連マスタ
-entity 品目マスタ {
-  品目コード
-  適用開始日
-  --
-  適用停止日
-  品名
-  品目区分 <<FK>>
-  品目グループコード <<FK>>
-  単位コード <<FK>>
-  場所コード <<FK>>
-  リードタイム
-  安全リードタイム
-  安全在庫数
-  歩留率
-  最小ロット数
-  刻みロット数
-  最大ロット数
-  有効期間
-}
-entity 品目区分マスタ {
-  品目区分
-  --
-  品目区分名
-}
-note left of 品目区分マスタ
-製品
-半製品
-中間品
-部品
-材料
-原料
-資材など
-end note
-entity 品目グループマスタ {
-  品目グループコード
-  --
-  品目グループ名
-}
-entity 単位マスタ {
-  単位コード
-  --
-  単位記号
-  単位名
-}
-品目区分マスタ |o--{ 品目マスタ
-品目グループマスタ |o--{ 品目マスタ
-単位マスタ |o-{ 品目マスタ
-@enduml
-```
-### テーブル定義
-<details>
-<summary>DDL（品目マスタ・単位マスタ）</summary>
-```sql
--- src/main/resources/db/migration/V002__create_item_master.sql
--- 品目区分 ENUM（日本語値）
-CREATE TYPE 品目区分 AS ENUM (
-    '製品', '半製品', '中間品', '部品', '材料', '原料', '資材'
-);
--- 単位マスタ（日本語テーブル名・カラム名）
-CREATE TABLE "単位マスタ" (
-    "単位コード" VARCHAR(10) PRIMARY KEY,
-    "単位記号" VARCHAR(10) NOT NULL,
-    "単位名" VARCHAR(50) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-);
--- 品目マスタ（日本語テーブル名・カラム名）
-CREATE TABLE "品目マスタ" (
-    "ID" SERIAL PRIMARY KEY,
-    "品目コード" VARCHAR(20) NOT NULL,
-    "適用開始日" DATE NOT NULL,
-    "適用停止日" DATE,
-    "品名" VARCHAR(100) NOT NULL,
-    "品目区分" 品目区分 NOT NULL,
-    "単位コード" VARCHAR(10) REFERENCES "単位マスタ"("単位コード"),
-    "リードタイム" INTEGER DEFAULT 0,
-    "安全リードタイム" INTEGER DEFAULT 0,
-    "安全在庫数" DECIMAL(15, 2) DEFAULT 0,
-    "歩留率" DECIMAL(5, 2) DEFAULT 100,
-    "最小ロット数" DECIMAL(15, 2) DEFAULT 1,
-    "刻みロット数" DECIMAL(15, 2) DEFAULT 1,
-    "最大ロット数" DECIMAL(15, 2),
-    "有効期間" INTEGER,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    UNIQUE("品目コード", "適用開始日")
-);
--- インデックス
-CREATE INDEX idx_品目マスタ_品目コード ON "品目マスタ"("品目コード");
-CREATE INDEX idx_品目マスタ_品目区分 ON "品目マスタ"("品目区分");
-```
-</details>
-### 世代管理
-品目マスタは `品目コード` と `適用開始日` の複合キーによる世代管理を採用しています。これにより：
-- 同じ品目コードでも、適用開始日が異なれば別レコードとして登録可能
-- 過去・現在・未来の品目情報を保持できる
-- 特定時点での品目情報を参照できる
-### ドメインモデル
-<details>
-<summary>品目エンティティ（Item.java）</summary>
-```java
-// src/main/java/com/example/production/domain/model/item/Item.java
-package com.example.pms.domain.model.item;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Item {
-    private Integer id;
-    private String itemCode;
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    private String itemName;
-    private ItemCategory itemCategory;
-    private String unitCode;
-    @Builder.Default
-    private Integer leadTime = 0;
-    @Builder.Default
-    private Integer safetyLeadTime = 0;
-    @Builder.Default
-    private BigDecimal safetyStock = BigDecimal.ZERO;
-    @Builder.Default
-    private BigDecimal yieldRate = new BigDecimal("100");
-    @Builder.Default
-    private BigDecimal minLotSize = BigDecimal.ONE;
-    @Builder.Default
-    private BigDecimal lotIncrement = BigDecimal.ONE;
-    private BigDecimal maxLotSize;
-    private Integer shelfLife;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-<details>
-<summary>品目区分 Enum（ItemCategory.java）</summary>
-```java
-// src/main/java/com/example/production/domain/model/item/ItemCategory.java
-package com.example.pms.domain.model.item;
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-@Getter
-@RequiredArgsConstructor
-public enum ItemCategory {
-    PRODUCT("製品"),
-    SEMI_PRODUCT("半製品"),
-    INTERMEDIATE("中間品"),
-    PART("部品"),
-    MATERIAL("材料"),
-    RAW_MATERIAL("原料"),
-    SUPPLY("資材");
-    private final String displayName;
-    public static ItemCategory fromDisplayName(String displayName) {
-        for (ItemCategory category : values()) {
-            if (category.displayName.equals(displayName)) {
-                return category;
-            }
-        }
-        throw new IllegalArgumentException("不正な品目区分: " + displayName);
-    }
-}
-```
-</details>
-### リポジトリ
-<details>
-<summary>Repository インターフェース（Output Port）</summary>
-```java
-// src/main/java/com/example/production/application/port/out/ItemRepository.java
-package com.example.pms.application.port.out;
-import com.example.pms.domain.model.item.Item;
-import java.time.LocalDate;
-import java.util.List;
-import java.util.Optional;
-/**
- * 品目リポジトリ（Output Port）
- * ドメイン層がデータアクセスに依存しないためのインターフェース
- */
-public interface ItemRepository {
-    /**
-     * 品目を保存する
-     */
-    void save(Item item);
-    /**
-     * 品目コードで品目を検索する（最新の適用開始日）
-     */
-    Optional<Item> findByItemCode(String itemCode);
-    /**
-     * 品目コードと基準日で品目を検索する
-     */
-    Optional<Item> findByItemCodeAndDate(String itemCode, LocalDate baseDate);
-    /**
-     * すべての品目を取得する
-     */
-    List<Item> findAll();
-    /**
-     * 品目を更新する
-     */
-    void update(Item item);
-    /**
-     * すべての品目を削除する
-     */
-    void deleteAll();
-}
-```
-</details>
-<details>
-<summary>Repository 実装（インフラストラクチャ層）</summary>
-```java
-// src/main/java/com/example/production/infrastructure/out/persistence/repository/ItemRepositoryImpl.java
-package com.example.pms.infrastructure.out.persistence.repository;
-import com.example.pms.application.port.out.ItemRepository;
-import com.example.pms.domain.model.item.Item;
-import com.example.pms.infrastructure.out.persistence.mapper.ItemMapper;
-import org.springframework.stereotype.Repository;
-import java.time.LocalDate;
-import java.util.List;
-import java.util.Optional;
-/**
- * 品目リポジトリ実装
- */
-@Repository
-public class ItemRepositoryImpl implements ItemRepository {
-    private final ItemMapper itemMapper;
-    public ItemRepositoryImpl(ItemMapper itemMapper) {
-        this.itemMapper = itemMapper;
-    }
-    @Override
-    public void save(Item item) {
-        itemMapper.insert(item);
-    }
-    @Override
-    public Optional<Item> findByItemCode(String itemCode) {
-        return itemMapper.findByItemCode(itemCode);
-    }
-    @Override
-    public Optional<Item> findByItemCodeAndDate(String itemCode, LocalDate baseDate) {
-        return itemMapper.findByItemCodeAndDate(itemCode, baseDate);
-    }
-    @Override
-    public List<Item> findAll() {
-        return itemMapper.findAll();
-    }
-    @Override
-    public void update(Item item) {
-        itemMapper.update(item);
-    }
-    @Override
-    public void deleteAll() {
-        itemMapper.deleteAll();
-    }
-}
-```
-</details>
-### TypeHandler
-PostgreSQL の日本語 ENUM 型と Java の Enum を相互変換するための TypeHandler を実装します。
-<details>
-<summary>ItemCategoryTypeHandler</summary>
-```java
-// src/main/java/com/example/pms/infrastructure/out/persistence/typehandler/ItemCategoryTypeHandler.java
-package com.example.pms.infrastructure.out.persistence.typehandler;
-import com.example.pms.domain.model.item.ItemCategory;
-import org.apache.ibatis.type.BaseTypeHandler;
-import org.apache.ibatis.type.JdbcType;
-import org.apache.ibatis.type.MappedTypes;
-import java.sql.*;
-@MappedTypes(ItemCategory.class)
-public class ItemCategoryTypeHandler extends BaseTypeHandler<ItemCategory> {
-    @Override
-    public void setNonNullParameter(PreparedStatement ps, int i,
-            ItemCategory parameter, JdbcType jdbcType) throws SQLException {
-        ps.setString(i, parameter.getDisplayName());
-    }
-    @Override
-    public ItemCategory getNullableResult(ResultSet rs, String columnName) throws SQLException {
-        String value = rs.getString(columnName);
-        return value == null ? null : ItemCategory.fromDisplayName(value);
-    }
-    @Override
-    public ItemCategory getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
-        String value = rs.getString(columnIndex);
-        return value == null ? null : ItemCategory.fromDisplayName(value);
-    }
-    @Override
-    public ItemCategory getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
-        String value = cs.getString(columnIndex);
-        return value == null ? null : ItemCategory.fromDisplayName(value);
-    }
-}
-```
-</details>
-### MyBatis Mapper
-日本語カラム名と英語プロパティ名のマッピングを定義します。
-<details>
-<summary>Mapper インターフェース</summary>
-```java
-// src/main/java/com/example/production/infrastructure/out/persistence/mapper/ItemMapper.java
-package com.example.pms.infrastructure.out.persistence.mapper;
-import com.example.pms.domain.model.item.Item;
-import org.apache.ibatis.annotations.Mapper;
-import org.apache.ibatis.annotations.Param;
-import java.time.LocalDate;
-import java.util.List;
-import java.util.Optional;
-@Mapper
-public interface ItemMapper {
-    void insert(Item item);
-    Optional<Item> findByItemCode(String itemCode);
-    Optional<Item> findByItemCodeAndDate(@Param("itemCode") String itemCode,
-                                          @Param("baseDate") LocalDate baseDate);
-    List<Item> findAll();
-    void update(Item item);
-    void deleteAll();
-}
-```
-</details>
-<details>
-<summary>MyBatis XML Mapper</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.pms.infrastructure.out.persistence.mapper.ItemMapper">
-    <!-- 日本語カラム名と英語プロパティ名のマッピング -->
-    <resultMap id="ItemResultMap" type="com.example.pms.domain.model.item.Item">
-        <id property="id" column="ID"/>
-        <result property="itemCode" column="品目コード"/>
-        <result property="effectiveFrom" column="適用開始日"/>
-        <result property="effectiveTo" column="適用停止日"/>
-        <result property="itemName" column="品名"/>
-        <result property="itemCategory" column="品目区分"
-                typeHandler="com.example.pms.infrastructure.out.persistence.typehandler.ItemCategoryTypeHandler"/>
-        <result property="unitCode" column="単位コード"/>
-        <result property="leadTime" column="リードタイム"/>
-        <result property="safetyLeadTime" column="安全リードタイム"/>
-        <result property="safetyStock" column="安全在庫数"/>
-        <result property="yieldRate" column="歩留率"/>
-        <result property="minLotSize" column="最小ロット数"/>
-        <result property="lotIncrement" column="刻みロット数"/>
-        <result property="maxLotSize" column="最大ロット数"/>
-        <result property="shelfLife" column="有効期間"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <insert id="insert" parameterType="com.example.pms.domain.model.item.Item"
-            useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
-        INSERT INTO "品目マスタ" (
-            "品目コード",
-            "適用開始日",
-            "適用停止日",
-            "品名",
-            "品目区分",
-            "単位コード",
-            "リードタイム",
-            "安全リードタイム",
-            "安全在庫数",
-            "歩留率",
-            "最小ロット数",
-            "刻みロット数",
-            "最大ロット数",
-            "有効期間",
-            "作成日時",
-            "更新日時"
-        ) VALUES (
-            #{itemCode},
-            #{effectiveFrom},
-            #{effectiveTo},
-            #{itemName},
-            #{itemCategory, typeHandler=com.example.pms.infrastructure.out.persistence.typehandler.ItemCategoryTypeHandler}::品目区分,
-            #{unitCode},
-            #{leadTime},
-            #{safetyLeadTime},
-            #{safetyStock},
-            #{yieldRate},
-            #{minLotSize},
-            #{lotIncrement},
-            #{maxLotSize},
-            #{shelfLife},
-            CURRENT_TIMESTAMP,
-            CURRENT_TIMESTAMP
-        )
-    </insert>
-    <select id="findByItemCode" resultMap="ItemResultMap">
-        SELECT * FROM "品目マスタ"
-        WHERE "品目コード" = #{itemCode}
-        ORDER BY "適用開始日" DESC
-        LIMIT 1
-    </select>
-    <select id="findByItemCodeAndDate" resultMap="ItemResultMap">
-        SELECT * FROM "品目マスタ"
-        WHERE "品目コード" = #{itemCode}
-          AND "適用開始日" &lt;= #{baseDate}
-          AND ("適用停止日" IS NULL OR "適用停止日" > #{baseDate})
-        ORDER BY "適用開始日" DESC
-        LIMIT 1
-    </select>
-    <select id="findAll" resultMap="ItemResultMap">
-        SELECT * FROM "品目マスタ"
-        ORDER BY "品目コード", "適用開始日" DESC
-    </select>
-    <update id="update" parameterType="com.example.pms.domain.model.item.Item">
-        UPDATE "品目マスタ" SET
-            "品名" = #{itemName},
-            "品目区分" = #{itemCategory, typeHandler=com.example.pms.infrastructure.out.persistence.typehandler.ItemCategoryTypeHandler}::品目区分,
-            "単位コード" = #{unitCode},
-            "リードタイム" = #{leadTime},
-            "安全リードタイム" = #{safetyLeadTime},
-            "安全在庫数" = #{safetyStock},
-            "歩留率" = #{yieldRate},
-            "最小ロット数" = #{minLotSize},
-            "刻みロット数" = #{lotIncrement},
-            "最大ロット数" = #{maxLotSize},
-            "有効期間" = #{shelfLife},
-            "更新日時" = CURRENT_TIMESTAMP
-        WHERE "ID" = #{id}
-    </update>
-    <delete id="deleteAll">
-        TRUNCATE TABLE "品目マスタ" CASCADE
-    </delete>
-</mapper>
-```
-</details>
----
-## 23.2 BOM（部品構成表）の設計
-BOM（Bill of Materials：部品構成表）は、製品がどのような部品・材料から構成されているかを定義する、生産管理システムの中核となるマスタです。
-### BOM の構造
-```plantuml
-@startwbs
-title BOMの例
-* X(1)
-** n(1)
-*** m(1)
-**** a(1)
-*** b(1)
-*** c(2)
-** d(1)
-@endwbs
-```
-()内の数字は数量を表します。製品 X を1つ作るには：
-- 中間品 n が 1 個必要
-- 部品 d が 1 個必要
-- 中間品 n を作るには、m が 1 個、b が 1 個、c が 2 個必要
-- ...というように、再帰的な構造になっています。
-### ER 図
-```plantuml
-@startuml
-title BOM ER図
-entity 部品構成表 {
-  親品目コード <<PK>>
-  子品目コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  適用停止日
-  基準数量
-  必要数量
-  不良率
-  工順
-}
-entity 品目マスタ {
-  品目コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  品名
-  品目区分
-  ...
-}
-品目マスタ ||--o{ 部品構成表 : 親品目
-品目マスタ ||--o{ 部品構成表 : 子品目
-@enduml
-```
-### テーブル定義
-<details>
-<summary>DDL（部品構成表）</summary>
-```sql
--- src/main/resources/db/migration/V003__create_bom.sql
--- 部品構成表（BOM）
-CREATE TABLE "部品構成表" (
-    "親品目コード" VARCHAR(20) NOT NULL,
-    "子品目コード" VARCHAR(20) NOT NULL,
-    "適用開始日" DATE NOT NULL,
-    "適用停止日" DATE,
-    "基準数量" DECIMAL(15, 2) NOT NULL DEFAULT 1,
-    "必要数量" DECIMAL(15, 2) NOT NULL,
-    "不良率" DECIMAL(5, 2) DEFAULT 0,
-    "工順" INTEGER,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    PRIMARY KEY ("親品目コード", "子品目コード", "適用開始日")
-);
--- インデックス
-CREATE INDEX idx_bom_親品目コード ON "部品構成表"("親品目コード");
-CREATE INDEX idx_bom_子品目コード ON "部品構成表"("子品目コード");
-```
-</details>
-### ドメインモデル
-<details>
-<summary>BOM エンティティ（Bom.java）</summary>
-```java
-// src/main/java/com/example/production/domain/model/bom/Bom.java
-package com.example.pms.domain.model.bom;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Bom {
-    private String parentItemCode;
-    private String childItemCode;
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    @Builder.Default
-    private BigDecimal baseQuantity = BigDecimal.ONE;
-    private BigDecimal requiredQuantity;
-    @Builder.Default
-    private BigDecimal defectRate = BigDecimal.ZERO;
-    private Integer sequence;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-<details>
-<summary>BOM 展開結果（BomExplosion.java）</summary>
-```java
-// src/main/java/com/example/production/domain/model/bom/BomExplosion.java
-package com.example.pms.domain.model.bom;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class BomExplosion {
-    private String parentItemCode;
-    private String childItemCode;
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    private BigDecimal baseQuantity;
-    private BigDecimal requiredQuantity;
-    private BigDecimal defectRate;
-    private Integer sequence;
-    private Integer level;
-    private BigDecimal totalQuantity;
-}
-```
-</details>
-### リポジトリ
-<details>
-<summary>BomRepository インターフェース（Output Port）</summary>
-```java
-// src/main/java/com/example/production/application/port/out/BomRepository.java
-package com.example.pms.application.port.out;
-import com.example.pms.domain.model.bom.Bom;
-import com.example.pms.domain.model.bom.BomExplosion;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.util.List;
-/**
- * BOMリポジトリ（Output Port）
- */
-public interface BomRepository {
-    void save(Bom bom);
-    List<Bom> findByParentItemCode(String parentItemCode);
-    List<Bom> findByParentItemCodeAndDate(String parentItemCode, LocalDate baseDate);
-    List<Bom> findByChildItemCode(String childItemCode);
-    List<BomExplosion> explode(String itemCode, BigDecimal quantity);
-    void deleteAll();
-}
-```
-</details>
-<details>
-<summary>BomRepositoryImpl 実装（インフラストラクチャ層）</summary>
-```java
-// src/main/java/com/example/production/infrastructure/out/persistence/repository/BomRepositoryImpl.java
-package com.example.pms.infrastructure.out.persistence.repository;
-import com.example.pms.application.port.out.BomRepository;
-import com.example.pms.domain.model.bom.Bom;
-import com.example.pms.domain.model.bom.BomExplosion;
-import com.example.pms.infrastructure.out.persistence.mapper.BomMapper;
-import org.springframework.stereotype.Repository;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.util.List;
-@Repository
-public class BomRepositoryImpl implements BomRepository {
-    private final BomMapper bomMapper;
-    public BomRepositoryImpl(BomMapper bomMapper) {
-        this.bomMapper = bomMapper;
-    }
-    @Override
-    public void save(Bom bom) {
-        bomMapper.insert(bom);
-    }
-    @Override
-    public List<Bom> findByParentItemCode(String parentItemCode) {
-        return bomMapper.findByParentItemCode(parentItemCode);
-    }
-    @Override
-    public List<Bom> findByParentItemCodeAndDate(String parentItemCode, LocalDate baseDate) {
-        return bomMapper.findByParentItemCodeAndDate(parentItemCode, baseDate);
-    }
-    @Override
-    public List<Bom> findByChildItemCode(String childItemCode) {
-        return bomMapper.findByChildItemCode(childItemCode);
-    }
-    @Override
-    public List<BomExplosion> explode(String itemCode, BigDecimal quantity) {
-        return bomMapper.explode(itemCode, quantity);
-    }
-    @Override
-    public void deleteAll() {
-        bomMapper.deleteAll();
-    }
-}
-```
-</details>
-### 再帰 CTE による BOM 展開
-BOM は再帰的な構造を持つため、PostgreSQL の再帰 CTE（Common Table Expression）を使用して全階層を展開します。
-<details>
-<summary>Mapper インターフェース</summary>
-```java
-// src/main/java/com/example/production/infrastructure/out/persistence/mapper/BomMapper.java
-package com.example.pms.infrastructure.out.persistence.mapper;
-import com.example.pms.domain.model.bom.Bom;
-import com.example.pms.domain.model.bom.BomExplosion;
-import org.apache.ibatis.annotations.Mapper;
-import org.apache.ibatis.annotations.Param;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.util.List;
-@Mapper
-public interface BomMapper {
-    void insert(Bom bom);
-    List<Bom> findByParentItemCode(String parentItemCode);
-    List<Bom> findByParentItemCodeAndDate(@Param("parentItemCode") String parentItemCode,
-                                           @Param("baseDate") LocalDate baseDate);
-    List<Bom> findByChildItemCode(String childItemCode);
-    List<BomExplosion> explode(@Param("itemCode") String itemCode,
-                               @Param("quantity") BigDecimal quantity);
-    void deleteAll();
-}
-```
-</details>
-<details>
-<summary>MyBatis XML Mapper（再帰 CTE を含む）</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.pms.infrastructure.out.persistence.mapper.BomMapper">
-    <!-- 日本語カラム名と英語プロパティ名のマッピング -->
-    <resultMap id="BomResultMap" type="com.example.pms.domain.model.bom.Bom">
-        <result property="parentItemCode" column="親品目コード"/>
-        <result property="childItemCode" column="子品目コード"/>
-        <result property="effectiveFrom" column="適用開始日"/>
-        <result property="effectiveTo" column="適用停止日"/>
-        <result property="baseQuantity" column="基準数量"/>
-        <result property="requiredQuantity" column="必要数量"/>
-        <result property="defectRate" column="不良率"/>
-        <result property="sequence" column="工順"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="updatedAt" column="更新日時"/>
-    </resultMap>
-    <resultMap id="BomExplosionResultMap" type="com.example.pms.domain.model.bom.BomExplosion">
-        <result property="parentItemCode" column="親品目コード"/>
-        <result property="childItemCode" column="子品目コード"/>
-        <result property="effectiveFrom" column="適用開始日"/>
-        <result property="effectiveTo" column="適用停止日"/>
-        <result property="baseQuantity" column="基準数量"/>
-        <result property="requiredQuantity" column="必要数量"/>
-        <result property="defectRate" column="不良率"/>
-        <result property="sequence" column="工順"/>
-        <result property="level" column="階層"/>
-        <result property="totalQuantity" column="累計数量"/>
-    </resultMap>
-    <insert id="insert" parameterType="com.example.pms.domain.model.bom.Bom">
-        INSERT INTO "部品構成表" (
-            "親品目コード",
-            "子品目コード",
-            "適用開始日",
-            "適用停止日",
-            "基準数量",
-            "必要数量",
-            "不良率",
-            "工順",
-            "作成日時",
-            "更新日時"
-        ) VALUES (
-            #{parentItemCode},
-            #{childItemCode},
-            #{effectiveFrom},
-            #{effectiveTo},
-            #{baseQuantity},
-            #{requiredQuantity},
-            #{defectRate},
-            #{sequence},
-            CURRENT_TIMESTAMP,
-            CURRENT_TIMESTAMP
-        )
-    </insert>
-    <select id="findByParentItemCode" resultMap="BomResultMap">
-        SELECT * FROM "部品構成表"
-        WHERE "親品目コード" = #{parentItemCode}
-          AND ("適用停止日" IS NULL OR "適用停止日" > CURRENT_DATE)
-        ORDER BY "工順", "子品目コード"
-    </select>
-    <select id="findByParentItemCodeAndDate" resultMap="BomResultMap">
-        SELECT * FROM "部品構成表"
-        WHERE "親品目コード" = #{parentItemCode}
-          AND "適用開始日" &lt;= #{baseDate}
-          AND ("適用停止日" IS NULL OR "適用停止日" > #{baseDate})
-        ORDER BY "工順", "子品目コード"
-    </select>
-    <select id="findByChildItemCode" resultMap="BomResultMap">
-        SELECT * FROM "部品構成表"
-        WHERE "子品目コード" = #{childItemCode}
-          AND ("適用停止日" IS NULL OR "適用停止日" > CURRENT_DATE)
-        ORDER BY "親品目コード"
-    </select>
-    <!-- 再帰CTEによる全階層展開 -->
-    <select id="explode" resultMap="BomExplosionResultMap">
-        WITH RECURSIVE bom_explosion AS (
-            -- 基底: 直接の子品目
-            SELECT
-                "親品目コード",
-                "子品目コード",
-                "適用開始日",
-                "適用停止日",
-                "基準数量",
-                "必要数量",
-                "不良率",
-                "工順",
-                1 as "階層",
-                "必要数量" as "累計数量"
-            FROM "部品構成表"
-            WHERE "親品目コード" = #{itemCode}
-              AND ("適用停止日" IS NULL OR "適用停止日" >= CURRENT_DATE)
-            UNION ALL
-            -- 再帰: 子品目の子品目
-            SELECT
-                b."親品目コード",
-                b."子品目コード",
-                b."適用開始日",
-                b."適用停止日",
-                b."基準数量",
-                b."必要数量",
-                b."不良率",
-                b."工順",
-                be."階層" + 1,
-                be."累計数量" * b."必要数量"
-            FROM "部品構成表" b
-            INNER JOIN bom_explosion be ON b."親品目コード" = be."子品目コード"
-            WHERE (b."適用停止日" IS NULL OR b."適用停止日" >= CURRENT_DATE)
-              AND be."階層" &lt; 10  -- 無限ループ防止
-        )
-        SELECT
-            "親品目コード",
-            "子品目コード",
-            "適用開始日",
-            "適用停止日",
-            "基準数量",
-            "必要数量",
-            "不良率",
-            "工順",
-            "階層",
-            "累計数量" * #{quantity} as "累計数量"
-        FROM bom_explosion
-        ORDER BY "階層", "親品目コード", "工順", "子品目コード"
-    </select>
-    <delete id="deleteAll">
-        TRUNCATE TABLE "部品構成表" CASCADE
-    </delete>
-</mapper>
-```
-</details>
----
-## 23.3 補助マスタの設計
-品目マスタと BOM を補完する補助マスタを設計します。
-### カレンダマスタ
-稼働日・休日・半日稼働を管理するマスタです。
-```plantuml
-@startuml
-title カレンダマスタ ER図
-entity カレンダマスタ {
-  カレンダコード <<PK>>
-  日付 <<PK>>
-  --
-  日付区分
-  稼働時間
-  備考
-}
-@enduml
-```
-<details>
-<summary>DDL（カレンダマスタ）</summary>
-```sql
--- src/main/resources/db/migration/V004__create_calendar_master.sql
--- 日付区分 ENUM
-CREATE TYPE 日付区分 AS ENUM ('稼働日', '休日', '半日稼働');
--- カレンダマスタ
-CREATE TABLE "カレンダマスタ" (
-    "カレンダコード" VARCHAR(20) NOT NULL,
-    "日付" DATE NOT NULL,
-    "日付区分" 日付区分 NOT NULL DEFAULT '稼働日',
-    "稼働時間" DECIMAL(5, 2),
-    "備考" VARCHAR(200),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    PRIMARY KEY ("カレンダコード", "日付")
-);
-```
-</details>
-<details>
-<summary>エンティティ（WorkCalendar.java, DateType.java）</summary>
-```java
-// src/main/java/com/example/production/domain/model/calendar/WorkCalendar.java
-package com.example.pms.domain.model.calendar;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class WorkCalendar {
-    private String calendarCode;
-    private LocalDate date;
-    private DateType dateType;
-    private BigDecimal workingHours;
-    private String note;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-```java
-// src/main/java/com/example/production/domain/model/calendar/DateType.java
-package com.example.pms.domain.model.calendar;
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-@Getter
-@RequiredArgsConstructor
-public enum DateType {
-    WORKING("稼働日"),
-    HOLIDAY("休日"),
-    HALF_DAY("半日稼働");
-    private final String displayName;
-    public static DateType fromDisplayName(String displayName) {
-        for (DateType type : values()) {
-            if (type.displayName.equals(displayName)) {
-                return type;
-            }
-        }
-        throw new IllegalArgumentException("不正な日付区分: " + displayName);
-    }
-}
-```
-</details>
-### 場所マスタ
-倉庫・製造場所・検査場所などを管理するマスタです。階層構造を持つことができます。
-```plantuml
-@startuml
-title 場所マスタ ER図
-entity 場所マスタ {
-  場所コード <<PK>>
-  --
-  場所名
-  場所区分
-  親場所コード <<FK>>
-}
-場所マスタ ||--o| 場所マスタ : 親子関係
-@enduml
-```
-<details>
-<summary>DDL（場所マスタ）</summary>
-```sql
--- src/main/resources/db/migration/V005__create_location_master.sql
--- 場所区分 ENUM
-CREATE TYPE 場所区分 AS ENUM ('倉庫', '製造', '検査', '出荷', '外注');
--- 場所マスタ
-CREATE TABLE "場所マスタ" (
-    "場所コード" VARCHAR(20) PRIMARY KEY,
-    "場所名" VARCHAR(100) NOT NULL,
-    "場所区分" 場所区分 NOT NULL,
-    "親場所コード" VARCHAR(20) REFERENCES "場所マスタ"("場所コード"),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
-);
-CREATE INDEX idx_場所マスタ_場所区分 ON "場所マスタ"("場所区分");
-```
-</details>
-<details>
-<summary>エンティティ（Location.java, LocationType.java）</summary>
-```java
-// src/main/java/com/example/production/domain/model/location/Location.java
-package com.example.pms.domain.model.location;
-import lombok.*;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Location {
-    private String locationCode;
-    private String locationName;
-    private LocationType locationType;
-    private String parentLocationCode;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-```java
-// src/main/java/com/example/production/domain/model/location/LocationType.java
-package com.example.pms.domain.model.location;
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-@Getter
-@RequiredArgsConstructor
-public enum LocationType {
-    WAREHOUSE("倉庫"),
-    MANUFACTURING("製造"),
-    INSPECTION("検査"),
-    SHIPPING("出荷"),
-    SUBCONTRACT("外注");
-    private final String displayName;
-    public static LocationType fromDisplayName(String displayName) {
-        for (LocationType type : values()) {
-            if (type.displayName.equals(displayName)) {
-                return type;
-            }
-        }
-        throw new IllegalArgumentException("不正な場所区分: " + displayName);
-    }
-}
-```
-</details>
-### 取引先マスタ
-仕入先・外注先・得意先を管理するマスタです。世代管理に対応しています。
-```plantuml
-@startuml
-title 取引先マスタ ER図
-entity 取引先マスタ {
-  取引先コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  適用停止日
-  取引先名
-  取引先カナ
-  取引先区分
-  郵便番号
-  住所
-  電話番号
-  FAX番号
-  担当者名
-}
-@enduml
-```
-<details>
-<summary>DDL（取引先マスタ）</summary>
-```sql
--- src/main/resources/db/migration/V006__create_supplier_master.sql
--- 取引先区分 ENUM
-CREATE TYPE 取引先区分 AS ENUM ('仕入先', '外注先', '得意先', '仕入先兼外注先');
--- 取引先マスタ
-CREATE TABLE "取引先マスタ" (
-    "取引先コード" VARCHAR(20) NOT NULL,
-    "適用開始日" DATE NOT NULL,
-    "適用停止日" DATE,
-    "取引先名" VARCHAR(100) NOT NULL,
-    "取引先カナ" VARCHAR(100),
-    "取引先区分" 取引先区分 NOT NULL,
-    "郵便番号" VARCHAR(10),
-    "住所" VARCHAR(200),
-    "電話番号" VARCHAR(20),
-    "FAX番号" VARCHAR(20),
-    "担当者名" VARCHAR(50),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    PRIMARY KEY ("取引先コード", "適用開始日")
-);
-CREATE INDEX idx_取引先マスタ_取引先区分 ON "取引先マスタ"("取引先区分");
-```
-</details>
-<details>
-<summary>エンティティ（Supplier.java, SupplierType.java）</summary>
-```java
-// src/main/java/com/example/production/domain/model/supplier/Supplier.java
-package com.example.pms.domain.model.supplier;
-import lombok.*;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Supplier {
-    private String supplierCode;
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    private String supplierName;
-    private String supplierNameKana;
-    private SupplierType supplierType;
-    private String postalCode;
-    private String address;
-    private String phoneNumber;
-    private String faxNumber;
-    private String contactPerson;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-```java
-// src/main/java/com/example/production/domain/model/supplier/SupplierType.java
-package com.example.pms.domain.model.supplier;
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-@Getter
-@RequiredArgsConstructor
-public enum SupplierType {
-    VENDOR("仕入先"),
-    SUBCONTRACTOR("外注先"),
-    CUSTOMER("得意先"),
-    VENDOR_AND_SUBCONTRACTOR("仕入先兼外注先");
-    private final String displayName;
-    public static SupplierType fromDisplayName(String displayName) {
-        for (SupplierType type : values()) {
-            if (type.displayName.equals(displayName)) {
-                return type;
-            }
-        }
-        throw new IllegalArgumentException("不正な取引先区分: " + displayName);
-    }
-}
-```
-</details>
-### 単位マスタ
-品目の数量単位を管理するマスタです。
-```plantuml
-@startuml
-title 単位マスタ ER図
-entity 単位マスタ {
-  単位コード <<PK>>
-  --
-  単位記号
-  単位名
-}
-@enduml
-```
-<details>
-<summary>エンティティ（Unit.java）</summary>
-```java
-// src/main/java/com/example/pms/domain/model/unit/Unit.java
-package com.example.pms.domain.model.unit;
-import lombok.*;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Unit {
-    private String unitCode;
-    private String unitSymbol;
-    private String unitName;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-### 部門マスタ
-部門・課の階層構造を管理するマスタです。
-```plantuml
-@startuml
-title 部門マスタ ER図
-entity 部門マスタ {
-  部門コード <<PK>>
-  --
-  部門名
-  部門パス
-  最下層区分
-  有効開始日
-  有効終了日
-}
-@enduml
-```
-<details>
-<summary>エンティティ（Department.java）</summary>
-```java
-// src/main/java/com/example/pms/domain/model/department/Department.java
-package com.example.pms.domain.model.department;
-import lombok.*;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Department {
-    private String departmentCode;
-    private String departmentName;
-    private String departmentPath;
-    private Boolean lowestLevel;
-    private LocalDate validFrom;
-    private LocalDate validTo;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-### 担当者マスタ
-担当者と部門の紐付けを管理するマスタです。世代管理に対応しています。
-```plantuml
-@startuml
-title 担当者マスタ ER図
-entity 担当者マスタ {
-  担当者コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  適用停止日
-  担当者名
-  部門コード <<FK>>
-  メールアドレス
-  電話番号
-}
-entity 部門マスタ {
-  部門コード <<PK>>
-  --
-  部門名
-  ...
-}
-部門マスタ ||--o{ 担当者マスタ
-@enduml
-```
-<details>
-<summary>エンティティ（Staff.java）</summary>
-```java
-// src/main/java/com/example/pms/domain/model/staff/Staff.java
-package com.example.pms.domain.model.staff;
-import lombok.*;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Staff {
-    private String staffCode;
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    private String staffName;
-    private String departmentCode;
-    private String email;
-    private String phoneNumber;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-### 工程マスタ
-製造工程の定義を管理するマスタです。
-```plantuml
-@startuml
-title 工程マスタ ER図
-entity 工程マスタ {
-  工程コード <<PK>>
-  --
-  工程名
-  工程区分
-  場所コード <<FK>>
-}
-entity 場所マスタ {
-  場所コード <<PK>>
-  --
-  場所名
-  ...
-}
-場所マスタ ||--o{ 工程マスタ
-@enduml
-```
-<details>
-<summary>エンティティ（Process.java）</summary>
-```java
-// src/main/java/com/example/pms/domain/model/process/Process.java
-package com.example.pms.domain.model.process;
-import lombok.*;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Process {
-    private String processCode;
-    private String processName;
-    private String processType;
-    private String locationCode;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-### 工程表
-品目ごとの製造工程順序を定義するマスタです。
-```plantuml
-@startuml
-title 工程表 ER図
-entity 工程表 {
-  品目コード <<PK>>
-  工順 <<PK>>
-  --
-  工程コード <<FK>>
-  標準作業時間
-  段取時間
-}
-entity 品目マスタ {
-  品目コード <<PK>>
-  --
-  品名
-  ...
-}
-entity 工程マスタ {
-  工程コード <<PK>>
-  --
-  工程名
-  ...
-}
-品目マスタ ||--o{ 工程表
-工程マスタ ||--o{ 工程表
-@enduml
-```
-<details>
-<summary>エンティティ（ProcessRoute.java）</summary>
-```java
-// src/main/java/com/example/pms/domain/model/process/ProcessRoute.java
-package com.example.pms.domain.model.process;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ProcessRoute {
-    private String itemCode;
-    private Integer sequence;
-    private String processCode;
-    private BigDecimal standardTime;
-    private BigDecimal setupTime;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-### 単価マスタ
-品目と取引先の組み合わせによる単価情報を管理するマスタです。世代管理に対応しています。
-```plantuml
-@startuml
-title 単価マスタ ER図
-entity 単価マスタ {
-  品目コード <<PK>>
-  取引先コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  適用停止日
-  単価
-  通貨コード
-}
-entity 品目マスタ {
-  品目コード <<PK>>
-  --
-  品名
-  ...
-}
-entity 取引先マスタ {
-  取引先コード <<PK>>
-  --
-  取引先名
-  ...
-}
-品目マスタ ||--o{ 単価マスタ
-取引先マスタ ||--o{ 単価マスタ
-@enduml
-```
-<details>
-<summary>エンティティ（UnitPrice.java）</summary>
-```java
-// src/main/java/com/example/pms/domain/model/unitprice/UnitPrice.java
-package com.example.pms.domain.model.unitprice;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class UnitPrice {
-    private String itemCode;
-    private String supplierCode;
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    private BigDecimal price;
-    private String currencyCode;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
-### 欠点マスタ
-品質不良の種類を管理するマスタです。
-```plantuml
-@startuml
-title 欠点マスタ ER図
-entity 欠点マスタ {
-  欠点コード <<PK>>
-  --
-  欠点名
-  欠点区分
-}
-@enduml
-```
-<details>
-<summary>エンティティ（Defect.java）</summary>
-```java
-// src/main/java/com/example/pms/domain/model/defect/Defect.java
-package com.example.pms.domain.model.defect;
-import lombok.*;
-import java.time.LocalDateTime;
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Defect {
-    private String defectCode;
-    private String defectName;
-    private String defectType;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-}
-```
-</details>
----
-## まとめ
-### 作成したテーブル
-| テーブル名（日本語） | 説明 |
-|-------------------|------|
-| `単位マスタ` | 品目の単位（個、kg、m など） |
-| `品目マスタ` | 製品・部品・材料などの品目情報 |
-| `部品構成表` | BOM（親子関係） |
-| `カレンダマスタ` | 稼働日・休日の管理 |
-| `場所マスタ` | 倉庫・工程などの場所情報 |
-| `取引先マスタ` | 仕入先・外注先・得意先 |
-| `部門マスタ` | 部門・課の階層構造 |
-| `担当者マスタ` | 担当者と部門の紐付け |
-| `工程マスタ` | 工程の定義 |
-| `工程表` | 品目ごとの製造工程 |
-| `単価マスタ` | 品目 × 取引先の単価 |
-| `欠点マスタ` | 品質不良の種類 |
-### アーキテクチャのポイント
-| レイヤー | パッケージ | 責務 |
-|---------|-----------|------|
-| **Domain** | `domain.model.*` | ビジネスロジック、エンティティ |
-| **Application** | `application.port.out` | Repository インターフェース（Output Port） |
-| **Infrastructure** | `infrastructure.out.persistence.*` | DB アクセス実装 |
-### 命名規則のまとめ
-| 要素 | 言語 | 例 |
-|------|------|-----|
-| **テーブル名** | 日本語 | `"品目マスタ"`, `"部品構成表"` |
-| **カラム名** | 日本語 | `"品目コード"`, `"品名"` |
-| **ENUM 型** | 日本語 | `品目区分`, `日付区分` |
-| **ENUM 値** | 日本語 | `'製品'`, `'稼働日'` |
-| **Java クラス名** | 英語 | `Item`, `Bom`, `WorkCalendar` |
-| **Java フィールド名** | 英語 | `itemCode`, `itemName` |
-| **Java メソッド名** | 英語 | `findByItemCode()`, `save()` |
-| **MyBatis resultMap** | 日本語 ↔ 英語 | `column="品目コード" property="itemCode"` |
-### ER図（第23章完了時点）
-```plantuml
-@startuml
-title マスタ情報 ER図
-entity 単位マスタ {
-  単位コード <<PK>>
-  --
-  単位記号
-  単位名
-}
-entity 品目マスタ {
-  ID <<PK>>
-  --
-  品目コード <<UK>>
-  適用開始日 <<UK>>
-  適用停止日
-  品名
-  品目区分
-  単位コード <<FK>>
-  リードタイム
-  歩留率
-  ...
-}
-entity 部品構成表 {
-  親品目コード <<PK>>
-  子品目コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  基準数量
-  必要数量
-  不良率
-  工順
-}
-entity カレンダマスタ {
-  カレンダコード <<PK>>
-  日付 <<PK>>
-  --
-  日付区分
-  稼働時間
-  備考
-}
-entity 場所マスタ {
-  場所コード <<PK>>
-  --
-  場所名
-  場所区分
-  親場所コード <<FK>>
-}
-entity 取引先マスタ {
-  取引先コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  取引先名
-  取引先区分
-  ...
-}
-entity 部門マスタ {
-  部門コード <<PK>>
-  --
-  部門名
-  部門パス
-  最下層区分
-}
-entity 担当者マスタ {
-  担当者コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  担当者名
-  部門コード <<FK>>
-  メールアドレス
-}
-entity 工程マスタ {
-  工程コード <<PK>>
-  --
-  工程名
-  工程区分
-  場所コード <<FK>>
-}
-entity 工程表 {
-  品目コード <<PK>>
-  工順 <<PK>>
-  --
-  工程コード <<FK>>
-  標準作業時間
-  段取時間
-}
-entity 単価マスタ {
-  品目コード <<PK>>
-  取引先コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  単価
-  通貨コード
-}
-entity 欠点マスタ {
-  欠点コード <<PK>>
-  --
-  欠点名
-  欠点区分
-}
-' リレーション
-単位マスタ ||--o{ 品目マスタ
-品目マスタ ||--o{ 部品構成表 : 親品目
-品目マスタ ||--o{ 部品構成表 : 子品目
-場所マスタ ||--o| 場所マスタ : 親子関係
-場所マスタ ||--o{ 工程マスタ
-部門マスタ ||--o{ 担当者マスタ
-品目マスタ ||--o{ 工程表
-工程マスタ ||--o{ 工程表
-品目マスタ ||--o{ 単価マスタ
-取引先マスタ ||--o{ 単価マスタ
-@enduml
-```
-### 設計のポイント
-1. **ヘキサゴナルアーキテクチャ**: ドメイン層がインフラに依存しない設計
-2. **世代管理**: 品目マスタや取引先マスタは `適用開始日` による世代管理を採用
-3. **日本語 DB / 英語 Java**: テーブル・カラムは日本語、Java コードは英語で統一
-4. **MyBatis resultMap**: 日本語カラムと英語プロパティのマッピングを明示的に定義
-5. **PostgreSQL ENUM**: 区分値は日本語 ENUM 型で型安全性を確保
-6. **TypeHandler**: Java Enum と日本語 ENUM 値の変換を実装
-7. **Repository パターン**: テストでは Repository インターフェースを使用
-8. **再帰 CTE**: BOM 展開には再帰 CTE を使用して全階層を効率的に取得
----
-[← 第22章：生産管理システムの全体像](chapter22.md) | [第24章：生産計画の設計 →](chapter24.md)
+# 第23章：マスタ情報の設計
+本章では、生産管理システムの基盤となるマスタ情報を設計します。ヘキサゴナルアーキテクチャ（ポート＆アダプターパターン）を採用し、ドメイン層がインフラストラクチャ層に依存しない設計とします。
+## アーキテクチャの概要
+```plantuml
+@startuml
+title ヘキサゴナルアーキテクチャ
+package "Application Layer" {
+  package "port/out" {
+    interface UnitRepository
+    interface ItemRepository
+    interface BomRepository
+    interface WorkCalendarRepository
+    interface LocationRepository
+    interface SupplierRepository
+    interface DepartmentRepository
+    interface StaffRepository
+    interface ProcessRepository
+    interface ProcessRouteRepository
+    interface UnitPriceRepository
+    interface DefectRepository
+  }
+}
+package "Domain Layer" {
+  package "model" {
+    class Unit
+    class Item
+    class ItemCategory
+    class Bom
+    class BomExplosion
+    class WorkCalendar
+    class DateType
+    class Location
+    class LocationType
+    class Supplier
+    class SupplierType
+    class Department
+    class Staff
+    class Process
+    class ProcessRoute
+    class UnitPrice
+    class Defect
+  }
+}
+package "Infrastructure Layer" {
+  package "out/persistence" {
+    package "mapper" {
+      interface UnitMapper
+      interface ItemMapper
+      interface BomMapper
+      interface WorkCalendarMapper
+      interface LocationMapper
+      interface SupplierMapper
+      interface DepartmentMapper
+      interface StaffMapper
+      interface ProcessMapper
+      interface ProcessRouteMapper
+      interface UnitPriceMapper
+      interface DefectMapper
+    }
+    package "repository" {
+      class UnitRepositoryImpl
+      class ItemRepositoryImpl
+      class BomRepositoryImpl
+      class WorkCalendarRepositoryImpl
+      class LocationRepositoryImpl
+      class SupplierRepositoryImpl
+      class DepartmentRepositoryImpl
+      class StaffRepositoryImpl
+      class ProcessRepositoryImpl
+      class ProcessRouteRepositoryImpl
+      class UnitPriceRepositoryImpl
+      class DefectRepositoryImpl
+    }
+    package "typehandler" {
+      class ItemCategoryTypeHandler
+      class DateTypeTypeHandler
+      class LocationTypeTypeHandler
+      class SupplierTypeTypeHandler
+    }
+  }
+}
+ItemRepository <|.. ItemRepositoryImpl
+ItemRepositoryImpl --> ItemMapper
+ItemRepositoryImpl --> Item
+@enduml
+```
+### パッケージ構成
+```
+src/main/java/com/example/pms/
+├── application/                    # アプリケーション層
+│   └── port/
+│       └── out/                   # Output Port（リポジトリインターフェース）
+│           ├── UnitRepository.java
+│           ├── ItemRepository.java
+│           ├── BomRepository.java
+│           ├── WorkCalendarRepository.java
+│           ├── LocationRepository.java
+│           ├── SupplierRepository.java
+│           ├── DepartmentRepository.java
+│           ├── StaffRepository.java
+│           ├── ProcessRepository.java
+│           ├── ProcessRouteRepository.java
+│           ├── UnitPriceRepository.java
+│           └── DefectRepository.java
+├── domain/                         # ドメイン層（純粋なビジネスロジック）
+│   └── model/                     # ドメインモデル
+│       ├── unit/
+│       │   └── Unit.java
+│       ├── item/
+│       │   ├── Item.java
+│       │   └── ItemCategory.java
+│       ├── bom/
+│       │   ├── Bom.java
+│       │   └── BomExplosion.java
+│       ├── calendar/
+│       │   ├── WorkCalendar.java
+│       │   └── DateType.java
+│       ├── location/
+│       │   ├── Location.java
+│       │   └── LocationType.java
+│       ├── supplier/
+│       │   ├── Supplier.java
+│       │   └── SupplierType.java
+│       ├── department/
+│       │   └── Department.java
+│       ├── staff/
+│       │   └── Staff.java
+│       ├── process/
+│       │   ├── Process.java
+│       │   └── ProcessRoute.java
+│       ├── unitprice/
+│       │   └── UnitPrice.java
+│       └── defect/
+│           └── Defect.java
+├── infrastructure/                 # インフラストラクチャ層
+│   └── out/
+│       └── persistence/
+│           ├── mapper/            # MyBatis Mapper
+│           │   ├── UnitMapper.java
+│           │   ├── ItemMapper.java
+│           │   ├── BomMapper.java
+│           │   ├── WorkCalendarMapper.java
+│           │   ├── LocationMapper.java
+│           │   ├── SupplierMapper.java
+│           │   ├── DepartmentMapper.java
+│           │   ├── StaffMapper.java
+│           │   ├── ProcessMapper.java
+│           │   ├── ProcessRouteMapper.java
+│           │   ├── UnitPriceMapper.java
+│           │   └── DefectMapper.java
+│           ├── repository/        # Repository実装
+│           │   ├── UnitRepositoryImpl.java
+│           │   ├── ItemRepositoryImpl.java
+│           │   ├── BomRepositoryImpl.java
+│           │   ├── WorkCalendarRepositoryImpl.java
+│           │   ├── LocationRepositoryImpl.java
+│           │   ├── SupplierRepositoryImpl.java
+│           │   ├── DepartmentRepositoryImpl.java
+│           │   ├── StaffRepositoryImpl.java
+│           │   ├── ProcessRepositoryImpl.java
+│           │   ├── ProcessRouteRepositoryImpl.java
+│           │   ├── UnitPriceRepositoryImpl.java
+│           │   └── DefectRepositoryImpl.java
+│           └── typehandler/       # TypeHandler
+│               ├── ItemCategoryTypeHandler.java
+│               ├── DateTypeTypeHandler.java
+│               ├── LocationTypeTypeHandler.java
+│               └── SupplierTypeTypeHandler.java
+└── config/
+    └── FlywayConfig.java
+```
+---
+## 23.1 品目マスタの設計
+品目マスタは、生産管理システムで扱う「モノ」（製品、部品、材料など）の情報を管理する、最も基本的なマスタです。
+### 品目とは
+生産管理における「品目」とは、管理対象となるすべての「モノ」を指します。
+| 品目区分 | 説明 | 例 |
+|---------|------|-----|
+| **製品** | 最終的に販売する完成品 | パソコン、スマートフォン |
+| **半製品** | 途中まで完成した製品 | 組立済みの基板 |
+| **中間品** | 製造工程の中間生成物 | 加工済み部品 |
+| **部品** | 製品を構成する部品 | ネジ、コネクタ |
+| **材料** | 加工に使用する材料 | 鋼材、プラスチック |
+| **原料** | 化学反応などの元となる原料 | 化学薬品 |
+| **資材** | 製造を支援する資材 | 梱包材、ラベル |
+### 品目マスタに必要な情報
+```plantuml
+@startuml
+title 品目マスタおよび関連マスタ
+entity 品目マスタ {
+  品目コード
+  適用開始日
+  --
+  適用停止日
+  品名
+  品目区分 <<FK>>
+  品目グループコード <<FK>>
+  単位コード <<FK>>
+  場所コード <<FK>>
+  リードタイム
+  安全リードタイム
+  安全在庫数
+  歩留率
+  最小ロット数
+  刻みロット数
+  最大ロット数
+  有効期間
+}
+entity 品目区分マスタ {
+  品目区分
+  --
+  品目区分名
+}
+note left of 品目区分マスタ
+製品
+半製品
+中間品
+部品
+材料
+原料
+資材など
+end note
+entity 品目グループマスタ {
+  品目グループコード
+  --
+  品目グループ名
+}
+entity 単位マスタ {
+  単位コード
+  --
+  単位記号
+  単位名
+}
+品目区分マスタ |o--{ 品目マスタ
+品目グループマスタ |o--{ 品目マスタ
+単位マスタ |o-{ 品目マスタ
+@enduml
+```
+### テーブル定義
+<details>
+<summary>DDL（品目マスタ・単位マスタ）</summary>
+```sql
+-- src/main/resources/db/migration/V002__create_item_master.sql
+-- 品目区分 ENUM（日本語値）
+CREATE TYPE 品目区分 AS ENUM (
+    '製品', '半製品', '中間品', '部品', '材料', '原料', '資材'
+);
+-- 単位マスタ（日本語テーブル名・カラム名）
+CREATE TABLE "単位マスタ" (
+    "単位コード" VARCHAR(10) PRIMARY KEY,
+    "単位記号" VARCHAR(10) NOT NULL,
+    "単位名" VARCHAR(50) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+-- 品目マスタ（日本語テーブル名・カラム名）
+CREATE TABLE "品目マスタ" (
+    "ID" SERIAL PRIMARY KEY,
+    "品目コード" VARCHAR(20) NOT NULL,
+    "適用開始日" DATE NOT NULL,
+    "適用停止日" DATE,
+    "品名" VARCHAR(100) NOT NULL,
+    "品目区分" 品目区分 NOT NULL,
+    "単位コード" VARCHAR(10) REFERENCES "単位マスタ"("単位コード"),
+    "リードタイム" INTEGER DEFAULT 0,
+    "安全リードタイム" INTEGER DEFAULT 0,
+    "安全在庫数" DECIMAL(15, 2) DEFAULT 0,
+    "歩留率" DECIMAL(5, 2) DEFAULT 100,
+    "最小ロット数" DECIMAL(15, 2) DEFAULT 1,
+    "刻みロット数" DECIMAL(15, 2) DEFAULT 1,
+    "最大ロット数" DECIMAL(15, 2),
+    "有効期間" INTEGER,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE("品目コード", "適用開始日")
+);
+-- インデックス
+CREATE INDEX idx_品目マスタ_品目コード ON "品目マスタ"("品目コード");
+CREATE INDEX idx_品目マスタ_品目区分 ON "品目マスタ"("品目区分");
+```
+</details>
+### 世代管理
+品目マスタは `品目コード` と `適用開始日` の複合キーによる世代管理を採用しています。これにより：
+- 同じ品目コードでも、適用開始日が異なれば別レコードとして登録可能
+- 過去・現在・未来の品目情報を保持できる
+- 特定時点での品目情報を参照できる
+### ドメインモデル
+<details>
+<summary>品目エンティティ（Item.java）</summary>
+```java
+// src/main/java/com/example/production/domain/model/item/Item.java
+package com.example.pms.domain.model.item;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Item {
+    private Integer id;
+    private String itemCode;
+    private LocalDate effectiveFrom;
+    private LocalDate effectiveTo;
+    private String itemName;
+    private ItemCategory itemCategory;
+    private String unitCode;
+    @Builder.Default
+    private Integer leadTime = 0;
+    @Builder.Default
+    private Integer safetyLeadTime = 0;
+    @Builder.Default
+    private BigDecimal safetyStock = BigDecimal.ZERO;
+    @Builder.Default
+    private BigDecimal yieldRate = new BigDecimal("100");
+    @Builder.Default
+    private BigDecimal minLotSize = BigDecimal.ONE;
+    @Builder.Default
+    private BigDecimal lotIncrement = BigDecimal.ONE;
+    private BigDecimal maxLotSize;
+    private Integer shelfLife;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+<details>
+<summary>品目区分 Enum（ItemCategory.java）</summary>
+```java
+// src/main/java/com/example/production/domain/model/item/ItemCategory.java
+package com.example.pms.domain.model.item;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+@Getter
+@RequiredArgsConstructor
+public enum ItemCategory {
+    PRODUCT("製品"),
+    SEMI_PRODUCT("半製品"),
+    INTERMEDIATE("中間品"),
+    PART("部品"),
+    MATERIAL("材料"),
+    RAW_MATERIAL("原料"),
+    SUPPLY("資材");
+    private final String displayName;
+    public static ItemCategory fromDisplayName(String displayName) {
+        for (ItemCategory category : values()) {
+            if (category.displayName.equals(displayName)) {
+                return category;
+            }
+        }
+        throw new IllegalArgumentException("不正な品目区分: " + displayName);
+    }
+}
+```
+</details>
+### リポジトリ
+<details>
+<summary>Repository インターフェース（Output Port）</summary>
+```java
+// src/main/java/com/example/production/application/port/out/ItemRepository.java
+package com.example.pms.application.port.out;
+import com.example.pms.domain.model.item.Item;
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Optional;
+/**
+ * 品目リポジトリ（Output Port）
+ * ドメイン層がデータアクセスに依存しないためのインターフェース
+ */
+public interface ItemRepository {
+    /**
+     * 品目を保存する
+     */
+    void save(Item item);
+    /**
+     * 品目コードで品目を検索する（最新の適用開始日）
+     */
+    Optional<Item> findByItemCode(String itemCode);
+    /**
+     * 品目コードと基準日で品目を検索する
+     */
+    Optional<Item> findByItemCodeAndDate(String itemCode, LocalDate baseDate);
+    /**
+     * すべての品目を取得する
+     */
+    List<Item> findAll();
+    /**
+     * 品目を更新する
+     */
+    void update(Item item);
+    /**
+     * すべての品目を削除する
+     */
+    void deleteAll();
+}
+```
+</details>
+<details>
+<summary>Repository 実装（インフラストラクチャ層）</summary>
+```java
+// src/main/java/com/example/production/infrastructure/out/persistence/repository/ItemRepositoryImpl.java
+package com.example.pms.infrastructure.out.persistence.repository;
+import com.example.pms.application.port.out.ItemRepository;
+import com.example.pms.domain.model.item.Item;
+import com.example.pms.infrastructure.out.persistence.mapper.ItemMapper;
+import org.springframework.stereotype.Repository;
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Optional;
+/**
+ * 品目リポジトリ実装
+ */
+@Repository
+public class ItemRepositoryImpl implements ItemRepository {
+    private final ItemMapper itemMapper;
+    public ItemRepositoryImpl(ItemMapper itemMapper) {
+        this.itemMapper = itemMapper;
+    }
+    @Override
+    public void save(Item item) {
+        itemMapper.insert(item);
+    }
+    @Override
+    public Optional<Item> findByItemCode(String itemCode) {
+        return itemMapper.findByItemCode(itemCode);
+    }
+    @Override
+    public Optional<Item> findByItemCodeAndDate(String itemCode, LocalDate baseDate) {
+        return itemMapper.findByItemCodeAndDate(itemCode, baseDate);
+    }
+    @Override
+    public List<Item> findAll() {
+        return itemMapper.findAll();
+    }
+    @Override
+    public void update(Item item) {
+        itemMapper.update(item);
+    }
+    @Override
+    public void deleteAll() {
+        itemMapper.deleteAll();
+    }
+}
+```
+</details>
+### TypeHandler
+PostgreSQL の日本語 ENUM 型と Java の Enum を相互変換するための TypeHandler を実装します。
+<details>
+<summary>ItemCategoryTypeHandler</summary>
+```java
+// src/main/java/com/example/pms/infrastructure/out/persistence/typehandler/ItemCategoryTypeHandler.java
+package com.example.pms.infrastructure.out.persistence.typehandler;
+import com.example.pms.domain.model.item.ItemCategory;
+import org.apache.ibatis.type.BaseTypeHandler;
+import org.apache.ibatis.type.JdbcType;
+import org.apache.ibatis.type.MappedTypes;
+import java.sql.*;
+@MappedTypes(ItemCategory.class)
+public class ItemCategoryTypeHandler extends BaseTypeHandler<ItemCategory> {
+    @Override
+    public void setNonNullParameter(PreparedStatement ps, int i,
+            ItemCategory parameter, JdbcType jdbcType) throws SQLException {
+        ps.setString(i, parameter.getDisplayName());
+    }
+    @Override
+    public ItemCategory getNullableResult(ResultSet rs, String columnName) throws SQLException {
+        String value = rs.getString(columnName);
+        return value == null ? null : ItemCategory.fromDisplayName(value);
+    }
+    @Override
+    public ItemCategory getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
+        String value = rs.getString(columnIndex);
+        return value == null ? null : ItemCategory.fromDisplayName(value);
+    }
+    @Override
+    public ItemCategory getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
+        String value = cs.getString(columnIndex);
+        return value == null ? null : ItemCategory.fromDisplayName(value);
+    }
+}
+```
+</details>
+### MyBatis Mapper
+日本語カラム名と英語プロパティ名のマッピングを定義します。
+<details>
+<summary>Mapper インターフェース</summary>
+```java
+// src/main/java/com/example/production/infrastructure/out/persistence/mapper/ItemMapper.java
+package com.example.pms.infrastructure.out.persistence.mapper;
+import com.example.pms.domain.model.item.Item;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Optional;
+@Mapper
+public interface ItemMapper {
+    void insert(Item item);
+    Optional<Item> findByItemCode(String itemCode);
+    Optional<Item> findByItemCodeAndDate(@Param("itemCode") String itemCode,
+                                          @Param("baseDate") LocalDate baseDate);
+    List<Item> findAll();
+    void update(Item item);
+    void deleteAll();
+}
+```
+</details>
+<details>
+<summary>MyBatis XML Mapper</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.pms.infrastructure.out.persistence.mapper.ItemMapper">
+    <!-- 日本語カラム名と英語プロパティ名のマッピング -->
+    <resultMap id="ItemResultMap" type="com.example.pms.domain.model.item.Item">
+        <id property="id" column="ID"/>
+        <result property="itemCode" column="品目コード"/>
+        <result property="effectiveFrom" column="適用開始日"/>
+        <result property="effectiveTo" column="適用停止日"/>
+        <result property="itemName" column="品名"/>
+        <result property="itemCategory" column="品目区分"
+                typeHandler="com.example.pms.infrastructure.out.persistence.typehandler.ItemCategoryTypeHandler"/>
+        <result property="unitCode" column="単位コード"/>
+        <result property="leadTime" column="リードタイム"/>
+        <result property="safetyLeadTime" column="安全リードタイム"/>
+        <result property="safetyStock" column="安全在庫数"/>
+        <result property="yieldRate" column="歩留率"/>
+        <result property="minLotSize" column="最小ロット数"/>
+        <result property="lotIncrement" column="刻みロット数"/>
+        <result property="maxLotSize" column="最大ロット数"/>
+        <result property="shelfLife" column="有効期間"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <insert id="insert" parameterType="com.example.pms.domain.model.item.Item"
+            useGeneratedKeys="true" keyProperty="id" keyColumn="ID">
+        INSERT INTO "品目マスタ" (
+            "品目コード",
+            "適用開始日",
+            "適用停止日",
+            "品名",
+            "品目区分",
+            "単位コード",
+            "リードタイム",
+            "安全リードタイム",
+            "安全在庫数",
+            "歩留率",
+            "最小ロット数",
+            "刻みロット数",
+            "最大ロット数",
+            "有効期間",
+            "作成日時",
+            "更新日時"
+        ) VALUES (
+            #{itemCode},
+            #{effectiveFrom},
+            #{effectiveTo},
+            #{itemName},
+            #{itemCategory, typeHandler=com.example.pms.infrastructure.out.persistence.typehandler.ItemCategoryTypeHandler}::品目区分,
+            #{unitCode},
+            #{leadTime},
+            #{safetyLeadTime},
+            #{safetyStock},
+            #{yieldRate},
+            #{minLotSize},
+            #{lotIncrement},
+            #{maxLotSize},
+            #{shelfLife},
+            CURRENT_TIMESTAMP,
+            CURRENT_TIMESTAMP
+        )
+    </insert>
+    <select id="findByItemCode" resultMap="ItemResultMap">
+        SELECT * FROM "品目マスタ"
+        WHERE "品目コード" = #{itemCode}
+        ORDER BY "適用開始日" DESC
+        LIMIT 1
+    </select>
+    <select id="findByItemCodeAndDate" resultMap="ItemResultMap">
+        SELECT * FROM "品目マスタ"
+        WHERE "品目コード" = #{itemCode}
+          AND "適用開始日" &lt;= #{baseDate}
+          AND ("適用停止日" IS NULL OR "適用停止日" > #{baseDate})
+        ORDER BY "適用開始日" DESC
+        LIMIT 1
+    </select>
+    <select id="findAll" resultMap="ItemResultMap">
+        SELECT * FROM "品目マスタ"
+        ORDER BY "品目コード", "適用開始日" DESC
+    </select>
+    <update id="update" parameterType="com.example.pms.domain.model.item.Item">
+        UPDATE "品目マスタ" SET
+            "品名" = #{itemName},
+            "品目区分" = #{itemCategory, typeHandler=com.example.pms.infrastructure.out.persistence.typehandler.ItemCategoryTypeHandler}::品目区分,
+            "単位コード" = #{unitCode},
+            "リードタイム" = #{leadTime},
+            "安全リードタイム" = #{safetyLeadTime},
+            "安全在庫数" = #{safetyStock},
+            "歩留率" = #{yieldRate},
+            "最小ロット数" = #{minLotSize},
+            "刻みロット数" = #{lotIncrement},
+            "最大ロット数" = #{maxLotSize},
+            "有効期間" = #{shelfLife},
+            "更新日時" = CURRENT_TIMESTAMP
+        WHERE "ID" = #{id}
+    </update>
+    <delete id="deleteAll">
+        TRUNCATE TABLE "品目マスタ" CASCADE
+    </delete>
+</mapper>
+```
+</details>
+---
+## 23.2 BOM（部品構成表）の設計
+BOM（Bill of Materials：部品構成表）は、製品がどのような部品・材料から構成されているかを定義する、生産管理システムの中核となるマスタです。
+### BOM の構造
+```plantuml
+@startwbs
+title BOMの例
+* X(1)
+** n(1)
+*** m(1)
+**** a(1)
+*** b(1)
+*** c(2)
+** d(1)
+@endwbs
+```
+()内の数字は数量を表します。製品 X を1つ作るには：
+- 中間品 n が 1 個必要
+- 部品 d が 1 個必要
+- 中間品 n を作るには、m が 1 個、b が 1 個、c が 2 個必要
+- ...というように、再帰的な構造になっています。
+### ER 図
+```plantuml
+@startuml
+title BOM ER図
+entity 部品構成表 {
+  親品目コード <<PK>>
+  子品目コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  適用停止日
+  基準数量
+  必要数量
+  不良率
+  工順
+}
+entity 品目マスタ {
+  品目コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  品名
+  品目区分
+  ...
+}
+品目マスタ ||--o{ 部品構成表 : 親品目
+品目マスタ ||--o{ 部品構成表 : 子品目
+@enduml
+```
+### テーブル定義
+<details>
+<summary>DDL（部品構成表）</summary>
+```sql
+-- src/main/resources/db/migration/V003__create_bom.sql
+-- 部品構成表（BOM）
+CREATE TABLE "部品構成表" (
+    "親品目コード" VARCHAR(20) NOT NULL,
+    "子品目コード" VARCHAR(20) NOT NULL,
+    "適用開始日" DATE NOT NULL,
+    "適用停止日" DATE,
+    "基準数量" DECIMAL(15, 2) NOT NULL DEFAULT 1,
+    "必要数量" DECIMAL(15, 2) NOT NULL,
+    "不良率" DECIMAL(5, 2) DEFAULT 0,
+    "工順" INTEGER,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY ("親品目コード", "子品目コード", "適用開始日")
+);
+-- インデックス
+CREATE INDEX idx_bom_親品目コード ON "部品構成表"("親品目コード");
+CREATE INDEX idx_bom_子品目コード ON "部品構成表"("子品目コード");
+```
+</details>
+### ドメインモデル
+<details>
+<summary>BOM エンティティ（Bom.java）</summary>
+```java
+// src/main/java/com/example/production/domain/model/bom/Bom.java
+package com.example.pms.domain.model.bom;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Bom {
+    private String parentItemCode;
+    private String childItemCode;
+    private LocalDate effectiveFrom;
+    private LocalDate effectiveTo;
+    @Builder.Default
+    private BigDecimal baseQuantity = BigDecimal.ONE;
+    private BigDecimal requiredQuantity;
+    @Builder.Default
+    private BigDecimal defectRate = BigDecimal.ZERO;
+    private Integer sequence;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+<details>
+<summary>BOM 展開結果（BomExplosion.java）</summary>
+```java
+// src/main/java/com/example/production/domain/model/bom/BomExplosion.java
+package com.example.pms.domain.model.bom;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class BomExplosion {
+    private String parentItemCode;
+    private String childItemCode;
+    private LocalDate effectiveFrom;
+    private LocalDate effectiveTo;
+    private BigDecimal baseQuantity;
+    private BigDecimal requiredQuantity;
+    private BigDecimal defectRate;
+    private Integer sequence;
+    private Integer level;
+    private BigDecimal totalQuantity;
+}
+```
+</details>
+### リポジトリ
+<details>
+<summary>BomRepository インターフェース（Output Port）</summary>
+```java
+// src/main/java/com/example/production/application/port/out/BomRepository.java
+package com.example.pms.application.port.out;
+import com.example.pms.domain.model.bom.Bom;
+import com.example.pms.domain.model.bom.BomExplosion;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.List;
+/**
+ * BOMリポジトリ（Output Port）
+ */
+public interface BomRepository {
+    void save(Bom bom);
+    List<Bom> findByParentItemCode(String parentItemCode);
+    List<Bom> findByParentItemCodeAndDate(String parentItemCode, LocalDate baseDate);
+    List<Bom> findByChildItemCode(String childItemCode);
+    List<BomExplosion> explode(String itemCode, BigDecimal quantity);
+    void deleteAll();
+}
+```
+</details>
+<details>
+<summary>BomRepositoryImpl 実装（インフラストラクチャ層）</summary>
+```java
+// src/main/java/com/example/production/infrastructure/out/persistence/repository/BomRepositoryImpl.java
+package com.example.pms.infrastructure.out.persistence.repository;
+import com.example.pms.application.port.out.BomRepository;
+import com.example.pms.domain.model.bom.Bom;
+import com.example.pms.domain.model.bom.BomExplosion;
+import com.example.pms.infrastructure.out.persistence.mapper.BomMapper;
+import org.springframework.stereotype.Repository;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.List;
+@Repository
+public class BomRepositoryImpl implements BomRepository {
+    private final BomMapper bomMapper;
+    public BomRepositoryImpl(BomMapper bomMapper) {
+        this.bomMapper = bomMapper;
+    }
+    @Override
+    public void save(Bom bom) {
+        bomMapper.insert(bom);
+    }
+    @Override
+    public List<Bom> findByParentItemCode(String parentItemCode) {
+        return bomMapper.findByParentItemCode(parentItemCode);
+    }
+    @Override
+    public List<Bom> findByParentItemCodeAndDate(String parentItemCode, LocalDate baseDate) {
+        return bomMapper.findByParentItemCodeAndDate(parentItemCode, baseDate);
+    }
+    @Override
+    public List<Bom> findByChildItemCode(String childItemCode) {
+        return bomMapper.findByChildItemCode(childItemCode);
+    }
+    @Override
+    public List<BomExplosion> explode(String itemCode, BigDecimal quantity) {
+        return bomMapper.explode(itemCode, quantity);
+    }
+    @Override
+    public void deleteAll() {
+        bomMapper.deleteAll();
+    }
+}
+```
+</details>
+### 再帰 CTE による BOM 展開
+BOM は再帰的な構造を持つため、PostgreSQL の再帰 CTE（Common Table Expression）を使用して全階層を展開します。
+<details>
+<summary>Mapper インターフェース</summary>
+```java
+// src/main/java/com/example/production/infrastructure/out/persistence/mapper/BomMapper.java
+package com.example.pms.infrastructure.out.persistence.mapper;
+import com.example.pms.domain.model.bom.Bom;
+import com.example.pms.domain.model.bom.BomExplosion;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.List;
+@Mapper
+public interface BomMapper {
+    void insert(Bom bom);
+    List<Bom> findByParentItemCode(String parentItemCode);
+    List<Bom> findByParentItemCodeAndDate(@Param("parentItemCode") String parentItemCode,
+                                           @Param("baseDate") LocalDate baseDate);
+    List<Bom> findByChildItemCode(String childItemCode);
+    List<BomExplosion> explode(@Param("itemCode") String itemCode,
+                               @Param("quantity") BigDecimal quantity);
+    void deleteAll();
+}
+```
+</details>
+<details>
+<summary>MyBatis XML Mapper（再帰 CTE を含む）</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.pms.infrastructure.out.persistence.mapper.BomMapper">
+    <!-- 日本語カラム名と英語プロパティ名のマッピング -->
+    <resultMap id="BomResultMap" type="com.example.pms.domain.model.bom.Bom">
+        <result property="parentItemCode" column="親品目コード"/>
+        <result property="childItemCode" column="子品目コード"/>
+        <result property="effectiveFrom" column="適用開始日"/>
+        <result property="effectiveTo" column="適用停止日"/>
+        <result property="baseQuantity" column="基準数量"/>
+        <result property="requiredQuantity" column="必要数量"/>
+        <result property="defectRate" column="不良率"/>
+        <result property="sequence" column="工順"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="updatedAt" column="更新日時"/>
+    </resultMap>
+    <resultMap id="BomExplosionResultMap" type="com.example.pms.domain.model.bom.BomExplosion">
+        <result property="parentItemCode" column="親品目コード"/>
+        <result property="childItemCode" column="子品目コード"/>
+        <result property="effectiveFrom" column="適用開始日"/>
+        <result property="effectiveTo" column="適用停止日"/>
+        <result property="baseQuantity" column="基準数量"/>
+        <result property="requiredQuantity" column="必要数量"/>
+        <result property="defectRate" column="不良率"/>
+        <result property="sequence" column="工順"/>
+        <result property="level" column="階層"/>
+        <result property="totalQuantity" column="累計数量"/>
+    </resultMap>
+    <insert id="insert" parameterType="com.example.pms.domain.model.bom.Bom">
+        INSERT INTO "部品構成表" (
+            "親品目コード",
+            "子品目コード",
+            "適用開始日",
+            "適用停止日",
+            "基準数量",
+            "必要数量",
+            "不良率",
+            "工順",
+            "作成日時",
+            "更新日時"
+        ) VALUES (
+            #{parentItemCode},
+            #{childItemCode},
+            #{effectiveFrom},
+            #{effectiveTo},
+            #{baseQuantity},
+            #{requiredQuantity},
+            #{defectRate},
+            #{sequence},
+            CURRENT_TIMESTAMP,
+            CURRENT_TIMESTAMP
+        )
+    </insert>
+    <select id="findByParentItemCode" resultMap="BomResultMap">
+        SELECT * FROM "部品構成表"
+        WHERE "親品目コード" = #{parentItemCode}
+          AND ("適用停止日" IS NULL OR "適用停止日" > CURRENT_DATE)
+        ORDER BY "工順", "子品目コード"
+    </select>
+    <select id="findByParentItemCodeAndDate" resultMap="BomResultMap">
+        SELECT * FROM "部品構成表"
+        WHERE "親品目コード" = #{parentItemCode}
+          AND "適用開始日" &lt;= #{baseDate}
+          AND ("適用停止日" IS NULL OR "適用停止日" > #{baseDate})
+        ORDER BY "工順", "子品目コード"
+    </select>
+    <select id="findByChildItemCode" resultMap="BomResultMap">
+        SELECT * FROM "部品構成表"
+        WHERE "子品目コード" = #{childItemCode}
+          AND ("適用停止日" IS NULL OR "適用停止日" > CURRENT_DATE)
+        ORDER BY "親品目コード"
+    </select>
+    <!-- 再帰CTEによる全階層展開 -->
+    <select id="explode" resultMap="BomExplosionResultMap">
+        WITH RECURSIVE bom_explosion AS (
+            -- 基底: 直接の子品目
+            SELECT
+                "親品目コード",
+                "子品目コード",
+                "適用開始日",
+                "適用停止日",
+                "基準数量",
+                "必要数量",
+                "不良率",
+                "工順",
+                1 as "階層",
+                "必要数量" as "累計数量"
+            FROM "部品構成表"
+            WHERE "親品目コード" = #{itemCode}
+              AND ("適用停止日" IS NULL OR "適用停止日" >= CURRENT_DATE)
+            UNION ALL
+            -- 再帰: 子品目の子品目
+            SELECT
+                b."親品目コード",
+                b."子品目コード",
+                b."適用開始日",
+                b."適用停止日",
+                b."基準数量",
+                b."必要数量",
+                b."不良率",
+                b."工順",
+                be."階層" + 1,
+                be."累計数量" * b."必要数量"
+            FROM "部品構成表" b
+            INNER JOIN bom_explosion be ON b."親品目コード" = be."子品目コード"
+            WHERE (b."適用停止日" IS NULL OR b."適用停止日" >= CURRENT_DATE)
+              AND be."階層" &lt; 10  -- 無限ループ防止
+        )
+        SELECT
+            "親品目コード",
+            "子品目コード",
+            "適用開始日",
+            "適用停止日",
+            "基準数量",
+            "必要数量",
+            "不良率",
+            "工順",
+            "階層",
+            "累計数量" * #{quantity} as "累計数量"
+        FROM bom_explosion
+        ORDER BY "階層", "親品目コード", "工順", "子品目コード"
+    </select>
+    <delete id="deleteAll">
+        TRUNCATE TABLE "部品構成表" CASCADE
+    </delete>
+</mapper>
+```
+</details>
+---
+## 23.3 補助マスタの設計
+品目マスタと BOM を補完する補助マスタを設計します。
+### カレンダマスタ
+稼働日・休日・半日稼働を管理するマスタです。
+```plantuml
+@startuml
+title カレンダマスタ ER図
+entity カレンダマスタ {
+  カレンダコード <<PK>>
+  日付 <<PK>>
+  --
+  日付区分
+  稼働時間
+  備考
+}
+@enduml
+```
+<details>
+<summary>DDL（カレンダマスタ）</summary>
+```sql
+-- src/main/resources/db/migration/V004__create_calendar_master.sql
+-- 日付区分 ENUM
+CREATE TYPE 日付区分 AS ENUM ('稼働日', '休日', '半日稼働');
+-- カレンダマスタ
+CREATE TABLE "カレンダマスタ" (
+    "カレンダコード" VARCHAR(20) NOT NULL,
+    "日付" DATE NOT NULL,
+    "日付区分" 日付区分 NOT NULL DEFAULT '稼働日',
+    "稼働時間" DECIMAL(5, 2),
+    "備考" VARCHAR(200),
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY ("カレンダコード", "日付")
+);
+```
+</details>
+<details>
+<summary>エンティティ（WorkCalendar.java, DateType.java）</summary>
+```java
+// src/main/java/com/example/production/domain/model/calendar/WorkCalendar.java
+package com.example.pms.domain.model.calendar;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class WorkCalendar {
+    private String calendarCode;
+    private LocalDate date;
+    private DateType dateType;
+    private BigDecimal workingHours;
+    private String note;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+```java
+// src/main/java/com/example/production/domain/model/calendar/DateType.java
+package com.example.pms.domain.model.calendar;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+@Getter
+@RequiredArgsConstructor
+public enum DateType {
+    WORKING("稼働日"),
+    HOLIDAY("休日"),
+    HALF_DAY("半日稼働");
+    private final String displayName;
+    public static DateType fromDisplayName(String displayName) {
+        for (DateType type : values()) {
+            if (type.displayName.equals(displayName)) {
+                return type;
+            }
+        }
+        throw new IllegalArgumentException("不正な日付区分: " + displayName);
+    }
+}
+```
+</details>
+### 場所マスタ
+倉庫・製造場所・検査場所などを管理するマスタです。階層構造を持つことができます。
+```plantuml
+@startuml
+title 場所マスタ ER図
+entity 場所マスタ {
+  場所コード <<PK>>
+  --
+  場所名
+  場所区分
+  親場所コード <<FK>>
+}
+場所マスタ ||--o| 場所マスタ : 親子関係
+@enduml
+```
+<details>
+<summary>DDL（場所マスタ）</summary>
+```sql
+-- src/main/resources/db/migration/V005__create_location_master.sql
+-- 場所区分 ENUM
+CREATE TYPE 場所区分 AS ENUM ('倉庫', '製造', '検査', '出荷', '外注');
+-- 場所マスタ
+CREATE TABLE "場所マスタ" (
+    "場所コード" VARCHAR(20) PRIMARY KEY,
+    "場所名" VARCHAR(100) NOT NULL,
+    "場所区分" 場所区分 NOT NULL,
+    "親場所コード" VARCHAR(20) REFERENCES "場所マスタ"("場所コード"),
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+CREATE INDEX idx_場所マスタ_場所区分 ON "場所マスタ"("場所区分");
+```
+</details>
+<details>
+<summary>エンティティ（Location.java, LocationType.java）</summary>
+```java
+// src/main/java/com/example/production/domain/model/location/Location.java
+package com.example.pms.domain.model.location;
+import lombok.*;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Location {
+    private String locationCode;
+    private String locationName;
+    private LocationType locationType;
+    private String parentLocationCode;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+```java
+// src/main/java/com/example/production/domain/model/location/LocationType.java
+package com.example.pms.domain.model.location;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+@Getter
+@RequiredArgsConstructor
+public enum LocationType {
+    WAREHOUSE("倉庫"),
+    MANUFACTURING("製造"),
+    INSPECTION("検査"),
+    SHIPPING("出荷"),
+    SUBCONTRACT("外注");
+    private final String displayName;
+    public static LocationType fromDisplayName(String displayName) {
+        for (LocationType type : values()) {
+            if (type.displayName.equals(displayName)) {
+                return type;
+            }
+        }
+        throw new IllegalArgumentException("不正な場所区分: " + displayName);
+    }
+}
+```
+</details>
+### 取引先マスタ
+仕入先・外注先・得意先を管理するマスタです。世代管理に対応しています。
+```plantuml
+@startuml
+title 取引先マスタ ER図
+entity 取引先マスタ {
+  取引先コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  適用停止日
+  取引先名
+  取引先カナ
+  取引先区分
+  郵便番号
+  住所
+  電話番号
+  FAX番号
+  担当者名
+}
+@enduml
+```
+<details>
+<summary>DDL（取引先マスタ）</summary>
+```sql
+-- src/main/resources/db/migration/V006__create_supplier_master.sql
+-- 取引先区分 ENUM
+CREATE TYPE 取引先区分 AS ENUM ('仕入先', '外注先', '得意先', '仕入先兼外注先');
+-- 取引先マスタ
+CREATE TABLE "取引先マスタ" (
+    "取引先コード" VARCHAR(20) NOT NULL,
+    "適用開始日" DATE NOT NULL,
+    "適用停止日" DATE,
+    "取引先名" VARCHAR(100) NOT NULL,
+    "取引先カナ" VARCHAR(100),
+    "取引先区分" 取引先区分 NOT NULL,
+    "郵便番号" VARCHAR(10),
+    "住所" VARCHAR(200),
+    "電話番号" VARCHAR(20),
+    "FAX番号" VARCHAR(20),
+    "担当者名" VARCHAR(50),
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY ("取引先コード", "適用開始日")
+);
+CREATE INDEX idx_取引先マスタ_取引先区分 ON "取引先マスタ"("取引先区分");
+```
+</details>
+<details>
+<summary>エンティティ（Supplier.java, SupplierType.java）</summary>
+```java
+// src/main/java/com/example/production/domain/model/supplier/Supplier.java
+package com.example.pms.domain.model.supplier;
+import lombok.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Supplier {
+    private String supplierCode;
+    private LocalDate effectiveFrom;
+    private LocalDate effectiveTo;
+    private String supplierName;
+    private String supplierNameKana;
+    private SupplierType supplierType;
+    private String postalCode;
+    private String address;
+    private String phoneNumber;
+    private String faxNumber;
+    private String contactPerson;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+```java
+// src/main/java/com/example/production/domain/model/supplier/SupplierType.java
+package com.example.pms.domain.model.supplier;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+@Getter
+@RequiredArgsConstructor
+public enum SupplierType {
+    VENDOR("仕入先"),
+    SUBCONTRACTOR("外注先"),
+    CUSTOMER("得意先"),
+    VENDOR_AND_SUBCONTRACTOR("仕入先兼外注先");
+    private final String displayName;
+    public static SupplierType fromDisplayName(String displayName) {
+        for (SupplierType type : values()) {
+            if (type.displayName.equals(displayName)) {
+                return type;
+            }
+        }
+        throw new IllegalArgumentException("不正な取引先区分: " + displayName);
+    }
+}
+```
+</details>
+### 単位マスタ
+品目の数量単位を管理するマスタです。
+```plantuml
+@startuml
+title 単位マスタ ER図
+entity 単位マスタ {
+  単位コード <<PK>>
+  --
+  単位記号
+  単位名
+}
+@enduml
+```
+<details>
+<summary>エンティティ（Unit.java）</summary>
+```java
+// src/main/java/com/example/pms/domain/model/unit/Unit.java
+package com.example.pms.domain.model.unit;
+import lombok.*;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Unit {
+    private String unitCode;
+    private String unitSymbol;
+    private String unitName;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+### 部門マスタ
+部門・課の階層構造を管理するマスタです。
+```plantuml
+@startuml
+title 部門マスタ ER図
+entity 部門マスタ {
+  部門コード <<PK>>
+  --
+  部門名
+  部門パス
+  最下層区分
+  有効開始日
+  有効終了日
+}
+@enduml
+```
+<details>
+<summary>エンティティ（Department.java）</summary>
+```java
+// src/main/java/com/example/pms/domain/model/department/Department.java
+package com.example.pms.domain.model.department;
+import lombok.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Department {
+    private String departmentCode;
+    private String departmentName;
+    private String departmentPath;
+    private Boolean lowestLevel;
+    private LocalDate validFrom;
+    private LocalDate validTo;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+### 担当者マスタ
+担当者と部門の紐付けを管理するマスタです。世代管理に対応しています。
+```plantuml
+@startuml
+title 担当者マスタ ER図
+entity 担当者マスタ {
+  担当者コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  適用停止日
+  担当者名
+  部門コード <<FK>>
+  メールアドレス
+  電話番号
+}
+entity 部門マスタ {
+  部門コード <<PK>>
+  --
+  部門名
+  ...
+}
+部門マスタ ||--o{ 担当者マスタ
+@enduml
+```
+<details>
+<summary>エンティティ（Staff.java）</summary>
+```java
+// src/main/java/com/example/pms/domain/model/staff/Staff.java
+package com.example.pms.domain.model.staff;
+import lombok.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Staff {
+    private String staffCode;
+    private LocalDate effectiveFrom;
+    private LocalDate effectiveTo;
+    private String staffName;
+    private String departmentCode;
+    private String email;
+    private String phoneNumber;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+### 工程マスタ
+製造工程の定義を管理するマスタです。
+```plantuml
+@startuml
+title 工程マスタ ER図
+entity 工程マスタ {
+  工程コード <<PK>>
+  --
+  工程名
+  工程区分
+  場所コード <<FK>>
+}
+entity 場所マスタ {
+  場所コード <<PK>>
+  --
+  場所名
+  ...
+}
+場所マスタ ||--o{ 工程マスタ
+@enduml
+```
+<details>
+<summary>エンティティ（Process.java）</summary>
+```java
+// src/main/java/com/example/pms/domain/model/process/Process.java
+package com.example.pms.domain.model.process;
+import lombok.*;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Process {
+    private String processCode;
+    private String processName;
+    private String processType;
+    private String locationCode;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+### 工程表
+品目ごとの製造工程順序を定義するマスタです。
+```plantuml
+@startuml
+title 工程表 ER図
+entity 工程表 {
+  品目コード <<PK>>
+  工順 <<PK>>
+  --
+  工程コード <<FK>>
+  標準作業時間
+  段取時間
+}
+entity 品目マスタ {
+  品目コード <<PK>>
+  --
+  品名
+  ...
+}
+entity 工程マスタ {
+  工程コード <<PK>>
+  --
+  工程名
+  ...
+}
+品目マスタ ||--o{ 工程表
+工程マスタ ||--o{ 工程表
+@enduml
+```
+<details>
+<summary>エンティティ（ProcessRoute.java）</summary>
+```java
+// src/main/java/com/example/pms/domain/model/process/ProcessRoute.java
+package com.example.pms.domain.model.process;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class ProcessRoute {
+    private String itemCode;
+    private Integer sequence;
+    private String processCode;
+    private BigDecimal standardTime;
+    private BigDecimal setupTime;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+### 単価マスタ
+品目と取引先の組み合わせによる単価情報を管理するマスタです。世代管理に対応しています。
+```plantuml
+@startuml
+title 単価マスタ ER図
+entity 単価マスタ {
+  品目コード <<PK>>
+  取引先コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  適用停止日
+  単価
+  通貨コード
+}
+entity 品目マスタ {
+  品目コード <<PK>>
+  --
+  品名
+  ...
+}
+entity 取引先マスタ {
+  取引先コード <<PK>>
+  --
+  取引先名
+  ...
+}
+品目マスタ ||--o{ 単価マスタ
+取引先マスタ ||--o{ 単価マスタ
+@enduml
+```
+<details>
+<summary>エンティティ（UnitPrice.java）</summary>
+```java
+// src/main/java/com/example/pms/domain/model/unitprice/UnitPrice.java
+package com.example.pms.domain.model.unitprice;
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class UnitPrice {
+    private String itemCode;
+    private String supplierCode;
+    private LocalDate effectiveFrom;
+    private LocalDate effectiveTo;
+    private BigDecimal price;
+    private String currencyCode;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+### 欠点マスタ
+品質不良の種類を管理するマスタです。
+```plantuml
+@startuml
+title 欠点マスタ ER図
+entity 欠点マスタ {
+  欠点コード <<PK>>
+  --
+  欠点名
+  欠点区分
+}
+@enduml
+```
+<details>
+<summary>エンティティ（Defect.java）</summary>
+```java
+// src/main/java/com/example/pms/domain/model/defect/Defect.java
+package com.example.pms.domain.model.defect;
+import lombok.*;
+import java.time.LocalDateTime;
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Defect {
+    private String defectCode;
+    private String defectName;
+    private String defectType;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+}
+```
+</details>
+---
+## まとめ
+### 作成したテーブル
+| テーブル名（日本語） | 説明 |
+|-------------------|------|
+| `単位マスタ` | 品目の単位（個、kg、m など） |
+| `品目マスタ` | 製品・部品・材料などの品目情報 |
+| `部品構成表` | BOM（親子関係） |
+| `カレンダマスタ` | 稼働日・休日の管理 |
+| `場所マスタ` | 倉庫・工程などの場所情報 |
+| `取引先マスタ` | 仕入先・外注先・得意先 |
+| `部門マスタ` | 部門・課の階層構造 |
+| `担当者マスタ` | 担当者と部門の紐付け |
+| `工程マスタ` | 工程の定義 |
+| `工程表` | 品目ごとの製造工程 |
+| `単価マスタ` | 品目 × 取引先の単価 |
+| `欠点マスタ` | 品質不良の種類 |
+### アーキテクチャのポイント
+| レイヤー | パッケージ | 責務 |
+|---------|-----------|------|
+| **Domain** | `domain.model.*` | ビジネスロジック、エンティティ |
+| **Application** | `application.port.out` | Repository インターフェース（Output Port） |
+| **Infrastructure** | `infrastructure.out.persistence.*` | DB アクセス実装 |
+### 命名規則のまとめ
+| 要素 | 言語 | 例 |
+|------|------|-----|
+| **テーブル名** | 日本語 | `"品目マスタ"`, `"部品構成表"` |
+| **カラム名** | 日本語 | `"品目コード"`, `"品名"` |
+| **ENUM 型** | 日本語 | `品目区分`, `日付区分` |
+| **ENUM 値** | 日本語 | `'製品'`, `'稼働日'` |
+| **Java クラス名** | 英語 | `Item`, `Bom`, `WorkCalendar` |
+| **Java フィールド名** | 英語 | `itemCode`, `itemName` |
+| **Java メソッド名** | 英語 | `findByItemCode()`, `save()` |
+| **MyBatis resultMap** | 日本語 ↔ 英語 | `column="品目コード" property="itemCode"` |
+### ER図（第23章完了時点）
+```plantuml
+@startuml
+title マスタ情報 ER図
+entity 単位マスタ {
+  単位コード <<PK>>
+  --
+  単位記号
+  単位名
+}
+entity 品目マスタ {
+  ID <<PK>>
+  --
+  品目コード <<UK>>
+  適用開始日 <<UK>>
+  適用停止日
+  品名
+  品目区分
+  単位コード <<FK>>
+  リードタイム
+  歩留率
+  ...
+}
+entity 部品構成表 {
+  親品目コード <<PK>>
+  子品目コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  基準数量
+  必要数量
+  不良率
+  工順
+}
+entity カレンダマスタ {
+  カレンダコード <<PK>>
+  日付 <<PK>>
+  --
+  日付区分
+  稼働時間
+  備考
+}
+entity 場所マスタ {
+  場所コード <<PK>>
+  --
+  場所名
+  場所区分
+  親場所コード <<FK>>
+}
+entity 取引先マスタ {
+  取引先コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  取引先名
+  取引先区分
+  ...
+}
+entity 部門マスタ {
+  部門コード <<PK>>
+  --
+  部門名
+  部門パス
+  最下層区分
+}
+entity 担当者マスタ {
+  担当者コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  担当者名
+  部門コード <<FK>>
+  メールアドレス
+}
+entity 工程マスタ {
+  工程コード <<PK>>
+  --
+  工程名
+  工程区分
+  場所コード <<FK>>
+}
+entity 工程表 {
+  品目コード <<PK>>
+  工順 <<PK>>
+  --
+  工程コード <<FK>>
+  標準作業時間
+  段取時間
+}
+entity 単価マスタ {
+  品目コード <<PK>>
+  取引先コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  単価
+  通貨コード
+}
+entity 欠点マスタ {
+  欠点コード <<PK>>
+  --
+  欠点名
+  欠点区分
+}
+' リレーション
+単位マスタ ||--o{ 品目マスタ
+品目マスタ ||--o{ 部品構成表 : 親品目
+品目マスタ ||--o{ 部品構成表 : 子品目
+場所マスタ ||--o| 場所マスタ : 親子関係
+場所マスタ ||--o{ 工程マスタ
+部門マスタ ||--o{ 担当者マスタ
+品目マスタ ||--o{ 工程表
+工程マスタ ||--o{ 工程表
+品目マスタ ||--o{ 単価マスタ
+取引先マスタ ||--o{ 単価マスタ
+@enduml
+```
+### 設計のポイント
+1. **ヘキサゴナルアーキテクチャ**: ドメイン層がインフラに依存しない設計
+2. **世代管理**: 品目マスタや取引先マスタは `適用開始日` による世代管理を採用
+3. **日本語 DB / 英語 Java**: テーブル・カラムは日本語、Java コードは英語で統一
+4. **MyBatis resultMap**: 日本語カラムと英語プロパティのマッピングを明示的に定義
+5. **PostgreSQL ENUM**: 区分値は日本語 ENUM 型で型安全性を確保
+6. **TypeHandler**: Java Enum と日本語 ENUM 値の変換を実装
+7. **Repository パターン**: テストでは Repository インターフェースを使用
+8. **再帰 CTE**: BOM 展開には再帰 CTE を使用して全階層を効率的に取得
+---
+[← 第22章：生産管理システムの全体像](chapter22.md) | [第24章：生産計画の設計 →](chapter24.md)