npm - @k2works/claude-code-booster - Versions diffs - 3.6.1 → 3.7.0 - Mend

@k2works/claude-code-booster 3.6.1 → 3.7.0

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

Files changed (713) hide show

package/lib/assets/docs/article/practical-database-design/study/study3-1.md CHANGED Viewed

@@ -1,2205 +1,2205 @@
-# 実践データベース設計：財務会計システム 研究 1 - モノリスサービスの実装
-## はじめに
-本研究では、API サーバー構成（第21章）とは異なるアプローチとして、**モノリスアーキテクチャ**による財務会計システムを実装します。UI（テンプレートエンジン）、ビジネスロジック、データベースアクセスがすべて同一サーバー内で動作する、伝統的かつ堅実なアーキテクチャです。
----
-## 第22章：モノリスアーキテクチャの基礎
-### 22.1 モノリスアーキテクチャとは
-**モノリス（Monolith / Monolithic Architecture）**とは、「API」と「UI」と「ビジネスロジック」が **1つの実行ユニット**（1つのプロジェクトやバイナリ）にまとまっているアーキテクチャを指します。
-```plantuml
-@startuml monolith_architecture
-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 を生成してブラウザに返却 |
-| **セッション管理** | サーバーサイドでユーザーセッションを管理 |
-| **トランザクション境界** | 単一プロセス内でのローカルトランザクション |
----
-### 22.2 API サーバー vs モノリス
-```plantuml
-@startuml api_vs_monolith
-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 フレンドリー |
-### 22.3 モノリスを選択すべき場面
-**モノリスが適している状況：**
-1. **小〜中規模のチーム**：専門のフロントエンドチームがいない場合
-2. **社内システム**：SEO 不要、限られたユーザー数
-3. **業務アプリケーション**：複雑な業務フローをサーバーサイドで処理
-4. **迅速な開発**：MVP やプロトタイプの素早い構築
-5. **運用コスト重視**：インフラ構成をシンプルに保ちたい場合
-**財務会計システムにおけるモノリスのメリット：**
-```
-財務会計システムの特性
-├── 社内利用が中心 → SEO 不要、SPA 不要
-├── 複雑な業務フロー → サーバーサイドで制御が容易
-├── 帳票出力 → サーバーサイドで PDF/Excel 生成
-├── 月次締め・決算処理 → バッチ処理との親和性
-├── 監査証跡 → サーバーサイドでのログ管理
-└── 運用担当者のスキル → シンプルな構成が望ましい
-```
----
-### 22.4 モノリスにおけるヘキサゴナルアーキテクチャ
-モノリスであっても、ヘキサゴナルアーキテクチャ（Ports and Adapters）を採用することで、保守性の高い設計を実現できます。
-```plantuml
-@startuml hexagonal_monolith
-' 左右のレイアウトを強制
-left to right direction
-package "Hexagonal Architecture (財務会計モノリス版)" {
-  rectangle "Application Core\n(Domain + Use Cases)" as core {
-    note as core_list
-      - Account (勘定科目)
-      - Journal (仕訳)
-      - Balance (残高)
-      - JournalDomainService
-      - AccountUseCase
-      - JournalUseCase
-      - BalanceUseCase
-    end note
-  }
-  rectangle "Input Adapters\n(Driving Side)" as input {
-    note as input_list
-      - Thymeleaf Controller
-      - フォーム処理
-      - セッション管理
-      - リクエスト検証
-    end note
-  }
-  rectangle "Output Adapters\n(Driven Side)" as output {
-    note as output_list
-      - MyBatis Repository
-      - Database Access
-      - Entity Mapping
-      - 帳票出力 (PDF/Excel)
-    end note
-  }
-  ' 接続線をパッケージ内に配置し、方向を指定
-  input --> core : "Input Ports\n(Use Cases)"
-  core --> output : "Output Ports\n(Repository Interfaces)"
-}
-' 注釈の配置
-note top of core
-  純粋なビジネスロジック
-  UI 技術（Thymeleaf）に依存しない
-  テスト可能な状態を維持
-end note
-note bottom of input
-  HTML フォームからの入力
-  サーバーサイドレンダリング
-  セッションベースの認証
-end note
-note bottom of output
-  PostgreSQL + MyBatis
-  帳票生成（PDF/Excel）
-  ファイル出力
-end note
-@enduml
-```
-**モノリスでもヘキサゴナルアーキテクチャを適用する理由：**
-1. **テスト容易性**：ドメインロジックを UI から分離してテスト可能
-2. **将来の移行**：必要に応じて API 層を追加可能
-3. **保守性**：関心の分離により変更影響を局所化
-4. **再利用性**：ドメインロジックを複数の UI で共有可能
----
-### 22.5 ディレクトリ構成
-```
-src/main/java/com/example/accounting/
-├── domain/                     # ドメイン層（API版と共通）
-│   ├── model/
-│   │   ├── account/           # 勘定科目
-│   │   ├── journal/           # 仕訳
-│   │   ├── balance/           # 残高
-│   │   └── department/        # 部門
-│   └── exception/
-│
-├── application/               # アプリケーション層（API版と共通）
-│   ├── port/
-│   │   ├── in/               # Input Port（ユースケース）
-│   │   └── out/              # Output Port（リポジトリ）
-│   └── service/
-│
-├── infrastructure/
-│   ├── persistence/          # Output Adapter（DB実装）
-│   │   ├── mapper/
-│   │   └── repository/
-│   └── web/                  # Input Adapter（Web実装）
-│       ├── controller/       # Thymeleaf Controller
-│       ├── form/             # フォームオブジェクト
-│       └── helper/           # ビューヘルパー
-│
-├── config/
-│
-└── resources/
-    ├── templates/            # Thymeleaf テンプレート
-    │   ├── layout/           # 共通レイアウト
-    │   ├── accounts/         # 勘定科目マスタ画面
-    │   ├── journals/         # 仕訳入力画面
-    │   ├── balances/         # 残高照会画面
-    │   └── reports/          # 帳票出力画面
-    ├── static/               # 静的リソース
-    │   ├── css/
-    │   ├── js/
-    │   └── images/
-    └── messages.properties   # メッセージリソース
-```
----
-### 22.6 技術スタックの導入
-<details>
-<summary>build.gradle.kts</summary>
-```kotlin
-plugins {
-    id("java")
-    id("org.springframework.boot") version "3.2.0"
-    id("io.spring.dependency-management") version "1.1.4"
-}
-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.3.0")
-    // Thymeleaf + Spring Security（認証機能を使う場合）
-    implementation("org.thymeleaf.extras:thymeleaf-extras-springsecurity6")
-    // htmx（モダンなインタラクティブUI）
-    // CDN から読み込むため依存関係は不要
-    // MyBatis
-    implementation("org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3")
-    // 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.2")
-    implementation("org.webjars:webjars-locator-core:0.55")
-    // 帳票出力
-    implementation("org.apache.poi:poi-ooxml:5.2.5")  // Excel
-    implementation("com.itextpdf:itext7-core:8.0.2")  // PDF
-    // Test
-    testImplementation("org.springframework.boot:spring-boot-starter-test")
-    testImplementation("org.testcontainers:postgresql:1.19.3")
-    testImplementation("org.testcontainers:junit-jupiter:1.19.3")
-    // Lombok
-    compileOnly("org.projectlombok:lombok")
-    annotationProcessor("org.projectlombok:lombok")
-}
-```
-</details>
-**パッケージの説明：**
-| パッケージ | 用途 |
-|-----------|------|
-| spring-boot-starter-thymeleaf | サーバーサイドテンプレートエンジン |
-| thymeleaf-layout-dialect | レイアウト継承（共通ヘッダー・フッター） |
-| webjars:bootstrap | CSS フレームワーク（サーバーから配信） |
-| poi-ooxml | Excel ファイル出力（帳票） |
-| itext7-core | PDF ファイル出力（帳票） |
----
-### 22.7 基本的な Spring Boot + Thymeleaf アプリケーション
-<details>
-<summary>アプリケーションクラス</summary>
-```java
-package com.example.accounting;
-import org.springframework.boot.SpringApplication;
-import org.springframework.boot.autoconfigure.SpringBootApplication;
-@SpringBootApplication
-public class AccountingApplication {
-    public static void main(String[] args) {
-        SpringApplication.run(AccountingApplication.class, args);
-    }
-}
-```
-</details>
-<details>
-<summary>application.yml</summary>
-```yaml
-spring:
-  datasource:
-    url: jdbc:postgresql://localhost:5432/accounting
-    username: postgres
-    password: postgres
-  thymeleaf:
-    cache: false  # 開発時はキャッシュ無効
-    prefix: classpath:/templates/
-    suffix: .html
-    encoding: UTF-8
-    mode: HTML
-  messages:
-    basename: messages
-    encoding: UTF-8
-mybatis:
-  mapper-locations: classpath:mapper/*.xml
-  configuration:
-    map-underscore-to-camel-case: true
-server:
-  servlet:
-    session:
-      timeout: 30m  # セッションタイムアウト
-```
-</details>
-<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.10"></script>
-</head>
-<body>
-    <!-- ナビゲーションバー -->
-    <nav class="navbar navbar-expand-lg navbar-dark bg-primary">
-        <div class="container-fluid">
-            <a class="navbar-brand" th:href="@{/}">財務会計システム</a>
-            <button class="navbar-toggler" type="button" data-bs-toggle="collapse"
-                    data-bs-target="#navbarNav">
-                <span class="navbar-toggler-icon"></span>
-            </button>
-            <div class="collapse navbar-collapse" id="navbarNav">
-                <ul class="navbar-nav">
-                    <li class="nav-item dropdown">
-                        <a class="nav-link dropdown-toggle" href="#" role="button"
-                           data-bs-toggle="dropdown">マスタ</a>
-                        <ul class="dropdown-menu">
-                            <li><a class="dropdown-item" th:href="@{/accounts}">勘定科目マスタ</a></li>
-                            <li><a class="dropdown-item" th:href="@{/account-structures}">勘定科目構成</a></li>
-                            <li><a class="dropdown-item" th:href="@{/tax-transactions}">課税取引マスタ</a></li>
-                            <li><a class="dropdown-item" th:href="@{/departments}">部門マスタ</a></li>
-                        </ul>
-                    </li>
-                    <li class="nav-item dropdown">
-                        <a class="nav-link dropdown-toggle" href="#" role="button"
-                           data-bs-toggle="dropdown">仕訳</a>
-                        <ul class="dropdown-menu">
-                            <li><a class="dropdown-item" th:href="@{/journals}">仕訳一覧</a></li>
-                            <li><a class="dropdown-item" th:href="@{/journals/new}">仕訳入力</a></li>
-                            <li><a class="dropdown-item" th:href="@{/journals/import}">仕訳取込</a></li>
-                        </ul>
-                    </li>
-                    <li class="nav-item dropdown">
-                        <a class="nav-link dropdown-toggle" href="#" role="button"
-                           data-bs-toggle="dropdown">照会</a>
-                        <ul class="dropdown-menu">
-                            <li><a class="dropdown-item" th:href="@{/balances/daily}">日次残高照会</a></li>
-                            <li><a class="dropdown-item" th:href="@{/balances/monthly}">月次残高照会</a></li>
-                        </ul>
-                    </li>
-                    <li class="nav-item dropdown">
-                        <a class="nav-link dropdown-toggle" href="#" role="button"
-                           data-bs-toggle="dropdown">帳票</a>
-                        <ul class="dropdown-menu">
-                            <li><a class="dropdown-item" th:href="@{/reports/daily}">日計表</a></li>
-                            <li><a class="dropdown-item" th:href="@{/reports/trial-balance}">合計残高試算表</a></li>
-                            <li><a class="dropdown-item" th:href="@{/reports/ledger}">総勘定元帳</a></li>
-                            <li><hr class="dropdown-divider"></li>
-                            <li><a class="dropdown-item" th:href="@{/reports/balance-sheet}">貸借対照表</a></li>
-                            <li><a class="dropdown-item" th:href="@{/reports/income-statement}">損益計算書</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" role="alert">
-            <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" role="alert">
-            <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>
-    <!-- フッター -->
-    <footer class="footer mt-5 py-3 bg-light">
-        <div class="container text-center">
-            <span class="text-muted">財務会計システム &copy; 2025</span>
-        </div>
-    </footer>
-    <!-- Bootstrap JS -->
-    <script th:src="@{/webjars/bootstrap/js/bootstrap.bundle.min.js}"></script>
-    <!-- ページ固有のスクリプト -->
-    <th:block layout:fragment="scripts"></th:block>
-</body>
-</html>
-```
-</details>
----
-### 22.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
-```
-<details>
-<summary>htmx の基本的な使い方</summary>
-```html
-<!-- 勘定科目検索（部分更新） -->
-<div class="mb-3">
-    <input type="text"
-           class="form-control"
-           name="keyword"
-           placeholder="勘定科目コードまたは勘定科目名で検索"
-           hx-get="/accounts/search"
-           hx-trigger="keyup changed delay:300ms"
-           hx-target="#search-results"
-           hx-indicator="#loading">
-    <span id="loading" class="htmx-indicator">検索中...</span>
-</div>
-<!-- 検索結果がここに挿入される -->
-<div id="search-results">
-    <!-- Controller から返される HTML フラグメント -->
-</div>
-```
-</details>
-<details>
-<summary>部分更新用 Controller</summary>
-```java
-@Controller
-@RequestMapping("/accounts")
-public class AccountController {
-    private final AccountUseCase accountUseCase;
-    // ... コンストラクタ省略
-    /**
-     * htmx 用の検索エンドポイント（フラグメントを返す）
-     */
-    @GetMapping("/search")
-    public String search(
-            @RequestParam(required = false) String keyword,
-            Model model) {
-        List<Account> accounts = accountUseCase.searchAccounts(keyword);
-        model.addAttribute("accounts", accounts);
-        // フラグメントのみを返す
-        return "accounts/search-results :: results";
-    }
-}
-```
-</details>
----
-### 22.9 API サーバー版との Controller の違い
-<details>
-<summary>API サーバー版（REST Controller）</summary>
-```java
-@RestController  // JSON を返す
-@RequestMapping("/api/accounts")
-public class AccountApiController {
-    @GetMapping
-    public ResponseEntity<List<AccountResponse>> getAllAccounts() {
-        List<Account> accounts = accountUseCase.getAllAccounts();
-        return ResponseEntity.ok(accounts.stream()
-            .map(AccountResponse::from)
-            .toList());
-    }
-    @PostMapping
-    public ResponseEntity<AccountResponse> createAccount(
-            @Valid @RequestBody CreateAccountRequest request) {  // JSON リクエスト
-        Account account = accountUseCase.createAccount(request.toCommand());
-        return ResponseEntity.status(HttpStatus.CREATED)
-            .body(AccountResponse.from(account));
-    }
-}
-```
-</details>
-<details>
-<summary>モノリス版（MVC Controller）</summary>
-```java
-@Controller  // HTML を返す
-@RequestMapping("/accounts")
-public class AccountController {
-    @GetMapping
-    public String list(Model model) {
-        List<Account> accounts = accountUseCase.getAllAccounts();
-        model.addAttribute("accounts", accounts);
-        return "accounts/list";  // Thymeleaf テンプレート
-    }
-    @PostMapping
-    public String create(
-            @Valid @ModelAttribute("form") AccountForm form,  // フォームデータ
-            BindingResult bindingResult,
-            RedirectAttributes redirectAttributes) {
-        if (bindingResult.hasErrors()) {
-            return "accounts/new";  // バリデーションエラー時は入力画面に戻る
-        }
-        accountUseCase.createAccount(form.toCommand());
-        redirectAttributes.addFlashAttribute("successMessage", "勘定科目を登録しました");
-        return "redirect:/accounts";  // PRG パターン
-    }
-}
-```
-</details>
-**主な違い：**
-| 観点 | API サーバー版 | モノリス版 |
-|------|--------------|-----------|
-| アノテーション | `@RestController` | `@Controller` |
-| 戻り値 | `ResponseEntity<T>` | テンプレート名（String） |
-| リクエスト | `@RequestBody`（JSON） | `@ModelAttribute`（フォーム） |
-| バリデーション | 例外ハンドラで処理 | `BindingResult` で処理 |
-| レスポンス | JSON | HTML（Thymeleaf） |
-| リダイレクト | 不要 | PRG パターン |
----
-## 第23章：マスタ画面の実装
-### 23.1 勘定科目マスタ画面の設計
-#### 画面一覧
-| 画面 | URL | メソッド | 説明 |
-|------|-----|---------|------|
-| 勘定科目一覧 | /accounts | GET | 勘定科目の検索・一覧表示 |
-| 勘定科目詳細 | /accounts/{accountCode} | GET | 勘定科目の詳細表示 |
-| 勘定科目登録 | /accounts/new | GET | 登録フォーム表示 |
-| 勘定科目登録処理 | /accounts | POST | 登録処理 |
-| 勘定科目編集 | /accounts/{accountCode}/edit | GET | 編集フォーム表示 |
-| 勘定科目更新処理 | /accounts/{accountCode} | POST | 更新処理（PUT 代替） |
-| 勘定科目削除処理 | /accounts/{accountCode}/delete | POST | 削除処理（DELETE 代替） |
-**注意**: HTML フォームは GET/POST のみ対応のため、PUT/DELETE は POST で代替します。
----
-### 23.2 フォームオブジェクトの設計
-<details>
-<summary>AccountForm.java</summary>
-```java
-package com.example.accounting.infrastructure.web.form;
-import com.example.accounting.application.port.in.CreateAccountCommand;
-import com.example.accounting.domain.model.account.*;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import jakarta.validation.constraints.Size;
-import lombok.Data;
-/**
- * 勘定科目登録・編集フォーム
- */
-@Data
-public class AccountForm {
-    @NotBlank(message = "勘定科目コードは必須です")
-    @Size(max = 5, message = "勘定科目コードは5文字以内で入力してください")
-    private String accountCode;
-    @NotBlank(message = "勘定科目名は必須です")
-    @Size(max = 40, message = "勘定科目名は40文字以内で入力してください")
-    private String accountName;
-    @Size(max = 10, message = "勘定科目略名は10文字以内で入力してください")
-    private String accountShortName;
-    @Size(max = 40, message = "勘定科目カナは40文字以内で入力してください")
-    private String accountNameKana;
-    @NotNull(message = "BSPL区分は必須です")
-    private BsplType bsplType;
-    @NotNull(message = "貸借区分は必須です")
-    private DebitCreditType debitCreditType;
-    @NotNull(message = "取引要素区分は必須です")
-    private TransactionElementType transactionElementType;
-    @NotNull(message = "集計区分は必須です")
-    private AggregationType aggregationType;
-    private ManagementAccountType managementAccountType;
-    private ExpenseType expenseType;
-    private SubsidiaryType subsidiaryType;
-    private TaxCalculationType taxCalculationType;
-    private String taxTransactionCode;
-    /**
-     * フォームをコマンドに変換
-     */
-    public CreateAccountCommand toCommand() {
-        return CreateAccountCommand.builder()
-            .accountCode(this.accountCode)
-            .accountName(this.accountName)
-            .accountShortName(this.accountShortName)
-            .accountNameKana(this.accountNameKana)
-            .bsplType(this.bsplType)
-            .debitCreditType(this.debitCreditType)
-            .transactionElementType(this.transactionElementType)
-            .aggregationType(this.aggregationType)
-            .managementAccountType(this.managementAccountType)
-            .expenseType(this.expenseType)
-            .subsidiaryType(this.subsidiaryType)
-            .taxCalculationType(this.taxCalculationType)
-            .taxTransactionCode(this.taxTransactionCode)
-            .build();
-    }
-    /**
-     * エンティティからフォームを生成
-     */
-    public static AccountForm from(Account account) {
-        AccountForm form = new AccountForm();
-        form.setAccountCode(account.getAccountCode());
-        form.setAccountName(account.getAccountName());
-        form.setAccountShortName(account.getAccountShortName());
-        form.setAccountNameKana(account.getAccountNameKana());
-        form.setBsplType(account.getBsplType());
-        form.setDebitCreditType(account.getDebitCreditType());
-        form.setTransactionElementType(account.getTransactionElementType());
-        form.setAggregationType(account.getAggregationType());
-        form.setManagementAccountType(account.getManagementAccountType());
-        form.setExpenseType(account.getExpenseType());
-        form.setSubsidiaryType(account.getSubsidiaryType());
-        form.setTaxCalculationType(account.getTaxCalculationType());
-        form.setTaxTransactionCode(account.getTaxTransactionCode());
-        return form;
-    }
-}
-```
-</details>
----
-### 23.3 勘定科目 Controller の TDD 実装
-#### Red: 失敗するテストを書く
-<details>
-<summary>AccountControllerTest.java</summary>
-```java
-package com.example.accounting.infrastructure.web.controller;
-import com.example.accounting.domain.model.account.*;
-import com.example.accounting.infrastructure.persistence.mapper.AccountMapper;
-import org.junit.jupiter.api.*;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
-import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.test.context.DynamicPropertyRegistry;
-import org.springframework.test.context.DynamicPropertySource;
-import org.springframework.test.web.servlet.MockMvc;
-import org.testcontainers.containers.PostgreSQLContainer;
-import org.testcontainers.junit.jupiter.Container;
-import org.testcontainers.junit.jupiter.Testcontainers;
-import static org.hamcrest.Matchers.*;
-import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
-import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
-@SpringBootTest
-@AutoConfigureMockMvc
-@Testcontainers
-@DisplayName("勘定科目マスタ画面")
-class AccountControllerTest {
-    @Container
-    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16")
-            .withDatabaseName("accounting_test")
-            .withUsername("test")
-            .withPassword("test");
-    @DynamicPropertySource
-    static void configureProperties(DynamicPropertyRegistry registry) {
-        registry.add("spring.datasource.url", postgres::getJdbcUrl);
-        registry.add("spring.datasource.username", postgres::getUsername);
-        registry.add("spring.datasource.password", postgres::getPassword);
-    }
-    @Autowired
-    private MockMvc mockMvc;
-    @Autowired
-    private AccountMapper accountMapper;
-    @BeforeEach
-    void setUp() {
-        accountMapper.deleteAll();
-    }
-    @Nested
-    @DisplayName("GET /accounts - 勘定科目一覧")
-    class AccountList {
-        @Test
-        @DisplayName("勘定科目一覧画面を表示できる")
-        void shouldDisplayAccountList() throws Exception {
-            // Arrange
-            insertTestAccount("11110", "現金", BsplType.BS, DebitCreditType.DEBIT);
-            // Act & Assert
-            mockMvc.perform(get("/accounts"))
-                .andExpect(status().isOk())
-                .andExpect(view().name("accounts/list"))
-                .andExpect(model().attributeExists("accounts"))
-                .andExpect(content().string(containsString("11110")))
-                .andExpect(content().string(containsString("現金")));
-        }
-        @Test
-        @DisplayName("BSPL区分でフィルタリングできる")
-        void shouldFilterByBsplType() throws Exception {
-            // Arrange
-            insertTestAccount("11110", "現金", BsplType.BS, DebitCreditType.DEBIT);
-            insertTestAccount("41100", "売上高", BsplType.PL, DebitCreditType.CREDIT);
-            // Act & Assert
-            mockMvc.perform(get("/accounts").param("bsplType", "BS"))
-                .andExpect(status().isOk())
-                .andExpect(model().attribute("accounts", hasSize(1)))
-                .andExpect(content().string(containsString("現金")))
-                .andExpect(content().string(not(containsString("売上高"))));
-        }
-    }
-    @Nested
-    @DisplayName("POST /accounts - 勘定科目登録処理")
-    class CreateAccount {
-        @Test
-        @DisplayName("勘定科目を登録できる")
-        void shouldCreateAccount() throws Exception {
-            mockMvc.perform(post("/accounts")
-                    .param("accountCode", "11120")
-                    .param("accountName", "当座預金")
-                    .param("bsplType", "BS")
-                    .param("debitCreditType", "DEBIT")
-                    .param("transactionElementType", "ASSET")
-                    .param("aggregationType", "POSTING"))
-                .andExpect(status().is3xxRedirection())
-                .andExpect(redirectedUrl("/accounts"))
-                .andExpect(flash().attribute("successMessage", containsString("登録")));
-            // データベースに保存されていることを確認
-            var saved = accountMapper.findByCode("11120");
-            Assertions.assertNotNull(saved);
-            Assertions.assertEquals("当座預金", saved.getAccountName());
-        }
-        @Test
-        @DisplayName("バリデーションエラー時は入力画面に戻る")
-        void shouldReturnFormOnValidationError() throws Exception {
-            mockMvc.perform(post("/accounts")
-                    .param("accountCode", "")  // 必須項目が空
-                    .param("accountName", "")
-                    .param("bsplType", "BS"))
-                .andExpect(status().isOk())
-                .andExpect(view().name("accounts/new"))
-                .andExpect(model().attributeHasFieldErrors("form", "accountCode", "accountName"));
-        }
-    }
-    private void insertTestAccount(String code, String name, BsplType bsplType, DebitCreditType debitCreditType) {
-        accountMapper.insert(Account.builder()
-            .accountCode(code)
-            .accountName(name)
-            .accountShortName(name)
-            .accountNameKana("")
-            .bsplType(bsplType)
-            .debitCreditType(debitCreditType)
-            .transactionElementType(TransactionElementType.ASSET)
-            .aggregationType(AggregationType.POSTING)
-            .build());
-    }
-}
-```
-</details>
-#### Green: Controller の実装
-<details>
-<summary>AccountController.java</summary>
-```java
-package com.example.accounting.infrastructure.web.controller;
-import com.example.accounting.application.port.in.*;
-import com.example.accounting.domain.exception.AccountInUseException;
-import com.example.accounting.domain.exception.AccountNotFoundException;
-import com.example.accounting.domain.exception.DuplicateAccountException;
-import com.example.accounting.domain.model.account.*;
-import com.example.accounting.infrastructure.web.form.AccountForm;
-import jakarta.validation.Valid;
-import org.springframework.stereotype.Controller;
-import org.springframework.ui.Model;
-import org.springframework.validation.BindingResult;
-import org.springframework.web.bind.annotation.*;
-import org.springframework.web.servlet.mvc.support.RedirectAttributes;
-import java.util.List;
-/**
- * 勘定科目マスタ Controller
- */
-@Controller
-@RequestMapping("/accounts")
-public class AccountController {
-    private final AccountUseCase accountUseCase;
-    public AccountController(AccountUseCase accountUseCase) {
-        this.accountUseCase = accountUseCase;
-    }
-    /**
-     * 勘定科目一覧画面
-     */
-    @GetMapping
-    public String list(
-            @RequestParam(required = false) String keyword,
-            @RequestParam(required = false) BsplType bsplType,
-            @RequestParam(required = false) DebitCreditType debitCreditType,
-            Model model) {
-        List<Account> accounts;
-        if (keyword != null || bsplType != null || debitCreditType != null) {
-            accounts = accountUseCase.searchAccounts(keyword, bsplType, debitCreditType);
-        } else {
-            accounts = accountUseCase.getAllAccounts();
-        }
-        model.addAttribute("accounts", accounts);
-        model.addAttribute("keyword", keyword);
-        model.addAttribute("selectedBsplType", bsplType);
-        model.addAttribute("selectedDebitCreditType", debitCreditType);
-        addEnumsToModel(model);
-        return "accounts/list";
-    }
-    /**
-     * 勘定科目登録画面
-     */
-    @GetMapping("/new")
-    public String newForm(Model model) {
-        model.addAttribute("form", new AccountForm());
-        addEnumsToModel(model);
-        return "accounts/new";
-    }
-    /**
-     * 勘定科目登録処理
-     */
-    @PostMapping
-    public String create(
-            @Valid @ModelAttribute("form") AccountForm form,
-            BindingResult bindingResult,
-            Model model,
-            RedirectAttributes redirectAttributes) {
-        if (bindingResult.hasErrors()) {
-            addEnumsToModel(model);
-            return "accounts/new";
-        }
-        try {
-            accountUseCase.createAccount(form.toCommand());
-            redirectAttributes.addFlashAttribute("successMessage",
-                "勘定科目「" + form.getAccountName() + "」を登録しました");
-            return "redirect:/accounts";
-        } catch (DuplicateAccountException e) {
-            model.addAttribute("errorMessage",
-                "勘定科目コード「" + form.getAccountCode() + "」は既に存在します");
-            addEnumsToModel(model);
-            return "accounts/new";
-        }
-    }
-    /**
-     * 勘定科目詳細画面
-     */
-    @GetMapping("/{accountCode}")
-    public String detail(@PathVariable String accountCode, Model model) {
-        Account account = accountUseCase.getAccount(accountCode)
-            .orElseThrow(() -> new AccountNotFoundException(accountCode));
-        model.addAttribute("account", account);
-        return "accounts/detail";
-    }
-    /**
-     * 勘定科目削除処理
-     */
-    @PostMapping("/{accountCode}/delete")
-    public String delete(
-            @PathVariable String accountCode,
-            Model model,
-            RedirectAttributes redirectAttributes) {
-        try {
-            Account account = accountUseCase.getAccount(accountCode)
-                .orElseThrow(() -> new AccountNotFoundException(accountCode));
-            accountUseCase.deleteAccount(accountCode);
-            redirectAttributes.addFlashAttribute("successMessage",
-                "勘定科目「" + account.getAccountName() + "」を削除しました");
-            return "redirect:/accounts";
-        } catch (AccountInUseException e) {
-            Account account = accountUseCase.getAccount(accountCode).orElseThrow();
-            model.addAttribute("account", account);
-            model.addAttribute("errorMessage",
-                "この勘定科目は仕訳で使用中のため削除できません");
-            return "accounts/detail";
-        }
-    }
-    /**
-     * 列挙型をモデルに追加
-     */
-    private void addEnumsToModel(Model model) {
-        model.addAttribute("bsplTypes", BsplType.values());
-        model.addAttribute("debitCreditTypes", DebitCreditType.values());
-        model.addAttribute("transactionElementTypes", TransactionElementType.values());
-        model.addAttribute("aggregationTypes", AggregationType.values());
-        model.addAttribute("managementAccountTypes", ManagementAccountType.values());
-        model.addAttribute("expenseTypes", ExpenseType.values());
-        model.addAttribute("subsidiaryTypes", SubsidiaryType.values());
-        model.addAttribute("taxCalculationTypes", TaxCalculationType.values());
-    }
-    /**
-     * 404 エラーハンドリング
-     */
-    @ExceptionHandler(AccountNotFoundException.class)
-    @ResponseStatus(org.springframework.http.HttpStatus.NOT_FOUND)
-    public String handleNotFound(AccountNotFoundException e, Model model) {
-        model.addAttribute("errorMessage", e.getMessage());
-        return "error/404";
-    }
-}
-```
-</details>
----
-## 第24章：仕訳入力画面の実装
-### 24.1 仕訳入力画面の設計
-#### 画面一覧
-| 画面 | URL | メソッド | 説明 |
-|------|-----|---------|------|
-| 仕訳一覧 | /journals | GET | 仕訳の検索・一覧表示 |
-| 仕訳詳細 | /journals/{journalNumber} | GET | 仕訳の詳細表示 |
-| 仕訳入力 | /journals/new | GET | 入力フォーム表示 |
-| 仕訳登録処理 | /journals | POST | 登録処理 |
-| 仕訳取消 | /journals/{journalNumber}/cancel | POST | 赤黒処理 |
----
-### 24.2 仕訳入力フォームオブジェクト
-<details>
-<summary>JournalForm.java</summary>
-```java
-package com.example.accounting.infrastructure.web.form;
-import com.example.accounting.application.port.in.CreateJournalCommand;
-import com.example.accounting.domain.model.journal.SingleComplexType;
-import jakarta.validation.Valid;
-import jakarta.validation.constraints.NotEmpty;
-import jakarta.validation.constraints.NotNull;
-import lombok.Data;
-import java.time.LocalDate;
-import java.util.ArrayList;
-import java.util.List;
-/**
- * 仕訳入力フォーム
- */
-@Data
-public class JournalForm {
-    @NotNull(message = "起票日は必須です")
-    private LocalDate journalDate;
-    private String description;
-    private boolean closingJournal;
-    @NotNull(message = "単複区分は必須です")
-    private SingleComplexType singleComplexType;
-    @Valid
-    @NotEmpty(message = "仕訳明細は1行以上必要です")
-    private List<JournalLineForm> lines = new ArrayList<>();
-    /**
-     * フォームをコマンドに変換
-     */
-    public CreateJournalCommand toCommand() {
-        return CreateJournalCommand.builder()
-            .journalDate(this.journalDate)
-            .description(this.description)
-            .closingJournal(this.closingJournal)
-            .singleComplexType(this.singleComplexType)
-            .lines(this.lines.stream()
-                .map(JournalLineForm::toCommand)
-                .toList())
-            .build();
-    }
-    /**
-     * 初期化（空の明細行を追加）
-     */
-    public void initializeLines() {
-        if (this.lines.isEmpty()) {
-            // 借方1行、貸方1行を追加
-            JournalLineForm debitLine = new JournalLineForm();
-            debitLine.setDebitCredit("DEBIT");
-            this.lines.add(debitLine);
-            JournalLineForm creditLine = new JournalLineForm();
-            creditLine.setDebitCredit("CREDIT");
-            this.lines.add(creditLine);
-        }
-    }
-}
-```
-</details>
-<details>
-<summary>JournalLineForm.java</summary>
-```java
-package com.example.accounting.infrastructure.web.form;
-import com.example.accounting.application.port.in.CreateJournalLineCommand;
-import jakarta.validation.constraints.NotBlank;
-import jakarta.validation.constraints.NotNull;
-import jakarta.validation.constraints.Positive;
-import lombok.Data;
-import java.math.BigDecimal;
-/**
- * 仕訳明細行フォーム
- */
-@Data
-public class JournalLineForm {
-    @NotBlank(message = "貸借区分は必須です")
-    private String debitCredit;  // "DEBIT" or "CREDIT"
-    @NotBlank(message = "勘定科目コードは必須です")
-    private String accountCode;
-    private String subsidiaryCode;
-    @NotNull(message = "金額は必須です")
-    @Positive(message = "金額は正の数で入力してください")
-    private BigDecimal amount;
-    private String taxType;
-    private BigDecimal taxRate;
-    private String departmentCode;
-    private String projectCode;
-    private String lineDescription;
-    /**
-     * フォームをコマンドに変換
-     */
-    public CreateJournalLineCommand toCommand() {
-        return CreateJournalLineCommand.builder()
-            .debitCredit(this.debitCredit)
-            .accountCode(this.accountCode)
-            .subsidiaryCode(this.subsidiaryCode)
-            .amount(this.amount)
-            .taxType(this.taxType)
-            .taxRate(this.taxRate)
-            .departmentCode(this.departmentCode)
-            .projectCode(this.projectCode)
-            .lineDescription(this.lineDescription)
-            .build();
-    }
-}
-```
-</details>
----
-### 24.3 仕訳 Controller の実装
-<details>
-<summary>JournalController.java</summary>
-```java
-package com.example.accounting.infrastructure.web.controller;
-import com.example.accounting.application.port.in.*;
-import com.example.accounting.domain.exception.DebitCreditImbalanceException;
-import com.example.accounting.domain.exception.JournalNotFoundException;
-import com.example.accounting.domain.model.journal.*;
-import com.example.accounting.infrastructure.web.form.JournalForm;
-import jakarta.validation.Valid;
-import org.springframework.format.annotation.DateTimeFormat;
-import org.springframework.stereotype.Controller;
-import org.springframework.ui.Model;
-import org.springframework.validation.BindingResult;
-import org.springframework.web.bind.annotation.*;
-import org.springframework.web.servlet.mvc.support.RedirectAttributes;
-import java.time.LocalDate;
-import java.util.List;
-/**
- * 仕訳 Controller
- */
-@Controller
-@RequestMapping("/journals")
-public class JournalController {
-    private final JournalUseCase journalUseCase;
-    private final AccountUseCase accountUseCase;
-    private final DepartmentUseCase departmentUseCase;
-    public JournalController(
-            JournalUseCase journalUseCase,
-            AccountUseCase accountUseCase,
-            DepartmentUseCase departmentUseCase) {
-        this.journalUseCase = journalUseCase;
-        this.accountUseCase = accountUseCase;
-        this.departmentUseCase = departmentUseCase;
-    }
-    /**
-     * 仕訳一覧画面
-     */
-    @GetMapping
-    public String list(
-            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate fromDate,
-            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate toDate,
-            @RequestParam(required = false) String accountCode,
-            @RequestParam(required = false) JournalStatus status,
-            Model model) {
-        // デフォルトは当月
-        if (fromDate == null) {
-            fromDate = LocalDate.now().withDayOfMonth(1);
-        }
-        if (toDate == null) {
-            toDate = LocalDate.now();
-        }
-        List<Journal> journals = journalUseCase.searchJournals(fromDate, toDate, accountCode, status);
-        model.addAttribute("journals", journals);
-        model.addAttribute("fromDate", fromDate);
-        model.addAttribute("toDate", toDate);
-        model.addAttribute("accountCode", accountCode);
-        model.addAttribute("status", status);
-        model.addAttribute("statuses", JournalStatus.values());
-        return "journals/list";
-    }
-    /**
-     * 仕訳入力画面
-     */
-    @GetMapping("/new")
-    public String newForm(Model model) {
-        JournalForm form = new JournalForm();
-        form.setJournalDate(LocalDate.now());
-        form.setSingleComplexType(SingleComplexType.SINGLE);
-        form.initializeLines();
-        model.addAttribute("form", form);
-        addMasterDataToModel(model);
-        return "journals/new";
-    }
-    /**
-     * 仕訳登録処理
-     */
-    @PostMapping
-    public String create(
-            @Valid @ModelAttribute("form") JournalForm form,
-            BindingResult bindingResult,
-            Model model,
-            RedirectAttributes redirectAttributes) {
-        if (bindingResult.hasErrors()) {
-            addMasterDataToModel(model);
-            return "journals/new";
-        }
-        try {
-            Journal journal = journalUseCase.createJournal(form.toCommand());
-            redirectAttributes.addFlashAttribute("successMessage",
-                "仕訳「" + journal.getJournalNumber() + "」を登録しました");
-            return "redirect:/journals/" + journal.getJournalNumber();
-        } catch (DebitCreditImbalanceException e) {
-            model.addAttribute("errorMessage", "借方・貸方の合計が一致しません");
-            addMasterDataToModel(model);
-            return "journals/new";
-        }
-    }
-    /**
-     * 仕訳詳細画面
-     */
-    @GetMapping("/{journalNumber}")
-    public String detail(@PathVariable String journalNumber, Model model) {
-        Journal journal = journalUseCase.getJournal(journalNumber)
-            .orElseThrow(() -> new JournalNotFoundException(journalNumber));
-        model.addAttribute("journal", journal);
-        return "journals/detail";
-    }
-    /**
-     * 仕訳取消処理（赤黒処理）
-     */
-    @PostMapping("/{journalNumber}/cancel")
-    public String cancel(
-            @PathVariable String journalNumber,
-            @RequestParam(required = false) String reason,
-            RedirectAttributes redirectAttributes) {
-        Journal cancelJournal = journalUseCase.cancelJournal(journalNumber, reason);
-        redirectAttributes.addFlashAttribute("successMessage",
-            "仕訳「" + journalNumber + "」を取消しました。" +
-            "取消仕訳「" + cancelJournal.getJournalNumber() + "」を作成しました。");
-        return "redirect:/journals/" + cancelJournal.getJournalNumber();
-    }
-    /**
-     * マスタデータをモデルに追加
-     */
-    private void addMasterDataToModel(Model model) {
-        model.addAttribute("accounts", accountUseCase.getPostingAccounts());
-        model.addAttribute("departments", departmentUseCase.getAllDepartments());
-        model.addAttribute("singleComplexTypes", SingleComplexType.values());
-    }
-}
-```
-</details>
----
-## 第25章：帳票出力の実装
-### 25.1 帳票出力の設計
-財務会計システムでは、以下の帳票を出力します。
-| 帳票名 | 説明 | 出力形式 |
-|-------|------|---------|
-| 日計表 | 日次の仕訳合計 | HTML / Excel / PDF |
-| 合計残高試算表 | 月次の勘定科目残高 | HTML / Excel / PDF |
-| 総勘定元帳 | 勘定科目別の仕訳明細 | HTML / Excel / PDF |
-| 貸借対照表 | 資産・負債・資本の状況 | HTML / Excel / PDF |
-| 損益計算書 | 収益・費用の状況 | HTML / Excel / PDF |
----
-### 25.2 帳票 Controller の実装
-<details>
-<summary>ReportController.java</summary>
-```java
-package com.example.accounting.infrastructure.web.controller;
-import com.example.accounting.application.port.in.*;
-import com.example.accounting.domain.model.report.*;
-import com.example.accounting.infrastructure.report.ExcelReportGenerator;
-import com.example.accounting.infrastructure.report.PdfReportGenerator;
-import org.springframework.format.annotation.DateTimeFormat;
-import org.springframework.http.HttpHeaders;
-import org.springframework.http.MediaType;
-import org.springframework.http.ResponseEntity;
-import org.springframework.stereotype.Controller;
-import org.springframework.ui.Model;
-import org.springframework.web.bind.annotation.*;
-import java.time.LocalDate;
-import java.time.YearMonth;
-/**
- * 帳票出力 Controller
- */
-@Controller
-@RequestMapping("/reports")
-public class ReportController {
-    private final ReportUseCase reportUseCase;
-    private final ExcelReportGenerator excelGenerator;
-    private final PdfReportGenerator pdfGenerator;
-    public ReportController(
-            ReportUseCase reportUseCase,
-            ExcelReportGenerator excelGenerator,
-            PdfReportGenerator pdfGenerator) {
-        this.reportUseCase = reportUseCase;
-        this.excelGenerator = excelGenerator;
-        this.pdfGenerator = pdfGenerator;
-    }
-    /**
-     * 日計表画面
-     */
-    @GetMapping("/daily")
-    public String dailyReport(
-            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
-            Model model) {
-        if (date == null) {
-            date = LocalDate.now();
-        }
-        DailyReport report = reportUseCase.getDailyReport(date);
-        model.addAttribute("report", report);
-        model.addAttribute("date", date);
-        return "reports/daily";
-    }
-    /**
-     * 日計表 Excel 出力
-     */
-    @GetMapping("/daily/excel")
-    public ResponseEntity<byte[]> dailyReportExcel(
-            @RequestParam @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date) {
-        DailyReport report = reportUseCase.getDailyReport(date);
-        byte[] excelData = excelGenerator.generateDailyReport(report);
-        return ResponseEntity.ok()
-            .header(HttpHeaders.CONTENT_DISPOSITION,
-                "attachment; filename=\"daily_report_" + date + ".xlsx\"")
-            .contentType(MediaType.parseMediaType(
-                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"))
-            .body(excelData);
-    }
-    /**
-     * 日計表 PDF 出力
-     */
-    @GetMapping("/daily/pdf")
-    public ResponseEntity<byte[]> dailyReportPdf(
-            @RequestParam @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date) {
-        DailyReport report = reportUseCase.getDailyReport(date);
-        byte[] pdfData = pdfGenerator.generateDailyReport(report);
-        return ResponseEntity.ok()
-            .header(HttpHeaders.CONTENT_DISPOSITION,
-                "attachment; filename=\"daily_report_" + date + ".pdf\"")
-            .contentType(MediaType.APPLICATION_PDF)
-            .body(pdfData);
-    }
-    /**
-     * 合計残高試算表画面
-     */
-    @GetMapping("/trial-balance")
-    public String trialBalance(
-            @RequestParam(required = false) String fiscalYear,
-            @RequestParam(required = false) Integer month,
-            Model model) {
-        YearMonth yearMonth = (fiscalYear != null && month != null)
-            ? YearMonth.of(Integer.parseInt(fiscalYear), month)
-            : YearMonth.now();
-        TrialBalance report = reportUseCase.getTrialBalance(yearMonth);
-        model.addAttribute("report", report);
-        model.addAttribute("yearMonth", yearMonth);
-        return "reports/trial-balance";
-    }
-    /**
-     * 合計残高試算表 Excel 出力
-     */
-    @GetMapping("/trial-balance/excel")
-    public ResponseEntity<byte[]> trialBalanceExcel(
-            @RequestParam String fiscalYear,
-            @RequestParam Integer month) {
-        YearMonth yearMonth = YearMonth.of(Integer.parseInt(fiscalYear), month);
-        TrialBalance report = reportUseCase.getTrialBalance(yearMonth);
-        byte[] excelData = excelGenerator.generateTrialBalance(report);
-        return ResponseEntity.ok()
-            .header(HttpHeaders.CONTENT_DISPOSITION,
-                "attachment; filename=\"trial_balance_" + yearMonth + ".xlsx\"")
-            .contentType(MediaType.parseMediaType(
-                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"))
-            .body(excelData);
-    }
-    /**
-     * 貸借対照表画面
-     */
-    @GetMapping("/balance-sheet")
-    public String balanceSheet(
-            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
-            Model model) {
-        if (date == null) {
-            date = LocalDate.now();
-        }
-        BalanceSheet report = reportUseCase.getBalanceSheet(date);
-        model.addAttribute("report", report);
-        model.addAttribute("date", date);
-        return "reports/balance-sheet";
-    }
-    /**
-     * 損益計算書画面
-     */
-    @GetMapping("/income-statement")
-    public String incomeStatement(
-            @RequestParam(required = false) String fiscalYear,
-            @RequestParam(required = false) Integer fromMonth,
-            @RequestParam(required = false) Integer toMonth,
-            Model model) {
-        YearMonth from = (fiscalYear != null && fromMonth != null)
-            ? YearMonth.of(Integer.parseInt(fiscalYear), fromMonth)
-            : YearMonth.now().withMonth(4);  // 期首（4月）
-        YearMonth to = (fiscalYear != null && toMonth != null)
-            ? YearMonth.of(Integer.parseInt(fiscalYear), toMonth)
-            : YearMonth.now();
-        IncomeStatement report = reportUseCase.getIncomeStatement(from, to);
-        model.addAttribute("report", report);
-        model.addAttribute("fromMonth", from);
-        model.addAttribute("toMonth", to);
-        return "reports/income-statement";
-    }
-}
-```
-</details>
----
-### 25.3 Excel 帳票生成
-<details>
-<summary>ExcelReportGenerator.java</summary>
-```java
-package com.example.accounting.infrastructure.report;
-import com.example.accounting.domain.model.report.*;
-import org.apache.poi.ss.usermodel.*;
-import org.apache.poi.ss.util.CellRangeAddress;
-import org.apache.poi.xssf.usermodel.XSSFWorkbook;
-import org.springframework.stereotype.Component;
-import java.io.ByteArrayOutputStream;
-import java.io.IOException;
-import java.time.format.DateTimeFormatter;
-/**
- * Excel 帳票生成
- */
-@Component
-public class ExcelReportGenerator {
-    /**
-     * 日計表 Excel 生成
-     */
-    public byte[] generateDailyReport(DailyReport report) {
-        try (Workbook workbook = new XSSFWorkbook()) {
-            Sheet sheet = workbook.createSheet("日計表");
-            // スタイル設定
-            CellStyle headerStyle = createHeaderStyle(workbook);
-            CellStyle amountStyle = createAmountStyle(workbook);
-            // タイトル
-            Row titleRow = sheet.createRow(0);
-            Cell titleCell = titleRow.createCell(0);
-            titleCell.setCellValue("日 計 表");
-            sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 5));
-            // 日付
-            Row dateRow = sheet.createRow(1);
-            dateRow.createCell(0).setCellValue(
-                report.getDate().format(DateTimeFormatter.ofPattern("yyyy年MM月dd日")));
-            // ヘッダー
-            Row headerRow = sheet.createRow(3);
-            String[] headers = {"勘定科目コード", "勘定科目名", "借方金額", "貸方金額"};
-            for (int i = 0; i < headers.length; i++) {
-                Cell cell = headerRow.createCell(i);
-                cell.setCellValue(headers[i]);
-                cell.setCellStyle(headerStyle);
-            }
-            // データ行
-            int rowNum = 4;
-            for (DailyReportLine line : report.getLines()) {
-                Row row = sheet.createRow(rowNum++);
-                row.createCell(0).setCellValue(line.getAccountCode());
-                row.createCell(1).setCellValue(line.getAccountName());
-                Cell debitCell = row.createCell(2);
-                debitCell.setCellValue(line.getDebitAmount().doubleValue());
-                debitCell.setCellStyle(amountStyle);
-                Cell creditCell = row.createCell(3);
-                creditCell.setCellValue(line.getCreditAmount().doubleValue());
-                creditCell.setCellStyle(amountStyle);
-            }
-            // 合計行
-            Row totalRow = sheet.createRow(rowNum);
-            totalRow.createCell(1).setCellValue("合計");
-            Cell totalDebitCell = totalRow.createCell(2);
-            totalDebitCell.setCellValue(report.getTotalDebit().doubleValue());
-            totalDebitCell.setCellStyle(amountStyle);
-            Cell totalCreditCell = totalRow.createCell(3);
-            totalCreditCell.setCellValue(report.getTotalCredit().doubleValue());
-            totalCreditCell.setCellStyle(amountStyle);
-            // 列幅調整
-            for (int i = 0; i < 4; i++) {
-                sheet.autoSizeColumn(i);
-            }
-            ByteArrayOutputStream out = new ByteArrayOutputStream();
-            workbook.write(out);
-            return out.toByteArray();
-        } catch (IOException e) {
-            throw new RuntimeException("Excel 生成エラー", e);
-        }
-    }
-    private CellStyle createHeaderStyle(Workbook workbook) {
-        CellStyle style = workbook.createCellStyle();
-        style.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex());
-        style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
-        style.setBorderBottom(BorderStyle.THIN);
-        style.setBorderTop(BorderStyle.THIN);
-        style.setBorderLeft(BorderStyle.THIN);
-        style.setBorderRight(BorderStyle.THIN);
-        style.setAlignment(HorizontalAlignment.CENTER);
-        return style;
-    }
-    private CellStyle createAmountStyle(Workbook workbook) {
-        CellStyle style = workbook.createCellStyle();
-        DataFormat format = workbook.createDataFormat();
-        style.setDataFormat(format.getFormat("#,##0"));
-        style.setAlignment(HorizontalAlignment.RIGHT);
-        return style;
-    }
-}
-```
-</details>
----
-## 第26章：ページネーションの実装
-### 26.1 ページネーションの設計
-一覧画面でデータ量が多い場合、すべてのデータを一度に表示するとパフォーマンスが低下します。ページネーションを実装して、データを分割して表示します。
-| 要素 | 説明 |
-|------|------|
-| **PageResult<T>** | ページネーション結果を表す汎用クラス |
-| **LIMIT/OFFSET** | SQL でのページ分割 |
-| **表示件数** | ユーザーが選択可能（10/25/50/100件） |
-| **ページナビゲーション** | 最初/前/ページ番号/次/最後 |
----
-### 26.2 PageResult クラス
-<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 page;
-    private final int size;
-    private final long totalElements;
-    private final int totalPages;
-    public PageResult(List<T> content, int page, int size, long totalElements) {
-        this.content = content;
-        this.page = page;
-        this.size = size;
-        this.totalElements = totalElements;
-        this.totalPages = size > 0 ? (int) Math.ceil((double) totalElements / size) : 0;
-    }
-    public List<T> getContent() {
-        return content;
-    }
-    public int getPage() {
-        return page;
-    }
-    public int getSize() {
-        return size;
-    }
-    public long getTotalElements() {
-        return totalElements;
-    }
-    public int getTotalPages() {
-        return totalPages;
-    }
-    public boolean isFirst() {
-        return page == 0;
-    }
-    public boolean isLast() {
-        return page >= totalPages - 1;
-    }
-    public boolean hasPrevious() {
-        return page > 0;
-    }
-    public boolean hasNext() {
-        return page < totalPages - 1;
-    }
-}
-```
-</details>
----
-### 26.3 Mapper 層の実装
-ページネーション用のクエリと件数取得クエリを追加します。
-<details>
-<summary>PartnerMapper.java（抜粋）</summary>
-```java
-/**
- * ページネーション付きで取引先を検索.
- */
-List<Partner> findWithPagination(
-    @Param("offset") int offset,
-    @Param("limit") int limit,
-    @Param("type") String type,
-    @Param("keyword") String keyword);
-/**
- * 検索条件に一致する取引先の件数を取得.
- */
-long count(@Param("type") String type, @Param("keyword") String keyword);
-```
-</details>
-<details>
-<summary>PartnerMapper.xml（抜粋）</summary>
-```xml
-<select id="findWithPagination" resultMap="PartnerResultMap">
-    SELECT * FROM "取引先マスタ"
-    <where>
-        <if test="type == 'customer'">
-            "顧客区分" = TRUE
-        </if>
-        <if test="type == 'supplier'">
-            "仕入先区分" = TRUE
-        </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="type == 'customer'">
-            "顧客区分" = TRUE
-        </if>
-        <if test="type == 'supplier'">
-            "仕入先区分" = TRUE
-        </if>
-        <if test="keyword != null and keyword != ''">
-            AND (LOWER("取引先コード") LIKE LOWER('%' || #{keyword} || '%')
-                 OR LOWER("取引先名") LIKE LOWER('%' || #{keyword} || '%'))
-        </if>
-    </where>
-</select>
-```
-</details>
----
-### 26.4 Repository 層の実装
-<details>
-<summary>PartnerRepository.java（抜粋）</summary>
-```java
-/**
- * ページネーション付きで取引先を検索.
- */
-PageResult<Partner> findWithPagination(int page, int size, String type, String keyword);
-```
-</details>
-<details>
-<summary>PartnerRepositoryImpl.java（抜粋）</summary>
-```java
-@Override
-public PageResult<Partner> findWithPagination(int page, int size, String type, String keyword) {
-    int offset = page * size;
-    List<Partner> partners = partnerMapper.findWithPagination(offset, size, type, keyword);
-    long totalElements = partnerMapper.count(type, keyword);
-    return new PageResult<>(partners, page, size, totalElements);
-}
-```
-</details>
----
-### 26.5 UseCase / Service 層の実装
-<details>
-<summary>PartnerUseCase.java（抜粋）</summary>
-```java
-/**
- * ページネーション付きで取引先を取得.
- */
-PageResult<Partner> getPartners(int page, int size, String type, String keyword);
-```
-</details>
-<details>
-<summary>PartnerService.java（抜粋）</summary>
-```java
-@Override
-@Transactional(readOnly = true)
-public PageResult<Partner> getPartners(int page, int size, String type, String keyword) {
-    return partnerRepository.findWithPagination(page, size, type, keyword);
-}
-```
-</details>
----
-### 26.6 Controller の実装
-<details>
-<summary>PartnerWebController.java（抜粋）</summary>
-```java
-@GetMapping
-public String list(
-        @RequestParam(defaultValue = "0") int page,
-        @RequestParam(defaultValue = "10") int size,
-        @RequestParam(required = false) String type,
-        @RequestParam(required = false) String keyword,
-        Model model) {
-    PageResult<Partner> partnerPage = partnerUseCase.getPartners(page, size, type, keyword);
-    model.addAttribute("partners", partnerPage.getContent());
-    model.addAttribute("page", partnerPage);
-    model.addAttribute("selectedType", type);
-    model.addAttribute("keyword", keyword);
-    model.addAttribute("currentSize", size);
-    return "partners/list";
-}
-```
-</details>
----
-### 26.7 テンプレートの実装
-<details>
-<summary>list.html ページネーション部分</summary>
-```html
-<!-- 検索フォーム -->
-<div class="search-form">
-    <form th:action="@{/partners}" method="get" class="row g-3">
-        <!-- 表示件数 -->
-        <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="col-md-2 d-flex align-items-end">
-            <button type="submit" class="btn btn-secondary">検索</button>
-        </div>
-    </form>
-</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(partners)}">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="@{/partners(page=0, size=${currentSize})}">&laquo;</a>
-            </li>
-            <!-- 前のページへ -->
-            <li class="page-item" th:classappend="${!page.hasPrevious()} ? 'disabled'">
-                <a class="page-link" th:href="@{/partners(page=${page.page - 1}, size=${currentSize})}">&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="@{/partners(page=${i}, size=${currentSize})}"
-                       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="@{/partners(page=${page.page + 1}, size=${currentSize})}">&rsaquo;</a>
-            </li>
-            <!-- 最後のページへ -->
-            <li class="page-item" th:classappend="${page.last} ? 'disabled'">
-                <a class="page-link" th:href="@{/partners(page=${page.totalPages - 1}, size=${currentSize})}">&raquo;</a>
-            </li>
-        </ul>
-    </nav>
-</div>
-```
-</details>
----
-### 26.8 ページネーションの動作
-```
-                    ページネーション処理フロー
-┌─────────────────────────────────────────────────────────────┐
-│  ブラウザ                                                    │
-│  /partners?page=2&size=10&keyword=xxx                       │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│  Controller                                                  │
-│  - page, size, keyword パラメータを受け取る                   │
-│  - UseCase.getPartners(page, size, keyword) を呼び出す       │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│  Service / Repository                                        │
-│  - offset = page * size を計算                               │
-│  - findWithPagination(offset, size, keyword) を実行          │
-│  - count(keyword) で総件数を取得                             │
-│  - PageResult<T> を生成して返却                              │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│  SQL (MyBatis)                                               │
-│  SELECT * FROM "テーブル"                                    │
-│  WHERE ... LIMIT 10 OFFSET 20                               │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│  PageResult<T>                                               │
-│  - content: データリスト (10件)                               │
-│  - page: 2                                                   │
-│  - size: 10                                                  │
-│  - totalElements: 57                                         │
-│  - totalPages: 6                                             │
-│  - isFirst/isLast/hasPrevious/hasNext メソッド               │
-└─────────────────────────────────────────────────────────────┘
-```
----
-### 26.9 検索条件の保持
-ページ遷移時に検索条件を保持するため、すべてのリンクに検索パラメータを含めます。
-```html
-<!-- 検索条件付きページネーションリンク -->
-<a th:href="@{/partners(
-    page=${i},
-    size=${currentSize},
-    type=${selectedType},
-    keyword=${keyword}
-)}">
-```
----
-## まとめ
-### 学んだこと
-1. **帳票の種類**: 日計表、試算表、元帳、財務諸表
-2. **HTML 表示**: Thymeleaf による帳票画面の実装
-3. **Excel 出力**: Apache POI による Excel ファイル生成
-4. **PDF 出力**: iText による PDF ファイル生成
-5. **ダウンロード**: ResponseEntity による添付ファイル返却
-6. **ページネーション**: PageResult<T> による一覧画面のページ分割
----
-### 実装した機能
-| 機能 | 説明 |
-|------|------|
-| **ホーム画面** | ダッシュボード、クイックアクセス |
-| **勘定科目マスタ** | 一覧・登録・編集・削除・検索 |
-| **仕訳入力** | 複合仕訳対応、貸借チェック |
-| **帳票出力** | 日計表、試算表、財務諸表 |
-### モノリス vs API サーバー
-| 観点 | モノリス | API サーバー |
-|------|---------|-------------|
-| **適用場面** | 社内システム、小〜中規模 | 大規模、SPA 連携 |
-| **開発速度** | 高速 | 環境構築に時間 |
-| **保守性** | 適切な設計で高い | 高い |
-| **チーム構成** | フルスタック | フロント/バック分離 |
-### 技術的なポイント
-1. **ヘキサゴナルアーキテクチャ**: モノリスでも適用可能
-2. **Thymeleaf**: サーバーサイドレンダリング
-3. **htmx**: JavaScript 不要の部分更新
-4. **PRG パターン**: フォーム二重送信防止
-5. **帳票生成**: POI（Excel）、iText（PDF）
+# 実践データベース設計：財務会計システム 研究 1 - モノリスサービスの実装
+## はじめに
+本研究では、API サーバー構成（第21章）とは異なるアプローチとして、**モノリスアーキテクチャ**による財務会計システムを実装します。UI（テンプレートエンジン）、ビジネスロジック、データベースアクセスがすべて同一サーバー内で動作する、伝統的かつ堅実なアーキテクチャです。
+---
+## 第22章：モノリスアーキテクチャの基礎
+### 22.1 モノリスアーキテクチャとは
+**モノリス（Monolith / Monolithic Architecture）**とは、「API」と「UI」と「ビジネスロジック」が **1つの実行ユニット**（1つのプロジェクトやバイナリ）にまとまっているアーキテクチャを指します。
+```plantuml
+@startuml monolith_architecture
+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 を生成してブラウザに返却 |
+| **セッション管理** | サーバーサイドでユーザーセッションを管理 |
+| **トランザクション境界** | 単一プロセス内でのローカルトランザクション |
+---
+### 22.2 API サーバー vs モノリス
+```plantuml
+@startuml api_vs_monolith
+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 フレンドリー |
+### 22.3 モノリスを選択すべき場面
+**モノリスが適している状況：**
+1. **小〜中規模のチーム**：専門のフロントエンドチームがいない場合
+2. **社内システム**：SEO 不要、限られたユーザー数
+3. **業務アプリケーション**：複雑な業務フローをサーバーサイドで処理
+4. **迅速な開発**：MVP やプロトタイプの素早い構築
+5. **運用コスト重視**：インフラ構成をシンプルに保ちたい場合
+**財務会計システムにおけるモノリスのメリット：**
+```
+財務会計システムの特性
+├── 社内利用が中心 → SEO 不要、SPA 不要
+├── 複雑な業務フロー → サーバーサイドで制御が容易
+├── 帳票出力 → サーバーサイドで PDF/Excel 生成
+├── 月次締め・決算処理 → バッチ処理との親和性
+├── 監査証跡 → サーバーサイドでのログ管理
+└── 運用担当者のスキル → シンプルな構成が望ましい
+```
+---
+### 22.4 モノリスにおけるヘキサゴナルアーキテクチャ
+モノリスであっても、ヘキサゴナルアーキテクチャ（Ports and Adapters）を採用することで、保守性の高い設計を実現できます。
+```plantuml
+@startuml hexagonal_monolith
+' 左右のレイアウトを強制
+left to right direction
+package "Hexagonal Architecture (財務会計モノリス版)" {
+  rectangle "Application Core\n(Domain + Use Cases)" as core {
+    note as core_list
+      - Account (勘定科目)
+      - Journal (仕訳)
+      - Balance (残高)
+      - JournalDomainService
+      - AccountUseCase
+      - JournalUseCase
+      - BalanceUseCase
+    end note
+  }
+  rectangle "Input Adapters\n(Driving Side)" as input {
+    note as input_list
+      - Thymeleaf Controller
+      - フォーム処理
+      - セッション管理
+      - リクエスト検証
+    end note
+  }
+  rectangle "Output Adapters\n(Driven Side)" as output {
+    note as output_list
+      - MyBatis Repository
+      - Database Access
+      - Entity Mapping
+      - 帳票出力 (PDF/Excel)
+    end note
+  }
+  ' 接続線をパッケージ内に配置し、方向を指定
+  input --> core : "Input Ports\n(Use Cases)"
+  core --> output : "Output Ports\n(Repository Interfaces)"
+}
+' 注釈の配置
+note top of core
+  純粋なビジネスロジック
+  UI 技術（Thymeleaf）に依存しない
+  テスト可能な状態を維持
+end note
+note bottom of input
+  HTML フォームからの入力
+  サーバーサイドレンダリング
+  セッションベースの認証
+end note
+note bottom of output
+  PostgreSQL + MyBatis
+  帳票生成（PDF/Excel）
+  ファイル出力
+end note
+@enduml
+```
+**モノリスでもヘキサゴナルアーキテクチャを適用する理由：**
+1. **テスト容易性**：ドメインロジックを UI から分離してテスト可能
+2. **将来の移行**：必要に応じて API 層を追加可能
+3. **保守性**：関心の分離により変更影響を局所化
+4. **再利用性**：ドメインロジックを複数の UI で共有可能
+---
+### 22.5 ディレクトリ構成
+```
+src/main/java/com/example/accounting/
+├── domain/                     # ドメイン層（API版と共通）
+│   ├── model/
+│   │   ├── account/           # 勘定科目
+│   │   ├── journal/           # 仕訳
+│   │   ├── balance/           # 残高
+│   │   └── department/        # 部門
+│   └── exception/
+│
+├── application/               # アプリケーション層（API版と共通）
+│   ├── port/
+│   │   ├── in/               # Input Port（ユースケース）
+│   │   └── out/              # Output Port（リポジトリ）
+│   └── service/
+│
+├── infrastructure/
+│   ├── persistence/          # Output Adapter（DB実装）
+│   │   ├── mapper/
+│   │   └── repository/
+│   └── web/                  # Input Adapter（Web実装）
+│       ├── controller/       # Thymeleaf Controller
+│       ├── form/             # フォームオブジェクト
+│       └── helper/           # ビューヘルパー
+│
+├── config/
+│
+└── resources/
+    ├── templates/            # Thymeleaf テンプレート
+    │   ├── layout/           # 共通レイアウト
+    │   ├── accounts/         # 勘定科目マスタ画面
+    │   ├── journals/         # 仕訳入力画面
+    │   ├── balances/         # 残高照会画面
+    │   └── reports/          # 帳票出力画面
+    ├── static/               # 静的リソース
+    │   ├── css/
+    │   ├── js/
+    │   └── images/
+    └── messages.properties   # メッセージリソース
+```
+---
+### 22.6 技術スタックの導入
+<details>
+<summary>build.gradle.kts</summary>
+```kotlin
+plugins {
+    id("java")
+    id("org.springframework.boot") version "3.2.0"
+    id("io.spring.dependency-management") version "1.1.4"
+}
+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.3.0")
+    // Thymeleaf + Spring Security（認証機能を使う場合）
+    implementation("org.thymeleaf.extras:thymeleaf-extras-springsecurity6")
+    // htmx（モダンなインタラクティブUI）
+    // CDN から読み込むため依存関係は不要
+    // MyBatis
+    implementation("org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3")
+    // 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.2")
+    implementation("org.webjars:webjars-locator-core:0.55")
+    // 帳票出力
+    implementation("org.apache.poi:poi-ooxml:5.2.5")  // Excel
+    implementation("com.itextpdf:itext7-core:8.0.2")  // PDF
+    // Test
+    testImplementation("org.springframework.boot:spring-boot-starter-test")
+    testImplementation("org.testcontainers:postgresql:1.19.3")
+    testImplementation("org.testcontainers:junit-jupiter:1.19.3")
+    // Lombok
+    compileOnly("org.projectlombok:lombok")
+    annotationProcessor("org.projectlombok:lombok")
+}
+```
+</details>
+**パッケージの説明：**
+| パッケージ | 用途 |
+|-----------|------|
+| spring-boot-starter-thymeleaf | サーバーサイドテンプレートエンジン |
+| thymeleaf-layout-dialect | レイアウト継承（共通ヘッダー・フッター） |
+| webjars:bootstrap | CSS フレームワーク（サーバーから配信） |
+| poi-ooxml | Excel ファイル出力（帳票） |
+| itext7-core | PDF ファイル出力（帳票） |
+---
+### 22.7 基本的な Spring Boot + Thymeleaf アプリケーション
+<details>
+<summary>アプリケーションクラス</summary>
+```java
+package com.example.accounting;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+@SpringBootApplication
+public class AccountingApplication {
+    public static void main(String[] args) {
+        SpringApplication.run(AccountingApplication.class, args);
+    }
+}
+```
+</details>
+<details>
+<summary>application.yml</summary>
+```yaml
+spring:
+  datasource:
+    url: jdbc:postgresql://localhost:5432/accounting
+    username: postgres
+    password: postgres
+  thymeleaf:
+    cache: false  # 開発時はキャッシュ無効
+    prefix: classpath:/templates/
+    suffix: .html
+    encoding: UTF-8
+    mode: HTML
+  messages:
+    basename: messages
+    encoding: UTF-8
+mybatis:
+  mapper-locations: classpath:mapper/*.xml
+  configuration:
+    map-underscore-to-camel-case: true
+server:
+  servlet:
+    session:
+      timeout: 30m  # セッションタイムアウト
+```
+</details>
+<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.10"></script>
+</head>
+<body>
+    <!-- ナビゲーションバー -->
+    <nav class="navbar navbar-expand-lg navbar-dark bg-primary">
+        <div class="container-fluid">
+            <a class="navbar-brand" th:href="@{/}">財務会計システム</a>
+            <button class="navbar-toggler" type="button" data-bs-toggle="collapse"
+                    data-bs-target="#navbarNav">
+                <span class="navbar-toggler-icon"></span>
+            </button>
+            <div class="collapse navbar-collapse" id="navbarNav">
+                <ul class="navbar-nav">
+                    <li class="nav-item dropdown">
+                        <a class="nav-link dropdown-toggle" href="#" role="button"
+                           data-bs-toggle="dropdown">マスタ</a>
+                        <ul class="dropdown-menu">
+                            <li><a class="dropdown-item" th:href="@{/accounts}">勘定科目マスタ</a></li>
+                            <li><a class="dropdown-item" th:href="@{/account-structures}">勘定科目構成</a></li>
+                            <li><a class="dropdown-item" th:href="@{/tax-transactions}">課税取引マスタ</a></li>
+                            <li><a class="dropdown-item" th:href="@{/departments}">部門マスタ</a></li>
+                        </ul>
+                    </li>
+                    <li class="nav-item dropdown">
+                        <a class="nav-link dropdown-toggle" href="#" role="button"
+                           data-bs-toggle="dropdown">仕訳</a>
+                        <ul class="dropdown-menu">
+                            <li><a class="dropdown-item" th:href="@{/journals}">仕訳一覧</a></li>
+                            <li><a class="dropdown-item" th:href="@{/journals/new}">仕訳入力</a></li>
+                            <li><a class="dropdown-item" th:href="@{/journals/import}">仕訳取込</a></li>
+                        </ul>
+                    </li>
+                    <li class="nav-item dropdown">
+                        <a class="nav-link dropdown-toggle" href="#" role="button"
+                           data-bs-toggle="dropdown">照会</a>
+                        <ul class="dropdown-menu">
+                            <li><a class="dropdown-item" th:href="@{/balances/daily}">日次残高照会</a></li>
+                            <li><a class="dropdown-item" th:href="@{/balances/monthly}">月次残高照会</a></li>
+                        </ul>
+                    </li>
+                    <li class="nav-item dropdown">
+                        <a class="nav-link dropdown-toggle" href="#" role="button"
+                           data-bs-toggle="dropdown">帳票</a>
+                        <ul class="dropdown-menu">
+                            <li><a class="dropdown-item" th:href="@{/reports/daily}">日計表</a></li>
+                            <li><a class="dropdown-item" th:href="@{/reports/trial-balance}">合計残高試算表</a></li>
+                            <li><a class="dropdown-item" th:href="@{/reports/ledger}">総勘定元帳</a></li>
+                            <li><hr class="dropdown-divider"></li>
+                            <li><a class="dropdown-item" th:href="@{/reports/balance-sheet}">貸借対照表</a></li>
+                            <li><a class="dropdown-item" th:href="@{/reports/income-statement}">損益計算書</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" role="alert">
+            <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" role="alert">
+            <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>
+    <!-- フッター -->
+    <footer class="footer mt-5 py-3 bg-light">
+        <div class="container text-center">
+            <span class="text-muted">財務会計システム &copy; 2025</span>
+        </div>
+    </footer>
+    <!-- Bootstrap JS -->
+    <script th:src="@{/webjars/bootstrap/js/bootstrap.bundle.min.js}"></script>
+    <!-- ページ固有のスクリプト -->
+    <th:block layout:fragment="scripts"></th:block>
+</body>
+</html>
+```
+</details>
+---
+### 22.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
+```
+<details>
+<summary>htmx の基本的な使い方</summary>
+```html
+<!-- 勘定科目検索（部分更新） -->
+<div class="mb-3">
+    <input type="text"
+           class="form-control"
+           name="keyword"
+           placeholder="勘定科目コードまたは勘定科目名で検索"
+           hx-get="/accounts/search"
+           hx-trigger="keyup changed delay:300ms"
+           hx-target="#search-results"
+           hx-indicator="#loading">
+    <span id="loading" class="htmx-indicator">検索中...</span>
+</div>
+<!-- 検索結果がここに挿入される -->
+<div id="search-results">
+    <!-- Controller から返される HTML フラグメント -->
+</div>
+```
+</details>
+<details>
+<summary>部分更新用 Controller</summary>
+```java
+@Controller
+@RequestMapping("/accounts")
+public class AccountController {
+    private final AccountUseCase accountUseCase;
+    // ... コンストラクタ省略
+    /**
+     * htmx 用の検索エンドポイント（フラグメントを返す）
+     */
+    @GetMapping("/search")
+    public String search(
+            @RequestParam(required = false) String keyword,
+            Model model) {
+        List<Account> accounts = accountUseCase.searchAccounts(keyword);
+        model.addAttribute("accounts", accounts);
+        // フラグメントのみを返す
+        return "accounts/search-results :: results";
+    }
+}
+```
+</details>
+---
+### 22.9 API サーバー版との Controller の違い
+<details>
+<summary>API サーバー版（REST Controller）</summary>
+```java
+@RestController  // JSON を返す
+@RequestMapping("/api/accounts")
+public class AccountApiController {
+    @GetMapping
+    public ResponseEntity<List<AccountResponse>> getAllAccounts() {
+        List<Account> accounts = accountUseCase.getAllAccounts();
+        return ResponseEntity.ok(accounts.stream()
+            .map(AccountResponse::from)
+            .toList());
+    }
+    @PostMapping
+    public ResponseEntity<AccountResponse> createAccount(
+            @Valid @RequestBody CreateAccountRequest request) {  // JSON リクエスト
+        Account account = accountUseCase.createAccount(request.toCommand());
+        return ResponseEntity.status(HttpStatus.CREATED)
+            .body(AccountResponse.from(account));
+    }
+}
+```
+</details>
+<details>
+<summary>モノリス版（MVC Controller）</summary>
+```java
+@Controller  // HTML を返す
+@RequestMapping("/accounts")
+public class AccountController {
+    @GetMapping
+    public String list(Model model) {
+        List<Account> accounts = accountUseCase.getAllAccounts();
+        model.addAttribute("accounts", accounts);
+        return "accounts/list";  // Thymeleaf テンプレート
+    }
+    @PostMapping
+    public String create(
+            @Valid @ModelAttribute("form") AccountForm form,  // フォームデータ
+            BindingResult bindingResult,
+            RedirectAttributes redirectAttributes) {
+        if (bindingResult.hasErrors()) {
+            return "accounts/new";  // バリデーションエラー時は入力画面に戻る
+        }
+        accountUseCase.createAccount(form.toCommand());
+        redirectAttributes.addFlashAttribute("successMessage", "勘定科目を登録しました");
+        return "redirect:/accounts";  // PRG パターン
+    }
+}
+```
+</details>
+**主な違い：**
+| 観点 | API サーバー版 | モノリス版 |
+|------|--------------|-----------|
+| アノテーション | `@RestController` | `@Controller` |
+| 戻り値 | `ResponseEntity<T>` | テンプレート名（String） |
+| リクエスト | `@RequestBody`（JSON） | `@ModelAttribute`（フォーム） |
+| バリデーション | 例外ハンドラで処理 | `BindingResult` で処理 |
+| レスポンス | JSON | HTML（Thymeleaf） |
+| リダイレクト | 不要 | PRG パターン |
+---
+## 第23章：マスタ画面の実装
+### 23.1 勘定科目マスタ画面の設計
+#### 画面一覧
+| 画面 | URL | メソッド | 説明 |
+|------|-----|---------|------|
+| 勘定科目一覧 | /accounts | GET | 勘定科目の検索・一覧表示 |
+| 勘定科目詳細 | /accounts/{accountCode} | GET | 勘定科目の詳細表示 |
+| 勘定科目登録 | /accounts/new | GET | 登録フォーム表示 |
+| 勘定科目登録処理 | /accounts | POST | 登録処理 |
+| 勘定科目編集 | /accounts/{accountCode}/edit | GET | 編集フォーム表示 |
+| 勘定科目更新処理 | /accounts/{accountCode} | POST | 更新処理（PUT 代替） |
+| 勘定科目削除処理 | /accounts/{accountCode}/delete | POST | 削除処理（DELETE 代替） |
+**注意**: HTML フォームは GET/POST のみ対応のため、PUT/DELETE は POST で代替します。
+---
+### 23.2 フォームオブジェクトの設計
+<details>
+<summary>AccountForm.java</summary>
+```java
+package com.example.accounting.infrastructure.web.form;
+import com.example.accounting.application.port.in.CreateAccountCommand;
+import com.example.accounting.domain.model.account.*;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+/**
+ * 勘定科目登録・編集フォーム
+ */
+@Data
+public class AccountForm {
+    @NotBlank(message = "勘定科目コードは必須です")
+    @Size(max = 5, message = "勘定科目コードは5文字以内で入力してください")
+    private String accountCode;
+    @NotBlank(message = "勘定科目名は必須です")
+    @Size(max = 40, message = "勘定科目名は40文字以内で入力してください")
+    private String accountName;
+    @Size(max = 10, message = "勘定科目略名は10文字以内で入力してください")
+    private String accountShortName;
+    @Size(max = 40, message = "勘定科目カナは40文字以内で入力してください")
+    private String accountNameKana;
+    @NotNull(message = "BSPL区分は必須です")
+    private BsplType bsplType;
+    @NotNull(message = "貸借区分は必須です")
+    private DebitCreditType debitCreditType;
+    @NotNull(message = "取引要素区分は必須です")
+    private TransactionElementType transactionElementType;
+    @NotNull(message = "集計区分は必須です")
+    private AggregationType aggregationType;
+    private ManagementAccountType managementAccountType;
+    private ExpenseType expenseType;
+    private SubsidiaryType subsidiaryType;
+    private TaxCalculationType taxCalculationType;
+    private String taxTransactionCode;
+    /**
+     * フォームをコマンドに変換
+     */
+    public CreateAccountCommand toCommand() {
+        return CreateAccountCommand.builder()
+            .accountCode(this.accountCode)
+            .accountName(this.accountName)
+            .accountShortName(this.accountShortName)
+            .accountNameKana(this.accountNameKana)
+            .bsplType(this.bsplType)
+            .debitCreditType(this.debitCreditType)
+            .transactionElementType(this.transactionElementType)
+            .aggregationType(this.aggregationType)
+            .managementAccountType(this.managementAccountType)
+            .expenseType(this.expenseType)
+            .subsidiaryType(this.subsidiaryType)
+            .taxCalculationType(this.taxCalculationType)
+            .taxTransactionCode(this.taxTransactionCode)
+            .build();
+    }
+    /**
+     * エンティティからフォームを生成
+     */
+    public static AccountForm from(Account account) {
+        AccountForm form = new AccountForm();
+        form.setAccountCode(account.getAccountCode());
+        form.setAccountName(account.getAccountName());
+        form.setAccountShortName(account.getAccountShortName());
+        form.setAccountNameKana(account.getAccountNameKana());
+        form.setBsplType(account.getBsplType());
+        form.setDebitCreditType(account.getDebitCreditType());
+        form.setTransactionElementType(account.getTransactionElementType());
+        form.setAggregationType(account.getAggregationType());
+        form.setManagementAccountType(account.getManagementAccountType());
+        form.setExpenseType(account.getExpenseType());
+        form.setSubsidiaryType(account.getSubsidiaryType());
+        form.setTaxCalculationType(account.getTaxCalculationType());
+        form.setTaxTransactionCode(account.getTaxTransactionCode());
+        return form;
+    }
+}
+```
+</details>
+---
+### 23.3 勘定科目 Controller の TDD 実装
+#### Red: 失敗するテストを書く
+<details>
+<summary>AccountControllerTest.java</summary>
+```java
+package com.example.accounting.infrastructure.web.controller;
+import com.example.accounting.domain.model.account.*;
+import com.example.accounting.infrastructure.persistence.mapper.AccountMapper;
+import org.junit.jupiter.api.*;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.test.context.DynamicPropertyRegistry;
+import org.springframework.test.context.DynamicPropertySource;
+import org.springframework.test.web.servlet.MockMvc;
+import org.testcontainers.containers.PostgreSQLContainer;
+import org.testcontainers.junit.jupiter.Container;
+import org.testcontainers.junit.jupiter.Testcontainers;
+import static org.hamcrest.Matchers.*;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
+@SpringBootTest
+@AutoConfigureMockMvc
+@Testcontainers
+@DisplayName("勘定科目マスタ画面")
+class AccountControllerTest {
+    @Container
+    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16")
+            .withDatabaseName("accounting_test")
+            .withUsername("test")
+            .withPassword("test");
+    @DynamicPropertySource
+    static void configureProperties(DynamicPropertyRegistry registry) {
+        registry.add("spring.datasource.url", postgres::getJdbcUrl);
+        registry.add("spring.datasource.username", postgres::getUsername);
+        registry.add("spring.datasource.password", postgres::getPassword);
+    }
+    @Autowired
+    private MockMvc mockMvc;
+    @Autowired
+    private AccountMapper accountMapper;
+    @BeforeEach
+    void setUp() {
+        accountMapper.deleteAll();
+    }
+    @Nested
+    @DisplayName("GET /accounts - 勘定科目一覧")
+    class AccountList {
+        @Test
+        @DisplayName("勘定科目一覧画面を表示できる")
+        void shouldDisplayAccountList() throws Exception {
+            // Arrange
+            insertTestAccount("11110", "現金", BsplType.BS, DebitCreditType.DEBIT);
+            // Act & Assert
+            mockMvc.perform(get("/accounts"))
+                .andExpect(status().isOk())
+                .andExpect(view().name("accounts/list"))
+                .andExpect(model().attributeExists("accounts"))
+                .andExpect(content().string(containsString("11110")))
+                .andExpect(content().string(containsString("現金")));
+        }
+        @Test
+        @DisplayName("BSPL区分でフィルタリングできる")
+        void shouldFilterByBsplType() throws Exception {
+            // Arrange
+            insertTestAccount("11110", "現金", BsplType.BS, DebitCreditType.DEBIT);
+            insertTestAccount("41100", "売上高", BsplType.PL, DebitCreditType.CREDIT);
+            // Act & Assert
+            mockMvc.perform(get("/accounts").param("bsplType", "BS"))
+                .andExpect(status().isOk())
+                .andExpect(model().attribute("accounts", hasSize(1)))
+                .andExpect(content().string(containsString("現金")))
+                .andExpect(content().string(not(containsString("売上高"))));
+        }
+    }
+    @Nested
+    @DisplayName("POST /accounts - 勘定科目登録処理")
+    class CreateAccount {
+        @Test
+        @DisplayName("勘定科目を登録できる")
+        void shouldCreateAccount() throws Exception {
+            mockMvc.perform(post("/accounts")
+                    .param("accountCode", "11120")
+                    .param("accountName", "当座預金")
+                    .param("bsplType", "BS")
+                    .param("debitCreditType", "DEBIT")
+                    .param("transactionElementType", "ASSET")
+                    .param("aggregationType", "POSTING"))
+                .andExpect(status().is3xxRedirection())
+                .andExpect(redirectedUrl("/accounts"))
+                .andExpect(flash().attribute("successMessage", containsString("登録")));
+            // データベースに保存されていることを確認
+            var saved = accountMapper.findByCode("11120");
+            Assertions.assertNotNull(saved);
+            Assertions.assertEquals("当座預金", saved.getAccountName());
+        }
+        @Test
+        @DisplayName("バリデーションエラー時は入力画面に戻る")
+        void shouldReturnFormOnValidationError() throws Exception {
+            mockMvc.perform(post("/accounts")
+                    .param("accountCode", "")  // 必須項目が空
+                    .param("accountName", "")
+                    .param("bsplType", "BS"))
+                .andExpect(status().isOk())
+                .andExpect(view().name("accounts/new"))
+                .andExpect(model().attributeHasFieldErrors("form", "accountCode", "accountName"));
+        }
+    }
+    private void insertTestAccount(String code, String name, BsplType bsplType, DebitCreditType debitCreditType) {
+        accountMapper.insert(Account.builder()
+            .accountCode(code)
+            .accountName(name)
+            .accountShortName(name)
+            .accountNameKana("")
+            .bsplType(bsplType)
+            .debitCreditType(debitCreditType)
+            .transactionElementType(TransactionElementType.ASSET)
+            .aggregationType(AggregationType.POSTING)
+            .build());
+    }
+}
+```
+</details>
+#### Green: Controller の実装
+<details>
+<summary>AccountController.java</summary>
+```java
+package com.example.accounting.infrastructure.web.controller;
+import com.example.accounting.application.port.in.*;
+import com.example.accounting.domain.exception.AccountInUseException;
+import com.example.accounting.domain.exception.AccountNotFoundException;
+import com.example.accounting.domain.exception.DuplicateAccountException;
+import com.example.accounting.domain.model.account.*;
+import com.example.accounting.infrastructure.web.form.AccountForm;
+import jakarta.validation.Valid;
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.validation.BindingResult;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.servlet.mvc.support.RedirectAttributes;
+import java.util.List;
+/**
+ * 勘定科目マスタ Controller
+ */
+@Controller
+@RequestMapping("/accounts")
+public class AccountController {
+    private final AccountUseCase accountUseCase;
+    public AccountController(AccountUseCase accountUseCase) {
+        this.accountUseCase = accountUseCase;
+    }
+    /**
+     * 勘定科目一覧画面
+     */
+    @GetMapping
+    public String list(
+            @RequestParam(required = false) String keyword,
+            @RequestParam(required = false) BsplType bsplType,
+            @RequestParam(required = false) DebitCreditType debitCreditType,
+            Model model) {
+        List<Account> accounts;
+        if (keyword != null || bsplType != null || debitCreditType != null) {
+            accounts = accountUseCase.searchAccounts(keyword, bsplType, debitCreditType);
+        } else {
+            accounts = accountUseCase.getAllAccounts();
+        }
+        model.addAttribute("accounts", accounts);
+        model.addAttribute("keyword", keyword);
+        model.addAttribute("selectedBsplType", bsplType);
+        model.addAttribute("selectedDebitCreditType", debitCreditType);
+        addEnumsToModel(model);
+        return "accounts/list";
+    }
+    /**
+     * 勘定科目登録画面
+     */
+    @GetMapping("/new")
+    public String newForm(Model model) {
+        model.addAttribute("form", new AccountForm());
+        addEnumsToModel(model);
+        return "accounts/new";
+    }
+    /**
+     * 勘定科目登録処理
+     */
+    @PostMapping
+    public String create(
+            @Valid @ModelAttribute("form") AccountForm form,
+            BindingResult bindingResult,
+            Model model,
+            RedirectAttributes redirectAttributes) {
+        if (bindingResult.hasErrors()) {
+            addEnumsToModel(model);
+            return "accounts/new";
+        }
+        try {
+            accountUseCase.createAccount(form.toCommand());
+            redirectAttributes.addFlashAttribute("successMessage",
+                "勘定科目「" + form.getAccountName() + "」を登録しました");
+            return "redirect:/accounts";
+        } catch (DuplicateAccountException e) {
+            model.addAttribute("errorMessage",
+                "勘定科目コード「" + form.getAccountCode() + "」は既に存在します");
+            addEnumsToModel(model);
+            return "accounts/new";
+        }
+    }
+    /**
+     * 勘定科目詳細画面
+     */
+    @GetMapping("/{accountCode}")
+    public String detail(@PathVariable String accountCode, Model model) {
+        Account account = accountUseCase.getAccount(accountCode)
+            .orElseThrow(() -> new AccountNotFoundException(accountCode));
+        model.addAttribute("account", account);
+        return "accounts/detail";
+    }
+    /**
+     * 勘定科目削除処理
+     */
+    @PostMapping("/{accountCode}/delete")
+    public String delete(
+            @PathVariable String accountCode,
+            Model model,
+            RedirectAttributes redirectAttributes) {
+        try {
+            Account account = accountUseCase.getAccount(accountCode)
+                .orElseThrow(() -> new AccountNotFoundException(accountCode));
+            accountUseCase.deleteAccount(accountCode);
+            redirectAttributes.addFlashAttribute("successMessage",
+                "勘定科目「" + account.getAccountName() + "」を削除しました");
+            return "redirect:/accounts";
+        } catch (AccountInUseException e) {
+            Account account = accountUseCase.getAccount(accountCode).orElseThrow();
+            model.addAttribute("account", account);
+            model.addAttribute("errorMessage",
+                "この勘定科目は仕訳で使用中のため削除できません");
+            return "accounts/detail";
+        }
+    }
+    /**
+     * 列挙型をモデルに追加
+     */
+    private void addEnumsToModel(Model model) {
+        model.addAttribute("bsplTypes", BsplType.values());
+        model.addAttribute("debitCreditTypes", DebitCreditType.values());
+        model.addAttribute("transactionElementTypes", TransactionElementType.values());
+        model.addAttribute("aggregationTypes", AggregationType.values());
+        model.addAttribute("managementAccountTypes", ManagementAccountType.values());
+        model.addAttribute("expenseTypes", ExpenseType.values());
+        model.addAttribute("subsidiaryTypes", SubsidiaryType.values());
+        model.addAttribute("taxCalculationTypes", TaxCalculationType.values());
+    }
+    /**
+     * 404 エラーハンドリング
+     */
+    @ExceptionHandler(AccountNotFoundException.class)
+    @ResponseStatus(org.springframework.http.HttpStatus.NOT_FOUND)
+    public String handleNotFound(AccountNotFoundException e, Model model) {
+        model.addAttribute("errorMessage", e.getMessage());
+        return "error/404";
+    }
+}
+```
+</details>
+---
+## 第24章：仕訳入力画面の実装
+### 24.1 仕訳入力画面の設計
+#### 画面一覧
+| 画面 | URL | メソッド | 説明 |
+|------|-----|---------|------|
+| 仕訳一覧 | /journals | GET | 仕訳の検索・一覧表示 |
+| 仕訳詳細 | /journals/{journalNumber} | GET | 仕訳の詳細表示 |
+| 仕訳入力 | /journals/new | GET | 入力フォーム表示 |
+| 仕訳登録処理 | /journals | POST | 登録処理 |
+| 仕訳取消 | /journals/{journalNumber}/cancel | POST | 赤黒処理 |
+---
+### 24.2 仕訳入力フォームオブジェクト
+<details>
+<summary>JournalForm.java</summary>
+```java
+package com.example.accounting.infrastructure.web.form;
+import com.example.accounting.application.port.in.CreateJournalCommand;
+import com.example.accounting.domain.model.journal.SingleComplexType;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import java.time.LocalDate;
+import java.util.ArrayList;
+import java.util.List;
+/**
+ * 仕訳入力フォーム
+ */
+@Data
+public class JournalForm {
+    @NotNull(message = "起票日は必須です")
+    private LocalDate journalDate;
+    private String description;
+    private boolean closingJournal;
+    @NotNull(message = "単複区分は必須です")
+    private SingleComplexType singleComplexType;
+    @Valid
+    @NotEmpty(message = "仕訳明細は1行以上必要です")
+    private List<JournalLineForm> lines = new ArrayList<>();
+    /**
+     * フォームをコマンドに変換
+     */
+    public CreateJournalCommand toCommand() {
+        return CreateJournalCommand.builder()
+            .journalDate(this.journalDate)
+            .description(this.description)
+            .closingJournal(this.closingJournal)
+            .singleComplexType(this.singleComplexType)
+            .lines(this.lines.stream()
+                .map(JournalLineForm::toCommand)
+                .toList())
+            .build();
+    }
+    /**
+     * 初期化（空の明細行を追加）
+     */
+    public void initializeLines() {
+        if (this.lines.isEmpty()) {
+            // 借方1行、貸方1行を追加
+            JournalLineForm debitLine = new JournalLineForm();
+            debitLine.setDebitCredit("DEBIT");
+            this.lines.add(debitLine);
+            JournalLineForm creditLine = new JournalLineForm();
+            creditLine.setDebitCredit("CREDIT");
+            this.lines.add(creditLine);
+        }
+    }
+}
+```
+</details>
+<details>
+<summary>JournalLineForm.java</summary>
+```java
+package com.example.accounting.infrastructure.web.form;
+import com.example.accounting.application.port.in.CreateJournalLineCommand;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Positive;
+import lombok.Data;
+import java.math.BigDecimal;
+/**
+ * 仕訳明細行フォーム
+ */
+@Data
+public class JournalLineForm {
+    @NotBlank(message = "貸借区分は必須です")
+    private String debitCredit;  // "DEBIT" or "CREDIT"
+    @NotBlank(message = "勘定科目コードは必須です")
+    private String accountCode;
+    private String subsidiaryCode;
+    @NotNull(message = "金額は必須です")
+    @Positive(message = "金額は正の数で入力してください")
+    private BigDecimal amount;
+    private String taxType;
+    private BigDecimal taxRate;
+    private String departmentCode;
+    private String projectCode;
+    private String lineDescription;
+    /**
+     * フォームをコマンドに変換
+     */
+    public CreateJournalLineCommand toCommand() {
+        return CreateJournalLineCommand.builder()
+            .debitCredit(this.debitCredit)
+            .accountCode(this.accountCode)
+            .subsidiaryCode(this.subsidiaryCode)
+            .amount(this.amount)
+            .taxType(this.taxType)
+            .taxRate(this.taxRate)
+            .departmentCode(this.departmentCode)
+            .projectCode(this.projectCode)
+            .lineDescription(this.lineDescription)
+            .build();
+    }
+}
+```
+</details>
+---
+### 24.3 仕訳 Controller の実装
+<details>
+<summary>JournalController.java</summary>
+```java
+package com.example.accounting.infrastructure.web.controller;
+import com.example.accounting.application.port.in.*;
+import com.example.accounting.domain.exception.DebitCreditImbalanceException;
+import com.example.accounting.domain.exception.JournalNotFoundException;
+import com.example.accounting.domain.model.journal.*;
+import com.example.accounting.infrastructure.web.form.JournalForm;
+import jakarta.validation.Valid;
+import org.springframework.format.annotation.DateTimeFormat;
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.validation.BindingResult;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.servlet.mvc.support.RedirectAttributes;
+import java.time.LocalDate;
+import java.util.List;
+/**
+ * 仕訳 Controller
+ */
+@Controller
+@RequestMapping("/journals")
+public class JournalController {
+    private final JournalUseCase journalUseCase;
+    private final AccountUseCase accountUseCase;
+    private final DepartmentUseCase departmentUseCase;
+    public JournalController(
+            JournalUseCase journalUseCase,
+            AccountUseCase accountUseCase,
+            DepartmentUseCase departmentUseCase) {
+        this.journalUseCase = journalUseCase;
+        this.accountUseCase = accountUseCase;
+        this.departmentUseCase = departmentUseCase;
+    }
+    /**
+     * 仕訳一覧画面
+     */
+    @GetMapping
+    public String list(
+            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate fromDate,
+            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate toDate,
+            @RequestParam(required = false) String accountCode,
+            @RequestParam(required = false) JournalStatus status,
+            Model model) {
+        // デフォルトは当月
+        if (fromDate == null) {
+            fromDate = LocalDate.now().withDayOfMonth(1);
+        }
+        if (toDate == null) {
+            toDate = LocalDate.now();
+        }
+        List<Journal> journals = journalUseCase.searchJournals(fromDate, toDate, accountCode, status);
+        model.addAttribute("journals", journals);
+        model.addAttribute("fromDate", fromDate);
+        model.addAttribute("toDate", toDate);
+        model.addAttribute("accountCode", accountCode);
+        model.addAttribute("status", status);
+        model.addAttribute("statuses", JournalStatus.values());
+        return "journals/list";
+    }
+    /**
+     * 仕訳入力画面
+     */
+    @GetMapping("/new")
+    public String newForm(Model model) {
+        JournalForm form = new JournalForm();
+        form.setJournalDate(LocalDate.now());
+        form.setSingleComplexType(SingleComplexType.SINGLE);
+        form.initializeLines();
+        model.addAttribute("form", form);
+        addMasterDataToModel(model);
+        return "journals/new";
+    }
+    /**
+     * 仕訳登録処理
+     */
+    @PostMapping
+    public String create(
+            @Valid @ModelAttribute("form") JournalForm form,
+            BindingResult bindingResult,
+            Model model,
+            RedirectAttributes redirectAttributes) {
+        if (bindingResult.hasErrors()) {
+            addMasterDataToModel(model);
+            return "journals/new";
+        }
+        try {
+            Journal journal = journalUseCase.createJournal(form.toCommand());
+            redirectAttributes.addFlashAttribute("successMessage",
+                "仕訳「" + journal.getJournalNumber() + "」を登録しました");
+            return "redirect:/journals/" + journal.getJournalNumber();
+        } catch (DebitCreditImbalanceException e) {
+            model.addAttribute("errorMessage", "借方・貸方の合計が一致しません");
+            addMasterDataToModel(model);
+            return "journals/new";
+        }
+    }
+    /**
+     * 仕訳詳細画面
+     */
+    @GetMapping("/{journalNumber}")
+    public String detail(@PathVariable String journalNumber, Model model) {
+        Journal journal = journalUseCase.getJournal(journalNumber)
+            .orElseThrow(() -> new JournalNotFoundException(journalNumber));
+        model.addAttribute("journal", journal);
+        return "journals/detail";
+    }
+    /**
+     * 仕訳取消処理（赤黒処理）
+     */
+    @PostMapping("/{journalNumber}/cancel")
+    public String cancel(
+            @PathVariable String journalNumber,
+            @RequestParam(required = false) String reason,
+            RedirectAttributes redirectAttributes) {
+        Journal cancelJournal = journalUseCase.cancelJournal(journalNumber, reason);
+        redirectAttributes.addFlashAttribute("successMessage",
+            "仕訳「" + journalNumber + "」を取消しました。" +
+            "取消仕訳「" + cancelJournal.getJournalNumber() + "」を作成しました。");
+        return "redirect:/journals/" + cancelJournal.getJournalNumber();
+    }
+    /**
+     * マスタデータをモデルに追加
+     */
+    private void addMasterDataToModel(Model model) {
+        model.addAttribute("accounts", accountUseCase.getPostingAccounts());
+        model.addAttribute("departments", departmentUseCase.getAllDepartments());
+        model.addAttribute("singleComplexTypes", SingleComplexType.values());
+    }
+}
+```
+</details>
+---
+## 第25章：帳票出力の実装
+### 25.1 帳票出力の設計
+財務会計システムでは、以下の帳票を出力します。
+| 帳票名 | 説明 | 出力形式 |
+|-------|------|---------|
+| 日計表 | 日次の仕訳合計 | HTML / Excel / PDF |
+| 合計残高試算表 | 月次の勘定科目残高 | HTML / Excel / PDF |
+| 総勘定元帳 | 勘定科目別の仕訳明細 | HTML / Excel / PDF |
+| 貸借対照表 | 資産・負債・資本の状況 | HTML / Excel / PDF |
+| 損益計算書 | 収益・費用の状況 | HTML / Excel / PDF |
+---
+### 25.2 帳票 Controller の実装
+<details>
+<summary>ReportController.java</summary>
+```java
+package com.example.accounting.infrastructure.web.controller;
+import com.example.accounting.application.port.in.*;
+import com.example.accounting.domain.model.report.*;
+import com.example.accounting.infrastructure.report.ExcelReportGenerator;
+import com.example.accounting.infrastructure.report.PdfReportGenerator;
+import org.springframework.format.annotation.DateTimeFormat;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.stereotype.Controller;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.*;
+import java.time.LocalDate;
+import java.time.YearMonth;
+/**
+ * 帳票出力 Controller
+ */
+@Controller
+@RequestMapping("/reports")
+public class ReportController {
+    private final ReportUseCase reportUseCase;
+    private final ExcelReportGenerator excelGenerator;
+    private final PdfReportGenerator pdfGenerator;
+    public ReportController(
+            ReportUseCase reportUseCase,
+            ExcelReportGenerator excelGenerator,
+            PdfReportGenerator pdfGenerator) {
+        this.reportUseCase = reportUseCase;
+        this.excelGenerator = excelGenerator;
+        this.pdfGenerator = pdfGenerator;
+    }
+    /**
+     * 日計表画面
+     */
+    @GetMapping("/daily")
+    public String dailyReport(
+            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
+            Model model) {
+        if (date == null) {
+            date = LocalDate.now();
+        }
+        DailyReport report = reportUseCase.getDailyReport(date);
+        model.addAttribute("report", report);
+        model.addAttribute("date", date);
+        return "reports/daily";
+    }
+    /**
+     * 日計表 Excel 出力
+     */
+    @GetMapping("/daily/excel")
+    public ResponseEntity<byte[]> dailyReportExcel(
+            @RequestParam @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date) {
+        DailyReport report = reportUseCase.getDailyReport(date);
+        byte[] excelData = excelGenerator.generateDailyReport(report);
+        return ResponseEntity.ok()
+            .header(HttpHeaders.CONTENT_DISPOSITION,
+                "attachment; filename=\"daily_report_" + date + ".xlsx\"")
+            .contentType(MediaType.parseMediaType(
+                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"))
+            .body(excelData);
+    }
+    /**
+     * 日計表 PDF 出力
+     */
+    @GetMapping("/daily/pdf")
+    public ResponseEntity<byte[]> dailyReportPdf(
+            @RequestParam @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date) {
+        DailyReport report = reportUseCase.getDailyReport(date);
+        byte[] pdfData = pdfGenerator.generateDailyReport(report);
+        return ResponseEntity.ok()
+            .header(HttpHeaders.CONTENT_DISPOSITION,
+                "attachment; filename=\"daily_report_" + date + ".pdf\"")
+            .contentType(MediaType.APPLICATION_PDF)
+            .body(pdfData);
+    }
+    /**
+     * 合計残高試算表画面
+     */
+    @GetMapping("/trial-balance")
+    public String trialBalance(
+            @RequestParam(required = false) String fiscalYear,
+            @RequestParam(required = false) Integer month,
+            Model model) {
+        YearMonth yearMonth = (fiscalYear != null && month != null)
+            ? YearMonth.of(Integer.parseInt(fiscalYear), month)
+            : YearMonth.now();
+        TrialBalance report = reportUseCase.getTrialBalance(yearMonth);
+        model.addAttribute("report", report);
+        model.addAttribute("yearMonth", yearMonth);
+        return "reports/trial-balance";
+    }
+    /**
+     * 合計残高試算表 Excel 出力
+     */
+    @GetMapping("/trial-balance/excel")
+    public ResponseEntity<byte[]> trialBalanceExcel(
+            @RequestParam String fiscalYear,
+            @RequestParam Integer month) {
+        YearMonth yearMonth = YearMonth.of(Integer.parseInt(fiscalYear), month);
+        TrialBalance report = reportUseCase.getTrialBalance(yearMonth);
+        byte[] excelData = excelGenerator.generateTrialBalance(report);
+        return ResponseEntity.ok()
+            .header(HttpHeaders.CONTENT_DISPOSITION,
+                "attachment; filename=\"trial_balance_" + yearMonth + ".xlsx\"")
+            .contentType(MediaType.parseMediaType(
+                "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"))
+            .body(excelData);
+    }
+    /**
+     * 貸借対照表画面
+     */
+    @GetMapping("/balance-sheet")
+    public String balanceSheet(
+            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
+            Model model) {
+        if (date == null) {
+            date = LocalDate.now();
+        }
+        BalanceSheet report = reportUseCase.getBalanceSheet(date);
+        model.addAttribute("report", report);
+        model.addAttribute("date", date);
+        return "reports/balance-sheet";
+    }
+    /**
+     * 損益計算書画面
+     */
+    @GetMapping("/income-statement")
+    public String incomeStatement(
+            @RequestParam(required = false) String fiscalYear,
+            @RequestParam(required = false) Integer fromMonth,
+            @RequestParam(required = false) Integer toMonth,
+            Model model) {
+        YearMonth from = (fiscalYear != null && fromMonth != null)
+            ? YearMonth.of(Integer.parseInt(fiscalYear), fromMonth)
+            : YearMonth.now().withMonth(4);  // 期首（4月）
+        YearMonth to = (fiscalYear != null && toMonth != null)
+            ? YearMonth.of(Integer.parseInt(fiscalYear), toMonth)
+            : YearMonth.now();
+        IncomeStatement report = reportUseCase.getIncomeStatement(from, to);
+        model.addAttribute("report", report);
+        model.addAttribute("fromMonth", from);
+        model.addAttribute("toMonth", to);
+        return "reports/income-statement";
+    }
+}
+```
+</details>
+---
+### 25.3 Excel 帳票生成
+<details>
+<summary>ExcelReportGenerator.java</summary>
+```java
+package com.example.accounting.infrastructure.report;
+import com.example.accounting.domain.model.report.*;
+import org.apache.poi.ss.usermodel.*;
+import org.apache.poi.ss.util.CellRangeAddress;
+import org.apache.poi.xssf.usermodel.XSSFWorkbook;
+import org.springframework.stereotype.Component;
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.time.format.DateTimeFormatter;
+/**
+ * Excel 帳票生成
+ */
+@Component
+public class ExcelReportGenerator {
+    /**
+     * 日計表 Excel 生成
+     */
+    public byte[] generateDailyReport(DailyReport report) {
+        try (Workbook workbook = new XSSFWorkbook()) {
+            Sheet sheet = workbook.createSheet("日計表");
+            // スタイル設定
+            CellStyle headerStyle = createHeaderStyle(workbook);
+            CellStyle amountStyle = createAmountStyle(workbook);
+            // タイトル
+            Row titleRow = sheet.createRow(0);
+            Cell titleCell = titleRow.createCell(0);
+            titleCell.setCellValue("日 計 表");
+            sheet.addMergedRegion(new CellRangeAddress(0, 0, 0, 5));
+            // 日付
+            Row dateRow = sheet.createRow(1);
+            dateRow.createCell(0).setCellValue(
+                report.getDate().format(DateTimeFormatter.ofPattern("yyyy年MM月dd日")));
+            // ヘッダー
+            Row headerRow = sheet.createRow(3);
+            String[] headers = {"勘定科目コード", "勘定科目名", "借方金額", "貸方金額"};
+            for (int i = 0; i < headers.length; i++) {
+                Cell cell = headerRow.createCell(i);
+                cell.setCellValue(headers[i]);
+                cell.setCellStyle(headerStyle);
+            }
+            // データ行
+            int rowNum = 4;
+            for (DailyReportLine line : report.getLines()) {
+                Row row = sheet.createRow(rowNum++);
+                row.createCell(0).setCellValue(line.getAccountCode());
+                row.createCell(1).setCellValue(line.getAccountName());
+                Cell debitCell = row.createCell(2);
+                debitCell.setCellValue(line.getDebitAmount().doubleValue());
+                debitCell.setCellStyle(amountStyle);
+                Cell creditCell = row.createCell(3);
+                creditCell.setCellValue(line.getCreditAmount().doubleValue());
+                creditCell.setCellStyle(amountStyle);
+            }
+            // 合計行
+            Row totalRow = sheet.createRow(rowNum);
+            totalRow.createCell(1).setCellValue("合計");
+            Cell totalDebitCell = totalRow.createCell(2);
+            totalDebitCell.setCellValue(report.getTotalDebit().doubleValue());
+            totalDebitCell.setCellStyle(amountStyle);
+            Cell totalCreditCell = totalRow.createCell(3);
+            totalCreditCell.setCellValue(report.getTotalCredit().doubleValue());
+            totalCreditCell.setCellStyle(amountStyle);
+            // 列幅調整
+            for (int i = 0; i < 4; i++) {
+                sheet.autoSizeColumn(i);
+            }
+            ByteArrayOutputStream out = new ByteArrayOutputStream();
+            workbook.write(out);
+            return out.toByteArray();
+        } catch (IOException e) {
+            throw new RuntimeException("Excel 生成エラー", e);
+        }
+    }
+    private CellStyle createHeaderStyle(Workbook workbook) {
+        CellStyle style = workbook.createCellStyle();
+        style.setFillForegroundColor(IndexedColors.GREY_25_PERCENT.getIndex());
+        style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
+        style.setBorderBottom(BorderStyle.THIN);
+        style.setBorderTop(BorderStyle.THIN);
+        style.setBorderLeft(BorderStyle.THIN);
+        style.setBorderRight(BorderStyle.THIN);
+        style.setAlignment(HorizontalAlignment.CENTER);
+        return style;
+    }
+    private CellStyle createAmountStyle(Workbook workbook) {
+        CellStyle style = workbook.createCellStyle();
+        DataFormat format = workbook.createDataFormat();
+        style.setDataFormat(format.getFormat("#,##0"));
+        style.setAlignment(HorizontalAlignment.RIGHT);
+        return style;
+    }
+}
+```
+</details>
+---
+## 第26章：ページネーションの実装
+### 26.1 ページネーションの設計
+一覧画面でデータ量が多い場合、すべてのデータを一度に表示するとパフォーマンスが低下します。ページネーションを実装して、データを分割して表示します。
+| 要素 | 説明 |
+|------|------|
+| **PageResult<T>** | ページネーション結果を表す汎用クラス |
+| **LIMIT/OFFSET** | SQL でのページ分割 |
+| **表示件数** | ユーザーが選択可能（10/25/50/100件） |
+| **ページナビゲーション** | 最初/前/ページ番号/次/最後 |
+---
+### 26.2 PageResult クラス
+<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 page;
+    private final int size;
+    private final long totalElements;
+    private final int totalPages;
+    public PageResult(List<T> content, int page, int size, long totalElements) {
+        this.content = content;
+        this.page = page;
+        this.size = size;
+        this.totalElements = totalElements;
+        this.totalPages = size > 0 ? (int) Math.ceil((double) totalElements / size) : 0;
+    }
+    public List<T> getContent() {
+        return content;
+    }
+    public int getPage() {
+        return page;
+    }
+    public int getSize() {
+        return size;
+    }
+    public long getTotalElements() {
+        return totalElements;
+    }
+    public int getTotalPages() {
+        return totalPages;
+    }
+    public boolean isFirst() {
+        return page == 0;
+    }
+    public boolean isLast() {
+        return page >= totalPages - 1;
+    }
+    public boolean hasPrevious() {
+        return page > 0;
+    }
+    public boolean hasNext() {
+        return page < totalPages - 1;
+    }
+}
+```
+</details>
+---
+### 26.3 Mapper 層の実装
+ページネーション用のクエリと件数取得クエリを追加します。
+<details>
+<summary>PartnerMapper.java（抜粋）</summary>
+```java
+/**
+ * ページネーション付きで取引先を検索.
+ */
+List<Partner> findWithPagination(
+    @Param("offset") int offset,
+    @Param("limit") int limit,
+    @Param("type") String type,
+    @Param("keyword") String keyword);
+/**
+ * 検索条件に一致する取引先の件数を取得.
+ */
+long count(@Param("type") String type, @Param("keyword") String keyword);
+```
+</details>
+<details>
+<summary>PartnerMapper.xml（抜粋）</summary>
+```xml
+<select id="findWithPagination" resultMap="PartnerResultMap">
+    SELECT * FROM "取引先マスタ"
+    <where>
+        <if test="type == 'customer'">
+            "顧客区分" = TRUE
+        </if>
+        <if test="type == 'supplier'">
+            "仕入先区分" = TRUE
+        </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="type == 'customer'">
+            "顧客区分" = TRUE
+        </if>
+        <if test="type == 'supplier'">
+            "仕入先区分" = TRUE
+        </if>
+        <if test="keyword != null and keyword != ''">
+            AND (LOWER("取引先コード") LIKE LOWER('%' || #{keyword} || '%')
+                 OR LOWER("取引先名") LIKE LOWER('%' || #{keyword} || '%'))
+        </if>
+    </where>
+</select>
+```
+</details>
+---
+### 26.4 Repository 層の実装
+<details>
+<summary>PartnerRepository.java（抜粋）</summary>
+```java
+/**
+ * ページネーション付きで取引先を検索.
+ */
+PageResult<Partner> findWithPagination(int page, int size, String type, String keyword);
+```
+</details>
+<details>
+<summary>PartnerRepositoryImpl.java（抜粋）</summary>
+```java
+@Override
+public PageResult<Partner> findWithPagination(int page, int size, String type, String keyword) {
+    int offset = page * size;
+    List<Partner> partners = partnerMapper.findWithPagination(offset, size, type, keyword);
+    long totalElements = partnerMapper.count(type, keyword);
+    return new PageResult<>(partners, page, size, totalElements);
+}
+```
+</details>
+---
+### 26.5 UseCase / Service 層の実装
+<details>
+<summary>PartnerUseCase.java（抜粋）</summary>
+```java
+/**
+ * ページネーション付きで取引先を取得.
+ */
+PageResult<Partner> getPartners(int page, int size, String type, String keyword);
+```
+</details>
+<details>
+<summary>PartnerService.java（抜粋）</summary>
+```java
+@Override
+@Transactional(readOnly = true)
+public PageResult<Partner> getPartners(int page, int size, String type, String keyword) {
+    return partnerRepository.findWithPagination(page, size, type, keyword);
+}
+```
+</details>
+---
+### 26.6 Controller の実装
+<details>
+<summary>PartnerWebController.java（抜粋）</summary>
+```java
+@GetMapping
+public String list(
+        @RequestParam(defaultValue = "0") int page,
+        @RequestParam(defaultValue = "10") int size,
+        @RequestParam(required = false) String type,
+        @RequestParam(required = false) String keyword,
+        Model model) {
+    PageResult<Partner> partnerPage = partnerUseCase.getPartners(page, size, type, keyword);
+    model.addAttribute("partners", partnerPage.getContent());
+    model.addAttribute("page", partnerPage);
+    model.addAttribute("selectedType", type);
+    model.addAttribute("keyword", keyword);
+    model.addAttribute("currentSize", size);
+    return "partners/list";
+}
+```
+</details>
+---
+### 26.7 テンプレートの実装
+<details>
+<summary>list.html ページネーション部分</summary>
+```html
+<!-- 検索フォーム -->
+<div class="search-form">
+    <form th:action="@{/partners}" method="get" class="row g-3">
+        <!-- 表示件数 -->
+        <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="col-md-2 d-flex align-items-end">
+            <button type="submit" class="btn btn-secondary">検索</button>
+        </div>
+    </form>
+</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(partners)}">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="@{/partners(page=0, size=${currentSize})}">&laquo;</a>
+            </li>
+            <!-- 前のページへ -->
+            <li class="page-item" th:classappend="${!page.hasPrevious()} ? 'disabled'">
+                <a class="page-link" th:href="@{/partners(page=${page.page - 1}, size=${currentSize})}">&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="@{/partners(page=${i}, size=${currentSize})}"
+                       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="@{/partners(page=${page.page + 1}, size=${currentSize})}">&rsaquo;</a>
+            </li>
+            <!-- 最後のページへ -->
+            <li class="page-item" th:classappend="${page.last} ? 'disabled'">
+                <a class="page-link" th:href="@{/partners(page=${page.totalPages - 1}, size=${currentSize})}">&raquo;</a>
+            </li>
+        </ul>
+    </nav>
+</div>
+```
+</details>
+---
+### 26.8 ページネーションの動作
+```
+                    ページネーション処理フロー
+┌─────────────────────────────────────────────────────────────┐
+│  ブラウザ                                                    │
+│  /partners?page=2&size=10&keyword=xxx                       │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  Controller                                                  │
+│  - page, size, keyword パラメータを受け取る                   │
+│  - UseCase.getPartners(page, size, keyword) を呼び出す       │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  Service / Repository                                        │
+│  - offset = page * size を計算                               │
+│  - findWithPagination(offset, size, keyword) を実行          │
+│  - count(keyword) で総件数を取得                             │
+│  - PageResult<T> を生成して返却                              │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  SQL (MyBatis)                                               │
+│  SELECT * FROM "テーブル"                                    │
+│  WHERE ... LIMIT 10 OFFSET 20                               │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  PageResult<T>                                               │
+│  - content: データリスト (10件)                               │
+│  - page: 2                                                   │
+│  - size: 10                                                  │
+│  - totalElements: 57                                         │
+│  - totalPages: 6                                             │
+│  - isFirst/isLast/hasPrevious/hasNext メソッド               │
+└─────────────────────────────────────────────────────────────┘
+```
+---
+### 26.9 検索条件の保持
+ページ遷移時に検索条件を保持するため、すべてのリンクに検索パラメータを含めます。
+```html
+<!-- 検索条件付きページネーションリンク -->
+<a th:href="@{/partners(
+    page=${i},
+    size=${currentSize},
+    type=${selectedType},
+    keyword=${keyword}
+)}">
+```
+---
+## まとめ
+### 学んだこと
+1. **帳票の種類**: 日計表、試算表、元帳、財務諸表
+2. **HTML 表示**: Thymeleaf による帳票画面の実装
+3. **Excel 出力**: Apache POI による Excel ファイル生成
+4. **PDF 出力**: iText による PDF ファイル生成
+5. **ダウンロード**: ResponseEntity による添付ファイル返却
+6. **ページネーション**: PageResult<T> による一覧画面のページ分割
+---
+### 実装した機能
+| 機能 | 説明 |
+|------|------|
+| **ホーム画面** | ダッシュボード、クイックアクセス |
+| **勘定科目マスタ** | 一覧・登録・編集・削除・検索 |
+| **仕訳入力** | 複合仕訳対応、貸借チェック |
+| **帳票出力** | 日計表、試算表、財務諸表 |
+### モノリス vs API サーバー
+| 観点 | モノリス | API サーバー |
+|------|---------|-------------|
+| **適用場面** | 社内システム、小〜中規模 | 大規模、SPA 連携 |
+| **開発速度** | 高速 | 環境構築に時間 |
+| **保守性** | 適切な設計で高い | 高い |
+| **チーム構成** | フルスタック | フロント/バック分離 |
+### 技術的なポイント
+1. **ヘキサゴナルアーキテクチャ**: モノリスでも適用可能
+2. **Thymeleaf**: サーバーサイドレンダリング
+3. **htmx**: JavaScript 不要の部分更新
+4. **PRG パターン**: フォーム二重送信防止
+5. **帳票生成**: POI（Excel）、iText（PDF）