refactor #558: collapse secondary UI guidance

src/main/resources/templates/objects.html

@@ -6,14 +6,19 @@
 <main class="container py-4">
   <div class="page-title">
     <h1>ORDS 조회 대상 등록</h1>
-    <p>이 화면은 DB 객체를 HTTP로 연결할 경로만 등록합니다. 누가 어떤 행을 볼 수 있는지는 권한 규칙과 VPD에서 결정합니다.</p>
+    <p class="context-summary">DB 객체를 조회 Handler에 연결하는 화면입니다. 접근 권한은 별도로 관리합니다.</p>
+    <details class="explanation-details">
+      <summary>이 화면의 역할 설명 보기</summary>
+      <p>이 화면은 DB 객체를 HTTP로 연결할 경로만 등록합니다. 누가 어떤 행을 볼 수 있는지는 권한 규칙과 VPD에서 결정합니다.</p>
+    </details>
   </div>
 
   <div class="alert alert-info">
-    <strong>벡터 지식자료 검색 흐름:</strong>
-    문서를 청크로 나누고 기술 태그를 붙인 뒤 전용 ORDS 검색을 등록합니다.
-    그 다음 <a href="/permissions">권한 관리</a>에서 <code>특정 기술 태그</code>를 여러 개 추가하면
-    태그 중 하나라도 맞는 청크만 검색됩니다.
+    <strong>벡터 검색 예제:</strong> 문서 청크와 기술 태그를 등록한 뒤 전용 ORDS 검색을 연결합니다.
+    <details class="explanation-details mt-2">
+      <summary>벡터 지식자료 검색 흐름 설명 보기</summary>
+      <p>문서를 청크로 나누고 기술 태그를 붙인 뒤 전용 ORDS 검색을 등록합니다. 그 다음 <a href="/permissions">권한 관리</a>에서 <code>특정 기술 태그</code>를 여러 개 추가하면 태그 중 하나라도 맞는 청크만 검색됩니다.</p>
+    </details>
   </div>
 
   <section th:replace="~{fragments/layout :: architectureStrip('ords')}"></section>
@@ -23,7 +28,11 @@
 
   <section class="content-band">
     <h2>조회 대상 추가 (예제 Handler)</h2>
-    <p class="section-subtitle">DB 객체 하나를 하나의 조회 Handler로 연결하는 예제입니다. 대상 추가 후 Handler를 생성하면 VPD context 설정과 기본 SELECT가 포함된 PL/SQL이 만들어지며, 소스 보기에서 실제 업무에 맞게 수정할 수 있습니다.</p>
+    <p class="section-subtitle">DB 객체 하나를 하나의 조회 Handler로 연결하는 시작 예제입니다.</p>
+    <details class="explanation-details">
+      <summary>대상 추가 후 생성되는 내용 보기</summary>
+      <p>대상 추가 후 Handler를 생성하면 VPD context 설정과 기본 SELECT가 포함된 PL/SQL이 만들어집니다. 소스 보기에서 실제 업무에 맞게 수정할 수 있습니다.</p>
+    </details>
     <form method="post" action="/objects" class="form-grid">
       <input type="hidden" th:name="${_csrf.parameterName}" th:value="${_csrf.token}">
       <input type="hidden" name="owner" required>
@@ -58,13 +67,10 @@
       </label>
       <button class="btn btn-primary" type="submit">대상 추가</button>
     </form>
-    <div class="alert alert-info mt-3 mb-0">
-      <strong>생성되는 예제 흐름:</strong>
-      <code>cb_ords_handler_pkg.set_vpd_context(:auth_header)</code>로 토큰의 사용자·역할 컨텍스트를 넣고,
-      선택한 한 테이블에 <code>SELECT ... FROM OWNER.TABLE</code>을 실행한 뒤 JSON으로 반환합니다.
-      이것은 유일한 사용 방식이 아니라 시작점이며, Handler 소스와 ORDS 메타데이터에서 수정할 수 있습니다.
-      컬럼 민감도·마스킹은 이 화면에서 다루지 않고 <a href="/permissions">권한 관리의 원문 표시 허용 컬럼</a>에서 별도로 설정합니다.
-    </div>
+    <details class="explanation-details explanation-warning mt-3">
+      <summary>기본 Handler 예제와 수정 가이드 보기</summary>
+      <p><code>cb_ords_handler_pkg.set_vpd_context(:auth_header)</code>로 토큰의 사용자·역할 컨텍스트를 넣고, 선택한 한 테이블에 <code>SELECT ... FROM OWNER.TABLE</code>을 실행한 뒤 JSON으로 반환합니다. 이것은 유일한 사용 방식이 아니라 시작점이며, Handler 소스와 ORDS 메타데이터에서 수정할 수 있습니다. 컬럼 민감도·마스킹은 이 화면에서 다루지 않고 <a href="/permissions">권한 관리의 원문 표시 허용 컬럼</a>에서 별도로 설정합니다.</p>
+    </details>
   </section>
 
   <section class="content-band">
@@ -135,11 +141,13 @@
           </tr>
           <tr>
             <td colspan="6" class="policy-source-cell">
-              <div class="object-handler-explainer">
-                <strong>이 대상에서 자동으로 연결되는 것</strong>
-                <span>토큰 헤더 → VPD context 설정 → 선택한 단일 테이블의 기본 SELECT → JSON 응답</span>
-                <small>행 접근은 권한 규칙/VPD가 담당합니다. 원문 표시 예외는 권한 관리 Step 4에서 여러 컬럼을 등록하세요.</small>
-              </div>
+              <details class="explanation-details">
+                <summary>이 대상의 자동 연결 흐름 보기</summary>
+                <div class="object-handler-explainer">
+                  <strong>토큰 헤더 → VPD context 설정 → 선택한 단일 테이블의 기본 SELECT → JSON 응답</strong>
+                  <small>행 접근은 권한 규칙/VPD가 담당합니다. 원문 표시 예외는 권한 관리 Step 4에서 여러 컬럼을 등록하세요.</small>
+                </div>
+              </details>
               <div th:if="${object.objectName() != 'CB_VECTOR_SEARCH_DOCUMENTS'}"
                    th:id="${'handler-source-' + object.objectId()}" class="text-muted small">
                 소스 보기를 누르면 기본 Handler PL/SQL이 표시됩니다.