@k2works/claude-code-booster 4.4.2 → 4.6.0

package/lib/assets/docs/article/practical-database-design/study/study3-4.md

@@ -1,2106 +1,2106 @@
-# 研究 4：GraphQL サービスの実装
-
-## はじめに
-
-本パートでは、REST API や gRPC とは異なるアプローチとして、**GraphQL** による財務会計システムを実装します。クライアントが必要なデータを正確に指定できる柔軟なクエリと、リアルタイム更新を実現する Subscription を活用します。
-
-ヘキサゴナルアーキテクチャ（ドメイン層・アプリケーション層）はそのまま共有し、**Input Adapter として GraphQL リゾルバ層のみを追加**します。
-
----
-
-## 第 22 章：GraphQL サーバーの基礎
-
-### 22.1 GraphQL とは
-
-GraphQL は Facebook が開発したクエリ言語および実行エンジンです。クライアントが必要なデータの形状を指定でき、Over-fetching（不要なデータの取得）や Under-fetching（必要なデータの不足）を防ぎます。
-
-```plantuml
-@startuml graphql_architecture
-!define RECTANGLE class
-
-skinparam backgroundColor #FEFEFE
-
-package "GraphQL Architecture (財務会計システム)" {
-
-  package "Client Side" {
-    RECTANGLE "GraphQL Client\n(Apollo/Relay/urql)" as client {
-      - Query (読み取り)
-      - Mutation (書き込み)
-      - Subscription (リアルタイム)
-    }
-  }
-
-  package "Server Side" {
-    RECTANGLE "GraphQL Server\n(Spring for GraphQL)" as server {
-      - AccountResolver
-      - JournalResolver
-      - BalanceResolver
-      - ReportResolver
-    }
-  }
-
-  package "Shared" {
-    RECTANGLE "GraphQL Schema\n(.graphqls files)" as schema {
-      - schema.graphqls
-      - account.graphqls
-      - journal.graphqls
-      - balance.graphqls
-      - report.graphqls
-    }
-  }
-}
-
-client --> schema : "スキーマに基づいて\nクエリを構築"
-server --> schema : "スキーマに基づいて\nリゾルバを実装"
-client <--> server : "HTTP/WebSocket\n(JSON)"
-
-note bottom of schema
-  スキーマ駆動開発
-  クライアント主導のデータ取得
-  型安全な API
-end note
-
-@enduml
-```
-
-**REST API / gRPC / GraphQL の比較：**
-
-| 特徴 | REST API | gRPC | GraphQL |
-|------|----------|------|---------|
-| プロトコル | HTTP/1.1 | HTTP/2 | HTTP/1.1 or HTTP/2 |
-| データ形式 | JSON | Protocol Buffers | JSON |
-| スキーマ | OpenAPI (任意) | .proto (必須) | .graphqls (必須) |
-| データ取得 | 固定レスポンス | 固定レスポンス | クライアント指定 |
-| エンドポイント | 複数 | 複数 | 単一 |
-| リアルタイム | WebSocket 別実装 | ストリーミング | Subscription |
-| 主な用途 | 汎用 API | マイクロサービス | フロントエンド向け |
-
-### 22.2 3 つの操作タイプ
-
-GraphQL は 3 つの操作タイプをサポートします：
-
-```plantuml
-@startuml graphql_operations
-skinparam backgroundColor #FEFEFE
-
-rectangle "1. Query\n(読み取り)" as query #LightBlue {
-}
-note right of query
-  { accounts { code name category } }
-  → { accounts: [...] }
-
-  データの取得
-  複数リソースを1回で取得可能
-end note
-
-rectangle "2. Mutation\n(書き込み)" as mutation #LightGreen {
-}
-note right of mutation
-  mutation { createJournal(...) }
-  → { createJournal: {...} }
-
-  データの作成・更新・削除
-end note
-
-rectangle "3. Subscription\n(リアルタイム)" as subscription #LightCoral {
-}
-note right of subscription
-  subscription { balanceChanged }
-  → (WebSocket でプッシュ通知)
-
-  リアルタイム更新の受信
-end note
-
-query -[hidden]-> mutation
-mutation -[hidden]-> subscription
-
-@enduml
-```
-
-**用途：**
-
-1. **Query**: データ取得（勘定科目一覧、仕訳照会、残高照会）
-2. **Mutation**: データ更新（仕訳登録、仕訳取消、決算仕訳）
-3. **Subscription**: リアルタイム通知（残高変動、仕訳登録通知）
-
-### 22.3 GraphQL におけるヘキサゴナルアーキテクチャ
-
-GraphQL を導入しても、ヘキサゴナルアーキテクチャ（ドメイン層・アプリケーション層）はそのまま共有し、**Input Adapter として GraphQL リゾルバ層のみを追加**します。
-
-```plantuml
-@startuml hexagonal_graphql
-!define RECTANGLE class
-
-package "Hexagonal Architecture (GraphQL版)" {
-
-  RECTANGLE "Application Core\n(Domain + Use Cases)" as core {
-    - Account (勘定科目)
-    - Journal (仕訳)
-    - DailyBalance (日次残高)
-    - MonthlyBalance (月次残高)
-    - AccountUseCase
-    - JournalUseCase
-    - BalanceUseCase
-  }
-
-  RECTANGLE "Input Adapters\n(Driving Side)" as input {
-    - REST Controller（既存）
-    - gRPC Service（既存）
-    - GraphQL Resolver（新規追加）
-    - DataFetcher
-    - DataLoader
-  }
-
-  RECTANGLE "Output Adapters\n(Driven Side)" as output {
-    - MyBatis Repository
-    - Database Access
-    - Entity Mapping
-  }
-}
-
-input --> core : "Input Ports\n(Use Cases)"
-core --> output : "Output Ports\n(Repository Interfaces)"
-
-note top of core
-  既存のビジネスロジック
-  REST API / gRPC 版と完全に共有
-  GraphQL 固有のコードは含まない
-end note
-
-note left of input
-  GraphQL リゾルバを
-  Input Adapter として追加
-  既存の REST/gRPC と共存可能
-end note
-
-note right of output
-  既存の Repository を
-  そのまま使用
-  変更不要
-end note
-
-@enduml
-```
-
-### 22.4 ディレクトリ構成
-
-既存の構成に `infrastructure/graphql/` を追加するだけです。
-
-```
-src/main/java/com/example/accounting/
-├── domain/                     # ドメイン層（API版と共通）
-│   ├── model/
-│   │   ├── account/
-│   │   ├── journal/
-│   │   ├── balance/
-│   │   └── report/
-│   └── exception/
-│
-├── application/               # アプリケーション層（API版と共通）
-│   ├── port/
-│   │   ├── in/               # Input Port（ユースケース）
-│   │   └── out/              # Output Port（リポジトリ）
-│   └── service/
-│
-├── infrastructure/
-│   ├── persistence/          # Output Adapter（DB実装）- 既存
-│   │   ├── mapper/
-│   │   └── repository/
-│   ├── rest/                 # Input Adapter（REST実装）- 既存
-│   ├── grpc/                 # Input Adapter（gRPC実装）- 既存
-│   └── graphql/              # Input Adapter（GraphQL実装）- 新規追加
-│       ├── resolver/         # Query/Mutation リゾルバ
-│       ├── dataloader/       # N+1 問題対策
-│       ├── scalar/           # カスタムスカラー型
-│       └── subscription/     # Subscription ハンドラ
-│
-├── config/
-│
-└── src/main/resources/
-    └── graphql/              # GraphQL スキーマ定義
-        ├── schema.graphqls
-        ├── account.graphqls
-        ├── journal.graphqls
-        ├── balance.graphqls
-        └── report.graphqls
-```
-
-### 22.5 技術スタックの追加
-
-既存の `build.gradle.kts` に GraphQL 関連の依存関係を追加します。
-
-<details>
-<summary>build.gradle.kts（差分）</summary>
-
-```kotlin
-dependencies {
-    // 既存の依存関係（Spring Boot, MyBatis, PostgreSQL等）はそのまま
-
-    // GraphQL 関連を追加
-    implementation("org.springframework.boot:spring-boot-starter-graphql")
-    implementation("org.springframework.boot:spring-boot-starter-websocket")  // Subscription 用
-
-    // GraphQL 拡張
-    implementation("com.graphql-java:graphql-java-extended-scalars:21.0")
-
-    // Test
-    testImplementation("org.springframework.graphql:spring-graphql-test")
-}
-```
-
-</details>
-
-**追加パッケージの説明：**
-
-| パッケージ | 用途 |
-|-----------|------|
-| spring-boot-starter-graphql | Spring Boot GraphQL 統合 |
-| spring-boot-starter-websocket | Subscription (WebSocket) |
-| graphql-java-extended-scalars | DateTime, BigDecimal 等のスカラー型 |
-| spring-graphql-test | GraphQL テストサポート |
-
-### 22.6 GraphQL 設定
-
-<details>
-<summary>application.yml（差分）</summary>
-
-```yaml
-spring:
-  graphql:
-    graphiql:
-      enabled: true
-      path: /graphiql
-    websocket:
-      path: /graphql
-    schema:
-      printer:
-        enabled: true
-      locations:
-        - classpath:graphql/
-    cors:
-      allowed-origins: "*"
-      allowed-methods: GET, POST
-```
-
-</details>
-
-<details>
-<summary>GraphQLConfig.java</summary>
-
-```java
-package com.example.accounting.config;
-
-import graphql.scalars.ExtendedScalars;
-import graphql.schema.idl.RuntimeWiring;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.graphql.execution.RuntimeWiringConfigurer;
-
-/**
- * GraphQL 設定
- */
-@Configuration
-public class GraphQLConfig {
-
-    @Bean
-    public RuntimeWiringConfigurer runtimeWiringConfigurer() {
-        return wiringBuilder -> wiringBuilder
-            .scalar(ExtendedScalars.Date)
-            .scalar(ExtendedScalars.DateTime)
-            .scalar(ExtendedScalars.GraphQLBigDecimal)
-            .scalar(ExtendedScalars.GraphQLLong);
-    }
-}
-```
-
-</details>
-
----
-
-## 第 23 章：GraphQL スキーマの定義
-
-### 23.1 ルートスキーマ
-
-<details>
-<summary>src/main/resources/graphql/schema.graphqls</summary>
-
-```graphql
-# ルートスキーマ
-type Query {
-    # 勘定科目
-    account(accountCode: ID!): Account
-    accounts(bsplCategory: BSPLCategory, page: Int, size: Int): AccountConnection!
-    accountHierarchy(accountCode: ID!): [Account!]!
-
-    # 課税取引
-    taxTransaction(taxCode: ID!): TaxTransaction
-    taxTransactions: [TaxTransaction!]!
-
-    # 勘定科目構成
-    accountConfig(accountCode: ID!): AccountConfig
-    accountConfigs(parentPath: String): [AccountConfig!]!
-
-    # 仕訳
-    journal(journalNumber: ID!): Journal
-    journals(fromDate: Date, toDate: Date, accountCode: ID, page: Int, size: Int): JournalConnection!
-
-    # 残高
-    dailyBalance(date: Date!, accountCode: ID!, subAccountCode: ID): DailyBalance
-    dailyBalances(date: Date!, page: Int, size: Int): DailyBalanceConnection!
-
-    monthlyBalance(fiscalYear: Int!, month: Int!, accountCode: ID!, subAccountCode: ID): MonthlyBalance
-    monthlyBalances(fiscalYear: Int!, month: Int!, page: Int, size: Int): MonthlyBalanceConnection!
-
-    # 帳票
-    dailyReport(date: Date!): DailyReport!
-    trialBalance(fiscalYear: Int!, month: Int!): TrialBalance!
-    financialStatements(fiscalYear: Int!): FinancialStatements!
-}
-
-type Mutation {
-    # 勘定科目
-    createAccount(input: CreateAccountInput!): Account!
-    updateAccount(input: UpdateAccountInput!): Account!
-    deleteAccount(accountCode: ID!): Boolean!
-
-    # 課税取引
-    createTaxTransaction(input: CreateTaxTransactionInput!): TaxTransaction!
-    updateTaxTransaction(input: UpdateTaxTransactionInput!): TaxTransaction!
-    deleteTaxTransaction(taxCode: ID!): Boolean!
-
-    # 仕訳
-    createJournal(input: CreateJournalInput!): Journal!
-    updateJournal(input: UpdateJournalInput!): Journal!
-    deleteJournal(journalNumber: ID!): Boolean!
-    reverseJournal(journalNumber: ID!, reason: String): Journal!
-
-    # 残高更新
-    recalculateDailyBalance(date: Date!): RecalculateResult!
-    recalculateMonthlyBalance(fiscalYear: Int!, month: Int!): RecalculateResult!
-
-    # 決算処理
-    executeClosing(input: ExecuteClosingInput!): ClosingResult!
-}
-
-type Subscription {
-    # 残高変動
-    balanceChanged(accountCode: ID): BalanceChange!
-
-    # 仕訳登録通知
-    journalCreated: JournalNotification!
-
-    # 決算処理進捗
-    closingProgressUpdated(closingId: ID!): ClosingProgress!
-}
-
-# ページネーション共通型
-type PageInfo {
-    hasNextPage: Boolean!
-    hasPreviousPage: Boolean!
-    totalElements: Int!
-    totalPages: Int!
-    currentPage: Int!
-}
-
-# カスタムスカラー
-scalar Date
-scalar DateTime
-scalar BigDecimal
-scalar Long
-```
-
-</details>
-
-### 23.2 勘定科目スキーマ
-
-<details>
-<summary>src/main/resources/graphql/account.graphqls</summary>
-
-```graphql
-# BSPL区分
-enum BSPLCategory {
-    BS      # 貸借対照表
-    PL      # 損益計算書
-}
-
-# 貸借区分
-enum DebitCreditCategory {
-    DEBIT   # 借方
-    CREDIT  # 貸方
-}
-
-# 取引要素区分
-enum TransactionElementCategory {
-    ASSET       # 資産
-    LIABILITY   # 負債
-    CAPITAL     # 資本
-    REVENUE     # 収益
-    EXPENSE     # 費用
-}
-
-# 集計区分
-enum AggregationCategory {
-    HEADING     # 見出科目
-    SUBTOTAL    # 集計科目
-    POSTING     # 計上科目
-}
-
-# 勘定科目
-type Account {
-    accountCode: ID!
-    accountName: String!
-    accountShortName: String
-    accountKana: String
-    bsplCategory: BSPLCategory!
-    debitCreditCategory: DebitCreditCategory!
-    transactionElementCategory: TransactionElementCategory!
-    aggregationCategory: AggregationCategory!
-    managementAccountingCategory: String
-    expenseCategory: String
-    ledgerOutputCategory: String
-    subAccountType: String
-    taxCalculationCategory: String
-    taxTransactionCode: ID
-    dueDateManagementCategory: String
-    createdAt: DateTime!
-    updatedAt: DateTime!
-    updatedBy: String
-
-    # 関連データ（必要な場合のみ取得）
-    taxTransaction: TaxTransaction
-    accountConfig: AccountConfig
-    childAccounts: [Account!]!
-    dailyBalances(date: Date): [DailyBalance!]!
-    monthlyBalances(fiscalYear: Int, month: Int): [MonthlyBalance!]!
-}
-
-# 勘定科目一覧（ページネーション付き）
-type AccountConnection {
-    edges: [AccountEdge!]!
-    pageInfo: PageInfo!
-}
-
-type AccountEdge {
-    node: Account!
-    cursor: String!
-}
-
-# 課税取引マスタ
-type TaxTransaction {
-    taxCode: ID!
-    taxName: String!
-    taxRate: BigDecimal!
-    updatedAt: DateTime!
-    updatedBy: String
-
-    # 関連データ
-    accounts: [Account!]!
-}
-
-# 勘定科目構成マスタ
-type AccountConfig {
-    accountCode: ID!
-    accountPath: String!
-    updatedAt: DateTime!
-    updatedBy: String
-
-    # 関連データ
-    account: Account!
-    parentAccount: Account
-    childAccounts: [Account!]!
-}
-
-# 入力型
-input CreateAccountInput {
-    accountCode: ID!
-    accountName: String!
-    accountShortName: String
-    accountKana: String
-    bsplCategory: BSPLCategory!
-    debitCreditCategory: DebitCreditCategory!
-    transactionElementCategory: TransactionElementCategory!
-    aggregationCategory: AggregationCategory!
-    managementAccountingCategory: String
-    expenseCategory: String
-    ledgerOutputCategory: String
-    subAccountType: String
-    taxCalculationCategory: String
-    taxTransactionCode: ID
-    dueDateManagementCategory: String
-}
-
-input UpdateAccountInput {
-    accountCode: ID!
-    accountName: String
-    accountShortName: String
-    accountKana: String
-    bsplCategory: BSPLCategory
-    debitCreditCategory: DebitCreditCategory
-    transactionElementCategory: TransactionElementCategory
-    aggregationCategory: AggregationCategory
-    managementAccountingCategory: String
-    expenseCategory: String
-    ledgerOutputCategory: String
-    subAccountType: String
-    taxCalculationCategory: String
-    taxTransactionCode: ID
-    dueDateManagementCategory: String
-}
-```
-
-</details>
-
-### 23.3 仕訳スキーマ
-
-<details>
-<summary>src/main/resources/graphql/journal.graphqls</summary>
-
-```graphql
-# 仕訳伝票区分
-enum JournalVoucherType {
-    NORMAL          # 通常仕訳
-    ADJUSTMENT      # 調整仕訳
-    CLOSING         # 決算仕訳
-}
-
-# 仕訳
-type Journal {
-    journalNumber: ID!
-    postingDate: Date!
-    entryDate: Date!
-    isClosingEntry: Boolean!
-    isSingleEntry: Boolean!
-    voucherType: JournalVoucherType!
-    isRecurring: Boolean!
-    employeeCode: String
-    departmentCode: String
-    isReversal: Boolean!
-    reversalJournalNumber: ID
-    createdAt: DateTime!
-    updatedAt: DateTime!
-
-    # 関連データ
-    details: [JournalDetail!]!
-    department: Department
-    totalDebitAmount: BigDecimal!
-    totalCreditAmount: BigDecimal!
-    isBalanced: Boolean!
-}
-
-# 仕訳明細
-type JournalDetail {
-    journalNumber: ID!
-    lineNumber: Int!
-    description: String
-    createdAt: DateTime!
-    updatedAt: DateTime!
-
-    # 関連データ
-    debitCreditDetails: [JournalDebitCreditDetail!]!
-}
-
-# 仕訳貸借明細
-type JournalDebitCreditDetail {
-    journalNumber: ID!
-    lineNumber: Int!
-    debitCreditCategory: DebitCreditCategory!
-    currencyCode: String
-    exchangeRate: BigDecimal
-    departmentCode: String
-    projectCode: String
-    accountCode: ID!
-    subAccountCode: String
-    amount: BigDecimal!
-    baseAmount: BigDecimal!
-    taxCategory: String
-    taxRate: BigDecimal
-    taxCalculationCategory: String
-    dueDate: Date
-    cashFlowFlag: Boolean
-    segmentCode: String
-    counterAccountCode: String
-    counterSubAccountCode: String
-    tagCode: String
-    tagDescription: String
-    createdAt: DateTime!
-    updatedAt: DateTime!
-
-    # 関連データ
-    account: Account!
-    counterAccount: Account
-}
-
-# 仕訳一覧
-type JournalConnection {
-    edges: [JournalEdge!]!
-    pageInfo: PageInfo!
-}
-
-type JournalEdge {
-    node: Journal!
-    cursor: String!
-}
-
-# 仕訳登録通知イベント
-type JournalNotification {
-    journalNumber: ID!
-    postingDate: Date!
-    totalDebitAmount: BigDecimal!
-    totalCreditAmount: BigDecimal!
-    createdBy: String
-    createdAt: DateTime!
-}
-
-# 入力型
-input CreateJournalInput {
-    postingDate: Date!
-    isClosingEntry: Boolean
-    isSingleEntry: Boolean
-    voucherType: JournalVoucherType
-    isRecurring: Boolean
-    employeeCode: String
-    departmentCode: String
-    details: [JournalDetailInput!]!
-}
-
-input JournalDetailInput {
-    lineNumber: Int!
-    description: String
-    debitCreditDetails: [JournalDebitCreditDetailInput!]!
-}
-
-input JournalDebitCreditDetailInput {
-    debitCreditCategory: DebitCreditCategory!
-    currencyCode: String
-    exchangeRate: BigDecimal
-    departmentCode: String
-    projectCode: String
-    accountCode: ID!
-    subAccountCode: String
-    amount: BigDecimal!
-    baseAmount: BigDecimal
-    taxCategory: String
-    taxRate: BigDecimal
-    dueDate: Date
-    segmentCode: String
-    counterAccountCode: String
-    tagCode: String
-    tagDescription: String
-}
-```
-
-</details>
-
-### 23.4 残高・帳票スキーマ
-
-<details>
-<summary>src/main/resources/graphql/balance.graphqls</summary>
-
-```graphql
-# 日次勘定科目残高
-type DailyBalance {
-    postingDate: Date!
-    accountCode: ID!
-    subAccountCode: String
-    departmentCode: String
-    projectCode: String
-    isClosingEntry: Boolean!
-    debitAmount: BigDecimal!
-    creditAmount: BigDecimal!
-    balance: BigDecimal!
-
-    # 関連データ
-    account: Account!
-}
-
-# 日次残高一覧
-type DailyBalanceConnection {
-    edges: [DailyBalanceEdge!]!
-    pageInfo: PageInfo!
-}
-
-type DailyBalanceEdge {
-    node: DailyBalance!
-    cursor: String!
-}
-
-# 月次勘定科目残高
-type MonthlyBalance {
-    fiscalYear: Int!
-    month: Int!
-    accountCode: ID!
-    subAccountCode: String
-    departmentCode: String
-    projectCode: String
-    isClosingEntry: Boolean!
-    beginningBalance: BigDecimal!
-    debitAmount: BigDecimal!
-    creditAmount: BigDecimal!
-    endingBalance: BigDecimal!
-
-    # 関連データ
-    account: Account!
-}
-
-# 残高変動イベント
-type BalanceChange {
-    accountCode: ID!
-    accountName: String!
-    changeType: BalanceChangeType!
-    previousBalance: BigDecimal!
-    currentBalance: BigDecimal!
-    changeAmount: BigDecimal!
-    timestamp: DateTime!
-}
-
-enum BalanceChangeType {
-    DEBIT       # 借方記入
-    CREDIT      # 貸方記入
-    ADJUSTMENT  # 調整
-    CLOSING     # 決算
-}
-
-# 再計算結果
-type RecalculateResult {
-    processedCount: Int!
-    updatedAccounts: [String!]!
-    timestamp: DateTime!
-}
-```
-
-</details>
-
-<details>
-<summary>src/main/resources/graphql/report.graphqls</summary>
-
-```graphql
-# 日計表
-type DailyReport {
-    reportDate: Date!
-    entries: [DailyReportEntry!]!
-    totalDebitAmount: BigDecimal!
-    totalCreditAmount: BigDecimal!
-    generatedAt: DateTime!
-}
-
-type DailyReportEntry {
-    accountCode: ID!
-    accountName: String!
-    debitAmount: BigDecimal!
-    creditAmount: BigDecimal!
-    balance: BigDecimal!
-}
-
-# 合計残高試算表
-type TrialBalance {
-    fiscalYear: Int!
-    month: Int!
-    entries: [TrialBalanceEntry!]!
-    totalDebitAmount: BigDecimal!
-    totalCreditAmount: BigDecimal!
-    totalDebitBalance: BigDecimal!
-    totalCreditBalance: BigDecimal!
-    generatedAt: DateTime!
-}
-
-type TrialBalanceEntry {
-    accountCode: ID!
-    accountName: String!
-    bsplCategory: BSPLCategory!
-    debitAmount: BigDecimal!
-    creditAmount: BigDecimal!
-    debitBalance: BigDecimal!
-    creditBalance: BigDecimal!
-}
-
-# 財務諸表
-type FinancialStatements {
-    fiscalYear: Int!
-    balanceSheet: BalanceSheet!
-    incomeStatement: IncomeStatement!
-    generatedAt: DateTime!
-}
-
-# 貸借対照表
-type BalanceSheet {
-    fiscalYear: Int!
-    assetEntries: [FinancialStatementEntry!]!
-    liabilityEntries: [FinancialStatementEntry!]!
-    capitalEntries: [FinancialStatementEntry!]!
-    totalAssets: BigDecimal!
-    totalLiabilities: BigDecimal!
-    totalCapital: BigDecimal!
-}
-
-# 損益計算書
-type IncomeStatement {
-    fiscalYear: Int!
-    revenueEntries: [FinancialStatementEntry!]!
-    expenseEntries: [FinancialStatementEntry!]!
-    totalRevenue: BigDecimal!
-    totalExpense: BigDecimal!
-    netIncome: BigDecimal!
-}
-
-type FinancialStatementEntry {
-    accountCode: ID!
-    accountName: String!
-    level: Int!
-    amount: BigDecimal!
-    isSubtotal: Boolean!
-}
-
-# 決算処理結果
-type ClosingResult {
-    closingId: ID!
-    fiscalYear: Int!
-    processedJournalCount: Int!
-    closingJournals: [Journal!]!
-    completedAt: DateTime!
-}
-
-# 決算処理進捗
-type ClosingProgress {
-    closingId: ID!
-    status: ClosingStatus!
-    currentStep: String!
-    processedCount: Int!
-    totalCount: Int!
-    progressPercent: Float!
-    updatedAt: DateTime!
-}
-
-enum ClosingStatus {
-    PROCESSING  # 処理中
-    COMPLETED   # 完了
-    FAILED      # 失敗
-}
-```
-
-</details>
-
----
-
-## 第 24 章：マスタ API の実装
-
-### 24.1 Query リゾルバ
-
-<details>
-<summary>QueryResolver.java</summary>
-
-```java
-package com.example.accounting.infrastructure.graphql.resolver;
-
-import com.example.accounting.application.port.in.AccountUseCase;
-import com.example.accounting.application.port.in.JournalUseCase;
-import com.example.accounting.application.port.in.BalanceUseCase;
-import com.example.accounting.domain.model.account.Account;
-import com.example.accounting.domain.model.account.TaxTransaction;
-import com.example.accounting.domain.model.account.AccountConfig;
-import com.example.accounting.infrastructure.graphql.dto.*;
-import org.springframework.graphql.data.method.annotation.Argument;
-import org.springframework.graphql.data.method.annotation.QueryMapping;
-import org.springframework.stereotype.Controller;
-
-import java.util.List;
-
-/**
- * GraphQL Query リゾルバ
- */
-@Controller
-public class QueryResolver {
-
-    private final AccountUseCase accountUseCase;
-    private final JournalUseCase journalUseCase;
-    private final BalanceUseCase balanceUseCase;
-
-    public QueryResolver(
-            AccountUseCase accountUseCase,
-            JournalUseCase journalUseCase,
-            BalanceUseCase balanceUseCase) {
-        this.accountUseCase = accountUseCase;
-        this.journalUseCase = journalUseCase;
-        this.balanceUseCase = balanceUseCase;
-    }
-
-    // === 勘定科目 ===
-
-    @QueryMapping
-    public Account account(@Argument String accountCode) {
-        return accountUseCase.findByCode(accountCode)
-            .orElse(null);
-    }
-
-    @QueryMapping
-    public AccountConnection accounts(
-            @Argument String bsplCategory,
-            @Argument Integer page,
-            @Argument Integer size) {
-
-        int pageNum = page != null ? page : 0;
-        int pageSize = size != null ? size : 20;
-
-        List<Account> accounts = accountUseCase.findAll(bsplCategory, pageNum, pageSize);
-        long totalCount = accountUseCase.count(bsplCategory);
-
-        return AccountConnection.of(accounts, pageNum, pageSize, totalCount);
-    }
-
-    @QueryMapping
-    public List<Account> accountHierarchy(@Argument String accountCode) {
-        return accountUseCase.findHierarchy(accountCode);
-    }
-
-    // === 課税取引 ===
-
-    @QueryMapping
-    public TaxTransaction taxTransaction(@Argument String taxCode) {
-        return accountUseCase.findTaxTransaction(taxCode)
-            .orElse(null);
-    }
-
-    @QueryMapping
-    public List<TaxTransaction> taxTransactions() {
-        return accountUseCase.findAllTaxTransactions();
-    }
-
-    // === 勘定科目構成 ===
-
-    @QueryMapping
-    public AccountConfig accountConfig(@Argument String accountCode) {
-        return accountUseCase.findAccountConfig(accountCode)
-            .orElse(null);
-    }
-
-    @QueryMapping
-    public List<AccountConfig> accountConfigs(@Argument String parentPath) {
-        if (parentPath != null) {
-            return accountUseCase.findAccountConfigsByPath(parentPath);
-        }
-        return accountUseCase.findAllAccountConfigs();
-    }
-}
-```
-
-</details>
-
-### 24.2 N+1 問題とは
-
-GraphQL では、ネストしたデータを取得する際に **N+1 問題** が発生しやすくなります。
-
-```plantuml
-@startuml n_plus_1_problem
-
-title N+1 問題の発生パターン
-
-participant "GraphQL Client" as client
-participant "AccountResolver" as resolver
-participant "TaxTransactionRepository" as repo
-database "PostgreSQL" as db
-
-client -> resolver : accounts(first: 10)
-resolver -> db : SELECT * FROM 勘定科目マスタ LIMIT 10
-db --> resolver : 10件の勘定科目
-
-loop 各勘定科目に対して（N回）
-  resolver -> repo : findByCode(taxCode)
-  repo -> db : SELECT * FROM 課税取引マスタ WHERE 課税取引コード = ?
-  db --> repo : 課税取引データ
-  repo --> resolver : 課税取引
-end
-
-resolver --> client : 勘定科目一覧（課税取引付き）
-
-note right of db
-  合計 11回のクエリ
-  (1 + N = 1 + 10)
-
-  勘定科目が100件なら101回！
-end note
-
-@enduml
-```
-
-### 24.3 DataLoader による解決
-
-**DataLoader** は、複数の個別リクエストをバッチ処理にまとめることで N+1 問題を解決します。
-
-```plantuml
-@startuml dataloader_solution
-
-title DataLoader による N+1 問題の解決
-
-participant "GraphQL Client" as client
-participant "AccountResolver" as resolver
-participant "TaxTransactionDataLoader" as loader
-participant "TaxTransactionRepository" as repo
-database "PostgreSQL" as db
-
-client -> resolver : accounts(first: 10)
-resolver -> db : SELECT * FROM 勘定科目マスタ LIMIT 10
-db --> resolver : 10件の勘定科目
-
-loop 各勘定科目に対して
-  resolver -> loader : load(taxCode)
-  note right of loader : キューに追加
-end
-
-loader -> repo : loadMany([code1, code2, ...code10])
-repo -> db : SELECT * FROM 課税取引マスタ WHERE 課税取引コード IN (?, ?, ..., ?)
-db --> repo : 課税取引データ
-repo --> loader : Map<課税取引コード, 課税取引>
-loader --> resolver : 各勘定科目の課税取引
-
-resolver --> client : 勘定科目一覧（課税取引付き）
-
-note right of db
-  合計 2回のクエリ
-  (1 + 1 = 2)
-
-  勘定科目が100件でも2回！
-end note
-
-@enduml
-```
-
-<details>
-<summary>TaxTransactionDataLoader.java</summary>
-
-```java
-package com.example.accounting.infrastructure.graphql.dataloader;
-
-import com.example.accounting.application.port.out.AccountRepository;
-import com.example.accounting.domain.model.account.TaxTransaction;
-import org.dataloader.BatchLoaderEnvironment;
-import org.dataloader.MappedBatchLoader;
-import org.springframework.stereotype.Component;
-
-import java.util.Map;
-import java.util.Set;
-import java.util.concurrent.CompletableFuture;
-import java.util.concurrent.CompletionStage;
-import java.util.function.Function;
-import java.util.stream.Collectors;
-
-/**
- * 課税取引データの DataLoader
- */
-@Component
-public class TaxTransactionDataLoader implements MappedBatchLoader<String, TaxTransaction> {
-
-    private final AccountRepository accountRepository;
-
-    public TaxTransactionDataLoader(AccountRepository accountRepository) {
-        this.accountRepository = accountRepository;
-    }
-
-    @Override
-    public CompletionStage<Map<String, TaxTransaction>> load(
-            Set<String> taxCodes,
-            BatchLoaderEnvironment environment) {
-
-        return CompletableFuture.supplyAsync(() -> {
-            return accountRepository.findTaxTransactionsByCodes(taxCodes).stream()
-                .collect(Collectors.toMap(
-                    TaxTransaction::getTaxCode,
-                    Function.identity()
-                ));
-        });
-    }
-}
-```
-
-</details>
-
-### 24.4 勘定科目リゾルバの実装
-
-<details>
-<summary>AccountResolver.java</summary>
-
-```java
-package com.example.accounting.infrastructure.graphql.resolver;
-
-import com.example.accounting.application.port.in.AccountUseCase;
-import com.example.accounting.config.DataLoaderConfig;
-import com.example.accounting.domain.model.account.Account;
-import com.example.accounting.domain.model.account.TaxTransaction;
-import com.example.accounting.domain.model.account.AccountConfig;
-import com.example.accounting.domain.model.balance.DailyBalance;
-import com.example.accounting.infrastructure.graphql.dto.*;
-import graphql.schema.DataFetchingEnvironment;
-import org.dataloader.DataLoader;
-import org.springframework.graphql.data.method.annotation.Argument;
-import org.springframework.graphql.data.method.annotation.MutationMapping;
-import org.springframework.graphql.data.method.annotation.QueryMapping;
-import org.springframework.graphql.data.method.annotation.SchemaMapping;
-import org.springframework.stereotype.Controller;
-
-import java.util.List;
-import java.util.concurrent.CompletableFuture;
-
-/**
- * 勘定科目 GraphQL リゾルバ
- */
-@Controller
-public class AccountResolver {
-
-    private final AccountUseCase accountUseCase;
-
-    public AccountResolver(AccountUseCase accountUseCase) {
-        this.accountUseCase = accountUseCase;
-    }
-
-    // === Query ===
-
-    @QueryMapping
-    public Account account(@Argument String accountCode) {
-        return accountUseCase.findByCode(accountCode).orElse(null);
-    }
-
-    @QueryMapping
-    public AccountConnection accounts(
-            @Argument String bsplCategory,
-            @Argument Integer page,
-            @Argument Integer size) {
-
-        int pageNum = page != null ? page : 0;
-        int pageSize = size != null ? size : 20;
-
-        List<Account> accounts = accountUseCase.findAll(bsplCategory, pageNum, pageSize);
-        long totalCount = accountUseCase.count(bsplCategory);
-
-        return AccountConnection.of(accounts, pageNum, pageSize, totalCount);
-    }
-
-    // === Mutation ===
-
-    @MutationMapping
-    public Account createAccount(@Argument CreateAccountInput input) {
-        Account account = Account.builder()
-            .accountCode(input.accountCode())
-            .accountName(input.accountName())
-            .accountShortName(input.accountShortName())
-            .bsplCategory(input.bsplCategory())
-            .debitCreditCategory(input.debitCreditCategory())
-            .transactionElementCategory(input.transactionElementCategory())
-            .aggregationCategory(input.aggregationCategory())
-            .taxTransactionCode(input.taxTransactionCode())
-            .build();
-
-        return accountUseCase.create(account);
-    }
-
-    @MutationMapping
-    public boolean deleteAccount(@Argument String accountCode) {
-        return accountUseCase.delete(accountCode);
-    }
-
-    // === フィールドリゾルバ（DataLoader 使用）===
-
-    @SchemaMapping(typeName = "Account", field = "taxTransaction")
-    public CompletableFuture<TaxTransaction> taxTransaction(
-            Account account,
-            DataFetchingEnvironment env) {
-
-        if (account.getTaxTransactionCode() == null) {
-            return CompletableFuture.completedFuture(null);
-        }
-
-        DataLoader<String, TaxTransaction> loader =
-            env.getDataLoader(DataLoaderConfig.TAX_TRANSACTION_LOADER);
-
-        return loader.load(account.getTaxTransactionCode());
-    }
-
-    @SchemaMapping(typeName = "Account", field = "accountConfig")
-    public CompletableFuture<AccountConfig> accountConfig(
-            Account account,
-            DataFetchingEnvironment env) {
-
-        DataLoader<String, AccountConfig> loader =
-            env.getDataLoader(DataLoaderConfig.ACCOUNT_CONFIG_LOADER);
-
-        return loader.load(account.getAccountCode());
-    }
-
-    @SchemaMapping(typeName = "Account", field = "childAccounts")
-    public List<Account> childAccounts(Account account) {
-        return accountUseCase.findChildAccounts(account.getAccountCode());
-    }
-}
-```
-
-</details>
-
----
-
-## 第 25 章：トランザクション API の実装
-
-### 25.1 仕訳リゾルバの実装
-
-<details>
-<summary>JournalResolver.java</summary>
-
-```java
-package com.example.accounting.infrastructure.graphql.resolver;
-
-import com.example.accounting.application.port.in.JournalUseCase;
-import com.example.accounting.config.DataLoaderConfig;
-import com.example.accounting.domain.model.journal.Journal;
-import com.example.accounting.domain.model.journal.JournalDetail;
-import com.example.accounting.domain.model.journal.JournalDebitCreditDetail;
-import com.example.accounting.domain.model.account.Account;
-import com.example.accounting.infrastructure.graphql.dto.*;
-import graphql.schema.DataFetchingEnvironment;
-import org.dataloader.DataLoader;
-import org.springframework.graphql.data.method.annotation.Argument;
-import org.springframework.graphql.data.method.annotation.MutationMapping;
-import org.springframework.graphql.data.method.annotation.QueryMapping;
-import org.springframework.graphql.data.method.annotation.SchemaMapping;
-import org.springframework.stereotype.Controller;
-
-import java.math.BigDecimal;
-import java.time.LocalDate;
-import java.util.List;
-import java.util.concurrent.CompletableFuture;
-
-/**
- * 仕訳 GraphQL リゾルバ
- */
-@Controller
-public class JournalResolver {
-
-    private final JournalUseCase journalUseCase;
-
-    public JournalResolver(JournalUseCase journalUseCase) {
-        this.journalUseCase = journalUseCase;
-    }
-
-    // === Query ===
-
-    @QueryMapping
-    public Journal journal(@Argument String journalNumber) {
-        return journalUseCase.findByNumber(journalNumber).orElse(null);
-    }
-
-    @QueryMapping
-    public JournalConnection journals(
-            @Argument LocalDate fromDate,
-            @Argument LocalDate toDate,
-            @Argument String accountCode,
-            @Argument Integer page,
-            @Argument Integer size) {
-
-        int pageNum = page != null ? page : 0;
-        int pageSize = size != null ? size : 20;
-
-        List<Journal> journals = journalUseCase.findAll(
-            fromDate, toDate, accountCode, pageNum, pageSize);
-        long totalCount = journalUseCase.count(fromDate, toDate, accountCode);
-
-        return JournalConnection.of(journals, pageNum, pageSize, totalCount);
-    }
-
-    // === Mutation ===
-
-    @MutationMapping
-    public Journal createJournal(@Argument CreateJournalInput input) {
-        Journal journal = Journal.builder()
-            .postingDate(input.postingDate())
-            .entryDate(LocalDate.now())
-            .isClosingEntry(input.isClosingEntry() != null ? input.isClosingEntry() : false)
-            .voucherType(input.voucherType())
-            .employeeCode(input.employeeCode())
-            .departmentCode(input.departmentCode())
-            .details(convertToDetails(input.details()))
-            .build();
-
-        // 貸借バランスチェック
-        validateBalance(journal);
-
-        return journalUseCase.create(journal);
-    }
-
-    @MutationMapping
-    public boolean deleteJournal(@Argument String journalNumber) {
-        return journalUseCase.delete(journalNumber);
-    }
-
-    @MutationMapping
-    public Journal reverseJournal(
-            @Argument String journalNumber,
-            @Argument String reason) {
-        return journalUseCase.reverse(journalNumber, reason);
-    }
-
-    // === フィールドリゾルバ ===
-
-    @SchemaMapping(typeName = "Journal", field = "totalDebitAmount")
-    public BigDecimal totalDebitAmount(Journal journal) {
-        return journal.getDetails().stream()
-            .flatMap(d -> d.getDebitCreditDetails().stream())
-            .filter(dc -> dc.getDebitCreditCategory().isDebit())
-            .map(JournalDebitCreditDetail::getAmount)
-            .reduce(BigDecimal.ZERO, BigDecimal::add);
-    }
-
-    @SchemaMapping(typeName = "Journal", field = "totalCreditAmount")
-    public BigDecimal totalCreditAmount(Journal journal) {
-        return journal.getDetails().stream()
-            .flatMap(d -> d.getDebitCreditDetails().stream())
-            .filter(dc -> dc.getDebitCreditCategory().isCredit())
-            .map(JournalDebitCreditDetail::getAmount)
-            .reduce(BigDecimal.ZERO, BigDecimal::add);
-    }
-
-    @SchemaMapping(typeName = "Journal", field = "isBalanced")
-    public boolean isBalanced(Journal journal) {
-        BigDecimal debit = totalDebitAmount(journal);
-        BigDecimal credit = totalCreditAmount(journal);
-        return debit.compareTo(credit) == 0;
-    }
-
-    @SchemaMapping(typeName = "JournalDebitCreditDetail", field = "account")
-    public CompletableFuture<Account> account(
-            JournalDebitCreditDetail detail,
-            DataFetchingEnvironment env) {
-
-        DataLoader<String, Account> loader =
-            env.getDataLoader(DataLoaderConfig.ACCOUNT_LOADER);
-
-        return loader.load(detail.getAccountCode());
-    }
-
-    // === Private Methods ===
-
-    private void validateBalance(Journal journal) {
-        BigDecimal debit = journal.getDetails().stream()
-            .flatMap(d -> d.getDebitCreditDetails().stream())
-            .filter(dc -> dc.getDebitCreditCategory().isDebit())
-            .map(JournalDebitCreditDetail::getAmount)
-            .reduce(BigDecimal.ZERO, BigDecimal::add);
-
-        BigDecimal credit = journal.getDetails().stream()
-            .flatMap(d -> d.getDebitCreditDetails().stream())
-            .filter(dc -> dc.getDebitCreditCategory().isCredit())
-            .map(JournalDebitCreditDetail::getAmount)
-            .reduce(BigDecimal.ZERO, BigDecimal::add);
-
-        if (debit.compareTo(credit) != 0) {
-            throw new IllegalArgumentException(
-                "貸借が一致しません。借方合計: " + debit + ", 貸方合計: " + credit);
-        }
-    }
-}
-```
-
-</details>
-
-### 25.2 GraphQL Subscription の実装
-
-GraphQL **Subscription** は、サーバーからクライアントへのリアルタイム通知を実現する仕組みです。
-
-```plantuml
-@startuml subscription_flow
-
-title GraphQL Subscription フロー
-
-participant "Client" as client
-participant "WebSocket" as ws
-participant "GraphQL Server" as server
-participant "EventPublisher" as publisher
-participant "JournalService" as service
-
-== Subscription 開始 ==
-client -> ws : subscription { balanceChanged }
-ws -> server : WebSocket 接続確立
-server -> publisher : 購読登録
-
-== 仕訳登録時 ==
-service -> publisher : 仕訳登録イベント発行
-publisher -> server : イベント受信
-server -> ws : BalanceChange データ送信
-ws -> client : リアルタイム通知
-
-== Subscription 終了 ==
-client -> ws : 接続終了
-ws -> server : WebSocket 切断
-server -> publisher : 購読解除
-
-@enduml
-```
-
-<details>
-<summary>SubscriptionResolver.java</summary>
-
-```java
-package com.example.accounting.infrastructure.graphql.subscription;
-
-import com.example.accounting.domain.event.BalanceChangeEvent;
-import com.example.accounting.domain.event.JournalCreatedEvent;
-import com.example.accounting.domain.event.ClosingProgressEvent;
-import com.example.accounting.infrastructure.graphql.dto.*;
-import org.springframework.graphql.data.method.annotation.Argument;
-import org.springframework.graphql.data.method.annotation.SubscriptionMapping;
-import org.springframework.stereotype.Controller;
-import reactor.core.publisher.Flux;
-
-/**
- * GraphQL Subscription リゾルバ
- */
-@Controller
-public class SubscriptionResolver {
-
-    private final BalanceEventPublisher balanceEventPublisher;
-    private final JournalEventPublisher journalEventPublisher;
-    private final ClosingEventPublisher closingEventPublisher;
-
-    public SubscriptionResolver(
-            BalanceEventPublisher balanceEventPublisher,
-            JournalEventPublisher journalEventPublisher,
-            ClosingEventPublisher closingEventPublisher) {
-        this.balanceEventPublisher = balanceEventPublisher;
-        this.journalEventPublisher = journalEventPublisher;
-        this.closingEventPublisher = closingEventPublisher;
-    }
-
-    @SubscriptionMapping
-    public Flux<BalanceChange> balanceChanged(@Argument String accountCode) {
-        Flux<BalanceChangeEvent> eventFlux = balanceEventPublisher.getEventFlux();
-
-        if (accountCode != null) {
-            eventFlux = eventFlux.filter(event ->
-                accountCode.equals(event.getAccountCode()));
-        }
-
-        return eventFlux.map(this::toBalanceChange);
-    }
-
-    @SubscriptionMapping
-    public Flux<JournalNotification> journalCreated() {
-        return journalEventPublisher.getEventFlux()
-            .map(this::toJournalNotification);
-    }
-
-    @SubscriptionMapping
-    public Flux<ClosingProgress> closingProgressUpdated(@Argument String closingId) {
-        return closingEventPublisher.getEventFlux()
-            .filter(event -> closingId.equals(event.getClosingId()))
-            .map(this::toClosingProgress);
-    }
-
-    private BalanceChange toBalanceChange(BalanceChangeEvent event) {
-        return new BalanceChange(
-            event.getAccountCode(),
-            event.getAccountName(),
-            event.getChangeType(),
-            event.getPreviousBalance(),
-            event.getCurrentBalance(),
-            event.getChangeAmount(),
-            event.getTimestamp()
-        );
-    }
-
-    private JournalNotification toJournalNotification(JournalCreatedEvent event) {
-        return new JournalNotification(
-            event.getJournalNumber(),
-            event.getPostingDate(),
-            event.getTotalDebitAmount(),
-            event.getTotalCreditAmount(),
-            event.getCreatedBy(),
-            event.getCreatedAt()
-        );
-    }
-
-    private ClosingProgress toClosingProgress(ClosingProgressEvent event) {
-        return new ClosingProgress(
-            event.getClosingId(),
-            event.getStatus(),
-            event.getCurrentStep(),
-            event.getProcessedCount(),
-            event.getTotalCount(),
-            event.getProgressPercent(),
-            event.getUpdatedAt()
-        );
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>BalanceEventPublisher.java</summary>
-
-```java
-package com.example.accounting.infrastructure.graphql.subscription;
-
-import com.example.accounting.domain.event.BalanceChangeEvent;
-import org.springframework.stereotype.Component;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Sinks;
-
-/**
- * 残高変動イベントパブリッシャー
- */
-@Component
-public class BalanceEventPublisher {
-
-    private final Sinks.Many<BalanceChangeEvent> sink;
-
-    public BalanceEventPublisher() {
-        this.sink = Sinks.many().multicast().onBackpressureBuffer();
-    }
-
-    public void publish(BalanceChangeEvent event) {
-        sink.tryEmitNext(event);
-    }
-
-    public Flux<BalanceChangeEvent> getEventFlux() {
-        return sink.asFlux();
-    }
-}
-```
-
-</details>
-
----
-
-## 第 26 章：エラーハンドリングとバリデーション
-
-### 26.1 GraphQL エラー設計
-
-GraphQL では、エラーは `errors` フィールドとして返されます。
-
-```plantuml
-@startuml graphql_error_handling
-
-title GraphQL エラーハンドリング
-
-package "GraphQL Layer" {
-  [GraphQL Error Handler]
-}
-
-package "Application Layer" {
-  [Use Case Exception]
-}
-
-package "Domain Layer" {
-  [Domain Exception]
-}
-
-[Domain Exception] --> [Use Case Exception] : 伝播
-[Use Case Exception] --> [GraphQL Error Handler] : 伝播
-
-note right of [Domain Exception]
-  ビジネスルール違反
-  - 貸借不一致
-  - 科目未登録
-  - 決算済み期間
-end note
-
-note right of [Use Case Exception]
-  ユースケース固有
-  - リソース未発見
-  - バリデーションエラー
-  - 権限不足
-end note
-
-note right of [GraphQL Error Handler]
-  GraphQL エラー形式に変換
-  - エラーコード
-  - エラーメッセージ
-  - エラー詳細
-end note
-
-@enduml
-```
-
-### 26.2 カスタム例外クラス
-
-<details>
-<summary>AccountingException.java（基底クラス）</summary>
-
-```java
-package com.example.accounting.domain.exception;
-
-/**
- * 財務会計ドメイン例外の基底クラス
- */
-public abstract class AccountingException extends RuntimeException {
-
-    private final String errorCode;
-
-    protected AccountingException(String errorCode, String message) {
-        super(message);
-        this.errorCode = errorCode;
-    }
-
-    protected AccountingException(String errorCode, String message, Throwable cause) {
-        super(message, cause);
-        this.errorCode = errorCode;
-    }
-
-    public String getErrorCode() {
-        return errorCode;
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>BalanceNotMatchException.java</summary>
-
-```java
-package com.example.accounting.domain.exception;
-
-import java.math.BigDecimal;
-
-/**
- * 貸借不一致例外
- */
-public class BalanceNotMatchException extends AccountingException {
-
-    private final BigDecimal debitTotal;
-    private final BigDecimal creditTotal;
-
-    public BalanceNotMatchException(BigDecimal debitTotal, BigDecimal creditTotal) {
-        super("BALANCE_NOT_MATCH",
-            String.format("貸借が一致しません。借方合計: %s, 貸方合計: %s", debitTotal, creditTotal));
-        this.debitTotal = debitTotal;
-        this.creditTotal = creditTotal;
-    }
-
-    public BigDecimal getDebitTotal() {
-        return debitTotal;
-    }
-
-    public BigDecimal getCreditTotal() {
-        return creditTotal;
-    }
-}
-```
-
-</details>
-
-### 26.3 GraphQL 例外ハンドラー
-
-<details>
-<summary>GraphQLExceptionHandler.java</summary>
-
-```java
-package com.example.accounting.infrastructure.graphql.exception;
-
-import com.example.accounting.domain.exception.*;
-import graphql.GraphQLError;
-import graphql.GraphqlErrorBuilder;
-import graphql.schema.DataFetchingEnvironment;
-import org.springframework.graphql.execution.DataFetcherExceptionResolverAdapter;
-import org.springframework.graphql.execution.ErrorType;
-import org.springframework.stereotype.Component;
-
-import java.util.HashMap;
-import java.util.Map;
-
-/**
- * GraphQL 例外ハンドラー
- */
-@Component
-public class GraphQLExceptionHandler extends DataFetcherExceptionResolverAdapter {
-
-    @Override
-    protected GraphQLError resolveToSingleError(Throwable ex, DataFetchingEnvironment env) {
-        if (ex instanceof AccountingException accountingEx) {
-            return handleAccountingException(accountingEx, env);
-        }
-
-        if (ex instanceof IllegalArgumentException) {
-            return GraphqlErrorBuilder.newError(env)
-                .errorType(ErrorType.BAD_REQUEST)
-                .message(ex.getMessage())
-                .build();
-        }
-
-        // その他の例外
-        return GraphqlErrorBuilder.newError(env)
-            .errorType(ErrorType.INTERNAL_ERROR)
-            .message("内部エラーが発生しました")
-            .build();
-    }
-
-    private GraphQLError handleAccountingException(
-            AccountingException ex, DataFetchingEnvironment env) {
-
-        Map<String, Object> extensions = new HashMap<>();
-        extensions.put("errorCode", ex.getErrorCode());
-
-        ErrorType errorType = mapToErrorType(ex);
-
-        // 例外固有の情報を追加
-        if (ex instanceof BalanceNotMatchException balanceEx) {
-            extensions.put("debitTotal", balanceEx.getDebitTotal());
-            extensions.put("creditTotal", balanceEx.getCreditTotal());
-        } else if (ex instanceof AccountNotFoundException accountEx) {
-            extensions.put("accountCode", accountEx.getAccountCode());
-        }
-
-        return GraphqlErrorBuilder.newError(env)
-            .errorType(errorType)
-            .message(ex.getMessage())
-            .extensions(extensions)
-            .build();
-    }
-
-    private ErrorType mapToErrorType(AccountingException ex) {
-        if (ex instanceof AccountNotFoundException ||
-            ex instanceof JournalNotFoundException) {
-            return ErrorType.NOT_FOUND;
-        }
-
-        if (ex instanceof BalanceNotMatchException ||
-            ex instanceof ClosedPeriodException) {
-            return ErrorType.BAD_REQUEST;
-        }
-
-        return ErrorType.INTERNAL_ERROR;
-    }
-}
-```
-
-</details>
-
-### 26.4 Spring for GraphQL テスト
-
-<details>
-<summary>AccountResolverTest.java</summary>
-
-```java
-package com.example.accounting.infrastructure.graphql;
-
-import org.junit.jupiter.api.Test;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.graphql.tester.AutoConfigureHttpGraphQlTester;
-import org.springframework.boot.test.context.SpringBootTest;
-import org.springframework.graphql.test.tester.HttpGraphQlTester;
-import org.springframework.test.context.DynamicPropertyRegistry;
-import org.springframework.test.context.DynamicPropertySource;
-import org.testcontainers.containers.PostgreSQLContainer;
-import org.testcontainers.junit.jupiter.Container;
-import org.testcontainers.junit.jupiter.Testcontainers;
-
-import static org.assertj.core.api.Assertions.assertThat;
-
-@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
-@AutoConfigureHttpGraphQlTester
-@Testcontainers
-class AccountResolverTest {
-
-    @Container
-    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16-alpine");
-
-    @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 HttpGraphQlTester graphQlTester;
-
-    @Test
-    void testQueryAccount() {
-        // language=GraphQL
-        String query = """
-            query {
-                account(accountCode: "11110") {
-                    accountCode
-                    accountName
-                    bsplCategory
-                    debitCreditCategory
-                }
-            }
-            """;
-
-        graphQlTester.document(query)
-            .execute()
-            .path("account.accountCode")
-            .entity(String.class)
-            .isEqualTo("11110");
-    }
-
-    @Test
-    void testMutationCreateAccount() {
-        // language=GraphQL
-        String mutation = """
-            mutation {
-                createAccount(input: {
-                    accountCode: "99999"
-                    accountName: "テスト科目"
-                    bsplCategory: BS
-                    debitCreditCategory: DEBIT
-                    transactionElementCategory: ASSET
-                    aggregationCategory: POSTING
-                }) {
-                    accountCode
-                    accountName
-                }
-            }
-            """;
-
-        graphQlTester.document(mutation)
-            .execute()
-            .path("createAccount.accountCode")
-            .entity(String.class)
-            .isEqualTo("99999");
-    }
-}
-```
-
-</details>
-
-### 26.5 GraphiQL による動作確認
-
-サーバー起動後、`http://localhost:8080/graphiql` にアクセスして対話的にクエリを実行できます。
-
-```graphql
-# 勘定科目の取得
-query {
-  account(accountCode: "11110") {
-    accountCode
-    accountName
-    bsplCategory
-    debitCreditCategory
-    taxTransaction {
-      taxCode
-      taxName
-      taxRate
-    }
-    dailyBalances {
-      postingDate
-      debitAmount
-      creditAmount
-      balance
-    }
-  }
-}
-
-# 仕訳登録
-mutation {
-  createJournal(input: {
-    postingDate: "2025-12-29"
-    voucherType: NORMAL
-    details: [
-      {
-        lineNumber: 1
-        description: "現金売上"
-        debitCreditDetails: [
-          {
-            debitCreditCategory: DEBIT
-            accountCode: "11110"
-            amount: "100000"
-          }
-          {
-            debitCreditCategory: CREDIT
-            accountCode: "41100"
-            amount: "100000"
-          }
-        ]
-      }
-    ]
-  }) {
-    journalNumber
-    postingDate
-    totalDebitAmount
-    totalCreditAmount
-    isBalanced
-  }
-}
-
-# 試算表
-query {
-  trialBalance(fiscalYear: 2025, month: 12) {
-    fiscalYear
-    month
-    entries {
-      accountCode
-      accountName
-      bsplCategory
-      debitAmount
-      creditAmount
-      debitBalance
-      creditBalance
-    }
-    totalDebitAmount
-    totalCreditAmount
-  }
-}
-```
-
----
-
-## 第 27 章：まとめと発展
-
-### 27.1 GraphQL 実装の振り返り
-
-```plantuml
-@startuml graphql_summary
-
-title 財務会計システム GraphQL 実装全体像
-
-package "GraphQL Schema" {
-  [schema.graphqls]
-  [account.graphqls]
-  [journal.graphqls]
-  [balance.graphqls]
-  [report.graphqls]
-}
-
-package "Resolvers" {
-  [QueryResolver]
-  [AccountResolver]
-  [JournalResolver]
-  [BalanceResolver]
-  [ReportResolver]
-  [SubscriptionResolver]
-}
-
-package "DataLoaders" {
-  [TaxTransactionDataLoader]
-  [DailyBalanceDataLoader]
-  [MonthlyBalanceDataLoader]
-  [AccountConfigDataLoader]
-}
-
-package "Application Layer" {
-  [AccountUseCase]
-  [JournalUseCase]
-  [BalanceUseCase]
-  [ReportUseCase]
-}
-
-package "Infrastructure" {
-  [MyBatis Repository]
-  [Event Publisher]
-  [PostgreSQL]
-}
-
-[schema.graphqls] --> [QueryResolver]
-[QueryResolver] --> [AccountUseCase]
-[AccountResolver] --> [TaxTransactionDataLoader]
-[AccountResolver] --> [DailyBalanceDataLoader]
-[JournalResolver] --> [JournalUseCase]
-[SubscriptionResolver] --> [Event Publisher]
-
-[AccountUseCase] --> [MyBatis Repository]
-[MyBatis Repository] --> [PostgreSQL]
-
-@enduml
-```
-
-### 27.2 REST / gRPC / GraphQL の使い分け
-
-| 観点 | REST API | gRPC | GraphQL |
-|------|----------|------|---------|
-| **クライアント** | Web ブラウザ、外部連携 | マイクロサービス間 | SPA、モバイルアプリ |
-| **データ量** | 固定レスポンス | 固定レスポンス | クライアント指定 |
-| **リアルタイム** | WebSocket 別実装 | ストリーミング | Subscription |
-| **型安全性** | △（OpenAPI） | ◎（.proto） | ◎（.graphqls） |
-| **学習コスト** | 低 | 中 | 中 |
-| **ブラウザ対応** | ◎ | △（gRPC-Web） | ◎ |
-
-```plantuml
-@startuml api_usage
-
-title API 使い分けパターン
-
-package "フロントエンド" {
-  [経理担当者 Web UI] as web
-  [経営ダッシュボード] as dashboard
-  [Excel アドイン] as excel
-}
-
-package "バックエンド" {
-  [財務会計システム] as accounting
-}
-
-package "連携システム" {
-  [販売管理システム] as sales
-  [購買管理システム] as purchase
-  [人事給与システム] as hr
-}
-
-web --> accounting : GraphQL\n(柔軟なクエリ)
-dashboard --> accounting : GraphQL\n(リアルタイム更新)
-excel --> accounting : REST API\n(シンプルな連携)
-
-sales --> accounting : gRPC\n(高性能・自動仕訳)
-purchase --> accounting : gRPC\n(高性能・自動仕訳)
-hr --> accounting : gRPC\n(給与仕訳連携)
-
-@enduml
-```
-
-### 27.3 ヘキサゴナルアーキテクチャの利点
-
-複数の API 形式を同時提供できるのは、ヘキサゴナルアーキテクチャの恩恵です。
-
-```plantuml
-@startuml hexagonal_benefit
-
-title 複数 API の同時提供
-
-package "Input Adapters" {
-  [REST Controller]
-  [gRPC Service]
-  [GraphQL Resolver]
-}
-
-package "Application Core" {
-  [AccountUseCase]
-  [JournalUseCase]
-  [BalanceUseCase]
-}
-
-package "Output Adapters" {
-  [MyBatis Repository]
-}
-
-[REST Controller] --> [AccountUseCase]
-[gRPC Service] --> [AccountUseCase]
-[GraphQL Resolver] --> [AccountUseCase]
-
-[REST Controller] --> [JournalUseCase]
-[gRPC Service] --> [JournalUseCase]
-[GraphQL Resolver] --> [JournalUseCase]
-
-note top of [Application Core]
-  ビジネスロジックは
-  API 形式に依存しない
-
-  1つのコードベースで
-  複数の API を提供
-end note
-
-@enduml
-```
-
-### 27.4 今後の発展
-
-本パートで構築した GraphQL サービスをベースに、以下の拡張が可能です：
-
-1. **認証・認可**: Spring Security + JWT による GraphQL 認証
-2. **キャッシュ**: Redis によるクエリ結果キャッシュ
-3. **監視**: GraphQL メトリクスの収集と監視
-4. **フェデレーション**: Apollo Federation による複数サービス統合
-5. **コード生成**: GraphQL Code Generator によるクライアントコード自動生成
-
-### 27.5 学習した内容
-
-1. **GraphQL の基本概念**: Query、Mutation、Subscription の 3 つの操作タイプ
-2. **スキーマ駆動開発**: `.graphqls` ファイルによる型安全な API 定義
-3. **N+1 問題と DataLoader**: バッチ処理によるパフォーマンス最適化
-4. **リゾルバ実装**: `@QueryMapping`、`@MutationMapping`、`@SchemaMapping`
-5. **Subscription**: WebSocket によるリアルタイム通知
-6. **エラーハンドリング**: カスタム例外と GraphQL エラー形式への変換
-7. **テスト**: `HttpGraphQlTester` による統合テスト
+# 研究 4：GraphQL サービスの実装
+
+## はじめに
+
+本パートでは、REST API や gRPC とは異なるアプローチとして、**GraphQL** による財務会計システムを実装します。クライアントが必要なデータを正確に指定できる柔軟なクエリと、リアルタイム更新を実現する Subscription を活用します。
+
+ヘキサゴナルアーキテクチャ（ドメイン層・アプリケーション層）はそのまま共有し、**Input Adapter として GraphQL リゾルバ層のみを追加**します。
+
+---
+
+## 第 22 章：GraphQL サーバーの基礎
+
+### 22.1 GraphQL とは
+
+GraphQL は Facebook が開発したクエリ言語および実行エンジンです。クライアントが必要なデータの形状を指定でき、Over-fetching（不要なデータの取得）や Under-fetching（必要なデータの不足）を防ぎます。
+
+```plantuml
+@startuml graphql_architecture
+!define RECTANGLE class
+
+skinparam backgroundColor #FEFEFE
+
+package "GraphQL Architecture (財務会計システム)" {
+
+  package "Client Side" {
+    RECTANGLE "GraphQL Client\n(Apollo/Relay/urql)" as client {
+      - Query (読み取り)
+      - Mutation (書き込み)
+      - Subscription (リアルタイム)
+    }
+  }
+
+  package "Server Side" {
+    RECTANGLE "GraphQL Server\n(Spring for GraphQL)" as server {
+      - AccountResolver
+      - JournalResolver
+      - BalanceResolver
+      - ReportResolver
+    }
+  }
+
+  package "Shared" {
+    RECTANGLE "GraphQL Schema\n(.graphqls files)" as schema {
+      - schema.graphqls
+      - account.graphqls
+      - journal.graphqls
+      - balance.graphqls
+      - report.graphqls
+    }
+  }
+}
+
+client --> schema : "スキーマに基づいて\nクエリを構築"
+server --> schema : "スキーマに基づいて\nリゾルバを実装"
+client <--> server : "HTTP/WebSocket\n(JSON)"
+
+note bottom of schema
+  スキーマ駆動開発
+  クライアント主導のデータ取得
+  型安全な API
+end note
+
+@enduml
+```
+
+**REST API / gRPC / GraphQL の比較：**
+
+| 特徴 | REST API | gRPC | GraphQL |
+|------|----------|------|---------|
+| プロトコル | HTTP/1.1 | HTTP/2 | HTTP/1.1 or HTTP/2 |
+| データ形式 | JSON | Protocol Buffers | JSON |
+| スキーマ | OpenAPI (任意) | .proto (必須) | .graphqls (必須) |
+| データ取得 | 固定レスポンス | 固定レスポンス | クライアント指定 |
+| エンドポイント | 複数 | 複数 | 単一 |
+| リアルタイム | WebSocket 別実装 | ストリーミング | Subscription |
+| 主な用途 | 汎用 API | マイクロサービス | フロントエンド向け |
+
+### 22.2 3 つの操作タイプ
+
+GraphQL は 3 つの操作タイプをサポートします：
+
+```plantuml
+@startuml graphql_operations
+skinparam backgroundColor #FEFEFE
+
+rectangle "1. Query\n(読み取り)" as query #LightBlue {
+}
+note right of query
+  { accounts { code name category } }
+  → { accounts: [...] }
+
+  データの取得
+  複数リソースを1回で取得可能
+end note
+
+rectangle "2. Mutation\n(書き込み)" as mutation #LightGreen {
+}
+note right of mutation
+  mutation { createJournal(...) }
+  → { createJournal: {...} }
+
+  データの作成・更新・削除
+end note
+
+rectangle "3. Subscription\n(リアルタイム)" as subscription #LightCoral {
+}
+note right of subscription
+  subscription { balanceChanged }
+  → (WebSocket でプッシュ通知)
+
+  リアルタイム更新の受信
+end note
+
+query -[hidden]-> mutation
+mutation -[hidden]-> subscription
+
+@enduml
+```
+
+**用途：**
+
+1. **Query**: データ取得（勘定科目一覧、仕訳照会、残高照会）
+2. **Mutation**: データ更新（仕訳登録、仕訳取消、決算仕訳）
+3. **Subscription**: リアルタイム通知（残高変動、仕訳登録通知）
+
+### 22.3 GraphQL におけるヘキサゴナルアーキテクチャ
+
+GraphQL を導入しても、ヘキサゴナルアーキテクチャ（ドメイン層・アプリケーション層）はそのまま共有し、**Input Adapter として GraphQL リゾルバ層のみを追加**します。
+
+```plantuml
+@startuml hexagonal_graphql
+!define RECTANGLE class
+
+package "Hexagonal Architecture (GraphQL版)" {
+
+  RECTANGLE "Application Core\n(Domain + Use Cases)" as core {
+    - Account (勘定科目)
+    - Journal (仕訳)
+    - DailyBalance (日次残高)
+    - MonthlyBalance (月次残高)
+    - AccountUseCase
+    - JournalUseCase
+    - BalanceUseCase
+  }
+
+  RECTANGLE "Input Adapters\n(Driving Side)" as input {
+    - REST Controller（既存）
+    - gRPC Service（既存）
+    - GraphQL Resolver（新規追加）
+    - DataFetcher
+    - DataLoader
+  }
+
+  RECTANGLE "Output Adapters\n(Driven Side)" as output {
+    - MyBatis Repository
+    - Database Access
+    - Entity Mapping
+  }
+}
+
+input --> core : "Input Ports\n(Use Cases)"
+core --> output : "Output Ports\n(Repository Interfaces)"
+
+note top of core
+  既存のビジネスロジック
+  REST API / gRPC 版と完全に共有
+  GraphQL 固有のコードは含まない
+end note
+
+note left of input
+  GraphQL リゾルバを
+  Input Adapter として追加
+  既存の REST/gRPC と共存可能
+end note
+
+note right of output
+  既存の Repository を
+  そのまま使用
+  変更不要
+end note
+
+@enduml
+```
+
+### 22.4 ディレクトリ構成
+
+既存の構成に `infrastructure/graphql/` を追加するだけです。
+
+```
+src/main/java/com/example/accounting/
+├── domain/                     # ドメイン層（API版と共通）
+│   ├── model/
+│   │   ├── account/
+│   │   ├── journal/
+│   │   ├── balance/
+│   │   └── report/
+│   └── exception/
+│
+├── application/               # アプリケーション層（API版と共通）
+│   ├── port/
+│   │   ├── in/               # Input Port（ユースケース）
+│   │   └── out/              # Output Port（リポジトリ）
+│   └── service/
+│
+├── infrastructure/
+│   ├── persistence/          # Output Adapter（DB実装）- 既存
+│   │   ├── mapper/
+│   │   └── repository/
+│   ├── rest/                 # Input Adapter（REST実装）- 既存
+│   ├── grpc/                 # Input Adapter（gRPC実装）- 既存
+│   └── graphql/              # Input Adapter（GraphQL実装）- 新規追加
+│       ├── resolver/         # Query/Mutation リゾルバ
+│       ├── dataloader/       # N+1 問題対策
+│       ├── scalar/           # カスタムスカラー型
+│       └── subscription/     # Subscription ハンドラ
+│
+├── config/
+│
+└── src/main/resources/
+    └── graphql/              # GraphQL スキーマ定義
+        ├── schema.graphqls
+        ├── account.graphqls
+        ├── journal.graphqls
+        ├── balance.graphqls
+        └── report.graphqls
+```
+
+### 22.5 技術スタックの追加
+
+既存の `build.gradle.kts` に GraphQL 関連の依存関係を追加します。
+
+<details>
+<summary>build.gradle.kts（差分）</summary>
+
+```kotlin
+dependencies {
+    // 既存の依存関係（Spring Boot, MyBatis, PostgreSQL等）はそのまま
+
+    // GraphQL 関連を追加
+    implementation("org.springframework.boot:spring-boot-starter-graphql")
+    implementation("org.springframework.boot:spring-boot-starter-websocket")  // Subscription 用
+
+    // GraphQL 拡張
+    implementation("com.graphql-java:graphql-java-extended-scalars:21.0")
+
+    // Test
+    testImplementation("org.springframework.graphql:spring-graphql-test")
+}
+```
+
+</details>
+
+**追加パッケージの説明：**
+
+| パッケージ | 用途 |
+|-----------|------|
+| spring-boot-starter-graphql | Spring Boot GraphQL 統合 |
+| spring-boot-starter-websocket | Subscription (WebSocket) |
+| graphql-java-extended-scalars | DateTime, BigDecimal 等のスカラー型 |
+| spring-graphql-test | GraphQL テストサポート |
+
+### 22.6 GraphQL 設定
+
+<details>
+<summary>application.yml（差分）</summary>
+
+```yaml
+spring:
+  graphql:
+    graphiql:
+      enabled: true
+      path: /graphiql
+    websocket:
+      path: /graphql
+    schema:
+      printer:
+        enabled: true
+      locations:
+        - classpath:graphql/
+    cors:
+      allowed-origins: "*"
+      allowed-methods: GET, POST
+```
+
+</details>
+
+<details>
+<summary>GraphQLConfig.java</summary>
+
+```java
+package com.example.accounting.config;
+
+import graphql.scalars.ExtendedScalars;
+import graphql.schema.idl.RuntimeWiring;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.graphql.execution.RuntimeWiringConfigurer;
+
+/**
+ * GraphQL 設定
+ */
+@Configuration
+public class GraphQLConfig {
+
+    @Bean
+    public RuntimeWiringConfigurer runtimeWiringConfigurer() {
+        return wiringBuilder -> wiringBuilder
+            .scalar(ExtendedScalars.Date)
+            .scalar(ExtendedScalars.DateTime)
+            .scalar(ExtendedScalars.GraphQLBigDecimal)
+            .scalar(ExtendedScalars.GraphQLLong);
+    }
+}
+```
+
+</details>
+
+---
+
+## 第 23 章：GraphQL スキーマの定義
+
+### 23.1 ルートスキーマ
+
+<details>
+<summary>src/main/resources/graphql/schema.graphqls</summary>
+
+```graphql
+# ルートスキーマ
+type Query {
+    # 勘定科目
+    account(accountCode: ID!): Account
+    accounts(bsplCategory: BSPLCategory, page: Int, size: Int): AccountConnection!
+    accountHierarchy(accountCode: ID!): [Account!]!
+
+    # 課税取引
+    taxTransaction(taxCode: ID!): TaxTransaction
+    taxTransactions: [TaxTransaction!]!
+
+    # 勘定科目構成
+    accountConfig(accountCode: ID!): AccountConfig
+    accountConfigs(parentPath: String): [AccountConfig!]!
+
+    # 仕訳
+    journal(journalNumber: ID!): Journal
+    journals(fromDate: Date, toDate: Date, accountCode: ID, page: Int, size: Int): JournalConnection!
+
+    # 残高
+    dailyBalance(date: Date!, accountCode: ID!, subAccountCode: ID): DailyBalance
+    dailyBalances(date: Date!, page: Int, size: Int): DailyBalanceConnection!
+
+    monthlyBalance(fiscalYear: Int!, month: Int!, accountCode: ID!, subAccountCode: ID): MonthlyBalance
+    monthlyBalances(fiscalYear: Int!, month: Int!, page: Int, size: Int): MonthlyBalanceConnection!
+
+    # 帳票
+    dailyReport(date: Date!): DailyReport!
+    trialBalance(fiscalYear: Int!, month: Int!): TrialBalance!
+    financialStatements(fiscalYear: Int!): FinancialStatements!
+}
+
+type Mutation {
+    # 勘定科目
+    createAccount(input: CreateAccountInput!): Account!
+    updateAccount(input: UpdateAccountInput!): Account!
+    deleteAccount(accountCode: ID!): Boolean!
+
+    # 課税取引
+    createTaxTransaction(input: CreateTaxTransactionInput!): TaxTransaction!
+    updateTaxTransaction(input: UpdateTaxTransactionInput!): TaxTransaction!
+    deleteTaxTransaction(taxCode: ID!): Boolean!
+
+    # 仕訳
+    createJournal(input: CreateJournalInput!): Journal!
+    updateJournal(input: UpdateJournalInput!): Journal!
+    deleteJournal(journalNumber: ID!): Boolean!
+    reverseJournal(journalNumber: ID!, reason: String): Journal!
+
+    # 残高更新
+    recalculateDailyBalance(date: Date!): RecalculateResult!
+    recalculateMonthlyBalance(fiscalYear: Int!, month: Int!): RecalculateResult!
+
+    # 決算処理
+    executeClosing(input: ExecuteClosingInput!): ClosingResult!
+}
+
+type Subscription {
+    # 残高変動
+    balanceChanged(accountCode: ID): BalanceChange!
+
+    # 仕訳登録通知
+    journalCreated: JournalNotification!
+
+    # 決算処理進捗
+    closingProgressUpdated(closingId: ID!): ClosingProgress!
+}
+
+# ページネーション共通型
+type PageInfo {
+    hasNextPage: Boolean!
+    hasPreviousPage: Boolean!
+    totalElements: Int!
+    totalPages: Int!
+    currentPage: Int!
+}
+
+# カスタムスカラー
+scalar Date
+scalar DateTime
+scalar BigDecimal
+scalar Long
+```
+
+</details>
+
+### 23.2 勘定科目スキーマ
+
+<details>
+<summary>src/main/resources/graphql/account.graphqls</summary>
+
+```graphql
+# BSPL区分
+enum BSPLCategory {
+    BS      # 貸借対照表
+    PL      # 損益計算書
+}
+
+# 貸借区分
+enum DebitCreditCategory {
+    DEBIT   # 借方
+    CREDIT  # 貸方
+}
+
+# 取引要素区分
+enum TransactionElementCategory {
+    ASSET       # 資産
+    LIABILITY   # 負債
+    CAPITAL     # 資本
+    REVENUE     # 収益
+    EXPENSE     # 費用
+}
+
+# 集計区分
+enum AggregationCategory {
+    HEADING     # 見出科目
+    SUBTOTAL    # 集計科目
+    POSTING     # 計上科目
+}
+
+# 勘定科目
+type Account {
+    accountCode: ID!
+    accountName: String!
+    accountShortName: String
+    accountKana: String
+    bsplCategory: BSPLCategory!
+    debitCreditCategory: DebitCreditCategory!
+    transactionElementCategory: TransactionElementCategory!
+    aggregationCategory: AggregationCategory!
+    managementAccountingCategory: String
+    expenseCategory: String
+    ledgerOutputCategory: String
+    subAccountType: String
+    taxCalculationCategory: String
+    taxTransactionCode: ID
+    dueDateManagementCategory: String
+    createdAt: DateTime!
+    updatedAt: DateTime!
+    updatedBy: String
+
+    # 関連データ（必要な場合のみ取得）
+    taxTransaction: TaxTransaction
+    accountConfig: AccountConfig
+    childAccounts: [Account!]!
+    dailyBalances(date: Date): [DailyBalance!]!
+    monthlyBalances(fiscalYear: Int, month: Int): [MonthlyBalance!]!
+}
+
+# 勘定科目一覧（ページネーション付き）
+type AccountConnection {
+    edges: [AccountEdge!]!
+    pageInfo: PageInfo!
+}
+
+type AccountEdge {
+    node: Account!
+    cursor: String!
+}
+
+# 課税取引マスタ
+type TaxTransaction {
+    taxCode: ID!
+    taxName: String!
+    taxRate: BigDecimal!
+    updatedAt: DateTime!
+    updatedBy: String
+
+    # 関連データ
+    accounts: [Account!]!
+}
+
+# 勘定科目構成マスタ
+type AccountConfig {
+    accountCode: ID!
+    accountPath: String!
+    updatedAt: DateTime!
+    updatedBy: String
+
+    # 関連データ
+    account: Account!
+    parentAccount: Account
+    childAccounts: [Account!]!
+}
+
+# 入力型
+input CreateAccountInput {
+    accountCode: ID!
+    accountName: String!
+    accountShortName: String
+    accountKana: String
+    bsplCategory: BSPLCategory!
+    debitCreditCategory: DebitCreditCategory!
+    transactionElementCategory: TransactionElementCategory!
+    aggregationCategory: AggregationCategory!
+    managementAccountingCategory: String
+    expenseCategory: String
+    ledgerOutputCategory: String
+    subAccountType: String
+    taxCalculationCategory: String
+    taxTransactionCode: ID
+    dueDateManagementCategory: String
+}
+
+input UpdateAccountInput {
+    accountCode: ID!
+    accountName: String
+    accountShortName: String
+    accountKana: String
+    bsplCategory: BSPLCategory
+    debitCreditCategory: DebitCreditCategory
+    transactionElementCategory: TransactionElementCategory
+    aggregationCategory: AggregationCategory
+    managementAccountingCategory: String
+    expenseCategory: String
+    ledgerOutputCategory: String
+    subAccountType: String
+    taxCalculationCategory: String
+    taxTransactionCode: ID
+    dueDateManagementCategory: String
+}
+```
+
+</details>
+
+### 23.3 仕訳スキーマ
+
+<details>
+<summary>src/main/resources/graphql/journal.graphqls</summary>
+
+```graphql
+# 仕訳伝票区分
+enum JournalVoucherType {
+    NORMAL          # 通常仕訳
+    ADJUSTMENT      # 調整仕訳
+    CLOSING         # 決算仕訳
+}
+
+# 仕訳
+type Journal {
+    journalNumber: ID!
+    postingDate: Date!
+    entryDate: Date!
+    isClosingEntry: Boolean!
+    isSingleEntry: Boolean!
+    voucherType: JournalVoucherType!
+    isRecurring: Boolean!
+    employeeCode: String
+    departmentCode: String
+    isReversal: Boolean!
+    reversalJournalNumber: ID
+    createdAt: DateTime!
+    updatedAt: DateTime!
+
+    # 関連データ
+    details: [JournalDetail!]!
+    department: Department
+    totalDebitAmount: BigDecimal!
+    totalCreditAmount: BigDecimal!
+    isBalanced: Boolean!
+}
+
+# 仕訳明細
+type JournalDetail {
+    journalNumber: ID!
+    lineNumber: Int!
+    description: String
+    createdAt: DateTime!
+    updatedAt: DateTime!
+
+    # 関連データ
+    debitCreditDetails: [JournalDebitCreditDetail!]!
+}
+
+# 仕訳貸借明細
+type JournalDebitCreditDetail {
+    journalNumber: ID!
+    lineNumber: Int!
+    debitCreditCategory: DebitCreditCategory!
+    currencyCode: String
+    exchangeRate: BigDecimal
+    departmentCode: String
+    projectCode: String
+    accountCode: ID!
+    subAccountCode: String
+    amount: BigDecimal!
+    baseAmount: BigDecimal!
+    taxCategory: String
+    taxRate: BigDecimal
+    taxCalculationCategory: String
+    dueDate: Date
+    cashFlowFlag: Boolean
+    segmentCode: String
+    counterAccountCode: String
+    counterSubAccountCode: String
+    tagCode: String
+    tagDescription: String
+    createdAt: DateTime!
+    updatedAt: DateTime!
+
+    # 関連データ
+    account: Account!
+    counterAccount: Account
+}
+
+# 仕訳一覧
+type JournalConnection {
+    edges: [JournalEdge!]!
+    pageInfo: PageInfo!
+}
+
+type JournalEdge {
+    node: Journal!
+    cursor: String!
+}
+
+# 仕訳登録通知イベント
+type JournalNotification {
+    journalNumber: ID!
+    postingDate: Date!
+    totalDebitAmount: BigDecimal!
+    totalCreditAmount: BigDecimal!
+    createdBy: String
+    createdAt: DateTime!
+}
+
+# 入力型
+input CreateJournalInput {
+    postingDate: Date!
+    isClosingEntry: Boolean
+    isSingleEntry: Boolean
+    voucherType: JournalVoucherType
+    isRecurring: Boolean
+    employeeCode: String
+    departmentCode: String
+    details: [JournalDetailInput!]!
+}
+
+input JournalDetailInput {
+    lineNumber: Int!
+    description: String
+    debitCreditDetails: [JournalDebitCreditDetailInput!]!
+}
+
+input JournalDebitCreditDetailInput {
+    debitCreditCategory: DebitCreditCategory!
+    currencyCode: String
+    exchangeRate: BigDecimal
+    departmentCode: String
+    projectCode: String
+    accountCode: ID!
+    subAccountCode: String
+    amount: BigDecimal!
+    baseAmount: BigDecimal
+    taxCategory: String
+    taxRate: BigDecimal
+    dueDate: Date
+    segmentCode: String
+    counterAccountCode: String
+    tagCode: String
+    tagDescription: String
+}
+```
+
+</details>
+
+### 23.4 残高・帳票スキーマ
+
+<details>
+<summary>src/main/resources/graphql/balance.graphqls</summary>
+
+```graphql
+# 日次勘定科目残高
+type DailyBalance {
+    postingDate: Date!
+    accountCode: ID!
+    subAccountCode: String
+    departmentCode: String
+    projectCode: String
+    isClosingEntry: Boolean!
+    debitAmount: BigDecimal!
+    creditAmount: BigDecimal!
+    balance: BigDecimal!
+
+    # 関連データ
+    account: Account!
+}
+
+# 日次残高一覧
+type DailyBalanceConnection {
+    edges: [DailyBalanceEdge!]!
+    pageInfo: PageInfo!
+}
+
+type DailyBalanceEdge {
+    node: DailyBalance!
+    cursor: String!
+}
+
+# 月次勘定科目残高
+type MonthlyBalance {
+    fiscalYear: Int!
+    month: Int!
+    accountCode: ID!
+    subAccountCode: String
+    departmentCode: String
+    projectCode: String
+    isClosingEntry: Boolean!
+    beginningBalance: BigDecimal!
+    debitAmount: BigDecimal!
+    creditAmount: BigDecimal!
+    endingBalance: BigDecimal!
+
+    # 関連データ
+    account: Account!
+}
+
+# 残高変動イベント
+type BalanceChange {
+    accountCode: ID!
+    accountName: String!
+    changeType: BalanceChangeType!
+    previousBalance: BigDecimal!
+    currentBalance: BigDecimal!
+    changeAmount: BigDecimal!
+    timestamp: DateTime!
+}
+
+enum BalanceChangeType {
+    DEBIT       # 借方記入
+    CREDIT      # 貸方記入
+    ADJUSTMENT  # 調整
+    CLOSING     # 決算
+}
+
+# 再計算結果
+type RecalculateResult {
+    processedCount: Int!
+    updatedAccounts: [String!]!
+    timestamp: DateTime!
+}
+```
+
+</details>
+
+<details>
+<summary>src/main/resources/graphql/report.graphqls</summary>
+
+```graphql
+# 日計表
+type DailyReport {
+    reportDate: Date!
+    entries: [DailyReportEntry!]!
+    totalDebitAmount: BigDecimal!
+    totalCreditAmount: BigDecimal!
+    generatedAt: DateTime!
+}
+
+type DailyReportEntry {
+    accountCode: ID!
+    accountName: String!
+    debitAmount: BigDecimal!
+    creditAmount: BigDecimal!
+    balance: BigDecimal!
+}
+
+# 合計残高試算表
+type TrialBalance {
+    fiscalYear: Int!
+    month: Int!
+    entries: [TrialBalanceEntry!]!
+    totalDebitAmount: BigDecimal!
+    totalCreditAmount: BigDecimal!
+    totalDebitBalance: BigDecimal!
+    totalCreditBalance: BigDecimal!
+    generatedAt: DateTime!
+}
+
+type TrialBalanceEntry {
+    accountCode: ID!
+    accountName: String!
+    bsplCategory: BSPLCategory!
+    debitAmount: BigDecimal!
+    creditAmount: BigDecimal!
+    debitBalance: BigDecimal!
+    creditBalance: BigDecimal!
+}
+
+# 財務諸表
+type FinancialStatements {
+    fiscalYear: Int!
+    balanceSheet: BalanceSheet!
+    incomeStatement: IncomeStatement!
+    generatedAt: DateTime!
+}
+
+# 貸借対照表
+type BalanceSheet {
+    fiscalYear: Int!
+    assetEntries: [FinancialStatementEntry!]!
+    liabilityEntries: [FinancialStatementEntry!]!
+    capitalEntries: [FinancialStatementEntry!]!
+    totalAssets: BigDecimal!
+    totalLiabilities: BigDecimal!
+    totalCapital: BigDecimal!
+}
+
+# 損益計算書
+type IncomeStatement {
+    fiscalYear: Int!
+    revenueEntries: [FinancialStatementEntry!]!
+    expenseEntries: [FinancialStatementEntry!]!
+    totalRevenue: BigDecimal!
+    totalExpense: BigDecimal!
+    netIncome: BigDecimal!
+}
+
+type FinancialStatementEntry {
+    accountCode: ID!
+    accountName: String!
+    level: Int!
+    amount: BigDecimal!
+    isSubtotal: Boolean!
+}
+
+# 決算処理結果
+type ClosingResult {
+    closingId: ID!
+    fiscalYear: Int!
+    processedJournalCount: Int!
+    closingJournals: [Journal!]!
+    completedAt: DateTime!
+}
+
+# 決算処理進捗
+type ClosingProgress {
+    closingId: ID!
+    status: ClosingStatus!
+    currentStep: String!
+    processedCount: Int!
+    totalCount: Int!
+    progressPercent: Float!
+    updatedAt: DateTime!
+}
+
+enum ClosingStatus {
+    PROCESSING  # 処理中
+    COMPLETED   # 完了
+    FAILED      # 失敗
+}
+```
+
+</details>
+
+---
+
+## 第 24 章：マスタ API の実装
+
+### 24.1 Query リゾルバ
+
+<details>
+<summary>QueryResolver.java</summary>
+
+```java
+package com.example.accounting.infrastructure.graphql.resolver;
+
+import com.example.accounting.application.port.in.AccountUseCase;
+import com.example.accounting.application.port.in.JournalUseCase;
+import com.example.accounting.application.port.in.BalanceUseCase;
+import com.example.accounting.domain.model.account.Account;
+import com.example.accounting.domain.model.account.TaxTransaction;
+import com.example.accounting.domain.model.account.AccountConfig;
+import com.example.accounting.infrastructure.graphql.dto.*;
+import org.springframework.graphql.data.method.annotation.Argument;
+import org.springframework.graphql.data.method.annotation.QueryMapping;
+import org.springframework.stereotype.Controller;
+
+import java.util.List;
+
+/**
+ * GraphQL Query リゾルバ
+ */
+@Controller
+public class QueryResolver {
+
+    private final AccountUseCase accountUseCase;
+    private final JournalUseCase journalUseCase;
+    private final BalanceUseCase balanceUseCase;
+
+    public QueryResolver(
+            AccountUseCase accountUseCase,
+            JournalUseCase journalUseCase,
+            BalanceUseCase balanceUseCase) {
+        this.accountUseCase = accountUseCase;
+        this.journalUseCase = journalUseCase;
+        this.balanceUseCase = balanceUseCase;
+    }
+
+    // === 勘定科目 ===
+
+    @QueryMapping
+    public Account account(@Argument String accountCode) {
+        return accountUseCase.findByCode(accountCode)
+            .orElse(null);
+    }
+
+    @QueryMapping
+    public AccountConnection accounts(
+            @Argument String bsplCategory,
+            @Argument Integer page,
+            @Argument Integer size) {
+
+        int pageNum = page != null ? page : 0;
+        int pageSize = size != null ? size : 20;
+
+        List<Account> accounts = accountUseCase.findAll(bsplCategory, pageNum, pageSize);
+        long totalCount = accountUseCase.count(bsplCategory);
+
+        return AccountConnection.of(accounts, pageNum, pageSize, totalCount);
+    }
+
+    @QueryMapping
+    public List<Account> accountHierarchy(@Argument String accountCode) {
+        return accountUseCase.findHierarchy(accountCode);
+    }
+
+    // === 課税取引 ===
+
+    @QueryMapping
+    public TaxTransaction taxTransaction(@Argument String taxCode) {
+        return accountUseCase.findTaxTransaction(taxCode)
+            .orElse(null);
+    }
+
+    @QueryMapping
+    public List<TaxTransaction> taxTransactions() {
+        return accountUseCase.findAllTaxTransactions();
+    }
+
+    // === 勘定科目構成 ===
+
+    @QueryMapping
+    public AccountConfig accountConfig(@Argument String accountCode) {
+        return accountUseCase.findAccountConfig(accountCode)
+            .orElse(null);
+    }
+
+    @QueryMapping
+    public List<AccountConfig> accountConfigs(@Argument String parentPath) {
+        if (parentPath != null) {
+            return accountUseCase.findAccountConfigsByPath(parentPath);
+        }
+        return accountUseCase.findAllAccountConfigs();
+    }
+}
+```
+
+</details>
+
+### 24.2 N+1 問題とは
+
+GraphQL では、ネストしたデータを取得する際に **N+1 問題** が発生しやすくなります。
+
+```plantuml
+@startuml n_plus_1_problem
+
+title N+1 問題の発生パターン
+
+participant "GraphQL Client" as client
+participant "AccountResolver" as resolver
+participant "TaxTransactionRepository" as repo
+database "PostgreSQL" as db
+
+client -> resolver : accounts(first: 10)
+resolver -> db : SELECT * FROM 勘定科目マスタ LIMIT 10
+db --> resolver : 10件の勘定科目
+
+loop 各勘定科目に対して（N回）
+  resolver -> repo : findByCode(taxCode)
+  repo -> db : SELECT * FROM 課税取引マスタ WHERE 課税取引コード = ?
+  db --> repo : 課税取引データ
+  repo --> resolver : 課税取引
+end
+
+resolver --> client : 勘定科目一覧（課税取引付き）
+
+note right of db
+  合計 11回のクエリ
+  (1 + N = 1 + 10)
+
+  勘定科目が100件なら101回！
+end note
+
+@enduml
+```
+
+### 24.3 DataLoader による解決
+
+**DataLoader** は、複数の個別リクエストをバッチ処理にまとめることで N+1 問題を解決します。
+
+```plantuml
+@startuml dataloader_solution
+
+title DataLoader による N+1 問題の解決
+
+participant "GraphQL Client" as client
+participant "AccountResolver" as resolver
+participant "TaxTransactionDataLoader" as loader
+participant "TaxTransactionRepository" as repo
+database "PostgreSQL" as db
+
+client -> resolver : accounts(first: 10)
+resolver -> db : SELECT * FROM 勘定科目マスタ LIMIT 10
+db --> resolver : 10件の勘定科目
+
+loop 各勘定科目に対して
+  resolver -> loader : load(taxCode)
+  note right of loader : キューに追加
+end
+
+loader -> repo : loadMany([code1, code2, ...code10])
+repo -> db : SELECT * FROM 課税取引マスタ WHERE 課税取引コード IN (?, ?, ..., ?)
+db --> repo : 課税取引データ
+repo --> loader : Map<課税取引コード, 課税取引>
+loader --> resolver : 各勘定科目の課税取引
+
+resolver --> client : 勘定科目一覧（課税取引付き）
+
+note right of db
+  合計 2回のクエリ
+  (1 + 1 = 2)
+
+  勘定科目が100件でも2回！
+end note
+
+@enduml
+```
+
+<details>
+<summary>TaxTransactionDataLoader.java</summary>
+
+```java
+package com.example.accounting.infrastructure.graphql.dataloader;
+
+import com.example.accounting.application.port.out.AccountRepository;
+import com.example.accounting.domain.model.account.TaxTransaction;
+import org.dataloader.BatchLoaderEnvironment;
+import org.dataloader.MappedBatchLoader;
+import org.springframework.stereotype.Component;
+
+import java.util.Map;
+import java.util.Set;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.CompletionStage;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+/**
+ * 課税取引データの DataLoader
+ */
+@Component
+public class TaxTransactionDataLoader implements MappedBatchLoader<String, TaxTransaction> {
+
+    private final AccountRepository accountRepository;
+
+    public TaxTransactionDataLoader(AccountRepository accountRepository) {
+        this.accountRepository = accountRepository;
+    }
+
+    @Override
+    public CompletionStage<Map<String, TaxTransaction>> load(
+            Set<String> taxCodes,
+            BatchLoaderEnvironment environment) {
+
+        return CompletableFuture.supplyAsync(() -> {
+            return accountRepository.findTaxTransactionsByCodes(taxCodes).stream()
+                .collect(Collectors.toMap(
+                    TaxTransaction::getTaxCode,
+                    Function.identity()
+                ));
+        });
+    }
+}
+```
+
+</details>
+
+### 24.4 勘定科目リゾルバの実装
+
+<details>
+<summary>AccountResolver.java</summary>
+
+```java
+package com.example.accounting.infrastructure.graphql.resolver;
+
+import com.example.accounting.application.port.in.AccountUseCase;
+import com.example.accounting.config.DataLoaderConfig;
+import com.example.accounting.domain.model.account.Account;
+import com.example.accounting.domain.model.account.TaxTransaction;
+import com.example.accounting.domain.model.account.AccountConfig;
+import com.example.accounting.domain.model.balance.DailyBalance;
+import com.example.accounting.infrastructure.graphql.dto.*;
+import graphql.schema.DataFetchingEnvironment;
+import org.dataloader.DataLoader;
+import org.springframework.graphql.data.method.annotation.Argument;
+import org.springframework.graphql.data.method.annotation.MutationMapping;
+import org.springframework.graphql.data.method.annotation.QueryMapping;
+import org.springframework.graphql.data.method.annotation.SchemaMapping;
+import org.springframework.stereotype.Controller;
+
+import java.util.List;
+import java.util.concurrent.CompletableFuture;
+
+/**
+ * 勘定科目 GraphQL リゾルバ
+ */
+@Controller
+public class AccountResolver {
+
+    private final AccountUseCase accountUseCase;
+
+    public AccountResolver(AccountUseCase accountUseCase) {
+        this.accountUseCase = accountUseCase;
+    }
+
+    // === Query ===
+
+    @QueryMapping
+    public Account account(@Argument String accountCode) {
+        return accountUseCase.findByCode(accountCode).orElse(null);
+    }
+
+    @QueryMapping
+    public AccountConnection accounts(
+            @Argument String bsplCategory,
+            @Argument Integer page,
+            @Argument Integer size) {
+
+        int pageNum = page != null ? page : 0;
+        int pageSize = size != null ? size : 20;
+
+        List<Account> accounts = accountUseCase.findAll(bsplCategory, pageNum, pageSize);
+        long totalCount = accountUseCase.count(bsplCategory);
+
+        return AccountConnection.of(accounts, pageNum, pageSize, totalCount);
+    }
+
+    // === Mutation ===
+
+    @MutationMapping
+    public Account createAccount(@Argument CreateAccountInput input) {
+        Account account = Account.builder()
+            .accountCode(input.accountCode())
+            .accountName(input.accountName())
+            .accountShortName(input.accountShortName())
+            .bsplCategory(input.bsplCategory())
+            .debitCreditCategory(input.debitCreditCategory())
+            .transactionElementCategory(input.transactionElementCategory())
+            .aggregationCategory(input.aggregationCategory())
+            .taxTransactionCode(input.taxTransactionCode())
+            .build();
+
+        return accountUseCase.create(account);
+    }
+
+    @MutationMapping
+    public boolean deleteAccount(@Argument String accountCode) {
+        return accountUseCase.delete(accountCode);
+    }
+
+    // === フィールドリゾルバ（DataLoader 使用）===
+
+    @SchemaMapping(typeName = "Account", field = "taxTransaction")
+    public CompletableFuture<TaxTransaction> taxTransaction(
+            Account account,
+            DataFetchingEnvironment env) {
+
+        if (account.getTaxTransactionCode() == null) {
+            return CompletableFuture.completedFuture(null);
+        }
+
+        DataLoader<String, TaxTransaction> loader =
+            env.getDataLoader(DataLoaderConfig.TAX_TRANSACTION_LOADER);
+
+        return loader.load(account.getTaxTransactionCode());
+    }
+
+    @SchemaMapping(typeName = "Account", field = "accountConfig")
+    public CompletableFuture<AccountConfig> accountConfig(
+            Account account,
+            DataFetchingEnvironment env) {
+
+        DataLoader<String, AccountConfig> loader =
+            env.getDataLoader(DataLoaderConfig.ACCOUNT_CONFIG_LOADER);
+
+        return loader.load(account.getAccountCode());
+    }
+
+    @SchemaMapping(typeName = "Account", field = "childAccounts")
+    public List<Account> childAccounts(Account account) {
+        return accountUseCase.findChildAccounts(account.getAccountCode());
+    }
+}
+```
+
+</details>
+
+---
+
+## 第 25 章：トランザクション API の実装
+
+### 25.1 仕訳リゾルバの実装
+
+<details>
+<summary>JournalResolver.java</summary>
+
+```java
+package com.example.accounting.infrastructure.graphql.resolver;
+
+import com.example.accounting.application.port.in.JournalUseCase;
+import com.example.accounting.config.DataLoaderConfig;
+import com.example.accounting.domain.model.journal.Journal;
+import com.example.accounting.domain.model.journal.JournalDetail;
+import com.example.accounting.domain.model.journal.JournalDebitCreditDetail;
+import com.example.accounting.domain.model.account.Account;
+import com.example.accounting.infrastructure.graphql.dto.*;
+import graphql.schema.DataFetchingEnvironment;
+import org.dataloader.DataLoader;
+import org.springframework.graphql.data.method.annotation.Argument;
+import org.springframework.graphql.data.method.annotation.MutationMapping;
+import org.springframework.graphql.data.method.annotation.QueryMapping;
+import org.springframework.graphql.data.method.annotation.SchemaMapping;
+import org.springframework.stereotype.Controller;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.List;
+import java.util.concurrent.CompletableFuture;
+
+/**
+ * 仕訳 GraphQL リゾルバ
+ */
+@Controller
+public class JournalResolver {
+
+    private final JournalUseCase journalUseCase;
+
+    public JournalResolver(JournalUseCase journalUseCase) {
+        this.journalUseCase = journalUseCase;
+    }
+
+    // === Query ===
+
+    @QueryMapping
+    public Journal journal(@Argument String journalNumber) {
+        return journalUseCase.findByNumber(journalNumber).orElse(null);
+    }
+
+    @QueryMapping
+    public JournalConnection journals(
+            @Argument LocalDate fromDate,
+            @Argument LocalDate toDate,
+            @Argument String accountCode,
+            @Argument Integer page,
+            @Argument Integer size) {
+
+        int pageNum = page != null ? page : 0;
+        int pageSize = size != null ? size : 20;
+
+        List<Journal> journals = journalUseCase.findAll(
+            fromDate, toDate, accountCode, pageNum, pageSize);
+        long totalCount = journalUseCase.count(fromDate, toDate, accountCode);
+
+        return JournalConnection.of(journals, pageNum, pageSize, totalCount);
+    }
+
+    // === Mutation ===
+
+    @MutationMapping
+    public Journal createJournal(@Argument CreateJournalInput input) {
+        Journal journal = Journal.builder()
+            .postingDate(input.postingDate())
+            .entryDate(LocalDate.now())
+            .isClosingEntry(input.isClosingEntry() != null ? input.isClosingEntry() : false)
+            .voucherType(input.voucherType())
+            .employeeCode(input.employeeCode())
+            .departmentCode(input.departmentCode())
+            .details(convertToDetails(input.details()))
+            .build();
+
+        // 貸借バランスチェック
+        validateBalance(journal);
+
+        return journalUseCase.create(journal);
+    }
+
+    @MutationMapping
+    public boolean deleteJournal(@Argument String journalNumber) {
+        return journalUseCase.delete(journalNumber);
+    }
+
+    @MutationMapping
+    public Journal reverseJournal(
+            @Argument String journalNumber,
+            @Argument String reason) {
+        return journalUseCase.reverse(journalNumber, reason);
+    }
+
+    // === フィールドリゾルバ ===
+
+    @SchemaMapping(typeName = "Journal", field = "totalDebitAmount")
+    public BigDecimal totalDebitAmount(Journal journal) {
+        return journal.getDetails().stream()
+            .flatMap(d -> d.getDebitCreditDetails().stream())
+            .filter(dc -> dc.getDebitCreditCategory().isDebit())
+            .map(JournalDebitCreditDetail::getAmount)
+            .reduce(BigDecimal.ZERO, BigDecimal::add);
+    }
+
+    @SchemaMapping(typeName = "Journal", field = "totalCreditAmount")
+    public BigDecimal totalCreditAmount(Journal journal) {
+        return journal.getDetails().stream()
+            .flatMap(d -> d.getDebitCreditDetails().stream())
+            .filter(dc -> dc.getDebitCreditCategory().isCredit())
+            .map(JournalDebitCreditDetail::getAmount)
+            .reduce(BigDecimal.ZERO, BigDecimal::add);
+    }
+
+    @SchemaMapping(typeName = "Journal", field = "isBalanced")
+    public boolean isBalanced(Journal journal) {
+        BigDecimal debit = totalDebitAmount(journal);
+        BigDecimal credit = totalCreditAmount(journal);
+        return debit.compareTo(credit) == 0;
+    }
+
+    @SchemaMapping(typeName = "JournalDebitCreditDetail", field = "account")
+    public CompletableFuture<Account> account(
+            JournalDebitCreditDetail detail,
+            DataFetchingEnvironment env) {
+
+        DataLoader<String, Account> loader =
+            env.getDataLoader(DataLoaderConfig.ACCOUNT_LOADER);
+
+        return loader.load(detail.getAccountCode());
+    }
+
+    // === Private Methods ===
+
+    private void validateBalance(Journal journal) {
+        BigDecimal debit = journal.getDetails().stream()
+            .flatMap(d -> d.getDebitCreditDetails().stream())
+            .filter(dc -> dc.getDebitCreditCategory().isDebit())
+            .map(JournalDebitCreditDetail::getAmount)
+            .reduce(BigDecimal.ZERO, BigDecimal::add);
+
+        BigDecimal credit = journal.getDetails().stream()
+            .flatMap(d -> d.getDebitCreditDetails().stream())
+            .filter(dc -> dc.getDebitCreditCategory().isCredit())
+            .map(JournalDebitCreditDetail::getAmount)
+            .reduce(BigDecimal.ZERO, BigDecimal::add);
+
+        if (debit.compareTo(credit) != 0) {
+            throw new IllegalArgumentException(
+                "貸借が一致しません。借方合計: " + debit + ", 貸方合計: " + credit);
+        }
+    }
+}
+```
+
+</details>
+
+### 25.2 GraphQL Subscription の実装
+
+GraphQL **Subscription** は、サーバーからクライアントへのリアルタイム通知を実現する仕組みです。
+
+```plantuml
+@startuml subscription_flow
+
+title GraphQL Subscription フロー
+
+participant "Client" as client
+participant "WebSocket" as ws
+participant "GraphQL Server" as server
+participant "EventPublisher" as publisher
+participant "JournalService" as service
+
+== Subscription 開始 ==
+client -> ws : subscription { balanceChanged }
+ws -> server : WebSocket 接続確立
+server -> publisher : 購読登録
+
+== 仕訳登録時 ==
+service -> publisher : 仕訳登録イベント発行
+publisher -> server : イベント受信
+server -> ws : BalanceChange データ送信
+ws -> client : リアルタイム通知
+
+== Subscription 終了 ==
+client -> ws : 接続終了
+ws -> server : WebSocket 切断
+server -> publisher : 購読解除
+
+@enduml
+```
+
+<details>
+<summary>SubscriptionResolver.java</summary>
+
+```java
+package com.example.accounting.infrastructure.graphql.subscription;
+
+import com.example.accounting.domain.event.BalanceChangeEvent;
+import com.example.accounting.domain.event.JournalCreatedEvent;
+import com.example.accounting.domain.event.ClosingProgressEvent;
+import com.example.accounting.infrastructure.graphql.dto.*;
+import org.springframework.graphql.data.method.annotation.Argument;
+import org.springframework.graphql.data.method.annotation.SubscriptionMapping;
+import org.springframework.stereotype.Controller;
+import reactor.core.publisher.Flux;
+
+/**
+ * GraphQL Subscription リゾルバ
+ */
+@Controller
+public class SubscriptionResolver {
+
+    private final BalanceEventPublisher balanceEventPublisher;
+    private final JournalEventPublisher journalEventPublisher;
+    private final ClosingEventPublisher closingEventPublisher;
+
+    public SubscriptionResolver(
+            BalanceEventPublisher balanceEventPublisher,
+            JournalEventPublisher journalEventPublisher,
+            ClosingEventPublisher closingEventPublisher) {
+        this.balanceEventPublisher = balanceEventPublisher;
+        this.journalEventPublisher = journalEventPublisher;
+        this.closingEventPublisher = closingEventPublisher;
+    }
+
+    @SubscriptionMapping
+    public Flux<BalanceChange> balanceChanged(@Argument String accountCode) {
+        Flux<BalanceChangeEvent> eventFlux = balanceEventPublisher.getEventFlux();
+
+        if (accountCode != null) {
+            eventFlux = eventFlux.filter(event ->
+                accountCode.equals(event.getAccountCode()));
+        }
+
+        return eventFlux.map(this::toBalanceChange);
+    }
+
+    @SubscriptionMapping
+    public Flux<JournalNotification> journalCreated() {
+        return journalEventPublisher.getEventFlux()
+            .map(this::toJournalNotification);
+    }
+
+    @SubscriptionMapping
+    public Flux<ClosingProgress> closingProgressUpdated(@Argument String closingId) {
+        return closingEventPublisher.getEventFlux()
+            .filter(event -> closingId.equals(event.getClosingId()))
+            .map(this::toClosingProgress);
+    }
+
+    private BalanceChange toBalanceChange(BalanceChangeEvent event) {
+        return new BalanceChange(
+            event.getAccountCode(),
+            event.getAccountName(),
+            event.getChangeType(),
+            event.getPreviousBalance(),
+            event.getCurrentBalance(),
+            event.getChangeAmount(),
+            event.getTimestamp()
+        );
+    }
+
+    private JournalNotification toJournalNotification(JournalCreatedEvent event) {
+        return new JournalNotification(
+            event.getJournalNumber(),
+            event.getPostingDate(),
+            event.getTotalDebitAmount(),
+            event.getTotalCreditAmount(),
+            event.getCreatedBy(),
+            event.getCreatedAt()
+        );
+    }
+
+    private ClosingProgress toClosingProgress(ClosingProgressEvent event) {
+        return new ClosingProgress(
+            event.getClosingId(),
+            event.getStatus(),
+            event.getCurrentStep(),
+            event.getProcessedCount(),
+            event.getTotalCount(),
+            event.getProgressPercent(),
+            event.getUpdatedAt()
+        );
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>BalanceEventPublisher.java</summary>
+
+```java
+package com.example.accounting.infrastructure.graphql.subscription;
+
+import com.example.accounting.domain.event.BalanceChangeEvent;
+import org.springframework.stereotype.Component;
+import reactor.core.publisher.Flux;
+import reactor.core.publisher.Sinks;
+
+/**
+ * 残高変動イベントパブリッシャー
+ */
+@Component
+public class BalanceEventPublisher {
+
+    private final Sinks.Many<BalanceChangeEvent> sink;
+
+    public BalanceEventPublisher() {
+        this.sink = Sinks.many().multicast().onBackpressureBuffer();
+    }
+
+    public void publish(BalanceChangeEvent event) {
+        sink.tryEmitNext(event);
+    }
+
+    public Flux<BalanceChangeEvent> getEventFlux() {
+        return sink.asFlux();
+    }
+}
+```
+
+</details>
+
+---
+
+## 第 26 章：エラーハンドリングとバリデーション
+
+### 26.1 GraphQL エラー設計
+
+GraphQL では、エラーは `errors` フィールドとして返されます。
+
+```plantuml
+@startuml graphql_error_handling
+
+title GraphQL エラーハンドリング
+
+package "GraphQL Layer" {
+  [GraphQL Error Handler]
+}
+
+package "Application Layer" {
+  [Use Case Exception]
+}
+
+package "Domain Layer" {
+  [Domain Exception]
+}
+
+[Domain Exception] --> [Use Case Exception] : 伝播
+[Use Case Exception] --> [GraphQL Error Handler] : 伝播
+
+note right of [Domain Exception]
+  ビジネスルール違反
+  - 貸借不一致
+  - 科目未登録
+  - 決算済み期間
+end note
+
+note right of [Use Case Exception]
+  ユースケース固有
+  - リソース未発見
+  - バリデーションエラー
+  - 権限不足
+end note
+
+note right of [GraphQL Error Handler]
+  GraphQL エラー形式に変換
+  - エラーコード
+  - エラーメッセージ
+  - エラー詳細
+end note
+
+@enduml
+```
+
+### 26.2 カスタム例外クラス
+
+<details>
+<summary>AccountingException.java（基底クラス）</summary>
+
+```java
+package com.example.accounting.domain.exception;
+
+/**
+ * 財務会計ドメイン例外の基底クラス
+ */
+public abstract class AccountingException extends RuntimeException {
+
+    private final String errorCode;
+
+    protected AccountingException(String errorCode, String message) {
+        super(message);
+        this.errorCode = errorCode;
+    }
+
+    protected AccountingException(String errorCode, String message, Throwable cause) {
+        super(message, cause);
+        this.errorCode = errorCode;
+    }
+
+    public String getErrorCode() {
+        return errorCode;
+    }
+}
+```
+
+</details>
+
+<details>
+<summary>BalanceNotMatchException.java</summary>
+
+```java
+package com.example.accounting.domain.exception;
+
+import java.math.BigDecimal;
+
+/**
+ * 貸借不一致例外
+ */
+public class BalanceNotMatchException extends AccountingException {
+
+    private final BigDecimal debitTotal;
+    private final BigDecimal creditTotal;
+
+    public BalanceNotMatchException(BigDecimal debitTotal, BigDecimal creditTotal) {
+        super("BALANCE_NOT_MATCH",
+            String.format("貸借が一致しません。借方合計: %s, 貸方合計: %s", debitTotal, creditTotal));
+        this.debitTotal = debitTotal;
+        this.creditTotal = creditTotal;
+    }
+
+    public BigDecimal getDebitTotal() {
+        return debitTotal;
+    }
+
+    public BigDecimal getCreditTotal() {
+        return creditTotal;
+    }
+}
+```
+
+</details>
+
+### 26.3 GraphQL 例外ハンドラー
+
+<details>
+<summary>GraphQLExceptionHandler.java</summary>
+
+```java
+package com.example.accounting.infrastructure.graphql.exception;
+
+import com.example.accounting.domain.exception.*;
+import graphql.GraphQLError;
+import graphql.GraphqlErrorBuilder;
+import graphql.schema.DataFetchingEnvironment;
+import org.springframework.graphql.execution.DataFetcherExceptionResolverAdapter;
+import org.springframework.graphql.execution.ErrorType;
+import org.springframework.stereotype.Component;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * GraphQL 例外ハンドラー
+ */
+@Component
+public class GraphQLExceptionHandler extends DataFetcherExceptionResolverAdapter {
+
+    @Override
+    protected GraphQLError resolveToSingleError(Throwable ex, DataFetchingEnvironment env) {
+        if (ex instanceof AccountingException accountingEx) {
+            return handleAccountingException(accountingEx, env);
+        }
+
+        if (ex instanceof IllegalArgumentException) {
+            return GraphqlErrorBuilder.newError(env)
+                .errorType(ErrorType.BAD_REQUEST)
+                .message(ex.getMessage())
+                .build();
+        }
+
+        // その他の例外
+        return GraphqlErrorBuilder.newError(env)
+            .errorType(ErrorType.INTERNAL_ERROR)
+            .message("内部エラーが発生しました")
+            .build();
+    }
+
+    private GraphQLError handleAccountingException(
+            AccountingException ex, DataFetchingEnvironment env) {
+
+        Map<String, Object> extensions = new HashMap<>();
+        extensions.put("errorCode", ex.getErrorCode());
+
+        ErrorType errorType = mapToErrorType(ex);
+
+        // 例外固有の情報を追加
+        if (ex instanceof BalanceNotMatchException balanceEx) {
+            extensions.put("debitTotal", balanceEx.getDebitTotal());
+            extensions.put("creditTotal", balanceEx.getCreditTotal());
+        } else if (ex instanceof AccountNotFoundException accountEx) {
+            extensions.put("accountCode", accountEx.getAccountCode());
+        }
+
+        return GraphqlErrorBuilder.newError(env)
+            .errorType(errorType)
+            .message(ex.getMessage())
+            .extensions(extensions)
+            .build();
+    }
+
+    private ErrorType mapToErrorType(AccountingException ex) {
+        if (ex instanceof AccountNotFoundException ||
+            ex instanceof JournalNotFoundException) {
+            return ErrorType.NOT_FOUND;
+        }
+
+        if (ex instanceof BalanceNotMatchException ||
+            ex instanceof ClosedPeriodException) {
+            return ErrorType.BAD_REQUEST;
+        }
+
+        return ErrorType.INTERNAL_ERROR;
+    }
+}
+```
+
+</details>
+
+### 26.4 Spring for GraphQL テスト
+
+<details>
+<summary>AccountResolverTest.java</summary>
+
+```java
+package com.example.accounting.infrastructure.graphql;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.autoconfigure.graphql.tester.AutoConfigureHttpGraphQlTester;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.graphql.test.tester.HttpGraphQlTester;
+import org.springframework.test.context.DynamicPropertyRegistry;
+import org.springframework.test.context.DynamicPropertySource;
+import org.testcontainers.containers.PostgreSQLContainer;
+import org.testcontainers.junit.jupiter.Container;
+import org.testcontainers.junit.jupiter.Testcontainers;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
+@AutoConfigureHttpGraphQlTester
+@Testcontainers
+class AccountResolverTest {
+
+    @Container
+    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16-alpine");
+
+    @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 HttpGraphQlTester graphQlTester;
+
+    @Test
+    void testQueryAccount() {
+        // language=GraphQL
+        String query = """
+            query {
+                account(accountCode: "11110") {
+                    accountCode
+                    accountName
+                    bsplCategory
+                    debitCreditCategory
+                }
+            }
+            """;
+
+        graphQlTester.document(query)
+            .execute()
+            .path("account.accountCode")
+            .entity(String.class)
+            .isEqualTo("11110");
+    }
+
+    @Test
+    void testMutationCreateAccount() {
+        // language=GraphQL
+        String mutation = """
+            mutation {
+                createAccount(input: {
+                    accountCode: "99999"
+                    accountName: "テスト科目"
+                    bsplCategory: BS
+                    debitCreditCategory: DEBIT
+                    transactionElementCategory: ASSET
+                    aggregationCategory: POSTING
+                }) {
+                    accountCode
+                    accountName
+                }
+            }
+            """;
+
+        graphQlTester.document(mutation)
+            .execute()
+            .path("createAccount.accountCode")
+            .entity(String.class)
+            .isEqualTo("99999");
+    }
+}
+```
+
+</details>
+
+### 26.5 GraphiQL による動作確認
+
+サーバー起動後、`http://localhost:8080/graphiql` にアクセスして対話的にクエリを実行できます。
+
+```graphql
+# 勘定科目の取得
+query {
+  account(accountCode: "11110") {
+    accountCode
+    accountName
+    bsplCategory
+    debitCreditCategory
+    taxTransaction {
+      taxCode
+      taxName
+      taxRate
+    }
+    dailyBalances {
+      postingDate
+      debitAmount
+      creditAmount
+      balance
+    }
+  }
+}
+
+# 仕訳登録
+mutation {
+  createJournal(input: {
+    postingDate: "2025-12-29"
+    voucherType: NORMAL
+    details: [
+      {
+        lineNumber: 1
+        description: "現金売上"
+        debitCreditDetails: [
+          {
+            debitCreditCategory: DEBIT
+            accountCode: "11110"
+            amount: "100000"
+          }
+          {
+            debitCreditCategory: CREDIT
+            accountCode: "41100"
+            amount: "100000"
+          }
+        ]
+      }
+    ]
+  }) {
+    journalNumber
+    postingDate
+    totalDebitAmount
+    totalCreditAmount
+    isBalanced
+  }
+}
+
+# 試算表
+query {
+  trialBalance(fiscalYear: 2025, month: 12) {
+    fiscalYear
+    month
+    entries {
+      accountCode
+      accountName
+      bsplCategory
+      debitAmount
+      creditAmount
+      debitBalance
+      creditBalance
+    }
+    totalDebitAmount
+    totalCreditAmount
+  }
+}
+```
+
+---
+
+## 第 27 章：まとめと発展
+
+### 27.1 GraphQL 実装の振り返り
+
+```plantuml
+@startuml graphql_summary
+
+title 財務会計システム GraphQL 実装全体像
+
+package "GraphQL Schema" {
+  [schema.graphqls]
+  [account.graphqls]
+  [journal.graphqls]
+  [balance.graphqls]
+  [report.graphqls]
+}
+
+package "Resolvers" {
+  [QueryResolver]
+  [AccountResolver]
+  [JournalResolver]
+  [BalanceResolver]
+  [ReportResolver]
+  [SubscriptionResolver]
+}
+
+package "DataLoaders" {
+  [TaxTransactionDataLoader]
+  [DailyBalanceDataLoader]
+  [MonthlyBalanceDataLoader]
+  [AccountConfigDataLoader]
+}
+
+package "Application Layer" {
+  [AccountUseCase]
+  [JournalUseCase]
+  [BalanceUseCase]
+  [ReportUseCase]
+}
+
+package "Infrastructure" {
+  [MyBatis Repository]
+  [Event Publisher]
+  [PostgreSQL]
+}
+
+[schema.graphqls] --> [QueryResolver]
+[QueryResolver] --> [AccountUseCase]
+[AccountResolver] --> [TaxTransactionDataLoader]
+[AccountResolver] --> [DailyBalanceDataLoader]
+[JournalResolver] --> [JournalUseCase]
+[SubscriptionResolver] --> [Event Publisher]
+
+[AccountUseCase] --> [MyBatis Repository]
+[MyBatis Repository] --> [PostgreSQL]
+
+@enduml
+```
+
+### 27.2 REST / gRPC / GraphQL の使い分け
+
+| 観点 | REST API | gRPC | GraphQL |
+|------|----------|------|---------|
+| **クライアント** | Web ブラウザ、外部連携 | マイクロサービス間 | SPA、モバイルアプリ |
+| **データ量** | 固定レスポンス | 固定レスポンス | クライアント指定 |
+| **リアルタイム** | WebSocket 別実装 | ストリーミング | Subscription |
+| **型安全性** | △（OpenAPI） | ◎（.proto） | ◎（.graphqls） |
+| **学習コスト** | 低 | 中 | 中 |
+| **ブラウザ対応** | ◎ | △（gRPC-Web） | ◎ |
+
+```plantuml
+@startuml api_usage
+
+title API 使い分けパターン
+
+package "フロントエンド" {
+  [経理担当者 Web UI] as web
+  [経営ダッシュボード] as dashboard
+  [Excel アドイン] as excel
+}
+
+package "バックエンド" {
+  [財務会計システム] as accounting
+}
+
+package "連携システム" {
+  [販売管理システム] as sales
+  [購買管理システム] as purchase
+  [人事給与システム] as hr
+}
+
+web --> accounting : GraphQL\n(柔軟なクエリ)
+dashboard --> accounting : GraphQL\n(リアルタイム更新)
+excel --> accounting : REST API\n(シンプルな連携)
+
+sales --> accounting : gRPC\n(高性能・自動仕訳)
+purchase --> accounting : gRPC\n(高性能・自動仕訳)
+hr --> accounting : gRPC\n(給与仕訳連携)
+
+@enduml
+```
+
+### 27.3 ヘキサゴナルアーキテクチャの利点
+
+複数の API 形式を同時提供できるのは、ヘキサゴナルアーキテクチャの恩恵です。
+
+```plantuml
+@startuml hexagonal_benefit
+
+title 複数 API の同時提供
+
+package "Input Adapters" {
+  [REST Controller]
+  [gRPC Service]
+  [GraphQL Resolver]
+}
+
+package "Application Core" {
+  [AccountUseCase]
+  [JournalUseCase]
+  [BalanceUseCase]
+}
+
+package "Output Adapters" {
+  [MyBatis Repository]
+}
+
+[REST Controller] --> [AccountUseCase]
+[gRPC Service] --> [AccountUseCase]
+[GraphQL Resolver] --> [AccountUseCase]
+
+[REST Controller] --> [JournalUseCase]
+[gRPC Service] --> [JournalUseCase]
+[GraphQL Resolver] --> [JournalUseCase]
+
+note top of [Application Core]
+  ビジネスロジックは
+  API 形式に依存しない
+
+  1つのコードベースで
+  複数の API を提供
+end note
+
+@enduml
+```
+
+### 27.4 今後の発展
+
+本パートで構築した GraphQL サービスをベースに、以下の拡張が可能です：
+
+1. **認証・認可**: Spring Security + JWT による GraphQL 認証
+2. **キャッシュ**: Redis によるクエリ結果キャッシュ
+3. **監視**: GraphQL メトリクスの収集と監視
+4. **フェデレーション**: Apollo Federation による複数サービス統合
+5. **コード生成**: GraphQL Code Generator によるクライアントコード自動生成
+
+### 27.5 学習した内容
+
+1. **GraphQL の基本概念**: Query、Mutation、Subscription の 3 つの操作タイプ
+2. **スキーマ駆動開発**: `.graphqls` ファイルによる型安全な API 定義
+3. **N+1 問題と DataLoader**: バッチ処理によるパフォーマンス最適化
+4. **リゾルバ実装**: `@QueryMapping`、`@MutationMapping`、`@SchemaMapping`
+5. **Subscription**: WebSocket によるリアルタイム通知
+6. **エラーハンドリング**: カスタム例外と GraphQL エラー形式への変換
+7. **テスト**: `HttpGraphQlTester` による統合テスト