From 6651e0e809a041fe30e584117a9757e8b2f41a3e Mon Sep 17 00:00:00 2001
From: curry772 <curry772@gmail.com>
Date: Thu, 27 Aug 2026 12:02:50 +0900
Subject: [PATCH] =?UTF-8?q?fix:=20=EB=B3=80=ED=99=98=EB=A7=A4=ED=95=91=20?=
 =?UTF-8?q?=20item=EC=9D=B4=20=ED=95=98=EB=82=98=EB=8F=84=20=EC=97=86?=
 =?UTF-8?q?=EB=8A=94=20=EB=B3=80=ED=99=98=EB=A7=A4=ED=95=91=20=EB=A1=9C?=
 =?UTF-8?q?=EB=94=A9=20=EC=95=88=EB=90=98=EB=8A=94=20=EB=AC=B8=EC=A0=9C=20?=
 =?UTF-8?q?=EC=B2=98=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../transform/loader/TransformLoaderRepository.java    | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/main/java/com/eactive/eai/transformer/transform/loader/TransformLoaderRepository.java b/src/main/java/com/eactive/eai/transformer/transform/loader/TransformLoaderRepository.java
index e380a22..9a86734 100644
--- a/src/main/java/com/eactive/eai/transformer/transform/loader/TransformLoaderRepository.java
+++ b/src/main/java/com/eactive/eai/transformer/transform/loader/TransformLoaderRepository.java
@@ -11,7 +11,15 @@ import com.eactive.eai.data.jpa.BaseRepository;
 interface TransformLoaderRepository
 		extends DataLoaderRepository<TransformEntity>, BaseRepository<TransformEntity, String> {
 
-	@Query("from TransformEntity t inner join fetch t.transformItemEntities where t.useyn = '1' order by t.cnvsnname")
+	/**
+	 * 변환 마스터(TSEAITR01) 전체 로딩.
+	 *
+	 * 변환 항목 매핑(TSEAITR03)이 한 건도 없는 변환도 로딩 대상에 포함시키기 위해 left join fetch 를 사용한다.
+	 * inner join fetch 로 조회할 경우 TSEAITR03 이 비어 있는 변환은 결과에서 통째로 누락되어,
+	 * 온라인 서버 기동 후 해당 변환 호출 시 "전문레이아웃매핑(변환)정보를 찾을 수 없음" 오류가 발생한다.
+	 * (매핑 항목이 없는 변환은 TransformValidator 가 기동 시 warn 으로 남긴다)
+	 */
+	@Query("from TransformEntity t left join fetch t.transformItemEntities where t.useyn = '1' order by t.cnvsnname")
 	@Override
 	Stream<TransformEntity> loadAll();