@k2works/claude-code-booster 6.1.0 → 6.3.0

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

@@ -1,2109 +0,0 @@
----
-type: Article
-title: "第32章：API サービスの実装"
-tags: [article, practical-database-design, part4]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-30T08:34:28Z }
----
-
-# 第32章：API サービスの実装
-
-## 32.1 ヘキサゴナルアーキテクチャの復習
-
-### ヘキサゴナルアーキテクチャとは
-
-ヘキサゴナルアーキテクチャ（Ports and Adapters パターン）は、アプリケーションのドメインロジックを外部の技術的詳細から分離するアーキテクチャスタイルです。
-
-```plantuml
-@startuml
-skinparam componentStyle uml2
-skinparam component {
-    BackgroundColor<<adapter>> LightBlue
-    BackgroundColor<<port>> LightGreen
-    BackgroundColor<<domain>> LightYellow
-}
-
-package "外部" {
-    [REST Client] as rest
-    [Database] as db
-}
-
-package "Application" {
-    package "Infrastructure" {
-        [REST Controller] <<adapter>> as controller
-        [MyBatis Repository] <<adapter>> as mybatis
-    }
-
-    package "Application Service" {
-        interface "Input Port\n(UseCase)" <<port>> as input
-        interface "Output Port\n(Repository)" <<port>> as output
-        [Service] as service
-    }
-
-    package "Domain" <<domain>> {
-        [Entity]
-        [Value Object]
-        [Domain Service]
-    }
-}
-
-rest --> controller
-controller --> input
-input <|.. service
-service --> output
-output <|.. mybatis
-mybatis --> db
-
-service --> Entity
-service --> [Domain Service]
-@enduml
-```
-
-### 主要な概念
-
-| 概念 | 説明 | 例 |
-|------|------|-----|
-| Input Port | ユースケースを定義するインターフェース | ItemUseCase |
-| Output Port | 外部リソースへのアクセスを定義するインターフェース | ItemRepository |
-| Input Adapter | 外部からの入力を受け付けるコンポーネント | REST Controller |
-| Output Adapter | 外部リソースへの出力を行うコンポーネント | MyBatis Repository |
-| Domain | ビジネスロジックを含む中心部分 | Entity, Value Object |
-
-### 依存関係の方向
-
-ヘキサゴナルアーキテクチャでは、依存関係は常に外側から内側に向かいます。
-
-```plantuml
-@startuml
-skinparam rectangle {
-    BackgroundColor<<outer>> LightBlue
-    BackgroundColor<<middle>> LightGreen
-    BackgroundColor<<inner>> LightYellow
-}
-
-rectangle "Infrastructure\n(Adapters)" <<outer>> as infra {
-}
-
-rectangle "Application\n(Ports & Services)" <<middle>> as app {
-}
-
-rectangle "Domain\n(Entities & Rules)" <<inner>> as domain {
-}
-
-infra --> app : 依存
-app --> domain : 依存
-@enduml
-```
-
----
-
-## 32.2 アーキテクチャ構造
-
-### プロジェクト構造
-
-```
-apps/pms/backend/
-├── src/
-│   ├── main/
-│   │   ├── java/
-│   │   │   └── com/example/pms/
-│   │   │       ├── Application.java
-│   │   │       ├── domain/
-│   │   │       │   ├── model/           # エンティティ・値オブジェクト
-│   │   │       │   │   ├── item/
-│   │   │       │   │   ├── bom/
-│   │   │       │   │   ├── inventory/
-│   │   │       │   │   ├── purchase/
-│   │   │       │   │   └── process/
-│   │   │       │   ├── service/         # ドメインサービス
-│   │   │       │   └── exception/       # ドメイン例外
-│   │   │       ├── application/
-│   │   │       │   ├── port/
-│   │   │       │   │   ├── in/          # Input Port（ユースケース）
-│   │   │       │   │   │   └── command/ # コマンドオブジェクト
-│   │   │       │   │   └── out/         # Output Port（リポジトリ）
-│   │   │       │   └── service/         # アプリケーションサービス
-│   │   │       └── infrastructure/
-│   │   │           ├── in/
-│   │   │           │   ├── rest/        # REST Controller
-│   │   │           │   │   └── dto/     # Request/Response DTO
-│   │   │           │   └── web/
-│   │   │           │       └── exception/ # 例外ハンドラ
-│   │   │           └── out/
-│   │   │               └── persistence/
-│   │   │                   └── repository/ # Repository 実装
-│   │   └── resources/
-│   │       ├── mapper/                  # MyBatis マッパー XML
-│   │       └── application.yml
-│   └── test/
-│       └── java/
-│           └── com/example/pms/
-│               └── integration/         # 統合テスト
-└── build.gradle.kts
-```
-
-### 技術スタックの導入
-
-<details>
-<summary>build.gradle.kts</summary>
-
-```kotlin
-plugins {
-    java
-    id("org.springframework.boot") version "3.2.0"
-    id("io.spring.dependency-management") version "1.1.4"
-}
-
-group = "com.example"
-version = "0.0.1-SNAPSHOT"
-
-java {
-    sourceCompatibility = JavaVersion.VERSION_21
-}
-
-repositories {
-    mavenCentral()
-}
-
-dependencies {
-    // Spring Boot
-    implementation("org.springframework.boot:spring-boot-starter-web")
-    implementation("org.springframework.boot:spring-boot-starter-validation")
-
-    // MyBatis
-    implementation("org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3")
-
-    // PostgreSQL
-    runtimeOnly("org.postgresql:postgresql")
-
-    // OpenAPI / Swagger
-    implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.3.0")
-
-    // Lombok
-    compileOnly("org.projectlombok:lombok")
-    annotationProcessor("org.projectlombok:lombok")
-
-    // Test
-    testImplementation("org.springframework.boot:spring-boot-starter-test")
-    testImplementation("org.testcontainers:postgresql:1.19.3")
-    testImplementation("org.testcontainers:junit-jupiter:1.19.3")
-}
-
-tasks.withType<Test> {
-    useJUnitPlatform()
-}
-```
-
-</details>
-
-### アプリケーション設定
-
-<details>
-<summary>Application.java</summary>
-
-```java
-package com.example.pms;
-
-import org.springframework.boot.SpringApplication;
-import org.springframework.boot.autoconfigure.SpringBootApplication;
-
-/**
- * 生産管理システム（Production Management System）のメインクラス.
- */
-@SpringBootApplication
-public class Application {
-
-    public static void main(String[] args) {
-        SpringApplication.run(Application.class, args);
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>OpenApiConfig.java</summary>
-
-```java
-package com.example.pms.infrastructure.config;
-
-import io.swagger.v3.oas.models.OpenAPI;
-import io.swagger.v3.oas.models.info.Contact;
-import io.swagger.v3.oas.models.info.Info;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-
-/**
- * OpenAPI 設定.
- */
-@Configuration
-public class OpenApiConfig {
-
-    @Bean
-    public OpenAPI customOpenAPI() {
-        return new OpenAPI()
-            .info(new Info()
-                .title("生産管理 API")
-                .version("1.0")
-                .description("生産管理システムの RESTful API")
-                .contact(new Contact()
-                    .name("開発チーム")
-                    .email("dev@example.com")));
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>RootController.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest;
-
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
-
-import java.util.Map;
-
-/**
- * API ルート Controller.
- */
-@RestController
-@RequestMapping("/api")
-@Tag(name = "root", description = "API ルート")
-public class RootController {
-
-    @GetMapping
-    @Operation(summary = "API 情報の取得")
-    public ResponseEntity<Map<String, String>> root() {
-        return ResponseEntity.ok(Map.of(
-            "service", "Production Management API",
-            "version", "1.0",
-            "docs", "/swagger-ui.html"
-        ));
-    }
-
-    @GetMapping("/health")
-    @Operation(summary = "ヘルスチェック")
-    public ResponseEntity<Map<String, String>> health() {
-        return ResponseEntity.ok(Map.of("status", "UP"));
-    }
-}
-```
-
-</details>
-
----
-
-## 32.3 マスタ API の実装
-
-### 32.3.1 品目マスタ API
-
-#### Output Port（リポジトリインターフェース）
-
-<details>
-<summary>ItemRepository.java</summary>
-
-```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>
-
-#### Input Port（ユースケースインターフェース）
-
-<details>
-<summary>ItemUseCase.java</summary>
-
-```java
-package com.example.pms.application.port.in;
-
-import com.example.pms.application.port.in.command.CreateItemCommand;
-import com.example.pms.application.port.in.command.UpdateItemCommand;
-import com.example.pms.domain.model.item.Item;
-
-import java.util.List;
-
-/**
- * 品目ユースケース（Input Port）.
- */
-public interface ItemUseCase {
-
-    List<Item> getAllItems();
-
-    Item getItem(String itemCode);
-
-    Item createItem(CreateItemCommand command);
-
-    Item updateItem(String itemCode, UpdateItemCommand command);
-
-    void deleteItem(String itemCode);
-}
-```
-
-</details>
-
-<details>
-<summary>CreateItemCommand.java</summary>
-
-```java
-package com.example.pms.application.port.in.command;
-
-import com.example.pms.domain.model.item.ItemCategory;
-import lombok.Builder;
-import lombok.Value;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-
-/**
- * 品目登録コマンド.
- */
-@Value
-@Builder
-public class CreateItemCommand {
-    String itemCode;
-    String itemName;
-    ItemCategory itemCategory;
-    String unitCode;
-    LocalDate effectiveFrom;
-    LocalDate effectiveTo;
-    Integer leadTime;
-    Integer safetyLeadTime;
-    BigDecimal safetyStock;
-    BigDecimal yieldRate;
-    BigDecimal minLotSize;
-    BigDecimal lotIncrement;
-    BigDecimal maxLotSize;
-    Integer shelfLife;
-}
-```
-
-</details>
-
-#### Application Service
-
-<details>
-<summary>ItemService.java</summary>
-
-```java
-package com.example.pms.application.service;
-
-import com.example.pms.application.port.in.ItemUseCase;
-import com.example.pms.application.port.in.command.CreateItemCommand;
-import com.example.pms.application.port.in.command.UpdateItemCommand;
-import com.example.pms.application.port.out.ItemRepository;
-import com.example.pms.domain.exception.DuplicateItemException;
-import com.example.pms.domain.exception.ItemNotFoundException;
-import com.example.pms.domain.model.item.Item;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.time.LocalDate;
-import java.util.List;
-
-/**
- * 品目サービス（Application Service）.
- */
-@Service
-@Transactional
-public class ItemService implements ItemUseCase {
-
-    private final ItemRepository itemRepository;
-
-    public ItemService(ItemRepository itemRepository) {
-        this.itemRepository = itemRepository;
-    }
-
-    @Override
-    @Transactional(readOnly = true)
-    public List<Item> getAllItems() {
-        return itemRepository.findAll();
-    }
-
-    @Override
-    @Transactional(readOnly = true)
-    public Item getItem(String itemCode) {
-        return itemRepository.findByItemCode(itemCode)
-            .orElseThrow(() -> new ItemNotFoundException(itemCode));
-    }
-
-    @Override
-    public Item createItem(CreateItemCommand command) {
-        if (itemRepository.findByItemCode(command.getItemCode()).isPresent()) {
-            throw new DuplicateItemException(command.getItemCode());
-        }
-
-        Item item = Item.builder()
-            .itemCode(command.getItemCode())
-            .itemName(command.getItemName())
-            .itemCategory(command.getItemCategory())
-            .unitCode(command.getUnitCode())
-            .effectiveFrom(command.getEffectiveFrom() != null
-                ? command.getEffectiveFrom() : LocalDate.now())
-            .effectiveTo(command.getEffectiveTo())
-            .leadTime(command.getLeadTime())
-            .safetyLeadTime(command.getSafetyLeadTime())
-            .safetyStock(command.getSafetyStock())
-            .yieldRate(command.getYieldRate())
-            .minLotSize(command.getMinLotSize())
-            .lotIncrement(command.getLotIncrement())
-            .maxLotSize(command.getMaxLotSize())
-            .shelfLife(command.getShelfLife())
-            .build();
-
-        itemRepository.save(item);
-        return item;
-    }
-
-    @Override
-    public Item updateItem(String itemCode, UpdateItemCommand command) {
-        Item existing = itemRepository.findByItemCode(itemCode)
-            .orElseThrow(() -> new ItemNotFoundException(itemCode));
-
-        Item updated = Item.builder()
-            .id(existing.getId())
-            .itemCode(existing.getItemCode())
-            .itemName(command.getItemName() != null
-                ? command.getItemName() : existing.getItemName())
-            .itemCategory(command.getItemCategory() != null
-                ? command.getItemCategory() : existing.getItemCategory())
-            .unitCode(command.getUnitCode() != null
-                ? command.getUnitCode() : existing.getUnitCode())
-            .effectiveFrom(existing.getEffectiveFrom())
-            .createdAt(existing.getCreatedAt())
-            .build();
-
-        itemRepository.update(updated);
-        return updated;
-    }
-
-    @Override
-    public void deleteItem(String itemCode) {
-        itemRepository.findByItemCode(itemCode)
-            .orElseThrow(() -> new ItemNotFoundException(itemCode));
-        throw new UnsupportedOperationException("品目の削除は現在サポートされていません");
-    }
-}
-```
-
-</details>
-
-#### Input Adapter（REST Controller）
-
-<details>
-<summary>ItemControllerTest.java（テスト駆動開発）</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest;
-
-import com.example.pms.application.port.in.ItemUseCase;
-import com.example.pms.domain.model.item.Item;
-import com.example.pms.domain.model.item.ItemCategory;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
-import org.springframework.boot.test.mock.mockito.MockBean;
-import org.springframework.http.MediaType;
-import org.springframework.test.web.servlet.MockMvc;
-
-import java.time.LocalDate;
-import java.util.List;
-
-import static org.mockito.ArgumentMatchers.any;
-import static org.mockito.Mockito.when;
-import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
-import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
-
-@WebMvcTest(ItemController.class)
-class ItemControllerTest {
-
-    @Autowired
-    private MockMvc mockMvc;
-
-    @Autowired
-    private ObjectMapper objectMapper;
-
-    @MockBean
-    private ItemUseCase itemUseCase;
-
-    private Item sampleItem;
-
-    @BeforeEach
-    void setUp() {
-        sampleItem = Item.builder()
-            .itemCode("ITEM001")
-            .itemName("テスト品目")
-            .itemCategory(ItemCategory.PRODUCT)
-            .unitCode("個")
-            .effectiveFrom(LocalDate.now())
-            .leadTime(5)
-            .build();
-    }
-
-    @Test
-    void 品目一覧を取得できる() throws Exception {
-        when(itemUseCase.getAllItems()).thenReturn(List.of(sampleItem));
-
-        mockMvc.perform(get("/api/items"))
-            .andExpect(status().isOk())
-            .andExpect(jsonPath("$[0].itemCode").value("ITEM001"))
-            .andExpect(jsonPath("$[0].itemName").value("テスト品目"));
-    }
-
-    @Test
-    void 品目を登録できる() throws Exception {
-        when(itemUseCase.createItem(any())).thenReturn(sampleItem);
-
-        var request = """
-            {
-                "itemCode": "ITEM001",
-                "itemName": "テスト品目",
-                "itemCategory": "PRODUCT",
-                "unitCode": "個",
-                "leadTime": 5
-            }
-            """;
-
-        mockMvc.perform(post("/api/items")
-                .contentType(MediaType.APPLICATION_JSON)
-                .content(request))
-            .andExpect(status().isCreated())
-            .andExpect(jsonPath("$.itemCode").value("ITEM001"));
-    }
-
-    @Test
-    void 品目を削除できる() throws Exception {
-        mockMvc.perform(delete("/api/items/ITEM001"))
-            .andExpect(status().isNoContent());
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>ItemController.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest;
-
-import com.example.pms.application.port.in.ItemUseCase;
-import com.example.pms.domain.model.item.Item;
-import com.example.pms.infrastructure.in.rest.dto.CreateItemRequest;
-import com.example.pms.infrastructure.in.rest.dto.ItemResponse;
-import com.example.pms.infrastructure.in.rest.dto.UpdateItemRequest;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import jakarta.validation.Valid;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.*;
-
-import java.util.List;
-
-/**
- * 品目マスタ API Controller.
- */
-@RestController
-@RequestMapping("/api/items")
-@Tag(name = "items", description = "品目マスタ API")
-public class ItemController {
-
-    private final ItemUseCase itemUseCase;
-
-    public ItemController(ItemUseCase itemUseCase) {
-        this.itemUseCase = itemUseCase;
-    }
-
-    @GetMapping
-    @Operation(summary = "品目一覧の取得")
-    public ResponseEntity<List<ItemResponse>> getAllItems() {
-        List<Item> items = itemUseCase.getAllItems();
-        return ResponseEntity.ok(items.stream()
-            .map(ItemResponse::from)
-            .toList());
-    }
-
-    @GetMapping("/{itemCode}")
-    @Operation(summary = "品目の取得")
-    public ResponseEntity<ItemResponse> getItem(@PathVariable String itemCode) {
-        Item item = itemUseCase.getItem(itemCode);
-        return ResponseEntity.ok(ItemResponse.from(item));
-    }
-
-    @PostMapping
-    @Operation(summary = "品目の登録")
-    public ResponseEntity<ItemResponse> createItem(
-            @Valid @RequestBody CreateItemRequest request) {
-        Item item = itemUseCase.createItem(request.toCommand());
-        return ResponseEntity.status(HttpStatus.CREATED)
-            .body(ItemResponse.from(item));
-    }
-
-    @PutMapping("/{itemCode}")
-    @Operation(summary = "品目の更新")
-    public ResponseEntity<ItemResponse> updateItem(
-            @PathVariable String itemCode,
-            @Valid @RequestBody UpdateItemRequest request) {
-        Item item = itemUseCase.updateItem(itemCode, request.toCommand());
-        return ResponseEntity.ok(ItemResponse.from(item));
-    }
-
-    @DeleteMapping("/{itemCode}")
-    @Operation(summary = "品目の削除")
-    @ResponseStatus(HttpStatus.NO_CONTENT)
-    public void deleteItem(@PathVariable String itemCode) {
-        itemUseCase.deleteItem(itemCode);
-    }
-}
-```
-
-</details>
-
-#### DTO（Request/Response）
-
-<details>
-<summary>CreateItemRequest.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest.dto;
-
-import com.example.pms.application.port.in.command.CreateItemCommand;
-import com.example.pms.domain.model.item.ItemCategory;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import lombok.Data;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-
-/**
- * 品目登録リクエスト DTO.
- */
-@Data
-public class CreateItemRequest {
-
-    @NotBlank(message = "品目コードは必須です")
-    private String itemCode;
-
-    @NotBlank(message = "品目名は必須です")
-    private String itemName;
-
-    @NotNull(message = "品目区分は必須です")
-    private ItemCategory itemCategory;
-
-    @NotBlank(message = "単位コードは必須です")
-    private String unitCode;
-
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    private Integer leadTime;
-    private Integer safetyLeadTime;
-    private BigDecimal safetyStock;
-    private BigDecimal yieldRate;
-    private BigDecimal minLotSize;
-    private BigDecimal lotIncrement;
-    private BigDecimal maxLotSize;
-    private Integer shelfLife;
-
-    public CreateItemCommand toCommand() {
-        return CreateItemCommand.builder()
-            .itemCode(itemCode)
-            .itemName(itemName)
-            .itemCategory(itemCategory)
-            .unitCode(unitCode)
-            .effectiveFrom(effectiveFrom)
-            .effectiveTo(effectiveTo)
-            .leadTime(leadTime)
-            .safetyLeadTime(safetyLeadTime)
-            .safetyStock(safetyStock)
-            .yieldRate(yieldRate)
-            .minLotSize(minLotSize)
-            .lotIncrement(lotIncrement)
-            .maxLotSize(maxLotSize)
-            .shelfLife(shelfLife)
-            .build();
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>UpdateItemRequest.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest.dto;
-
-import com.example.pms.application.port.in.command.UpdateItemCommand;
-import com.example.pms.domain.model.item.ItemCategory;
-import lombok.Data;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-
-/**
- * 品目更新リクエスト DTO.
- */
-@Data
-public class UpdateItemRequest {
-
-    private String itemName;
-    private ItemCategory itemCategory;
-    private String unitCode;
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    private Integer leadTime;
-    private Integer safetyLeadTime;
-    private BigDecimal safetyStock;
-    private BigDecimal yieldRate;
-    private BigDecimal minLotSize;
-    private BigDecimal lotIncrement;
-    private BigDecimal maxLotSize;
-    private Integer shelfLife;
-
-    public UpdateItemCommand toCommand() {
-        return UpdateItemCommand.builder()
-            .itemName(itemName)
-            .itemCategory(itemCategory)
-            .unitCode(unitCode)
-            .effectiveFrom(effectiveFrom)
-            .effectiveTo(effectiveTo)
-            .leadTime(leadTime)
-            .safetyLeadTime(safetyLeadTime)
-            .safetyStock(safetyStock)
-            .yieldRate(yieldRate)
-            .minLotSize(minLotSize)
-            .lotIncrement(lotIncrement)
-            .maxLotSize(maxLotSize)
-            .shelfLife(shelfLife)
-            .build();
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>ItemResponse.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest.dto;
-
-import com.example.pms.domain.model.item.Item;
-import com.example.pms.domain.model.item.ItemCategory;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Data;
-import lombok.NoArgsConstructor;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-
-/**
- * 品目レスポンス DTO.
- * Note: Jackson シリアライゼーションのため @Data + @NoArgsConstructor + @AllArgsConstructor を使用
- */
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ItemResponse {
-    private Integer id;
-    private String itemCode;
-    private String itemName;
-    private ItemCategory itemCategory;
-    private String unitCode;
-    private LocalDate effectiveFrom;
-    private LocalDate effectiveTo;
-    private Integer leadTime;
-    private Integer safetyLeadTime;
-    private BigDecimal safetyStock;
-    private BigDecimal yieldRate;
-    private BigDecimal minLotSize;
-    private BigDecimal lotIncrement;
-    private BigDecimal maxLotSize;
-    private Integer shelfLife;
-    private LocalDateTime createdAt;
-    private LocalDateTime updatedAt;
-
-    public static ItemResponse from(Item item) {
-        return ItemResponse.builder()
-            .id(item.getId())
-            .itemCode(item.getItemCode())
-            .itemName(item.getItemName())
-            .itemCategory(item.getItemCategory())
-            .unitCode(item.getUnitCode())
-            .effectiveFrom(item.getEffectiveFrom())
-            .effectiveTo(item.getEffectiveTo())
-            .leadTime(item.getLeadTime())
-            .safetyLeadTime(item.getSafetyLeadTime())
-            .safetyStock(item.getSafetyStock())
-            .yieldRate(item.getYieldRate())
-            .minLotSize(item.getMinLotSize())
-            .lotIncrement(item.getLotIncrement())
-            .maxLotSize(item.getMaxLotSize())
-            .shelfLife(item.getShelfLife())
-            .createdAt(item.getCreatedAt())
-            .updatedAt(item.getUpdatedAt())
-            .build();
-    }
-}
-```
-
-</details>
-
-#### Output Adapter（MyBatis Repository）
-
-<details>
-<summary>MyBatisItemRepository.java</summary>
-
-```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 org.apache.ibatis.annotations.*;
-import org.springframework.stereotype.Repository;
-
-import java.time.LocalDate;
-import java.util.List;
-import java.util.Optional;
-
-/**
- * 品目リポジトリの MyBatis 実装（Output Adapter）.
- */
-@Repository
-@Mapper
-public interface MyBatisItemRepository extends ItemRepository {
-
-    @Override
-    @Insert("""
-        INSERT INTO "品目マスタ" ("品目コード", "適用開始日", "品名", "品目区分", "単位コード",
-            "リードタイム", "安全リードタイム", "安全在庫数", "歩留まり率",
-            "最小ロットサイズ", "ロット増分", "最大ロットサイズ", "賞味期限日数")
-        VALUES (#{itemCode}, #{effectiveFrom}, #{itemName}, #{itemCategory}::品目区分, #{unitCode},
-            #{leadTime}, #{safetyLeadTime}, #{safetyStock}, #{yieldRate},
-            #{minLotSize}, #{lotIncrement}, #{maxLotSize}, #{shelfLife})
-        """)
-    void save(Item item);
-
-    @Override
-    @Select("""
-        SELECT * FROM "品目マスタ"
-        WHERE "品目コード" = #{itemCode}
-        ORDER BY "適用開始日" DESC LIMIT 1
-        """)
-    @ResultMap("itemMap")
-    Optional<Item> findByItemCode(String itemCode);
-
-    @Override
-    @Select("""
-        SELECT * FROM "品目マスタ"
-        WHERE "品目コード" = #{itemCode}
-          AND "適用開始日" <= #{baseDate}
-        ORDER BY "適用開始日" DESC LIMIT 1
-        """)
-    @ResultMap("itemMap")
-    Optional<Item> findByItemCodeAndDate(String itemCode, LocalDate baseDate);
-
-    @Override
-    @Select("SELECT * FROM \"品目マスタ\"")
-    @Results(id = "itemMap", value = {
-        @Result(property = "id", column = "品目ID"),
-        @Result(property = "itemCode", column = "品目コード"),
-        @Result(property = "itemName", column = "品名"),
-        @Result(property = "itemCategory", column = "品目区分"),
-        @Result(property = "unitCode", column = "単位コード"),
-        @Result(property = "effectiveFrom", column = "適用開始日"),
-        @Result(property = "effectiveTo", 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 = "更新日時")
-    })
-    List<Item> findAll();
-
-    @Override
-    @Update("""
-        UPDATE "品目マスタ"
-        SET "品名" = #{itemName}, "品目区分" = #{itemCategory}::品目区分,
-            "単位コード" = #{unitCode}
-        WHERE "品目ID" = #{id}
-        """)
-    void update(Item item);
-
-    @Override
-    @Delete("DELETE FROM \"品目マスタ\"")
-    void deleteAll();
-}
-```
-
-</details>
-
-### 32.3.2 BOM マスタ API
-
-#### BOM 展開サービス
-
-<details>
-<summary>BomService.java</summary>
-
-```java
-package com.example.pms.application.service;
-
-import com.example.pms.application.port.out.BomRepository;
-import com.example.pms.domain.model.bom.Bom;
-import lombok.Builder;
-import lombok.Value;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.math.BigDecimal;
-import java.util.ArrayList;
-import java.util.List;
-
-/**
- * BOM サービス（Application Service）.
- */
-@Service
-@Transactional(readOnly = true)
-public class BomService {
-
-    private final BomRepository bomRepository;
-
-    public BomService(BomRepository bomRepository) {
-        this.bomRepository = bomRepository;
-    }
-
-    /**
-     * BOM 展開（部品展開）
-     */
-    public List<BomNode> explodeBom(String itemCode, int maxLevel) {
-        List<BomNode> result = new ArrayList<>();
-        explodeRecursive(itemCode, 1, maxLevel, BigDecimal.ONE, result);
-        return result;
-    }
-
-    private void explodeRecursive(
-            String parentCode,
-            int currentLevel,
-            int maxLevel,
-            BigDecimal parentQuantity,
-            List<BomNode> result) {
-
-        if (currentLevel > maxLevel) return;
-
-        List<Bom> children = bomRepository.findByParentCode(parentCode);
-
-        for (Bom bom : children) {
-            BigDecimal requiredQty = bom.getQuantity().multiply(parentQuantity);
-
-            result.add(BomNode.builder()
-                .level(currentLevel)
-                .itemCode(bom.getChildItemCode())
-                .itemName(bom.getChildItemName())
-                .quantity(requiredQty)
-                .unit(bom.getUnit())
-                .build());
-
-            explodeRecursive(
-                bom.getChildItemCode(),
-                currentLevel + 1,
-                maxLevel,
-                requiredQty,
-                result);
-        }
-    }
-
-    /**
-     * 逆展開（使用先照会）
-     */
-    public List<WhereUsedResult> whereUsed(String itemCode) {
-        List<WhereUsedResult> result = new ArrayList<>();
-        whereUsedRecursive(itemCode, 1, result);
-        return result;
-    }
-
-    private void whereUsedRecursive(
-            String childCode,
-            int level,
-            List<WhereUsedResult> result) {
-
-        List<Bom> parents = bomRepository.findByChildCode(childCode);
-
-        for (Bom bom : parents) {
-            result.add(WhereUsedResult.builder()
-                .level(level)
-                .parentItemCode(bom.getParentItemCode())
-                .parentItemName(bom.getParentItemName())
-                .quantity(bom.getQuantity())
-                .build());
-
-            whereUsedRecursive(bom.getParentItemCode(), level + 1, result);
-        }
-    }
-}
-
-@Value
-@Builder
-class BomNode {
-    int level;
-    String itemCode;
-    String itemName;
-    BigDecimal quantity;
-    String unit;
-}
-
-@Value
-@Builder
-class WhereUsedResult {
-    int level;
-    String parentItemCode;
-    String parentItemName;
-    BigDecimal quantity;
-}
-```
-
-</details>
-
-#### BOM Controller
-
-<details>
-<summary>BomController.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest;
-
-import com.example.pms.application.service.BomNode;
-import com.example.pms.application.service.BomService;
-import com.example.pms.application.service.WhereUsedResult;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.Parameter;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.*;
-
-import java.util.List;
-
-/**
- * BOM API Controller.
- */
-@RestController
-@RequestMapping("/api/bom")
-@Tag(name = "bom", description = "BOM API")
-public class BomController {
-
-    private final BomService bomService;
-
-    public BomController(BomService bomService) {
-        this.bomService = bomService;
-    }
-
-    @GetMapping("/{itemCode}/explode")
-    @Operation(summary = "BOM 展開（部品展開）")
-    public ResponseEntity<List<BomNode>> explodeBom(
-            @PathVariable String itemCode,
-            @Parameter(description = "展開レベル（デフォルト: 10）")
-            @RequestParam(defaultValue = "10") int maxLevel) {
-        List<BomNode> nodes = bomService.explodeBom(itemCode, maxLevel);
-        return ResponseEntity.ok(nodes);
-    }
-
-    @GetMapping("/{itemCode}/where-used")
-    @Operation(summary = "逆展開（使用先照会）")
-    public ResponseEntity<List<WhereUsedResult>> whereUsed(
-            @PathVariable String itemCode) {
-        List<WhereUsedResult> results = bomService.whereUsed(itemCode);
-        return ResponseEntity.ok(results);
-    }
-}
-```
-
-</details>
-
----
-
-## 32.4 トランザクション API の実装
-
-### 32.4.1 発注 API
-
-#### Input Port
-
-<details>
-<summary>PurchaseOrderUseCase.java</summary>
-
-```java
-package com.example.pms.application.port.in;
-
-import com.example.pms.application.port.in.command.CreatePurchaseOrderCommand;
-import com.example.pms.domain.model.purchase.PurchaseOrder;
-
-import java.util.List;
-
-/**
- * 発注ユースケース（Input Port）.
- */
-public interface PurchaseOrderUseCase {
-
-    List<PurchaseOrder> getAllOrders();
-
-    PurchaseOrder getOrder(String orderNumber);
-
-    PurchaseOrder createOrder(CreatePurchaseOrderCommand command);
-
-    PurchaseOrder confirmOrder(String orderNumber);
-
-    void cancelOrder(String orderNumber);
-}
-```
-
-</details>
-
-#### Controller
-
-<details>
-<summary>PurchaseOrderController.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest;
-
-import com.example.pms.application.port.in.PurchaseOrderUseCase;
-import com.example.pms.domain.model.purchase.PurchaseOrder;
-import com.example.pms.infrastructure.in.rest.dto.CreatePurchaseOrderRequest;
-import com.example.pms.infrastructure.in.rest.dto.PurchaseOrderResponse;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import jakarta.validation.Valid;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.*;
-
-import java.util.List;
-
-/**
- * 発注 API Controller.
- */
-@RestController
-@RequestMapping("/api/purchase-orders")
-@Tag(name = "purchase-orders", description = "発注 API")
-public class PurchaseOrderController {
-
-    private final PurchaseOrderUseCase useCase;
-
-    public PurchaseOrderController(PurchaseOrderUseCase useCase) {
-        this.useCase = useCase;
-    }
-
-    @GetMapping
-    @Operation(summary = "発注一覧の取得")
-    public ResponseEntity<List<PurchaseOrderResponse>> getAllOrders() {
-        List<PurchaseOrder> orders = useCase.getAllOrders();
-        return ResponseEntity.ok(orders.stream()
-            .map(PurchaseOrderResponse::from)
-            .toList());
-    }
-
-    @GetMapping("/{orderNumber}")
-    @Operation(summary = "発注詳細の取得")
-    public ResponseEntity<PurchaseOrderResponse> getOrder(
-            @PathVariable String orderNumber) {
-        PurchaseOrder order = useCase.getOrder(orderNumber);
-        return ResponseEntity.ok(PurchaseOrderResponse.from(order));
-    }
-
-    @PostMapping
-    @Operation(summary = "発注の登録")
-    public ResponseEntity<PurchaseOrderResponse> createOrder(
-            @Valid @RequestBody CreatePurchaseOrderRequest request) {
-        PurchaseOrder order = useCase.createOrder(request.toCommand());
-        return ResponseEntity.status(HttpStatus.CREATED)
-            .body(PurchaseOrderResponse.from(order));
-    }
-
-    @PostMapping("/{orderNumber}/confirm")
-    @Operation(summary = "発注の確定")
-    public ResponseEntity<PurchaseOrderResponse> confirmOrder(
-            @PathVariable String orderNumber) {
-        PurchaseOrder order = useCase.confirmOrder(orderNumber);
-        return ResponseEntity.ok(PurchaseOrderResponse.from(order));
-    }
-
-    @DeleteMapping("/{orderNumber}")
-    @Operation(summary = "発注の取消")
-    @ResponseStatus(HttpStatus.NO_CONTENT)
-    public void cancelOrder(@PathVariable String orderNumber) {
-        useCase.cancelOrder(orderNumber);
-    }
-}
-```
-
-</details>
-
-### 32.4.2 在庫照会 API
-
-#### Input Port
-
-<details>
-<summary>InventoryUseCase.java</summary>
-
-```java
-package com.example.pms.application.port.in;
-
-import com.example.pms.domain.model.inventory.Stock;
-import lombok.Builder;
-import lombok.Value;
-
-import java.math.BigDecimal;
-import java.util.List;
-
-/**
- * 在庫ユースケース（Input Port）.
- */
-public interface InventoryUseCase {
-
-    /**
-     * 在庫一覧を取得
-     */
-    List<Stock> getInventory(InventoryQuery query);
-
-    /**
-     * 在庫サマリーを取得
-     */
-    List<InventorySummary> getInventorySummary();
-
-    /**
-     * 在庫不足品目を取得
-     */
-    List<InventorySummary> getShortageItems();
-}
-
-@Value
-@Builder
-class InventoryQuery {
-    String itemCode;
-    String locationCode;
-    String stockStatus;
-}
-
-@Value
-@Builder
-class InventorySummary {
-    String itemCode;
-    String itemName;
-    BigDecimal totalQuantity;
-    Integer safetyStock;
-    StockState stockState;
-
-    public enum StockState {
-        NORMAL, SHORTAGE, EXCESS
-    }
-}
-```
-
-</details>
-
-#### Controller
-
-<details>
-<summary>InventoryController.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest;
-
-import com.example.pms.application.port.in.InventoryQuery;
-import com.example.pms.application.port.in.InventorySummary;
-import com.example.pms.application.port.in.InventoryUseCase;
-import com.example.pms.domain.model.inventory.Stock;
-import com.example.pms.infrastructure.in.rest.dto.StockResponse;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.Parameter;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.*;
-
-import java.util.List;
-
-/**
- * 在庫 API Controller.
- */
-@RestController
-@RequestMapping("/api/inventory")
-@Tag(name = "inventory", description = "在庫 API")
-public class InventoryController {
-
-    private final InventoryUseCase useCase;
-
-    public InventoryController(InventoryUseCase useCase) {
-        this.useCase = useCase;
-    }
-
-    @GetMapping
-    @Operation(summary = "在庫一覧の取得")
-    public ResponseEntity<List<StockResponse>> getInventory(
-            @Parameter(description = "品目コード")
-            @RequestParam(required = false) String itemCode,
-            @Parameter(description = "場所コード")
-            @RequestParam(required = false) String locationCode,
-            @Parameter(description = "在庫状態")
-            @RequestParam(required = false) String status) {
-
-        InventoryQuery query = InventoryQuery.builder()
-            .itemCode(itemCode)
-            .locationCode(locationCode)
-            .stockStatus(status)
-            .build();
-
-        List<Stock> stocks = useCase.getInventory(query);
-        return ResponseEntity.ok(stocks.stream()
-            .map(StockResponse::from)
-            .toList());
-    }
-
-    @GetMapping("/summary")
-    @Operation(summary = "在庫サマリーの取得")
-    public ResponseEntity<List<InventorySummary>> getInventorySummary() {
-        List<InventorySummary> summary = useCase.getInventorySummary();
-        return ResponseEntity.ok(summary);
-    }
-
-    @GetMapping("/shortage")
-    @Operation(summary = "在庫不足品目の取得")
-    public ResponseEntity<List<InventorySummary>> getShortageItems() {
-        List<InventorySummary> items = useCase.getShortageItems();
-        return ResponseEntity.ok(items);
-    }
-}
-```
-
-</details>
-
-### 32.4.3 作業指示 API
-
-<details>
-<summary>WorkOrderController.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest;
-
-import com.example.pms.application.port.in.WorkOrderUseCase;
-import com.example.pms.domain.model.process.WorkOrder;
-import com.example.pms.infrastructure.in.rest.dto.CreateWorkOrderRequest;
-import com.example.pms.infrastructure.in.rest.dto.WorkOrderResponse;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import jakarta.validation.Valid;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.*;
-
-import java.util.List;
-
-/**
- * 作業指示 API Controller.
- */
-@RestController
-@RequestMapping("/api/work-orders")
-@Tag(name = "work-orders", description = "作業指示 API")
-public class WorkOrderController {
-
-    private final WorkOrderUseCase useCase;
-
-    public WorkOrderController(WorkOrderUseCase useCase) {
-        this.useCase = useCase;
-    }
-
-    @GetMapping
-    @Operation(summary = "作業指示一覧の取得")
-    public ResponseEntity<List<WorkOrderResponse>> getAllWorkOrders() {
-        List<WorkOrder> workOrders = useCase.getAllWorkOrders();
-        return ResponseEntity.ok(workOrders.stream()
-            .map(WorkOrderResponse::from)
-            .toList());
-    }
-
-    @GetMapping("/{workOrderNumber}")
-    @Operation(summary = "作業指示詳細の取得")
-    public ResponseEntity<WorkOrderResponse> getWorkOrder(
-            @PathVariable String workOrderNumber) {
-        WorkOrder workOrder = useCase.getWorkOrder(workOrderNumber);
-        return ResponseEntity.ok(WorkOrderResponse.from(workOrder));
-    }
-
-    @PostMapping
-    @Operation(summary = "作業指示の登録")
-    public ResponseEntity<WorkOrderResponse> createWorkOrder(
-            @Valid @RequestBody CreateWorkOrderRequest request) {
-        WorkOrder workOrder = useCase.createWorkOrder(request.toCommand());
-        return ResponseEntity.status(HttpStatus.CREATED)
-            .body(WorkOrderResponse.from(workOrder));
-    }
-}
-```
-
-</details>
-
-### 32.4.4 MRP 実行 API
-
-#### MRP サービス
-
-<details>
-<summary>MrpUseCase.java</summary>
-
-```java
-package com.example.pms.application.port.in;
-
-import lombok.Builder;
-import lombok.Value;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-import java.util.List;
-
-/**
- * MRP ユースケース（Input Port）.
- */
-public interface MrpUseCase {
-
-    /**
-     * MRP（所要量展開）を実行
-     */
-    MrpResult execute(LocalDate startDate, LocalDate endDate);
-
-    @Value
-    @Builder
-    class MrpResult {
-        LocalDateTime executionTime;
-        LocalDate periodStart;
-        LocalDate periodEnd;
-        List<PlannedOrder> plannedOrders;
-        List<ShortageItem> shortageItems;
-    }
-
-    @Value
-    @Builder
-    class PlannedOrder {
-        String itemCode;
-        String itemName;
-        String orderType; // MANUFACTURING or PURCHASE
-        BigDecimal quantity;
-        LocalDate dueDate;
-    }
-
-    @Value
-    @Builder
-    class ShortageItem {
-        String itemCode;
-        String itemName;
-        BigDecimal shortageQuantity;
-        LocalDate recommendedOrderDate;
-    }
-}
-```
-
-</details>
-
-#### MRP Controller
-
-<details>
-<summary>MrpController.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.rest;
-
-import com.example.pms.application.port.in.MrpUseCase;
-import com.example.pms.infrastructure.in.rest.dto.ExecuteMrpRequest;
-import com.example.pms.infrastructure.in.rest.dto.MrpResultResponse;
-import io.swagger.v3.oas.annotations.Operation;
-import io.swagger.v3.oas.annotations.tags.Tag;
-import jakarta.validation.Valid;
-import org.springframework.http.ResponseEntity;
-import org.springframework.web.bind.annotation.*;
-
-/**
- * MRP API Controller.
- */
-@RestController
-@RequestMapping("/api/mrp")
-@Tag(name = "mrp", description = "MRP API")
-public class MrpController {
-
-    private final MrpUseCase mrpUseCase;
-
-    public MrpController(MrpUseCase mrpUseCase) {
-        this.mrpUseCase = mrpUseCase;
-    }
-
-    @PostMapping("/execute")
-    @Operation(
-        summary = "MRP の実行",
-        description = "指定期間の所要量展開を実行し、計画オーダを生成します"
-    )
-    public ResponseEntity<MrpResultResponse> execute(
-            @Valid @RequestBody ExecuteMrpRequest request) {
-        var result = mrpUseCase.execute(
-            request.getStartDate(),
-            request.getEndDate()
-        );
-        return ResponseEntity.ok(MrpResultResponse.from(result));
-    }
-}
-```
-
-</details>
-
----
-
-## 32.5 エラーハンドリング
-
-### 32.5.1 ドメイン例外の定義
-
-<details>
-<summary>DomainException.java</summary>
-
-```java
-package com.example.pms.domain.exception;
-
-/**
- * ドメイン例外の基底クラス.
- */
-public abstract class DomainException extends RuntimeException {
-
-    protected DomainException(String message) {
-        super(message);
-    }
-
-    protected DomainException(String message, Throwable cause) {
-        super(message, cause);
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>ItemNotFoundException.java</summary>
-
-```java
-package com.example.pms.domain.exception;
-
-/**
- * 品目が見つからない例外.
- */
-public class ItemNotFoundException extends DomainException {
-
-    public ItemNotFoundException(String itemCode) {
-        super("品目が見つかりません: " + itemCode);
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>DuplicateItemException.java</summary>
-
-```java
-package com.example.pms.domain.exception;
-
-/**
- * 品目コード重複例外.
- */
-public class DuplicateItemException extends DomainException {
-
-    public DuplicateItemException(String itemCode) {
-        super("品目コードが既に存在します: " + itemCode);
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>InsufficientInventoryException.java</summary>
-
-```java
-package com.example.pms.domain.exception;
-
-import java.math.BigDecimal;
-
-/**
- * 在庫不足例外.
- */
-public class InsufficientInventoryException extends DomainException {
-
-    public InsufficientInventoryException(String itemCode, BigDecimal required, BigDecimal available) {
-        super(String.format("在庫が不足しています: %s (必要: %s, 有効: %s)",
-            itemCode, required, available));
-    }
-}
-```
-
-</details>
-
-### 32.5.2 グローバル例外ハンドラ
-
-<details>
-<summary>GlobalExceptionHandler.java</summary>
-
-```java
-package com.example.pms.infrastructure.in.web.exception;
-
-import com.example.pms.domain.exception.DomainException;
-import com.example.pms.domain.exception.DuplicateItemException;
-import com.example.pms.domain.exception.ItemNotFoundException;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.ProblemDetail;
-import org.springframework.web.bind.MethodArgumentNotValidException;
-import org.springframework.web.bind.annotation.ExceptionHandler;
-import org.springframework.web.bind.annotation.RestControllerAdvice;
-
-import java.net.URI;
-import java.time.Instant;
-import java.util.stream.Collectors;
-
-/**
- * グローバル例外ハンドラ.
- */
-@RestControllerAdvice
-public class GlobalExceptionHandler {
-
-    @ExceptionHandler(ItemNotFoundException.class)
-    public ProblemDetail handleItemNotFoundException(ItemNotFoundException ex) {
-        ProblemDetail problem = ProblemDetail.forStatusAndDetail(
-            HttpStatus.NOT_FOUND, ex.getMessage());
-        problem.setTitle("品目が見つかりません");
-        problem.setType(URI.create("https://api.example.com/errors/item-not-found"));
-        problem.setProperty("timestamp", Instant.now());
-        return problem;
-    }
-
-    @ExceptionHandler(DuplicateItemException.class)
-    public ProblemDetail handleDuplicateItemException(DuplicateItemException ex) {
-        ProblemDetail problem = ProblemDetail.forStatusAndDetail(
-            HttpStatus.CONFLICT, ex.getMessage());
-        problem.setTitle("品目コード重複");
-        problem.setType(URI.create("https://api.example.com/errors/duplicate-item"));
-        problem.setProperty("timestamp", Instant.now());
-        return problem;
-    }
-
-    @ExceptionHandler(MethodArgumentNotValidException.class)
-    public ProblemDetail handleValidationException(MethodArgumentNotValidException ex) {
-        String errors = ex.getBindingResult().getFieldErrors().stream()
-            .map(e -> e.getField() + ": " + e.getDefaultMessage())
-            .collect(Collectors.joining(", "));
-
-        ProblemDetail problem = ProblemDetail.forStatusAndDetail(
-            HttpStatus.BAD_REQUEST, errors);
-        problem.setTitle("入力値が不正です");
-        problem.setType(URI.create("https://api.example.com/errors/validation-error"));
-        problem.setProperty("timestamp", Instant.now());
-        return problem;
-    }
-
-    @ExceptionHandler(DomainException.class)
-    public ProblemDetail handleDomainException(DomainException ex) {
-        ProblemDetail problem = ProblemDetail.forStatusAndDetail(
-            HttpStatus.BAD_REQUEST, ex.getMessage());
-        problem.setTitle("ドメインエラー");
-        problem.setType(URI.create("https://api.example.com/errors/domain-error"));
-        problem.setProperty("timestamp", Instant.now());
-        return problem;
-    }
-
-    @ExceptionHandler(Exception.class)
-    public ProblemDetail handleGenericException(Exception ex) {
-        ProblemDetail problem = ProblemDetail.forStatusAndDetail(
-            HttpStatus.INTERNAL_SERVER_ERROR, "予期しないエラーが発生しました");
-        problem.setTitle("内部エラー");
-        problem.setType(URI.create("https://api.example.com/errors/internal-error"));
-        problem.setProperty("timestamp", Instant.now());
-        return problem;
-    }
-}
-```
-
-</details>
-
-### 32.5.3 エラーレスポンス形式
-
-RFC 7807（Problem Details for HTTP APIs）に準拠したエラーレスポンスを返します。
-
-```json
-{
-    "type": "https://api.example.com/errors/item-not-found",
-    "title": "品目が見つかりません",
-    "status": 404,
-    "detail": "品目が見つかりません: ITEM001",
-    "instance": "/api/items/ITEM001",
-    "timestamp": "2024-01-15T10:30:00Z"
-}
-```
-
-| フィールド | 説明 |
-|-----------|------|
-| type | エラー種別を識別する URI |
-| title | エラーの概要 |
-| status | HTTP ステータスコード |
-| detail | エラーの詳細説明 |
-| instance | エラーが発生したリソースの URI |
-| timestamp | エラー発生時刻 |
-
----
-
-## 32.6 API ドキュメント
-
-### OpenAPI / Swagger UI
-
-サーバー起動後、以下の URL で Swagger UI を確認できます：
-
-```
-http://localhost:8080/swagger-ui.html
-```
-
-### API 一覧
-
-| カテゴリ | エンドポイント | メソッド | 説明 |
-|---------|---------------|----------|------|
-| **品目** | /api/items | GET | 品目一覧の取得 |
-| | /api/items/{itemCode} | GET | 品目の取得 |
-| | /api/items | POST | 品目の登録 |
-| | /api/items/{itemCode} | PUT | 品目の更新 |
-| | /api/items/{itemCode} | DELETE | 品目の削除 |
-| **BOM** | /api/bom/{itemCode}/explode | GET | 部品展開 |
-| | /api/bom/{itemCode}/where-used | GET | 使用先照会 |
-| **発注** | /api/purchase-orders | GET | 発注一覧の取得 |
-| | /api/purchase-orders/{orderNumber} | GET | 発注詳細の取得 |
-| | /api/purchase-orders | POST | 発注の登録 |
-| | /api/purchase-orders/{orderNumber}/confirm | POST | 発注の確定 |
-| | /api/purchase-orders/{orderNumber} | DELETE | 発注の取消 |
-| **在庫** | /api/inventory | GET | 在庫一覧の取得 |
-| | /api/inventory/summary | GET | 在庫サマリーの取得 |
-| | /api/inventory/shortage | GET | 在庫不足品目の取得 |
-| **作業指示** | /api/work-orders | GET | 作業指示一覧の取得 |
-| | /api/work-orders/{workOrderNumber} | GET | 作業指示詳細の取得 |
-| | /api/work-orders | POST | 作業指示の登録 |
-| | /api/work-orders/{workOrderNumber}/completion | POST | 完成実績の登録 |
-| | /api/work-orders/{workOrderNumber}/progress | PATCH | 作業進捗の更新 |
-| **MRP** | /api/mrp/execute | POST | MRP の実行 |
-| | /api/mrp/results | GET | MRP 実行結果の照会 |
-| | /api/mrp/planned-orders | GET | 計画オーダ一覧の取得 |
-
----
-
-## 32.7 API インテグレーションテスト
-
-### RestClient を使用した API インテグレーションテスト
-
-本プロジェクトでは、MockMvc の代わりに RestClient を使用した実際の HTTP リクエストベースのテストを採用しています。
-
-<details>
-<summary>IntegrationTestBase.java</summary>
-
-```java
-package com.example.pms.integration;
-
-import com.example.pms.TestcontainersConfiguration;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.boot.test.web.server.LocalServerPort;
-import org.springframework.context.annotation.Import;
-import org.springframework.http.MediaType;
-import org.springframework.jdbc.core.JdbcTemplate;
-import org.springframework.test.context.ActiveProfiles;
-import org.springframework.web.client.RestClient;
-
-/**
- * API インテグレーションテストの基底クラス.
- * TestContainers を使用して PostgreSQL コンテナを起動し、
- * 実際の HTTP リクエストでテストを実行する。
- */
-@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
-@Import(TestcontainersConfiguration.class)
-@ActiveProfiles("test")
-public abstract class IntegrationTestBase {
-
-    @LocalServerPort
-    protected int port;
-
-    @Autowired
-    protected JdbcTemplate jdbcTemplate;
-
-    private RestClient restClient;
-
-    /**
-     * REST クライアントを取得.
-     */
-    protected RestClient getRestClient() {
-        if (restClient == null) {
-            restClient = RestClient.builder()
-                .baseUrl("http://localhost:" + port)
-                .defaultHeader("Content-Type", MediaType.APPLICATION_JSON_VALUE)
-                .defaultHeader("Accept", MediaType.APPLICATION_JSON_VALUE)
-                .build();
-        }
-        return restClient;
-    }
-
-    protected void cleanupItemData() {
-        jdbcTemplate.execute("DELETE FROM \"品目マスタ\" WHERE \"品目コード\" LIKE 'TEST%'");
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>ItemApiIntegrationTest.java</summary>
-
-```java
-package com.example.pms.integration;
-
-import static org.assertj.core.api.Assertions.assertThat;
-import static org.assertj.core.api.Assertions.assertThatThrownBy;
-
-import com.example.pms.domain.model.item.ItemCategory;
-import com.example.pms.infrastructure.in.rest.dto.CreateItemRequest;
-import com.example.pms.infrastructure.in.rest.dto.ItemResponse;
-import com.example.pms.infrastructure.in.rest.dto.UpdateItemRequest;
-import org.junit.jupiter.api.AfterEach;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.DisplayName;
-import org.junit.jupiter.api.Nested;
-import org.junit.jupiter.api.Test;
-import org.springframework.http.HttpStatus;
-import org.springframework.http.MediaType;
-import org.springframework.web.client.HttpClientErrorException;
-
-@DisplayName("品目 API 統合テスト")
-class ItemApiIntegrationTest extends IntegrationTestBase {
-
-    private static final String API_PATH = "/api/items";
-
-    @BeforeEach
-    void setUp() {
-        createUnit("個", "個", "個");
-        cleanupItemData();
-    }
-
-    @AfterEach
-    void tearDown() {
-        cleanupItemData();
-    }
-
-    @Nested
-    @DisplayName("品目登録・取得フロー")
-    class ItemCrudFlow {
-
-        @Test
-        @DisplayName("品目を登録して取得できる")
-        void shouldCreateAndRetrieveItem() {
-            CreateItemRequest createRequest = new CreateItemRequest();
-            createRequest.setItemCode("TEST001");
-            createRequest.setItemName("テスト品目");
-            createRequest.setItemCategory(ItemCategory.PRODUCT);
-            createRequest.setUnitCode("個");
-
-            // 品目を登録
-            ItemResponse createResponse = getRestClient()
-                .post()
-                .uri(API_PATH)
-                .contentType(MediaType.APPLICATION_JSON)
-                .body(createRequest)
-                .retrieve()
-                .body(ItemResponse.class);
-
-            assertThat(createResponse).isNotNull();
-            assertThat(createResponse.getItemCode()).isEqualTo("TEST001");
-
-            // 登録した品目を取得
-            ItemResponse getResponse = getRestClient()
-                .get()
-                .uri(API_PATH + "/TEST001")
-                .retrieve()
-                .body(ItemResponse.class);
-
-            assertThat(getResponse).isNotNull();
-            assertThat(getResponse.getItemCode()).isEqualTo("TEST001");
-            assertThat(getResponse.getItemName()).isEqualTo("テスト品目");
-        }
-
-        @Test
-        @DisplayName("存在しない品目を取得すると404エラー")
-        void shouldReturn404WhenItemNotFound() {
-            assertThatThrownBy(() ->
-                getRestClient()
-                    .get()
-                    .uri(API_PATH + "/NOT-EXIST")
-                    .retrieve()
-                    .body(ItemResponse.class)
-            ).isInstanceOf(HttpClientErrorException.class)
-                .satisfies(ex -> {
-                    HttpClientErrorException httpEx = (HttpClientErrorException) ex;
-                    assertThat(httpEx.getStatusCode()).isEqualTo(HttpStatus.NOT_FOUND);
-                });
-        }
-
-        @Test
-        @DisplayName("重複した品目コードで登録すると409エラー")
-        void shouldReturn409WhenDuplicateItemCode() {
-            CreateItemRequest createRequest = new CreateItemRequest();
-            createRequest.setItemCode("TEST002");
-            createRequest.setItemName("テスト品目2");
-            createRequest.setItemCategory(ItemCategory.PRODUCT);
-            createRequest.setUnitCode("個");
-
-            // 1回目は成功
-            getRestClient()
-                .post()
-                .uri(API_PATH)
-                .contentType(MediaType.APPLICATION_JSON)
-                .body(createRequest)
-                .retrieve()
-                .body(ItemResponse.class);
-
-            // 2回目は409
-            assertThatThrownBy(() ->
-                getRestClient()
-                    .post()
-                    .uri(API_PATH)
-                    .contentType(MediaType.APPLICATION_JSON)
-                    .body(createRequest)
-                    .retrieve()
-                    .body(ItemResponse.class)
-            ).isInstanceOf(HttpClientErrorException.class)
-                .satisfies(ex -> {
-                    HttpClientErrorException httpEx = (HttpClientErrorException) ex;
-                    assertThat(httpEx.getStatusCode()).isEqualTo(HttpStatus.CONFLICT);
-                });
-        }
-    }
-}
-```
-
-</details>
-
-### テスト用初期化スクリプト
-
-<details>
-<summary>init.sql</summary>
-
-```sql
--- テスト用テーブル作成
-CREATE TABLE 品目マスタ (
-    品目コード VARCHAR(20) PRIMARY KEY,
-    品目名 VARCHAR(100) NOT NULL,
-    品目種別 VARCHAR(20),
-    単位 VARCHAR(10),
-    標準原価 DECIMAL(15,2),
-    安全在庫 INTEGER,
-    リードタイム INTEGER
-);
-
-CREATE TABLE 部品表 (
-    親品目コード VARCHAR(20) NOT NULL,
-    子品目コード VARCHAR(20) NOT NULL,
-    員数 DECIMAL(10,4) NOT NULL,
-    PRIMARY KEY (親品目コード, 子品目コード)
-);
-
-CREATE TABLE 発注 (
-    発注番号 VARCHAR(20) PRIMARY KEY,
-    仕入先コード VARCHAR(20) NOT NULL,
-    発注日 DATE NOT NULL,
-    ステータス VARCHAR(10) DEFAULT '作成中'
-);
-
-CREATE TABLE 発注明細 (
-    発注番号 VARCHAR(20) NOT NULL,
-    明細番号 INTEGER NOT NULL,
-    品目コード VARCHAR(20) NOT NULL,
-    発注数量 DECIMAL(10,2) NOT NULL,
-    単価 DECIMAL(15,2),
-    納期 DATE,
-    PRIMARY KEY (発注番号, 明細番号)
-);
-
-CREATE TABLE 在庫 (
-    品目コード VARCHAR(20) NOT NULL,
-    保管場所コード VARCHAR(20) NOT NULL,
-    在庫数量 DECIMAL(10,2) NOT NULL DEFAULT 0,
-    PRIMARY KEY (品目コード, 保管場所コード)
-);
-```
-
-</details>
-
----
-
-## まとめ
-
-本章では、ヘキサゴナルアーキテクチャを採用した生産管理システムの REST API を実装しました。
-
-### 実装したコンポーネント
-
-| レイヤー | コンポーネント | 役割 |
-|---------|--------------|------|
-| Domain | Entity, Exception | ビジネスロジック、ドメインルール |
-| Application | UseCase, Service | ユースケースの実装、トランザクション管理 |
-| Infrastructure | Controller, Repository | 外部との入出力 |
-
-### アーキテクチャの特徴
-
-1. **ヘキサゴナルアーキテクチャ**: ドメインを中心に据えた設計
-2. **Ports and Adapters**: インターフェースと実装の分離
-3. **TDD**: テスト駆動で API を開発
-4. **OpenAPI**: Swagger UI で API 仕様を可視化
-
-### 技術スタック
-
-- **Spring Boot 3.2**: REST API フレームワーク
-- **MyBatis**: O/R マッピング
-- **Bean Validation**: リクエスト検証
-- **springdoc-openapi**: API ドキュメント生成
-- **Testcontainers**: 統合テスト
-
----
-
-[前へ: 第31章 生産管理データ設計（E 社事例）](chapter31.md) | [目次へ戻る](../index.md)