npm - @k2works/claude-code-booster - Versions diffs - 4.13.0 → 4.14.0 - Mend

@k2works/claude-code-booster 4.13.0 → 4.14.0

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

Files changed (751) hide show

package/lib/assets/docs/article/practical-database-design/part3-orm/chapter14-orm.md CHANGED Viewed

@@ -1,991 +1,991 @@
-# 第14章：財務会計システムの全体像（ORM版）
-本章では、財務会計システムの全体像を把握し、Spring Data JPA を使用した ORM 実装のアーキテクチャについて解説します。MyBatis 版との違いを比較しながら、JPA の特徴を活かした設計手法を学びます。
----
-## 14.1 財務会計システムのスコープ
-### 基幹業務システムにおける位置づけ
-財務会計システムは、基幹業務システムの中で他のシステムから仕訳データを受け取り、企業の財務状態を管理する重要なシステムです。
-```plantuml
-@startuml
-title 基幹業務システムの全体像
-state "得意先\n(Customer)" as Customer
-state "販売管理\n(Sales Management)" as SalesManagement
-SalesManagement : ・受注 \n・出荷 \n・売上
-state "購買管理\n(Procurement Management)" as ProcurementManagement
-ProcurementManagement : ・発注\n・入荷/受入\n・仕入(検収)
-state "在庫\n(Inventory)" as Inventory
-state "仕入先\n(Supplier)" as Supplier
-state "生産管理\n(Production Management)" as ProductionManagement
-ProductionManagement : ・生産計画\n・品質管理\n・工程管理\n・製造原価管理
-state "債権管理\n(Accounts Receivable)" as AccountsReceivable
-AccountsReceivable : ・請求 \n・入金
-state "債務管理\n(Accounts Payable)" as AccountsPayable
-AccountsPayable : ・支払\n・出金
-state "財務会計\n(Financial Accounting)" as Accounting #LightBlue
-Accounting : ・勘定科目管理\n・仕訳処理\n・残高管理\n・財務諸表\n・決算処理
-[*] -> Customer
-Customer --> SalesManagement
-SalesManagement --> AccountsReceivable
-SalesManagement --> ProcurementManagement : 調達依頼
-SalesManagement --> ProductionManagement : 需要予測 \n製造指示
-SalesManagement --> Accounting : 仕訳
-SalesManagement --> Customer
-Inventory --> SalesManagement
-ProcurementManagement --> Inventory
-ProcurementManagement --> AccountsPayable
-ProcurementManagement --> Supplier
-Supplier --> ProcurementManagement
-ProductionManagement --> ProcurementManagement : 調達依頼
-ProductionManagement --> Inventory : 入荷
-Inventory --> ProductionManagement : 払出
-AccountsReceivable --> Accounting
-AccountsPayable --> Accounting
-ProductionManagement --> Accounting : 仕訳
-ProcurementManagement --> Accounting : 仕訳
-Customer -> [*]
-@enduml
-```
-### 財務会計システムの業務領域
-財務会計システムは、以下の業務領域をカバーします。
-```plantuml
-@startuml
-[*] -> 販売管理
-販売管理 --> 財務会計 : 売上仕訳
-販売管理 : 売掛金 / 売上
-[*] -> 購買管理
-購買管理 --> 財務会計 : 仕入仕訳
-購買管理 : 仕入 / 買掛金
-[*] -> 債権管理
-債権管理 --> 財務会計 : 入金仕訳
-債権管理 : 現金預金 / 売掛金
-[*] -> 債務管理
-債務管理 --> 財務会計 : 支払仕訳
-債務管理 : 買掛金 / 現金預金
-財務会計 --> 帳票出力
-財務会計 : 勘定科目管理 \n仕訳処理 \n残高管理
-帳票出力 : 日計表 \n合計残高試算表 \n財務諸表
-帳票出力 -> [*]
-@enduml
-```
-### 業務機能の概要
-| 業務 | 説明 |
-|------|------|
-| **勘定科目管理** | 勘定科目マスタ・勘定科目構成マスタの管理 |
-| **仕訳処理** | 仕訳入力・自動仕訳・仕訳照会 |
-| **残高管理** | 日次残高・月次残高の管理 |
-| **帳票出力** | 日計表・合計残高試算表・財務諸表の出力 |
-| **決算処理** | 月次決算・年次決算 |
-### ユースケース図
-財務会計システム全体のユースケースは以下の通りです。
-```plantuml
-@startuml
-left to right direction
-skinparam packageStyle rectangle
-skinparam linetype ortho
-title 財務会計システム ユースケース図
-actor 経理担当者 as accounting
-actor 財務担当者 as finance
-actor 営業担当者 as sales
-actor 購買担当者 as buyer
-actor 管理者 as admin
-rectangle 財務会計システム {
-    usecase "勘定科目管理" as UC_ACCOUNT
-    usecase "仕訳入力" as UC_JOURNAL
-    usecase "自動仕訳" as UC_AUTO_JOURNAL
-    usecase "残高照会" as UC_BALANCE
-    usecase "日計表出力" as UC_DAILY
-    usecase "試算表出力" as UC_TRIAL
-    usecase "財務諸表出力" as UC_FINANCIAL
-    usecase "決算処理" as UC_CLOSING
-}
-admin -- UC_ACCOUNT
-accounting -- UC_JOURNAL
-accounting -- UC_BALANCE
-accounting -- UC_DAILY
-accounting -- UC_TRIAL
-accounting -- UC_CLOSING
-finance -- UC_FINANCIAL
-sales -- UC_AUTO_JOURNAL
-buyer -- UC_AUTO_JOURNAL
-@enduml
-```
----
-## 14.2 ORM アーキテクチャの概要
-### MyBatis 版と JPA 版の比較
-本章では、MyBatis 版と同じビジネスロジックを Spring Data JPA で実装します。ORM の違いによるアプローチの差異を理解することが目的です。
-| 観点 | MyBatis 版 | JPA 版 |
-|------|-----------|--------|
-| マッピング方法 | XML Mapper + resultMap | @Entity + @Column |
-| ENUM 変換 | TypeHandler | AttributeConverter |
-| Repository | Mapper インターフェース + XML | JpaRepository インターフェース |
-| SQL | XML で明示的に記述 | メソッド名規約で自動生成 |
-| テスト基底クラス | @MybatisTest | @DataJpaTest |
-| N+1 問題対策 | 明示的な JOIN | @EntityGraph, JPQL JOIN FETCH |
-### JPA の特徴
-```plantuml
-@startuml
-title JPA / Hibernate の特徴
-package "JPA (Java Persistence API)" {
-    rectangle entity [
-        <b>Entity</b>
-        --
-        - @Entity
-        - @Table
-        - @Column
-        - @Id
-    ]
-    rectangle relations [
-        <b>Relationships</b>
-        --
-        - @OneToMany
-        - @ManyToOne
-        - @ManyToMany
-        - @Embedded
-    ]
-    rectangle query [
-        <b>Query</b>
-        --
-        - JPQL
-        - Criteria API
-        - Native Query
-        - メソッド名規約
-    ]
-}
-package "Spring Data JPA" {
-    rectangle repo [
-        <b>Repository</b>
-        --
-        - JpaRepository
-        - @Query
-        - Specification
-        - @EntityGraph
-    ]
-}
-' 関係線の定義
-entity --> relations
-entity --> query
-query --> repo
-note right of entity
-  オブジェクト指向の
-  マッピング定義
-end note
-note right of repo
-  Repository パターンの
-  自動実装
-end note
-@enduml
-```
----
-## 14.3 プロジェクト構成
-### ヘキサゴナルアーキテクチャ
-財務会計システムは、ヘキサゴナルアーキテクチャ（ポート&アダプターパターン）を採用します。
-```
-src/main/java/com/example/accounting/
-├── application/                    # アプリケーション層
-│   └── port/
-│       └── out/                   # Output Port（リポジトリインターフェース）
-│           └── AccountRepository.java
-├── domain/                         # ドメイン層（純粋なビジネスロジック）
-│   └── model/                     # ドメインモデル
-│       └── account/
-│           ├── Account.java       # @Entity アノテーション付き
-│           ├── BsPlType.java
-│           ├── DebitCreditType.java
-│           ├── TransactionElementType.java
-│           ├── AggregationType.java
-│           └── TaxCalculationType.java
-├── infrastructure/                 # インフラストラクチャ層
-│   └── persistence/
-│       ├── converter/             # JPA AttributeConverter
-│       │   ├── BsPlTypeConverter.java
-│       │   ├── DebitCreditTypeConverter.java
-│       │   ├── TransactionElementTypeConverter.java
-│       │   ├── AggregationTypeConverter.java
-│       │   └── TaxCalculationTypeConverter.java
-│       └── repository/            # Repository実装
-│           ├── AccountJpaRepository.java  # Spring Data JPA
-│           └── AccountRepositoryImpl.java
-└── config/
-    └── JpaConfig.java
-src/main/resources/
-├── db/migration/
-│   └── V001__create_enum_types.sql
-└── application.yml
-```
-### アーキテクチャ図
-```plantuml
-@startuml hexagonal_architecture_jpa
-!define RECTANGLE class
-package "Hexagonal Architecture (財務会計API - JPA版)" {
-  RECTANGLE "Application Core\n(Domain + Use Cases)" as core {
-    - Account (勘定科目)
-    - Journal (仕訳)
-    - JournalEntry (仕訳明細)
-    - DailyBalance (日次残高)
-    - MonthlyBalance (月次残高)
-    - AccountUseCase
-    - JournalUseCase
-    - BalanceUseCase
-  }
-  RECTANGLE "Input Adapters\n(Driving Side)" as input {
-    - Spring Controllers
-    - REST API Endpoints
-    - Request Validation
-    - Error Handling
-  }
-  RECTANGLE "Output Adapters\n(Driven Side)" as output {
-    - Spring Data JPA Repository
-    - AttributeConverter
-    - Entity Mapping
-  }
-}
-input --> core : "Input Ports\n(Use Cases)"
-core --> output : "Output Ports\n(Repository Interfaces)"
-note top of core
-  純粋なビジネスロジック
-  JPA アノテーションは
-  ドメイン層に配置
-end note
-note left of input
-  外部からアプリケーションを
-  駆動するアダプター
-  HTTP, REST等
-end note
-note right of output
-  アプリケーションが外部の
-  技術を使うためのアダプター
-  PostgreSQL, Hibernate等
-end note
-@enduml
-```
----
-## 14.4 環境構築
-### 前提条件
-以下のツールがインストールされていることを確認してください。
-- Java 17以上（推奨：Java 21 LTS）
-- Gradle 8.x以上（推奨：Gradle Wrapper使用）
-- Docker & Docker Compose（推奨）
-- Git
-### build.gradle の設定
-<details>
-<summary>build.gradle</summary>
-```groovy
-plugins {
-    id 'java'
-    id 'application'
-    id 'jacoco'
-    id 'org.springframework.boot' version '3.2.0'
-    id 'io.spring.dependency-management' version '1.1.4'
-}
-group = 'com.example.accounting'
-version = '0.0.1-SNAPSHOT'
-java {
-    sourceCompatibility = '21'
-}
-repositories {
-    mavenCentral()
-}
-dependencies {
-    // Spring Boot
-    implementation 'org.springframework.boot:spring-boot-starter-web'
-    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
-    implementation 'org.springframework.boot:spring-boot-starter-validation'
-    testImplementation 'org.springframework.boot:spring-boot-starter-test'
-    // Flyway
-    implementation 'org.flywaydb:flyway-core'
-    implementation 'org.flywaydb:flyway-database-postgresql'
-    // Database
-    runtimeOnly 'org.postgresql:postgresql'
-    // Lombok (オプション)
-    compileOnly 'org.projectlombok:lombok'
-    annotationProcessor 'org.projectlombok:lombok'
-    // Test
-    testImplementation 'org.junit.jupiter:junit-jupiter-api'
-    testImplementation 'org.junit.jupiter:junit-jupiter-params'
-    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine'
-    testImplementation 'org.assertj:assertj-core:3.24.2'
-    testImplementation 'org.testcontainers:testcontainers:1.19.3'
-    testImplementation 'org.testcontainers:postgresql:1.19.3'
-    testImplementation 'org.testcontainers:junit-jupiter:1.19.3'
-}
-test {
-    useJUnitPlatform()
-}
-jacoco {
-    toolVersion = "0.8.11"
-}
-jacocoTestReport {
-    dependsOn test
-    reports {
-        xml.required = true
-        html.required = true
-    }
-}
-```
-</details>
-### Docker Compose のセットアップ
-<details>
-<summary>docker-compose.yml</summary>
-```yaml
-services:
-  postgres:
-    image: postgres:16-alpine
-    container_name: financial-accounting-postgres-jpa
-    restart: unless-stopped
-    environment:
-      POSTGRES_USER: ${POSTGRES_USER:-postgres}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
-      POSTGRES_DB: ${POSTGRES_DB:-financial_accounting}
-      TZ: 'Asia/Tokyo'
-    ports:
-      - "${POSTGRES_PORT:-5432}:5432"
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres}"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-volumes:
-  postgres_data:
-```
-</details>
-### application.yml の設定
-<details>
-<summary>application.yml</summary>
-```yaml
-spring:
-  application:
-    name: financial-accounting-jpa
-  datasource:
-    url: jdbc:postgresql://localhost:5432/financial_accounting
-    username: postgres
-    password: postgres
-    driver-class-name: org.postgresql.Driver
-  jpa:
-    hibernate:
-      ddl-auto: validate  # Flyway でスキーマ管理するため validate
-    show-sql: true
-    properties:
-      hibernate:
-        format_sql: true
-        dialect: org.hibernate.dialect.PostgreSQLDialect
-  flyway:
-    enabled: true
-    locations: classpath:db/migration
-logging:
-  level:
-    org.hibernate.SQL: DEBUG
-    org.hibernate.type.descriptor.sql.BasicBinder: TRACE
-```
-</details>
-### PostgreSQL ENUM の定義
-<details>
-<summary>V001__create_enum_types.sql</summary>
-```sql
--- BSPL区分（貸借対照表・損益計算書）
-CREATE TYPE BSPL区分 AS ENUM ('BS', 'PL');
--- 貸借区分
-CREATE TYPE 貸借区分 AS ENUM ('借方', '貸方');
--- 取引要素区分
-CREATE TYPE 取引要素区分 AS ENUM ('資産', '負債', '資本', '収益', '費用');
--- 集計区分
-CREATE TYPE 集計区分 AS ENUM ('見出科目', '集計科目', '計上科目');
--- 消費税計算区分
-CREATE TYPE 消費税計算区分 AS ENUM ('課税', '非課税', '不課税', '免税');
-```
-</details>
----
-## 14.5 JPA エンティティの基本
-### 日本語テーブル名・カラム名のマッピング
-本シリーズでは、**日本語テーブル名・日本語カラム名**を使用します。JPA では、`@Table` と `@Column` アノテーションを使ってマッピングします。
-| 項目 | 例 |
-|-----|-----|
-| テーブル名 | `勘定科目マスタ`, `仕訳データ`, `日次勘定科目残高` |
-| カラム名 | `勘定科目コード`, `勘定科目名`, `BSPL区分` |
-| ENUM名 | `BSPL区分`, `貸借区分`, `集計区分` |
-| ENUM値 | `BS`, `PL`, `借方`, `貸方` |
-### エンティティクラスの例
-<details>
-<summary>Account.java（勘定科目エンティティ）</summary>
-```java
-package com.example.accounting.domain.model.account;
-import jakarta.persistence.*;
-import lombok.*;
-import java.time.LocalDateTime;
-@Entity
-@Table(name = "勘定科目マスタ")
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Account {
-    @Id
-    @Column(name = "勘定科目コード", length = 5)
-    private String accountCode;
-    @Column(name = "勘定科目名", length = 40, nullable = false)
-    private String accountName;
-    @Column(name = "勘定科目略名", length = 10)
-    private String accountShortName;
-    @Column(name = "勘定科目カナ", length = 40)
-    private String accountNameKana;
-    @Convert(converter = BsPlTypeConverter.class)
-    @Column(name = "BSPL区分", nullable = false, columnDefinition = "BSPL区分")
-    private BsPlType bsPlType;
-    @Convert(converter = DebitCreditTypeConverter.class)
-    @Column(name = "貸借区分", nullable = false, columnDefinition = "貸借区分")
-    private DebitCreditType debitCreditType;
-    @Convert(converter = TransactionElementTypeConverter.class)
-    @Column(name = "取引要素区分", nullable = false, columnDefinition = "取引要素区分")
-    private TransactionElementType transactionElementType;
-    @Convert(converter = AggregationTypeConverter.class)
-    @Column(name = "集計区分", nullable = false, columnDefinition = "集計区分")
-    private AggregationType aggregationType;
-    @Column(name = "管理会計区分", length = 1)
-    private String managementAccountingType;
-    @Column(name = "費用区分", length = 1)
-    private String expenseType;
-    @Column(name = "元帳出力区分", length = 1)
-    private String ledgerOutputType;
-    @Column(name = "補助科目種別", length = 1)
-    private String subAccountType;
-    @Convert(converter = TaxCalculationTypeConverter.class)
-    @Column(name = "消費税計算区分", columnDefinition = "消費税計算区分")
-    private TaxCalculationType taxCalculationType;
-    @Column(name = "課税取引コード", length = 2)
-    private String taxTransactionCode;
-    @Column(name = "期日管理区分", length = 1)
-    private String dueDateManagementType;
-    @Column(name = "作成日時")
-    private LocalDateTime createdAt;
-    @Column(name = "更新日時")
-    private LocalDateTime updatedAt;
-    @Column(name = "更新者名", length = 12)
-    private String updatedBy;
-    @PrePersist
-    protected void onCreate() {
-        createdAt = LocalDateTime.now();
-        updatedAt = LocalDateTime.now();
-    }
-    @PreUpdate
-    protected void onUpdate() {
-        updatedAt = LocalDateTime.now();
-    }
-}
-```
-</details>
-### ENUM 定義
-<details>
-<summary>BsPlType.java（BSPL区分）</summary>
-```java
-package com.example.accounting.domain.model.account;
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-@Getter
-@RequiredArgsConstructor
-public enum BsPlType {
-    BS("BS"),  // 貸借対照表
-    PL("PL");  // 損益計算書
-    private final String displayName;
-    public static BsPlType fromDisplayName(String displayName) {
-        for (BsPlType type : values()) {
-            if (type.displayName.equals(displayName)) {
-                return type;
-            }
-        }
-        throw new IllegalArgumentException("不正なBSPL区分: " + displayName);
-    }
-}
-```
-</details>
-<details>
-<summary>DebitCreditType.java（貸借区分）</summary>
-```java
-package com.example.accounting.domain.model.account;
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-@Getter
-@RequiredArgsConstructor
-public enum DebitCreditType {
-    DEBIT("借方"),
-    CREDIT("貸方");
-    private final String displayName;
-    public static DebitCreditType fromDisplayName(String displayName) {
-        for (DebitCreditType type : values()) {
-            if (type.displayName.equals(displayName)) {
-                return type;
-            }
-        }
-        throw new IllegalArgumentException("不正な貸借区分: " + displayName);
-    }
-}
-```
-</details>
-### AttributeConverter
-JPA では `AttributeConverter` を使って PostgreSQL ENUM と Java Enum を変換します。
-<details>
-<summary>BsPlTypeConverter.java</summary>
-```java
-package com.example.accounting.infrastructure.persistence.converter;
-import com.example.accounting.domain.model.account.BsPlType;
-import jakarta.persistence.AttributeConverter;
-import jakarta.persistence.Converter;
-@Converter(autoApply = true)
-public class BsPlTypeConverter implements AttributeConverter<BsPlType, String> {
-    @Override
-    public String convertToDatabaseColumn(BsPlType attribute) {
-        return attribute != null ? attribute.getDisplayName() : null;
-    }
-    @Override
-    public BsPlType convertToEntityAttribute(String dbData) {
-        return dbData != null ? BsPlType.fromDisplayName(dbData) : null;
-    }
-}
-```
-</details>
----
-## 14.6 Spring Data JPA Repository
-### JpaRepository インターフェース
-Spring Data JPA では、インターフェースを定義するだけで基本的な CRUD 操作が自動実装されます。
-<details>
-<summary>AccountJpaRepository.java</summary>
-```java
-package com.example.accounting.infrastructure.persistence.repository;
-import com.example.accounting.domain.model.account.Account;
-import com.example.accounting.domain.model.account.AggregationType;
-import com.example.accounting.domain.model.account.BsPlType;
-import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.stereotype.Repository;
-import java.util.List;
-@Repository
-public interface AccountJpaRepository extends JpaRepository<Account, String> {
-    List<Account> findByBsPlType(BsPlType bsPlType);
-    List<Account> findByAggregationType(AggregationType aggregationType);
-    List<Account> findAllByOrderByAccountCodeAsc();
-}
-```
-</details>
-### Repository インターフェース（Output Port）
-ヘキサゴナルアーキテクチャでは、アプリケーション層に Output Port を定義します。
-<details>
-<summary>AccountRepository.java</summary>
-```java
-package com.example.accounting.application.port.out;
-import com.example.accounting.domain.model.account.Account;
-import com.example.accounting.domain.model.account.AggregationType;
-import com.example.accounting.domain.model.account.BsPlType;
-import java.util.List;
-import java.util.Optional;
-/**
- * 勘定科目リポジトリ（Output Port）
- */
-public interface AccountRepository {
-    void save(Account account);
-    Optional<Account> findByCode(String accountCode);
-    List<Account> findAll();
-    List<Account> findByBsPlType(BsPlType bsPlType);
-    List<Account> findByAggregationType(AggregationType aggregationType);
-    void delete(String accountCode);
-    void deleteAll();
-}
-```
-</details>
-### Repository 実装（Infrastructure 層）
-<details>
-<summary>AccountRepositoryImpl.java</summary>
-```java
-package com.example.accounting.infrastructure.persistence.repository;
-import com.example.accounting.application.port.out.AccountRepository;
-import com.example.accounting.domain.model.account.Account;
-import com.example.accounting.domain.model.account.AggregationType;
-import com.example.accounting.domain.model.account.BsPlType;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Repository;
-import java.util.List;
-import java.util.Optional;
-@Repository
-@RequiredArgsConstructor
-public class AccountRepositoryImpl implements AccountRepository {
-    private final AccountJpaRepository jpaRepository;
-    @Override
-    public void save(Account account) {
-        jpaRepository.save(account);
-    }
-    @Override
-    public Optional<Account> findByCode(String accountCode) {
-        return jpaRepository.findById(accountCode);
-    }
-    @Override
-    public List<Account> findAll() {
-        return jpaRepository.findAllByOrderByAccountCodeAsc();
-    }
-    @Override
-    public List<Account> findByBsPlType(BsPlType bsPlType) {
-        return jpaRepository.findByBsPlType(bsPlType);
-    }
-    @Override
-    public List<Account> findByAggregationType(AggregationType aggregationType) {
-        return jpaRepository.findByAggregationType(aggregationType);
-    }
-    @Override
-    public void delete(String accountCode) {
-        jpaRepository.deleteById(accountCode);
-    }
-    @Override
-    public void deleteAll() {
-        jpaRepository.deleteAll();
-    }
-}
-```
-</details>
----
-## 14.7 TestContainers によるテスト
-### テスト基盤クラス
-<details>
-<summary>BaseIntegrationTest.java</summary>
-```java
-package com.example.accounting.testsetup;
-import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
-import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
-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;
-@Testcontainers
-@DataJpaTest
-@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
-public abstract class BaseIntegrationTest {
-    @Container
-    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16-alpine")
-            .withDatabaseName("testdb")
-            .withUsername("testuser")
-            .withPassword("testpass");
-    @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);
-        registry.add("spring.flyway.enabled", () -> "true");
-        registry.add("spring.flyway.locations", () -> "classpath:db/migration");
-        registry.add("spring.jpa.hibernate.ddl-auto", () -> "validate");
-    }
-}
-```
-</details>
-### データベース接続テスト
-<details>
-<summary>DatabaseConnectionTest.java</summary>
-```java
-package com.example.accounting;
-import com.example.accounting.testsetup.BaseIntegrationTest;
-import org.junit.jupiter.api.DisplayName;
-import org.junit.jupiter.api.Test;
-import org.springframework.beans.factory.annotation.Autowired;
-import javax.sql.DataSource;
-import java.sql.Connection;
-import java.sql.ResultSet;
-import java.sql.Statement;
-import static org.assertj.core.api.Assertions.assertThat;
-@DisplayName("データベース接続")
-class DatabaseConnectionTest extends BaseIntegrationTest {
-    @Autowired
-    private DataSource dataSource;
-    @Test
-    @DisplayName("PostgreSQLに接続できる")
-    void canConnectToPostgres() throws Exception {
-        try (Connection conn = dataSource.getConnection();
-             Statement stmt = conn.createStatement();
-             ResultSet rs = stmt.executeQuery("SELECT 1")) {
-            assertThat(rs.next()).isTrue();
-            assertThat(rs.getInt(1)).isEqualTo(1);
-        }
-    }
-    @Test
-    @DisplayName("BSPL区分ENUMが作成されている")
-    void bsplTypeEnumExists() throws Exception {
-        try (Connection conn = dataSource.getConnection();
-             Statement stmt = conn.createStatement();
-             ResultSet rs = stmt.executeQuery(
-                 "SELECT unnest(enum_range(NULL::BSPL区分))::text")) {
-            assertThat(rs.next()).isTrue();
-            assertThat(rs.getString(1)).isEqualTo("BS");
-        }
-    }
-}
-```
-</details>
----
-## 14.8 命名規則のまとめ
-| 要素 | 言語 | 例 |
-|------|------|-----|
-| **テーブル名** | 日本語 | `"勘定科目マスタ"`, `"仕訳データ"` |
-| **カラム名** | 日本語 | `"勘定科目コード"`, `"勘定科目名"` |
-| **ENUM 型** | 日本語 | `BSPL区分`, `貸借区分` |
-| **ENUM 値** | 日本語 | `'BS'`, `'借方'` |
-| **Java クラス名** | 英語 | `Account`, `BsPlType` |
-| **Java フィールド名** | 英語 | `accountCode`, `accountName` |
-| **Java メソッド名** | 英語 | `findByCode()`, `save()` |
-| **JPA アノテーション** | 日本語カラム指定 | `@Column(name = "勘定科目コード")` |
----
-## 本章のまとめ
-本章では、財務会計システムの全体像と JPA による ORM 実装の基本を学びました。
-### 学んだこと
-| カテゴリ | 内容 |
-|----------|------|
-| スコープ | 勘定科目管理・仕訳処理・残高管理・帳票出力・決算処理 |
-| アーキテクチャ | ヘキサゴナルアーキテクチャ（ポート&アダプター） |
-| ORM | Spring Data JPA / Hibernate |
-| マッピング | @Entity, @Table, @Column, @Convert |
-| ENUM 変換 | AttributeConverter |
-| テスト | TestContainers + @DataJpaTest |
-### MyBatis 版との主な違い
-| 項目 | MyBatis 版 | JPA 版 |
-|------|-----------|--------|
-| SQL 記述 | XML で明示的に記述 | 自動生成（メソッド名規約） |
-| マッピング | resultMap | @Entity + @Column |
-| ENUM 変換 | TypeHandler | AttributeConverter |
-| 関連取得 | 明示的な JOIN | @EntityGraph, FETCH JOIN |
-### 次章の予告
-第15章では、財務会計システムの基盤となる勘定科目マスタの設計を JPA で実装します。@EmbeddedId を使った複合主キーや @ManyToOne によるリレーションも解説します。
+# 第14章：財務会計システムの全体像（ORM版）
+本章では、財務会計システムの全体像を把握し、Spring Data JPA を使用した ORM 実装のアーキテクチャについて解説します。MyBatis 版との違いを比較しながら、JPA の特徴を活かした設計手法を学びます。
+---
+## 14.1 財務会計システムのスコープ
+### 基幹業務システムにおける位置づけ
+財務会計システムは、基幹業務システムの中で他のシステムから仕訳データを受け取り、企業の財務状態を管理する重要なシステムです。
+```plantuml
+@startuml
+title 基幹業務システムの全体像
+state "得意先\n(Customer)" as Customer
+state "販売管理\n(Sales Management)" as SalesManagement
+SalesManagement : ・受注 \n・出荷 \n・売上
+state "購買管理\n(Procurement Management)" as ProcurementManagement
+ProcurementManagement : ・発注\n・入荷/受入\n・仕入(検収)
+state "在庫\n(Inventory)" as Inventory
+state "仕入先\n(Supplier)" as Supplier
+state "生産管理\n(Production Management)" as ProductionManagement
+ProductionManagement : ・生産計画\n・品質管理\n・工程管理\n・製造原価管理
+state "債権管理\n(Accounts Receivable)" as AccountsReceivable
+AccountsReceivable : ・請求 \n・入金
+state "債務管理\n(Accounts Payable)" as AccountsPayable
+AccountsPayable : ・支払\n・出金
+state "財務会計\n(Financial Accounting)" as Accounting #LightBlue
+Accounting : ・勘定科目管理\n・仕訳処理\n・残高管理\n・財務諸表\n・決算処理
+[*] -> Customer
+Customer --> SalesManagement
+SalesManagement --> AccountsReceivable
+SalesManagement --> ProcurementManagement : 調達依頼
+SalesManagement --> ProductionManagement : 需要予測 \n製造指示
+SalesManagement --> Accounting : 仕訳
+SalesManagement --> Customer
+Inventory --> SalesManagement
+ProcurementManagement --> Inventory
+ProcurementManagement --> AccountsPayable
+ProcurementManagement --> Supplier
+Supplier --> ProcurementManagement
+ProductionManagement --> ProcurementManagement : 調達依頼
+ProductionManagement --> Inventory : 入荷
+Inventory --> ProductionManagement : 払出
+AccountsReceivable --> Accounting
+AccountsPayable --> Accounting
+ProductionManagement --> Accounting : 仕訳
+ProcurementManagement --> Accounting : 仕訳
+Customer -> [*]
+@enduml
+```
+### 財務会計システムの業務領域
+財務会計システムは、以下の業務領域をカバーします。
+```plantuml
+@startuml
+[*] -> 販売管理
+販売管理 --> 財務会計 : 売上仕訳
+販売管理 : 売掛金 / 売上
+[*] -> 購買管理
+購買管理 --> 財務会計 : 仕入仕訳
+購買管理 : 仕入 / 買掛金
+[*] -> 債権管理
+債権管理 --> 財務会計 : 入金仕訳
+債権管理 : 現金預金 / 売掛金
+[*] -> 債務管理
+債務管理 --> 財務会計 : 支払仕訳
+債務管理 : 買掛金 / 現金預金
+財務会計 --> 帳票出力
+財務会計 : 勘定科目管理 \n仕訳処理 \n残高管理
+帳票出力 : 日計表 \n合計残高試算表 \n財務諸表
+帳票出力 -> [*]
+@enduml
+```
+### 業務機能の概要
+| 業務 | 説明 |
+|------|------|
+| **勘定科目管理** | 勘定科目マスタ・勘定科目構成マスタの管理 |
+| **仕訳処理** | 仕訳入力・自動仕訳・仕訳照会 |
+| **残高管理** | 日次残高・月次残高の管理 |
+| **帳票出力** | 日計表・合計残高試算表・財務諸表の出力 |
+| **決算処理** | 月次決算・年次決算 |
+### ユースケース図
+財務会計システム全体のユースケースは以下の通りです。
+```plantuml
+@startuml
+left to right direction
+skinparam packageStyle rectangle
+skinparam linetype ortho
+title 財務会計システム ユースケース図
+actor 経理担当者 as accounting
+actor 財務担当者 as finance
+actor 営業担当者 as sales
+actor 購買担当者 as buyer
+actor 管理者 as admin
+rectangle 財務会計システム {
+    usecase "勘定科目管理" as UC_ACCOUNT
+    usecase "仕訳入力" as UC_JOURNAL
+    usecase "自動仕訳" as UC_AUTO_JOURNAL
+    usecase "残高照会" as UC_BALANCE
+    usecase "日計表出力" as UC_DAILY
+    usecase "試算表出力" as UC_TRIAL
+    usecase "財務諸表出力" as UC_FINANCIAL
+    usecase "決算処理" as UC_CLOSING
+}
+admin -- UC_ACCOUNT
+accounting -- UC_JOURNAL
+accounting -- UC_BALANCE
+accounting -- UC_DAILY
+accounting -- UC_TRIAL
+accounting -- UC_CLOSING
+finance -- UC_FINANCIAL
+sales -- UC_AUTO_JOURNAL
+buyer -- UC_AUTO_JOURNAL
+@enduml
+```
+---
+## 14.2 ORM アーキテクチャの概要
+### MyBatis 版と JPA 版の比較
+本章では、MyBatis 版と同じビジネスロジックを Spring Data JPA で実装します。ORM の違いによるアプローチの差異を理解することが目的です。
+| 観点 | MyBatis 版 | JPA 版 |
+|------|-----------|--------|
+| マッピング方法 | XML Mapper + resultMap | @Entity + @Column |
+| ENUM 変換 | TypeHandler | AttributeConverter |
+| Repository | Mapper インターフェース + XML | JpaRepository インターフェース |
+| SQL | XML で明示的に記述 | メソッド名規約で自動生成 |
+| テスト基底クラス | @MybatisTest | @DataJpaTest |
+| N+1 問題対策 | 明示的な JOIN | @EntityGraph, JPQL JOIN FETCH |
+### JPA の特徴
+```plantuml
+@startuml
+title JPA / Hibernate の特徴
+package "JPA (Java Persistence API)" {
+    rectangle entity [
+        <b>Entity</b>
+        --
+        - @Entity
+        - @Table
+        - @Column
+        - @Id
+    ]
+    rectangle relations [
+        <b>Relationships</b>
+        --
+        - @OneToMany
+        - @ManyToOne
+        - @ManyToMany
+        - @Embedded
+    ]
+    rectangle query [
+        <b>Query</b>
+        --
+        - JPQL
+        - Criteria API
+        - Native Query
+        - メソッド名規約
+    ]
+}
+package "Spring Data JPA" {
+    rectangle repo [
+        <b>Repository</b>
+        --
+        - JpaRepository
+        - @Query
+        - Specification
+        - @EntityGraph
+    ]
+}
+' 関係線の定義
+entity --> relations
+entity --> query
+query --> repo
+note right of entity
+  オブジェクト指向の
+  マッピング定義
+end note
+note right of repo
+  Repository パターンの
+  自動実装
+end note
+@enduml
+```
+---
+## 14.3 プロジェクト構成
+### ヘキサゴナルアーキテクチャ
+財務会計システムは、ヘキサゴナルアーキテクチャ（ポート&アダプターパターン）を採用します。
+```
+src/main/java/com/example/accounting/
+├── application/                    # アプリケーション層
+│   └── port/
+│       └── out/                   # Output Port（リポジトリインターフェース）
+│           └── AccountRepository.java
+├── domain/                         # ドメイン層（純粋なビジネスロジック）
+│   └── model/                     # ドメインモデル
+│       └── account/
+│           ├── Account.java       # @Entity アノテーション付き
+│           ├── BsPlType.java
+│           ├── DebitCreditType.java
+│           ├── TransactionElementType.java
+│           ├── AggregationType.java
+│           └── TaxCalculationType.java
+├── infrastructure/                 # インフラストラクチャ層
+│   └── persistence/
+│       ├── converter/             # JPA AttributeConverter
+│       │   ├── BsPlTypeConverter.java
+│       │   ├── DebitCreditTypeConverter.java
+│       │   ├── TransactionElementTypeConverter.java
+│       │   ├── AggregationTypeConverter.java
+│       │   └── TaxCalculationTypeConverter.java
+│       └── repository/            # Repository実装
+│           ├── AccountJpaRepository.java  # Spring Data JPA
+│           └── AccountRepositoryImpl.java
+└── config/
+    └── JpaConfig.java
+src/main/resources/
+├── db/migration/
+│   └── V001__create_enum_types.sql
+└── application.yml
+```
+### アーキテクチャ図
+```plantuml
+@startuml hexagonal_architecture_jpa
+!define RECTANGLE class
+package "Hexagonal Architecture (財務会計API - JPA版)" {
+  RECTANGLE "Application Core\n(Domain + Use Cases)" as core {
+    - Account (勘定科目)
+    - Journal (仕訳)
+    - JournalEntry (仕訳明細)
+    - DailyBalance (日次残高)
+    - MonthlyBalance (月次残高)
+    - AccountUseCase
+    - JournalUseCase
+    - BalanceUseCase
+  }
+  RECTANGLE "Input Adapters\n(Driving Side)" as input {
+    - Spring Controllers
+    - REST API Endpoints
+    - Request Validation
+    - Error Handling
+  }
+  RECTANGLE "Output Adapters\n(Driven Side)" as output {
+    - Spring Data JPA Repository
+    - AttributeConverter
+    - Entity Mapping
+  }
+}
+input --> core : "Input Ports\n(Use Cases)"
+core --> output : "Output Ports\n(Repository Interfaces)"
+note top of core
+  純粋なビジネスロジック
+  JPA アノテーションは
+  ドメイン層に配置
+end note
+note left of input
+  外部からアプリケーションを
+  駆動するアダプター
+  HTTP, REST等
+end note
+note right of output
+  アプリケーションが外部の
+  技術を使うためのアダプター
+  PostgreSQL, Hibernate等
+end note
+@enduml
+```
+---
+## 14.4 環境構築
+### 前提条件
+以下のツールがインストールされていることを確認してください。
+- Java 17以上（推奨：Java 21 LTS）
+- Gradle 8.x以上（推奨：Gradle Wrapper使用）
+- Docker & Docker Compose（推奨）
+- Git
+### build.gradle の設定
+<details>
+<summary>build.gradle</summary>
+```groovy
+plugins {
+    id 'java'
+    id 'application'
+    id 'jacoco'
+    id 'org.springframework.boot' version '3.2.0'
+    id 'io.spring.dependency-management' version '1.1.4'
+}
+group = 'com.example.accounting'
+version = '0.0.1-SNAPSHOT'
+java {
+    sourceCompatibility = '21'
+}
+repositories {
+    mavenCentral()
+}
+dependencies {
+    // Spring Boot
+    implementation 'org.springframework.boot:spring-boot-starter-web'
+    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+    implementation 'org.springframework.boot:spring-boot-starter-validation'
+    testImplementation 'org.springframework.boot:spring-boot-starter-test'
+    // Flyway
+    implementation 'org.flywaydb:flyway-core'
+    implementation 'org.flywaydb:flyway-database-postgresql'
+    // Database
+    runtimeOnly 'org.postgresql:postgresql'
+    // Lombok (オプション)
+    compileOnly 'org.projectlombok:lombok'
+    annotationProcessor 'org.projectlombok:lombok'
+    // Test
+    testImplementation 'org.junit.jupiter:junit-jupiter-api'
+    testImplementation 'org.junit.jupiter:junit-jupiter-params'
+    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine'
+    testImplementation 'org.assertj:assertj-core:3.24.2'
+    testImplementation 'org.testcontainers:testcontainers:1.19.3'
+    testImplementation 'org.testcontainers:postgresql:1.19.3'
+    testImplementation 'org.testcontainers:junit-jupiter:1.19.3'
+}
+test {
+    useJUnitPlatform()
+}
+jacoco {
+    toolVersion = "0.8.11"
+}
+jacocoTestReport {
+    dependsOn test
+    reports {
+        xml.required = true
+        html.required = true
+    }
+}
+```
+</details>
+### Docker Compose のセットアップ
+<details>
+<summary>docker-compose.yml</summary>
+```yaml
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: financial-accounting-postgres-jpa
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-postgres}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
+      POSTGRES_DB: ${POSTGRES_DB:-financial_accounting}
+      TZ: 'Asia/Tokyo'
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+volumes:
+  postgres_data:
+```
+</details>
+### application.yml の設定
+<details>
+<summary>application.yml</summary>
+```yaml
+spring:
+  application:
+    name: financial-accounting-jpa
+  datasource:
+    url: jdbc:postgresql://localhost:5432/financial_accounting
+    username: postgres
+    password: postgres
+    driver-class-name: org.postgresql.Driver
+  jpa:
+    hibernate:
+      ddl-auto: validate  # Flyway でスキーマ管理するため validate
+    show-sql: true
+    properties:
+      hibernate:
+        format_sql: true
+        dialect: org.hibernate.dialect.PostgreSQLDialect
+  flyway:
+    enabled: true
+    locations: classpath:db/migration
+logging:
+  level:
+    org.hibernate.SQL: DEBUG
+    org.hibernate.type.descriptor.sql.BasicBinder: TRACE
+```
+</details>
+### PostgreSQL ENUM の定義
+<details>
+<summary>V001__create_enum_types.sql</summary>
+```sql
+-- BSPL区分（貸借対照表・損益計算書）
+CREATE TYPE BSPL区分 AS ENUM ('BS', 'PL');
+-- 貸借区分
+CREATE TYPE 貸借区分 AS ENUM ('借方', '貸方');
+-- 取引要素区分
+CREATE TYPE 取引要素区分 AS ENUM ('資産', '負債', '資本', '収益', '費用');
+-- 集計区分
+CREATE TYPE 集計区分 AS ENUM ('見出科目', '集計科目', '計上科目');
+-- 消費税計算区分
+CREATE TYPE 消費税計算区分 AS ENUM ('課税', '非課税', '不課税', '免税');
+```
+</details>
+---
+## 14.5 JPA エンティティの基本
+### 日本語テーブル名・カラム名のマッピング
+本シリーズでは、**日本語テーブル名・日本語カラム名**を使用します。JPA では、`@Table` と `@Column` アノテーションを使ってマッピングします。
+| 項目 | 例 |
+|-----|-----|
+| テーブル名 | `勘定科目マスタ`, `仕訳データ`, `日次勘定科目残高` |
+| カラム名 | `勘定科目コード`, `勘定科目名`, `BSPL区分` |
+| ENUM名 | `BSPL区分`, `貸借区分`, `集計区分` |
+| ENUM値 | `BS`, `PL`, `借方`, `貸方` |
+### エンティティクラスの例
+<details>
+<summary>Account.java（勘定科目エンティティ）</summary>
+```java
+package com.example.accounting.domain.model.account;
+import jakarta.persistence.*;
+import lombok.*;
+import java.time.LocalDateTime;
+@Entity
+@Table(name = "勘定科目マスタ")
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class Account {
+    @Id
+    @Column(name = "勘定科目コード", length = 5)
+    private String accountCode;
+    @Column(name = "勘定科目名", length = 40, nullable = false)
+    private String accountName;
+    @Column(name = "勘定科目略名", length = 10)
+    private String accountShortName;
+    @Column(name = "勘定科目カナ", length = 40)
+    private String accountNameKana;
+    @Convert(converter = BsPlTypeConverter.class)
+    @Column(name = "BSPL区分", nullable = false, columnDefinition = "BSPL区分")
+    private BsPlType bsPlType;
+    @Convert(converter = DebitCreditTypeConverter.class)
+    @Column(name = "貸借区分", nullable = false, columnDefinition = "貸借区分")
+    private DebitCreditType debitCreditType;
+    @Convert(converter = TransactionElementTypeConverter.class)
+    @Column(name = "取引要素区分", nullable = false, columnDefinition = "取引要素区分")
+    private TransactionElementType transactionElementType;
+    @Convert(converter = AggregationTypeConverter.class)
+    @Column(name = "集計区分", nullable = false, columnDefinition = "集計区分")
+    private AggregationType aggregationType;
+    @Column(name = "管理会計区分", length = 1)
+    private String managementAccountingType;
+    @Column(name = "費用区分", length = 1)
+    private String expenseType;
+    @Column(name = "元帳出力区分", length = 1)
+    private String ledgerOutputType;
+    @Column(name = "補助科目種別", length = 1)
+    private String subAccountType;
+    @Convert(converter = TaxCalculationTypeConverter.class)
+    @Column(name = "消費税計算区分", columnDefinition = "消費税計算区分")
+    private TaxCalculationType taxCalculationType;
+    @Column(name = "課税取引コード", length = 2)
+    private String taxTransactionCode;
+    @Column(name = "期日管理区分", length = 1)
+    private String dueDateManagementType;
+    @Column(name = "作成日時")
+    private LocalDateTime createdAt;
+    @Column(name = "更新日時")
+    private LocalDateTime updatedAt;
+    @Column(name = "更新者名", length = 12)
+    private String updatedBy;
+    @PrePersist
+    protected void onCreate() {
+        createdAt = LocalDateTime.now();
+        updatedAt = LocalDateTime.now();
+    }
+    @PreUpdate
+    protected void onUpdate() {
+        updatedAt = LocalDateTime.now();
+    }
+}
+```
+</details>
+### ENUM 定義
+<details>
+<summary>BsPlType.java（BSPL区分）</summary>
+```java
+package com.example.accounting.domain.model.account;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+@Getter
+@RequiredArgsConstructor
+public enum BsPlType {
+    BS("BS"),  // 貸借対照表
+    PL("PL");  // 損益計算書
+    private final String displayName;
+    public static BsPlType fromDisplayName(String displayName) {
+        for (BsPlType type : values()) {
+            if (type.displayName.equals(displayName)) {
+                return type;
+            }
+        }
+        throw new IllegalArgumentException("不正なBSPL区分: " + displayName);
+    }
+}
+```
+</details>
+<details>
+<summary>DebitCreditType.java（貸借区分）</summary>
+```java
+package com.example.accounting.domain.model.account;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+@Getter
+@RequiredArgsConstructor
+public enum DebitCreditType {
+    DEBIT("借方"),
+    CREDIT("貸方");
+    private final String displayName;
+    public static DebitCreditType fromDisplayName(String displayName) {
+        for (DebitCreditType type : values()) {
+            if (type.displayName.equals(displayName)) {
+                return type;
+            }
+        }
+        throw new IllegalArgumentException("不正な貸借区分: " + displayName);
+    }
+}
+```
+</details>
+### AttributeConverter
+JPA では `AttributeConverter` を使って PostgreSQL ENUM と Java Enum を変換します。
+<details>
+<summary>BsPlTypeConverter.java</summary>
+```java
+package com.example.accounting.infrastructure.persistence.converter;
+import com.example.accounting.domain.model.account.BsPlType;
+import jakarta.persistence.AttributeConverter;
+import jakarta.persistence.Converter;
+@Converter(autoApply = true)
+public class BsPlTypeConverter implements AttributeConverter<BsPlType, String> {
+    @Override
+    public String convertToDatabaseColumn(BsPlType attribute) {
+        return attribute != null ? attribute.getDisplayName() : null;
+    }
+    @Override
+    public BsPlType convertToEntityAttribute(String dbData) {
+        return dbData != null ? BsPlType.fromDisplayName(dbData) : null;
+    }
+}
+```
+</details>
+---
+## 14.6 Spring Data JPA Repository
+### JpaRepository インターフェース
+Spring Data JPA では、インターフェースを定義するだけで基本的な CRUD 操作が自動実装されます。
+<details>
+<summary>AccountJpaRepository.java</summary>
+```java
+package com.example.accounting.infrastructure.persistence.repository;
+import com.example.accounting.domain.model.account.Account;
+import com.example.accounting.domain.model.account.AggregationType;
+import com.example.accounting.domain.model.account.BsPlType;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+import java.util.List;
+@Repository
+public interface AccountJpaRepository extends JpaRepository<Account, String> {
+    List<Account> findByBsPlType(BsPlType bsPlType);
+    List<Account> findByAggregationType(AggregationType aggregationType);
+    List<Account> findAllByOrderByAccountCodeAsc();
+}
+```
+</details>
+### Repository インターフェース（Output Port）
+ヘキサゴナルアーキテクチャでは、アプリケーション層に Output Port を定義します。
+<details>
+<summary>AccountRepository.java</summary>
+```java
+package com.example.accounting.application.port.out;
+import com.example.accounting.domain.model.account.Account;
+import com.example.accounting.domain.model.account.AggregationType;
+import com.example.accounting.domain.model.account.BsPlType;
+import java.util.List;
+import java.util.Optional;
+/**
+ * 勘定科目リポジトリ（Output Port）
+ */
+public interface AccountRepository {
+    void save(Account account);
+    Optional<Account> findByCode(String accountCode);
+    List<Account> findAll();
+    List<Account> findByBsPlType(BsPlType bsPlType);
+    List<Account> findByAggregationType(AggregationType aggregationType);
+    void delete(String accountCode);
+    void deleteAll();
+}
+```
+</details>
+### Repository 実装（Infrastructure 層）
+<details>
+<summary>AccountRepositoryImpl.java</summary>
+```java
+package com.example.accounting.infrastructure.persistence.repository;
+import com.example.accounting.application.port.out.AccountRepository;
+import com.example.accounting.domain.model.account.Account;
+import com.example.accounting.domain.model.account.AggregationType;
+import com.example.accounting.domain.model.account.BsPlType;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+import java.util.List;
+import java.util.Optional;
+@Repository
+@RequiredArgsConstructor
+public class AccountRepositoryImpl implements AccountRepository {
+    private final AccountJpaRepository jpaRepository;
+    @Override
+    public void save(Account account) {
+        jpaRepository.save(account);
+    }
+    @Override
+    public Optional<Account> findByCode(String accountCode) {
+        return jpaRepository.findById(accountCode);
+    }
+    @Override
+    public List<Account> findAll() {
+        return jpaRepository.findAllByOrderByAccountCodeAsc();
+    }
+    @Override
+    public List<Account> findByBsPlType(BsPlType bsPlType) {
+        return jpaRepository.findByBsPlType(bsPlType);
+    }
+    @Override
+    public List<Account> findByAggregationType(AggregationType aggregationType) {
+        return jpaRepository.findByAggregationType(aggregationType);
+    }
+    @Override
+    public void delete(String accountCode) {
+        jpaRepository.deleteById(accountCode);
+    }
+    @Override
+    public void deleteAll() {
+        jpaRepository.deleteAll();
+    }
+}
+```
+</details>
+---
+## 14.7 TestContainers によるテスト
+### テスト基盤クラス
+<details>
+<summary>BaseIntegrationTest.java</summary>
+```java
+package com.example.accounting.testsetup;
+import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
+import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
+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;
+@Testcontainers
+@DataJpaTest
+@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
+public abstract class BaseIntegrationTest {
+    @Container
+    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16-alpine")
+            .withDatabaseName("testdb")
+            .withUsername("testuser")
+            .withPassword("testpass");
+    @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);
+        registry.add("spring.flyway.enabled", () -> "true");
+        registry.add("spring.flyway.locations", () -> "classpath:db/migration");
+        registry.add("spring.jpa.hibernate.ddl-auto", () -> "validate");
+    }
+}
+```
+</details>
+### データベース接続テスト
+<details>
+<summary>DatabaseConnectionTest.java</summary>
+```java
+package com.example.accounting;
+import com.example.accounting.testsetup.BaseIntegrationTest;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import javax.sql.DataSource;
+import java.sql.Connection;
+import java.sql.ResultSet;
+import java.sql.Statement;
+import static org.assertj.core.api.Assertions.assertThat;
+@DisplayName("データベース接続")
+class DatabaseConnectionTest extends BaseIntegrationTest {
+    @Autowired
+    private DataSource dataSource;
+    @Test
+    @DisplayName("PostgreSQLに接続できる")
+    void canConnectToPostgres() throws Exception {
+        try (Connection conn = dataSource.getConnection();
+             Statement stmt = conn.createStatement();
+             ResultSet rs = stmt.executeQuery("SELECT 1")) {
+            assertThat(rs.next()).isTrue();
+            assertThat(rs.getInt(1)).isEqualTo(1);
+        }
+    }
+    @Test
+    @DisplayName("BSPL区分ENUMが作成されている")
+    void bsplTypeEnumExists() throws Exception {
+        try (Connection conn = dataSource.getConnection();
+             Statement stmt = conn.createStatement();
+             ResultSet rs = stmt.executeQuery(
+                 "SELECT unnest(enum_range(NULL::BSPL区分))::text")) {
+            assertThat(rs.next()).isTrue();
+            assertThat(rs.getString(1)).isEqualTo("BS");
+        }
+    }
+}
+```
+</details>
+---
+## 14.8 命名規則のまとめ
+| 要素 | 言語 | 例 |
+|------|------|-----|
+| **テーブル名** | 日本語 | `"勘定科目マスタ"`, `"仕訳データ"` |
+| **カラム名** | 日本語 | `"勘定科目コード"`, `"勘定科目名"` |
+| **ENUM 型** | 日本語 | `BSPL区分`, `貸借区分` |
+| **ENUM 値** | 日本語 | `'BS'`, `'借方'` |
+| **Java クラス名** | 英語 | `Account`, `BsPlType` |
+| **Java フィールド名** | 英語 | `accountCode`, `accountName` |
+| **Java メソッド名** | 英語 | `findByCode()`, `save()` |
+| **JPA アノテーション** | 日本語カラム指定 | `@Column(name = "勘定科目コード")` |
+---
+## 本章のまとめ
+本章では、財務会計システムの全体像と JPA による ORM 実装の基本を学びました。
+### 学んだこと
+| カテゴリ | 内容 |
+|----------|------|
+| スコープ | 勘定科目管理・仕訳処理・残高管理・帳票出力・決算処理 |
+| アーキテクチャ | ヘキサゴナルアーキテクチャ（ポート&アダプター） |
+| ORM | Spring Data JPA / Hibernate |
+| マッピング | @Entity, @Table, @Column, @Convert |
+| ENUM 変換 | AttributeConverter |
+| テスト | TestContainers + @DataJpaTest |
+### MyBatis 版との主な違い
+| 項目 | MyBatis 版 | JPA 版 |
+|------|-----------|--------|
+| SQL 記述 | XML で明示的に記述 | 自動生成（メソッド名規約） |
+| マッピング | resultMap | @Entity + @Column |
+| ENUM 変換 | TypeHandler | AttributeConverter |
+| 関連取得 | 明示的な JOIN | @EntityGraph, FETCH JOIN |
+### 次章の予告
+第15章では、財務会計システムの基盤となる勘定科目マスタの設計を JPA で実装します。@EmbeddedId を使った複合主キーや @ManyToOne によるリレーションも解説します。