@k2works/claude-code-booster 4.7.0 → 4.8.0

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

@@ -1,1627 +1,1627 @@
-# 第5章：マスタ情報の設計
-
-販売管理システムの基盤となるマスタ情報を TDD で設計していきます。本章では、組織・社員・商品・取引先といった基本的なマスタテーブルの設計と実装を行います。
-
-## 5.1 部門マスタの設計
-
-企業の組織構造を管理する部門マスタを設計します。
-
-### 組織階層の概念
-
-企業の組織は階層構造を持っています。部門マスタでは、この階層構造を「部門パス」で表現します。
-
-```plantuml
-@startwbs
-
-* 全社 : 10000
-** 営業本部 : 11000
-*** 東日本営業部 : 11100
-**** 営業1課 : 11101
-**** 営業2課 : 11102
-*** 西日本営業部 : 11200
-**** 営業3課 : 11201
-**** 営業4課 : 11202
-** 管理本部 : 12000
-*** 総務部 : 12100
-**** 庶務課 : 12101
-**** 人事課 : 12102
-*** 経理部 : 12200
-**** 経理課 : 12201
-**** 財務課 : 12202
-
-@endwbs
-```
-
-### 部門マスタの ER 図
-
-```plantuml
-@startuml
-
-title 部門マスタ
-
-entity 部門マスタ {
-  部門コード <<PK>>
-  開始日 <<PK>>
-  --
-  終了日
-  部門名
-  組織階層
-  部門パス
-  最下層区分
-  作成日時
-  作成者名
-  更新日時
-  更新者名
-}
-
-note right of 部門マスタ
-  部門パスの例：
-  10000~11000~11100
-  （チルダで連結）
-end note
-
-@enduml
-```
-
-### 部門マスタの項目説明
-
-| 項目 | 説明 | 例 |
-|-----|------|-----|
-| **部門コード** | 部門を一意に識別するコード | `11101` |
-| **開始日** | 部門の有効期間開始日 | `2025-01-01` |
-| **終了日** | 部門の有効期間終了日 | `null`（有効） |
-| **部門名** | 部門の名称 | `営業1課` |
-| **組織階層** | 階層の深さ（0から開始） | `3` |
-| **部門パス** | ルートからのパス（チルダ連結） | `10000~11000~11100~11101` |
-| **最下層区分** | 最下層（末端）かどうか | `true` |
-
-### 組織改正への対応（履歴管理）
-
-組織改正が発生した場合、同じ部門コードでも開始日が異なるレコードを登録することで、組織の変遷を管理できます。
-
-```plantuml
-@startuml
-
-title 組織改正の履歴管理
-
-entity "部門マスタ（2024年度）" as dept2024 {
-  部門コード: 11000
-  開始日: 2024-01-01
-  終了日: 2024-12-31
-  --
-  部門名: 営業部
-  組織階層: 1
-  部門パス: 10000~11000
-}
-
-entity "部門マスタ（2025年度）" as dept2025 {
-  部門コード: 11000
-  開始日: 2025-01-01
-  終了日: null
-  --
-  部門名: 営業本部
-  組織階層: 1
-  部門パス: 10000~11000
-}
-
-dept2024 -[hidden]- dept2025
-
-note bottom of dept2025
-  同じ部門コードでも
-  開始日が異なれば
-  別レコードとして登録可能
-end note
-
-@enduml
-```
-
-### マイグレーション：部門マスタテーブルの作成
-
-<details>
-<summary>SQL 実装</summary>
-
-```sql
--- src/main/resources/db/migration/V002__create_department_master.sql
-
--- 部門マスタ（日本語テーブル名・カラム名）
-CREATE TABLE "部門マスタ" (
-    "部門コード" VARCHAR(10) NOT NULL,
-    "開始日" DATE NOT NULL,
-    "終了日" DATE,
-    "部門名" VARCHAR(40) NOT NULL,
-    "組織階層" INTEGER NOT NULL DEFAULT 0,
-    "部門パス" VARCHAR(100),
-    "最下層区分" BOOLEAN NOT NULL DEFAULT FALSE,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50),
-    PRIMARY KEY ("部門コード", "開始日")
-);
-
--- インデックス
-CREATE INDEX idx_部門マスタ_部門パス ON "部門マスタ"("部門パス");
-CREATE INDEX idx_部門マスタ_組織階層 ON "部門マスタ"("組織階層");
-```
-
-</details>
-
-### TDD：部門の登録と取得
-
-#### Red: 失敗するテストを書く
-
-<details>
-<summary>DepartmentRepositoryTest.java</summary>
-
-```java
-// src/test/java/com/example/sms/infrastructure/persistence/repository/DepartmentRepositoryTest.java
-package com.example.sms.infrastructure.persistence.repository;
-
-import com.example.sms.application.port.out.DepartmentRepository;
-import com.example.sms.domain.model.department.Department;
-import com.example.sms.testsetup.BaseIntegrationTest;
-import org.junit.jupiter.api.*;
-import org.springframework.beans.factory.annotation.Autowired;
-
-import java.time.LocalDate;
-
-import static org.assertj.core.api.Assertions.*;
-
-@DisplayName("部門リポジトリ")
-class DepartmentRepositoryTest extends BaseIntegrationTest {
-
-    @Autowired
-    private DepartmentRepository departmentRepository;
-
-    @BeforeEach
-    void setUp() {
-        departmentRepository.deleteAll();
-    }
-
-    @Nested
-    @DisplayName("登録")
-    class Registration {
-
-        @Test
-        @DisplayName("部門を登録できる")
-        void canRegisterDepartment() {
-            // Arrange
-            var department = Department.builder()
-                    .departmentCode("10000")
-                    .startDate(LocalDate.of(2025, 1, 1))
-                    .departmentName("本社")
-                    .hierarchyLevel(0)
-                    .departmentPath("10000")
-                    .isLeaf(false)
-                    .build();
-
-            // Act
-            departmentRepository.save(department);
-
-            // Assert
-            var result = departmentRepository.findByCode("10000");
-            assertThat(result).isPresent();
-            assertThat(result.get().getDepartmentName()).isEqualTo("本社");
-            assertThat(result.get().getHierarchyLevel()).isEqualTo(0);
-        }
-
-        @Test
-        @DisplayName("階層構造を持つ部門を登録できる")
-        void canRegisterHierarchicalDepartments() {
-            // Arrange: 親部門
-            var parent = Department.builder()
-                    .departmentCode("10000")
-                    .startDate(LocalDate.of(2025, 1, 1))
-                    .departmentName("本社")
-                    .hierarchyLevel(0)
-                    .departmentPath("10000")
-                    .isLeaf(false)
-                    .build();
-            departmentRepository.save(parent);
-
-            // Arrange: 子部門
-            var child = Department.builder()
-                    .departmentCode("11000")
-                    .startDate(LocalDate.of(2025, 1, 1))
-                    .departmentName("営業本部")
-                    .hierarchyLevel(1)
-                    .departmentPath("10000~11000")
-                    .isLeaf(false)
-                    .build();
-            departmentRepository.save(child);
-
-            // Arrange: 孫部門（最下層）
-            var grandChild = Department.builder()
-                    .departmentCode("11101")
-                    .startDate(LocalDate.of(2025, 1, 1))
-                    .departmentName("営業1課")
-                    .hierarchyLevel(3)
-                    .departmentPath("10000~11000~11100~11101")
-                    .isLeaf(true)
-                    .build();
-            departmentRepository.save(grandChild);
-
-            // Act
-            var result = departmentRepository.findByCode("11101");
-
-            // Assert
-            assertThat(result).isPresent();
-            assertThat(result.get().getDepartmentPath()).isEqualTo("10000~11000~11100~11101");
-            assertThat(result.get().isLeaf()).isTrue();
-        }
-    }
-
-    @Nested
-    @DisplayName("履歴管理")
-    class HistoryManagement {
-
-        @Test
-        @DisplayName("同じ部門コードでも開始日が異なれば登録できる（組織改正対応）")
-        void canRegisterSameCodeWithDifferentStartDate() {
-            // Arrange: 旧組織
-            var oldDept = Department.builder()
-                    .departmentCode("11000")
-                    .startDate(LocalDate.of(2024, 1, 1))
-                    .endDate(LocalDate.of(2024, 12, 31))
-                    .departmentName("営業部")
-                    .hierarchyLevel(1)
-                    .departmentPath("10000~11000")
-                    .isLeaf(false)
-                    .build();
-            departmentRepository.save(oldDept);
-
-            // Arrange: 新組織
-            var newDept = Department.builder()
-                    .departmentCode("11000")
-                    .startDate(LocalDate.of(2025, 1, 1))
-                    .departmentName("営業本部")
-                    .hierarchyLevel(1)
-                    .departmentPath("10000~11000")
-                    .isLeaf(false)
-                    .build();
-            departmentRepository.save(newDept);
-
-            // Act: 現在有効な部門を取得
-            var result = departmentRepository.findByCodeAndDate("11000", LocalDate.of(2025, 4, 1));
-
-            // Assert
-            assertThat(result).isPresent();
-            assertThat(result.get().getDepartmentName()).isEqualTo("営業本部");
-        }
-    }
-}
-```
-
-</details>
-
-#### Green: テストを通す実装
-
-<details>
-<summary>Department.java（エンティティ）</summary>
-
-```java
-// src/main/java/com/example/sms/domain/model/department/Department.java
-package com.example.sms.domain.model.department;
-
-import lombok.*;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Department {
-    private String departmentCode;
-    private LocalDate startDate;
-    private LocalDate endDate;
-    private String departmentName;
-    @Builder.Default
-    private Integer hierarchyLevel = 0;
-    private String departmentPath;
-    @Builder.Default
-    private boolean isLeaf = false;
-    private LocalDateTime createdAt;
-    private String createdBy;
-    private LocalDateTime updatedAt;
-    private String updatedBy;
-}
-```
-
-</details>
-
-<details>
-<summary>DepartmentRepository.java（Output Port）</summary>
-
-```java
-// src/main/java/com/example/sms/application/port/out/DepartmentRepository.java
-package com.example.sms.application.port.out;
-
-import com.example.sms.domain.model.department.Department;
-
-import java.time.LocalDate;
-import java.util.List;
-import java.util.Optional;
-
-/**
- * 部門リポジトリ（Output Port）
- */
-public interface DepartmentRepository {
-
-    void save(Department department);
-
-    Optional<Department> findByCode(String departmentCode);
-
-    Optional<Department> findByCodeAndDate(String departmentCode, LocalDate baseDate);
-
-    List<Department> findAll();
-
-    List<Department> findByHierarchyLevel(int level);
-
-    List<Department> findChildren(String parentPath);
-
-    void update(Department department);
-
-    void deleteAll();
-}
-```
-
-</details>
-
-<details>
-<summary>DepartmentMapper.xml</summary>
-
-```xml
-<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE mapper
-        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
-        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
-<mapper namespace="com.example.sms.infrastructure.persistence.mapper.DepartmentMapper">
-
-    <resultMap id="DepartmentResultMap" type="com.example.sms.domain.model.department.Department">
-        <result property="departmentCode" column="部門コード"/>
-        <result property="startDate" column="開始日"/>
-        <result property="endDate" column="終了日"/>
-        <result property="departmentName" column="部門名"/>
-        <result property="hierarchyLevel" column="組織階層"/>
-        <result property="departmentPath" column="部門パス"/>
-        <result property="isLeaf" column="最下層区分"/>
-        <result property="createdAt" column="作成日時"/>
-        <result property="createdBy" column="作成者名"/>
-        <result property="updatedAt" column="更新日時"/>
-        <result property="updatedBy" column="更新者名"/>
-    </resultMap>
-
-    <insert id="insert" parameterType="com.example.sms.domain.model.department.Department">
-        INSERT INTO "部門マスタ" (
-            "部門コード", "開始日", "終了日", "部門名",
-            "組織階層", "部門パス", "最下層区分",
-            "作成日時", "作成者名", "更新日時", "更新者名"
-        ) VALUES (
-            #{departmentCode}, #{startDate}, #{endDate}, #{departmentName},
-            #{hierarchyLevel}, #{departmentPath}, #{isLeaf},
-            CURRENT_TIMESTAMP, #{createdBy}, CURRENT_TIMESTAMP, #{updatedBy}
-        )
-    </insert>
-
-    <select id="findByCode" resultMap="DepartmentResultMap">
-        SELECT * FROM "部門マスタ"
-        WHERE "部門コード" = #{departmentCode}
-          AND ("終了日" IS NULL OR "終了日" > CURRENT_DATE)
-        ORDER BY "開始日" DESC
-        LIMIT 1
-    </select>
-
-    <select id="findByCodeAndDate" resultMap="DepartmentResultMap">
-        SELECT * FROM "部門マスタ"
-        WHERE "部門コード" = #{departmentCode}
-          AND "開始日" &lt;= #{baseDate}
-          AND ("終了日" IS NULL OR "終了日" > #{baseDate})
-        ORDER BY "開始日" DESC
-        LIMIT 1
-    </select>
-
-    <delete id="deleteAll">
-        TRUNCATE TABLE "部門マスタ" CASCADE
-    </delete>
-</mapper>
-```
-
-</details>
-
----
-
-## 5.2 社員マスタの設計
-
-部門に所属する社員を管理するマスタを設計します。
-
-### 社員マスタの ER 図
-
-```plantuml
-@startuml
-
-title 社員マスタ
-
-entity 社員マスタ {
-  社員コード <<PK>>
-  --
-  社員名
-  社員名カナ
-  部門コード <<FK>>
-  開始日 <<FK>>
-  作成日時
-  作成者名
-  更新日時
-  更新者名
-}
-
-entity 部門マスタ {
-  部門コード <<PK>>
-  開始日 <<PK>>
-  --
-  ...
-}
-
-社員マスタ }o--|| 部門マスタ
-
-@enduml
-```
-
-### マイグレーション：社員マスタテーブルの作成
-
-<details>
-<summary>SQL 実装</summary>
-
-```sql
--- src/main/resources/db/migration/V003__create_employee_master.sql
-
--- 社員マスタ
-CREATE TABLE "社員マスタ" (
-    "社員コード" VARCHAR(10) PRIMARY KEY,
-    "社員名" VARCHAR(20) NOT NULL,
-    "社員名カナ" VARCHAR(40),
-    "部門コード" VARCHAR(10),
-    "開始日" DATE,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50),
-    FOREIGN KEY ("部門コード", "開始日") REFERENCES "部門マスタ"("部門コード", "開始日")
-);
-
-CREATE INDEX idx_社員マスタ_部門コード ON "社員マスタ"("部門コード");
-```
-
-</details>
-
-### エンティティ（ドメイン層）
-
-<details>
-<summary>Employee.java</summary>
-
-```java
-// src/main/java/com/example/sms/domain/model/employee/Employee.java
-package com.example.sms.domain.model.employee;
-
-import lombok.*;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Employee {
-    private String employeeCode;
-    private String employeeName;
-    private String employeeNameKana;
-    private String departmentCode;
-    private LocalDate departmentStartDate;
-    private LocalDateTime createdAt;
-    private String createdBy;
-    private LocalDateTime updatedAt;
-    private String updatedBy;
-}
-```
-
-</details>
-
----
-
-## 5.3 商品マスタの設計
-
-販売管理システムで扱う「商品」の情報を管理するマスタを設計します。
-
-### 商品マスタの構造
-
-```plantuml
-@startuml
-!define TABLE(x) entity x << (T,#FFAAAA) >>
-
-skinparam linetype ortho
-left to right direction
-
-TABLE(顧客別販売単価) {
-  商品コード (FK)
-  取引先コード (FK)
-  --
-  販売単価
-  作成日時
-  作成者名
-  更新日時
-  更新者名
-}
-
-TABLE(商品マスタ) {
-  商品コード
-  --
-  商品正式名
-  商品名
-  商品名カナ
-  商品区分
-  製品型番
-  販売単価
-  仕入単価
-  税区分
-  商品分類コード (FK)
-  雑区分
-  在庫管理対象区分
-  在庫引当区分
-  仕入先コード (FK)
-  作成日時
-  作成者名
-  更新日時
-  更新者名
-}
-
-TABLE(商品分類マスタ) {
-  商品分類コード
-  --
-  商品分類名
-  商品分類階層
-  商品分類パス
-  最下層区分
-  作成日時
-  作成者名
-  更新日時
-  更新者名
-}
-
-顧客別販売単価 }o--|| 商品マスタ
-商品マスタ }o..|| 商品分類マスタ
-
-@enduml
-```
-
-### 商品区分と税区分
-
-商品には「商品区分」と「税区分」という2つの区分があります。
-
-#### 商品区分
-
-| 区分値 | 説明 |
-|-------|------|
-| 商品 | 仕入れて販売する商品 |
-| 製品 | 自社で製造した製品 |
-| サービス | 無形のサービス |
-| 諸口 | その他の一時的な商品 |
-
-#### 税区分
-
-| 区分値 | 説明 |
-|-------|------|
-| 外税 | 税抜価格で管理し、別途消費税を計算 |
-| 内税 | 税込価格で管理 |
-| 非課税 | 消費税対象外 |
-
-### マイグレーション：商品マスタテーブルの作成
-
-<details>
-<summary>SQL 実装</summary>
-
-```sql
--- src/main/resources/db/migration/V004__create_product_master.sql
-
--- 商品区分 ENUM
-CREATE TYPE 商品区分 AS ENUM ('商品', '製品', 'サービス', '諸口');
-
--- 税区分 ENUM
-CREATE TYPE 税区分 AS ENUM ('外税', '内税', '非課税');
-
--- 商品分類マスタ
-CREATE TABLE "商品分類マスタ" (
-    "商品分類コード" VARCHAR(10) PRIMARY KEY,
-    "商品分類名" VARCHAR(50) NOT NULL,
-    "商品分類階層" INTEGER NOT NULL DEFAULT 0,
-    "商品分類パス" VARCHAR(100),
-    "最下層区分" BOOLEAN NOT NULL DEFAULT FALSE,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50)
-);
-
--- 商品マスタ
-CREATE TABLE "商品マスタ" (
-    "商品コード" VARCHAR(20) PRIMARY KEY,
-    "商品正式名" VARCHAR(200),
-    "商品名" VARCHAR(100) NOT NULL,
-    "商品名カナ" VARCHAR(200),
-    "商品区分" 商品区分 NOT NULL DEFAULT '商品',
-    "製品型番" VARCHAR(50),
-    "販売単価" DECIMAL(15, 2) DEFAULT 0,
-    "仕入単価" DECIMAL(15, 2) DEFAULT 0,
-    "税区分" 税区分 NOT NULL DEFAULT '外税',
-    "商品分類コード" VARCHAR(10) REFERENCES "商品分類マスタ"("商品分類コード"),
-    "雑区分" BOOLEAN DEFAULT FALSE,
-    "在庫管理対象区分" BOOLEAN DEFAULT TRUE,
-    "在庫引当区分" BOOLEAN DEFAULT TRUE,
-    "仕入先コード" VARCHAR(20),
-    "仕入先枝番" VARCHAR(10),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50)
-);
-
--- インデックス
-CREATE INDEX idx_商品マスタ_商品区分 ON "商品マスタ"("商品区分");
-CREATE INDEX idx_商品マスタ_商品分類コード ON "商品マスタ"("商品分類コード");
-CREATE INDEX idx_商品分類マスタ_商品分類パス ON "商品分類マスタ"("商品分類パス");
-```
-
-</details>
-
-### TDD：商品の登録と取得
-
-#### Red: 失敗するテストを書く
-
-<details>
-<summary>ProductRepositoryTest.java</summary>
-
-```java
-// src/test/java/com/example/sms/infrastructure/persistence/repository/ProductRepositoryTest.java
-package com.example.sms.infrastructure.persistence.repository;
-
-import com.example.sms.application.port.out.ProductRepository;
-import com.example.sms.domain.model.product.Product;
-import com.example.sms.domain.model.product.ProductCategory;
-import com.example.sms.domain.model.product.TaxCategory;
-import com.example.sms.testsetup.BaseIntegrationTest;
-import org.junit.jupiter.api.*;
-import org.springframework.beans.factory.annotation.Autowired;
-
-import java.math.BigDecimal;
-
-import static org.assertj.core.api.Assertions.*;
-
-@DisplayName("商品リポジトリ")
-class ProductRepositoryTest extends BaseIntegrationTest {
-
-    @Autowired
-    private ProductRepository productRepository;
-
-    @BeforeEach
-    void setUp() {
-        productRepository.deleteAll();
-    }
-
-    @Nested
-    @DisplayName("登録")
-    class Registration {
-
-        @Test
-        @DisplayName("商品を登録できる")
-        void canRegisterProduct() {
-            // Arrange
-            var product = Product.builder()
-                    .productCode("PROD001")
-                    .productName("テスト商品")
-                    .productCategory(ProductCategory.PRODUCT)
-                    .sellingPrice(new BigDecimal("1000"))
-                    .purchasePrice(new BigDecimal("700"))
-                    .taxCategory(TaxCategory.EXCLUSIVE)
-                    .build();
-
-            // Act
-            productRepository.save(product);
-
-            // Assert
-            var result = productRepository.findByCode("PROD001");
-            assertThat(result).isPresent();
-            assertThat(result.get().getProductName()).isEqualTo("テスト商品");
-            assertThat(result.get().getSellingPrice()).isEqualByComparingTo(new BigDecimal("1000"));
-        }
-
-        @Test
-        @DisplayName("全ての商品区分を登録できる")
-        void canRegisterAllCategories() {
-            var categories = ProductCategory.values();
-
-            for (int i = 0; i < categories.length; i++) {
-                var product = Product.builder()
-                        .productCode("CAT-" + String.format("%03d", i))
-                        .productName("商品" + categories[i].getDisplayName())
-                        .productCategory(categories[i])
-                        .taxCategory(TaxCategory.EXCLUSIVE)
-                        .build();
-
-                productRepository.save(product);
-
-                var result = productRepository.findByCode(product.getProductCode());
-                assertThat(result).isPresent();
-                assertThat(result.get().getProductCategory()).isEqualTo(categories[i]);
-            }
-        }
-    }
-
-    @Nested
-    @DisplayName("税区分")
-    class TaxCategories {
-
-        @Test
-        @DisplayName("外税商品を登録できる")
-        void canRegisterExclusiveTax() {
-            var product = createProduct("TAX001", "外税商品", TaxCategory.EXCLUSIVE);
-            productRepository.save(product);
-
-            var result = productRepository.findByCode("TAX001");
-            assertThat(result.get().getTaxCategory()).isEqualTo(TaxCategory.EXCLUSIVE);
-        }
-
-        @Test
-        @DisplayName("内税商品を登録できる")
-        void canRegisterInclusiveTax() {
-            var product = createProduct("TAX002", "内税商品", TaxCategory.INCLUSIVE);
-            productRepository.save(product);
-
-            var result = productRepository.findByCode("TAX002");
-            assertThat(result.get().getTaxCategory()).isEqualTo(TaxCategory.INCLUSIVE);
-        }
-
-        @Test
-        @DisplayName("非課税商品を登録できる")
-        void canRegisterTaxFree() {
-            var product = createProduct("TAX003", "非課税商品", TaxCategory.TAX_FREE);
-            productRepository.save(product);
-
-            var result = productRepository.findByCode("TAX003");
-            assertThat(result.get().getTaxCategory()).isEqualTo(TaxCategory.TAX_FREE);
-        }
-    }
-
-    private Product createProduct(String code, String name, TaxCategory taxCategory) {
-        return Product.builder()
-                .productCode(code)
-                .productName(name)
-                .productCategory(ProductCategory.PRODUCT)
-                .taxCategory(taxCategory)
-                .build();
-    }
-}
-```
-
-</details>
-
-#### Green: テストを通す実装
-
-<details>
-<summary>Product.java（エンティティ）</summary>
-
-```java
-// src/main/java/com/example/sms/domain/model/product/Product.java
-package com.example.sms.domain.model.product;
-
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Product {
-    private String productCode;
-    private String productFullName;
-    private String productName;
-    private String productNameKana;
-    private ProductCategory productCategory;
-    private String modelNumber;
-    @Builder.Default
-    private BigDecimal sellingPrice = BigDecimal.ZERO;
-    @Builder.Default
-    private BigDecimal purchasePrice = BigDecimal.ZERO;
-    private TaxCategory taxCategory;
-    private String classificationCode;
-    @Builder.Default
-    private boolean isMiscellaneous = false;
-    @Builder.Default
-    private boolean isInventoryManaged = true;
-    @Builder.Default
-    private boolean isInventoryAllocated = true;
-    private String supplierCode;
-    private String supplierBranchNumber;
-    private LocalDateTime createdAt;
-    private String createdBy;
-    private LocalDateTime updatedAt;
-    private String updatedBy;
-}
-```
-
-</details>
-
-<details>
-<summary>ProductCategory.java（商品区分 Enum）</summary>
-
-```java
-// src/main/java/com/example/sms/domain/model/product/ProductCategory.java
-package com.example.sms.domain.model.product;
-
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-
-@Getter
-@RequiredArgsConstructor
-public enum ProductCategory {
-    PRODUCT("商品"),
-    MANUFACTURED("製品"),
-    SERVICE("サービス"),
-    MISCELLANEOUS("諸口");
-
-    private final String displayName;
-
-    public static ProductCategory fromDisplayName(String displayName) {
-        for (ProductCategory category : values()) {
-            if (category.displayName.equals(displayName)) {
-                return category;
-            }
-        }
-        throw new IllegalArgumentException("不正な商品区分: " + displayName);
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>TaxCategory.java（税区分 Enum）</summary>
-
-```java
-// src/main/java/com/example/sms/domain/model/product/TaxCategory.java
-package com.example.sms.domain.model.product;
-
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-
-@Getter
-@RequiredArgsConstructor
-public enum TaxCategory {
-    EXCLUSIVE("外税"),
-    INCLUSIVE("内税"),
-    TAX_FREE("非課税");
-
-    private final String displayName;
-
-    public static TaxCategory fromDisplayName(String displayName) {
-        for (TaxCategory category : values()) {
-            if (category.displayName.equals(displayName)) {
-                return category;
-            }
-        }
-        throw new IllegalArgumentException("不正な税区分: " + displayName);
-    }
-}
-```
-
-</details>
-
-### 顧客別販売単価の設計
-
-特定の顧客に対して、標準単価とは異なる販売単価を設定できる仕組みです。
-
-<details>
-<summary>SQL 実装</summary>
-
-```sql
--- src/main/resources/db/migration/V005__create_customer_price.sql
-
--- 顧客別販売単価
-CREATE TABLE "顧客別販売単価" (
-    "商品コード" VARCHAR(20) NOT NULL REFERENCES "商品マスタ"("商品コード"),
-    "取引先コード" VARCHAR(20) NOT NULL,
-    "適用開始日" DATE NOT NULL,
-    "適用終了日" DATE,
-    "販売単価" DECIMAL(15, 2) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50),
-    PRIMARY KEY ("商品コード", "取引先コード", "適用開始日")
-);
-```
-
-</details>
-
----
-
-## 5.4 原価管理の設計
-
-商品の原価を計算する方法には8種類あります。
-
-### 8種類の原価法
-
-| 原価法 | 説明 |
-|-------|------|
-| **個別原価法** | 個々の商品ごとに原価を管理 |
-| **先入先出法** | 最も古い在庫から順に払い出す |
-| **後入先出法** | 最も新しい在庫から順に払い出す |
-| **総平均法** | 期間全体の平均原価を使用 |
-| **移動平均法** | 仕入れのたびに平均原価を再計算 |
-| **単純平均法** | 単純に平均値を使用 |
-| **最終仕入原価法** | 最後に仕入れた原価を使用 |
-| **売価還元法** | 売価から逆算して原価を算出 |
-
-### 原価法の選択基準
-
-```plantuml
-@startuml
-
-title 原価法の選択フロー
-
-start
-
-if (商品の個別管理が必要？) then (yes)
-  :個別原価法;
-  stop
-else (no)
-endif
-
-if (期中の原価変動が大きい？) then (yes)
-  if (リアルタイム管理が必要？) then (yes)
-    :移動平均法;
-  else (no)
-    :総平均法;
-  endif
-  stop
-else (no)
-endif
-
-if (簡便な管理でよい？) then (yes)
-  :最終仕入原価法;
-  stop
-else (no)
-  :先入先出法;
-  stop
-endif
-
-@enduml
-```
-
-本システムでは**移動平均法**を採用し、仕入れのたびに平均原価を再計算します。
-
----
-
-## 5.5 消費税の設計
-
-### 税区分の考え方
-
-| 税区分 | 説明 | 計算方法 |
-|-------|------|---------|
-| **外税** | 税抜価格で管理 | 価格 × 税率 = 消費税額 |
-| **内税** | 税込価格で管理 | 価格 × 税率 ÷ (1 + 税率) = 消費税額 |
-| **非課税** | 消費税対象外 | 消費税額 = 0 |
-
-### 消費税計算の実装
-
-<details>
-<summary>TaxCalculator.java</summary>
-
-```java
-// src/main/java/com/example/sms/domain/type/TaxCalculator.java
-package com.example.sms.domain.type;
-
-import com.example.sms.domain.model.product.TaxCategory;
-import lombok.RequiredArgsConstructor;
-import java.math.BigDecimal;
-import java.math.RoundingMode;
-
-@RequiredArgsConstructor
-public class TaxCalculator {
-
-    private final BigDecimal taxRate;
-
-    /**
-     * 消費税額を計算する
-     */
-    public BigDecimal calculateTax(BigDecimal price, TaxCategory taxCategory) {
-        return switch (taxCategory) {
-            case EXCLUSIVE -> price.multiply(taxRate)
-                    .setScale(0, RoundingMode.DOWN);
-            case INCLUSIVE -> price.multiply(taxRate)
-                    .divide(BigDecimal.ONE.add(taxRate), 0, RoundingMode.DOWN);
-            case TAX_FREE -> BigDecimal.ZERO;
-        };
-    }
-
-    /**
-     * 税込金額を計算する
-     */
-    public BigDecimal calculateTaxIncludedPrice(BigDecimal price, TaxCategory taxCategory) {
-        return switch (taxCategory) {
-            case EXCLUSIVE -> price.add(calculateTax(price, taxCategory));
-            case INCLUSIVE -> price;
-            case TAX_FREE -> price;
-        };
-    }
-}
-```
-
-</details>
-
----
-
-## 5.6 顧客マスタの設計
-
-顧客と仕入先を統合管理する取引先マスタを設計します。
-
-### 取引先マスタの構造
-
-```plantuml
-@startuml
-left to right direction
-
-entity 取引先マスタ {
-  取引先コード <<PK>>
-  --
-  取引先名
-  取引先カナ
-  顧客区分
-  仕入先区分
-  郵便番号
-  住所1
-  住所2
-  取引先分類コード
-  取引禁止フラグ
-  雑区分
-  取引先グループコード
-  与信限度額
-  与信一時増加枠
-  更新日時
-  更新者名
-}
-
-entity 顧客マスタ {
-  顧客コード(FK) <<PK>>
-  顧客枝番 <<PK>>
-  --
-  顧客区分
-  請求先コード
-  請求先枝番
-  回収先コード
-  回収先枝番
-  顧客名
-  顧客名カナ
-  自社担当者コード
-  顧客担当者名
-  顧客請求区分
-  顧客締日1
-  顧客支払月1
-  顧客支払日1
-  顧客支払方法1
-  ...
-}
-
-entity 仕入先マスタ {
-  仕入先コード(FK) <<PK>>
-  仕入先枝番 <<PK>>
-  --
-  仕入先担当者名
-  部門名
-  電話番号
-  FAX番号
-  メールアドレス
-  ...
-}
-
-entity 出荷先マスタ {
-  取引先コード(FK)
-  顧客枝番(FK)
-  出荷先番号 <<PK>>
-  --
-  出荷先名
-  地域コード
-  出荷先郵便番号
-  出荷先住所1
-  出荷先住所2
-  ...
-}
-
-取引先マスタ ||--o| 顧客マスタ
-取引先マスタ ||--o| 仕入先マスタ
-顧客マスタ ||--o{ 出荷先マスタ
-
-@enduml
-```
-
-### 請求先・回収先の概念
-
-顧客マスタでは、実際に商品を購入する顧客と、請求書を送付する先（請求先）、代金を回収する先（回収先）を分けて管理できます。
-
-```plantuml
-@startuml
-
-title 請求先・回収先の関係
-
-actor "購入者\n（A支店）" as buyer
-actor "請求先\n（本社経理部）" as billing
-actor "回収先\n（本社財務部）" as collection
-
-buyer -right-> billing : 請求書送付先
-billing -right-> collection : 代金支払元
-
-note bottom of buyer
-  顧客コード: C001
-  顧客枝番: 01
-  請求先コード: C001
-  請求先枝番: 00
-end note
-
-note bottom of billing
-  顧客コード: C001
-  顧客枝番: 00
-  （本社）
-end note
-
-@enduml
-```
-
-### マイグレーション：取引先関連テーブルの作成
-
-<details>
-<summary>SQL 実装</summary>
-
-```sql
--- src/main/resources/db/migration/V006__create_partner_master.sql
-
--- 請求区分 ENUM
-CREATE TYPE 請求区分 AS ENUM ('都度', '締め');
-
--- 支払方法 ENUM
-CREATE TYPE 支払方法 AS ENUM ('現金', '振込', '手形', '小切手', 'その他');
-
--- 取引先グループマスタ
-CREATE TABLE "取引先グループマスタ" (
-    "取引先グループコード" VARCHAR(10) PRIMARY KEY,
-    "取引先グループ名" VARCHAR(50) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50)
-);
-
--- 取引先マスタ
-CREATE TABLE "取引先マスタ" (
-    "取引先コード" VARCHAR(20) PRIMARY KEY,
-    "取引先名" VARCHAR(100) NOT NULL,
-    "取引先カナ" VARCHAR(200),
-    "顧客区分" BOOLEAN DEFAULT FALSE,
-    "仕入先区分" BOOLEAN DEFAULT FALSE,
-    "郵便番号" VARCHAR(10),
-    "住所1" VARCHAR(100),
-    "住所2" VARCHAR(100),
-    "取引先分類コード" VARCHAR(10),
-    "取引禁止フラグ" BOOLEAN DEFAULT FALSE,
-    "雑区分" BOOLEAN DEFAULT FALSE,
-    "取引先グループコード" VARCHAR(10) REFERENCES "取引先グループマスタ"("取引先グループコード"),
-    "与信限度額" DECIMAL(15, 2) DEFAULT 0,
-    "与信一時増加枠" DECIMAL(15, 2) DEFAULT 0,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50)
-);
-
--- 顧客マスタ
-CREATE TABLE "顧客マスタ" (
-    "顧客コード" VARCHAR(20) NOT NULL REFERENCES "取引先マスタ"("取引先コード"),
-    "顧客枝番" VARCHAR(10) NOT NULL DEFAULT '00',
-    "顧客区分" VARCHAR(10),
-    "請求先コード" VARCHAR(20),
-    "請求先枝番" VARCHAR(10),
-    "回収先コード" VARCHAR(20),
-    "回収先枝番" VARCHAR(10),
-    "顧客名" VARCHAR(100),
-    "顧客名カナ" VARCHAR(200),
-    "自社担当者コード" VARCHAR(10),
-    "顧客担当者名" VARCHAR(50),
-    "顧客部門名" VARCHAR(50),
-    "顧客郵便番号" VARCHAR(10),
-    "顧客都道府県" VARCHAR(10),
-    "顧客住所1" VARCHAR(100),
-    "顧客住所2" VARCHAR(100),
-    "顧客電話番号" VARCHAR(20),
-    "顧客FAX番号" VARCHAR(20),
-    "顧客メールアドレス" VARCHAR(100),
-    "顧客請求区分" 請求区分 DEFAULT '締め',
-    "顧客締日1" INTEGER,
-    "顧客支払月1" INTEGER,
-    "顧客支払日1" INTEGER,
-    "顧客支払方法1" 支払方法,
-    "顧客締日2" INTEGER,
-    "顧客支払月2" INTEGER,
-    "顧客支払日2" INTEGER,
-    "顧客支払方法2" 支払方法,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50),
-    PRIMARY KEY ("顧客コード", "顧客枝番")
-);
-
--- 仕入先マスタ
-CREATE TABLE "仕入先マスタ" (
-    "仕入先コード" VARCHAR(20) NOT NULL REFERENCES "取引先マスタ"("取引先コード"),
-    "仕入先枝番" VARCHAR(10) NOT NULL DEFAULT '00',
-    "仕入先担当者名" VARCHAR(50),
-    "部門名" VARCHAR(50),
-    "電話番号" VARCHAR(20),
-    "FAX番号" VARCHAR(20),
-    "メールアドレス" VARCHAR(100),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50),
-    PRIMARY KEY ("仕入先コード", "仕入先枝番")
-);
-
--- 地域マスタ
-CREATE TABLE "地域マスタ" (
-    "地域コード" VARCHAR(10) PRIMARY KEY,
-    "地域名" VARCHAR(50) NOT NULL,
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50)
-);
-
--- 出荷先マスタ
-CREATE TABLE "出荷先マスタ" (
-    "取引先コード" VARCHAR(20) NOT NULL,
-    "顧客枝番" VARCHAR(10) NOT NULL,
-    "出荷先番号" VARCHAR(10) NOT NULL,
-    "出荷先名" VARCHAR(100) NOT NULL,
-    "地域コード" VARCHAR(10) REFERENCES "地域マスタ"("地域コード"),
-    "出荷先郵便番号" VARCHAR(10),
-    "出荷先住所1" VARCHAR(100),
-    "出荷先住所2" VARCHAR(100),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "作成者名" VARCHAR(50),
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(50),
-    PRIMARY KEY ("取引先コード", "顧客枝番", "出荷先番号"),
-    FOREIGN KEY ("取引先コード", "顧客枝番") REFERENCES "顧客マスタ"("顧客コード", "顧客枝番")
-);
-
--- インデックス
-CREATE INDEX idx_取引先マスタ_取引先グループ ON "取引先マスタ"("取引先グループコード");
-CREATE INDEX idx_顧客マスタ_請求先 ON "顧客マスタ"("請求先コード", "請求先枝番");
-```
-
-</details>
-
-### エンティティ（ドメイン層）
-
-<details>
-<summary>Partner.java</summary>
-
-```java
-// src/main/java/com/example/sms/domain/model/partner/Partner.java
-package com.example.sms.domain.model.partner;
-
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Partner {
-    private String partnerCode;
-    private String partnerName;
-    private String partnerNameKana;
-    @Builder.Default
-    private boolean isCustomer = false;
-    @Builder.Default
-    private boolean isSupplier = false;
-    private String postalCode;
-    private String address1;
-    private String address2;
-    private String classificationCode;
-    @Builder.Default
-    private boolean isTradingProhibited = false;
-    @Builder.Default
-    private boolean isMiscellaneous = false;
-    private String groupCode;
-    @Builder.Default
-    private BigDecimal creditLimit = BigDecimal.ZERO;
-    @Builder.Default
-    private BigDecimal temporaryCreditIncrease = BigDecimal.ZERO;
-    private LocalDateTime createdAt;
-    private String createdBy;
-    private LocalDateTime updatedAt;
-    private String updatedBy;
-}
-```
-
-</details>
-
----
-
-## 5.7 取引条件の設計
-
-顧客との取引条件（締日・支払日など）を管理します。
-
-### 締日・支払月・支払日の管理
-
-| 項目 | 説明 | 例 |
-|-----|------|-----|
-| **締日** | 請求の締め日 | 20日、末日 |
-| **支払月** | 締め月から何ヶ月後か | 0（当月）、1（翌月） |
-| **支払日** | 支払日 | 10日、25日、末日 |
-
-### 都度請求と締め請求
-
-| 請求区分 | 説明 |
-|---------|------|
-| **都度請求** | 取引のたびに請求書を発行 |
-| **締め請求** | 締日でまとめて請求書を発行 |
-
-### 与信管理
-
-```plantuml
-@startuml
-
-title 与信チェックフロー
-
-start
-
-:受注登録;
-
-:売掛残高を取得;
-:受注済残高を取得;
-:今回受注金額を加算;
-
-:与信限度額を取得;
-:一時増加枠を取得;
-
-if (売掛残高 + 受注済残高 + 今回受注 > 与信限度額 + 一時増加枠) then (yes)
-  :与信オーバー警告;
-  if (強制登録？) then (yes)
-    :受注登録（警告付き）;
-  else (no)
-    :受注キャンセル;
-    stop
-  endif
-else (no)
-endif
-
-:受注確定;
-
-stop
-
-@enduml
-```
-
-### 請求区分・支払方法の Enum
-
-<details>
-<summary>BillingType.java</summary>
-
-```java
-// src/main/java/com/example/sms/domain/model/partner/BillingType.java
-package com.example.sms.domain.model.partner;
-
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-
-@Getter
-@RequiredArgsConstructor
-public enum BillingType {
-    ON_DEMAND("都度"),
-    PERIODIC("締め");
-
-    private final String displayName;
-
-    public static BillingType fromDisplayName(String displayName) {
-        for (BillingType type : values()) {
-            if (type.displayName.equals(displayName)) {
-                return type;
-            }
-        }
-        throw new IllegalArgumentException("不正な請求区分: " + displayName);
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>PaymentMethod.java</summary>
-
-```java
-// src/main/java/com/example/sms/domain/model/partner/PaymentMethod.java
-package com.example.sms.domain.model.partner;
-
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-
-@Getter
-@RequiredArgsConstructor
-public enum PaymentMethod {
-    CASH("現金"),
-    TRANSFER("振込"),
-    BILL("手形"),
-    CHECK("小切手"),
-    OTHER("その他");
-
-    private final String displayName;
-
-    public static PaymentMethod fromDisplayName(String displayName) {
-        for (PaymentMethod method : values()) {
-            if (method.displayName.equals(displayName)) {
-                return method;
-            }
-        }
-        throw new IllegalArgumentException("不正な支払方法: " + displayName);
-    }
-}
-```
-
-</details>
-
----
-
-## 第5章のまとめ
-
-### 作成したテーブル
-
-| テーブル名 | 説明 |
-|-----------|------|
-| `部門マスタ` | 組織階層を管理する部門情報 |
-| `社員マスタ` | 部門に所属する社員情報 |
-| `商品分類マスタ` | 商品の分類階層 |
-| `商品マスタ` | 販売商品の情報 |
-| `顧客別販売単価` | 顧客ごとの特別単価 |
-| `取引先グループマスタ` | 取引先のグループ |
-| `取引先マスタ` | 顧客・仕入先の統合情報 |
-| `顧客マスタ` | 顧客固有情報 |
-| `仕入先マスタ` | 仕入先固有情報 |
-| `地域マスタ` | 地域情報 |
-| `出荷先マスタ` | 顧客の出荷先情報 |
-
-### ER 図（第5章完了時点）
-
-```plantuml
-@startuml
-
-title マスタ情報 ER図
-
-entity 部門マスタ {
-  部門コード <<PK>>
-  開始日 <<PK>>
-  --
-  終了日
-  部門名
-  組織階層
-  部門パス
-  最下層区分
-}
-
-entity 社員マスタ {
-  社員コード <<PK>>
-  --
-  社員名
-  社員名カナ
-  部門コード <<FK>>
-  開始日 <<FK>>
-}
-
-entity 商品分類マスタ {
-  商品分類コード <<PK>>
-  --
-  商品分類名
-  商品分類階層
-  商品分類パス
-  最下層区分
-}
-
-entity 商品マスタ {
-  商品コード <<PK>>
-  --
-  商品正式名
-  商品名
-  商品名カナ
-  商品区分
-  販売単価
-  仕入単価
-  税区分
-  商品分類コード <<FK>>
-  ...
-}
-
-entity 顧客別販売単価 {
-  商品コード <<PK,FK>>
-  取引先コード <<PK>>
-  適用開始日 <<PK>>
-  --
-  適用終了日
-  販売単価
-}
-
-entity 取引先マスタ {
-  取引先コード <<PK>>
-  --
-  取引先名
-  顧客区分
-  仕入先区分
-  与信限度額
-  ...
-}
-
-entity 顧客マスタ {
-  顧客コード <<PK,FK>>
-  顧客枝番 <<PK>>
-  --
-  請求先コード
-  顧客請求区分
-  顧客締日1
-  ...
-}
-
-entity 仕入先マスタ {
-  仕入先コード <<PK,FK>>
-  仕入先枝番 <<PK>>
-  --
-  仕入先担当者名
-  ...
-}
-
-entity 出荷先マスタ {
-  取引先コード <<PK,FK>>
-  顧客枝番 <<PK,FK>>
-  出荷先番号 <<PK>>
-  --
-  出荷先名
-  地域コード <<FK>>
-  ...
-}
-
-部門マスタ ||--o{ 社員マスタ
-商品分類マスタ ||--o{ 商品マスタ
-商品マスタ ||--o{ 顧客別販売単価
-取引先マスタ ||--o| 顧客マスタ
-取引先マスタ ||--o| 仕入先マスタ
-顧客マスタ ||--o{ 出荷先マスタ
-
-@enduml
-```
-
-### 設計のポイント
-
-1. **組織階層管理**: 部門マスタは `部門パス` で階層構造を表現
-2. **履歴管理**: 部門マスタは `開始日` による世代管理を採用
-3. **統合マスタ**: 取引先マスタで顧客・仕入先を統合管理
-4. **日本語 DB / 英語 Java**: テーブル・カラムは日本語、Java コードは英語で統一
-5. **PostgreSQL ENUM**: 区分値は日本語 ENUM 型で型安全性を確保
-6. **与信管理**: 与信限度額と一時増加枠で柔軟な与信管理を実現
-
----
-
-## 次章の予告
-
-第6章では、受注・出荷・売上の設計に進みます。販売管理の中核となる業務フローを TDD で実装していきます。
-
----
-
-[← 第4章：販売管理システムのアーキテクチャ](./chapter04.md) | [第6章：受注・出荷・売上の設計 →](./chapter06.md)
+# 第5章：マスタ情報の設計
+
+販売管理システムの基盤となるマスタ情報を TDD で設計していきます。本章では、組織・社員・商品・取引先といった基本的なマスタテーブルの設計と実装を行います。
+
+## 5.1 部門マスタの設計
+
+企業の組織構造を管理する部門マスタを設計します。
+
+### 組織階層の概念
+
+企業の組織は階層構造を持っています。部門マスタでは、この階層構造を「部門パス」で表現します。
+
+```plantuml
+@startwbs
+
+* 全社 : 10000
+** 営業本部 : 11000
+*** 東日本営業部 : 11100
+**** 営業1課 : 11101
+**** 営業2課 : 11102
+*** 西日本営業部 : 11200
+**** 営業3課 : 11201
+**** 営業4課 : 11202
+** 管理本部 : 12000
+*** 総務部 : 12100
+**** 庶務課 : 12101
+**** 人事課 : 12102
+*** 経理部 : 12200
+**** 経理課 : 12201
+**** 財務課 : 12202
+
+@endwbs
+```
+
+### 部門マスタの ER 図
+
+```plantuml
+@startuml
+
+title 部門マスタ
+
+entity 部門マスタ {
+  部門コード <<PK>>
+  開始日 <<PK>>
+  --
+  終了日
+  部門名
+  組織階層
+  部門パス
+  最下層区分
+  作成日時
+  作成者名
+  更新日時
+  更新者名
+}
+
+note right of 部門マスタ
+  部門パスの例：
+  10000~11000~11100
+  （チルダで連結）
+end note
+
+@enduml
+```
+
+### 部門マスタの項目説明
+
+| 項目 | 説明 | 例 |
+|-----|------|-----|
+| **部門コード** | 部門を一意に識別するコード | `11101` |
+| **開始日** | 部門の有効期間開始日 | `2025-01-01` |
+| **終了日** | 部門の有効期間終了日 | `null`（有効） |
+| **部門名** | 部門の名称 | `営業1課` |
+| **組織階層** | 階層の深さ（0から開始） | `3` |
+| **部門パス** | ルートからのパス（チルダ連結） | `10000~11000~11100~11101` |
+| **最下層区分** | 最下層（末端）かどうか | `true` |
+
+### 組織改正への対応（履歴管理）
+
+組織改正が発生した場合、同じ部門コードでも開始日が異なるレコードを登録することで、組織の変遷を管理できます。
+
+```plantuml
+@startuml
+
+title 組織改正の履歴管理
+
+entity "部門マスタ（2024年度）" as dept2024 {
+  部門コード: 11000
+  開始日: 2024-01-01
+  終了日: 2024-12-31
+  --
+  部門名: 営業部
+  組織階層: 1
+  部門パス: 10000~11000
+}
+
+entity "部門マスタ（2025年度）" as dept2025 {
+  部門コード: 11000
+  開始日: 2025-01-01
+  終了日: null
+  --
+  部門名: 営業本部
+  組織階層: 1
+  部門パス: 10000~11000
+}
+
+dept2024 -[hidden]- dept2025
+
+note bottom of dept2025
+  同じ部門コードでも
+  開始日が異なれば
+  別レコードとして登録可能
+end note
+
+@enduml
+```
+
+### マイグレーション：部門マスタテーブルの作成
+
+<details>
+<summary>SQL 実装</summary>
+
+```sql
+-- src/main/resources/db/migration/V002__create_department_master.sql
+
+-- 部門マスタ（日本語テーブル名・カラム名）
+CREATE TABLE "部門マスタ" (
+    "部門コード" VARCHAR(10) NOT NULL,
+    "開始日" DATE NOT NULL,
+    "終了日" DATE,
+    "部門名" VARCHAR(40) NOT NULL,
+    "組織階層" INTEGER NOT NULL DEFAULT 0,
+    "部門パス" VARCHAR(100),
+    "最下層区分" BOOLEAN NOT NULL DEFAULT FALSE,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50),
+    PRIMARY KEY ("部門コード", "開始日")
+);
+
+-- インデックス
+CREATE INDEX idx_部門マスタ_部門パス ON "部門マスタ"("部門パス");
+CREATE INDEX idx_部門マスタ_組織階層 ON "部門マスタ"("組織階層");
+```
+
+</details>
+
+### TDD：部門の登録と取得
+
+#### Red: 失敗するテストを書く
+
+<details>
+<summary>DepartmentRepositoryTest.java</summary>
+
+```java
+// src/test/java/com/example/sms/infrastructure/persistence/repository/DepartmentRepositoryTest.java
+package com.example.sms.infrastructure.persistence.repository;
+
+import com.example.sms.application.port.out.DepartmentRepository;
+import com.example.sms.domain.model.department.Department;
+import com.example.sms.testsetup.BaseIntegrationTest;
+import org.junit.jupiter.api.*;
+import org.springframework.beans.factory.annotation.Autowired;
+
+import java.time.LocalDate;
+
+import static org.assertj.core.api.Assertions.*;
+
+@DisplayName("部門リポジトリ")
+class DepartmentRepositoryTest extends BaseIntegrationTest {
+
+    @Autowired
+    private DepartmentRepository departmentRepository;
+
+    @BeforeEach
+    void setUp() {
+        departmentRepository.deleteAll();
+    }
+
+    @Nested
+    @DisplayName("登録")
+    class Registration {
+
+        @Test
+        @DisplayName("部門を登録できる")
+        void canRegisterDepartment() {
+            // Arrange
+            var department = Department.builder()
+                    .departmentCode("10000")
+                    .startDate(LocalDate.of(2025, 1, 1))
+                    .departmentName("本社")
+                    .hierarchyLevel(0)
+                    .departmentPath("10000")
+                    .isLeaf(false)
+                    .build();
+
+            // Act
+            departmentRepository.save(department);
+
+            // Assert
+            var result = departmentRepository.findByCode("10000");
+            assertThat(result).isPresent();
+            assertThat(result.get().getDepartmentName()).isEqualTo("本社");
+            assertThat(result.get().getHierarchyLevel()).isEqualTo(0);
+        }
+
+        @Test
+        @DisplayName("階層構造を持つ部門を登録できる")
+        void canRegisterHierarchicalDepartments() {
+            // Arrange: 親部門
+            var parent = Department.builder()
+                    .departmentCode("10000")
+                    .startDate(LocalDate.of(2025, 1, 1))
+                    .departmentName("本社")
+                    .hierarchyLevel(0)
+                    .departmentPath("10000")
+                    .isLeaf(false)
+                    .build();
+            departmentRepository.save(parent);
+
+            // Arrange: 子部門
+            var child = Department.builder()
+                    .departmentCode("11000")
+                    .startDate(LocalDate.of(2025, 1, 1))
+                    .departmentName("営業本部")
+                    .hierarchyLevel(1)
+                    .departmentPath("10000~11000")
+                    .isLeaf(false)
+                    .build();
+            departmentRepository.save(child);
+
+            // Arrange: 孫部門（最下層）
+            var grandChild = Department.builder()
+                    .departmentCode("11101")
+                    .startDate(LocalDate.of(2025, 1, 1))
+                    .departmentName("営業1課")
+                    .hierarchyLevel(3)
+                    .departmentPath("10000~11000~11100~11101")
+                    .isLeaf(true)
+                    .build();
+            departmentRepository.save(grandChild);
+
+            // Act
+            var result = departmentRepository.findByCode("11101");
+
+            // Assert
+            assertThat(result).isPresent();
+            assertThat(result.get().getDepartmentPath()).isEqualTo("10000~11000~11100~11101");
+            assertThat(result.get().isLeaf()).isTrue();
+        }
+    }
+
+    @Nested
+    @DisplayName("履歴管理")
+    class HistoryManagement {
+
+        @Test
+        @DisplayName("同じ部門コードでも開始日が異なれば登録できる（組織改正対応）")
+        void canRegisterSameCodeWithDifferentStartDate() {
+            // Arrange: 旧組織
+            var oldDept = Department.builder()
+                    .departmentCode("11000")
+                    .startDate(LocalDate.of(2024, 1, 1))
+                    .endDate(LocalDate.of(2024, 12, 31))
+                    .departmentName("営業部")
+                    .hierarchyLevel(1)
+                    .departmentPath("10000~11000")
+                    .isLeaf(false)
+                    .build();
+            departmentRepository.save(oldDept);
+
+            // Arrange: 新組織
+            var newDept = Department.builder()
+                    .departmentCode("11000")
+                    .startDate(LocalDate.of(2025, 1, 1))
+                    .departmentName("営業本部")
+                    .hierarchyLevel(1)
+                    .departmentPath("10000~11000")
+                    .isLeaf(false)
+                    .build();
+            departmentRepository.save(newDept);
+
+            // Act: 現在有効な部門を取得
+            var result = departmentRepository.findByCodeAndDate("11000", LocalDate.of(2025, 4, 1));
+
+            // Assert
+            assertThat(result).isPresent();
+            assertThat(result.get().getDepartmentName()).isEqualTo("営業本部");
+        }
+    }
+}
+```
+
+</details>
+
+#### Green: テストを通す実装
+
+<details>
+<summary>Department.java（エンティティ）</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/department/Department.java
+package com.example.sms.domain.model.department;
+
+import lombok.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Department {
+    private String departmentCode;
+    private LocalDate startDate;
+    private LocalDate endDate;
+    private String departmentName;
+    @Builder.Default
+    private Integer hierarchyLevel = 0;
+    private String departmentPath;
+    @Builder.Default
+    private boolean isLeaf = false;
+    private LocalDateTime createdAt;
+    private String createdBy;
+    private LocalDateTime updatedAt;
+    private String updatedBy;
+}
+```
+
+</details>
+
+<details>
+<summary>DepartmentRepository.java（Output Port）</summary>
+
+```java
+// src/main/java/com/example/sms/application/port/out/DepartmentRepository.java
+package com.example.sms.application.port.out;
+
+import com.example.sms.domain.model.department.Department;
+
+import java.time.LocalDate;
+import java.util.List;
+import java.util.Optional;
+
+/**
+ * 部門リポジトリ（Output Port）
+ */
+public interface DepartmentRepository {
+
+    void save(Department department);
+
+    Optional<Department> findByCode(String departmentCode);
+
+    Optional<Department> findByCodeAndDate(String departmentCode, LocalDate baseDate);
+
+    List<Department> findAll();
+
+    List<Department> findByHierarchyLevel(int level);
+
+    List<Department> findChildren(String parentPath);
+
+    void update(Department department);
+
+    void deleteAll();
+}
+```
+
+</details>
+
+<details>
+<summary>DepartmentMapper.xml</summary>
+
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.example.sms.infrastructure.persistence.mapper.DepartmentMapper">
+
+    <resultMap id="DepartmentResultMap" type="com.example.sms.domain.model.department.Department">
+        <result property="departmentCode" column="部門コード"/>
+        <result property="startDate" column="開始日"/>
+        <result property="endDate" column="終了日"/>
+        <result property="departmentName" column="部門名"/>
+        <result property="hierarchyLevel" column="組織階層"/>
+        <result property="departmentPath" column="部門パス"/>
+        <result property="isLeaf" column="最下層区分"/>
+        <result property="createdAt" column="作成日時"/>
+        <result property="createdBy" column="作成者名"/>
+        <result property="updatedAt" column="更新日時"/>
+        <result property="updatedBy" column="更新者名"/>
+    </resultMap>
+
+    <insert id="insert" parameterType="com.example.sms.domain.model.department.Department">
+        INSERT INTO "部門マスタ" (
+            "部門コード", "開始日", "終了日", "部門名",
+            "組織階層", "部門パス", "最下層区分",
+            "作成日時", "作成者名", "更新日時", "更新者名"
+        ) VALUES (
+            #{departmentCode}, #{startDate}, #{endDate}, #{departmentName},
+            #{hierarchyLevel}, #{departmentPath}, #{isLeaf},
+            CURRENT_TIMESTAMP, #{createdBy}, CURRENT_TIMESTAMP, #{updatedBy}
+        )
+    </insert>
+
+    <select id="findByCode" resultMap="DepartmentResultMap">
+        SELECT * FROM "部門マスタ"
+        WHERE "部門コード" = #{departmentCode}
+          AND ("終了日" IS NULL OR "終了日" > CURRENT_DATE)
+        ORDER BY "開始日" DESC
+        LIMIT 1
+    </select>
+
+    <select id="findByCodeAndDate" resultMap="DepartmentResultMap">
+        SELECT * FROM "部門マスタ"
+        WHERE "部門コード" = #{departmentCode}
+          AND "開始日" &lt;= #{baseDate}
+          AND ("終了日" IS NULL OR "終了日" > #{baseDate})
+        ORDER BY "開始日" DESC
+        LIMIT 1
+    </select>
+
+    <delete id="deleteAll">
+        TRUNCATE TABLE "部門マスタ" CASCADE
+    </delete>
+</mapper>
+```
+
+</details>
+
+---
+
+## 5.2 社員マスタの設計
+
+部門に所属する社員を管理するマスタを設計します。
+
+### 社員マスタの ER 図
+
+```plantuml
+@startuml
+
+title 社員マスタ
+
+entity 社員マスタ {
+  社員コード <<PK>>
+  --
+  社員名
+  社員名カナ
+  部門コード <<FK>>
+  開始日 <<FK>>
+  作成日時
+  作成者名
+  更新日時
+  更新者名
+}
+
+entity 部門マスタ {
+  部門コード <<PK>>
+  開始日 <<PK>>
+  --
+  ...
+}
+
+社員マスタ }o--|| 部門マスタ
+
+@enduml
+```
+
+### マイグレーション：社員マスタテーブルの作成
+
+<details>
+<summary>SQL 実装</summary>
+
+```sql
+-- src/main/resources/db/migration/V003__create_employee_master.sql
+
+-- 社員マスタ
+CREATE TABLE "社員マスタ" (
+    "社員コード" VARCHAR(10) PRIMARY KEY,
+    "社員名" VARCHAR(20) NOT NULL,
+    "社員名カナ" VARCHAR(40),
+    "部門コード" VARCHAR(10),
+    "開始日" DATE,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50),
+    FOREIGN KEY ("部門コード", "開始日") REFERENCES "部門マスタ"("部門コード", "開始日")
+);
+
+CREATE INDEX idx_社員マスタ_部門コード ON "社員マスタ"("部門コード");
+```
+
+</details>
+
+### エンティティ（ドメイン層）
+
+<details>
+<summary>Employee.java</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/employee/Employee.java
+package com.example.sms.domain.model.employee;
+
+import lombok.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Employee {
+    private String employeeCode;
+    private String employeeName;
+    private String employeeNameKana;
+    private String departmentCode;
+    private LocalDate departmentStartDate;
+    private LocalDateTime createdAt;
+    private String createdBy;
+    private LocalDateTime updatedAt;
+    private String updatedBy;
+}
+```
+
+</details>
+
+---
+
+## 5.3 商品マスタの設計
+
+販売管理システムで扱う「商品」の情報を管理するマスタを設計します。
+
+### 商品マスタの構造
+
+```plantuml
+@startuml
+!define TABLE(x) entity x << (T,#FFAAAA) >>
+
+skinparam linetype ortho
+left to right direction
+
+TABLE(顧客別販売単価) {
+  商品コード (FK)
+  取引先コード (FK)
+  --
+  販売単価
+  作成日時
+  作成者名
+  更新日時
+  更新者名
+}
+
+TABLE(商品マスタ) {
+  商品コード
+  --
+  商品正式名
+  商品名
+  商品名カナ
+  商品区分
+  製品型番
+  販売単価
+  仕入単価
+  税区分
+  商品分類コード (FK)
+  雑区分
+  在庫管理対象区分
+  在庫引当区分
+  仕入先コード (FK)
+  作成日時
+  作成者名
+  更新日時
+  更新者名
+}
+
+TABLE(商品分類マスタ) {
+  商品分類コード
+  --
+  商品分類名
+  商品分類階層
+  商品分類パス
+  最下層区分
+  作成日時
+  作成者名
+  更新日時
+  更新者名
+}
+
+顧客別販売単価 }o--|| 商品マスタ
+商品マスタ }o..|| 商品分類マスタ
+
+@enduml
+```
+
+### 商品区分と税区分
+
+商品には「商品区分」と「税区分」という2つの区分があります。
+
+#### 商品区分
+
+| 区分値 | 説明 |
+|-------|------|
+| 商品 | 仕入れて販売する商品 |
+| 製品 | 自社で製造した製品 |
+| サービス | 無形のサービス |
+| 諸口 | その他の一時的な商品 |
+
+#### 税区分
+
+| 区分値 | 説明 |
+|-------|------|
+| 外税 | 税抜価格で管理し、別途消費税を計算 |
+| 内税 | 税込価格で管理 |
+| 非課税 | 消費税対象外 |
+
+### マイグレーション：商品マスタテーブルの作成
+
+<details>
+<summary>SQL 実装</summary>
+
+```sql
+-- src/main/resources/db/migration/V004__create_product_master.sql
+
+-- 商品区分 ENUM
+CREATE TYPE 商品区分 AS ENUM ('商品', '製品', 'サービス', '諸口');
+
+-- 税区分 ENUM
+CREATE TYPE 税区分 AS ENUM ('外税', '内税', '非課税');
+
+-- 商品分類マスタ
+CREATE TABLE "商品分類マスタ" (
+    "商品分類コード" VARCHAR(10) PRIMARY KEY,
+    "商品分類名" VARCHAR(50) NOT NULL,
+    "商品分類階層" INTEGER NOT NULL DEFAULT 0,
+    "商品分類パス" VARCHAR(100),
+    "最下層区分" BOOLEAN NOT NULL DEFAULT FALSE,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50)
+);
+
+-- 商品マスタ
+CREATE TABLE "商品マスタ" (
+    "商品コード" VARCHAR(20) PRIMARY KEY,
+    "商品正式名" VARCHAR(200),
+    "商品名" VARCHAR(100) NOT NULL,
+    "商品名カナ" VARCHAR(200),
+    "商品区分" 商品区分 NOT NULL DEFAULT '商品',
+    "製品型番" VARCHAR(50),
+    "販売単価" DECIMAL(15, 2) DEFAULT 0,
+    "仕入単価" DECIMAL(15, 2) DEFAULT 0,
+    "税区分" 税区分 NOT NULL DEFAULT '外税',
+    "商品分類コード" VARCHAR(10) REFERENCES "商品分類マスタ"("商品分類コード"),
+    "雑区分" BOOLEAN DEFAULT FALSE,
+    "在庫管理対象区分" BOOLEAN DEFAULT TRUE,
+    "在庫引当区分" BOOLEAN DEFAULT TRUE,
+    "仕入先コード" VARCHAR(20),
+    "仕入先枝番" VARCHAR(10),
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50)
+);
+
+-- インデックス
+CREATE INDEX idx_商品マスタ_商品区分 ON "商品マスタ"("商品区分");
+CREATE INDEX idx_商品マスタ_商品分類コード ON "商品マスタ"("商品分類コード");
+CREATE INDEX idx_商品分類マスタ_商品分類パス ON "商品分類マスタ"("商品分類パス");
+```
+
+</details>
+
+### TDD：商品の登録と取得
+
+#### Red: 失敗するテストを書く
+
+<details>
+<summary>ProductRepositoryTest.java</summary>
+
+```java
+// src/test/java/com/example/sms/infrastructure/persistence/repository/ProductRepositoryTest.java
+package com.example.sms.infrastructure.persistence.repository;
+
+import com.example.sms.application.port.out.ProductRepository;
+import com.example.sms.domain.model.product.Product;
+import com.example.sms.domain.model.product.ProductCategory;
+import com.example.sms.domain.model.product.TaxCategory;
+import com.example.sms.testsetup.BaseIntegrationTest;
+import org.junit.jupiter.api.*;
+import org.springframework.beans.factory.annotation.Autowired;
+
+import java.math.BigDecimal;
+
+import static org.assertj.core.api.Assertions.*;
+
+@DisplayName("商品リポジトリ")
+class ProductRepositoryTest extends BaseIntegrationTest {
+
+    @Autowired
+    private ProductRepository productRepository;
+
+    @BeforeEach
+    void setUp() {
+        productRepository.deleteAll();
+    }
+
+    @Nested
+    @DisplayName("登録")
+    class Registration {
+
+        @Test
+        @DisplayName("商品を登録できる")
+        void canRegisterProduct() {
+            // Arrange
+            var product = Product.builder()
+                    .productCode("PROD001")
+                    .productName("テスト商品")
+                    .productCategory(ProductCategory.PRODUCT)
+                    .sellingPrice(new BigDecimal("1000"))
+                    .purchasePrice(new BigDecimal("700"))
+                    .taxCategory(TaxCategory.EXCLUSIVE)
+                    .build();
+
+            // Act
+            productRepository.save(product);
+
+            // Assert
+            var result = productRepository.findByCode("PROD001");
+            assertThat(result).isPresent();
+            assertThat(result.get().getProductName()).isEqualTo("テスト商品");
+            assertThat(result.get().getSellingPrice()).isEqualByComparingTo(new BigDecimal("1000"));
+        }
+
+        @Test
+        @DisplayName("全ての商品区分を登録できる")
+        void canRegisterAllCategories() {
+            var categories = ProductCategory.values();
+
+            for (int i = 0; i < categories.length; i++) {
+                var product = Product.builder()
+                        .productCode("CAT-" + String.format("%03d", i))
+                        .productName("商品" + categories[i].getDisplayName())
+                        .productCategory(categories[i])
+                        .taxCategory(TaxCategory.EXCLUSIVE)
+                        .build();
+
+                productRepository.save(product);
+
+                var result = productRepository.findByCode(product.getProductCode());
+                assertThat(result).isPresent();
+                assertThat(result.get().getProductCategory()).isEqualTo(categories[i]);
+            }
+        }
+    }
+
+    @Nested
+    @DisplayName("税区分")
+    class TaxCategories {
+
+        @Test
+        @DisplayName("外税商品を登録できる")
+        void canRegisterExclusiveTax() {
+            var product = createProduct("TAX001", "外税商品", TaxCategory.EXCLUSIVE);
+            productRepository.save(product);
+
+            var result = productRepository.findByCode("TAX001");
+            assertThat(result.get().getTaxCategory()).isEqualTo(TaxCategory.EXCLUSIVE);
+        }
+
+        @Test
+        @DisplayName("内税商品を登録できる")
+        void canRegisterInclusiveTax() {
+            var product = createProduct("TAX002", "内税商品", TaxCategory.INCLUSIVE);
+            productRepository.save(product);
+
+            var result = productRepository.findByCode("TAX002");
+            assertThat(result.get().getTaxCategory()).isEqualTo(TaxCategory.INCLUSIVE);
+        }
+
+        @Test
+        @DisplayName("非課税商品を登録できる")
+        void canRegisterTaxFree() {
+            var product = createProduct("TAX003", "非課税商品", TaxCategory.TAX_FREE);
+            productRepository.save(product);
+
+            var result = productRepository.findByCode("TAX003");
+            assertThat(result.get().getTaxCategory()).isEqualTo(TaxCategory.TAX_FREE);
+        }
+    }
+
+    private Product createProduct(String code, String name, TaxCategory taxCategory) {
+        return Product.builder()
+                .productCode(code)
+                .productName(name)
+                .productCategory(ProductCategory.PRODUCT)
+                .taxCategory(taxCategory)
+                .build();
+    }
+}
+```
+
+</details>
+
+#### Green: テストを通す実装
+
+<details>
+<summary>Product.java（エンティティ）</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/product/Product.java
+package com.example.sms.domain.model.product;
+
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Product {
+    private String productCode;
+    private String productFullName;
+    private String productName;
+    private String productNameKana;
+    private ProductCategory productCategory;
+    private String modelNumber;
+    @Builder.Default
+    private BigDecimal sellingPrice = BigDecimal.ZERO;
+    @Builder.Default
+    private BigDecimal purchasePrice = BigDecimal.ZERO;
+    private TaxCategory taxCategory;
+    private String classificationCode;
+    @Builder.Default
+    private boolean isMiscellaneous = false;
+    @Builder.Default
+    private boolean isInventoryManaged = true;
+    @Builder.Default
+    private boolean isInventoryAllocated = true;
+    private String supplierCode;
+    private String supplierBranchNumber;
+    private LocalDateTime createdAt;
+    private String createdBy;
+    private LocalDateTime updatedAt;
+    private String updatedBy;
+}
+```
+
+</details>
+
+<details>
+<summary>ProductCategory.java（商品区分 Enum）</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/product/ProductCategory.java
+package com.example.sms.domain.model.product;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum ProductCategory {
+    PRODUCT("商品"),
+    MANUFACTURED("製品"),
+    SERVICE("サービス"),
+    MISCELLANEOUS("諸口");
+
+    private final String displayName;
+
+    public static ProductCategory fromDisplayName(String displayName) {
+        for (ProductCategory category : values()) {
+            if (category.displayName.equals(displayName)) {
+                return category;
+            }
+        }
+        throw new IllegalArgumentException("不正な商品区分: " + displayName);
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>TaxCategory.java（税区分 Enum）</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/product/TaxCategory.java
+package com.example.sms.domain.model.product;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum TaxCategory {
+    EXCLUSIVE("外税"),
+    INCLUSIVE("内税"),
+    TAX_FREE("非課税");
+
+    private final String displayName;
+
+    public static TaxCategory fromDisplayName(String displayName) {
+        for (TaxCategory category : values()) {
+            if (category.displayName.equals(displayName)) {
+                return category;
+            }
+        }
+        throw new IllegalArgumentException("不正な税区分: " + displayName);
+    }
+}
+```
+
+</details>
+
+### 顧客別販売単価の設計
+
+特定の顧客に対して、標準単価とは異なる販売単価を設定できる仕組みです。
+
+<details>
+<summary>SQL 実装</summary>
+
+```sql
+-- src/main/resources/db/migration/V005__create_customer_price.sql
+
+-- 顧客別販売単価
+CREATE TABLE "顧客別販売単価" (
+    "商品コード" VARCHAR(20) NOT NULL REFERENCES "商品マスタ"("商品コード"),
+    "取引先コード" VARCHAR(20) NOT NULL,
+    "適用開始日" DATE NOT NULL,
+    "適用終了日" DATE,
+    "販売単価" DECIMAL(15, 2) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50),
+    PRIMARY KEY ("商品コード", "取引先コード", "適用開始日")
+);
+```
+
+</details>
+
+---
+
+## 5.4 原価管理の設計
+
+商品の原価を計算する方法には8種類あります。
+
+### 8種類の原価法
+
+| 原価法 | 説明 |
+|-------|------|
+| **個別原価法** | 個々の商品ごとに原価を管理 |
+| **先入先出法** | 最も古い在庫から順に払い出す |
+| **後入先出法** | 最も新しい在庫から順に払い出す |
+| **総平均法** | 期間全体の平均原価を使用 |
+| **移動平均法** | 仕入れのたびに平均原価を再計算 |
+| **単純平均法** | 単純に平均値を使用 |
+| **最終仕入原価法** | 最後に仕入れた原価を使用 |
+| **売価還元法** | 売価から逆算して原価を算出 |
+
+### 原価法の選択基準
+
+```plantuml
+@startuml
+
+title 原価法の選択フロー
+
+start
+
+if (商品の個別管理が必要？) then (yes)
+  :個別原価法;
+  stop
+else (no)
+endif
+
+if (期中の原価変動が大きい？) then (yes)
+  if (リアルタイム管理が必要？) then (yes)
+    :移動平均法;
+  else (no)
+    :総平均法;
+  endif
+  stop
+else (no)
+endif
+
+if (簡便な管理でよい？) then (yes)
+  :最終仕入原価法;
+  stop
+else (no)
+  :先入先出法;
+  stop
+endif
+
+@enduml
+```
+
+本システムでは**移動平均法**を採用し、仕入れのたびに平均原価を再計算します。
+
+---
+
+## 5.5 消費税の設計
+
+### 税区分の考え方
+
+| 税区分 | 説明 | 計算方法 |
+|-------|------|---------|
+| **外税** | 税抜価格で管理 | 価格 × 税率 = 消費税額 |
+| **内税** | 税込価格で管理 | 価格 × 税率 ÷ (1 + 税率) = 消費税額 |
+| **非課税** | 消費税対象外 | 消費税額 = 0 |
+
+### 消費税計算の実装
+
+<details>
+<summary>TaxCalculator.java</summary>
+
+```java
+// src/main/java/com/example/sms/domain/type/TaxCalculator.java
+package com.example.sms.domain.type;
+
+import com.example.sms.domain.model.product.TaxCategory;
+import lombok.RequiredArgsConstructor;
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+
+@RequiredArgsConstructor
+public class TaxCalculator {
+
+    private final BigDecimal taxRate;
+
+    /**
+     * 消費税額を計算する
+     */
+    public BigDecimal calculateTax(BigDecimal price, TaxCategory taxCategory) {
+        return switch (taxCategory) {
+            case EXCLUSIVE -> price.multiply(taxRate)
+                    .setScale(0, RoundingMode.DOWN);
+            case INCLUSIVE -> price.multiply(taxRate)
+                    .divide(BigDecimal.ONE.add(taxRate), 0, RoundingMode.DOWN);
+            case TAX_FREE -> BigDecimal.ZERO;
+        };
+    }
+
+    /**
+     * 税込金額を計算する
+     */
+    public BigDecimal calculateTaxIncludedPrice(BigDecimal price, TaxCategory taxCategory) {
+        return switch (taxCategory) {
+            case EXCLUSIVE -> price.add(calculateTax(price, taxCategory));
+            case INCLUSIVE -> price;
+            case TAX_FREE -> price;
+        };
+    }
+}
+```
+
+</details>
+
+---
+
+## 5.6 顧客マスタの設計
+
+顧客と仕入先を統合管理する取引先マスタを設計します。
+
+### 取引先マスタの構造
+
+```plantuml
+@startuml
+left to right direction
+
+entity 取引先マスタ {
+  取引先コード <<PK>>
+  --
+  取引先名
+  取引先カナ
+  顧客区分
+  仕入先区分
+  郵便番号
+  住所1
+  住所2
+  取引先分類コード
+  取引禁止フラグ
+  雑区分
+  取引先グループコード
+  与信限度額
+  与信一時増加枠
+  更新日時
+  更新者名
+}
+
+entity 顧客マスタ {
+  顧客コード(FK) <<PK>>
+  顧客枝番 <<PK>>
+  --
+  顧客区分
+  請求先コード
+  請求先枝番
+  回収先コード
+  回収先枝番
+  顧客名
+  顧客名カナ
+  自社担当者コード
+  顧客担当者名
+  顧客請求区分
+  顧客締日1
+  顧客支払月1
+  顧客支払日1
+  顧客支払方法1
+  ...
+}
+
+entity 仕入先マスタ {
+  仕入先コード(FK) <<PK>>
+  仕入先枝番 <<PK>>
+  --
+  仕入先担当者名
+  部門名
+  電話番号
+  FAX番号
+  メールアドレス
+  ...
+}
+
+entity 出荷先マスタ {
+  取引先コード(FK)
+  顧客枝番(FK)
+  出荷先番号 <<PK>>
+  --
+  出荷先名
+  地域コード
+  出荷先郵便番号
+  出荷先住所1
+  出荷先住所2
+  ...
+}
+
+取引先マスタ ||--o| 顧客マスタ
+取引先マスタ ||--o| 仕入先マスタ
+顧客マスタ ||--o{ 出荷先マスタ
+
+@enduml
+```
+
+### 請求先・回収先の概念
+
+顧客マスタでは、実際に商品を購入する顧客と、請求書を送付する先（請求先）、代金を回収する先（回収先）を分けて管理できます。
+
+```plantuml
+@startuml
+
+title 請求先・回収先の関係
+
+actor "購入者\n（A支店）" as buyer
+actor "請求先\n（本社経理部）" as billing
+actor "回収先\n（本社財務部）" as collection
+
+buyer -right-> billing : 請求書送付先
+billing -right-> collection : 代金支払元
+
+note bottom of buyer
+  顧客コード: C001
+  顧客枝番: 01
+  請求先コード: C001
+  請求先枝番: 00
+end note
+
+note bottom of billing
+  顧客コード: C001
+  顧客枝番: 00
+  （本社）
+end note
+
+@enduml
+```
+
+### マイグレーション：取引先関連テーブルの作成
+
+<details>
+<summary>SQL 実装</summary>
+
+```sql
+-- src/main/resources/db/migration/V006__create_partner_master.sql
+
+-- 請求区分 ENUM
+CREATE TYPE 請求区分 AS ENUM ('都度', '締め');
+
+-- 支払方法 ENUM
+CREATE TYPE 支払方法 AS ENUM ('現金', '振込', '手形', '小切手', 'その他');
+
+-- 取引先グループマスタ
+CREATE TABLE "取引先グループマスタ" (
+    "取引先グループコード" VARCHAR(10) PRIMARY KEY,
+    "取引先グループ名" VARCHAR(50) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50)
+);
+
+-- 取引先マスタ
+CREATE TABLE "取引先マスタ" (
+    "取引先コード" VARCHAR(20) PRIMARY KEY,
+    "取引先名" VARCHAR(100) NOT NULL,
+    "取引先カナ" VARCHAR(200),
+    "顧客区分" BOOLEAN DEFAULT FALSE,
+    "仕入先区分" BOOLEAN DEFAULT FALSE,
+    "郵便番号" VARCHAR(10),
+    "住所1" VARCHAR(100),
+    "住所2" VARCHAR(100),
+    "取引先分類コード" VARCHAR(10),
+    "取引禁止フラグ" BOOLEAN DEFAULT FALSE,
+    "雑区分" BOOLEAN DEFAULT FALSE,
+    "取引先グループコード" VARCHAR(10) REFERENCES "取引先グループマスタ"("取引先グループコード"),
+    "与信限度額" DECIMAL(15, 2) DEFAULT 0,
+    "与信一時増加枠" DECIMAL(15, 2) DEFAULT 0,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50)
+);
+
+-- 顧客マスタ
+CREATE TABLE "顧客マスタ" (
+    "顧客コード" VARCHAR(20) NOT NULL REFERENCES "取引先マスタ"("取引先コード"),
+    "顧客枝番" VARCHAR(10) NOT NULL DEFAULT '00',
+    "顧客区分" VARCHAR(10),
+    "請求先コード" VARCHAR(20),
+    "請求先枝番" VARCHAR(10),
+    "回収先コード" VARCHAR(20),
+    "回収先枝番" VARCHAR(10),
+    "顧客名" VARCHAR(100),
+    "顧客名カナ" VARCHAR(200),
+    "自社担当者コード" VARCHAR(10),
+    "顧客担当者名" VARCHAR(50),
+    "顧客部門名" VARCHAR(50),
+    "顧客郵便番号" VARCHAR(10),
+    "顧客都道府県" VARCHAR(10),
+    "顧客住所1" VARCHAR(100),
+    "顧客住所2" VARCHAR(100),
+    "顧客電話番号" VARCHAR(20),
+    "顧客FAX番号" VARCHAR(20),
+    "顧客メールアドレス" VARCHAR(100),
+    "顧客請求区分" 請求区分 DEFAULT '締め',
+    "顧客締日1" INTEGER,
+    "顧客支払月1" INTEGER,
+    "顧客支払日1" INTEGER,
+    "顧客支払方法1" 支払方法,
+    "顧客締日2" INTEGER,
+    "顧客支払月2" INTEGER,
+    "顧客支払日2" INTEGER,
+    "顧客支払方法2" 支払方法,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50),
+    PRIMARY KEY ("顧客コード", "顧客枝番")
+);
+
+-- 仕入先マスタ
+CREATE TABLE "仕入先マスタ" (
+    "仕入先コード" VARCHAR(20) NOT NULL REFERENCES "取引先マスタ"("取引先コード"),
+    "仕入先枝番" VARCHAR(10) NOT NULL DEFAULT '00',
+    "仕入先担当者名" VARCHAR(50),
+    "部門名" VARCHAR(50),
+    "電話番号" VARCHAR(20),
+    "FAX番号" VARCHAR(20),
+    "メールアドレス" VARCHAR(100),
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50),
+    PRIMARY KEY ("仕入先コード", "仕入先枝番")
+);
+
+-- 地域マスタ
+CREATE TABLE "地域マスタ" (
+    "地域コード" VARCHAR(10) PRIMARY KEY,
+    "地域名" VARCHAR(50) NOT NULL,
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50)
+);
+
+-- 出荷先マスタ
+CREATE TABLE "出荷先マスタ" (
+    "取引先コード" VARCHAR(20) NOT NULL,
+    "顧客枝番" VARCHAR(10) NOT NULL,
+    "出荷先番号" VARCHAR(10) NOT NULL,
+    "出荷先名" VARCHAR(100) NOT NULL,
+    "地域コード" VARCHAR(10) REFERENCES "地域マスタ"("地域コード"),
+    "出荷先郵便番号" VARCHAR(10),
+    "出荷先住所1" VARCHAR(100),
+    "出荷先住所2" VARCHAR(100),
+    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "作成者名" VARCHAR(50),
+    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    "更新者名" VARCHAR(50),
+    PRIMARY KEY ("取引先コード", "顧客枝番", "出荷先番号"),
+    FOREIGN KEY ("取引先コード", "顧客枝番") REFERENCES "顧客マスタ"("顧客コード", "顧客枝番")
+);
+
+-- インデックス
+CREATE INDEX idx_取引先マスタ_取引先グループ ON "取引先マスタ"("取引先グループコード");
+CREATE INDEX idx_顧客マスタ_請求先 ON "顧客マスタ"("請求先コード", "請求先枝番");
+```
+
+</details>
+
+### エンティティ（ドメイン層）
+
+<details>
+<summary>Partner.java</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/partner/Partner.java
+package com.example.sms.domain.model.partner;
+
+import lombok.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Partner {
+    private String partnerCode;
+    private String partnerName;
+    private String partnerNameKana;
+    @Builder.Default
+    private boolean isCustomer = false;
+    @Builder.Default
+    private boolean isSupplier = false;
+    private String postalCode;
+    private String address1;
+    private String address2;
+    private String classificationCode;
+    @Builder.Default
+    private boolean isTradingProhibited = false;
+    @Builder.Default
+    private boolean isMiscellaneous = false;
+    private String groupCode;
+    @Builder.Default
+    private BigDecimal creditLimit = BigDecimal.ZERO;
+    @Builder.Default
+    private BigDecimal temporaryCreditIncrease = BigDecimal.ZERO;
+    private LocalDateTime createdAt;
+    private String createdBy;
+    private LocalDateTime updatedAt;
+    private String updatedBy;
+}
+```
+
+</details>
+
+---
+
+## 5.7 取引条件の設計
+
+顧客との取引条件（締日・支払日など）を管理します。
+
+### 締日・支払月・支払日の管理
+
+| 項目 | 説明 | 例 |
+|-----|------|-----|
+| **締日** | 請求の締め日 | 20日、末日 |
+| **支払月** | 締め月から何ヶ月後か | 0（当月）、1（翌月） |
+| **支払日** | 支払日 | 10日、25日、末日 |
+
+### 都度請求と締め請求
+
+| 請求区分 | 説明 |
+|---------|------|
+| **都度請求** | 取引のたびに請求書を発行 |
+| **締め請求** | 締日でまとめて請求書を発行 |
+
+### 与信管理
+
+```plantuml
+@startuml
+
+title 与信チェックフロー
+
+start
+
+:受注登録;
+
+:売掛残高を取得;
+:受注済残高を取得;
+:今回受注金額を加算;
+
+:与信限度額を取得;
+:一時増加枠を取得;
+
+if (売掛残高 + 受注済残高 + 今回受注 > 与信限度額 + 一時増加枠) then (yes)
+  :与信オーバー警告;
+  if (強制登録？) then (yes)
+    :受注登録（警告付き）;
+  else (no)
+    :受注キャンセル;
+    stop
+  endif
+else (no)
+endif
+
+:受注確定;
+
+stop
+
+@enduml
+```
+
+### 請求区分・支払方法の Enum
+
+<details>
+<summary>BillingType.java</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/partner/BillingType.java
+package com.example.sms.domain.model.partner;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum BillingType {
+    ON_DEMAND("都度"),
+    PERIODIC("締め");
+
+    private final String displayName;
+
+    public static BillingType fromDisplayName(String displayName) {
+        for (BillingType type : values()) {
+            if (type.displayName.equals(displayName)) {
+                return type;
+            }
+        }
+        throw new IllegalArgumentException("不正な請求区分: " + displayName);
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>PaymentMethod.java</summary>
+
+```java
+// src/main/java/com/example/sms/domain/model/partner/PaymentMethod.java
+package com.example.sms.domain.model.partner;
+
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
+public enum PaymentMethod {
+    CASH("現金"),
+    TRANSFER("振込"),
+    BILL("手形"),
+    CHECK("小切手"),
+    OTHER("その他");
+
+    private final String displayName;
+
+    public static PaymentMethod fromDisplayName(String displayName) {
+        for (PaymentMethod method : values()) {
+            if (method.displayName.equals(displayName)) {
+                return method;
+            }
+        }
+        throw new IllegalArgumentException("不正な支払方法: " + displayName);
+    }
+}
+```
+
+</details>
+
+---
+
+## 第5章のまとめ
+
+### 作成したテーブル
+
+| テーブル名 | 説明 |
+|-----------|------|
+| `部門マスタ` | 組織階層を管理する部門情報 |
+| `社員マスタ` | 部門に所属する社員情報 |
+| `商品分類マスタ` | 商品の分類階層 |
+| `商品マスタ` | 販売商品の情報 |
+| `顧客別販売単価` | 顧客ごとの特別単価 |
+| `取引先グループマスタ` | 取引先のグループ |
+| `取引先マスタ` | 顧客・仕入先の統合情報 |
+| `顧客マスタ` | 顧客固有情報 |
+| `仕入先マスタ` | 仕入先固有情報 |
+| `地域マスタ` | 地域情報 |
+| `出荷先マスタ` | 顧客の出荷先情報 |
+
+### ER 図（第5章完了時点）
+
+```plantuml
+@startuml
+
+title マスタ情報 ER図
+
+entity 部門マスタ {
+  部門コード <<PK>>
+  開始日 <<PK>>
+  --
+  終了日
+  部門名
+  組織階層
+  部門パス
+  最下層区分
+}
+
+entity 社員マスタ {
+  社員コード <<PK>>
+  --
+  社員名
+  社員名カナ
+  部門コード <<FK>>
+  開始日 <<FK>>
+}
+
+entity 商品分類マスタ {
+  商品分類コード <<PK>>
+  --
+  商品分類名
+  商品分類階層
+  商品分類パス
+  最下層区分
+}
+
+entity 商品マスタ {
+  商品コード <<PK>>
+  --
+  商品正式名
+  商品名
+  商品名カナ
+  商品区分
+  販売単価
+  仕入単価
+  税区分
+  商品分類コード <<FK>>
+  ...
+}
+
+entity 顧客別販売単価 {
+  商品コード <<PK,FK>>
+  取引先コード <<PK>>
+  適用開始日 <<PK>>
+  --
+  適用終了日
+  販売単価
+}
+
+entity 取引先マスタ {
+  取引先コード <<PK>>
+  --
+  取引先名
+  顧客区分
+  仕入先区分
+  与信限度額
+  ...
+}
+
+entity 顧客マスタ {
+  顧客コード <<PK,FK>>
+  顧客枝番 <<PK>>
+  --
+  請求先コード
+  顧客請求区分
+  顧客締日1
+  ...
+}
+
+entity 仕入先マスタ {
+  仕入先コード <<PK,FK>>
+  仕入先枝番 <<PK>>
+  --
+  仕入先担当者名
+  ...
+}
+
+entity 出荷先マスタ {
+  取引先コード <<PK,FK>>
+  顧客枝番 <<PK,FK>>
+  出荷先番号 <<PK>>
+  --
+  出荷先名
+  地域コード <<FK>>
+  ...
+}
+
+部門マスタ ||--o{ 社員マスタ
+商品分類マスタ ||--o{ 商品マスタ
+商品マスタ ||--o{ 顧客別販売単価
+取引先マスタ ||--o| 顧客マスタ
+取引先マスタ ||--o| 仕入先マスタ
+顧客マスタ ||--o{ 出荷先マスタ
+
+@enduml
+```
+
+### 設計のポイント
+
+1. **組織階層管理**: 部門マスタは `部門パス` で階層構造を表現
+2. **履歴管理**: 部門マスタは `開始日` による世代管理を採用
+3. **統合マスタ**: 取引先マスタで顧客・仕入先を統合管理
+4. **日本語 DB / 英語 Java**: テーブル・カラムは日本語、Java コードは英語で統一
+5. **PostgreSQL ENUM**: 区分値は日本語 ENUM 型で型安全性を確保
+6. **与信管理**: 与信限度額と一時増加枠で柔軟な与信管理を実現
+
+---
+
+## 次章の予告
+
+第6章では、受注・出荷・売上の設計に進みます。販売管理の中核となる業務フローを TDD で実装していきます。
+
+---
+
+[← 第4章：販売管理システムのアーキテクチャ](./chapter04.md) | [第6章：受注・出荷・売上の設計 →](./chapter06.md)