From bc0824b934e683922b8859747ca404afd2289bd9 Mon Sep 17 00:00:00 2001
From: Marcel <marcel@familienarchiv>
Date: Wed, 29 Apr 2026 19:55:16 +0200
Subject: [PATCH] refactor(TranscriptionBlock): document EAGER fetch rationale

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../org/raddatz/familienarchiv/model/TranscriptionBlock.java    | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/backend/src/main/java/org/raddatz/familienarchiv/model/TranscriptionBlock.java b/backend/src/main/java/org/raddatz/familienarchiv/model/TranscriptionBlock.java
index af56efe4..6d3e167d 100644
--- a/backend/src/main/java/org/raddatz/familienarchiv/model/TranscriptionBlock.java
+++ b/backend/src/main/java/org/raddatz/familienarchiv/model/TranscriptionBlock.java
@@ -35,6 +35,8 @@ public class TranscriptionBlock {
     @Column(columnDefinition = "TEXT")
     private String text;
 
+    // EAGER: mention set is bounded by block text length (typically < 20 entries).
+    // Switching back to LAZY requires callers to be inside an open Hibernate session.
     @ElementCollection(fetch = FetchType.EAGER)
     @CollectionTable(
             name = "transcription_block_mentioned_persons",