[Developer] #567 expose VPD effective SQL trace

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

@@ -70,6 +70,33 @@
     </div>
   </section>
 
+  <section class="result-section sql-trace-section" th:if="${result.hasSqlTrace()}">
+    <div class="section-heading compact-heading">
+      <div>
+        <h3>토큰 적용 후 SQL</h3>
+        <p class="section-subtitle">ORDS Handler가 반환한 VPD predicate 또는 같은 토큰 컨텍스트를 재현해 조회한 predicate를 기본 조회문에 합친 형태입니다.</p>
+      </div>
+      <span class="badge text-bg-light">DBMS_RLS predicate</span>
+    </div>
+    <div class="probe-exchange-grid mt-3">
+      <section class="probe-exchange" data-sql-trace-field="vpd_predicate">
+        <h3>VPD가 추가한 WHERE 조건</h3>
+        <pre th:text="${result.vpdPredicate()}">(DEPT_CODE = SYS_CONTEXT('CB_AGENT_CTX', 'DEPT_CODE'))</pre>
+      </section>
+      <section class="probe-exchange" data-sql-trace-field="effective_sql">
+        <h3>권한 적용 SQL</h3>
+        <pre th:text="${result.effectiveSql()}">SELECT ... WHERE (...) AND ROWNUM &lt;= ...</pre>
+      </section>
+    </div>
+    <p class="form-hint mt-2 mb-0">
+      Oracle 내부 optimizer의 실행계획이나 bind 값 치환 결과가 아니라, 이 토큰 컨텍스트에서 VPD 정책 함수가 실제로 반환한 행 조건을 표시합니다. 컬럼 마스킹은 별도 Redaction 정책입니다.
+    </p>
+  </section>
+
+  <div class="alert alert-light mb-0" th:if="${result.successLike() and !result.hasSqlTrace()}">
+    이 Handler는 SQL trace 정보를 반환하지 않았고 백오피스 DB에서도 기본 VPD predicate를 조회하지 못했습니다. <a href="/ords-handlers">ORDS 핸들러</a>에서 trace가 포함된 소스를 적용하고, <code>CB_AGENT_DOC_VPD_FILTER</code> 실행 권한을 확인하세요.
+  </div>
+
   <section class="next-action-card">
     <h3>다음에 할 일</h3>
     <p th:text="${result.nextAction()}">다음 행동</p>

src/main/resources/templates/ords-handlers.html

@@ -9,10 +9,14 @@
     <p class="context-summary">토큰을 DB 권한 컨텍스트로 바꾸는 Handler를 확인·수정합니다.</p>
     <details class="explanation-details">
       <summary>Handler 처리 흐름 설명 보기</summary>
-      <p>Bearer Token을 DB 컨텍스트로 변환한 뒤 VPD가 권한체계를 적용합니다. 아래 소스는 등록된 ORDS Handler가 실제로 실행하는 기술 세부 내용입니다.</p>
+      <p>Bearer Token을 DB 컨텍스트로 변환한 뒤 VPD가 권한체계를 적용합니다. 아래 소스는 등록된 ORDS Handler가 실제로 실행하는 기술 세부 내용입니다. 실행 결과의 “토큰 적용 후 SQL”은 권한 결과 확인 메뉴에서 확인할 수 있습니다.</p>
     </details>
   </div>
 
+  <div class="alert alert-info">
+    권한별로 VPD가 붙인 실제 행 조건을 확인하려면 <a href="/probe">권한 결과 확인</a>에서 이 Handler의 보호 객체를 실행하세요. SQL trace를 반환하도록 갱신된 Handler는 같은 ORDS 세션의 <code>CB_AGENT_DOC_VPD_FILTER</code> predicate를 함께 표시합니다.
+  </div>
+
   <div class="alert alert-success" th:if="${message}" th:text="${message}"></div>
   <div class="alert alert-danger" th:if="${errorMessage}" th:text="${errorMessage}"></div>