@k2works/claude-code-booster 3.2.1 → 3.3.0

package/lib/assets/docs/article/practical-database-design/study/study2-1.md

@@ -0,0 +1,1693 @@
+# 実践データベース設計：販売管理システム 研究 1 - モノリスサービスの実装
+
+## はじめに
+
+本研究では、API サーバー構成（第13章）とは異なるアプローチとして、**モノリスアーキテクチャ**による販売管理システムを実装します。UI（テンプレートエンジン）、ビジネスロジック、データベースアクセスがすべて同一サーバー内で動作する、伝統的かつ堅実なアーキテクチャです。
+
+---
+
+## 第14章：モノリスアーキテクチャの基礎
+
+### 14.1 モノリスアーキテクチャとは
+
+**モノリス（Monolith / Monolithic Architecture）**とは、「API」と「UI」と「ビジネスロジック」が **1つの実行ユニット**（1つのプロジェクトやバイナリ）にまとまっているアーキテクチャを指します。
+
+```plantuml
+@startuml monolith_architecture
+!define RECTANGLE class
+
+title モノリスアーキテクチャ
+
+package "モノリスサーバー (単一の実行ユニット)" {
+
+  package "プレゼンテーション層" {
+    [Controller]
+    [Thymeleaf テンプレート]
+    [静的リソース (CSS/JS)]
+  }
+
+  package "ビジネスロジック層" {
+    [Application Service]
+    [Domain Model]
+    [Domain Service]
+  }
+
+  package "データアクセス層" {
+    [Repository]
+    [MyBatis Mapper]
+  }
+}
+
+database "PostgreSQL" as DB
+
+actor "ブラウザ" as Browser
+
+Browser --> [Controller] : HTTP リクエスト
+[Controller] --> [Thymeleaf テンプレート] : モデル渡し
+[Thymeleaf テンプレート] --> Browser : HTML レスポンス
+[Controller] --> [Application Service]
+[Application Service] --> [Domain Model]
+[Application Service] --> [Repository]
+[Repository] --> [MyBatis Mapper]
+[MyBatis Mapper] --> DB
+
+note right of "モノリスサーバー (単一の実行ユニット)"
+  すべてが1つのプロセスで動作
+  - 同一JVMで実行
+  - 同一デプロイユニット
+  - 密結合だが開発・運用がシンプル
+end note
+
+@enduml
+```
+
+**モノリスの主な特徴：**
+
+| 特徴 | 説明 |
+|------|------|
+| **単一デプロイ** | アプリケーション全体が1つのアーティファクト（JAR/WAR）としてデプロイ |
+| **同一プロセス** | UI、ビジネスロジック、データアクセスが同じ JVM で動作 |
+| **テンプレートエンジン** | サーバーサイドで HTML を生成してブラウザに返却 |
+| **セッション管理** | サーバーサイドでユーザーセッションを管理 |
+| **トランザクション境界** | 単一プロセス内でのローカルトランザクション |
+
+---
+
+### 14.2 API サーバー vs モノリス
+
+```plantuml
+@startuml api_vs_monolith
+!define RECTANGLE class
+
+left to right direction
+
+package "API サーバー構成（疎結合）" {
+  package "フロントエンド" as FE {
+    [React/Vue/Angular]
+    [SPA]
+  }
+
+  package "バックエンド" as BE {
+    [REST API]
+    [JSON レスポンス]
+  }
+
+  database "DB1" as DB_API
+
+  FE --> BE : HTTP/JSON
+  BE --> DB_API
+}
+
+package "モノリス構成（密結合）" {
+  package "モノリスサーバー" as Mono {
+    [Controller + View]
+    [テンプレートエンジン]
+    [ビジネスロジック]
+    [データアクセス]
+  }
+
+  database "DB2" as DB_Mono
+
+  Mono --> DB_Mono
+}
+
+actor "ブラウザ (API)" as Browser1
+actor "ブラウザ (Mono)" as Browser2
+
+Browser1 --> FE
+Browser2 --> Mono : HTTP (HTML)
+
+@enduml
+```
+
+| 観点 | API サーバー構成 | モノリス構成 |
+|------|-----------------|-------------|
+| **結合度** | 疎結合（フロントエンドとバックエンドが分離） | 密結合（すべてが同一サーバー） |
+| **フロントエンド** | SPA（React/Vue/Angular） | テンプレートエンジン（Thymeleaf） |
+| **通信方式** | REST API（JSON） | サーバーサイドレンダリング（HTML） |
+| **開発チーム** | フロント/バックエンドで分業可能 | フルスタックで開発 |
+| **デプロイ** | 別々にデプロイ可能 | 単一アーティファクトをデプロイ |
+| **スケーリング** | 個別にスケール可能 | 全体をスケール |
+| **複雑さ** | API 設計・認証・CORS などが必要 | シンプル、設定が少ない |
+| **初期開発速度** | 環境構築に時間がかかる | 素早く開発開始できる |
+| **SEO** | SSR/SSG が必要な場合あり | サーバーサイドレンダリングで SEO フレンドリー |
+
+### 14.3 モノリスを選択すべき場面
+
+**モノリスが適している状況：**
+
+1. **小〜中規模のチーム**：専門のフロントエンドチームがいない場合
+2. **社内システム**：SEO 不要、限られたユーザー数
+3. **業務アプリケーション**：複雑な業務フローをサーバーサイドで処理
+4. **迅速な開発**：MVP やプロトタイプの素早い構築
+5. **運用コスト重視**：インフラ構成をシンプルに保ちたい場合
+
+---
+
+### 14.4 モノリスにおけるヘキサゴナルアーキテクチャ
+
+モノリスであっても、ヘキサゴナルアーキテクチャ（Ports and Adapters）を採用することで、保守性の高い設計を実現できます。
+
+```plantuml
+@startuml hexagonal_monolith
+!define RECTANGLE class
+
+package "Hexagonal Architecture (モノリス版)" {
+
+  RECTANGLE "Application Core\n(Domain + Use Cases)" as core {
+    - Product (商品)
+    - Partner (取引先)
+    - SalesOrder (受注)
+    - Shipment (出荷)
+    - Invoice (請求)
+    - ProductUseCase
+    - SalesOrderUseCase
+    - InvoiceUseCase
+  }
+
+  RECTANGLE "Input Adapters\n(Driving Side)" as input {
+    - Thymeleaf Controller
+    - フォーム処理
+    - セッション管理
+    - リクエスト検証
+  }
+
+  RECTANGLE "Output Adapters\n(Driven Side)" as output {
+    - MyBatis Repository
+    - Database Access
+    - Entity Mapping
+    - 帳票出力
+  }
+}
+
+input --> core : "Input Ports\n(Use Cases)"
+core --> output : "Output Ports\n(Repository Interfaces)"
+
+note top of core
+  純粋なビジネスロジック
+  UI 技術（Thymeleaf）に依存しない
+  テスト可能な状態を維持
+end note
+
+note left of input
+  HTML フォームからの入力
+  サーバーサイドレンダリング
+  セッションベースの認証
+end note
+
+note right of output
+  PostgreSQL + MyBatis
+  帳票生成（PDF/Excel）
+  ファイル出力
+end note
+
+@enduml
+```
+
+---
+
+### 14.5 ディレクトリ構成
+
+```
+apps/sms/backend/src/main/java/com/example/sms/
+├── domain/                       # ドメイン層（API版と共通）
+│   ├── model/
+│   │   ├── product/
+│   │   ├── partner/
+│   │   ├── sales/
+│   │   ├── shipping/
+│   │   ├── invoice/
+│   │   └── receipt/
+│   └── exception/
+│
+├── application/                  # アプリケーション層（API版と共通）
+│   ├── port/
+│   │   ├── in/                  # Input Port（ユースケース）
+│   │   └── out/                 # Output Port（リポジトリ）
+│   └── service/
+│
+├── infrastructure/
+│   ├── out/
+│   │   └── persistence/         # Output Adapter（DB実装）
+│   │       ├── mapper/
+│   │       ├── repository/
+│   │       └── typehandler/
+│   └── in/
+│       └── web/                 # Input Adapter（Web実装）
+│           ├── controller/      # Thymeleaf Controller
+│           ├── form/            # フォームオブジェクト
+│           └── helper/          # ビューヘルパー
+│
+└── config/
+
+apps/sms/backend/src/main/resources/
+├── templates/                    # Thymeleaf テンプレート
+│   ├── layout/                   # 共通レイアウト
+│   ├── products/                 # 商品マスタ画面
+│   ├── partners/                 # 取引先マスタ画面
+│   ├── orders/                   # 受注画面
+│   ├── shipments/                # 出荷画面
+│   └── invoices/                 # 請求画面
+├── static/                       # 静的リソース
+│   ├── css/
+│   ├── js/
+│   └── images/
+├── mapper/                       # MyBatis Mapper XML
+└── messages.properties           # メッセージリソース
+```
+
+---
+
+### 14.6 技術スタックの導入
+
+#### build.gradle.kts
+
+<details>
+<summary>コード例: build.gradle.kts</summary>
+
+```kotlin
+plugins {
+    id("java")
+    id("org.springframework.boot") version "3.4.1"
+    id("io.spring.dependency-management") version "1.1.7"
+}
+
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
+}
+
+dependencies {
+    // Spring Boot Web（REST APIではなくMVCとして使用）
+    implementation("org.springframework.boot:spring-boot-starter-web")
+    implementation("org.springframework.boot:spring-boot-starter-validation")
+
+    // Thymeleaf（テンプレートエンジン）
+    implementation("org.springframework.boot:spring-boot-starter-thymeleaf")
+    implementation("nz.net.ultraq.thymeleaf:thymeleaf-layout-dialect:3.4.0")
+
+    // htmx（モダンなインタラクティブUI）
+    // CDN から読み込むため依存関係は不要
+
+    // MyBatis
+    implementation("org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.4")
+
+    // PostgreSQL
+    runtimeOnly("org.postgresql:postgresql")
+
+    // Flyway
+    implementation("org.flywaydb:flyway-core")
+    implementation("org.flywaydb:flyway-database-postgresql")
+
+    // Webjars（Bootstrap等のフロントエンドライブラリ）
+    implementation("org.webjars:bootstrap:5.3.3")
+    implementation("org.webjars:webjars-locator-core:0.59")
+
+    // 帳票出力
+    implementation("org.apache.poi:poi-ooxml:5.3.0")  // Excel
+    implementation("io.github.openhtmltopdf:openhtmltopdf-pdfbox:1.1.22")  // PDF（Thymeleaf + HTML/CSS）
+    implementation("io.github.openhtmltopdf:openhtmltopdf-slf4j:1.1.22")
+
+    // Test
+    testImplementation("org.springframework.boot:spring-boot-starter-test")
+    testImplementation("org.testcontainers:postgresql:1.20.4")
+    testImplementation("org.testcontainers:junit-jupiter:1.20.4")
+
+    // Lombok
+    compileOnly("org.projectlombok:lombok")
+    annotationProcessor("org.projectlombok:lombok")
+}
+```
+
+</details>
+
+---
+
+### 14.7 共通レイアウト（layout/default.html）
+
+<details>
+<summary>コード例: layout/default.html</summary>
+
+```html
+<!DOCTYPE html>
+<html xmlns:th="http://www.thymeleaf.org"
+      xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
+      lang="ja">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title layout:title-pattern="$CONTENT_TITLE - $LAYOUT_TITLE">販売管理システム</title>
+
+    <!-- Bootstrap CSS -->
+    <link rel="stylesheet" th:href="@{/webjars/bootstrap/css/bootstrap.min.css}">
+
+    <!-- カスタム CSS -->
+    <link rel="stylesheet" th:href="@{/css/style.css}">
+
+    <!-- htmx（部分更新用） -->
+    <script src="https://unpkg.com/htmx.org@1.9.12"></script>
+</head>
+<body>
+    <!-- ナビゲーションバー -->
+    <nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+        <div class="container-fluid">
+            <a class="navbar-brand" th:href="@{/}">販売管理システム</a>
+            <div class="collapse navbar-collapse" id="navbarNav">
+                <ul class="navbar-nav">
+                    <li class="nav-item dropdown">
+                        <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown">マスタ</a>
+                        <ul class="dropdown-menu">
+                            <li><a class="dropdown-item" th:href="@{/products}">商品マスタ</a></li>
+                            <li><a class="dropdown-item" th:href="@{/partners}">取引先マスタ</a></li>
+                        </ul>
+                    </li>
+                    <li class="nav-item dropdown">
+                        <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown">販売</a>
+                        <ul class="dropdown-menu">
+                            <li><a class="dropdown-item" th:href="@{/orders}">受注</a></li>
+                            <li><a class="dropdown-item" th:href="@{/shipments}">出荷</a></li>
+                        </ul>
+                    </li>
+                    <li class="nav-item dropdown">
+                        <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown">債権</a>
+                        <ul class="dropdown-menu">
+                            <li><a class="dropdown-item" th:href="@{/invoices}">請求</a></li>
+                            <li><a class="dropdown-item" th:href="@{/receipts}">入金</a></li>
+                        </ul>
+                    </li>
+                </ul>
+            </div>
+        </div>
+    </nav>
+
+    <!-- フラッシュメッセージ -->
+    <div class="container mt-3">
+        <div th:if="${successMessage}" class="alert alert-success alert-dismissible fade show">
+            <span th:text="${successMessage}"></span>
+            <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
+        </div>
+        <div th:if="${errorMessage}" class="alert alert-danger alert-dismissible fade show">
+            <span th:text="${errorMessage}"></span>
+            <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
+        </div>
+    </div>
+
+    <!-- メインコンテンツ -->
+    <main class="container mt-4">
+        <div layout:fragment="content"></div>
+    </main>
+
+    <!-- Bootstrap JS -->
+    <script th:src="@{/webjars/bootstrap/js/bootstrap.bundle.min.js}"></script>
+    <th:block layout:fragment="scripts"></th:block>
+</body>
+</html>
+```
+
+</details>
+
+---
+
+### 14.8 htmx による部分更新
+
+モノリスアプリケーションでも、**htmx** を使用することで SPA のような操作性を実現できます。
+
+```plantuml
+@startuml htmx_flow
+title htmx による部分更新
+
+actor "ブラウザ" as Browser
+participant "htmx" as htmx
+participant "Controller" as Controller
+participant "Thymeleaf\nフラグメント" as Fragment
+
+Browser -> htmx : ボタンクリック
+htmx -> Controller : AJAX リクエスト\n(hx-get/hx-post)
+Controller -> Fragment : フラグメントを\nレンダリング
+Fragment --> Controller : HTML フラグメント
+Controller --> htmx : HTML レスポンス
+htmx -> Browser : DOM を部分更新\n(hx-target)
+
+note right of htmx
+  htmx は特別な属性（hx-*）を
+  使って AJAX 通信を行う
+  JavaScript を書かずに
+  インタラクティブな UI を実現
+end note
+
+@enduml
+```
+
+#### htmx の基本的な使い方
+
+<details>
+<summary>コード例: htmx による商品検索</summary>
+
+```html
+<!-- 商品検索（部分更新） -->
+<input type="text" class="form-control"
+       hx-get="/products/search"
+       hx-trigger="keyup changed delay:300ms"
+       hx-target="#search-results"
+       hx-indicator="#loading">
+<span id="loading" class="htmx-indicator">検索中...</span>
+
+<div id="search-results">
+    <!-- Controller から返される HTML フラグメント -->
+</div>
+```
+
+</details>
+
+---
+
+## 第15章：マスタの実装
+
+### 15.1 商品マスタ画面の設計
+
+| 画面 | URL | メソッド | 説明 |
+|------|-----|---------|------|
+| 商品一覧 | /products | GET | 商品の検索・一覧表示 |
+| 商品詳細 | /products/{productCode} | GET | 商品の詳細表示 |
+| 商品登録 | /products/new | GET | 登録フォーム表示 |
+| 商品登録処理 | /products | POST | 登録処理 |
+| 商品編集 | /products/{productCode}/edit | GET | 編集フォーム表示 |
+| 商品更新処理 | /products/{productCode} | POST | 更新処理（PUT 代替） |
+| 商品削除処理 | /products/{productCode}/delete | POST | 削除処理（DELETE 代替） |
+
+### 15.2 フォームオブジェクトの設計
+
+<details>
+<summary>コード例: ProductForm.java</summary>
+
+```java
+package com.example.sms.infrastructure.in.web.form;
+
+import com.example.sms.application.port.in.CreateProductCommand;
+import com.example.sms.domain.model.product.ProductCategory;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Positive;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * 商品登録・編集フォーム
+ */
+@Data
+public class ProductForm {
+
+    @NotBlank(message = "商品コードは必須です")
+    @Size(max = 20, message = "商品コードは20文字以内で入力してください")
+    private String productCode;
+
+    @NotBlank(message = "商品名は必須です")
+    @Size(max = 100, message = "商品名は100文字以内で入力してください")
+    private String productName;
+
+    @NotNull(message = "商品区分は必須です")
+    private ProductCategory category;
+
+    @Positive(message = "単価は正の数で入力してください")
+    private BigDecimal unitPrice;
+
+    /**
+     * フォームをコマンドに変換
+     */
+    public CreateProductCommand toCommand() {
+        return CreateProductCommand.builder()
+            .productCode(this.productCode)
+            .productName(this.productName)
+            .category(this.category)
+            .unitPrice(this.unitPrice)
+            .build();
+    }
+
+    /**
+     * エンティティからフォームを生成
+     */
+    public static ProductForm from(Product product) {
+        ProductForm form = new ProductForm();
+        form.setProductCode(product.getProductCode());
+        form.setProductName(product.getProductName());
+        form.setCategory(product.getCategory());
+        form.setUnitPrice(product.getUnitPrice());
+        return form;
+    }
+}
+```
+
+</details>
+
+### 15.3 商品 Controller の TDD 実装
+
+<details>
+<summary>コード例: ProductControllerTest.java</summary>
+
+```java
+@SpringBootTest
+@AutoConfigureMockMvc
+@Testcontainers
+@DisplayName("商品マスタ画面")
+class ProductControllerTest {
+
+    @Container
+    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16")
+            .withDatabaseName("sms_test");
+
+    @DynamicPropertySource
+    static void configureProperties(DynamicPropertyRegistry registry) {
+        registry.add("spring.datasource.url", postgres::getJdbcUrl);
+    }
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @Test
+    @DisplayName("商品一覧画面を表示できる")
+    void shouldDisplayProductList() throws Exception {
+        mockMvc.perform(get("/products"))
+            .andExpect(status().isOk())
+            .andExpect(view().name("products/list"))
+            .andExpect(model().attributeExists("products"));
+    }
+
+    @Test
+    @DisplayName("商品を登録できる")
+    void shouldCreateProduct() throws Exception {
+        mockMvc.perform(post("/products")
+                .param("productCode", "NEW-001")
+                .param("productName", "新規商品")
+                .param("category", "FINISHED_GOODS")
+                .param("unitPrice", "1000"))
+            .andExpect(status().is3xxRedirection())
+            .andExpect(redirectedUrl("/products"))
+            .andExpect(flash().attribute("successMessage", containsString("登録")));
+    }
+}
+```
+
+</details>
+
+### 15.4 商品 Controller
+
+<details>
+<summary>コード例: ProductController.java</summary>
+
+```java
+@Controller
+@RequestMapping("/products")
+public class ProductController {
+
+    private final ProductUseCase productUseCase;
+
+    public ProductController(ProductUseCase productUseCase) {
+        this.productUseCase = productUseCase;
+    }
+
+    @GetMapping
+    public String list(@RequestParam(required = false) ProductCategory category, Model model) {
+        List<Product> products = category != null
+            ? productUseCase.findByCategory(category)
+            : productUseCase.findAll();
+        model.addAttribute("products", products);
+        model.addAttribute("categories", ProductCategory.values());
+        return "products/list";
+    }
+
+    @GetMapping("/new")
+    public String newForm(Model model) {
+        model.addAttribute("form", new ProductForm());
+        model.addAttribute("categories", ProductCategory.values());
+        return "products/new";
+    }
+
+    @PostMapping
+    public String create(
+            @Valid @ModelAttribute("form") ProductForm form,
+            BindingResult bindingResult,
+            RedirectAttributes redirectAttributes,
+            Model model) {
+
+        if (bindingResult.hasErrors()) {
+            model.addAttribute("categories", ProductCategory.values());
+            return "products/new";
+        }
+
+        productUseCase.createProduct(form.toCommand());
+        redirectAttributes.addFlashAttribute("successMessage", "商品を登録しました");
+        return "redirect:/products";
+    }
+
+    @GetMapping("/{productCode}/edit")
+    public String editForm(@PathVariable String productCode, Model model) {
+        Product product = productUseCase.findByCode(productCode)
+            .orElseThrow(() -> new ProductNotFoundException(productCode));
+        model.addAttribute("form", ProductForm.from(product));
+        model.addAttribute("categories", ProductCategory.values());
+        return "products/edit";
+    }
+
+    @PostMapping("/{productCode}")
+    public String update(
+            @PathVariable String productCode,
+            @Valid @ModelAttribute("form") ProductForm form,
+            BindingResult bindingResult,
+            RedirectAttributes redirectAttributes,
+            Model model) {
+
+        if (bindingResult.hasErrors()) {
+            model.addAttribute("categories", ProductCategory.values());
+            return "products/edit";
+        }
+
+        productUseCase.updateProduct(productCode, form.toCommand());
+        redirectAttributes.addFlashAttribute("successMessage", "商品を更新しました");
+        return "redirect:/products/" + productCode;
+    }
+
+    @PostMapping("/{productCode}/delete")
+    public String delete(@PathVariable String productCode, RedirectAttributes redirectAttributes) {
+        productUseCase.deleteProduct(productCode);
+        redirectAttributes.addFlashAttribute("successMessage", "商品を削除しました");
+        return "redirect:/products";
+    }
+}
+```
+
+</details>
+
+---
+
+## 第16章：トランザクションの実装
+
+### 16.1 受注業務画面の実装
+
+#### 受注 Controller
+
+<details>
+<summary>コード例: OrderController.java</summary>
+
+```java
+@Controller
+@RequestMapping("/orders")
+public class OrderController {
+
+    private final OrderUseCase orderUseCase;
+    private final ProductUseCase productUseCase;
+    private final PartnerUseCase partnerUseCase;
+
+    @GetMapping
+    public String list(
+            @RequestParam(required = false) String status,
+            @RequestParam(required = false) String customerCode,
+            Model model) {
+
+        List<Order> orders = orderUseCase.getOrders(status, customerCode);
+        model.addAttribute("orders", orders);
+        model.addAttribute("customers", partnerUseCase.getCustomers());
+        return "orders/list";
+    }
+
+    @GetMapping("/new")
+    public String newForm(Model model) {
+        model.addAttribute("form", new OrderForm());
+        model.addAttribute("customers", partnerUseCase.getCustomers());
+        model.addAttribute("products", productUseCase.getAllProducts());
+        return "orders/new";
+    }
+
+    @PostMapping
+    public String create(
+            @Valid @ModelAttribute("form") OrderForm form,
+            BindingResult bindingResult,
+            Model model,
+            RedirectAttributes redirectAttributes) {
+
+        if (bindingResult.hasErrors()) {
+            model.addAttribute("customers", partnerUseCase.getCustomers());
+            model.addAttribute("products", productUseCase.getAllProducts());
+            return "orders/new";
+        }
+
+        Order order = orderUseCase.createOrder(form.toCommand());
+        redirectAttributes.addFlashAttribute("successMessage",
+            "受注「" + order.getOrderNumber() + "」を登録しました");
+        return "redirect:/orders";
+    }
+
+    @PostMapping("/{orderNumber}/confirm")
+    public String confirm(@PathVariable String orderNumber, RedirectAttributes redirectAttributes) {
+        orderUseCase.confirmOrder(orderNumber);
+        redirectAttributes.addFlashAttribute("successMessage",
+            "受注「" + orderNumber + "」を確定しました");
+        return "redirect:/orders/" + orderNumber;
+    }
+
+    @PostMapping("/{orderNumber}/cancel")
+    public String cancel(@PathVariable String orderNumber, RedirectAttributes redirectAttributes) {
+        orderUseCase.cancelOrder(orderNumber);
+        redirectAttributes.addFlashAttribute("successMessage",
+            "受注「" + orderNumber + "」を取り消しました");
+        return "redirect:/orders";
+    }
+}
+```
+
+</details>
+
+### 16.2 動的フォーム（明細行の追加・削除）
+
+htmx を使用して、ページをリロードせずに明細行を追加・削除できます。
+
+<details>
+<summary>コード例: 動的フォーム（明細行）</summary>
+
+```html
+<!-- 明細追加ボタン -->
+<button type="button" class="btn btn-sm btn-outline-primary"
+        hx-get="/orders/add-detail-row"
+        hx-target="#detail-rows"
+        hx-swap="beforeend"
+        hx-vals='js:{"index": document.querySelectorAll("#detail-rows tr").length}'>
+    <i class="bi bi-plus"></i> 行追加
+</button>
+
+<!-- 明細行フラグメント -->
+<tr th:fragment="detailRow" th:id="'row-' + ${index}">
+    <td>
+        <select class="form-select product-select"
+                th:name="'details[' + ${index} + '].productCode'" required
+                onchange="updatePrice(this)">
+            <option value="">選択</option>
+            <option th:each="product : ${products}"
+                    th:value="${product.productCode}"
+                    th:text="${product.productCode + ' - ' + product.productName}"
+                    th:data-price="${product.unitPrice}"></option>
+        </select>
+    </td>
+    <td>
+        <input type="number" class="form-control quantity-input"
+               th:name="'details[' + ${index} + '].quantity'" min="1" value="1" required
+               onchange="calculateAmount(this)">
+    </td>
+    <td>
+        <input type="number" class="form-control price-input"
+               th:name="'details[' + ${index} + '].unitPrice'" step="1" min="0"
+               onchange="calculateAmount(this)">
+    </td>
+    <td>
+        <input type="text" class="form-control amount-display" readonly value="0">
+    </td>
+    <td>
+        <button type="button" class="btn btn-sm btn-outline-danger"
+                onclick="this.closest('tr').remove(); calculateTotal()">削除</button>
+    </td>
+</tr>
+```
+
+</details>
+
+### 16.3 出荷業務画面の実装
+
+<details>
+<summary>コード例: ShipmentController.java</summary>
+
+```java
+@Controller
+@RequestMapping("/shipments")
+public class ShipmentController {
+
+    private final ShipmentUseCase shipmentUseCase;
+    private final OrderUseCase orderUseCase;
+
+    @GetMapping
+    public String list(
+            @RequestParam(required = false) String status,
+            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate shipmentDate,
+            Model model) {
+
+        List<Shipment> shipments = shipmentDate != null
+            ? shipmentUseCase.getShipmentsByDate(shipmentDate)
+            : shipmentUseCase.getShipments(status);
+
+        model.addAttribute("shipments", shipments);
+        model.addAttribute("today", LocalDate.now());
+        return "shipments/list";
+    }
+
+    @PostMapping("/{shipmentNumber}/execute")
+    public String execute(@PathVariable String shipmentNumber, RedirectAttributes redirectAttributes) {
+        try {
+            shipmentUseCase.executeShipment(shipmentNumber);
+            redirectAttributes.addFlashAttribute("successMessage",
+                "出荷「" + shipmentNumber + "」を実行しました");
+        } catch (InsufficientInventoryException e) {
+            redirectAttributes.addFlashAttribute("errorMessage",
+                "在庫不足のため出荷できません: " + e.getMessage());
+        }
+        return "redirect:/shipments/" + shipmentNumber;
+    }
+}
+```
+
+</details>
+
+---
+
+## 第17章：エラーハンドリングと帳票出力
+
+### 17.1 グローバル例外ハンドラ
+
+<details>
+<summary>コード例: GlobalExceptionHandler.java</summary>
+
+```java
+@ControllerAdvice
+public class GlobalExceptionHandler {
+
+    private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);
+
+    /**
+     * 業務エラー（リソース未検出）
+     */
+    @ExceptionHandler(ResourceNotFoundException.class)
+    public String handleResourceNotFound(ResourceNotFoundException ex, Model model) {
+        logger.warn("リソース未検出: {}", ex.getMessage());
+        model.addAttribute("errorMessage", ex.getMessage());
+        return "error/404";
+    }
+
+    /**
+     * 業務エラー（バリデーション）
+     */
+    @ExceptionHandler(BusinessValidationException.class)
+    public String handleBusinessValidation(BusinessValidationException ex, Model model) {
+        logger.warn("業務バリデーションエラー: {}", ex.getMessage());
+        model.addAttribute("errorMessage", ex.getMessage());
+        model.addAttribute("errorCode", ex.getErrorCode());
+        return "error/business";
+    }
+
+    /**
+     * システムエラー
+     */
+    @ExceptionHandler(Exception.class)
+    public String handleGeneralException(Exception ex, Model model) {
+        logger.error("システムエラー", ex);
+        model.addAttribute("errorMessage", "システムエラーが発生しました。管理者にお問い合わせください。");
+        return "error/500";
+    }
+}
+```
+
+</details>
+
+### 17.2 Excel 帳票出力
+
+<details>
+<summary>コード例: ReportController.java（Excel 出力）</summary>
+
+```java
+@Controller
+@RequestMapping("/reports")
+public class ReportController {
+
+    private final ReportUseCase reportUseCase;
+
+    @GetMapping("/inventory/excel")
+    public void exportInventoryExcel(HttpServletResponse response) throws IOException {
+        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+        response.setHeader("Content-Disposition",
+            "attachment; filename=inventory_" + LocalDate.now() + ".xlsx");
+
+        try (Workbook workbook = new XSSFWorkbook()) {
+            Sheet sheet = workbook.createSheet("在庫一覧");
+
+            // ヘッダー行
+            Row headerRow = sheet.createRow(0);
+            CellStyle headerStyle = createHeaderStyle(workbook);
+            String[] headers = {"商品コード", "商品名", "現在在庫", "安全在庫", "過不足"};
+            for (int i = 0; i < headers.length; i++) {
+                Cell cell = headerRow.createCell(i);
+                cell.setCellValue(headers[i]);
+                cell.setCellStyle(headerStyle);
+            }
+
+            // データ行
+            List<InventoryData> inventoryList = reportUseCase.getInventoryReport();
+            int rowNum = 1;
+            for (InventoryData data : inventoryList) {
+                Row row = sheet.createRow(rowNum++);
+                row.createCell(0).setCellValue(data.getProductCode());
+                row.createCell(1).setCellValue(data.getProductName());
+                row.createCell(2).setCellValue(data.getCurrentStock());
+                row.createCell(3).setCellValue(data.getSafetyStock());
+                row.createCell(4).setCellValue(data.getDifference());
+            }
+
+            // 列幅自動調整
+            for (int i = 0; i < headers.length; i++) {
+                sheet.autoSizeColumn(i);
+            }
+
+            workbook.write(response.getOutputStream());
+        }
+    }
+}
+```
+
+</details>
+
+### 17.3 PDF 帳票出力（Thymeleaf + OpenHTMLtoPDF）
+
+PDF 帳票は **Thymeleaf テンプレート + OpenHTMLtoPDF** を使用して実装します。この方式により、HTML/CSS で帳票のレイアウトを定義でき、デザインの自由度が高く保守性も向上します。
+
+```plantuml
+@startuml pdf_generation_flow
+title PDF 生成フロー
+
+participant "Controller" as C
+participant "PdfGeneratorService" as PDF
+participant "TemplateEngine" as T
+participant "PdfRendererBuilder" as R
+
+C -> PDF : generatePdf(templateName, variables)
+PDF -> T : process(templateName, context)
+T --> PDF : HTML 文字列
+PDF -> R : withHtmlContent(html, null)
+R -> R : run()
+R --> PDF : PDF バイナリ
+PDF --> C : byte[]
+
+@enduml
+```
+
+#### PDF 生成サービス
+
+<details>
+<summary>コード例: PdfGeneratorService.java</summary>
+
+```java
+package com.example.sms.infrastructure.in.web.service;
+
+import com.openhtmltopdf.pdfboxout.PdfRendererBuilder;
+import org.springframework.core.io.ClassPathResource;
+import org.springframework.stereotype.Service;
+import org.thymeleaf.TemplateEngine;
+import org.thymeleaf.context.Context;
+
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.IOException;
+import java.util.Map;
+
+/**
+ * PDF生成サービス.
+ * ThymeleafテンプレートからPDFを生成する.
+ */
+@Service
+public class PdfGeneratorService {
+
+    private static final String FONT_FAMILY = "Japanese";
+
+    /** Windowsのシステムフォントパス. */
+    private static final String[] WINDOWS_FONTS = {
+        "C:/Windows/Fonts/YuGothM.ttc",   // Yu Gothic Medium
+        "C:/Windows/Fonts/YuGothR.ttc",   // Yu Gothic Regular
+        "C:/Windows/Fonts/msgothic.ttc",  // MS Gothic
+        "C:/Windows/Fonts/meiryo.ttc"     // Meiryo
+    };
+
+    private final TemplateEngine templateEngine;
+    private final File japaneseFontFile;
+
+    public PdfGeneratorService(TemplateEngine templateEngine) {
+        this.templateEngine = templateEngine;
+        this.japaneseFontFile = findJapaneseFont();
+    }
+
+    /**
+     * ThymeleafテンプレートからPDFを生成する.
+     */
+    public byte[] generatePdf(String templateName, Map<String, Object> variables) {
+        Context context = new Context();
+        context.setVariables(variables);
+        String html = templateEngine.process(templateName, context);
+
+        try (ByteArrayOutputStream outputStream = new ByteArrayOutputStream()) {
+            PdfRendererBuilder builder = new PdfRendererBuilder()
+                .useFastMode();
+
+            // 日本語フォントを登録
+            if (japaneseFontFile != null) {
+                builder = builder.useFont(japaneseFontFile, FONT_FAMILY);
+            }
+
+            builder.withHtmlContent(html, null)
+                .toStream(outputStream)
+                .run();
+
+            return outputStream.toByteArray();
+        } catch (IOException e) {
+            throw new PdfGenerationException("PDF生成に失敗しました", e);
+        }
+    }
+
+    /** 日本語フォントを検索する. */
+    private File findJapaneseFont() {
+        // クラスパスからフォントを検索
+        ClassPathResource fontResource = new ClassPathResource("fonts/NotoSansJP-Regular.ttf");
+        if (fontResource.exists()) {
+            try {
+                return fontResource.getFile();
+            } catch (IOException e) {
+                // クラスパスからの読み込み失敗時はシステムフォントを試す
+            }
+        }
+
+        // Windowsのシステムフォントを検索
+        for (String fontPath : WINDOWS_FONTS) {
+            File fontFile = new File(fontPath);
+            if (fontFile.exists()) {
+                return fontFile;
+            }
+        }
+        return null;
+    }
+}
+```
+
+</details>
+
+**日本語フォント対応のポイント：**
+
+| ポイント | 説明 |
+|---------|------|
+| **フォント登録** | `builder.useFont(fontFile, fontFamily)` でフォントを登録 |
+| **CSS でフォント指定** | `font-family: Japanese, sans-serif;` で登録したフォントを参照 |
+| **システムフォント** | Windows は Yu Gothic、macOS はヒラギノなどを自動検出 |
+| **カスタムフォント** | `resources/fonts/` に TTF ファイルを配置して使用可能 |
+
+#### PDF 用 HTML テンプレート
+
+<details>
+<summary>コード例: reports/invoice-pdf.html</summary>
+
+```html
+<!DOCTYPE html>
+<html xmlns:th="http://www.thymeleaf.org" lang="ja">
+<head>
+    <meta charset="UTF-8"/>
+    <title>請求書</title>
+    <style>
+        @page {
+            size: A4;
+            margin: 20mm;
+        }
+        body {
+            /* "Japanese" は PdfGeneratorService で登録したフォントファミリー名 */
+            font-family: Japanese, "Noto Sans JP", "Hiragino Sans", sans-serif;
+            font-size: 10pt;
+            line-height: 1.5;
+        }
+        .header {
+            text-align: center;
+            margin-bottom: 30px;
+        }
+        .header h1 {
+            font-size: 24pt;
+            margin: 0;
+        }
+        .amount-box {
+            border: 2px solid #333;
+            padding: 15px;
+            margin-bottom: 30px;
+            text-align: center;
+        }
+        .amount-box .value {
+            font-size: 20pt;
+            font-weight: bold;
+        }
+        table {
+            width: 100%;
+            border-collapse: collapse;
+            margin-bottom: 20px;
+        }
+        th, td {
+            border: 1px solid #333;
+            padding: 8px;
+        }
+        th {
+            background-color: #f0f0f0;
+            text-align: center;
+        }
+        td.number {
+            text-align: right;
+        }
+    </style>
+</head>
+<body>
+    <div class="header">
+        <h1>請求書</h1>
+    </div>
+
+    <div class="meta">
+        <p>請求番号: <span th:text="${invoice.invoiceNumber}"></span></p>
+        <p>請求日: <span th:text="${#temporals.format(invoice.invoiceDate, 'yyyy年MM月dd日')}"></span></p>
+    </div>
+
+    <div class="customer">
+        <p><span th:text="${customerName}"></span> 御中</p>
+    </div>
+
+    <div class="amount-box">
+        <p class="label">ご請求金額</p>
+        <p class="value">¥<span th:text="${#numbers.formatDecimal(invoice.currentInvoiceAmount, 1, 'COMMA', 0, 'POINT')}"></span>-</p>
+    </div>
+
+    <!-- 請求明細テーブル -->
+    <table th:if="${invoice.details != null and !invoice.details.isEmpty()}">
+        <thead>
+            <tr>
+                <th>売上番号</th>
+                <th>売上日</th>
+                <th>売上金額</th>
+                <th>消費税</th>
+                <th>合計</th>
+            </tr>
+        </thead>
+        <tbody>
+            <tr th:each="detail : ${invoice.details}">
+                <td th:text="${detail.salesNumber}"></td>
+                <td th:text="${#temporals.format(detail.salesDate, 'yyyy/MM/dd')}"></td>
+                <td class="number" th:text="${#numbers.formatDecimal(detail.salesAmount, 1, 'COMMA', 0, 'POINT')}"></td>
+                <td class="number" th:text="${#numbers.formatDecimal(detail.taxAmount, 1, 'COMMA', 0, 'POINT')}"></td>
+                <td class="number" th:text="${#numbers.formatDecimal(detail.totalAmount, 1, 'COMMA', 0, 'POINT')}"></td>
+            </tr>
+        </tbody>
+    </table>
+</body>
+</html>
+```
+
+</details>
+
+#### Controller での PDF 出力
+
+<details>
+<summary>コード例: ReportWebController.java（PDF 出力）</summary>
+
+```java
+@Controller
+@RequestMapping("/reports")
+public class ReportWebController {
+
+    private final ReportService reportService;
+    private final PdfGeneratorService pdfGeneratorService;
+
+    /**
+     * 請求書を PDF 形式でエクスポート.
+     */
+    @GetMapping("/invoice/{invoiceNumber}/pdf")
+    public void exportInvoicePdf(@PathVariable String invoiceNumber, HttpServletResponse response)
+            throws IOException {
+
+        Invoice invoice = reportService.getInvoiceForReport(invoiceNumber);
+        String customerName = reportService.getCustomerName(invoice.getCustomerCode());
+
+        // テンプレート変数を設定
+        Map<String, Object> variables = Map.of(
+            "invoice", invoice,
+            "customerName", customerName
+        );
+
+        // PDFを生成
+        byte[] pdfBytes = pdfGeneratorService.generatePdf("reports/invoice-pdf", variables);
+
+        // レスポンスを設定
+        response.setContentType("application/pdf");
+        response.setHeader("Content-Disposition",
+            "attachment; filename=invoice_" + invoiceNumber + ".pdf");
+        response.setContentLength(pdfBytes.length);
+        response.getOutputStream().write(pdfBytes);
+    }
+}
+```
+
+</details>
+
+#### Thymeleaf + OpenHTMLtoPDF のメリット
+
+| 観点 | 説明 |
+|------|------|
+| **デザインの自由度** | HTML/CSS でレイアウトを定義できるため、複雑なデザインも容易 |
+| **保守性** | HTML テンプレートなので、プログラマー以外でも修正しやすい |
+| **再利用** | 同じテンプレートを Web 表示とPDF 出力で共有可能 |
+| **プレビュー** | ブラウザで HTML として確認後、PDF 出力できる |
+| **日本語対応** | CSS で日本語フォントを指定するだけで対応可能 |
+
+---
+
+## 第18章：ページネーション
+
+### 18.1 ページネーションの概要
+
+大量のデータを扱う一覧画面では、パフォーマンスとユーザビリティの観点から**ページネーション**（ページ分割）が必要です。本章では、商品マスタ画面を例に、ヘキサゴナルアーキテクチャに沿ったページネーション機能の実装方法を解説します。
+
+```plantuml
+@startuml pagination_flow
+title ページネーション処理フロー
+
+actor "ブラウザ" as Browser
+participant "ProductWebController" as Controller
+participant "ProductService" as Service
+participant "ProductRepositoryImpl" as Repository
+participant "ProductMapper" as Mapper
+database "PostgreSQL" as DB
+
+Browser -> Controller : GET /products?page=0&size=10
+Controller -> Service : getProducts(page, size, category, keyword)
+Service -> Repository : findWithPagination(page, size, category, keyword)
+Repository -> Mapper : findWithPagination(offset, limit, category, keyword)
+Mapper -> DB : SELECT ... LIMIT #{limit} OFFSET #{offset}
+DB --> Mapper : 商品データ（10件）
+Repository -> Mapper : count(category, keyword)
+Mapper -> DB : SELECT COUNT(*) ...
+DB --> Mapper : 総件数
+Repository --> Service : PageResult<Product>
+Service --> Controller : PageResult<Product>
+Controller -> Browser : products/list.html\n（ページネーション UI 付き）
+
+@enduml
+```
+
+### 18.2 ページネーション結果クラス
+
+ページネーション結果を表す汎用クラスを定義します。
+
+<details>
+<summary>コード例: PageResult.java</summary>
+
+```java
+package com.example.sms.domain.model.common;
+
+import java.util.List;
+
+/**
+ * ページネーション結果を表すクラス.
+ *
+ * @param <T> 要素の型
+ */
+public class PageResult<T> {
+
+    private final List<T> content;
+    private final int pageNumber;
+    private final int pageSize;
+    private final long totalElements;
+    private final int totalPages;
+
+    public PageResult(List<T> content, int pageNumber, int pageSize, long totalElements) {
+        this.content = content;
+        this.pageNumber = pageNumber;
+        this.pageSize = pageSize;
+        this.totalElements = totalElements;
+        this.totalPages = pageSize > 0 ? (int) Math.ceil((double) totalElements / pageSize) : 0;
+    }
+
+    public List<T> getContent() { return content; }
+    public int getPage() { return pageNumber; }
+    public int getSize() { return pageSize; }
+    public long getTotalElements() { return totalElements; }
+    public int getTotalPages() { return totalPages; }
+    public boolean hasNext() { return pageNumber < totalPages - 1; }
+    public boolean hasPrevious() { return pageNumber > 0; }
+    public boolean isFirst() { return pageNumber == 0; }
+    public boolean isLast() { return pageNumber >= totalPages - 1; }
+    public int getNumber() { return pageNumber + 1; }
+
+    public static <T> PageResult<T> empty() {
+        return new PageResult<>(List.of(), 0, 10, 0);
+    }
+}
+```
+
+</details>
+
+### 18.3 MyBatis マッパーの実装
+
+ページネーション用の SQL クエリを追加します。`LIMIT` と `OFFSET` を使用してデータを取得し、`COUNT` で総件数を取得します。
+
+<details>
+<summary>コード例: ProductMapper.xml（抜粋）</summary>
+
+```xml
+<select id="findWithPagination" resultMap="ProductResultMap">
+    SELECT * FROM "商品マスタ"
+    <where>
+        <if test="category != null and category != ''">
+            "商品区分" = #{category}::商品区分
+        </if>
+        <if test="keyword != null and keyword != ''">
+            AND (LOWER("商品コード") LIKE LOWER('%' || #{keyword} || '%')
+                 OR LOWER("商品名") LIKE LOWER('%' || #{keyword} || '%'))
+        </if>
+    </where>
+    ORDER BY "商品コード"
+    LIMIT #{limit} OFFSET #{offset}
+</select>
+
+<select id="count" resultType="long">
+    SELECT COUNT(*) FROM "商品マスタ"
+    <where>
+        <if test="category != null and category != ''">
+            "商品区分" = #{category}::商品区分
+        </if>
+        <if test="keyword != null and keyword != ''">
+            AND (LOWER("商品コード") LIKE LOWER('%' || #{keyword} || '%')
+                 OR LOWER("商品名") LIKE LOWER('%' || #{keyword} || '%'))
+        </if>
+    </where>
+</select>
+```
+
+</details>
+
+<details>
+<summary>コード例: ProductMapper.java</summary>
+
+```java
+@Mapper
+public interface ProductMapper {
+    // 既存のメソッド...
+
+    List<Product> findWithPagination(
+            @Param("offset") int offset,
+            @Param("limit") int limit,
+            @Param("category") String category,
+            @Param("keyword") String keyword);
+
+    long count(@Param("category") String category, @Param("keyword") String keyword);
+}
+```
+
+</details>
+
+### 18.4 リポジトリの実装
+
+Output Port にページネーション用のメソッドを追加します。
+
+<details>
+<summary>コード例: ProductRepository.java（インターフェース）</summary>
+
+```java
+public interface ProductRepository {
+    // 既存のメソッド...
+
+    /**
+     * ページネーション付きで商品を取得.
+     */
+    PageResult<Product> findWithPagination(int page, int size, ProductCategory category, String keyword);
+}
+```
+
+</details>
+
+<details>
+<summary>コード例: ProductRepositoryImpl.java（実装）</summary>
+
+```java
+@Override
+public PageResult<Product> findWithPagination(int page, int size, ProductCategory category, String keyword) {
+    int offset = page * size;
+    String categoryName = category != null ? category.getDisplayName() : null;
+
+    List<Product> products = productMapper.findWithPagination(offset, size, categoryName, keyword);
+    long totalElements = productMapper.count(categoryName, keyword);
+
+    return new PageResult<>(products, page, size, totalElements);
+}
+```
+
+</details>
+
+### 18.5 ユースケースとサービスの実装
+
+Input Port にページネーション用のメソッドを追加します。
+
+<details>
+<summary>コード例: ProductUseCase.java</summary>
+
+```java
+public interface ProductUseCase {
+    // 既存のメソッド...
+
+    /**
+     * ページネーション付きで商品を取得する.
+     */
+    PageResult<Product> getProducts(int page, int size, ProductCategory category, String keyword);
+}
+```
+
+</details>
+
+<details>
+<summary>コード例: ProductService.java</summary>
+
+```java
+@Override
+@Transactional(readOnly = true)
+public PageResult<Product> getProducts(int page, int size, ProductCategory category, String keyword) {
+    return productRepository.findWithPagination(page, size, category, keyword);
+}
+```
+
+</details>
+
+### 18.6 Controller の実装
+
+ページネーションパラメータを受け取り、ビューにページ情報を渡します。
+
+<details>
+<summary>コード例: ProductWebController.java</summary>
+
+```java
+@Controller
+@RequestMapping("/products")
+public class ProductWebController {
+
+    private static final int DEFAULT_PAGE_SIZE = 10;
+
+    private final ProductUseCase productUseCase;
+    // ...
+
+    @GetMapping
+    public String list(
+            @RequestParam(defaultValue = "0") int page,
+            @RequestParam(defaultValue = "10") int size,
+            @RequestParam(required = false) ProductCategory category,
+            @RequestParam(required = false) String keyword,
+            Model model) {
+
+        PageResult<Product> productPage = productUseCase.getProducts(page, size, category, keyword);
+
+        model.addAttribute("products", productPage.getContent());
+        model.addAttribute("page", productPage);
+        model.addAttribute("categories", ProductCategory.values());
+        model.addAttribute("selectedCategory", category);
+        model.addAttribute("keyword", keyword);
+        model.addAttribute("currentSize", size);
+        return "products/list";
+    }
+}
+```
+
+</details>
+
+### 18.7 Thymeleaf テンプレートの実装
+
+Bootstrap のページネーションコンポーネントを使用して UI を実装します。
+
+<details>
+<summary>コード例: products/list.html（ページネーション部分）</summary>
+
+```html
+<!-- 検索フォームに表示件数選択を追加 -->
+<div class="col-md-2">
+    <label class="form-label">表示件数</label>
+    <select name="size" class="form-select">
+        <option value="10" th:selected="${currentSize == 10}">10件</option>
+        <option value="25" th:selected="${currentSize == 25}">25件</option>
+        <option value="50" th:selected="${currentSize == 50}">50件</option>
+        <option value="100" th:selected="${currentSize == 100}">100件</option>
+    </select>
+</div>
+
+<!-- ページネーション -->
+<div class="mt-3">
+    <div class="text-muted text-center mb-2">
+        <span th:if="${page.totalElements > 0}">
+            <span th:text="${page.page * page.size + 1}">1</span> -
+            <span th:text="${page.page * page.size + #lists.size(products)}">10</span> 件
+            （全 <span th:text="${page.totalElements}">0</span> 件）
+        </span>
+        <span th:if="${page.totalElements == 0}">0 件</span>
+    </div>
+
+    <nav th:if="${page.totalPages > 1}" aria-label="ページナビゲーション">
+        <ul class="pagination justify-content-center mb-0">
+            <!-- 最初のページへ -->
+            <li class="page-item" th:classappend="${page.first} ? 'disabled'">
+                <a class="page-link" th:href="@{/products(page=0, size=${currentSize},
+                   category=${selectedCategory?.name()}, keyword=${keyword})}">&laquo;</a>
+            </li>
+            <!-- 前のページへ -->
+            <li class="page-item" th:classappend="${!page.hasPrevious()} ? 'disabled'">
+                <a class="page-link" th:href="@{/products(page=${page.page - 1},
+                   size=${currentSize}, category=${selectedCategory?.name()},
+                   keyword=${keyword})}">&lsaquo;</a>
+            </li>
+
+            <!-- ページ番号 -->
+            <th:block th:with="startPage=${page.page > 2 ? page.page - 2 : 0},
+                               endPage=${page.page + 2 < page.totalPages - 1 ? page.page + 2 : page.totalPages - 1}">
+                <li class="page-item" th:if="${startPage > 0}">
+                    <span class="page-link">...</span>
+                </li>
+                <li th:each="i : ${#numbers.sequence(startPage, endPage)}"
+                    class="page-item"
+                    th:classappend="${i == page.page} ? 'active'">
+                    <a class="page-link"
+                       th:href="@{/products(page=${i}, size=${currentSize},
+                          category=${selectedCategory?.name()}, keyword=${keyword})}"
+                       th:text="${i + 1}">1</a>
+                </li>
+                <li class="page-item" th:if="${endPage < page.totalPages - 1}">
+                    <span class="page-link">...</span>
+                </li>
+            </th:block>
+
+            <!-- 次のページへ -->
+            <li class="page-item" th:classappend="${!page.hasNext()} ? 'disabled'">
+                <a class="page-link" th:href="@{/products(page=${page.page + 1},
+                   size=${currentSize}, category=${selectedCategory?.name()},
+                   keyword=${keyword})}">&rsaquo;</a>
+            </li>
+            <!-- 最後のページへ -->
+            <li class="page-item" th:classappend="${page.last} ? 'disabled'">
+                <a class="page-link" th:href="@{/products(page=${page.totalPages - 1},
+                   size=${currentSize}, category=${selectedCategory?.name()},
+                   keyword=${keyword})}">&raquo;</a>
+            </li>
+        </ul>
+    </nav>
+</div>
+```
+
+</details>
+
+### 18.8 ページネーションの設計ポイント
+
+| ポイント | 説明 |
+|---------|------|
+| **0始まり vs 1始まり** | 内部では0始まり、表示では1始まりを使用 |
+| **デフォルト値** | ページサイズは 10 件程度が一般的 |
+| **検索条件の保持** | ページ遷移時も検索条件（カテゴリ、キーワード）を保持 |
+| **ページ番号の省略** | 大量ページの場合は「...」で省略 |
+| **SQL 最適化** | OFFSET が大きい場合のパフォーマンスに注意 |
+
+### 18.9 パフォーマンス考慮事項
+
+```plantuml
+@startuml offset_performance
+title OFFSET のパフォーマンス問題
+
+note as N1
+**OFFSET が大きい場合の問題**
+
+SELECT * FROM products
+ORDER BY product_code
+LIMIT 10 OFFSET 100000
+
+→ 先頭から100,000件スキャンしてから
+  10件を返す（非効率）
+
+**対策**
+1. Keyset Pagination（カーソル方式）
+2. インデックス付きカラムでの絞り込み
+3. キャッシュの活用
+end note
+
+@enduml
+```
+
+大量データの場合は、OFFSET ベースではなく **Keyset Pagination**（カーソル方式）を検討します：
+
+```sql
+-- OFFSET 方式（非効率）
+SELECT * FROM products ORDER BY product_code LIMIT 10 OFFSET 100000;
+
+-- Keyset Pagination（効率的）
+SELECT * FROM products
+WHERE product_code > 'LAST_SEEN_CODE'
+ORDER BY product_code
+LIMIT 10;
+```
+
+---
+
+## 第10部-B のまとめ
+
+### API サーバー版との比較
+
+| 観点 | API サーバー版 | モノリス版 |
+|------|--------------|-----------|
+| **アーキテクチャ** | フロントエンド分離（SPA） | 統合（Thymeleaf） |
+| **通信** | REST API（JSON） | サーバーサイドレンダリング（HTML） |
+| **状態管理** | クライアント側（localStorage 等） | サーバー側（セッション） |
+| **部分更新** | JavaScript（Axios 等） | htmx |
+| **帳票出力** | API 経由でダウンロード | 直接ダウンロード |
+| **認証** | JWT/OAuth | セッションベース |
+| **複雑さ** | 高（API 設計、CORS 等） | 低（シンプル） |
+| **開発速度** | 初期は遅い | 初期は速い |
+
+### 実装した機能
+
+| カテゴリ | 機能 |
+|---------|------|
+| **商品マスタ** | 一覧、詳細、登録、編集、削除、検索、ページネーション |
+| **取引先マスタ** | 一覧、詳細（取引履歴）、登録、編集、削除、検索 |
+| **受注** | 一覧、登録（動的明細）、確定、取消 |
+| **出荷** | 一覧、出荷指示、出荷実行、取消 |
+| **請求** | 一覧、締処理、請求書発行 |
+| **入金** | 一覧、入金登録、消込処理 |
+| **帳票** | Excel/PDF 出力 |
+| **共通** | レイアウト、エラーハンドリング、フラッシュメッセージ、ページネーション |
+
+### 技術スタック
+
+| カテゴリ | 技術 |
+|---------|------|
+| **言語** | Java 21 |
+| **フレームワーク** | Spring Boot 3.4 |
+| **テンプレート** | Thymeleaf |
+| **部分更新** | htmx |
+| **CSS** | Bootstrap 5 |
+| **ORM** | MyBatis |
+| **データベース** | PostgreSQL 16 |
+| **Excel** | Apache POI |
+| **PDF** | OpenHTMLtoPDF（Thymeleaf + HTML/CSS） |
+| **テスト** | JUnit 5, TestContainers |
+
+### モノリスを選択すべき場面
+
+1. **社内システム**: 限られたユーザー、SEO 不要
+2. **業務アプリケーション**: 複雑な業務フロー
+3. **小規模チーム**: フルスタック開発
+4. **迅速な開発**: MVP、プロトタイプ
+5. **運用コスト重視**: シンプルなインフラ
+
+モノリスアーキテクチャは決して「古い」アーキテクチャではありません。適切な場面で選択することで、シンプルかつ効率的なシステム開発が可能です。