[Developer] #572 separate vector search and VPD filter trace

src/main/resources/templates/fragments/probe-result.html

@@ -112,7 +112,10 @@
     <div class="section-heading compact-heading">
       <div>
         <h3>토큰 적용 후 SQL</h3>
-        <p class="section-subtitle">ORDS Handler가 반환한 VPD predicate 또는 같은 토큰 컨텍스트를 재현해 조회한 predicate를 기본 조회문에 합친 형태입니다.</p>
+        <p class="section-subtitle"
+           th:text="${vectorSearch ? 'VECTOR_DISTANCE 유사도 검색과 현재 사용자의 역할 기반 VPD 권한 필터를 결합한 재현용 SQL입니다.' : 'ORDS Handler가 반환한 VPD predicate 또는 같은 토큰 컨텍스트를 재현해 조회한 predicate를 기본 조회문에 합친 형태입니다.'}">
+          ORDS Handler가 반환한 VPD predicate 또는 같은 토큰 컨텍스트를 재현해 조회한 predicate를 기본 조회문에 합친 형태입니다.
+        </p>
       </div>
       <span class="badge text-bg-light">DBMS_RLS predicate</span>
     </div>
@@ -137,9 +140,17 @@
           </div>
         </dl>
       </section>
+      <section class="probe-exchange" data-sql-trace-field="vector_search" th:if="${vectorSearch}">
+        <h3>벡터 유사도 검색 기준</h3>
+        <pre>VECTOR_DISTANCE(d.embedding, TO_VECTOR(:embedding), COSINE) AS score
+ORDER BY score ASC
+ROWNUM &lt;= :row_limit</pre>
+        <p class="form-hint mb-0">이 부분이 검색어 벡터와 저장 벡터의 거리 계산입니다. 아래 권한 필터의 TAG 조건은 검색어 유사도 계산이 아니라 접근 통제입니다.</p>
+      </section>
       <section class="probe-exchange" data-sql-trace-field="vpd_predicate">
-        <h3>VPD가 추가한 WHERE 조건</h3>
+        <h3 th:text="${vectorSearch ? '역할 기반 권한 필터 (VPD)' : 'VPD가 추가한 WHERE 조건'}">VPD가 추가한 WHERE 조건</h3>
         <pre th:text="${result.vpdPredicate()}">(DEPT_CODE = SYS_CONTEXT('CB_AGENT_CTX', 'DEPT_CODE'))</pre>
+        <p class="form-hint mb-0" th:if="${vectorSearch}">선택한 사용자의 직접 역할·그룹 상속 역할에 연결된 permission rule에서 계산된 조건입니다. 권한이 없으면 <code>1 = 0</code>, ALL이면 <code>1 = 1</code>이 됩니다.</p>
       </section>
       <section class="probe-exchange" data-sql-trace-field="effective_sql">
         <h3>권한 적용 SQL</h3>

src/test/java/com/cloudhandson/vpdbackoffice/web/GuidedFlowTemplateTest.java

@@ -37,6 +37,9 @@ class GuidedFlowTemplateTest {
         .contains("토큰 적용 후 SQL")
         .contains("set_vpd_context 사용자 컨텍스트")
         .contains("CB_AGENT_CTX.USER_ID")
+        .contains("벡터 유사도 검색 기준")
+        .contains("역할 기반 권한 필터 (VPD)")
+        .contains("VECTOR_DISTANCE")
         .contains("벡터 검색 Top-K")
         .contains("벡터 거리 (SCORE)")
         .contains("vpd_predicate")