@k2works/claude-code-booster 6.1.0 → 6.3.0

package/lib/assets/docs/article/practical-database-design/part3-orm/chapter15-orm.md

@@ -1,1309 +0,0 @@
----
-type: Article
-title: "第15章：勘定科目の設計（ORM版）"
-description: "財務会計システムの根幹となる勘定科目マスタを Spring Data JPA で設計します。"
-tags: [article, practical-database-design, part3-orm]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-30T08:34:28Z }
----
-
-# 第15章：勘定科目の設計（ORM版）
-
-財務会計システムの根幹となる勘定科目マスタを Spring Data JPA で設計します。本章では、TDD（テスト駆動開発）を用いて勘定科目マスタ、勘定科目構成マスタ、課税取引マスタを JPA エンティティとして実装していきます。
-
----
-
-## 15.1 勘定科目マスタの設計
-
-### 勘定科目の区分体系
-
-勘定科目は複数の区分で分類されます。これらの区分を正しく理解することが、財務会計システム設計の基礎となります。
-
-```plantuml
-@startuml
-
-title 勘定科目の区分体系
-
-package "BSPL区分" {
-  rectangle "BS（貸借対照表）" as BS #LightBlue
-  rectangle "PL（損益計算書）" as PL #LightGreen
-}
-
-package "貸借区分" {
-  rectangle "借方" as Debit #LightYellow
-  rectangle "貸方" as Credit #LightPink
-}
-
-package "取引要素区分" {
-  rectangle "資産" as Asset
-  rectangle "負債" as Liability
-  rectangle "資本" as Equity
-  rectangle "収益" as Revenue
-  rectangle "費用" as Expense
-}
-
-package "集計区分" {
-  rectangle "見出科目" as Header
-  rectangle "集計科目" as Summary
-  rectangle "計上科目" as Posting
-}
-
-BS --> Asset : 借方
-BS --> Liability : 貸方
-BS --> Equity : 貸方
-PL --> Revenue : 貸方
-PL --> Expense : 借方
-
-@enduml
-```
-
-#### 区分の説明
-
-| 区分 | 説明 | 値の例 |
-|-----|------|-------|
-| **BSPL区分** | 貸借対照表(BS)か損益計算書(PL)か | `BS`, `PL` |
-| **貸借区分** | 借方科目か貸方科目か | `借方`, `貸方` |
-| **取引要素区分** | 5つの取引要素のどれに該当するか | `資産`, `負債`, `資本`, `収益`, `費用` |
-| **集計区分** | 科目の性質（見出し/集計/計上） | `見出科目`, `集計科目`, `計上科目` |
-
-#### 取引要素と貸借区分の関係
-
-複式簿記では、取引要素によって借方・貸方が決まります。
-
-| 取引要素 | BSPL区分 | 増加時の貸借 | 減少時の貸借 |
-|---------|---------|------------|------------|
-| 資産 | BS | 借方 | 貸方 |
-| 負債 | BS | 貸方 | 借方 |
-| 資本 | BS | 貸方 | 借方 |
-| 収益 | PL | 貸方 | 借方 |
-| 費用 | PL | 借方 | 貸方 |
-
-### 勘定科目マスタのER図
-
-```plantuml
-@startuml
-
-title 勘定科目マスタ
-
-entity 勘定科目マスタ {
-  勘定科目コード <<PK>>
-  --
-  勘定科目名
-  勘定科目略名
-  勘定科目カナ
-  BSPL区分
-  貸借区分
-  取引要素区分
-  集計区分
-  管理会計区分
-  費用区分
-  元帳出力区分
-  補助科目種別
-  消費税計算区分
-  課税取引コード <<FK>>
-  期日管理区分
-  作成日時
-  更新日時
-  更新者名
-}
-
-entity 課税取引マスタ {
-  課税取引コード <<PK>>
-  --
-  課税取引名
-  税率
-  更新日時
-  更新者名
-}
-
-勘定科目マスタ }o..|| 課税取引マスタ
-
-@enduml
-```
-
-### マイグレーション：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>
-
-<details>
-<summary>V002__create_account_master.sql</summary>
-
-```sql
--- 課税取引マスタ
-CREATE TABLE "課税取引マスタ" (
-    "課税取引コード" VARCHAR(2) PRIMARY KEY,
-    "課税取引名" VARCHAR(20) NOT NULL,
-    "税率" DECIMAL(5,3) NOT NULL DEFAULT 0.10,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(12)
-);
-
--- 勘定科目マスタ
-CREATE TABLE "勘定科目マスタ" (
-    "勘定科目コード" VARCHAR(5) PRIMARY KEY,
-    "勘定科目名" VARCHAR(40) NOT NULL,
-    "勘定科目略名" VARCHAR(10),
-    "勘定科目カナ" VARCHAR(40),
-    "BSPL区分" BSPL区分 NOT NULL,
-    "貸借区分" 貸借区分 NOT NULL,
-    "取引要素区分" 取引要素区分 NOT NULL,
-    "集計区分" 集計区分 NOT NULL,
-    "管理会計区分" VARCHAR(1),
-    "費用区分" VARCHAR(1),
-    "元帳出力区分" VARCHAR(1),
-    "補助科目種別" VARCHAR(1),
-    "消費税計算区分" 消費税計算区分,
-    "課税取引コード" VARCHAR(2) REFERENCES "課税取引マスタ"("課税取引コード"),
-    "期日管理区分" VARCHAR(1),
-    "作成日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(12)
-);
-
--- インデックス
-CREATE INDEX idx_勘定科目マスタ_BSPL区分 ON "勘定科目マスタ"("BSPL区分");
-CREATE INDEX idx_勘定科目マスタ_取引要素区分 ON "勘定科目マスタ"("取引要素区分");
-CREATE INDEX idx_勘定科目マスタ_集計区分 ON "勘定科目マスタ"("集計区分");
-```
-
-</details>
-
----
-
-## 15.2 JPA エンティティの実装
-
-### TDD による勘定科目マスタの実装
-
-#### Red: 失敗するテストを書く
-
-<details>
-<summary>勘定科目リポジトリテスト</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.repository;
-
-import com.example.accounting.application.port.out.AccountRepository;
-import com.example.accounting.domain.model.account.*;
-import com.example.accounting.testsetup.BaseIntegrationTest;
-import org.junit.jupiter.api.*;
-import org.springframework.beans.factory.annotation.Autowired;
-
-import static org.assertj.core.api.Assertions.*;
-
-@DisplayName("勘定科目リポジトリ")
-class AccountRepositoryTest extends BaseIntegrationTest {
-
-    @Autowired
-    private AccountRepository accountRepository;
-
-    @BeforeEach
-    void setUp() {
-        accountRepository.deleteAll();
-    }
-
-    @Nested
-    @DisplayName("登録")
-    class Registration {
-
-        @Test
-        @DisplayName("勘定科目を登録できる")
-        void canRegisterAccount() {
-            // Arrange
-            var account = Account.builder()
-                    .accountCode("11110")
-                    .accountName("現金")
-                    .accountShortName("現金")
-                    .bsPlType(BsPlType.BS)
-                    .debitCreditType(DebitCreditType.DEBIT)
-                    .transactionElementType(TransactionElementType.ASSET)
-                    .aggregationType(AggregationType.POSTING)
-                    .build();
-
-            // Act
-            accountRepository.save(account);
-
-            // Assert
-            var result = accountRepository.findByCode("11110");
-            assertThat(result).isPresent();
-            assertThat(result.get().getAccountName()).isEqualTo("現金");
-            assertThat(result.get().getBsPlType()).isEqualTo(BsPlType.BS);
-            assertThat(result.get().getDebitCreditType()).isEqualTo(DebitCreditType.DEBIT);
-        }
-
-        @Test
-        @DisplayName("貸借対照表の資産科目を登録できる")
-        void canRegisterBSAssetAccount() {
-            var account = createAccount("11000", "流動資産", BsPlType.BS,
-                    DebitCreditType.DEBIT, TransactionElementType.ASSET, AggregationType.SUMMARY);
-            accountRepository.save(account);
-
-            var result = accountRepository.findByCode("11000");
-            assertThat(result).isPresent();
-            assertThat(result.get().getBsPlType()).isEqualTo(BsPlType.BS);
-            assertThat(result.get().getTransactionElementType()).isEqualTo(TransactionElementType.ASSET);
-        }
-
-        @Test
-        @DisplayName("損益計算書の収益科目を登録できる")
-        void canRegisterPLRevenueAccount() {
-            var account = createAccount("41000", "売上高", BsPlType.PL,
-                    DebitCreditType.CREDIT, TransactionElementType.REVENUE, AggregationType.SUMMARY);
-            accountRepository.save(account);
-
-            var result = accountRepository.findByCode("41000");
-            assertThat(result).isPresent();
-            assertThat(result.get().getBsPlType()).isEqualTo(BsPlType.PL);
-            assertThat(result.get().getTransactionElementType()).isEqualTo(TransactionElementType.REVENUE);
-        }
-    }
-
-    @Nested
-    @DisplayName("集計区分")
-    class AggregationTypes {
-
-        @Test
-        @DisplayName("見出科目を登録できる")
-        void canRegisterHeaderAccount() {
-            var account = createAccount("11", "(資産の部）", BsPlType.BS,
-                    DebitCreditType.DEBIT, TransactionElementType.ASSET, AggregationType.HEADING);
-            accountRepository.save(account);
-
-            var result = accountRepository.findByCode("11");
-            assertThat(result.get().getAggregationType()).isEqualTo(AggregationType.HEADING);
-        }
-
-        @Test
-        @DisplayName("集計科目を登録できる")
-        void canRegisterSummaryAccount() {
-            var account = createAccount("11190", "現金及び預金", BsPlType.BS,
-                    DebitCreditType.DEBIT, TransactionElementType.ASSET, AggregationType.SUMMARY);
-            accountRepository.save(account);
-
-            var result = accountRepository.findByCode("11190");
-            assertThat(result.get().getAggregationType()).isEqualTo(AggregationType.SUMMARY);
-        }
-
-        @Test
-        @DisplayName("計上科目を登録できる")
-        void canRegisterPostingAccount() {
-            var account = createAccount("11110", "現金", BsPlType.BS,
-                    DebitCreditType.DEBIT, TransactionElementType.ASSET, AggregationType.POSTING);
-            accountRepository.save(account);
-
-            var result = accountRepository.findByCode("11110");
-            assertThat(result.get().getAggregationType()).isEqualTo(AggregationType.POSTING);
-        }
-    }
-
-    private Account createAccount(String code, String name, BsPlType bsPlType,
-            DebitCreditType debitCreditType, TransactionElementType transactionElementType,
-            AggregationType aggregationType) {
-        return Account.builder()
-                .accountCode(code)
-                .accountName(name)
-                .bsPlType(bsPlType)
-                .debitCreditType(debitCreditType)
-                .transactionElementType(transactionElementType)
-                .aggregationType(aggregationType)
-                .build();
-    }
-}
-```
-
-</details>
-
-#### Green: テストを通す実装
-
-##### ドメイン層（JPA エンティティ）
-
-<details>
-<summary>Account.java（勘定科目エンティティ）</summary>
-
-```java
-package com.example.accounting.domain.model.account;
-
-import com.example.accounting.infrastructure.persistence.converter.*;
-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>
-
-<details>
-<summary>TransactionElementType.java（取引要素区分）</summary>
-
-```java
-package com.example.accounting.domain.model.account;
-
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-
-@Getter
-@RequiredArgsConstructor
-public enum TransactionElementType {
-    ASSET("資産"),
-    LIABILITY("負債"),
-    EQUITY("資本"),
-    REVENUE("収益"),
-    EXPENSE("費用");
-
-    private final String displayName;
-
-    public static TransactionElementType fromDisplayName(String displayName) {
-        for (TransactionElementType type : values()) {
-            if (type.displayName.equals(displayName)) {
-                return type;
-            }
-        }
-        throw new IllegalArgumentException("不正な取引要素区分: " + displayName);
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>AggregationType.java（集計区分）</summary>
-
-```java
-package com.example.accounting.domain.model.account;
-
-import lombok.Getter;
-import lombok.RequiredArgsConstructor;
-
-@Getter
-@RequiredArgsConstructor
-public enum AggregationType {
-    HEADING("見出科目"),
-    SUMMARY("集計科目"),
-    POSTING("計上科目");
-
-    private final String displayName;
-
-    public static AggregationType fromDisplayName(String displayName) {
-        for (AggregationType type : values()) {
-            if (type.displayName.equals(displayName)) {
-                return type;
-            }
-        }
-        throw new IllegalArgumentException("不正な集計区分: " + displayName);
-    }
-}
-```
-
-</details>
-
-##### AttributeConverter（ENUM 変換）
-
-JPA では `AttributeConverter` を使って PostgreSQL ENUM と Java Enum を変換します。MyBatis の TypeHandler に相当します。
-
-<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>
-
-<details>
-<summary>DebitCreditTypeConverter.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.converter;
-
-import com.example.accounting.domain.model.account.DebitCreditType;
-import jakarta.persistence.AttributeConverter;
-import jakarta.persistence.Converter;
-
-@Converter(autoApply = true)
-public class DebitCreditTypeConverter implements AttributeConverter<DebitCreditType, String> {
-
-    @Override
-    public String convertToDatabaseColumn(DebitCreditType attribute) {
-        return attribute != null ? attribute.getDisplayName() : null;
-    }
-
-    @Override
-    public DebitCreditType convertToEntityAttribute(String dbData) {
-        return dbData != null ? DebitCreditType.fromDisplayName(dbData) : null;
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>TransactionElementTypeConverter.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.converter;
-
-import com.example.accounting.domain.model.account.TransactionElementType;
-import jakarta.persistence.AttributeConverter;
-import jakarta.persistence.Converter;
-
-@Converter(autoApply = true)
-public class TransactionElementTypeConverter implements AttributeConverter<TransactionElementType, String> {
-
-    @Override
-    public String convertToDatabaseColumn(TransactionElementType attribute) {
-        return attribute != null ? attribute.getDisplayName() : null;
-    }
-
-    @Override
-    public TransactionElementType convertToEntityAttribute(String dbData) {
-        return dbData != null ? TransactionElementType.fromDisplayName(dbData) : null;
-    }
-}
-```
-
-</details>
-
-<details>
-<summary>AggregationTypeConverter.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.converter;
-
-import com.example.accounting.domain.model.account.AggregationType;
-import jakarta.persistence.AttributeConverter;
-import jakarta.persistence.Converter;
-
-@Converter(autoApply = true)
-public class AggregationTypeConverter implements AttributeConverter<AggregationType, String> {
-
-    @Override
-    public String convertToDatabaseColumn(AggregationType attribute) {
-        return attribute != null ? attribute.getDisplayName() : null;
-    }
-
-    @Override
-    public AggregationType convertToEntityAttribute(String dbData) {
-        return dbData != null ? AggregationType.fromDisplayName(dbData) : null;
-    }
-}
-```
-
-</details>
-
-##### Repository インターフェース（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 com.example.accounting.domain.model.account.TransactionElementType;
-
-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);
-
-    List<Account> findByTransactionElementType(TransactionElementType type);
-
-    void update(Account account);
-
-    void deleteAll();
-}
-```
-
-</details>
-
-##### Spring Data JPA Repository
-
-<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 com.example.accounting.domain.model.account.TransactionElementType;
-import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.data.jpa.repository.Modifying;
-import org.springframework.data.jpa.repository.Query;
-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> findByTransactionElementType(TransactionElementType transactionElementType);
-
-    List<Account> findAllByOrderByAccountCodeAsc();
-
-    @Modifying
-    @Query(value = "TRUNCATE TABLE \"勘定科目マスタ\" CASCADE", nativeQuery = true)
-    void truncateTable();
-}
-```
-
-</details>
-
-##### Repository 実装クラス（インフラストラクチャ層）
-
-<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 com.example.accounting.domain.model.account.TransactionElementType;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Repository;
-import org.springframework.transaction.annotation.Transactional;
-
-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 List<Account> findByTransactionElementType(TransactionElementType type) {
-        return jpaRepository.findByTransactionElementType(type);
-    }
-
-    @Override
-    public void update(Account account) {
-        jpaRepository.save(account);
-    }
-
-    @Override
-    @Transactional
-    public void deleteAll() {
-        jpaRepository.truncateTable();
-    }
-}
-```
-
-</details>
-
----
-
-## 15.3 勘定科目構成マスタの設計
-
-### チルダ連結方式による階層構造
-
-勘定科目の階層構造を「チルダ（^）連結」で表現します。これにより、SQL の LIKE 検索で効率的に階層検索ができます。
-
-```plantuml
-@startwbs
-title 貸借対照表の科目ツリー構造（部分）
-
-* 貸借対照表
-** 資産の部
-*** 流動資産
-**** 現金及び預金
-***** 現金
-***** 当座預金
-***** 普通預金
-*** 固定資産
-**** 有形固定資産
-***** 建物
-***** 機械及び装置
-** 負債の部
-*** 流動負債
-**** 支払手形
-**** 買掛金
-** 資本の部
-*** 資本金
-*** 利益剰余金
-@endwbs
-```
-
-### 勘定科目構成マスタのデータ例
-
-| 勘定科目コード | 勘定科目パス |
-|-------------|-------------|
-| 11 | 11 |
-| 11000 | 11^11000 |
-| 11190 | 11^11000^11190 |
-| 11110 | 11^11000^11190^11110 |
-| 11120 | 11^11000^11190^11120 |
-| 11130 | 11^11000^11190^11130 |
-
-### マイグレーション
-
-<details>
-<summary>V003__create_account_structure.sql</summary>
-
-```sql
--- 勘定科目構成マスタ
-CREATE TABLE "勘定科目構成マスタ" (
-    "勘定科目コード" VARCHAR(5) PRIMARY KEY REFERENCES "勘定科目マスタ"("勘定科目コード"),
-    "勘定科目パス" VARCHAR(100) NOT NULL,
-    "更新日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    "更新者名" VARCHAR(12)
-);
-
--- インデックス（パス検索用）
-CREATE INDEX idx_勘定科目構成マスタ_パス ON "勘定科目構成マスタ"("勘定科目パス");
-```
-
-</details>
-
-### TDD による勘定科目構成マスタの実装
-
-#### JPA エンティティ
-
-<details>
-<summary>AccountStructure.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 AccountStructure {
-
-    @Id
-    @Column(name = "勘定科目コード", length = 5)
-    private String accountCode;
-
-    @Column(name = "勘定科目パス", length = 100, nullable = false)
-    private String accountPath;
-
-    @Column(name = "更新日時")
-    private LocalDateTime updatedAt;
-
-    @Column(name = "更新者名", length = 12)
-    private String updatedBy;
-
-    /**
-     * パスの深さ（階層レベル）を取得
-     */
-    @Transient
-    public int getDepth() {
-        if (accountPath == null || accountPath.isEmpty()) {
-            return 0;
-        }
-        return accountPath.split("\\^").length - 1;
-    }
-
-    /**
-     * 親科目コードを取得
-     */
-    @Transient
-    public String getParentCode() {
-        if (accountPath == null || !accountPath.contains("^")) {
-            return null;
-        }
-        String[] parts = accountPath.split("\\^");
-        if (parts.length < 2) {
-            return null;
-        }
-        return parts[parts.length - 2];
-    }
-
-    @PrePersist
-    @PreUpdate
-    protected void onUpdate() {
-        updatedAt = LocalDateTime.now();
-    }
-}
-```
-
-</details>
-
-#### Repository インターフェース（Output Port）
-
-<details>
-<summary>AccountStructureRepository.java</summary>
-
-```java
-package com.example.accounting.application.port.out;
-
-import com.example.accounting.domain.model.account.AccountStructure;
-
-import java.util.List;
-import java.util.Optional;
-
-/**
- * 勘定科目構成リポジトリ（Output Port）
- */
-public interface AccountStructureRepository {
-
-    void save(AccountStructure structure);
-
-    Optional<AccountStructure> findByCode(String accountCode);
-
-    List<AccountStructure> findAll();
-
-    List<AccountStructure> findByPathContaining(String pathSegment);
-
-    List<AccountStructure> findChildren(String parentCode);
-
-    void update(AccountStructure structure);
-
-    void deleteAll();
-}
-```
-
-</details>
-
-#### Spring Data JPA Repository
-
-<details>
-<summary>AccountStructureJpaRepository.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.repository;
-
-import com.example.accounting.domain.model.account.AccountStructure;
-import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.data.jpa.repository.Modifying;
-import org.springframework.data.jpa.repository.Query;
-import org.springframework.data.repository.query.Param;
-import org.springframework.stereotype.Repository;
-
-import java.util.List;
-
-@Repository
-public interface AccountStructureJpaRepository extends JpaRepository<AccountStructure, String> {
-
-    List<AccountStructure> findAllByOrderByAccountCodeAsc();
-
-    @Query("SELECT s FROM AccountStructure s WHERE s.accountPath LIKE %:pathSegment% ORDER BY s.accountCode")
-    List<AccountStructure> findByAccountPathContaining(@Param("pathSegment") String pathSegment);
-
-    @Query("SELECT s FROM AccountStructure s WHERE s.accountPath LIKE :parentCode% ORDER BY s.accountCode")
-    List<AccountStructure> findChildrenByParentCode(@Param("parentCode") String parentCode);
-
-    @Modifying
-    @Query(value = "TRUNCATE TABLE \"勘定科目構成マスタ\" CASCADE", nativeQuery = true)
-    void truncateTable();
-}
-```
-
-</details>
-
-#### Repository 実装クラス
-
-<details>
-<summary>AccountStructureRepositoryImpl.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.repository;
-
-import com.example.accounting.application.port.out.AccountStructureRepository;
-import com.example.accounting.domain.model.account.AccountStructure;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Repository;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.util.List;
-import java.util.Optional;
-
-@Repository
-@RequiredArgsConstructor
-public class AccountStructureRepositoryImpl implements AccountStructureRepository {
-
-    private final AccountStructureJpaRepository jpaRepository;
-
-    @Override
-    public void save(AccountStructure structure) {
-        jpaRepository.save(structure);
-    }
-
-    @Override
-    public Optional<AccountStructure> findByCode(String accountCode) {
-        return jpaRepository.findById(accountCode);
-    }
-
-    @Override
-    public List<AccountStructure> findAll() {
-        return jpaRepository.findAllByOrderByAccountCodeAsc();
-    }
-
-    @Override
-    public List<AccountStructure> findByPathContaining(String pathSegment) {
-        return jpaRepository.findByAccountPathContaining(pathSegment);
-    }
-
-    @Override
-    public List<AccountStructure> findChildren(String parentCode) {
-        return jpaRepository.findChildrenByParentCode(parentCode + "^");
-    }
-
-    @Override
-    public void update(AccountStructure structure) {
-        jpaRepository.save(structure);
-    }
-
-    @Override
-    @Transactional
-    public void deleteAll() {
-        jpaRepository.truncateTable();
-    }
-}
-```
-
-</details>
-
----
-
-## 15.4 課税取引マスタの設計
-
-### 課税取引コード・税率の管理
-
-課税取引マスタは、消費税の税率情報を管理するマスタテーブルです。
-
-| 課税取引コード | 課税取引名 | 税率 |
-|-------------|-----------|------|
-| 00 | 非課税 | 0.000 |
-| 08 | 軽減税率 | 0.080 |
-| 10 | 標準税率 | 0.100 |
-
-### TDD による課税取引マスタの実装
-
-#### JPA エンティティ
-
-<details>
-<summary>TaxTransaction.java</summary>
-
-```java
-package com.example.accounting.domain.model.tax;
-
-import jakarta.persistence.*;
-import lombok.*;
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-@Entity
-@Table(name = "課税取引マスタ")
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class TaxTransaction {
-
-    @Id
-    @Column(name = "課税取引コード", length = 2)
-    private String taxCode;
-
-    @Column(name = "課税取引名", length = 20, nullable = false)
-    private String taxName;
-
-    @Builder.Default
-    @Column(name = "税率", precision = 5, scale = 3, nullable = false)
-    private BigDecimal taxRate = new BigDecimal("0.10");
-
-    @Column(name = "更新日時")
-    private LocalDateTime updatedAt;
-
-    @Column(name = "更新者名", length = 12)
-    private String updatedBy;
-
-    /**
-     * 税込金額を計算
-     */
-    public BigDecimal calculateTaxIncludedAmount(BigDecimal amount) {
-        return amount.add(amount.multiply(taxRate));
-    }
-
-    /**
-     * 消費税額を計算
-     */
-    public BigDecimal calculateTaxAmount(BigDecimal amount) {
-        return amount.multiply(taxRate);
-    }
-
-    @PrePersist
-    @PreUpdate
-    protected void onUpdate() {
-        updatedAt = LocalDateTime.now();
-    }
-}
-```
-
-</details>
-
-#### Spring Data JPA Repository
-
-<details>
-<summary>TaxTransactionJpaRepository.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.repository;
-
-import com.example.accounting.domain.model.tax.TaxTransaction;
-import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.data.jpa.repository.Modifying;
-import org.springframework.data.jpa.repository.Query;
-import org.springframework.stereotype.Repository;
-
-import java.util.List;
-
-@Repository
-public interface TaxTransactionJpaRepository extends JpaRepository<TaxTransaction, String> {
-
-    List<TaxTransaction> findAllByOrderByTaxCodeAsc();
-
-    @Modifying
-    @Query(value = "TRUNCATE TABLE \"課税取引マスタ\" CASCADE", nativeQuery = true)
-    void truncateTable();
-}
-```
-
-</details>
-
----
-
-## 15.5 MyBatis 版との比較
-
-### 実装の違い
-
-| 観点 | MyBatis 版 | JPA 版 |
-|------|-----------|--------|
-| マッピング | XML Mapper + resultMap | @Entity + @Column |
-| ENUM 変換 | TypeHandler | AttributeConverter |
-| Repository | Mapper インターフェース + XML | JpaRepository インターフェース |
-| SQL | XML で明示的に記述 | メソッド名規約で自動生成 |
-| トランザクション管理 | 明示的に記述 | @Transactional |
-| TRUNCATE | XML で定義 | @Query(nativeQuery) |
-
-### コード量の比較
-
-| 項目 | MyBatis 版 | JPA 版 |
-|------|-----------|--------|
-| エンティティ | POJO（アノテーションなし） | @Entity + @Column |
-| ENUM 変換 | TypeHandler（各4クラス） | AttributeConverter（各4クラス） |
-| Mapper/Repository | Mapper + XML | JpaRepository インターフェースのみ |
-| SQL | XML で全て記述 | メソッド名規約 + @Query |
-
----
-
-## 第15章のまとめ
-
-### 作成したテーブル
-
-| テーブル名 | 説明 |
-|----------|------|
-| `課税取引マスタ` | 消費税の税率情報を管理 |
-| `勘定科目マスタ` | 勘定科目の基本情報を管理 |
-| `勘定科目構成マスタ` | 勘定科目の階層構造をチルダ連結で管理 |
-
-### ER図
-
-```plantuml
-@startuml
-
-title 勘定科目関連 ER図
-
-entity 課税取引マスタ {
-  課税取引コード <<PK>>
-  --
-  課税取引名
-  税率
-  更新日時
-  更新者名
-}
-
-entity 勘定科目マスタ {
-  勘定科目コード <<PK>>
-  --
-  勘定科目名
-  勘定科目略名
-  勘定科目カナ
-  BSPL区分
-  貸借区分
-  取引要素区分
-  集計区分
-  管理会計区分
-  費用区分
-  元帳出力区分
-  補助科目種別
-  消費税計算区分
-  課税取引コード <<FK>>
-  期日管理区分
-  ...
-}
-
-entity 勘定科目構成マスタ {
-  勘定科目コード <<PK,FK>>
-  --
-  勘定科目パス
-  更新日時
-  更新者名
-}
-
-勘定科目マスタ }o..|| 課税取引マスタ
-勘定科目マスタ ||--|| 勘定科目構成マスタ
-
-@enduml
-```
-
-### 設計のポイント
-
-1. **ENUM 型の活用**: BSPL区分、貸借区分、取引要素区分、集計区分で型安全性を確保
-2. **日本語 DB / 英語 Java**: テーブル・カラムは日本語、Java コードは英語で統一
-3. **AttributeConverter**: Java Enum と日本語 ENUM 値の変換を JPA AttributeConverter で実装
-4. **チルダ連結方式**: 勘定科目構成マスタで階層構造を表現し、JPQL の LIKE 検索で効率的に階層検索
-5. **ヘキサゴナルアーキテクチャ**: ドメイン層がインフラに依存しない設計
-6. **JpaRepository**: メソッド名規約による自動 SQL 生成
-
-### 命名規則
-
-| 要素 | 言語 | 例 |
-|------|------|-----|
-| **テーブル名** | 日本語 | `"勘定科目マスタ"`, `"課税取引マスタ"` |
-| **カラム名** | 日本語 | `"勘定科目コード"`, `"勘定科目名"` |
-| **ENUM 型** | 日本語 | `BSPL区分`, `貸借区分` |
-| **ENUM 値** | 日本語 | `'BS'`, `'借方'` |
-| **Java クラス名** | 英語 | `Account`, `AccountStructure` |
-| **Java フィールド名** | 英語 | `accountCode`, `accountName` |
-| **JPA @Column** | 日本語カラム指定 | `@Column(name = "勘定科目コード")` |
-
----
-
-## 次章の予告
-
-第16章では、仕訳テーブルの設計に進みます。複式簿記の基本構造である「借方・貸方」の仕訳データを JPA で実装していきます。@EmbeddedId を使った複合主キーや @ManyToOne によるリレーションも解説します。