[Developer] #619 map stakeholder tokens to permission rules

src/main/resources/templates/fragments/layout.html

@@ -21,6 +21,8 @@
       <button class="rw-menu-trigger" type="button" data-submenu-trigger="operations" aria-controls="submenu-operations" aria-expanded="false">운영</button>
     </div>
     <div class="rw-nav-utility ms-auto">
+      <a class="rw-quick-link" href="/permissions">권한 설정</a>
+      <a class="rw-quick-link" href="/tokens">토큰 발급</a>
       <button class="rw-admin-trigger" type="button" data-submenu-trigger="admin" aria-controls="submenu-admin" aria-expanded="false">관리자</button>
       <form method="post" action="/logout">
         <input type="hidden" th:name="${_csrf.parameterName}" th:value="${_csrf.token}">
@@ -34,12 +36,12 @@
           <a class="nav-link" href="/users">사용자 관리</a>
           <a class="nav-link" href="/groups">그룹 관리</a>
           <a class="nav-link" href="/roles">역할 관리</a>
-          <a class="nav-link" href="/permissions">접근 규칙</a>
+          <a class="nav-link" href="/permissions">권한 설정</a>
           <a class="nav-link" href="/effective-matrix">권한 현황</a>
       </div>
       <div id="submenu-protection" class="rw-submenu" data-submenu-panel="protection" role="navigation" aria-label="보호 및 검증 메뉴" hidden>
           <a class="nav-link" href="/vpd-policies">보호 상태</a>
-          <a class="nav-link" href="/tokens">검증 세션</a>
+          <a class="nav-link" href="/tokens">토큰 발급</a>
           <a class="nav-link" href="/probe">접근 검증</a>
       </div>
       <div id="submenu-integration" class="rw-submenu" data-submenu-panel="integration" role="navigation" aria-label="연동 도구 메뉴" hidden>

src/main/resources/templates/permissions.html

@@ -8,7 +8,7 @@
     <h1>접근 규칙</h1>
     <details class="explanation-details">
       <summary>도움말</summary>
-      <p>VPD policy function이 참조할 사용자, 역할, 행 규칙, 컬럼 원문 허용 규칙을 저장합니다. 이 화면에서 만든 규칙이 기본 Filter의 동적 입력이 됩니다.</p>
+      <p>VPD policy function이 참조할 사용자, 역할, 행 규칙, 컬럼 원문 허용 규칙을 저장합니다. KB 원장 예제에서 <code>STAKEHOLDER_SELF</code>는 토큰의 이해당사자 ID, <code>STAKEHOLDER_CHANNEL</code>은 역할에 연결된 채널로 행 범위를 계산합니다.</p>
     </details>
   </div>
 
@@ -167,6 +167,8 @@
                 <option value="DEPT">지정 부서</option>
                 <option value="EMP_NO">지정 사번</option>
                 <option value="TAG">특정 기술 태그</option>
+                <option value="STAKEHOLDER_SELF">이해당사자 본인 담당</option>
+                <option value="STAKEHOLDER_CHANNEL">이해당사자 채널 범위</option>
                 <option value="=">=</option>
                 <option value="!=">!=</option>
               </select>
@@ -176,7 +178,7 @@
           </div>
           <details class="explanation-details">
             <summary>행 규칙과 기술 태그 OR 조건 보기</summary>
-            <p class="wizard-hint">특정 기술 태그는 기본적으로 <code>TECH_TAG</code> 컬럼을 봅니다. 같은 ALLOW 권한에 태그를 여러 개 추가하면 “태그 A 또는 태그 B”로 조회되고, DENY 태그는 허용 결과에서 제외됩니다. 객체에 TECH_TAG가 없으면 실제 태그 컬럼을 직접 지정하세요.</p>
+            <p class="wizard-hint">특정 기술 태그는 기본적으로 <code>TECH_TAG</code> 컬럼을 봅니다. 같은 ALLOW 권한에 태그를 여러 개 추가하면 “태그 A 또는 태그 B”로 조회됩니다. <code>이해당사자 본인 담당</code>은 <code>FC_ID</code>를 직접 비교하거나 <code>CUST_ID</code>/<code>CONTRACT_NO</code>를 계약원장에 안전하게 연결합니다. <code>이해당사자 채널 범위</code>도 같은 방식으로 <code>FC_CHANNEL</code>을 비교합니다. 두 이해당사자 규칙은 비교할 컬럼을 반드시 선택하세요.</p>
           </details>
         </div>
       </div>
