@k2works/claude-code-booster 3.2.1 → 3.3.1

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

@@ -0,0 +1,2418 @@
+# 実践データベース設計：販売管理システム 研究 5 - Axon CQRS/ES の実装
+
+## はじめに
+
+本研究では、REST API（第10部-A）、gRPC（研究 3）、GraphQL（研究 4）とは異なるアプローチとして、**CQRS（Command Query Responsibility Segregation）** と **Event Sourcing** による販売管理システムを実装します。Axon Framework を使用し、コマンド（書き込み）とクエリ（読み取り）を分離し、すべての状態変更をイベントとして記録するアーキテクチャを構築します。
+
+研究 1 で構築したヘキサゴナルアーキテクチャの考え方を踏襲しつつ、**ドメインモデルをフレームワークから分離**し、Axon Aggregate Adapter を介して連携させます。Read Model の永続化には **MyBatis** を使用します。
+
+---
+
+## 第18章：Axon CQRS/ES アーキテクチャの基礎
+
+### 18.1 CQRS とは
+
+CQRS（Command Query Responsibility Segregation）は、コマンド（書き込み）とクエリ（読み取り）の責務を分離するアーキテクチャパターンです。従来の CRUD 操作を単一のモデルで処理するのではなく、書き込み用のモデルと読み取り用のモデルを分けることで、それぞれに最適化された設計が可能になります。
+
+```plantuml
+@startuml cqrs_architecture
+skinparam componentStyle rectangle
+skinparam backgroundColor #FEFEFE
+
+package "Command Side (Write)" {
+  [REST Controller] --> [CommandGateway]
+  [CommandGateway] --> [Aggregate]
+  [Aggregate] --> [Event Store]
+}
+
+package "Query Side (Read)" {
+  [Event Store] --> [Projection]
+  [Projection] --> [Read Model DB]
+  [REST Controller] --> [MyBatis Mapper]
+  [MyBatis Mapper] --> [Read Model DB]
+}
+
+@enduml
+```
+
+**CQRS の利点：**
+
+| 観点 | 説明 |
+|------|------|
+| **スケーラビリティ** | 読み取りと書き込みを独立してスケール可能 |
+| **パフォーマンス** | 読み取りに最適化されたモデルで高速クエリ |
+| **複雑性の分離** | 書き込みロジックと読み取りロジックを独立して開発 |
+| **監査対応** | Event Sourcing と組み合わせて完全な履歴を保持 |
+
+---
+
+### 18.2 Event Sourcing とは
+
+Event Sourcing は、アプリケーションの状態をイベントの連続として保存するパターンです。現在の状態を直接保存するのではなく、状態変更を表すイベントを記録し、必要に応じてイベントを再生して現在の状態を再構築します。
+
+```plantuml
+@startuml event_sourcing
+skinparam componentStyle rectangle
+skinparam backgroundColor #FEFEFE
+
+[Command] --> [Aggregate] : 1. コマンド受信
+[Aggregate] --> [Domain Model] : 2. ビジネスロジック実行
+[Domain Model] --> [Event] : 3. イベント生成
+[Event] --> [Event Store] : 4. イベント永続化
+[Event Store] --> [Aggregate] : 5. イベント再生（状態復元）
+
+@enduml
+```
+
+**Event Sourcing の利点：**
+
+| 観点 | 説明 |
+|------|------|
+| **完全な履歴** | すべての状態変更が記録される |
+| **監査証跡** | いつ、誰が、何を変更したかが明確 |
+| **時間旅行** | 過去の任意の時点の状態を再構築可能 |
+| **イベント駆動** | 他システムとの連携が容易 |
+| **デバッグ** | 問題発生時にイベントを追跡可能 |
+
+---
+
+### 18.3 ヘキサゴナルアーキテクチャとの統合
+
+本実装では、ヘキサゴナルアーキテクチャ（Ports & Adapters）を採用し、ビジネスロジックを外部依存から分離します。
+
+```plantuml
+@startuml hexagonal_cqrs
+!define RECTANGLE class
+skinparam backgroundColor #FEFEFE
+
+package "Hexagonal Architecture (CQRS/ES 版)" {
+
+  package "Inbound Adapters" {
+    [REST Controller]
+  }
+
+  package "Application Core" {
+    package "Application Layer" {
+      [Aggregate Adapter]
+      [Projection]
+      [Policy Handler]
+    }
+
+    package "Domain Layer" {
+      [Domain Model]
+      [Commands]
+      [Value Objects]
+    }
+
+    package "API Layer" {
+      [Events]
+    }
+  }
+
+  package "Outbound Adapters" {
+    [MyBatis Mapper]
+    [Event Store]
+  }
+}
+
+[REST Controller] --> [Aggregate Adapter]
+[Aggregate Adapter] --> [Domain Model]
+[Projection] --> [MyBatis Mapper]
+
+note top of [Domain Model]
+  純粋なドメインモデル
+  Axon Framework に依存しない
+  ビジネスロジックのみ
+end note
+
+note left of [Aggregate Adapter]
+  Axon 用アダプター
+  @Aggregate, @CommandHandler
+  フレームワーク依存を吸収
+end note
+
+@enduml
+```
+
+**設計原則：**
+
+1. **ドメインモデルの純粋性**: ドメインモデルは Axon に依存しない純粋な Java コード
+2. **Aggregate Adapter**: Axon Framework 用のアダプターを Application Layer に配置
+3. **イベントは公開 API**: イベントは他の Context から参照される公開 API として定義
+
+---
+
+### 18.4 技術スタック
+
+| カテゴリ | 技術 | バージョン |
+|---------|------|-----------|
+| 言語 | Java | 21 |
+| フレームワーク | Spring Boot | 3.4.1 |
+| CQRS/ES | Axon Framework | 4.10.3 |
+| ORM | MyBatis | 3.0.4 |
+| API ドキュメント | SpringDoc OpenAPI | 2.7.0 |
+| データベース | H2 (開発) / PostgreSQL (本番) | - |
+
+#### build.gradle.kts
+
+<details>
+<summary>コード例: build.gradle.kts</summary>
+
+```kotlin
+dependencies {
+    // Spring Boot
+    implementation("org.springframework.boot:spring-boot-starter-web")
+    implementation("org.springframework.boot:spring-boot-starter-validation")
+
+    // Axon Framework
+    implementation("org.axonframework:axon-spring-boot-starter:4.10.3") {
+        exclude(group = "org.axonframework", module = "axon-server-connector")
+    }
+
+    // MyBatis
+    implementation("org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.4")
+
+    // OpenAPI
+    implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.7.0")
+
+    // Database
+    runtimeOnly("com.h2database:h2")
+    runtimeOnly("org.postgresql:postgresql")
+
+    // Test
+    testImplementation("org.springframework.boot:spring-boot-starter-test")
+    testImplementation("org.axonframework:axon-test:4.10.3")
+    testImplementation("org.mybatis.spring.boot:mybatis-spring-boot-starter-test:3.0.4")
+}
+```
+
+</details>
+
+---
+
+### 18.5 ディレクトリ構造
+
+<details>
+<summary>コード例: ディレクトリ構成</summary>
+
+```
+src/main/java/com/example/sales/
+├── app/                              # アプリケーション共通
+│   └── RootController.java
+├── config/                           # 設定クラス
+│   ├── AxonConfig.java
+│   ├── MyBatisConfig.java
+│   └── OpenApiConfig.java
+├── order/                            # Order Bounded Context
+│   ├── api/
+│   │   └── events/                   # 公開イベント API
+│   │       ├── OrderEvent.java       # sealed interface
+│   │       ├── OrderCreatedEvent.java
+│   │       ├── OrderConfirmedEvent.java
+│   │       └── OrderCancelledEvent.java
+│   ├── adapter/
+│   │   ├── inbound/rest/orders/      # Inbound Adapter (REST)
+│   │   │   ├── OrdersController.java
+│   │   │   └── protocol/             # Request/Response DTO
+│   │   └── outbound/persistence/     # Outbound Adapter (MyBatis)
+│   │       ├── entity/
+│   │       │   └── OrderEntity.java
+│   │       └── mapper/
+│   │           └── OrderMapper.java
+│   ├── application/
+│   │   ├── aggregate/                # Axon Aggregate Adapter
+│   │   │   └── OrderAggregateAdapter.java
+│   │   ├── policy/                   # イベントハンドラー（Choreography）
+│   │   │   └── StockEventHandler.java
+│   │   └── query/                    # Projection
+│   │       └── OrderProjection.java
+│   └── domain/
+│       └── model/aggregate/order/    # 純粋なドメインモデル
+│           ├── Order.java
+│           ├── OrderCommands.java
+│           └── OrderStatus.java
+└── inventory/                        # Inventory Bounded Context
+    ├── api/events/
+    │   ├── StockEvent.java
+    │   ├── StockReservedEvent.java
+    │   └── StockReservationFailedEvent.java
+    ├── application/
+    │   ├── aggregate/
+    │   │   └── StockAggregateAdapter.java
+    │   └── policy/
+    │       └── OrderEventHandler.java
+    └── domain/model/aggregate/stock/
+        ├── Stock.java
+        └── StockCommands.java
+
+src/main/resources/
+├── application.yml
+├── schema.sql                        # Read Model スキーマ
+└── mapper/
+    └── OrderMapper.xml               # MyBatis マッパー XML
+```
+
+</details>
+
+---
+
+### 18.6 Axon 設定クラス
+
+<details>
+<summary>コード例: AxonConfig.java</summary>
+
+```java
+package com.example.sales.config;
+
+import org.axonframework.eventsourcing.eventstore.EmbeddedEventStore;
+import org.axonframework.eventsourcing.eventstore.EventStorageEngine;
+import org.axonframework.eventsourcing.eventstore.EventStore;
+import org.axonframework.eventsourcing.eventstore.jdbc.JdbcEventStorageEngine;
+import org.axonframework.serialization.Serializer;
+import org.axonframework.serialization.json.JacksonSerializer;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import javax.sql.DataSource;
+
+/**
+ * Axon Framework 設定
+ */
+@Configuration
+public class AxonConfig {
+
+    /**
+     * JDBC ベースの Event Storage Engine
+     */
+    @Bean
+    public EventStorageEngine eventStorageEngine(
+            DataSource dataSource,
+            Serializer serializer) {
+        return JdbcEventStorageEngine.builder()
+                .snapshotSerializer(serializer)
+                .eventSerializer(serializer)
+                .dataSource(dataSource)
+                .build();
+    }
+
+    /**
+     * Event Store
+     */
+    @Bean
+    public EventStore eventStore(EventStorageEngine eventStorageEngine) {
+        return EmbeddedEventStore.builder()
+                .storageEngine(eventStorageEngine)
+                .build();
+    }
+
+    /**
+     * JSON シリアライザー
+     */
+    @Bean
+    public Serializer eventSerializer() {
+        return JacksonSerializer.defaultSerializer();
+    }
+}
+```
+
+</details>
+
+### 18.7 MyBatis 設定クラス
+
+<details>
+<summary>コード例: MyBatisConfig.java</summary>
+
+```java
+package com.example.sales.config;
+
+import org.apache.ibatis.session.SqlSessionFactory;
+import org.mybatis.spring.SqlSessionFactoryBean;
+import org.mybatis.spring.annotation.MapperScan;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
+
+import javax.sql.DataSource;
+
+/**
+ * MyBatis 設定
+ */
+@Configuration
+@MapperScan(basePackages = {
+    "com.example.sales.order.adapter.outbound.persistence.mapper",
+    "com.example.sales.inventory.adapter.outbound.persistence.mapper"
+})
+public class MyBatisConfig {
+
+    @Bean
+    public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
+        SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
+        factoryBean.setDataSource(dataSource);
+        factoryBean.setMapperLocations(
+            new PathMatchingResourcePatternResolver()
+                .getResources("classpath:mapper/**/*.xml")
+        );
+        factoryBean.setTypeAliasesPackage(
+            "com.example.sales.order.adapter.outbound.persistence.entity," +
+            "com.example.sales.inventory.adapter.outbound.persistence.entity"
+        );
+
+        org.apache.ibatis.session.Configuration configuration =
+            new org.apache.ibatis.session.Configuration();
+        configuration.setMapUnderscoreToCamelCase(true);
+        factoryBean.setConfiguration(configuration);
+
+        return factoryBean.getObject();
+    }
+}
+```
+
+</details>
+
+---
+
+## 第19章：ドメインモデルとイベント設計
+
+### 19.1 Order Bounded Context
+
+注文の作成から配送完了までのライフサイクルを管理します。
+
+#### 状態遷移図
+
+```plantuml
+@startuml order_state
+skinparam backgroundColor #FEFEFE
+
+[*] --> PENDING : OrderCreated
+PENDING --> CONFIRMED : OrderConfirmed
+PENDING --> REJECTED : OrderRejected
+PENDING --> CANCELLED : OrderCancelled
+CONFIRMED --> AWAITING_SHIPMENT : ShipmentRequested
+CONFIRMED --> CANCELLED : OrderCancelled
+AWAITING_SHIPMENT --> SHIPPED : OrderShipped
+AWAITING_SHIPMENT --> CANCELLED : OrderCancelled
+SHIPPED --> DELIVERED : OrderDelivered
+
+@enduml
+```
+
+#### イベント一覧
+
+| イベント | 説明 |
+|---------|------|
+| `OrderCreatedEvent` | 注文が作成された |
+| `OrderConfirmedEvent` | 注文が確定された（在庫確保成功） |
+| `OrderRejectedEvent` | 注文が拒否された（在庫確保失敗） |
+| `ShipmentRequestedEvent` | 出荷が依頼された |
+| `OrderShippedEvent` | 注文が出荷された |
+| `OrderDeliveredEvent` | 注文が配達された |
+| `OrderCancelledEvent` | 注文がキャンセルされた |
+
+---
+
+### 19.2 イベント定義（API Layer）
+
+#### sealed interface によるイベントの型安全性
+
+<details>
+<summary>コード例: OrderEvent.java</summary>
+
+```java
+package com.example.sales.order.api.events;
+
+/**
+ * Order イベントの sealed interface
+ * すべての Order イベントの親インターフェース
+ */
+public sealed interface OrderEvent permits
+        OrderCreatedEvent,
+        OrderConfirmedEvent,
+        OrderRejectedEvent,
+        ShipmentRequestedEvent,
+        OrderShippedEvent,
+        OrderDeliveredEvent,
+        OrderCancelledEvent {
+
+    String orderId();
+}
+```
+
+</details>
+
+**sealed interface の利点：**
+
+- **網羅性チェック**: switch 式でコンパイル時に全ケースをチェック
+- **型安全性**: 許可されたクラスのみが実装可能
+- **ドキュメント**: 存在するイベントが一目でわかる
+
+#### イベント record の実装
+
+<details>
+<summary>コード例: OrderCreatedEvent.java</summary>
+
+```java
+package com.example.sales.order.api.events;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 注文作成イベント
+ */
+public record OrderCreatedEvent(
+        String orderId,
+        String customerId,
+        String productId,
+        int quantity,
+        BigDecimal totalAmount,
+        LocalDateTime createdAt
+) implements OrderEvent {
+}
+```
+
+</details>
+
+<details>
+<summary>コード例: OrderConfirmedEvent.java</summary>
+
+```java
+package com.example.sales.order.api.events;
+
+import java.time.LocalDateTime;
+
+/**
+ * 注文確定イベント
+ */
+public record OrderConfirmedEvent(
+        String orderId,
+        LocalDateTime confirmedAt
+) implements OrderEvent {
+}
+```
+
+</details>
+
+<details>
+<summary>コード例: OrderCancelledEvent.java</summary>
+
+```java
+package com.example.sales.order.api.events;
+
+import java.time.LocalDateTime;
+
+/**
+ * 注文キャンセルイベント
+ */
+public record OrderCancelledEvent(
+        String orderId,
+        String productId,
+        int quantity,
+        String cancelledBy,
+        String reason,
+        LocalDateTime cancelledAt
+) implements OrderEvent {
+}
+```
+
+</details>
+
+---
+
+### 19.3 コマンド定義（Domain Layer）
+
+<details>
+<summary>コード例: OrderCommands.java</summary>
+
+```java
+package com.example.sales.order.domain.model.aggregate.order;
+
+import org.axonframework.modelling.command.TargetAggregateIdentifier;
+import java.math.BigDecimal;
+
+/**
+ * Order 集約へのコマンド定義
+ */
+public final class OrderCommands {
+
+    private OrderCommands() {
+    }
+
+    /**
+     * 注文作成コマンド
+     */
+    public record CreateOrderCommand(
+            @TargetAggregateIdentifier
+            String orderId,
+            String customerId,
+            String productId,
+            int quantity,
+            BigDecimal totalAmount
+    ) {
+    }
+
+    /**
+     * 注文確定コマンド
+     */
+    public record ConfirmOrderCommand(
+            @TargetAggregateIdentifier
+            String orderId
+    ) {
+    }
+
+    /**
+     * 注文拒否コマンド
+     */
+    public record RejectOrderCommand(
+            @TargetAggregateIdentifier
+            String orderId,
+            String reason
+    ) {
+    }
+
+    /**
+     * 出荷依頼コマンド
+     */
+    public record RequestShipmentCommand(
+            @TargetAggregateIdentifier
+            String orderId
+    ) {
+    }
+
+    /**
+     * 出荷コマンド
+     */
+    public record ShipOrderCommand(
+            @TargetAggregateIdentifier
+            String orderId,
+            String trackingNumber
+    ) {
+    }
+
+    /**
+     * 配達完了コマンド
+     */
+    public record DeliverOrderCommand(
+            @TargetAggregateIdentifier
+            String orderId
+    ) {
+    }
+
+    /**
+     * キャンセルコマンド
+     */
+    public record CancelOrderCommand(
+            @TargetAggregateIdentifier
+            String orderId,
+            String cancelledBy,
+            String reason
+    ) {
+    }
+}
+```
+
+</details>
+
+**@TargetAggregateIdentifier の役割：**
+
+- Axon がコマンドをどの集約インスタンスにルーティングするかを決定
+- 集約の一意識別子となるフィールドに付与
+
+---
+
+### 19.4 ドメインモデル（純粋な Java）
+
+<details>
+<summary>コード例: Order.java</summary>
+
+```java
+package com.example.sales.order.domain.model.aggregate.order;
+
+import com.example.sales.order.api.events.*;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * Order ドメインモデル（Axon 非依存）
+ * 純粋なビジネスロジックのみを含む
+ */
+public record Order(
+        String orderId,
+        String customerId,
+        String productId,
+        int quantity,
+        BigDecimal totalAmount,
+        OrderStatus status
+) {
+
+    // ======== ファクトリメソッド ========
+
+    /**
+     * 注文作成
+     */
+    public static OrderCreatedEvent create(
+            String orderId,
+            String customerId,
+            String productId,
+            int quantity,
+            BigDecimal totalAmount
+    ) {
+        // バリデーション
+        if (quantity <= 0) {
+            throw new IllegalArgumentException("Quantity must be positive");
+        }
+        if (totalAmount.compareTo(BigDecimal.ZERO) <= 0) {
+            throw new IllegalArgumentException("Total amount must be positive");
+        }
+
+        return new OrderCreatedEvent(
+                orderId,
+                customerId,
+                productId,
+                quantity,
+                totalAmount,
+                LocalDateTime.now()
+        );
+    }
+
+    /**
+     * イベントからの再構築
+     */
+    public static Order from(OrderCreatedEvent event) {
+        return new Order(
+                event.orderId(),
+                event.customerId(),
+                event.productId(),
+                event.quantity(),
+                event.totalAmount(),
+                OrderStatus.PENDING
+        );
+    }
+
+    // ======== 状態遷移メソッド ========
+
+    /**
+     * 注文確定
+     */
+    public OrderConfirmedEvent confirm() {
+        if (status != OrderStatus.PENDING) {
+            throw new IllegalStateException("Only pending orders can be confirmed");
+        }
+        return new OrderConfirmedEvent(orderId, LocalDateTime.now());
+    }
+
+    /**
+     * 注文拒否
+     */
+    public OrderRejectedEvent reject(String reason) {
+        if (status != OrderStatus.PENDING) {
+            throw new IllegalStateException("Only pending orders can be rejected");
+        }
+        return new OrderRejectedEvent(orderId, reason, LocalDateTime.now());
+    }
+
+    /**
+     * 出荷依頼
+     */
+    public ShipmentRequestedEvent requestShipment() {
+        if (status != OrderStatus.CONFIRMED) {
+            throw new IllegalStateException("Only confirmed orders can request shipment");
+        }
+        return new ShipmentRequestedEvent(orderId, LocalDateTime.now());
+    }
+
+    /**
+     * 出荷
+     */
+    public OrderShippedEvent ship(String trackingNumber) {
+        if (status != OrderStatus.AWAITING_SHIPMENT) {
+            throw new IllegalStateException("Only orders awaiting shipment can be shipped");
+        }
+        return new OrderShippedEvent(orderId, productId, quantity, trackingNumber, LocalDateTime.now());
+    }
+
+    /**
+     * 配達完了
+     */
+    public OrderDeliveredEvent deliver() {
+        if (status != OrderStatus.SHIPPED) {
+            throw new IllegalStateException("Only shipped orders can be delivered");
+        }
+        return new OrderDeliveredEvent(orderId, LocalDateTime.now());
+    }
+
+    /**
+     * キャンセル
+     */
+    public OrderCancelledEvent cancel(String cancelledBy, String reason) {
+        if (status == OrderStatus.SHIPPED || status == OrderStatus.DELIVERED) {
+            throw new IllegalStateException("Shipped or delivered orders cannot be cancelled");
+        }
+        if (status == OrderStatus.CANCELLED) {
+            throw new IllegalStateException("Order is already cancelled");
+        }
+        if (status == OrderStatus.REJECTED) {
+            throw new IllegalStateException("Rejected orders cannot be cancelled");
+        }
+        return new OrderCancelledEvent(orderId, productId, quantity, cancelledBy, reason, LocalDateTime.now());
+    }
+
+    // ======== イベント適用メソッド ========
+
+    /**
+     * イベントを適用して新しい状態を生成
+     */
+    public Order apply(OrderEvent event) {
+        return switch (event) {
+            case OrderCreatedEvent e -> from(e);
+            case OrderConfirmedEvent e -> withStatus(OrderStatus.CONFIRMED);
+            case OrderRejectedEvent e -> withStatus(OrderStatus.REJECTED);
+            case ShipmentRequestedEvent e -> withStatus(OrderStatus.AWAITING_SHIPMENT);
+            case OrderShippedEvent e -> withStatus(OrderStatus.SHIPPED);
+            case OrderDeliveredEvent e -> withStatus(OrderStatus.DELIVERED);
+            case OrderCancelledEvent e -> withStatus(OrderStatus.CANCELLED);
+        };
+    }
+
+    /**
+     * 状態更新ヘルパー
+     */
+    private Order withStatus(OrderStatus newStatus) {
+        return new Order(orderId, customerId, productId, quantity, totalAmount, newStatus);
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>コード例: OrderStatus.java</summary>
+
+```java
+package com.example.sales.order.domain.model.aggregate.order;
+
+/**
+ * 注文ステータス
+ */
+public enum OrderStatus {
+    PENDING,           // 保留中
+    CONFIRMED,         // 確定
+    REJECTED,          // 拒否
+    AWAITING_SHIPMENT, // 出荷待ち
+    SHIPPED,           // 出荷済み
+    DELIVERED,         // 配達済み
+    CANCELLED          // キャンセル
+}
+```
+
+</details>
+
+**ドメインモデル設計原則：**
+
+| 原則 | 説明 |
+|------|------|
+| **Axon 非依存** | ドメインモデルにフレームワーク依存を持たせない |
+| **イミュータブル** | record でイミュータブルに設計 |
+| **イベントを返す** | 状態遷移メソッドはイベントを返す |
+| **最小限のフィールド** | 状態遷移の判定に必要な最小限のみ保持 |
+
+---
+
+### 19.5 Inventory Bounded Context
+
+商品在庫の予約・確定・解放を管理します。
+
+#### イベント定義
+
+<details>
+<summary>コード例: StockEvent.java</summary>
+
+```java
+package com.example.sales.inventory.api.events;
+
+/**
+ * Stock イベントの sealed interface
+ */
+public sealed interface StockEvent permits
+        StockInitializedEvent,
+        StockReservedEvent,
+        StockReservationFailedEvent,
+        StockDeductedEvent,
+        StockReleasedEvent {
+
+    String productId();
+}
+```
+
+</details>
+
+<details>
+<summary>コード例: StockReservedEvent.java</summary>
+
+```java
+package com.example.sales.inventory.api.events;
+
+import java.time.LocalDateTime;
+
+/**
+ * 在庫予約成功イベント
+ */
+public record StockReservedEvent(
+        String productId,
+        String orderId,
+        int quantity,
+        LocalDateTime reservedAt
+) implements StockEvent {
+}
+```
+
+</details>
+
+<details>
+<summary>コード例: StockReservationFailedEvent.java</summary>
+
+```java
+package com.example.sales.inventory.api.events;
+
+import java.time.LocalDateTime;
+
+/**
+ * 在庫予約失敗イベント
+ */
+public record StockReservationFailedEvent(
+        String productId,
+        String orderId,
+        int requestedQuantity,
+        int availableQuantity,
+        String reason,
+        LocalDateTime failedAt
+) implements StockEvent {
+}
+```
+
+</details>
+
+#### ドメインモデル
+
+<details>
+<summary>コード例: Stock.java</summary>
+
+```java
+package com.example.sales.inventory.domain.model.aggregate.stock;
+
+import com.example.sales.inventory.api.events.*;
+import java.time.LocalDateTime;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Stock ドメインモデル（在庫管理）
+ */
+public record Stock(
+        String productId,
+        int totalQuantity,
+        int availableQuantity,
+        Map<String, Integer> reservations  // orderId -> quantity
+) {
+
+    public Stock {
+        reservations = reservations != null ? new HashMap<>(reservations) : new HashMap<>();
+    }
+
+    /**
+     * 初期化ファクトリ
+     */
+    public static Stock initial(String productId, int initialQuantity) {
+        return new Stock(productId, initialQuantity, initialQuantity, new HashMap<>());
+    }
+
+    /**
+     * 在庫予約（成功または失敗イベントを返す）
+     */
+    public StockEvent reserve(String orderId, int quantity) {
+        if (reservations.containsKey(orderId)) {
+            return new StockReservationFailedEvent(
+                    productId, orderId, quantity, availableQuantity,
+                    "Order already has a reservation",
+                    LocalDateTime.now()
+            );
+        }
+
+        if (availableQuantity < quantity) {
+            return new StockReservationFailedEvent(
+                    productId, orderId, quantity, availableQuantity,
+                    "Insufficient stock",
+                    LocalDateTime.now()
+            );
+        }
+
+        return new StockReservedEvent(productId, orderId, quantity, LocalDateTime.now());
+    }
+
+    /**
+     * 在庫確定（出荷時）
+     */
+    public StockDeductedEvent deduct(String orderId, int quantity) {
+        if (!reservations.containsKey(orderId)) {
+            throw new IllegalStateException("No reservation found for order: " + orderId);
+        }
+        return new StockDeductedEvent(productId, orderId, quantity, LocalDateTime.now());
+    }
+
+    /**
+     * 在庫解放（キャンセル時）
+     */
+    public StockReleasedEvent release(String orderId, int quantity) {
+        if (!reservations.containsKey(orderId)) {
+            throw new IllegalStateException("No reservation found for order: " + orderId);
+        }
+        return new StockReleasedEvent(productId, orderId, quantity, LocalDateTime.now());
+    }
+
+    /**
+     * イベント適用
+     */
+    public Stock apply(StockEvent event) {
+        return switch (event) {
+            case StockInitializedEvent e -> initial(e.productId(), e.initialQuantity());
+            case StockReservedEvent e -> {
+                var newReservations = new HashMap<>(reservations);
+                newReservations.put(e.orderId(), e.quantity());
+                yield new Stock(
+                        productId,
+                        totalQuantity,
+                        availableQuantity - e.quantity(),
+                        newReservations
+                );
+            }
+            case StockReservationFailedEvent e -> this;  // 状態変更なし
+            case StockDeductedEvent e -> {
+                var newReservations = new HashMap<>(reservations);
+                newReservations.remove(e.orderId());
+                yield new Stock(
+                        productId,
+                        totalQuantity - e.quantity(),
+                        availableQuantity,
+                        newReservations
+                );
+            }
+            case StockReleasedEvent e -> {
+                var newReservations = new HashMap<>(reservations);
+                newReservations.remove(e.orderId());
+                yield new Stock(
+                        productId,
+                        totalQuantity,
+                        availableQuantity + e.quantity(),
+                        newReservations
+                );
+            }
+        };
+    }
+}
+```
+
+</details>
+
+---
+
+## 第20章：Aggregate Adapter と Policy Handler
+
+### 20.1 Aggregate Adapter パターン
+
+Aggregate Adapter は、純粋なドメインモデルと Axon Framework を繋ぐアダプター層です。フレームワーク固有のアノテーションやライフサイクル処理をドメインモデルから分離します。
+
+```plantuml
+@startuml aggregate_adapter
+skinparam backgroundColor #FEFEFE
+
+package "Application Layer" {
+    class OrderAggregateAdapter << @Aggregate >> {
+        - orderId: String
+        - order: Order
+        + @CommandHandler: handle(CreateOrderCommand)
+        + @CommandHandler: handle(ConfirmOrderCommand)
+        + @EventSourcingHandler: on(OrderCreatedEvent)
+        + @EventSourcingHandler: on(OrderConfirmedEvent)
+    }
+}
+
+package "Domain Layer" {
+    class Order << record >> {
+        + create(): OrderCreatedEvent
+        + confirm(): OrderConfirmedEvent
+        + apply(event): Order
+    }
+}
+
+OrderAggregateAdapter --> Order : "委譲"
+
+note bottom of OrderAggregateAdapter
+  Axon Framework 用アダプター
+  フレームワーク依存を吸収
+end note
+
+note bottom of Order
+  純粋なドメインモデル
+  Axon に依存しない
+end note
+
+@enduml
+```
+
+---
+
+### 20.2 Order Aggregate Adapter
+
+<details>
+<summary>コード例: OrderAggregateAdapter.java</summary>
+
+```java
+package com.example.sales.order.application.aggregate;
+
+import com.example.sales.order.api.events.*;
+import com.example.sales.order.domain.model.aggregate.order.Order;
+import com.example.sales.order.domain.model.aggregate.order.OrderCommands.*;
+import org.axonframework.commandhandling.CommandHandler;
+import org.axonframework.eventsourcing.EventSourcingHandler;
+import org.axonframework.modelling.command.AggregateIdentifier;
+import org.axonframework.modelling.command.AggregateLifecycle;
+import org.axonframework.spring.stereotype.Aggregate;
+
+/**
+ * Order Aggregate Adapter（Axon Framework 用）
+ */
+@Aggregate
+public class OrderAggregateAdapter {
+
+    @AggregateIdentifier
+    private String orderId;
+
+    private Order order;
+
+    /**
+     * Axon が使用するデフォルトコンストラクタ
+     */
+    protected OrderAggregateAdapter() {
+    }
+
+    // ======== Command Handlers ========
+
+    /**
+     * 集約作成コマンドハンドラー（コンストラクタ）
+     */
+    @CommandHandler
+    public OrderAggregateAdapter(CreateOrderCommand command) {
+        // ドメインモデルのファクトリメソッドを呼び出し
+        var event = Order.create(
+                command.orderId(),
+                command.customerId(),
+                command.productId(),
+                command.quantity(),
+                command.totalAmount()
+        );
+        // イベントを発行
+        AggregateLifecycle.apply(event);
+    }
+
+    /**
+     * 確定コマンドハンドラー
+     */
+    @CommandHandler
+    public void handle(ConfirmOrderCommand command) {
+        var event = order.confirm();
+        AggregateLifecycle.apply(event);
+    }
+
+    /**
+     * 拒否コマンドハンドラー
+     */
+    @CommandHandler
+    public void handle(RejectOrderCommand command) {
+        var event = order.reject(command.reason());
+        AggregateLifecycle.apply(event);
+    }
+
+    /**
+     * 出荷依頼コマンドハンドラー
+     */
+    @CommandHandler
+    public void handle(RequestShipmentCommand command) {
+        var event = order.requestShipment();
+        AggregateLifecycle.apply(event);
+    }
+
+    /**
+     * 出荷コマンドハンドラー
+     */
+    @CommandHandler
+    public void handle(ShipOrderCommand command) {
+        var event = order.ship(command.trackingNumber());
+        AggregateLifecycle.apply(event);
+    }
+
+    /**
+     * 配達完了コマンドハンドラー
+     */
+    @CommandHandler
+    public void handle(DeliverOrderCommand command) {
+        var event = order.deliver();
+        AggregateLifecycle.apply(event);
+    }
+
+    /**
+     * キャンセルコマンドハンドラー
+     */
+    @CommandHandler
+    public void handle(CancelOrderCommand command) {
+        var event = order.cancel(command.cancelledBy(), command.reason());
+        AggregateLifecycle.apply(event);
+    }
+
+    // ======== Event Sourcing Handlers（状態復元）========
+
+    @EventSourcingHandler
+    public void on(OrderCreatedEvent event) {
+        this.orderId = event.orderId();
+        this.order = Order.from(event);
+    }
+
+    @EventSourcingHandler
+    public void on(OrderConfirmedEvent event) {
+        this.order = order.apply(event);
+    }
+
+    @EventSourcingHandler
+    public void on(OrderRejectedEvent event) {
+        this.order = order.apply(event);
+    }
+
+    @EventSourcingHandler
+    public void on(ShipmentRequestedEvent event) {
+        this.order = order.apply(event);
+    }
+
+    @EventSourcingHandler
+    public void on(OrderShippedEvent event) {
+        this.order = order.apply(event);
+    }
+
+    @EventSourcingHandler
+    public void on(OrderDeliveredEvent event) {
+        this.order = order.apply(event);
+    }
+
+    @EventSourcingHandler
+    public void on(OrderCancelledEvent event) {
+        this.order = order.apply(event);
+    }
+}
+```
+
+</details>
+
+**Axon アノテーション解説：**
+
+| アノテーション | 説明 |
+|--------------|------|
+| `@Aggregate` | Event Sourcing 集約であることを宣言 |
+| `@AggregateIdentifier` | 集約の識別子フィールド |
+| `@CommandHandler` | コマンドを処理するメソッド |
+| `@EventSourcingHandler` | イベントから状態を復元するメソッド |
+| `AggregateLifecycle.apply()` | イベントを発行するメソッド |
+
+---
+
+### 20.3 Stock Aggregate Adapter
+
+<details>
+<summary>コード例: StockAggregateAdapter.java</summary>
+
+```java
+package com.example.sales.inventory.application.aggregate;
+
+import com.example.sales.inventory.api.events.*;
+import com.example.sales.inventory.domain.model.aggregate.stock.Stock;
+import com.example.sales.inventory.domain.model.aggregate.stock.StockCommands.*;
+import org.axonframework.commandhandling.CommandHandler;
+import org.axonframework.eventsourcing.EventSourcingHandler;
+import org.axonframework.modelling.command.AggregateIdentifier;
+import org.axonframework.modelling.command.AggregateLifecycle;
+import org.axonframework.spring.stereotype.Aggregate;
+
+import java.time.LocalDateTime;
+
+/**
+ * Stock Aggregate Adapter
+ */
+@Aggregate
+public class StockAggregateAdapter {
+
+    @AggregateIdentifier
+    private String productId;
+
+    private Stock stock;
+
+    protected StockAggregateAdapter() {
+    }
+
+    @CommandHandler
+    public StockAggregateAdapter(InitializeStockCommand command) {
+        AggregateLifecycle.apply(new StockInitializedEvent(
+                command.productId(),
+                command.initialQuantity(),
+                LocalDateTime.now()
+        ));
+    }
+
+    @CommandHandler
+    public void handle(ReserveStockCommand command) {
+        var event = stock.reserve(command.orderId(), command.quantity());
+        AggregateLifecycle.apply(event);
+    }
+
+    @CommandHandler
+    public void handle(DeductStockCommand command) {
+        var event = stock.deduct(command.orderId(), command.quantity());
+        AggregateLifecycle.apply(event);
+    }
+
+    @CommandHandler
+    public void handle(ReleaseStockCommand command) {
+        var event = stock.release(command.orderId(), command.quantity());
+        AggregateLifecycle.apply(event);
+    }
+
+    @EventSourcingHandler
+    public void on(StockInitializedEvent event) {
+        this.productId = event.productId();
+        this.stock = Stock.initial(event.productId(), event.initialQuantity());
+    }
+
+    @EventSourcingHandler
+    public void on(StockReservedEvent event) {
+        this.stock = stock.apply(event);
+    }
+
+    @EventSourcingHandler
+    public void on(StockReservationFailedEvent event) {
+        // 状態変更なし
+    }
+
+    @EventSourcingHandler
+    public void on(StockDeductedEvent event) {
+        this.stock = stock.apply(event);
+    }
+
+    @EventSourcingHandler
+    public void on(StockReleasedEvent event) {
+        this.stock = stock.apply(event);
+    }
+}
+```
+
+</details>
+
+---
+
+### 20.4 Policy Handler（Choreography パターン）
+
+Policy Handler は、他の Bounded Context から発行されたイベントを購読し、自律的に反応する処理を実装します。Choreography パターンでは、各 Context が独立して動作し、イベントを介して連携します。
+
+```plantuml
+@startuml choreography
+skinparam backgroundColor #FEFEFE
+
+participant "Order Context" as Order
+participant "Event Bus" as Bus
+participant "Inventory Context" as Inventory
+
+== 注文作成フロー ==
+Order -> Bus : OrderCreatedEvent
+Bus -> Inventory : OrderCreatedEvent
+Inventory -> Inventory : reserve()
+alt 在庫あり
+  Inventory -> Bus : StockReservedEvent
+  Bus -> Order : StockReservedEvent
+  Order -> Order : confirm()
+else 在庫なし
+  Inventory -> Bus : StockReservationFailedEvent
+  Bus -> Order : StockReservationFailedEvent
+  Order -> Order : reject()
+end
+
+== 出荷フロー ==
+Order -> Bus : OrderShippedEvent
+Bus -> Inventory : OrderShippedEvent
+Inventory -> Inventory : deduct()
+Inventory -> Bus : StockDeductedEvent
+
+== キャンセルフロー ==
+Order -> Bus : OrderCancelledEvent
+Bus -> Inventory : OrderCancelledEvent
+Inventory -> Inventory : release()
+Inventory -> Bus : StockReleasedEvent
+
+@enduml
+```
+
+---
+
+### 20.5 OrderEventHandler（Inventory Context 内）
+
+<details>
+<summary>コード例: OrderEventHandler.java</summary>
+
+```java
+package com.example.sales.inventory.application.policy;
+
+import com.example.sales.inventory.domain.model.aggregate.stock.StockCommands.*;
+import com.example.sales.order.api.events.OrderCancelledEvent;
+import com.example.sales.order.api.events.OrderCreatedEvent;
+import com.example.sales.order.api.events.OrderShippedEvent;
+import org.axonframework.commandhandling.gateway.CommandGateway;
+import org.axonframework.eventhandling.EventHandler;
+import org.springframework.stereotype.Component;
+
+/**
+ * Order イベントに反応して在庫操作を実行する Policy Handler
+ */
+@Component
+public class OrderEventHandler {
+
+    private final CommandGateway commandGateway;
+
+    public OrderEventHandler(CommandGateway commandGateway) {
+        this.commandGateway = commandGateway;
+    }
+
+    /**
+     * Policy: "When an order is created, reserve stock"
+     */
+    @EventHandler
+    public void on(OrderCreatedEvent event) {
+        var command = new ReserveStockCommand(
+                event.productId(),
+                event.orderId(),
+                event.quantity()
+        );
+        commandGateway.send(command);
+    }
+
+    /**
+     * Policy: "When an order is shipped, deduct stock"
+     */
+    @EventHandler
+    public void on(OrderShippedEvent event) {
+        var command = new DeductStockCommand(
+                event.productId(),
+                event.orderId(),
+                event.quantity()
+        );
+        commandGateway.send(command);
+    }
+
+    /**
+     * Policy: "When an order is cancelled, release stock"
+     */
+    @EventHandler
+    public void on(OrderCancelledEvent event) {
+        var command = new ReleaseStockCommand(
+                event.productId(),
+                event.orderId(),
+                event.quantity()
+        );
+        commandGateway.send(command);
+    }
+}
+```
+
+</details>
+
+---
+
+### 20.6 StockEventHandler（Order Context 内）
+
+<details>
+<summary>コード例: StockEventHandler.java</summary>
+
+```java
+package com.example.sales.order.application.policy;
+
+import com.example.sales.inventory.api.events.StockReservationFailedEvent;
+import com.example.sales.inventory.api.events.StockReservedEvent;
+import com.example.sales.order.domain.model.aggregate.order.OrderCommands.*;
+import org.axonframework.commandhandling.gateway.CommandGateway;
+import org.axonframework.eventhandling.EventHandler;
+import org.springframework.stereotype.Component;
+
+/**
+ * Stock イベントに反応して注文状態を更新する Policy Handler
+ */
+@Component
+public class StockEventHandler {
+
+    private final CommandGateway commandGateway;
+
+    public StockEventHandler(CommandGateway commandGateway) {
+        this.commandGateway = commandGateway;
+    }
+
+    /**
+     * Policy: "When stock is reserved, confirm the order"
+     */
+    @EventHandler
+    public void on(StockReservedEvent event) {
+        var command = new ConfirmOrderCommand(event.orderId());
+        commandGateway.send(command);
+    }
+
+    /**
+     * Policy: "When stock reservation fails, reject the order"
+     */
+    @EventHandler
+    public void on(StockReservationFailedEvent event) {
+        var command = new RejectOrderCommand(event.orderId(), event.reason());
+        commandGateway.send(command);
+    }
+}
+```
+
+</details>
+
+**Policy Handler の設計原則：**
+
+| 原則 | 説明 |
+|------|------|
+| **単一責任** | 1 つの Policy Handler は 1 つの関心事のみを扱う |
+| **疎結合** | 他の Context のイベントを購読し、自 Context のコマンドを発行 |
+| **自律性** | 他のサービスに依存せず独立して動作 |
+| **冪等性** | 同じイベントを複数回受信しても問題ないよう設計 |
+
+---
+
+## 第21章：Projection と Read Model
+
+### 21.1 Projection の役割
+
+Projection は、イベントを購読して Read Model（クエリ用のデータモデル）を更新するコンポーネントです。CQRS では、書き込みモデル（Event Store）と読み取りモデル（Read Model DB）を分離し、それぞれに最適化されたデータ構造を使用します。
+
+```plantuml
+@startuml projection
+skinparam backgroundColor #FEFEFE
+
+participant "CommandHandler" as CH
+participant "Event Store" as ES
+participant "Projection" as P
+participant "MyBatis Mapper" as MB
+participant "Read Model DB" as DB
+participant "REST Controller" as RC
+
+== 書き込み（Command Side）==
+CH -> ES : イベント保存
+ES -> P : イベント通知
+
+== 読み取りモデル更新 ==
+P -> MB : insert/update
+MB -> DB : SQL 実行
+
+== 読み取り（Query Side）==
+RC -> MB : findById
+MB -> DB : SELECT
+DB --> MB : 結果
+MB --> RC : Entity
+
+note right of P
+  Projection は
+  イベントを購読して
+  MyBatis 経由で
+  Read Model を更新
+end note
+
+@enduml
+```
+
+---
+
+### 21.2 Order Projection（MyBatis 版）
+
+<details>
+<summary>コード例: OrderProjection.java</summary>
+
+```java
+package com.example.sales.order.application.query;
+
+import com.example.sales.order.adapter.outbound.persistence.entity.OrderEntity;
+import com.example.sales.order.adapter.outbound.persistence.mapper.OrderMapper;
+import com.example.sales.order.api.events.*;
+import org.axonframework.eventhandling.EventHandler;
+import org.springframework.stereotype.Component;
+
+/**
+ * Order Projection（MyBatis を使用した Read Model の更新）
+ */
+@Component
+public class OrderProjection {
+
+    private final OrderMapper orderMapper;
+
+    public OrderProjection(OrderMapper orderMapper) {
+        this.orderMapper = orderMapper;
+    }
+
+    @EventHandler
+    public void on(OrderCreatedEvent event) {
+        var entity = new OrderEntity();
+        entity.setOrderId(event.orderId());
+        entity.setCustomerId(event.customerId());
+        entity.setProductId(event.productId());
+        entity.setQuantity(event.quantity());
+        entity.setTotalAmount(event.totalAmount());
+        entity.setStatus("PENDING");
+        entity.setCreatedAt(event.createdAt());
+
+        orderMapper.insert(entity);
+    }
+
+    @EventHandler
+    public void on(OrderConfirmedEvent event) {
+        orderMapper.updateStatus(event.orderId(), "CONFIRMED");
+        orderMapper.updateConfirmedAt(event.orderId(), event.confirmedAt());
+    }
+
+    @EventHandler
+    public void on(OrderRejectedEvent event) {
+        orderMapper.updateStatus(event.orderId(), "REJECTED");
+        orderMapper.updateRejection(event.orderId(), event.reason(), event.rejectedAt());
+    }
+
+    @EventHandler
+    public void on(ShipmentRequestedEvent event) {
+        orderMapper.updateStatus(event.orderId(), "AWAITING_SHIPMENT");
+        orderMapper.updateRequestedAt(event.orderId(), event.requestedAt());
+    }
+
+    @EventHandler
+    public void on(OrderShippedEvent event) {
+        orderMapper.updateStatus(event.orderId(), "SHIPPED");
+        orderMapper.updateShipment(event.orderId(), event.trackingNumber(), event.shippedAt());
+    }
+
+    @EventHandler
+    public void on(OrderDeliveredEvent event) {
+        orderMapper.updateStatus(event.orderId(), "DELIVERED");
+        orderMapper.updateDeliveredAt(event.orderId(), event.deliveredAt());
+    }
+
+    @EventHandler
+    public void on(OrderCancelledEvent event) {
+        orderMapper.updateStatus(event.orderId(), "CANCELLED");
+        orderMapper.updateCancellation(
+            event.orderId(),
+            event.cancelledBy(),
+            event.reason(),
+            event.cancelledAt()
+        );
+    }
+}
+```
+
+</details>
+
+---
+
+### 21.3 Read Model Entity
+
+<details>
+<summary>コード例: OrderEntity.java</summary>
+
+```java
+package com.example.sales.order.adapter.outbound.persistence.entity;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * Order Read Model（表示用のすべてのフィールドを保持）
+ */
+public class OrderEntity {
+
+    private String orderId;
+    private String customerId;
+    private String productId;
+    private int quantity;
+    private BigDecimal totalAmount;
+    private String status;
+    private LocalDateTime confirmedAt;
+    private LocalDateTime requestedAt;
+    private String trackingNumber;
+    private LocalDateTime shippedAt;
+    private LocalDateTime deliveredAt;
+    private String cancelledBy;
+    private String cancellationReason;
+    private LocalDateTime cancelledAt;
+    private String rejectionReason;
+    private LocalDateTime rejectedAt;
+    private LocalDateTime createdAt;
+
+    // Getters and Setters
+    public String getOrderId() { return orderId; }
+    public void setOrderId(String orderId) { this.orderId = orderId; }
+
+    public String getCustomerId() { return customerId; }
+    public void setCustomerId(String customerId) { this.customerId = customerId; }
+
+    public String getProductId() { return productId; }
+    public void setProductId(String productId) { this.productId = productId; }
+
+    public int getQuantity() { return quantity; }
+    public void setQuantity(int quantity) { this.quantity = quantity; }
+
+    public BigDecimal getTotalAmount() { return totalAmount; }
+    public void setTotalAmount(BigDecimal totalAmount) { this.totalAmount = totalAmount; }
+
+    public String getStatus() { return status; }
+    public void setStatus(String status) { this.status = status; }
+
+    public LocalDateTime getConfirmedAt() { return confirmedAt; }
+    public void setConfirmedAt(LocalDateTime confirmedAt) { this.confirmedAt = confirmedAt; }
+
+    public LocalDateTime getRequestedAt() { return requestedAt; }
+    public void setRequestedAt(LocalDateTime requestedAt) { this.requestedAt = requestedAt; }
+
+    public String getTrackingNumber() { return trackingNumber; }
+    public void setTrackingNumber(String trackingNumber) { this.trackingNumber = trackingNumber; }
+
+    public LocalDateTime getShippedAt() { return shippedAt; }
+    public void setShippedAt(LocalDateTime shippedAt) { this.shippedAt = shippedAt; }
+
+    public LocalDateTime getDeliveredAt() { return deliveredAt; }
+    public void setDeliveredAt(LocalDateTime deliveredAt) { this.deliveredAt = deliveredAt; }
+
+    public String getCancelledBy() { return cancelledBy; }
+    public void setCancelledBy(String cancelledBy) { this.cancelledBy = cancelledBy; }
+
+    public String getCancellationReason() { return cancellationReason; }
+    public void setCancellationReason(String cancellationReason) { this.cancellationReason = cancellationReason; }
+
+    public LocalDateTime getCancelledAt() { return cancelledAt; }
+    public void setCancelledAt(LocalDateTime cancelledAt) { this.cancelledAt = cancelledAt; }
+
+    public String getRejectionReason() { return rejectionReason; }
+    public void setRejectionReason(String rejectionReason) { this.rejectionReason = rejectionReason; }
+
+    public LocalDateTime getRejectedAt() { return rejectedAt; }
+    public void setRejectedAt(LocalDateTime rejectedAt) { this.rejectedAt = rejectedAt; }
+
+    public LocalDateTime getCreatedAt() { return createdAt; }
+    public void setCreatedAt(LocalDateTime createdAt) { this.createdAt = createdAt; }
+}
+```
+
+</details>
+
+---
+
+### 21.4 MyBatis Mapper インターフェース
+
+<details>
+<summary>コード例: OrderMapper.java</summary>
+
+```java
+package com.example.sales.order.adapter.outbound.persistence.mapper;
+
+import com.example.sales.order.adapter.outbound.persistence.entity.OrderEntity;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Optional;
+
+/**
+ * Order MyBatis Mapper
+ */
+@Mapper
+public interface OrderMapper {
+
+    // 挿入
+    void insert(OrderEntity entity);
+
+    // 検索
+    Optional<OrderEntity> findById(@Param("orderId") String orderId);
+
+    List<OrderEntity> findAll();
+
+    List<OrderEntity> findByCustomerId(@Param("customerId") String customerId);
+
+    List<OrderEntity> findByStatus(@Param("status") String status);
+
+    // 更新
+    void updateStatus(@Param("orderId") String orderId, @Param("status") String status);
+
+    void updateConfirmedAt(@Param("orderId") String orderId, @Param("confirmedAt") LocalDateTime confirmedAt);
+
+    void updateRequestedAt(@Param("orderId") String orderId, @Param("requestedAt") LocalDateTime requestedAt);
+
+    void updateShipment(
+        @Param("orderId") String orderId,
+        @Param("trackingNumber") String trackingNumber,
+        @Param("shippedAt") LocalDateTime shippedAt
+    );
+
+    void updateDeliveredAt(@Param("orderId") String orderId, @Param("deliveredAt") LocalDateTime deliveredAt);
+
+    void updateCancellation(
+        @Param("orderId") String orderId,
+        @Param("cancelledBy") String cancelledBy,
+        @Param("cancellationReason") String cancellationReason,
+        @Param("cancelledAt") LocalDateTime cancelledAt
+    );
+
+    void updateRejection(
+        @Param("orderId") String orderId,
+        @Param("rejectionReason") String rejectionReason,
+        @Param("rejectedAt") LocalDateTime rejectedAt
+    );
+}
+```
+
+</details>
+
+---
+
+### 21.5 MyBatis Mapper XML
+
+<details>
+<summary>コード例: OrderMapper.xml</summary>
+
+```xml
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+
+<mapper namespace="com.example.sales.order.adapter.outbound.persistence.mapper.OrderMapper">
+
+    <resultMap id="orderResultMap" type="OrderEntity">
+        <id property="orderId" column="order_id"/>
+        <result property="customerId" column="customer_id"/>
+        <result property="productId" column="product_id"/>
+        <result property="quantity" column="quantity"/>
+        <result property="totalAmount" column="total_amount"/>
+        <result property="status" column="status"/>
+        <result property="confirmedAt" column="confirmed_at"/>
+        <result property="requestedAt" column="requested_at"/>
+        <result property="trackingNumber" column="tracking_number"/>
+        <result property="shippedAt" column="shipped_at"/>
+        <result property="deliveredAt" column="delivered_at"/>
+        <result property="cancelledBy" column="cancelled_by"/>
+        <result property="cancellationReason" column="cancellation_reason"/>
+        <result property="cancelledAt" column="cancelled_at"/>
+        <result property="rejectionReason" column="rejection_reason"/>
+        <result property="rejectedAt" column="rejected_at"/>
+        <result property="createdAt" column="created_at"/>
+    </resultMap>
+
+    <insert id="insert" parameterType="OrderEntity">
+        INSERT INTO orders (
+            order_id, customer_id, product_id, quantity, total_amount,
+            status, created_at
+        ) VALUES (
+            #{orderId}, #{customerId}, #{productId}, #{quantity}, #{totalAmount},
+            #{status}, #{createdAt}
+        )
+    </insert>
+
+    <select id="findById" resultMap="orderResultMap">
+        SELECT * FROM orders WHERE order_id = #{orderId}
+    </select>
+
+    <select id="findAll" resultMap="orderResultMap">
+        SELECT * FROM orders ORDER BY created_at DESC
+    </select>
+
+    <select id="findByCustomerId" resultMap="orderResultMap">
+        SELECT * FROM orders WHERE customer_id = #{customerId} ORDER BY created_at DESC
+    </select>
+
+    <select id="findByStatus" resultMap="orderResultMap">
+        SELECT * FROM orders WHERE status = #{status} ORDER BY created_at DESC
+    </select>
+
+    <update id="updateStatus">
+        UPDATE orders SET status = #{status} WHERE order_id = #{orderId}
+    </update>
+
+    <update id="updateConfirmedAt">
+        UPDATE orders SET confirmed_at = #{confirmedAt} WHERE order_id = #{orderId}
+    </update>
+
+    <update id="updateRequestedAt">
+        UPDATE orders SET requested_at = #{requestedAt} WHERE order_id = #{orderId}
+    </update>
+
+    <update id="updateShipment">
+        UPDATE orders
+        SET tracking_number = #{trackingNumber}, shipped_at = #{shippedAt}
+        WHERE order_id = #{orderId}
+    </update>
+
+    <update id="updateDeliveredAt">
+        UPDATE orders SET delivered_at = #{deliveredAt} WHERE order_id = #{orderId}
+    </update>
+
+    <update id="updateCancellation">
+        UPDATE orders
+        SET cancelled_by = #{cancelledBy},
+            cancellation_reason = #{cancellationReason},
+            cancelled_at = #{cancelledAt}
+        WHERE order_id = #{orderId}
+    </update>
+
+    <update id="updateRejection">
+        UPDATE orders
+        SET rejection_reason = #{rejectionReason}, rejected_at = #{rejectedAt}
+        WHERE order_id = #{orderId}
+    </update>
+
+</mapper>
+```
+
+</details>
+
+---
+
+### 21.6 Read Model スキーマ
+
+<details>
+<summary>コード例: schema.sql</summary>
+
+```sql
+-- Read Model: Orders テーブル
+CREATE TABLE IF NOT EXISTS orders (
+    order_id VARCHAR(36) PRIMARY KEY,
+    customer_id VARCHAR(36) NOT NULL,
+    product_id VARCHAR(36) NOT NULL,
+    quantity INT NOT NULL,
+    total_amount DECIMAL(12, 2) NOT NULL,
+    status VARCHAR(20) NOT NULL,
+    confirmed_at TIMESTAMP,
+    requested_at TIMESTAMP,
+    tracking_number VARCHAR(50),
+    shipped_at TIMESTAMP,
+    delivered_at TIMESTAMP,
+    cancelled_by VARCHAR(100),
+    cancellation_reason TEXT,
+    cancelled_at TIMESTAMP,
+    rejection_reason TEXT,
+    rejected_at TIMESTAMP,
+    created_at TIMESTAMP NOT NULL
+);
+
+-- インデックス
+CREATE INDEX IF NOT EXISTS idx_orders_customer_id ON orders(customer_id);
+CREATE INDEX IF NOT EXISTS idx_orders_status ON orders(status);
+CREATE INDEX IF NOT EXISTS idx_orders_created_at ON orders(created_at);
+```
+
+</details>
+
+---
+
+### 21.7 最小限フィールドの原則
+
+Event Sourcing では、ドメインモデルは「次のコマンドを処理するために必要な最小限の状態」のみを保持します。一方、Read Model は表示に必要なすべてのフィールドを保持します。
+
+| フィールド | ドメインモデル | Read Model | 理由 |
+|-----------|:-------------:|:----------:|------|
+| orderId | O | O | 識別子として必要 |
+| status | O | O | 状態遷移の判定に必要 |
+| confirmedAt | X | O | 判定に不要、表示のみ |
+| trackingNumber | X | O | 判定に不要、表示のみ |
+| cancelledBy | X | O | 判定に不要、表示のみ |
+| createdAt | X | O | 判定に不要、表示のみ |
+
+---
+
+## 第22章：REST API と統合テスト
+
+### 22.1 REST Controller（Inbound Adapter）
+
+<details>
+<summary>コード例: OrdersController.java</summary>
+
+```java
+package com.example.sales.order.adapter.inbound.rest.orders;
+
+import com.example.sales.order.adapter.inbound.rest.orders.protocol.*;
+import com.example.sales.order.adapter.outbound.persistence.mapper.OrderMapper;
+import com.example.sales.order.domain.model.aggregate.order.OrderCommands.*;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.axonframework.commandhandling.gateway.CommandGateway;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.UUID;
+import java.util.concurrent.CompletableFuture;
+
+/**
+ * Order REST Controller（Inbound Adapter）
+ */
+@RestController
+@RequestMapping("/api/orders")
+@Tag(name = "Orders", description = "Order management API")
+public class OrdersController {
+
+    private final CommandGateway commandGateway;
+    private final OrderMapper orderMapper;
+
+    public OrdersController(CommandGateway commandGateway, OrderMapper orderMapper) {
+        this.commandGateway = commandGateway;
+        this.orderMapper = orderMapper;
+    }
+
+    // ========== Command Side (Write) ==========
+
+    @PostMapping
+    @Operation(summary = "Create a new order")
+    public CompletableFuture<ResponseEntity<OrderCreateResponse>> create(
+            @Valid @RequestBody OrderCreateRequest request
+    ) {
+        var orderId = UUID.randomUUID().toString();
+        var command = new CreateOrderCommand(
+                orderId,
+                request.customerId(),
+                request.productId(),
+                request.quantity(),
+                request.totalAmount()
+        );
+
+        return commandGateway.send(command)
+                .thenApply(result -> ResponseEntity
+                        .status(HttpStatus.CREATED)
+                        .body(new OrderCreateResponse(orderId)));
+    }
+
+    @PostMapping("/{id}/request-shipment")
+    @Operation(summary = "Request shipment for an order")
+    public CompletableFuture<ResponseEntity<Void>> requestShipment(@PathVariable String id) {
+        var command = new RequestShipmentCommand(id);
+
+        return commandGateway.send(command)
+                .thenApply(result -> ResponseEntity.ok().<Void>build());
+    }
+
+    @PostMapping("/{id}/ship")
+    @Operation(summary = "Ship an order")
+    public CompletableFuture<ResponseEntity<Void>> ship(
+            @PathVariable String id,
+            @Valid @RequestBody OrderShipRequest request
+    ) {
+        var command = new ShipOrderCommand(id, request.trackingNumber());
+
+        return commandGateway.send(command)
+                .thenApply(result -> ResponseEntity.ok().<Void>build());
+    }
+
+    @PostMapping("/{id}/deliver")
+    @Operation(summary = "Deliver an order")
+    public CompletableFuture<ResponseEntity<Void>> deliver(@PathVariable String id) {
+        var command = new DeliverOrderCommand(id);
+
+        return commandGateway.send(command)
+                .thenApply(result -> ResponseEntity.ok().<Void>build());
+    }
+
+    @PostMapping("/{id}/cancel")
+    @Operation(summary = "Cancel an order")
+    public CompletableFuture<ResponseEntity<Void>> cancel(
+            @PathVariable String id,
+            @Valid @RequestBody OrderCancelRequest request
+    ) {
+        var command = new CancelOrderCommand(id, request.cancelledBy(), request.reason());
+
+        return commandGateway.send(command)
+                .thenApply(result -> ResponseEntity.ok().<Void>build());
+    }
+
+    // ========== Query Side (Read) ==========
+
+    @GetMapping("/{id}")
+    @Operation(summary = "Get an order by ID")
+    public ResponseEntity<OrderGetResponse> get(@PathVariable String id) {
+        return orderMapper.findById(id)
+                .map(entity -> ResponseEntity.ok(OrderGetResponse.from(entity)))
+                .orElse(ResponseEntity.notFound().build());
+    }
+
+    @GetMapping
+    @Operation(summary = "Get all orders")
+    public ResponseEntity<OrderListResponse> getAll() {
+        var entities = orderMapper.findAll();
+        var items = entities.stream()
+                .map(OrderGetResponse::from)
+                .toList();
+        return ResponseEntity.ok(new OrderListResponse(items));
+    }
+}
+```
+
+</details>
+
+---
+
+### 22.2 Request/Response DTO
+
+<details>
+<summary>コード例: OrderCreateRequest.java</summary>
+
+```java
+package com.example.sales.order.adapter.inbound.rest.orders.protocol;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Positive;
+import java.math.BigDecimal;
+
+/**
+ * 注文作成リクエスト
+ */
+public record OrderCreateRequest(
+        @NotBlank
+        String customerId,
+
+        @NotBlank
+        String productId,
+
+        @Positive
+        int quantity,
+
+        @Positive
+        BigDecimal totalAmount
+) {
+}
+```
+
+</details>
+
+<details>
+<summary>コード例: OrderGetResponse.java</summary>
+
+```java
+package com.example.sales.order.adapter.inbound.rest.orders.protocol;
+
+import com.example.sales.order.adapter.outbound.persistence.entity.OrderEntity;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 注文取得レスポンス
+ */
+public record OrderGetResponse(
+        String orderId,
+        String customerId,
+        String productId,
+        int quantity,
+        BigDecimal totalAmount,
+        String status,
+        LocalDateTime confirmedAt,
+        LocalDateTime requestedAt,
+        String trackingNumber,
+        LocalDateTime shippedAt,
+        LocalDateTime deliveredAt,
+        String cancelledBy,
+        String cancellationReason,
+        LocalDateTime cancelledAt,
+        String rejectionReason,
+        LocalDateTime rejectedAt,
+        LocalDateTime createdAt
+) {
+
+    public static OrderGetResponse from(OrderEntity entity) {
+        return new OrderGetResponse(
+                entity.getOrderId(),
+                entity.getCustomerId(),
+                entity.getProductId(),
+                entity.getQuantity(),
+                entity.getTotalAmount(),
+                entity.getStatus(),
+                entity.getConfirmedAt(),
+                entity.getRequestedAt(),
+                entity.getTrackingNumber(),
+                entity.getShippedAt(),
+                entity.getDeliveredAt(),
+                entity.getCancelledBy(),
+                entity.getCancellationReason(),
+                entity.getCancelledAt(),
+                entity.getRejectionReason(),
+                entity.getRejectedAt(),
+                entity.getCreatedAt()
+        );
+    }
+}
+```
+
+</details>
+
+---
+
+### 22.3 API エンドポイント一覧
+
+| メソッド | パス | 説明 | 種別 |
+|---------|------|------|------|
+| POST | `/api/orders` | 注文作成 | Command |
+| POST | `/api/orders/{id}/request-shipment` | 出荷依頼 | Command |
+| POST | `/api/orders/{id}/ship` | 出荷 | Command |
+| POST | `/api/orders/{id}/deliver` | 配達完了 | Command |
+| POST | `/api/orders/{id}/cancel` | キャンセル | Command |
+| GET | `/api/orders` | 注文一覧取得 | Query |
+| GET | `/api/orders/{id}` | 注文詳細取得 | Query |
+
+---
+
+### 22.4 Axon Test による単体テスト
+
+<details>
+<summary>コード例: OrderAggregateTest.java</summary>
+
+```java
+package com.example.sales.order.application.aggregate;
+
+import com.example.sales.order.api.events.*;
+import com.example.sales.order.domain.model.aggregate.order.OrderCommands.*;
+import org.axonframework.test.aggregate.AggregateTestFixture;
+import org.axonframework.test.aggregate.FixtureConfiguration;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Nested;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+class OrderAggregateTest {
+
+    private FixtureConfiguration<OrderAggregateAdapter> fixture;
+
+    @BeforeEach
+    void setUp() {
+        fixture = new AggregateTestFixture<>(OrderAggregateAdapter.class);
+    }
+
+    @Nested
+    @DisplayName("注文作成")
+    class CreateOrder {
+
+        @Test
+        @DisplayName("正常な注文を作成できる")
+        void shouldCreateOrder() {
+            var command = new CreateOrderCommand(
+                    "order-1",
+                    "customer-1",
+                    "product-1",
+                    10,
+                    BigDecimal.valueOf(1000)
+            );
+
+            fixture.givenNoPriorActivity()
+                    .when(command)
+                    .expectSuccessfulHandlerExecution()
+                    .expectEventsMatching(events ->
+                            events.getPayload() instanceof OrderCreatedEvent
+                    );
+        }
+
+        @Test
+        @DisplayName("数量が0以下の場合はエラー")
+        void shouldRejectZeroQuantity() {
+            var command = new CreateOrderCommand(
+                    "order-1",
+                    "customer-1",
+                    "product-1",
+                    0,
+                    BigDecimal.valueOf(1000)
+            );
+
+            fixture.givenNoPriorActivity()
+                    .when(command)
+                    .expectException(IllegalArgumentException.class);
+        }
+    }
+
+    @Nested
+    @DisplayName("注文確定")
+    class ConfirmOrder {
+
+        @Test
+        @DisplayName("保留中の注文を確定できる")
+        void shouldConfirmPendingOrder() {
+            var createdEvent = new OrderCreatedEvent(
+                    "order-1",
+                    "customer-1",
+                    "product-1",
+                    10,
+                    BigDecimal.valueOf(1000),
+                    LocalDateTime.now()
+            );
+
+            fixture.given(createdEvent)
+                    .when(new ConfirmOrderCommand("order-1"))
+                    .expectSuccessfulHandlerExecution()
+                    .expectEventsMatching(events ->
+                            events.getPayload() instanceof OrderConfirmedEvent
+                    );
+        }
+    }
+
+    @Nested
+    @DisplayName("注文キャンセル")
+    class CancelOrder {
+
+        @Test
+        @DisplayName("保留中の注文をキャンセルできる")
+        void shouldCancelPendingOrder() {
+            var createdEvent = new OrderCreatedEvent(
+                    "order-1",
+                    "customer-1",
+                    "product-1",
+                    10,
+                    BigDecimal.valueOf(1000),
+                    LocalDateTime.now()
+            );
+
+            fixture.given(createdEvent)
+                    .when(new CancelOrderCommand("order-1", "user-1", "Customer request"))
+                    .expectSuccessfulHandlerExecution()
+                    .expectEventsMatching(events ->
+                            events.getPayload() instanceof OrderCancelledEvent
+                    );
+        }
+
+        @Test
+        @DisplayName("出荷済みの注文はキャンセルできない")
+        void shouldNotCancelShippedOrder() {
+            var createdEvent = new OrderCreatedEvent(
+                    "order-1",
+                    "customer-1",
+                    "product-1",
+                    10,
+                    BigDecimal.valueOf(1000),
+                    LocalDateTime.now()
+            );
+            var confirmedEvent = new OrderConfirmedEvent("order-1", LocalDateTime.now());
+            var requestedEvent = new ShipmentRequestedEvent("order-1", LocalDateTime.now());
+            var shippedEvent = new OrderShippedEvent("order-1", "product-1", 10, "TRACK123", LocalDateTime.now());
+
+            fixture.given(createdEvent, confirmedEvent, requestedEvent, shippedEvent)
+                    .when(new CancelOrderCommand("order-1", "user-1", "Customer request"))
+                    .expectException(IllegalStateException.class);
+        }
+    }
+}
+```
+
+</details>
+
+---
+
+## Part 10-F のまとめ
+
+### 実装した機能一覧
+
+| 章 | 内容 | 主要技術 |
+|---|---|---|
+| **第18章: 基礎** | CQRS/ES アーキテクチャの基礎 | Axon Framework, Event Sourcing |
+| **第19章: ドメイン設計** | イベント、コマンド、ドメインモデル | sealed interface, record |
+| **第20章: Aggregate/Policy** | Aggregate Adapter, Choreography | @Aggregate, @EventHandler |
+| **第21章: Projection** | Read Model の更新、最小限フィールド | @EventHandler, MyBatis |
+| **第22章: REST API** | Inbound Adapter, テスト | CommandGateway, Axon Test |
+
+### アーキテクチャの特徴
+
+```plantuml
+@startuml cqrs_summary
+skinparam backgroundColor #FEFEFE
+
+package "Command Side" {
+    [REST Controller] as RC1
+    [CommandGateway] as CG
+    [Aggregate Adapter] as AA
+    [Domain Model] as DM
+    [Event Store] as ES
+}
+
+package "Query Side" {
+    [REST Controller] as RC2
+    [MyBatis Mapper] as MB
+    [Read Model DB] as DB
+    [Projection] as P
+}
+
+RC1 --> CG : send(command)
+CG --> AA : @CommandHandler
+AA --> DM : ビジネスロジック
+DM --> AA : event
+AA --> ES : apply(event)
+ES --> P : @EventHandler
+P --> MB : insert/update
+MB --> DB : SQL
+
+RC2 --> MB : query
+MB --> DB : SELECT
+
+note right of DM
+  純粋なドメインモデル
+  Axon に依存しない
+end note
+
+note right of P
+  イベントを購読して
+  MyBatis 経由で
+  Read Model を更新
+end note
+
+@enduml
+```
+
+### 設計上の特徴
+
+| 特徴 | 説明 |
+|------|------|
+| **ドメインモデルとフレームワークの分離** | `Order.java` は純粋なドメインモデル、`OrderAggregateAdapter.java` は Axon 用アダプター |
+| **Choreography による疎結合** | 各 Context は独立して動作、イベントを介した非同期連携 |
+| **sealed interface による型安全性** | イベントの網羅性チェック、switch 式でコンパイル時検証 |
+| **record によるイミュータブル設計** | 状態変更は常に新しいインスタンスを生成 |
+| **最小限フィールドの原則** | ドメインモデルは状態遷移判定に必要な最小限のみ保持 |
+| **MyBatis による柔軟な SQL 制御** | Read Model の更新に MyBatis Mapper を使用 |
+
+### 技術スタック
+
+| カテゴリ | 技術 |
+|---------|------|
+| **言語** | Java 21 |
+| **フレームワーク** | Spring Boot 3.4.1 |
+| **CQRS/ES** | Axon Framework 4.10.3 |
+| **ORM** | MyBatis 3.0.4 |
+| **データベース** | H2 / PostgreSQL |
+| **テスト** | JUnit 5, Axon Test |
+
+### API 形式の比較
+
+| 観点 | REST API | gRPC | GraphQL | CQRS/ES |
+|------|----------|------|---------|---------|
+| **書き込みモデル** | 同一 | 同一 | 同一 | 分離（Command） |
+| **読み取りモデル** | 同一 | 同一 | 同一 | 分離（Query） |
+| **履歴保持** | 別途実装 | 別途実装 | 別途実装 | 標準搭載 |
+| **監査証跡** | 別途実装 | 別途実装 | 別途実装 | 標準搭載 |
+| **スケーラビリティ** | 中 | 高 | 中 | 非常に高 |
+| **複雑性** | 低 | 中 | 中 | 高 |
+
+### CQRS/ES を選択する場面
+
+1. **監査要件**: すべての状態変更の履歴が必要
+2. **複雑なドメイン**: ビジネスロジックが複雑で、書き込みと読み取りの要件が異なる
+3. **高いスケーラビリティ**: 読み取りと書き込みを独立してスケールしたい
+4. **イベント駆動アーキテクチャ**: マイクロサービス間の連携にイベントを使用
+5. **時間旅行**: 過去の任意の時点の状態を再構築したい
+
+CQRS/ES は導入コストが高いですが、監査要件や複雑なドメインを持つシステムでは、その恩恵は大きくなります。Axon Framework を使用することで、イベントソーシングと CQRS の複雑さを軽減し、ドメインロジックに集中できます。MyBatis を使用することで、Read Model の更新において柔軟な SQL 制御が可能になります。