@k2works/claude-code-booster 6.1.0 → 6.3.0

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

@@ -1,1025 +0,0 @@
----
-type: Article
-title: "第19章：赤黒とログの設計（ORM版）"
-description: "会計システムにおけるデータ訂正方式（赤黒処理）とログ管理の設計を行います。"
-tags: [article, practical-database-design, part3-orm]
-status: stable
-generated: { by: human:kakimomokuri, at: 2026-03-30T08:34:28Z }
----
-
-# 第19章：赤黒とログの設計（ORM版）
-
-会計システムにおけるデータ訂正方式（赤黒処理）とログ管理の設計を行います。
-
-JPA 版では、@EntityListeners と AuditingEntityListener を使用した監査証跡の実装を行います。
-
----
-
-## 19.1 赤黒処理の概念
-
-会計システムでは、一度登録したデータの「削除」や「更新」を安易に行うことはできません。監査証跡を確保しつつ、データ訂正を行う方式が必要です。
-
-### 赤黒処理とは
-
-赤黒処理とは、誤った仕訳を訂正する際に、元の仕訳を「赤伝（取消伝票）」で打ち消し、正しい仕訳を「黒伝（訂正伝票）」として新規登録する方式です。
-
-```plantuml
-@startuml
-
-title 赤黒処理の流れ
-
-rectangle "元伝票（誤り）" as original {
-  card "仕訳番号: J0001\n【借方】現金 100,000\n【貸方】売上 100,000" as j1
-}
-
-rectangle "赤伝（取消）" as red {
-  card "仕訳番号: J0001R\n【借方】売上 100,000\n【貸方】現金 100,000\n※貸借を反転" as j2
-}
-
-rectangle "黒伝（訂正）" as black {
-  card "仕訳番号: J0002\n【借方】現金 120,000\n【貸方】売上 120,000\n※正しい金額" as j3
-}
-
-original --> red : 赤伝発行
-red --> black : 黒伝発行
-
-note bottom of red
-赤伝は元伝票の
-貸借を完全に反転
-仕訳金額の合計が
-ゼロになる
-end note
-
-note bottom of black
-黒伝は正しい内容で
-新規に仕訳を起票
-end note
-
-@enduml
-```
-
-### 赤黒処理のメリット
-
-| メリット | 説明 |
-|---------|------|
-| 監査証跡の確保 | 元の仕訳が残り、訂正履歴が追跡可能 |
-| データ整合性 | 物理削除を行わないため、参照整合性が維持される |
-| 会計基準準拠 | 会計原則に則った正当な訂正方法 |
-| 残高の自動調整 | 赤伝により残高が自動的に訂正される |
-
----
-
-## 19.2 赤黒処理のテーブル設計
-
-仕訳テーブルには、赤黒処理に必要な項目が含まれています。
-
-```plantuml
-@startuml
-
-entity "仕訳" as Journal {
-  * **仕訳伝票番号**: VARCHAR(10) <<PK>>
-  --
-  起票日
-  入力日
-  仕訳伝票区分
-  ...
-  **赤伝フラグ**: SMALLINT
-  **赤黒伝票番号**: INTEGER
-  作成日時
-  更新日時
-}
-
-note right of Journal
-赤伝フラグ:
-  0 = 通常（黒伝）
-  1 = 赤伝（取消）
-
-赤黒伝票番号:
-  赤伝の場合、元伝票の番号を格納
-  紐付けにより履歴を追跡
-end note
-
-@enduml
-```
-
----
-
-## 19.3 MyBatis 版との実装比較
-
-### データアクセス層の比較
-
-| 機能 | MyBatis 版 | JPA 版 |
-|-----|-----------|--------|
-| 監査カラム設定 | 手動 / Interceptor | @EnableJpaAuditing |
-| マスタ変更ログ | DB トリガー | @EntityListeners |
-| ENUM 変換 | TypeHandler | AttributeConverter |
-| 動的クエリ | XML `<if>` タグ | Specification パターン |
-| 一括保存（Cascade） | 明示的に各テーブル INSERT | CascadeType.ALL |
-
----
-
-## 19.4 赤黒処理サービスの実装
-
-<details>
-<summary>JournalCorrectionService.java</summary>
-
-```java
-package com.example.accounting.application.service;
-
-import com.example.accounting.application.port.out.JournalRepository;
-import com.example.accounting.domain.model.journal.*;
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.time.LocalDate;
-import java.util.ArrayList;
-
-/**
- * 赤黒処理サービス
- *
- * JPA 版でもビジネスロジックは MyBatis 版と同じ
- * Entity の操作方法が異なる（JPA では Cascade を活用）
- */
-@Service
-@RequiredArgsConstructor
-@Slf4j
-public class JournalCorrectionService {
-
-    private final JournalRepository journalRepository;
-    private final BalanceUpdateService balanceUpdateService;
-
-    /**
-     * 仕訳を赤黒訂正する
-     * @param originalVoucherNumber 元伝票番号
-     * @param correctedJournal 訂正後の仕訳（黒伝）
-     * @return 赤伝と黒伝の仕訳伝票番号
-     */
-    @Transactional
-    public CorrectionResult correctJournal(String originalVoucherNumber,
-            Journal correctedJournal) {
-        // 元伝票を取得
-        var original = journalRepository.findByVoucherNumber(originalVoucherNumber)
-            .orElseThrow(() -> new IllegalArgumentException(
-                "元伝票が見つかりません: " + originalVoucherNumber));
-
-        // 赤伝を作成
-        var redSlip = createRedSlip(original);
-        journalRepository.save(redSlip);
-        balanceUpdateService.updateBalancesForJournal(redSlip);
-
-        // 黒伝（訂正伝票）を登録
-        if (!correctedJournal.isBalanced()) {
-            throw new IllegalArgumentException("訂正仕訳の貸借が一致しません");
-        }
-        journalRepository.save(correctedJournal);
-        balanceUpdateService.updateBalancesForJournal(correctedJournal);
-
-        log.info("赤黒訂正完了: 元伝票={}, 赤伝={}, 黒伝={}",
-            originalVoucherNumber,
-            redSlip.getJournalVoucherNumber(),
-            correctedJournal.getJournalVoucherNumber());
-
-        return new CorrectionResult(
-            redSlip.getJournalVoucherNumber(),
-            correctedJournal.getJournalVoucherNumber()
-        );
-    }
-
-    /**
-     * 仕訳を取消する（赤伝のみ発行）
-     * @param voucherNumber 取消対象の仕訳伝票番号
-     * @return 赤伝の仕訳伝票番号
-     */
-    @Transactional
-    public String cancelJournal(String voucherNumber) {
-        var original = journalRepository.findByVoucherNumber(voucherNumber)
-            .orElseThrow(() -> new IllegalArgumentException(
-                "仕訳が見つかりません: " + voucherNumber));
-
-        // 既に赤伝が発行されているか確認
-        if (original.getRedSlipFlag() != null && original.getRedSlipFlag()) {
-            throw new IllegalStateException("この仕訳は既に取消済みです");
-        }
-
-        // 赤伝を作成
-        var redSlip = createRedSlip(original);
-        journalRepository.save(redSlip);
-        balanceUpdateService.updateBalancesForJournal(redSlip);
-
-        log.info("仕訳取消完了: 元伝票={}, 赤伝={}",
-            voucherNumber, redSlip.getJournalVoucherNumber());
-
-        return redSlip.getJournalVoucherNumber();
-    }
-
-    /**
-     * 赤伝を作成する
-     *
-     * JPA 版では CascadeType.ALL により、
-     * Journal を保存すると details も自動的に保存される
-     */
-    private Journal createRedSlip(Journal original) {
-        // 赤伝の仕訳伝票番号を生成（元伝票番号 + R）
-        var redVoucherNumber = original.getJournalVoucherNumber() + "R";
-
-        // 貸借を反転した明細を作成
-        var redDetails = new ArrayList<JournalDetail>();
-        for (var detail : original.getDetails()) {
-            var reversedDCDetails = new ArrayList<JournalDebitCreditDetail>();
-            for (var dcDetail : detail.getDebitCreditDetails()) {
-                var reversed = JournalDebitCreditDetail.builder()
-                    .journalVoucherNumber(redVoucherNumber)
-                    .lineNumber(dcDetail.getLineNumber())
-                    .debitCreditLineNumber(dcDetail.getDebitCreditLineNumber())
-                    // 借方→貸方、貸方→借方に反転
-                    .debitCreditType(
-                        dcDetail.getDebitCreditType() == DebitCreditType.DEBIT
-                            ? DebitCreditType.CREDIT
-                            : DebitCreditType.DEBIT)
-                    .accountCode(dcDetail.getAccountCode())
-                    .subAccountCode(dcDetail.getSubAccountCode())
-                    .departmentCode(dcDetail.getDepartmentCode())
-                    .amount(dcDetail.getAmount())
-                    .taxType(dcDetail.getTaxType())
-                    .taxRate(dcDetail.getTaxRate())
-                    .build();
-                reversedDCDetails.add(reversed);
-            }
-
-            var redDetail = JournalDetail.builder()
-                .journalVoucherNumber(redVoucherNumber)
-                .lineNumber(detail.getLineNumber())
-                .lineSummary(detail.getLineSummary() + "（取消）")
-                .debitCreditDetails(reversedDCDetails)
-                .build();
-            redDetails.add(redDetail);
-        }
-
-        return Journal.builder()
-            .journalVoucherNumber(redVoucherNumber)
-            .postingDate(LocalDate.now())
-            .entryDate(LocalDate.now())
-            .closingEntryFlag(original.getClosingEntryFlag())
-            .voucherType(original.getVoucherType())
-            .departmentCode(original.getDepartmentCode())
-            .redSlipFlag(true)
-            .redBlackVoucherNumber(extractNumericPart(original.getJournalVoucherNumber()))
-            .details(redDetails)
-            .build();
-    }
-
-    private Integer extractNumericPart(String voucherNumber) {
-        return Integer.parseInt(voucherNumber.replaceAll("[^0-9]", ""));
-    }
-
-    /**
-     * 訂正結果
-     */
-    public record CorrectionResult(
-        String redSlipNumber,
-        String blackSlipNumber
-    ) {}
-}
-```
-
-</details>
-
----
-
-## 19.5 ログ管理方式の選択
-
-会計システムのログ管理には、3つの方式があります。
-
-```plantuml
-@startuml
-
-title ログ管理方式の比較
-
-rectangle "方式A: データ自体にログ情報を持つ" as a {
-  card "作成日時\n更新日時\n更新者名" as a1
-}
-
-rectangle "方式B: 赤黒処理・論理削除" as b {
-  card "赤伝フラグ\n赤黒伝票番号\n削除フラグ" as b1
-}
-
-rectangle "方式C: ログテーブルに保存" as c {
-  card "操作種別\n操作前データ\n操作後データ\n操作者" as c1
-}
-
-a -[hidden]right- b
-b -[hidden]right- c
-
-note bottom of a
-最もシンプル
-更新履歴は保持しない
-JPA では @EnableJpaAuditing
-end note
-
-note bottom of b
-会計データに最適
-監査証跡を確保
-end note
-
-note bottom of c
-完全な履歴管理
-マスタ更新に最適
-end note
-
-@enduml
-```
-
-### 推奨される組み合わせ
-
-| データ種別 | 方式 | JPA 実装 |
-|----------|------|---------|
-| マスタデータ | A + C | @EnableJpaAuditing + @EntityListeners |
-| トランザクションデータ | A + B | @EnableJpaAuditing + 赤黒処理 |
-| サマリデータ | A | @EnableJpaAuditing のみ |
-
----
-
-## 19.6 JPA Auditing による自動タイムスタンプ
-
-JPA 版では、Spring Data JPA の Auditing 機能を使用して、作成日時・更新日時・作成者・更新者を自動的に設定できます。
-
-### Auditing 設定
-
-<details>
-<summary>AccountingApplication.java</summary>
-
-```java
-package com.example.accounting;
-
-import org.springframework.boot.SpringApplication;
-import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
-
-@SpringBootApplication
-@EnableJpaAuditing  // JPA Auditing を有効化
-public class AccountingApplication {
-    public static void main(String[] args) {
-        SpringApplication.run(AccountingApplication.class, args);
-    }
-}
-```
-
-</details>
-
-### AuditorAware 実装（操作者の自動設定）
-
-<details>
-<summary>AuditorAwareImpl.java</summary>
-
-```java
-package com.example.accounting.infrastructure.config;
-
-import org.springframework.data.domain.AuditorAware;
-import org.springframework.security.core.Authentication;
-import org.springframework.security.core.context.SecurityContextHolder;
-import org.springframework.stereotype.Component;
-
-import java.util.Optional;
-
-/**
- * 操作者を自動取得する AuditorAware 実装
- *
- * Spring Security と連携して、現在ログイン中のユーザーを取得
- * @CreatedBy, @LastModifiedBy に自動設定される
- */
-@Component
-public class AuditorAwareImpl implements AuditorAware<String> {
-
-    @Override
-    public Optional<String> getCurrentAuditor() {
-        Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
-
-        if (authentication == null || !authentication.isAuthenticated()) {
-            return Optional.of("system");
-        }
-
-        return Optional.of(authentication.getName());
-    }
-}
-```
-
-</details>
-
-### 監査情報を持つ基底 Entity
-
-<details>
-<summary>BaseEntity.java</summary>
-
-```java
-package com.example.accounting.domain.model.common;
-
-import jakarta.persistence.*;
-import lombok.Getter;
-import lombok.Setter;
-import org.springframework.data.annotation.CreatedBy;
-import org.springframework.data.annotation.CreatedDate;
-import org.springframework.data.annotation.LastModifiedBy;
-import org.springframework.data.annotation.LastModifiedDate;
-import org.springframework.data.jpa.domain.support.AuditingEntityListener;
-
-import java.time.LocalDateTime;
-
-/**
- * 監査情報を持つ基底 Entity
- *
- * JPA 版では @EntityListeners と Auditing アノテーションで
- * 作成日時・更新日時・作成者・更新者を自動管理
- *
- * MyBatis 版では手動で設定していたが、JPA 版では自動化
- */
-@MappedSuperclass
-@EntityListeners(AuditingEntityListener.class)
-@Getter
-@Setter
-public abstract class BaseEntity {
-
-    @CreatedDate
-    @Column(name = "作成日時", nullable = false, updatable = false)
-    private LocalDateTime createdAt;
-
-    @LastModifiedDate
-    @Column(name = "更新日時", nullable = false)
-    private LocalDateTime updatedAt;
-
-    @CreatedBy
-    @Column(name = "作成者", length = 50, updatable = false)
-    private String createdBy;
-
-    @LastModifiedBy
-    @Column(name = "更新者", length = 50)
-    private String updatedBy;
-}
-```
-
-</details>
-
----
-
-## 19.7 マスタ変更ログテーブルの設計
-
-### Flyway マイグレーション
-
-<details>
-<summary>V010__create_change_log_table.sql</summary>
-
-```sql
--- 操作種別
-CREATE TYPE 操作種別 AS ENUM ('INSERT', 'UPDATE', 'DELETE');
-
--- 変更ログテーブル
-CREATE TABLE "変更ログ" (
-    "ログID" SERIAL PRIMARY KEY,
-    "テーブル名" VARCHAR(50) NOT NULL,
-    "レコードキー" VARCHAR(100) NOT NULL,
-    "操作種別" 操作種別 NOT NULL,
-    "操作前データ" JSONB,
-    "操作後データ" JSONB,
-    "操作日時" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
-    "操作者" VARCHAR(50),
-    "操作端末" VARCHAR(100),
-    "備考" TEXT
-);
-
--- インデックス
-CREATE INDEX "idx_変更ログ_テーブル名" ON "変更ログ"("テーブル名");
-CREATE INDEX "idx_変更ログ_レコードキー" ON "変更ログ"("レコードキー");
-CREATE INDEX "idx_変更ログ_操作日時" ON "変更ログ"("操作日時");
-```
-
-</details>
-
-### 変更ログ Entity
-
-<details>
-<summary>ChangeLog.java</summary>
-
-```java
-package com.example.accounting.domain.model.audit;
-
-import com.example.accounting.infrastructure.persistence.converter.OperationTypeConverter;
-import jakarta.persistence.*;
-import lombok.*;
-
-import java.time.LocalDateTime;
-
-/**
- * 変更ログ Entity
- *
- * JPA 版では @Entity で定義
- * @GeneratedValue で自動採番
- */
-@Entity
-@Table(name = "変更ログ")
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class ChangeLog {
-
-    @Id
-    @GeneratedValue(strategy = GenerationType.IDENTITY)
-    @Column(name = "ログID")
-    private Long logId;
-
-    @Column(name = "テーブル名", length = 50, nullable = false)
-    private String tableName;
-
-    @Column(name = "レコードキー", length = 100, nullable = false)
-    private String recordKey;
-
-    @Convert(converter = OperationTypeConverter.class)
-    @Column(name = "操作種別", nullable = false, columnDefinition = "操作種別")
-    private OperationType operationType;
-
-    @Column(name = "操作前データ", columnDefinition = "JSONB")
-    private String beforeData;
-
-    @Column(name = "操作後データ", columnDefinition = "JSONB")
-    private String afterData;
-
-    @Column(name = "操作日時", nullable = false)
-    private LocalDateTime operatedAt;
-
-    @Column(name = "操作者", length = 50)
-    private String operatedBy;
-
-    @Column(name = "操作端末", length = 100)
-    private String operatedFrom;
-
-    @Column(name = "備考", columnDefinition = "TEXT")
-    private String remarks;
-
-    @PrePersist
-    protected void onCreate() {
-        if (this.operatedAt == null) {
-            this.operatedAt = LocalDateTime.now();
-        }
-    }
-}
-```
-
-</details>
-
-### 操作種別 Enum と Converter
-
-<details>
-<summary>OperationType.java と OperationTypeConverter.java</summary>
-
-```java
-package com.example.accounting.domain.model.audit;
-
-/**
- * 操作種別 Enum
- */
-public enum OperationType {
-    INSERT,
-    UPDATE,
-    DELETE
-}
-```
-
-```java
-package com.example.accounting.infrastructure.persistence.converter;
-
-import com.example.accounting.domain.model.audit.OperationType;
-import jakarta.persistence.AttributeConverter;
-import jakarta.persistence.Converter;
-
-/**
- * 操作種別 ↔ PostgreSQL ENUM 変換
- */
-@Converter(autoApply = true)
-public class OperationTypeConverter implements AttributeConverter<OperationType, String> {
-
-    @Override
-    public String convertToDatabaseColumn(OperationType attribute) {
-        return attribute != null ? attribute.name() : null;
-    }
-
-    @Override
-    public OperationType convertToEntityAttribute(String dbData) {
-        return dbData != null ? OperationType.valueOf(dbData) : null;
-    }
-}
-```
-
-</details>
-
----
-
-## 19.8 EntityListener によるマスタ変更ログの自動記録
-
-JPA 版では @EntityListeners を使用して、Entity のライフサイクルイベントをフックし、変更ログを自動的に記録できます。
-
-<details>
-<summary>ChangeLogListener.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.listener;
-
-import com.example.accounting.domain.model.audit.ChangeLog;
-import com.example.accounting.domain.model.audit.OperationType;
-import com.example.accounting.infrastructure.persistence.repository.ChangeLogJpaRepository;
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import jakarta.persistence.*;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.security.core.context.SecurityContextHolder;
-import org.springframework.stereotype.Component;
-
-import java.time.LocalDateTime;
-
-/**
- * マスタ変更ログを自動記録する EntityListener
- *
- * JPA 版では @EntityListeners で Entity のライフサイクルをフック
- * MyBatis 版では DB トリガーで実装していた機能を Java コードで実現
- */
-@Component
-@Slf4j
-public class ChangeLogListener {
-
-    private static ChangeLogJpaRepository changeLogRepository;
-    private static ObjectMapper objectMapper;
-
-    @Autowired
-    public void setChangeLogRepository(ChangeLogJpaRepository repository) {
-        ChangeLogListener.changeLogRepository = repository;
-    }
-
-    @Autowired
-    public void setObjectMapper(ObjectMapper mapper) {
-        ChangeLogListener.objectMapper = mapper;
-    }
-
-    @PostPersist
-    public void postPersist(Object entity) {
-        saveChangeLog(entity, OperationType.INSERT, null, entity);
-    }
-
-    @PostUpdate
-    public void postUpdate(Object entity) {
-        saveChangeLog(entity, OperationType.UPDATE, null, entity);
-    }
-
-    @PostRemove
-    public void postRemove(Object entity) {
-        saveChangeLog(entity, OperationType.DELETE, entity, null);
-    }
-
-    private void saveChangeLog(Object entity, OperationType operationType,
-                               Object beforeData, Object afterData) {
-        try {
-            String tableName = getTableName(entity);
-            String recordKey = getRecordKey(entity);
-            String beforeJson = beforeData != null ? objectMapper.writeValueAsString(beforeData) : null;
-            String afterJson = afterData != null ? objectMapper.writeValueAsString(afterData) : null;
-
-            var changeLog = ChangeLog.builder()
-                .tableName(tableName)
-                .recordKey(recordKey)
-                .operationType(operationType)
-                .beforeData(beforeJson)
-                .afterData(afterJson)
-                .operatedAt(LocalDateTime.now())
-                .operatedBy(getCurrentUser())
-                .build();
-
-            changeLogRepository.save(changeLog);
-
-            log.debug("変更ログ記録: table={}, key={}, operation={}",
-                tableName, recordKey, operationType);
-
-        } catch (JsonProcessingException e) {
-            log.error("変更ログの JSON 変換に失敗しました", e);
-        }
-    }
-
-    private String getTableName(Object entity) {
-        Table tableAnnotation = entity.getClass().getAnnotation(Table.class);
-        return tableAnnotation != null ? tableAnnotation.name() : entity.getClass().getSimpleName();
-    }
-
-    private String getRecordKey(Object entity) {
-        return entity.toString();
-    }
-
-    private String getCurrentUser() {
-        var authentication = SecurityContextHolder.getContext().getAuthentication();
-        return authentication != null ? authentication.getName() : "system";
-    }
-}
-```
-
-</details>
-
-### EntityListener を使用する Entity
-
-```java
-// Account Entity に @EntityListeners を追加
-@Entity
-@Table(name = "勘定科目マスタ")
-@EntityListeners(ChangeLogListener.class)  // 変更ログを自動記録
-@Data
-@Builder
-@NoArgsConstructor
-@AllArgsConstructor
-public class Account extends BaseEntity {
-    // ... 既存のフィールド
-}
-```
-
----
-
-## 19.9 変更ログリポジトリの実装
-
-### JpaRepository と Specification
-
-<details>
-<summary>ChangeLogJpaRepository.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.repository;
-
-import com.example.accounting.domain.model.audit.ChangeLog;
-import com.example.accounting.domain.model.audit.OperationType;
-import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
-import org.springframework.data.jpa.repository.Query;
-import org.springframework.data.repository.query.Param;
-import org.springframework.stereotype.Repository;
-
-import java.time.LocalDateTime;
-import java.util.List;
-
-/**
- * 変更ログ JpaRepository
- *
- * JpaSpecificationExecutor を継承して動的クエリに対応
- */
-@Repository
-public interface ChangeLogJpaRepository
-        extends JpaRepository<ChangeLog, Long>,
-                JpaSpecificationExecutor<ChangeLog> {
-
-    /**
-     * テーブル名とレコードキーで検索
-     */
-    List<ChangeLog> findByTableNameAndRecordKeyOrderByOperatedAtDesc(
-            String tableName, String recordKey);
-
-    /**
-     * テーブル名で検索
-     */
-    List<ChangeLog> findByTableNameOrderByOperatedAtDesc(String tableName);
-
-    /**
-     * 操作種別で検索
-     */
-    List<ChangeLog> findByOperationTypeOrderByOperatedAtDesc(OperationType operationType);
-
-    /**
-     * 期間指定で検索
-     */
-    @Query("SELECT c FROM ChangeLog c " +
-           "WHERE c.operatedAt BETWEEN :from AND :to " +
-           "ORDER BY c.operatedAt DESC")
-    List<ChangeLog> findByDateRange(
-            @Param("from") LocalDateTime from,
-            @Param("to") LocalDateTime to);
-
-    /**
-     * 操作者で検索
-     */
-    List<ChangeLog> findByOperatedByOrderByOperatedAtDesc(String operatedBy);
-}
-```
-
-</details>
-
-### Specification による動的クエリ
-
-<details>
-<summary>ChangeLogSpecifications.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.specification;
-
-import com.example.accounting.domain.model.audit.ChangeLog;
-import com.example.accounting.domain.model.audit.OperationType;
-import org.springframework.data.jpa.domain.Specification;
-
-import java.time.LocalDateTime;
-
-/**
- * 変更ログ検索用 Specification
- *
- * JPA 版では Specification パターンで動的クエリを構築
- * MyBatis 版では XML の <if> タグで動的 SQL を構築していた
- */
-public class ChangeLogSpecifications {
-
-    public static Specification<ChangeLog> tableNameEquals(String tableName) {
-        return (root, query, cb) ->
-            tableName == null ? null : cb.equal(root.get("tableName"), tableName);
-    }
-
-    public static Specification<ChangeLog> recordKeyEquals(String recordKey) {
-        return (root, query, cb) ->
-            recordKey == null ? null : cb.equal(root.get("recordKey"), recordKey);
-    }
-
-    public static Specification<ChangeLog> operationTypeEquals(OperationType operationType) {
-        return (root, query, cb) ->
-            operationType == null ? null : cb.equal(root.get("operationType"), operationType);
-    }
-
-    public static Specification<ChangeLog> operatedAtAfter(LocalDateTime from) {
-        return (root, query, cb) ->
-            from == null ? null : cb.greaterThanOrEqualTo(root.get("operatedAt"), from);
-    }
-
-    public static Specification<ChangeLog> operatedAtBefore(LocalDateTime to) {
-        return (root, query, cb) ->
-            to == null ? null : cb.lessThanOrEqualTo(root.get("operatedAt"), to);
-    }
-
-    public static Specification<ChangeLog> operatedByEquals(String operatedBy) {
-        return (root, query, cb) ->
-            operatedBy == null ? null : cb.equal(root.get("operatedBy"), operatedBy);
-    }
-}
-```
-
-</details>
-
----
-
-## 19.10 変更ログリポジトリのテスト
-
-<details>
-<summary>ChangeLogRepositoryTest.java</summary>
-
-```java
-package com.example.accounting.infrastructure.persistence.repository;
-
-import com.example.accounting.application.port.out.ChangeLogRepository;
-import com.example.accounting.domain.model.audit.ChangeLog;
-import com.example.accounting.domain.model.audit.OperationType;
-import org.junit.jupiter.api.*;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
-import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
-import org.springframework.context.annotation.Import;
-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 java.time.LocalDateTime;
-
-import static org.assertj.core.api.Assertions.*;
-
-/**
- * 変更ログリポジトリのテスト
- */
-@DataJpaTest
-@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
-@Testcontainers
-@Import(ChangeLogRepositoryImpl.class)
-@DisplayName("変更ログリポジトリ")
-class ChangeLogRepositoryTest {
-
-    @Container
-    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16")
-            .withDatabaseName("testdb")
-            .withUsername("test")
-            .withPassword("test");
-
-    @DynamicPropertySource
-    static void configureProperties(DynamicPropertyRegistry registry) {
-        registry.add("spring.datasource.url", postgres::getJdbcUrl);
-        registry.add("spring.datasource.username", postgres::getUsername);
-        registry.add("spring.datasource.password", postgres::getPassword);
-    }
-
-    @Autowired
-    private ChangeLogRepository changeLogRepository;
-
-    @Nested
-    @DisplayName("登録")
-    class Insert {
-
-        @Test
-        @DisplayName("変更ログを登録できる")
-        void canInsertChangeLog() {
-            // Arrange
-            var changeLog = ChangeLog.builder()
-                    .tableName("勘定科目マスタ")
-                    .recordKey("11100")
-                    .operationType(OperationType.INSERT)
-                    .afterData("{\"勘定科目コード\":\"11100\",\"勘定科目名\":\"現金\"}")
-                    .operatedBy("admin")
-                    .build();
-
-            // Act
-            changeLogRepository.save(changeLog);
-
-            // Assert
-            assertThat(changeLog.getLogId()).isNotNull();
-            var result = changeLogRepository.findById(changeLog.getLogId());
-            assertThat(result).isPresent();
-            assertThat(result.get().getTableName()).isEqualTo("勘定科目マスタ");
-            assertThat(result.get().getOperationType()).isEqualTo(OperationType.INSERT);
-        }
-    }
-
-    @Nested
-    @DisplayName("検索")
-    class Search {
-
-        @Test
-        @DisplayName("テーブル名とレコードキーで検索できる")
-        void canFindByTableNameAndRecordKey() {
-            // Act
-            var result = changeLogRepository.findByTableNameAndRecordKey(
-                    "勘定科目マスタ", "11100");
-
-            // Assert
-            assertThat(result).allMatch(log ->
-                    log.getTableName().equals("勘定科目マスタ") &&
-                    log.getRecordKey().equals("11100"));
-        }
-
-        @Test
-        @DisplayName("複合条件で検索できる")
-        void canFindByConditions() {
-            // Act: Specification パターンで動的クエリ
-            var result = changeLogRepository.findByConditions(
-                    "勘定科目マスタ",
-                    null,
-                    OperationType.UPDATE,
-                    null,
-                    null,
-                    null);
-
-            // Assert
-            assertThat(result).allMatch(log ->
-                log.getOperationType() == OperationType.UPDATE);
-        }
-    }
-}
-```
-
-</details>
-
----
-
-## 19.11 まとめ：設計のポイント
-
-### 赤黒処理によるデータ訂正
-
-1. 物理削除を行わず、赤伝で打ち消し
-2. 監査証跡の確保
-3. 残高の自動調整
-4. JPA 版では CascadeType.ALL で一括保存
-
-### ログ管理方式の使い分け
-
-| データ種別 | 方式 | JPA 実装 |
-|----------|------|---------|
-| マスタデータ | ログテーブル方式 | @EntityListeners |
-| トランザクションデータ | 赤黒処理 | Cascade 保存 |
-| サマリデータ | 更新日時のみ | @EnableJpaAuditing |
-
-### JPA Auditing による自動化
-
-- @CreatedDate, @LastModifiedDate で日時自動設定
-- @CreatedBy, @LastModifiedBy で操作者自動設定
-- AuditorAware で Spring Security 連携
-
-### MyBatis 版との比較
-
-| 観点 | MyBatis 版 | JPA 版 |
-|------|-----------|--------|
-| 監査カラム設定 | 手動 / Interceptor | @EnableJpaAuditing |
-| マスタ変更ログ | DB トリガー | @EntityListeners |
-| ENUM 変換 | TypeHandler | AttributeConverter |
-| 動的クエリ | XML `<if>` タグ | Specification パターン |
-| 自動採番 | useGeneratedKeys | @GeneratedValue |
-| テスト | @MybatisTest | @DataJpaTest |
-
----
-
-## 次章予告
-
-[第20章](chapter20-orm.md)では、D社（化粧品製造販売）の事例に基づいて、Seedデータを作成します。JPA 版では CommandLineRunner と @Transactional を使用したデータ投入を実装します。