@@ -261,7 +263,7 @@
                   th:classappend="${permission.permissionEffect() == 'DENY'} ? ' text-bg-danger' : ' text-bg-success'"
                   th:text="${permission.permissionEffect()}">ALLOW</span>
           </td>
-          <td><pre class="table-pre" th:text="${permission.filterPreview()} ?: ${permission.rules()} ?: '-'">ALL ROWS</pre></td>
+          <td><pre class="table-pre" th:text="${permission.filterPreview() ?: permission.rules() ?: '-'}">ALL ROWS</pre></td>
           <td th:text="${permission.visibleColumns()} ?: '-'">CONTENTS</td>
           <td>
             <details class="row-management">

src/main/resources/templates/tokens.html

@@ -8,7 +8,7 @@
     <h1>검증 세션</h1>
     <details class="explanation-details">
       <summary>도움말</summary>
-      <p>검증할 사용자를 나타내는 토큰을 만들고, 한 번만 표시되는 원문을 다음 단계에서 사용합니다. 원문은 저장하지 않고 해시와 식별용 prefix만 보관합니다.</p>
+      <p>이해당사자 원장에 등록된 업무 사용자를 토큰에 연결합니다. 토큰 원문은 한 번만 표시하며, DB에는 해시와 식별용 prefix만 보관합니다. 역할·채널·행 권한은 토큰이 아니라 접근 규칙에서 동적으로 계산합니다.</p>
     </details>
   </div>
 
@@ -27,16 +27,19 @@
   <section class="content-band">
     <div class="section-heading">
       <div>
-        <h2>검증 사용자 선택</h2>
-        <p class="section-subtitle">토큰에는 사용자의 직접 역할과 그룹 상속 역할이 연결됩니다. 권한 자체를 토큰에 복사하지 않으므로 이후 권한 변경도 동적으로 반영됩니다.</p>
+        <h2>이해당사자 토큰 발급</h2>
+        <p class="section-subtitle">모든 KB 이해당사자에게 토큰을 발급할 수 있습니다. 지점장·설계사 등의 실제 행 범위는 접근 규칙에 연결된 역할로 결정되므로, 토큰을 다시 만들지 않아도 권한 변경이 반영됩니다.</p>
       </div>
     </div>
     <form method="post" action="/tokens" class="form-grid">
       <input type="hidden" th:name="${_csrf.parameterName}" th:value="${_csrf.token}">
       <label>
-        사용자
-        <select class="form-select" name="userId" required>
-          <option th:each="user : ${users}" th:value="${user.userId()}" th:text="${user.username()}"></option>
+        이해당사자
+        <select class="form-select" name="stakeholderUserId" required>
+          <option value="" selected disabled>토큰을 발급할 이해당사자 선택</option>
+          <option th:each="stakeholder : ${stakeholders}"
+                  th:value="${stakeholder.stakeholderUserId()}"
+                  th:text="${stakeholder.displayLabel()}"></option>
         </select>
       </label>
       <label>
@@ -71,12 +74,13 @@
     </div>
     <div class="table-responsive">
       <table class="table table-sm align-middle">
-        <thead><tr><th>ID</th><th>사용자</th><th>용도</th><th>식별용 Prefix</th><th>만료</th><th>회수</th><th></th></tr></thead>
+        <thead><tr><th>ID</th><th>이해당사자</th><th>역할·채널</th><th>용도</th><th>식별용 Prefix</th><th>만료</th><th>회수</th><th></th></tr></thead>
         <tbody>
         <tr th:each="token : ${tokens}"
             th:attr="data-key-id=${token.keyId()},data-description=${token.description()},data-revoked=${token.revokedAt() != null}">
           <td th:text="${token.keyId()}">1</td>
           <td th:text="${token.username()}">user</td>
+          <td th:text="${token.stakeholderRole() == null ? '기존 앱 사용자' : token.stakeholderRole() + ' / ' + token.stakeholderChannel()}">지점장 / 설계사채널</td>
           <td th:text="${token.description()} ?: '-'">용도</td>
           <td><code th:text="${token.keyPrefix() + '****'}">vpd_****</code></td>
           <td th:text="${token.expiresAt()}">2026</td>
@@ -90,7 +94,7 @@
             </form>
           </td>
         </tr>
-        <tr th:if="${#lists.isEmpty(tokens)}"><td colspan="7" class="text-muted">아직 발급된 토큰이 없습니다.</td></tr>
+        <tr th:if="${#lists.isEmpty(tokens)}"><td colspan="8" class="text-muted">아직 발급된 토큰이 없습니다.</td></tr>
         </tbody>
       </table>
     </div>