Merge branch 'master' into design

수신자 이름 지정 인증번호 발송 기능 추가:
- %USER_NAME% 지원 위한 createMessageRecipient 수정 - GUEST_USER_NAME 상수 및 관련 기본값 처리 로직 추가
2026-08-07 10:19:52 +09:00 · 2026-08-07 09:20:39 +09:00 · 2026-08-06 13:21:41 +09:00 · 2026-08-06 13:20:27 +09:00 · 2026-08-06 13:20:21 +09:00 · 2026-08-06 09:59:34 +09:00
36 changed files with 1692 additions and 258 deletions
@@ -521,6 +521,7 @@ ls -lh src/main/resources/static/css/main.min.css  # minified
 ## 문서

 - **개발환경 준비 사항**: [`djb-docs/개발환경-준비-사항.md`](djb-docs/개발환경-준비-사항.md) — JDK·Gradle·Node.js·SASS 설치 가이드
+- **메뉴 관리 개발 가이드**: [`readme-docs/메뉴-관리-개발-가이드.md`](readme-docs/메뉴-관리-개발-가이드.md) — menu.yml/roles.yml 스키마·시딩 규칙·캐시 리로드·admin 포탈메뉴관리 연동
 - **프로젝트 상세 지침**: `CLAUDE.md` (한글)
 - **사용자 가이드**: `개발자포탈.md` (한글)
 - **빌드 스크립트**: `build-gf63.sh`, `deploy_portal.sh`
@@ -0,0 +1,85 @@
+# 메뉴 관리 개발 가이드
+
+포탈 GNB/마이페이지 메뉴는 `menu.yml` → DB(PTL_MENU_*) → 캐시 → 템플릿 렌더 구조로 동작하며,
+노출/배치 관리는 eapim-admin **포탈메뉴관리**(파트너포탈 > 포탈관리 > 메뉴 관리)에서 수행한다.
+
+## 구성 요소
+
+| 구성 | 위치 | 역할 |
+|---|---|---|
+| `menu.yml` | `src/main/resources/menu.yml` | 기본 메뉴 정의 (id/노출명/path/권한/기본 배치) |
+| `roles.yml` | `src/main/resources/roles.yml` | 역할 정의 (`portal.portal_security` 이동분) |
+| 엔티티/공유 서비스 | `elink-portal-common` `com.eactive.apim.portal.menu.*` | PTL_MENU_ITEM·PTL_MENU_PLACEMENT·PTL_ROLE(+AUTHORITY), `PortalMenuDataService` |
+| 시더 | `djb/menu/MenuSeeder.java` | 부팅 시 yml→DB 적재 (ApplicationReadyEvent) |
+| 캐시 | `djb/menu/MenuService.java` | role 비의존 트리 스냅샷, TTL 1시간(PTL_PROPERTY) |
+| 렌더 | `djb/menu/MenuModelAdvice.java` → 모델 `menuView` | 요청별 노출(EXPOSE_ROLES) 필터 |
+| 접근 제어 | `djb/menu/MenuAccessInterceptor.java` | ACCESS_ROLES 서버측 집행 (경로 정확 일치) |
+| 내부 API | `djb/menu/MenuInternalController.java` | `POST /internal/menu/reload` (admin 캐시 리로드 수신) |
+
+메뉴를 소비하는 템플릿: `fragment/djbank/header_container.html`(데스크톱 nav·마이페이지 드롭다운·모바일 drawer),
+`fragment/djbank/service_sidebar.html`. 모두 `${menuView}` 를 반복 렌더하므로 **메뉴 추가 시 템플릿 수정 불필요**.
+
+## menu.yml 스키마
+
+```yaml
+portal-menu:
+  items:
+    - id: support            # kebab-case 필수 (^[a-z0-9-]+$). 변경 금지(변경=신규 항목)
+      name: "고객지원"
+      group: true            # 상위 그룹. path 생략 시 클릭 없음(자식 있어야 노출)
+      section: GNB           # GNB(기본) | MYPAGE. 자식은 부모 섹션 상속
+      expose-roles: []       # 생략=전체(익명 포함), AUTHENTICATED=로그인자, 그 외 역할코드 any-of
+      children:
+        - { id: support-faq, name: "FAQ", path: /faq_list }
+    - { id: my-page-webhook, name: "Webhook 관리", path: /webhook, icon: fa-bell,
+        expose-roles: [ROLE_WEBHOOK], access-roles: [ROLE_WEBHOOK] }
+```
+
+- `expose-roles` = 메뉴 **노출** 조건, `access-roles` = URL **접근** 조건(인터셉터 차단, redirect).
+- `icon` 은 마이페이지 드롭다운 전용(FontAwesome 클래스).
+- 정렬은 yml 나열 순서(기본 배치 sort = index×10).
+
+## 시딩 규칙 (MenuSeeder)
+
+1. **항목**: id 기준 upsert. yml 값이 바뀌면 DFLT_*(기본값 스냅샷)를 갱신하고,
+   **관리자가 수정하지 않은 필드(현재값==구 기본값)만** 새 기본값을 따라간다.
+   구조 필드(`group`/`section`/`icon`/`new-window`)는 항상 yml 이 이긴다.
+2. **배치**: `PTL_MENU_PLACEMENT` 가 **비어있을 때만** 기본 배치로 최초 시딩.
+   이후 배치는 admin 이 소유한다 — 재배포/재기동에도 보존됨.
+3. yml 에서 항목을 제거해도 DB 는 삭제하지 않고 경고 로그만 남긴다(수동 정리).
+4. 부팅 시딩 주체는 인증 사용자가 없으므로 `CREATED_BY=SYSTEM`.
+
+## 캐시와 리로드
+
+- 스냅샷 TTL: PTL_PROPERTY `Portal / menu.cache.ttl-seconds` (기본 3600초).
+- 즉시 반영: `curl -X POST http://127.0.0.1:39130/internal/menu/reload`
+  (admin 포탈메뉴관리의 [캐시 Reload] 버튼이 동일 호출 수행).
+- 내부 API 가드: `Portal / menu.internal.allow-ips` 허용 IP 목록(기본 loopback)
+  + X-Forwarded-For 동반 요청 거부. CSRF 면제(`/internal/menu/**`).
+- admin 측 호출 URL: `Portal / portal.internal.menu-reload-url`.
+
+## 새 메뉴 추가 절차
+
+**기본 메뉴(코드 배포와 함께)**
+1. 페이지/라우트 준비 (`portal.pages` 또는 `@GetMapping` — 기존 방식 그대로)
+2. `menu.yml` 에 항목 추가 (필요 시 breadcrumb 용 `page.home` 트리도 갱신 — 별도 체계 유지)
+3. 재기동 → 시딩 로그 확인 → 헤더/드로어 노출 확인
+4. 이미 운영 중인 DB 라면 배치는 자동 추가되지 않음(배치 시딩은 최초 1회) —
+   admin 화면에서 미배치 → 원하는 위치로 드래그 후 저장
+
+**운영자 임시 메뉴(외부 링크 등)**: admin 포탈메뉴관리 [메뉴 추가] → 미배치 생성 → 드래그 배치 → 저장 → 캐시 Reload.
+커스텀 항목은 미배치 시 삭제된다.
+
+## 로컬 개발 주의
+
+- `gradle bootRun` 으로 시딩까지 확인하려면 damo-manager 가 classpath 에 필요:
+  `JAVA_TOOL_OPTIONS="-Xbootclasspath/a:<...>/apache-tomcat-9.0.115-djb/lib/damo-manager.jar"`
+  (미지정 시 감사 컬럼 암호화 컨버터에서 NoClassDefFoundError).
+- 템플릿/메뉴 반영 확인은 서버 재시작 후 curl 로.
+- elink-portal-common 수정 후 Q클래스 duplicate 컴파일 오류 시 각 모듈 `build/generated` 삭제 후 재컴파일.
+
+## 역할(roles.yml) 변경
+
+- 로그인 권한 확장은 `PortalRolesProperties`(yml 바인딩)를 직접 사용 — DB 미러(PTL_ROLE*)는
+  admin 권한 선택 체크박스 소스 전용.
+- 역할 추가 시 `roles.yml` 의 `authority-names` 에 한글 라벨을 함께 등록해야 admin 화면에 표기된다.
@@ -4,11 +4,23 @@ public interface AuthNumberService {

    String sendRequestAuthNumber(String recipientKey, String msgType);

+    /**
+     * 기본 TTL 로 발송하되 수신자 이름을 지정한다. 세 번째 인자가 int 인 오버로드(TTL 지정)와 혼동하지 말 것.
+     */
+    String sendRequestAuthNumber(String recipientKey, String msgType, String username);
+
    /**
     * 인증번호를 지정한 유효시간(초)으로 발송한다. 로그인/step-up 2FA 는 회원가입 기본 TTL 과
     * 다른 값을 쓸 수 있으므로 호출부에서 TTL 을 지정한다.
     */
    String sendRequestAuthNumber(String recipientKey, String msgType, int ttlSeconds);

+    /**
+     * 수신자 이름을 지정해 인증번호를 발송한다. 메시지 템플릿의 %USER_NAME% 치환에 사용되며,
+     * 회원가입·아이디/비밀번호 찾기처럼 사용자 이름을 알 수 없는 흐름은 "guest" 를 넘긴다.
+     * username 이 비어 있으면 %USER_NAME% 은 치환되지 않고 원문이 그대로 남는다.
+     */
+    String sendRequestAuthNumber(String recipientKey, String msgType, int ttlSeconds, String username);
+
    boolean verifyAuthNumber(String recipientKey, String authNumber);
 }
@@ -45,19 +45,31 @@ public class AuthNumberServiceImpl implements AuthNumberService {
    @Override
    @Transactional(noRollbackFor = AuthNumberException.class)
    public String sendRequestAuthNumber(String recipientKey, String msgType) {
-        return sendRequestAuthNumber(recipientKey, msgType, authNumberExpirationTime);
+        return sendRequestAuthNumber(recipientKey, msgType, authNumberExpirationTime, null);
+    }
+
+    @Override
+    @Transactional(noRollbackFor = AuthNumberException.class)
+    public String sendRequestAuthNumber(String recipientKey, String msgType, String username) {
+        return sendRequestAuthNumber(recipientKey, msgType, authNumberExpirationTime, username);
    }

    @Override
    @Transactional(noRollbackFor = AuthNumberException.class)
    public String sendRequestAuthNumber(String recipientKey, String msgType, int ttlSeconds) {
+        return sendRequestAuthNumber(recipientKey, msgType, ttlSeconds, null);
+    }
+
+    @Override
+    @Transactional(noRollbackFor = AuthNumberException.class)
+    public String sendRequestAuthNumber(String recipientKey, String msgType, int ttlSeconds, String username) {
        logger.info("Sending auth number to: {} via {} (ttl={}s)", recipientKey, msgType, ttlSeconds);

        validateResendTime(recipientKey);

        String authNumber = generator.generateAuthNumber();

-        MessageRecipient recipient = createMessageRecipient(recipientKey, msgType);
+        MessageRecipient recipient = createMessageRecipient(recipientKey, msgType, username);
        messageSender.sendAuthMessage(recipient, authNumber, msgType);

        storage.saveAuthNumber(recipientKey, authNumber,
@@ -99,9 +111,13 @@ public class AuthNumberServiceImpl implements AuthNumberService {
        });
    }

-    private MessageRecipient createMessageRecipient(String recipientKey, String msgType) {
+    private MessageRecipient createMessageRecipient(String recipientKey, String msgType, String username) {
        MessageRecipient recipient = new MessageRecipient();
        recipient.setUserId(recipientKey);
+        // 메시지 템플릿 %USER_NAME% 치환용. 비어 있으면 MessageSendService 가 파라미터 자체를 넣지 않는다.
+        if (username != null && !username.trim().isEmpty()) {
+            recipient.setUsername(username);
+        }
        if ("SMS".equalsIgnoreCase(msgType)) {
            recipient.setPhone(recipientKey);
        } else if ("EMAIL".equalsIgnoreCase(msgType)) {
@@ -17,6 +17,12 @@ public class AuthFacadeImpl implements AuthFacade {
    private final AuthNoticeProperties authNoticeProperties;
    private static final Logger log = LoggerFactory.getLogger(AuthFacadeImpl.class);

+    /**
+     * 회원가입·아이디/비밀번호 찾기 등 로그인 이전 흐름은 수신자 이름을 알 수 없으므로
+     * 메시지 템플릿 %USER_NAME% 자리에 넣을 기본값.
+     */
+    private static final String GUEST_USER_NAME = "guest";
+

    /**
     * 인증 요청
@@ -43,7 +49,7 @@ public class AuthFacadeImpl implements AuthFacade {
        }

        try {
-            String generatedAuthNumber = authNumberService.sendRequestAuthNumber(recipientKey, msgType);
+            String generatedAuthNumber = authNumberService.sendRequestAuthNumber(recipientKey, msgType, GUEST_USER_NAME);
            response.setValid(true);
            response.setMessage("인증번호를 발송하였습니다.");
            // 테스트 환경(PTL_PROPERTY auth.test-notice.enabled=true, prod 제외)에서만 인증번호를 응답에 노출
@@ -10,7 +10,7 @@ import com.eactive.apim.portal.common.exception.UserNotFoundException;
 import com.eactive.apim.portal.common.user.PortalAuthenticatedUser;
 import com.eactive.apim.portal.common.util.EncryptionUtil;
 import com.eactive.apim.portal.common.util.SecurityUtil;
-import com.eactive.apim.portal.config.PortalProperties;
+import com.eactive.apim.portal.djb.menu.PortalRolesProperties;
 import com.eactive.apim.portal.portaluser.entity.PortalUser;
 import com.eactive.apim.portal.portaluser.entity.PortalUserEnums;
 import com.eactive.apim.portal.portaluser.entity.PortalUserEnums.RoleCode;
@@ -50,7 +50,7 @@ public class PortalUserAuthService implements UserDetailsService {

    private final PortalUserRepository portalUserRepository;
    private final PortalUserMapper portalUserMapper;
-    private final PortalProperties portalProperties;
+    private final PortalRolesProperties portalRolesProperties;
    private final PasswordEncoder passwordEncoder;
    private final MessageHandlerService messageHandlerService;
    private final MessageRequestRepository messageRequestRepository;
@@ -76,7 +76,7 @@ public class PortalUserAuthService implements UserDetailsService {
     */
    public PortalAuthenticatedUser buildAuthenticatedUser(PortalUser portalUser) {
        RoleCode userRole = portalUser.getRoleCode() == null ? RoleCode.ROLE_USER : portalUser.getRoleCode();
-        List<String> roles = portalProperties.getPortalSecurity().get(userRole);
+        List<String> roles = portalRolesProperties.getAuthorities(userRole);
        PortalAuthenticatedUser authenticatedUser = portalUserMapper.portalUserToAuthenticatedUser(portalUser);

        authenticatedUser.getAuthorities().add(new SimpleGrantedAuthority(userRole.name()));
@@ -12,6 +12,8 @@ import com.eactive.apim.portal.config.PortalProperties;
 import com.eactive.apim.portal.apps.auth.AuthNoticeProperties;
 import com.eactive.apim.portal.apps.session.service.UserSessionService;
 import com.eactive.apim.portal.common.security.ClientGuardService;
+import com.eactive.apim.portal.djb.footer.RelatedSite;
+import com.eactive.apim.portal.djb.footer.RelatedSiteService;
 import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;

@ControllerAdvice
@@ -35,6 +37,9 @@ public class GlobalControllerAdvice {
    @Autowired
    private AuthNoticeProperties authNoticeProperties;

+    @Autowired
+    private RelatedSiteService relatedSiteService;
+
    @Autowired
    private Environment environment;

@@ -111,4 +116,21 @@ public class GlobalControllerAdvice {
        return portalPropertyService.getOrCreateProperty(
            "Portal", "customer.center.contact", "1588-3388", "고객센터 연락처");
    }
+
+    /**
+     * 푸터 관련 사이트 셀렉트 라벨. PortalProperty(Portal/footer.related-sites.label)에서 조회.
+     */
+    @ModelAttribute("relatedSitesLabel")
+    public String relatedSitesLabel() {
+        return relatedSiteService.getLabel();
+    }
+
+    /**
+     * 푸터 관련 사이트 목록. PortalProperty(Portal/footer.related-sites)의 '이름=URL' 줄 목록을 파싱한 결과.
+     * 비어 있으면 푸터에서 셀렉트 자체를 렌더하지 않는다.
+     */
+    @ModelAttribute("relatedSites")
+    public List<RelatedSite> relatedSites() {
+        return relatedSiteService.getSites();
+    }
 }
@@ -2,6 +2,7 @@ package com.eactive.apim.portal.common.migration;

 import com.eactive.apim.portal.common.util.StringMaskingUtil;
 import com.eactive.apim.portal.jpa.PersonalDataEncryptConverter;
+import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Qualifier;
 import org.springframework.http.HttpStatus;
@@ -20,6 +21,8 @@ import java.util.Arrays;
 import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
+import java.util.stream.Collectors;

 /**
 * [임시] 레거시 평문 데이터를 {@link PersonalDataEncryptConverter} 규칙으로 일괄 정규화(암호화)하는 운영 도구.
@@ -29,15 +32,19 @@ import java.util.Map;
 * 쓰기에서 무조건 인코딩하므로, {@code convertToDatabaseColumn(convertToEntityAttribute(x))}는
 * 평문→인코딩, 인코딩→동일값(멱등)으로 정규화된다. 이 값이 기존과 다를 때만 UPDATE 한다.</p>
 *
- * <p>보안: 오직 127.0.0.1(localhost)에서 직접 호출한 요청만 허용한다. 기본은 dry-run(미변경)이며,
- * 실제 실행은 {@code dryRun=false}를 명시해야 한다. 작업 완료 후 이 클래스는 제거한다.</p>
+ * <p>보안: PTL_PROPERTY {@code Portal / migration.internal.allow-ips} 허용 IP 목록(콤마 구분,
+ * 기본 loopback)에 포함된 IP 의 직접 호출만 허용한다 ({@code MenuInternalController} 모델).
+ * 운영 서버는 bind IP 가 NIC IP 라 loopback 호출이 불가하므로, 실행 전 property 에 호출자 IP 를
+ * 추가하고 작업 완료 후 원복한다. 프록시 경유(X-Forwarded-For 존재) 요청은 거부한다.
+ * 기본은 dry-run(미변경)이며, 실제 실행은 {@code dryRun=false}를 명시해야 한다.
+ * 작업 완료 후 이 클래스는 제거한다.</p>
 *
 * <pre>
 *   # 미리보기(변경 안 함)
 *   curl -X POST 'http://127.0.0.1:39130/internal/migration/encrypt-legacy'
 *   # 실제 실행 (PII 컬럼)
 *   curl -X POST 'http://127.0.0.1:39130/internal/migration/encrypt-legacy?dryRun=false'
- *   # audit 컬럼(created_by/last_modified_by, 15개 테이블)까지 포함
+ *   # audit 컬럼(created_by/last_modified_by, 19개 테이블)까지 포함
 *   curl -X POST 'http://127.0.0.1:39130/internal/migration/encrypt-legacy?dryRun=false&includeAudit=true'
 * </pre>
 */
@@ -46,13 +53,14 @@ import java.util.Map;
@RequestMapping("/internal/migration")
 public class LegacyEncryptionMigrationController {

-    /** PII 직접 컬럼 (로그인/검색에 직접 영향) */
+    /** PII 직접 컬럼 (로그인/검색에 직접 영향). ofctelno 는 admin(UnifbwkManService)이 컨버터를 수동 호출해 암호화하는 컬럼 */
    private static final List<TargetTable> PII_TARGETS = Arrays.asList(
            new TargetTable("PTL_USER", Arrays.asList("login_id", "email_addr", "phone_number", "mobile_number")),
            new TargetTable("PTL_MESSAGE_REQUEST", Arrays.asList("email", "phone")),
-            new TargetTable("tseairm02", Arrays.asList("cphnno", "emad")),
+            new TargetTable("tseairm02", Arrays.asList("cphnno", "emad", "ofctelno")),
            new TargetTable("PTL_USER_LOG", Arrays.asList("login_id")),
-            new TargetTable("PTL_TWO_FACTOR_AUTH", Arrays.asList("recipient"))
+            new TargetTable("PTL_TWO_FACTOR_AUTH", Arrays.asList("recipient")),
+            new TargetTable("PTL_USER_INVITATION", Arrays.asList("INVITATION_MOBILE"))
    );

    /** Auditable(@MappedSuperclass) 상속 테이블의 감사 컬럼 (옵션) */
@@ -61,16 +69,24 @@ public class LegacyEncryptionMigrationController {
            "DJB_APISTATUS_INCIDENT", "DJB_APISTATUS_INCIDENT_TIMELINE", "DJB_APISTATUS_INCIDENT_API",
            "ptl_file", "PTL_MESSAGE_TEMPLATE", "ptl_notice", "ptl_terms",
            "ptl_user_privacy_policy_agreement", "ptl_approval_line",
-            "PTL_INQUIRY_COMMENT", "ptl_inquiry", "ptl_partnership_application"
+            "PTL_INQUIRY_COMMENT", "ptl_inquiry", "ptl_partnership_application",
+            "PTL_MENU_ITEM", "PTL_MENU_PLACEMENT", "PTL_ROLE", "PTL_ROLE_AUTHORITY"
    );
    private static final List<String> AUDIT_COLUMNS = Arrays.asList("created_by", "last_modified_by");

+    static final String PROP_GROUP = "Portal";
+    static final String PROP_ALLOW_IPS = "migration.internal.allow-ips";
+    static final String DEFAULT_ALLOW_IPS = "127.0.0.1,::1";
+
    private final JdbcTemplate jdbcTemplate;
+    private final PortalPropertyService portalPropertyService;
    private final PersonalDataEncryptConverter converter = new PersonalDataEncryptConverter();

-    public LegacyEncryptionMigrationController(@Qualifier("portalDataSource") DataSource emsDataSource) {
+    public LegacyEncryptionMigrationController(@Qualifier("portalDataSource") DataSource emsDataSource,
+                                               PortalPropertyService portalPropertyService) {
        // EMS(EMSAPP) 스키마 데이터소스. 컨버터 적용 테이블은 모두 EMS에 존재한다.
        this.jdbcTemplate = new JdbcTemplate(emsDataSource);
+        this.portalPropertyService = portalPropertyService;
    }

    @PostMapping("/encrypt-legacy")
@@ -78,7 +94,7 @@ public class LegacyEncryptionMigrationController {
    public Map<String, Object> encryptLegacy(HttpServletRequest request,
                                             @RequestParam(defaultValue = "true") boolean dryRun,
                                             @RequestParam(defaultValue = "false") boolean includeAudit) {
-        assertLocalOnly(request);
+        assertAllowedIp(request);
        assertNotBypass();

        List<TargetTable> targets = new ArrayList<>(PII_TARGETS);
@@ -90,24 +106,36 @@ public class LegacyEncryptionMigrationController {

        List<Map<String, Object>> results = new ArrayList<>();
        int totalChanged = 0;
+        int totalSkipped = 0;
        for (TargetTable target : targets) {
            for (String column : target.columns) {
                Map<String, Object> r = processColumn(target.table, column, dryRun);
                results.add(r);
                totalChanged += (int) r.get("changed");
+                totalSkipped += (int) r.get("skipped");
            }
        }

        Map<String, Object> response = new LinkedHashMap<>();
        response.put("mode", dryRun ? "dry-run (변경 없음)" : "executed");
+        response.put("damoMode", resolveDamoMode());
        response.put("includeAudit", includeAudit);
        response.put("totalChanged", totalChanged);
+        // 정규화 결과가 빈 값이라 UPDATE 를 생략한 건수. 0 이 아니면 원인 조사 후 진행할 것.
+        response.put("totalSkipped", totalSkipped);
        response.put("results", results);
-        log.info("[레거시 암호화 마이그레이션] mode={} includeAudit={} totalChanged={}",
-                dryRun ? "dry-run" : "executed", includeAudit, totalChanged);
+        log.info("[레거시 암호화 마이그레이션] mode={} includeAudit={} totalChanged={} totalSkipped={}",
+                dryRun ? "dry-run" : "executed", includeAudit, totalChanged, totalSkipped);
        return response;
    }

+    private String resolveDamoMode() {
+        if (converter.isBypassMode()) {
+            return "BYPASS";
+        }
+        return converter.isFakeMode() ? "FAKE" : "REAL";
+    }
+
    /**
     * 단일 (테이블, 컬럼)의 고유값을 정규화하고, 값이 바뀌는 경우에만 UPDATE.
     */
@@ -125,11 +153,13 @@ public class LegacyEncryptionMigrationController {
            log.warn("[마이그레이션] 조회 실패 table={} column={} : {}", table, column, e.toString());
            r.put("distinct", 0);
            r.put("changed", 0);
+            r.put("skipped", 0);
            r.put("error", e.getMessage());
            return r;
        }

        int changed = 0;
+        int skipped = 0;
        for (String value : values) {
            String normalized;
            try {
@@ -139,6 +169,13 @@ public class LegacyEncryptionMigrationController {
                log.warn("[마이그레이션] 정규화 실패 table={} column={} : {}", table, column, e.toString());
                continue;
            }
+            if ((normalized == null || normalized.isEmpty()) && !value.isEmpty()) {
+                // 방어: 원본이 비어있지 않은데 정규화 결과가 빈 값 → 절대 UPDATE 하지 않음 (데이터 소실 방지)
+                skipped++;
+                log.warn("[마이그레이션] 정규화 결과가 빈 값 — UPDATE 생략 table={} column={} valueLen={}",
+                        table, column, value.length());
+                continue;
+            }
            if (normalized != null && !normalized.equals(value)) {
                if (!dryRun) {
                    jdbcTemplate.update(
@@ -151,6 +188,7 @@ public class LegacyEncryptionMigrationController {

        r.put("distinct", values.size());
        r.put("changed", changed);
+        r.put("skipped", skipped);
        return r;
    }

@@ -169,21 +207,45 @@ public class LegacyEncryptionMigrationController {
    }

    /**
-     * 127.0.0.1(localhost) 직접 호출만 허용. 프록시 경유(X-Forwarded-For 존재) 요청은 거부한다.
+     * PTL_PROPERTY({@code Portal / migration.internal.allow-ips}) 허용 IP 목록 검사.
+     * 프록시 경유(X-Forwarded-For 존재) 요청은 IP 신뢰 불가로 거부한다. ({@code MenuInternalController} 모델)
+     * 운영 서버는 bind IP 가 NIC IP 라 loopback 기본값으로는 호출 불가 — 실행 전 property 에
+     * 호출자 IP 를 추가하고 완료 후 원복한다.
     */
-    private void assertLocalOnly(HttpServletRequest request) {
-        String remote = request.getRemoteAddr();
-        boolean localAddr = "127.0.0.1".equals(remote)
-                || "0:0:0:0:0:0:0:1".equals(remote)
-                || "::1".equals(remote);
+    private void assertAllowedIp(HttpServletRequest request) {
+        String remote = canonicalize(request.getRemoteAddr());
        boolean viaProxy = request.getHeader("X-Forwarded-For") != null;
-        if (!localAddr || viaProxy) {
-            log.warn("[마이그레이션] 비로컬 접근 차단 remoteAddr={} xff={}",
-                    StringMaskingUtil.maskIpAddress(remote), StringMaskingUtil.maskIpAddress(request.getHeader("X-Forwarded-For")));
-            throw new ResponseStatusException(HttpStatus.FORBIDDEN, "localhost(127.0.0.1) 직접 호출만 허용됩니다.");
+
+        Set<String> allowed = Arrays.stream(resolveAllowIps().split(","))
+                .map(String::trim)
+                .filter(ip -> !ip.isEmpty())
+                .map(LegacyEncryptionMigrationController::canonicalize)
+                .collect(Collectors.toSet());
+
+        if (viaProxy || !allowed.contains(remote)) {
+            log.warn("[마이그레이션] 비허용 접근 차단 remoteAddr={} viaProxy={} xff={}",
+                    StringMaskingUtil.maskIpAddress(remote), viaProxy,
+                    StringMaskingUtil.maskIpAddress(request.getHeader("X-Forwarded-For")));
+            throw new ResponseStatusException(HttpStatus.FORBIDDEN,
+                    "허용되지 않은 접근입니다. (PTL_PROPERTY " + PROP_GROUP + "/" + PROP_ALLOW_IPS + " 확인)");
        }
    }

+    private String resolveAllowIps() {
+        try {
+            return portalPropertyService.getOrCreateProperty(PROP_GROUP, PROP_ALLOW_IPS,
+                    DEFAULT_ALLOW_IPS, "레거시 암호화 마이그레이션 내부 API 허용 IP 목록(콤마 구분)");
+        } catch (Exception e) {
+            log.warn("[마이그레이션] 허용 IP 목록 조회 실패 - 기본값({}) 사용", DEFAULT_ALLOW_IPS, e);
+            return DEFAULT_ALLOW_IPS;
+        }
+    }
+
+    /** IPv6 loopback 표기 통일 */
+    private static String canonicalize(String ip) {
+        return "0:0:0:0:0:0:0:1".equals(ip) ? "::1" : ip;
+    }
+
    private static final class TargetTable {
        final String table;
        final List<String> columns;
@@ -109,6 +109,7 @@ public class PortalConfigSecurity {
                    .csrfTokenRepository(csrfTokenRepository)
                    .ignoringRequestMatchers(new AntPathRequestMatcher("/_proxy/**/*"))
                    .ignoringRequestMatchers(new AntPathRequestMatcher("/internal/migration/**"))
+                    .ignoringRequestMatchers(new AntPathRequestMatcher("/internal/menu/**"))
                )
                // 로그인 페이지에 오래 머물러 세션(=CSRF 토큰 저장소)이 타임아웃되면
                // 로그인 제출 시 CsrfFilter가 AnonymousAuthenticationFilter보다 먼저 예외를 던져
@@ -44,6 +44,7 @@ public class PortalConfigWebDispatcherServlet implements WebMvcConfigurer {
    private final Environment environment;
    private final com.eactive.apim.portal.apps.auth.twofactor.TwoFactorService twoFactorService;
    private final com.eactive.apim.portal.apps.auth.twofactor.TwoFactorProperties twoFactorProperties;
+    private final com.eactive.apim.portal.djb.menu.MenuService menuService;

    // 정적자원 해시 버전닝 토글(application.yml: app.resource-versioning.enabled).
    // prod 는 이 값을 무시하고 항상 ON 으로 동작한다(isResourceVersioningEnabled 참고).
@@ -58,10 +59,12 @@ public class PortalConfigWebDispatcherServlet implements WebMvcConfigurer {

    public PortalConfigWebDispatcherServlet(Environment environment,
        com.eactive.apim.portal.apps.auth.twofactor.TwoFactorService twoFactorService,
-        com.eactive.apim.portal.apps.auth.twofactor.TwoFactorProperties twoFactorProperties) {
+        com.eactive.apim.portal.apps.auth.twofactor.TwoFactorProperties twoFactorProperties,
+        com.eactive.apim.portal.djb.menu.MenuService menuService) {
        this.environment = environment;
        this.twoFactorService = twoFactorService;
        this.twoFactorProperties = twoFactorProperties;
+        this.menuService = menuService;
    }


@@ -131,6 +134,14 @@ public class PortalConfigWebDispatcherServlet implements WebMvcConfigurer {
            .addPathPatterns("/**")
            .excludePathPatterns(staticExcludes)
            .excludePathPatterns("/auth/2fa/**");
+
+        // 메뉴 접근 권한(ACCESS_ROLES) 가드. 메뉴 경로 정확 일치 시에만 검사하며
+        // 하위 경로는 기존 @Secured / PageRoute.role 안전망에 위임한다.
+        registry.addInterceptor(new com.eactive.apim.portal.djb.menu.MenuAccessInterceptor(menuService))
+            .addPathPatterns("/**")
+            .excludePathPatterns(staticExcludes)
+            .excludePathPatterns("/internal/**", "/auth/2fa/**",
+                "/login", "/actionLogin.do", "/actionLogout.do", "/error");
    }

    @Bean
@@ -1,13 +1,11 @@
 package com.eactive.apim.portal.config;

 import com.eactive.apim.portal.common.pagerouter.property.PageRoute;
-import com.eactive.apim.portal.portaluser.entity.PortalUserEnums.RoleCode;
 import lombok.Data;
 import org.springframework.boot.context.properties.ConfigurationProperties;
 import org.springframework.stereotype.Component;

 import java.util.List;
-import java.util.Map;

@Data
@Component
@@ -25,8 +23,6 @@ public class PortalProperties {

    private String authVirtualCode = "";

-    private Map<RoleCode, List<String>> portalSecurity;
-
    private FileProperties file = new FileProperties();

    /**
@@ -0,0 +1,22 @@
+package com.eactive.apim.portal.djb.footer;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.ToString;
+
+/**
+ * 푸터 "관련 사이트" 셀렉트에 노출되는 사이트 한 건.
+ *
+ * <p>{@link RelatedSiteService} 가 PortalProperty 문자열을 파싱해 만든다.</p>
+ */
+@Getter
+@ToString
+@AllArgsConstructor
+public class RelatedSite {
+
+    /** 셀렉트에 표시되는 이름 (예: 신한은행) */
+    private final String name;
+
+    /** 이동 대상 URL (http/https 절대주소 또는 `/` 로 시작하는 사이트 상대주소) */
+    private final String url;
+}
@@ -0,0 +1,131 @@
+package com.eactive.apim.portal.djb.footer;
+
+import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * 푸터 "관련 사이트" 셀렉트의 라벨과 목록을 DB(PortalProperty)에서 조회한다.
+ *
+ * <p>group 은 기존 {@code Portal} 을 재사용하여 {@link PortalPropertyService#getOrCreateProperty}
+ * 의 자동 생성(self-seed)이 동작하도록 한다.</p>
+ *
+ * <ul>
+ *   <li>{@code footer.related-sites.label} - 셀렉트 첫 항목(플레이스홀더) 문구</li>
+ *   <li>{@code footer.related-sites} - 사이트 목록. 한 줄에 하나씩 {@code 이름=URL}</li>
+ * </ul>
+ *
+ * <h3>목록 표기 규칙</h3>
+ * <pre>
+ * # 주석 (# 으로 시작하는 줄은 무시)
+ * 신한은행=http://www.shinhan.com
+ * 제주은행 = https://www.jejubank.co.kr   ← = 앞뒤 공백 허용
+ * </pre>
+ * <ul>
+ *   <li>빈 줄 · {@code #} 로 시작하는 줄은 건너뛴다.</li>
+ *   <li>줄 순서가 곧 화면 노출 순서다.</li>
+ *   <li>URL 에 {@code =} 가 들어가도 <b>첫 번째</b> {@code =} 만 구분자로 쓰므로 안전하다.</li>
+ *   <li>{@code =} 가 없거나 이름/URL 이 비었거나 허용되지 않은 스킴이면 그 줄만 버리고 WARN 로그를
+ *       남긴다. (한 줄이 잘못돼도 나머지 사이트는 정상 노출)</li>
+ * </ul>
+ *
+ * <p>허용 스킴을 {@code http/https} 와 사이트 상대경로로 제한하는 이유는, 이 값이 관리자 화면에서
+ * 편집되어 그대로 앵커/스크립트 이동 대상이 되기 때문이다({@code javascript:} 등 차단).</p>
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class RelatedSiteService {
+
+    private static final String GROUP = "Portal";
+
+    static final String NAME_LABEL = "footer.related-sites.label";
+    static final String NAME_SITES = "footer.related-sites";
+
+    static final String DESC_LABEL = "푸터 관련 사이트 셀렉트 라벨(첫 항목 문구)";
+    static final String DESC_SITES = "푸터 관련 사이트 목록. 한 줄에 하나씩 '이름=URL' (빈 줄·# 주석 무시)";
+
+    static final String DEFAULT_LABEL = "DJBank 관련 사이트";
+
+    /** 기본값: 신한금융그룹 Family site (shinhangroup.com 하단 목록 기준) */
+    static final String DEFAULT_SITES = String.join("\n",
+            "신한은행=http://www.shinhan.com",
+            "신한카드=http://www.shinhancard.com",
+            "신한투자증권=http://www.shinhansec.com",
+            "신한라이프=http://www.shinhanlife.co.kr",
+            "신한캐피탈=http://www.shcap.co.kr",
+            "신한자산운용=https://www.shinhanfund.com",
+            "제주은행=https://www.jejubank.co.kr",
+            "신한저축은행=http://www.shinhansavings.co.kr",
+            "신한자산신탁=http://www.shinhantrust.kr",
+            "신한DS=http://www.shinhansys.co.kr",
+            "신한펀드파트너스=https://www.shinhanfundpartners.com",
+            "신한리츠운용=http://shinhanrem.com",
+            "신한벤처투자=http://www.shinhanvc.com",
+            "신한EZ손해보험=http://www.shinhanez.co.kr",
+            "신한장학재단=http://www.shsf.or.kr",
+            "신한금융희망재단=http://www.shinhanfoundation.or.kr");
+
+    private final PortalPropertyService portalPropertyService;
+
+    /** 셀렉트 첫 항목에 노출할 라벨 */
+    @Transactional
+    public String getLabel() {
+        String label = portalPropertyService.getOrCreateProperty(GROUP, NAME_LABEL, DEFAULT_LABEL, DESC_LABEL);
+        return (label == null || label.trim().isEmpty()) ? DEFAULT_LABEL : label.trim();
+    }
+
+    /** 셀렉트에 노출할 사이트 목록. 파싱 결과가 없으면 빈 리스트(푸터에서 셀렉트 미노출) */
+    @Transactional
+    public List<RelatedSite> getSites() {
+        return parse(portalPropertyService.getOrCreateProperty(GROUP, NAME_SITES, DEFAULT_SITES, DESC_SITES));
+    }
+
+    /**
+     * {@code 이름=URL} 줄 목록을 파싱한다. 잘못된 줄은 건너뛴다.
+     */
+    static List<RelatedSite> parse(String raw) {
+        if (raw == null || raw.trim().isEmpty()) {
+            return Collections.emptyList();
+        }
+
+        List<RelatedSite> sites = new ArrayList<>();
+        for (String rawLine : raw.split("\\r?\\n")) {
+            String line = rawLine.trim();
+            if (line.isEmpty() || line.startsWith("#")) {
+                continue;
+            }
+
+            int sep = line.indexOf('=');
+            if (sep <= 0) {
+                log.warn("관련 사이트 설정 형식 오류(= 구분자 없음) - 해당 줄 무시: {}", line);
+                continue;
+            }
+
+            String name = line.substring(0, sep).trim();
+            String url = line.substring(sep + 1).trim();
+            if (name.isEmpty() || url.isEmpty()) {
+                log.warn("관련 사이트 설정 형식 오류(이름 또는 URL 없음) - 해당 줄 무시: {}", line);
+                continue;
+            }
+            if (!isAllowedUrl(url)) {
+                log.warn("관련 사이트 설정 URL 스킴 불허(http/https 또는 / 로 시작해야 함) - 해당 줄 무시: {}", line);
+                continue;
+            }
+
+            sites.add(new RelatedSite(name, url));
+        }
+        return sites;
+    }
+
+    private static boolean isAllowedUrl(String url) {
+        String lower = url.toLowerCase();
+        return lower.startsWith("http://") || lower.startsWith("https://") || url.startsWith("/");
+    }
+}
@@ -0,0 +1,70 @@
+package com.eactive.apim.portal.djb.menu;
+
+import com.eactive.apim.portal.menu.entity.PortalMenuItem;
+import com.eactive.apim.portal.common.util.SecurityUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.servlet.HandlerInterceptor;
+
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
+import java.util.List;
+
+/**
+ * 메뉴 접근 권한(ACCESS_ROLES) 서버측 집행.
+ *
+ * <p>요청 경로가 접근 권한이 설정된 메뉴 경로와 정확히 일치할 때만 검사한다
+ * (하위 경로는 기존 안전망 @Secured / PageRoute.role 에 위임 — 사용자 결정).
+ * 미충족 시 익명은 로그인으로, 인증 사용자는 홈으로 리다이렉트한다.
+ * 메뉴에 등록되지 않은 경로는 통과시킨다.
+ */
+@Slf4j
+@RequiredArgsConstructor
+public class MenuAccessInterceptor implements HandlerInterceptor {
+
+    private final MenuService menuService;
+
+    @Override
+    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
+        throws Exception {
+        String path = currentPath(request);
+        List<String> requiredRoles = menuService.getSnapshot().getAccessRolesByPath().get(path);
+        if (requiredRoles == null || requiredRoles.isEmpty()) {
+            return true;
+        }
+        if (isAllowed(requiredRoles)) {
+            return true;
+        }
+
+        if (!SecurityUtil.isAuthenticated()) {
+            response.sendRedirect(request.getContextPath() + "/login");
+        } else {
+            log.info("메뉴 접근 권한 미충족 - path: {}, 필요 권한: {}, 사용자: {}",
+                path, requiredRoles, SecurityUtil.getCurrentLoginId());
+            response.sendRedirect(request.getContextPath() + "/");
+        }
+        return false;
+    }
+
+    private boolean isAllowed(List<String> requiredRoles) {
+        for (String role : requiredRoles) {
+            if (PortalMenuItem.ROLE_AUTHENTICATED.equals(role)) {
+                if (SecurityUtil.isAuthenticated()) {
+                    return true;
+                }
+            } else if (SecurityUtil.hasRole(role)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private String currentPath(HttpServletRequest request) {
+        String uri = request.getRequestURI();
+        String contextPath = request.getContextPath();
+        if (contextPath != null && !contextPath.isEmpty() && uri.startsWith(contextPath)) {
+            uri = uri.substring(contextPath.length());
+        }
+        return uri;
+    }
+}
@@ -0,0 +1,91 @@
+package com.eactive.apim.portal.djb.menu;
+
+import com.eactive.apim.portal.common.util.IpAddressMatcher;
+import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import javax.servlet.http.HttpServletRequest;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+/**
+ * 메뉴 캐시 내부 API — eapim-admin 의 reload 명령 수신용.
+ *
+ * <p>가드: PTL_PROPERTY {@code Portal / menu.internal.allow-ips} 허용 IP 목록
+ * (기본 loopback) + X-Forwarded-For 동반 요청 거부
+ * ({@code LegacyEncryptionMigrationController.assertLocalOnly} 모델).
+ * 허용 목록은 {@link IpAddressMatcher} 규칙을 따라 정확 일치 외에
+ * IPv4 CIDR({@code 172.30.1.0/24}) 과 옥텟 와일드카드({@code 172.30.*.*}) 를 지원한다.
+ * CSRF 는 PortalConfigSecurity 에서 {@code /internal/menu/**} 예외 처리.</p>
+ *
+ * <pre>curl -X POST http://127.0.0.1:39130/internal/menu/reload</pre>
+ */
+@Slf4j
+@RestController
+@RequestMapping("/internal/menu")
+@RequiredArgsConstructor
+public class MenuInternalController {
+
+    static final String PROP_GROUP = "Portal";
+    static final String PROP_ALLOW_IPS = "menu.internal.allow-ips";
+    static final String DEFAULT_ALLOW_IPS = "127.0.0.1,::1";
+    static final String PROP_ALLOW_IPS_DESCRIPTION =
+        "메뉴 내부 API(리로드) 허용 IP 목록. 콤마(,)/세미콜론(;)/줄바꿈 구분, "
+            + "정확일치·IPv4 CIDR(172.30.1.0/24)·와일드카드(172.30.*.*) 지원";
+
+    private final MenuService menuService;
+    private final PortalPropertyService portalPropertyService;
+
+    @PostMapping("/reload")
+    public ResponseEntity<Map<String, Object>> reload(HttpServletRequest request) {
+        if (!isAllowed(request)) {
+            Map<String, Object> denied = new LinkedHashMap<>();
+            denied.put("result", "DENIED");
+            denied.put("message", "허용되지 않은 접근입니다. (menu.internal.allow-ips 확인)");
+            return ResponseEntity.status(HttpStatus.FORBIDDEN).body(denied);
+        }
+
+        MenuService.MenuSnapshot snapshot = menuService.reload();
+        log.info("메뉴 캐시 리로드 명령 수신 - from: {}", request.getRemoteAddr());
+
+        Map<String, Object> body = new LinkedHashMap<>();
+        body.put("result", "OK");
+        body.put("itemCount", snapshot.getItemCount());
+        body.put("reloadedAt", LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
+        return ResponseEntity.ok(body);
+    }
+
+    /**
+     * 허용 IP 검사. 프록시 경유(X-Forwarded-For 존재) 요청은 IP 신뢰 불가로 거부한다.
+     * (embedded Tomcat 은 forward-headers-strategy: native 로 XFF 가 remoteAddr 에 반영될 수 있으나
+     * 그 경우에도 allowlist 검사로 차단된다. WebLogic WAR 배포에서는 원 소켓 IP 로 검사된다.)
+     */
+    private boolean isAllowed(HttpServletRequest request) {
+        String remote = IpAddressMatcher.canonicalize(request.getRemoteAddr());
+        boolean viaProxy = request.getHeader("X-Forwarded-For") != null;
+
+        if (viaProxy || !IpAddressMatcher.matches(resolveAllowIps(), remote)) {
+            log.warn("메뉴 내부 API 차단 - remote: {}, viaProxy: {}", remote, viaProxy);
+            return false;
+        }
+        return true;
+    }
+
+    private String resolveAllowIps() {
+        try {
+            return portalPropertyService.getOrCreateProperty(PROP_GROUP, PROP_ALLOW_IPS,
+                DEFAULT_ALLOW_IPS, PROP_ALLOW_IPS_DESCRIPTION);
+        } catch (Exception e) {
+            log.warn("허용 IP 목록 조회 실패 - 기본값({}) 사용", DEFAULT_ALLOW_IPS, e);
+            return DEFAULT_ALLOW_IPS;
+        }
+    }
+}
@@ -0,0 +1,94 @@
+package com.eactive.apim.portal.djb.menu;
+
+import com.eactive.apim.portal.menu.entity.PortalMenuItem;
+import com.eactive.apim.portal.common.util.SecurityUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.ControllerAdvice;
+import org.springframework.web.bind.annotation.ModelAttribute;
+
+import javax.servlet.http.HttpServletRequest;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 모든 뷰 요청에 role 필터가 적용된 {@code menuView} 를 주입한다
+ * (breadcrumb 의 GlobalControllerAdvice 와 동일한 방식).
+ *
+ * <p>노출 판정: EXPOSE_ROLES 비어있음(전체) ∥ AUTHENTICATED(로그인) ∥
+ * 역할 any-of. 경로 없는 그룹은 노출 자식이 하나도 없으면 제외한다.
+ */
+@Slf4j
+@ControllerAdvice
+@RequiredArgsConstructor
+public class MenuModelAdvice {
+
+    private final MenuService menuService;
+
+    @ModelAttribute("menuView")
+    public MenuView menuView(HttpServletRequest request) {
+        try {
+            MenuService.MenuSnapshot snapshot = menuService.getSnapshot();
+            boolean authenticated = SecurityUtil.isAuthenticated();
+
+            List<MenuNode> gnb = new ArrayList<>();
+            MenuNode mypage = null;
+            for (MenuNode root : snapshot.getRoots()) {
+                MenuNode filtered = filter(root, authenticated);
+                if (filtered == null) {
+                    continue;
+                }
+                if (PortalMenuItem.SECTION_MYPAGE.equals(filtered.getSection())) {
+                    if (mypage == null) {
+                        mypage = filtered;
+                    }
+                } else {
+                    gnb.add(filtered);
+                }
+            }
+            return new MenuView(gnb, mypage, request.getRequestURI());
+        } catch (Exception e) {
+            // 메뉴 조회 실패가 화면 전체를 막지 않도록 빈 메뉴로 폴백
+            log.error("메뉴 뷰 구성 실패 - 빈 메뉴로 렌더링합니다.", e);
+            return MenuView.empty();
+        }
+    }
+
+    private MenuNode filter(MenuNode node, boolean authenticated) {
+        if (!isExposed(node, authenticated)) {
+            return null;
+        }
+        MenuNode copy = node.copyWithoutChildren();
+        List<MenuNode> children = new ArrayList<>();
+        for (MenuNode child : node.getChildren()) {
+            MenuNode filteredChild = filter(child, authenticated);
+            if (filteredChild != null) {
+                children.add(filteredChild);
+            }
+        }
+        copy.setChildren(children);
+
+        // 경로 없는 그룹은 노출할 자식이 없으면 통째로 제외
+        if (copy.isGroup() && !copy.hasPath() && children.isEmpty()) {
+            return null;
+        }
+        return copy;
+    }
+
+    private boolean isExposed(MenuNode node, boolean authenticated) {
+        List<String> exposeRoles = node.getExposeRoles();
+        if (exposeRoles.isEmpty()) {
+            return true;
+        }
+        for (String role : exposeRoles) {
+            if (PortalMenuItem.ROLE_AUTHENTICATED.equals(role)) {
+                if (authenticated) {
+                    return true;
+                }
+            } else if (SecurityUtil.hasRole(role)) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
@@ -0,0 +1,46 @@
+package com.eactive.apim.portal.djb.menu;
+
+import lombok.Data;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 렌더용 메뉴 노드. {@link MenuService} 스냅샷 트리와
+ * {@link MenuModelAdvice} 의 요청별 필터 사본 양쪽에 사용한다.
+ */
+@Data
+public class MenuNode {
+
+    private String menuId;
+    private String name;
+    /** 이동 경로 (null = 클릭 없는 그룹) */
+    private String path;
+    private boolean group;
+    /** GNB | MYPAGE */
+    private String section;
+    private String icon;
+    private boolean newWindow;
+    private List<String> exposeRoles = new ArrayList<>();
+    private List<String> accessRoles = new ArrayList<>();
+    private List<MenuNode> children = new ArrayList<>();
+
+    /** 필터 사본 생성 (children 제외 필드 복사) */
+    public MenuNode copyWithoutChildren() {
+        MenuNode copy = new MenuNode();
+        copy.menuId = menuId;
+        copy.name = name;
+        copy.path = path;
+        copy.group = group;
+        copy.section = section;
+        copy.icon = icon;
+        copy.newWindow = newWindow;
+        copy.exposeRoles = exposeRoles;
+        copy.accessRoles = accessRoles;
+        return copy;
+    }
+
+    public boolean hasPath() {
+        return path != null && !path.isEmpty();
+    }
+}
@@ -0,0 +1,360 @@
+package com.eactive.apim.portal.djb.menu;
+
+import com.eactive.apim.portal.menu.entity.PortalMenuItem;
+import com.eactive.apim.portal.menu.entity.PortalMenuPlacement;
+import com.eactive.apim.portal.menu.entity.PortalRole;
+import com.eactive.apim.portal.menu.entity.PortalRoleAuthority;
+import com.eactive.apim.portal.menu.entity.PortalRoleAuthorityId;
+import com.eactive.apim.portal.menu.repository.PortalMenuItemRepository;
+import com.eactive.apim.portal.menu.repository.PortalMenuPlacementRepository;
+import com.eactive.apim.portal.menu.repository.PortalRoleAuthorityRepository;
+import com.eactive.apim.portal.menu.repository.PortalRoleRepository;
+import com.eactive.apim.portal.menu.service.PortalMenuDataService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.boot.context.event.ApplicationReadyEvent;
+import org.springframework.context.ApplicationListener;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.function.BiConsumer;
+import java.util.function.Function;
+import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+
+/**
+ * 부팅 시 menu.yml / roles.yml → DB 적재.
+ *
+ * <ul>
+ *   <li>역할: PTL_ROLE upsert + PTL_ROLE_AUTHORITY 재구축 (roles.yml 미러)</li>
+ *   <li>메뉴 항목: id 기준 upsert — yml 기본값이 바뀌면 DFLT_* 를 갱신하고,
+ *       관리자가 수정하지 않은(현재값==구 기본값) 필드만 새 기본값을 따라간다</li>
+ *   <li>배치: PTL_MENU_PLACEMENT 가 비어있을 때만 DFLT_* 로 최초 시딩</li>
+ *   <li>yml 에서 사라진 PORTAL 항목은 경고 로그만 남기고 삭제하지 않는다</li>
+ * </ul>
+ *
+ * 부팅 컨텍스트에는 인증 주체가 없어 감사(@CreatedBy)가 비므로,
+ * 신규 행은 {@code createdBy=SYSTEM} 을 명시 세팅한다
+ * (AuditingHandler 는 auditor 부재 시 기존 값을 보존).
+ */
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class MenuSeeder implements ApplicationListener<ApplicationReadyEvent> {
+
+    static final String SYSTEM_AUDITOR = "SYSTEM";
+    private static final Pattern MENU_ID_PATTERN = Pattern.compile("^[a-z0-9-]+$");
+
+    private final PortalMenuYmlProperties menuYmlProperties;
+    private final PortalRolesProperties rolesProperties;
+    private final PortalMenuItemRepository menuItemRepository;
+    private final PortalMenuPlacementRepository menuPlacementRepository;
+    private final PortalRoleRepository roleRepository;
+    private final PortalRoleAuthorityRepository roleAuthorityRepository;
+    private final PortalMenuDataService menuDataService;
+    private final MenuService menuService;
+
+    @Override
+    @Transactional
+    public void onApplicationEvent(ApplicationReadyEvent event) {
+        try {
+            seedRoles();
+            seedMenuItems();
+            seedPlacementsIfEmpty();
+            menuService.reload();
+        } catch (Exception e) {
+            // 시딩 실패가 기동 자체를 막지 않도록 로그만 남긴다 (메뉴는 기존 DB 값으로 동작)
+            log.error("메뉴/역할 시딩 실패 - 기존 DB 데이터로 동작합니다.", e);
+        }
+    }
+
+    // ─────────────── 역할 ───────────────
+
+    private void seedRoles() {
+        int sortOrder = 10;
+        int upserted = 0;
+        Set<String> definedCodes = new HashSet<>();
+
+        for (PortalRolesProperties.RoleDef roleDef : rolesProperties.getRoles()) {
+            upserted += upsertRole(roleDef.getCode(), roleDef.getName(), PortalRole.TYPE_BASE, sortOrder) ? 1 : 0;
+            definedCodes.add(roleDef.getCode());
+            sortOrder += 10;
+        }
+        for (Map.Entry<String, String> entry : rolesProperties.getAuthorityNames().entrySet()) {
+            if (definedCodes.contains(entry.getKey())) {
+                continue;
+            }
+            upserted += upsertRole(entry.getKey(), entry.getValue(), PortalRole.TYPE_AUTHORITY, sortOrder) ? 1 : 0;
+            sortOrder += 10;
+        }
+
+        // 역할→권한 매핑은 순수 미러 — 통째로 재구축
+        roleAuthorityRepository.deleteAllInBatch();
+        roleAuthorityRepository.flush();
+        List<PortalRoleAuthority> mappings = rolesProperties.getRoles().stream()
+            .flatMap(roleDef -> roleDef.getAuthorities().stream()
+                .map(authority -> {
+                    PortalRoleAuthority mapping = new PortalRoleAuthority();
+                    mapping.setId(new PortalRoleAuthorityId(roleDef.getCode(), authority));
+                    mapping.setCreatedBy(SYSTEM_AUDITOR);
+                    return mapping;
+                }))
+            .collect(Collectors.toList());
+        roleAuthorityRepository.saveAll(mappings);
+
+        log.info("역할 시딩 완료 - PTL_ROLE upsert {}건, PTL_ROLE_AUTHORITY {}건 재구축", upserted, mappings.size());
+    }
+
+    private boolean upsertRole(String code, String name, String type, int sortOrder) {
+        PortalRole role = roleRepository.findById(code).orElse(null);
+        if (role == null) {
+            role = new PortalRole();
+            role.setRoleCode(code);
+            role.setCreatedBy(SYSTEM_AUDITOR);
+        } else if (Objects.equals(role.getRoleName(), name)
+            && Objects.equals(role.getRoleType(), type)
+            && Objects.equals(role.getSortOrder(), sortOrder)) {
+            return false;
+        }
+        role.setRoleName(name);
+        role.setRoleType(type);
+        role.setSortOrder(sortOrder);
+        roleRepository.save(role);
+        return true;
+    }
+
+    // ─────────────── 메뉴 항목 ───────────────
+
+    private void seedMenuItems() {
+        List<FlatMenuDef> flatDefs = flatten(menuYmlProperties.getItems());
+        validate(flatDefs);
+
+        int inserted = 0;
+        int updated = 0;
+        for (FlatMenuDef def : flatDefs) {
+            PortalMenuItem existing = menuItemRepository.findById(def.id).orElse(null);
+            if (existing == null) {
+                menuItemRepository.save(newItem(def));
+                inserted++;
+            } else if (updateItem(existing, def)) {
+                menuItemRepository.save(existing);
+                updated++;
+            }
+        }
+
+        // yml 에서 사라진 PORTAL 항목 경고 (자동 삭제 금지)
+        Set<String> ymlIds = flatDefs.stream().map(def -> def.id).collect(Collectors.toSet());
+        menuItemRepository.findAllBySourceType(PortalMenuItem.SOURCE_PORTAL).stream()
+            .map(PortalMenuItem::getMenuId)
+            .filter(id -> !ymlIds.contains(id))
+            .forEach(id -> log.warn("menu.yml 에 없는 기본 메뉴 항목이 DB에 남아 있습니다 (수동 정리 필요): {}", id));
+
+        log.info("메뉴 항목 시딩 완료 - 신규 {}건, 갱신 {}건, 유지 {}건",
+            inserted, updated, flatDefs.size() - inserted - updated);
+    }
+
+    private PortalMenuItem newItem(FlatMenuDef def) {
+        PortalMenuItem item = new PortalMenuItem();
+        item.setMenuId(def.id);
+        item.setSourceType(PortalMenuItem.SOURCE_PORTAL);
+        item.setCreatedBy(SYSTEM_AUDITOR);
+
+        item.setMenuName(def.name());
+        item.setMenuPath(def.path());
+        item.setExposeRoles(def.exposeCsv());
+        item.setAccessRoles(def.accessCsv());
+
+        applyStructure(item, def);
+        applyDefaults(item, def);
+        return item;
+    }
+
+    /**
+     * 기존 항목 upsert 갱신. 내용 필드는 "관리자 미수정(현재값==구 기본값) 시에만"
+     * 새 기본값을 따라가고, 구조 필드(group/section/icon/new-window)와 DFLT_* 는
+     * 항상 yml 값으로 맞춘다.
+     *
+     * @return 변경이 있었으면 true
+     */
+    private boolean updateItem(PortalMenuItem item, FlatMenuDef def) {
+        boolean[] changed = {false};
+
+        followDefault(item, changed, def.name(), PortalMenuItem::getDfltMenuName,
+            PortalMenuItem::getMenuName, PortalMenuItem::setMenuName, PortalMenuItem::setDfltMenuName);
+        followDefault(item, changed, def.path(), PortalMenuItem::getDfltMenuPath,
+            PortalMenuItem::getMenuPath, PortalMenuItem::setMenuPath, PortalMenuItem::setDfltMenuPath);
+        followDefault(item, changed, def.exposeCsv(), PortalMenuItem::getDfltExposeRoles,
+            PortalMenuItem::getExposeRoles, PortalMenuItem::setExposeRoles, PortalMenuItem::setDfltExposeRoles);
+        followDefault(item, changed, def.accessCsv(), PortalMenuItem::getDfltAccessRoles,
+            PortalMenuItem::getAccessRoles, PortalMenuItem::setAccessRoles, PortalMenuItem::setDfltAccessRoles);
+
+        String groupYn = def.source.isGroup() ? "Y" : "N";
+        String section = def.section();
+        String newWindowYn = def.source.isNewWindow() ? "Y" : "N";
+        if (!Objects.equals(item.getGroupYn(), groupYn)
+            || !Objects.equals(item.getMenuSection(), section)
+            || !Objects.equals(item.getIconClass(), def.source.getIcon())
+            || !Objects.equals(item.getNewWindowYn(), newWindowYn)) {
+            applyStructure(item, def);
+            changed[0] = true;
+        }
+
+        if (!Objects.equals(item.getDfltParentId(), def.parentId)
+            || !Objects.equals(item.getDfltSortOrder(), def.sortOrder)) {
+            item.setDfltParentId(def.parentId);
+            item.setDfltSortOrder(def.sortOrder);
+            changed[0] = true;
+        }
+        return changed[0];
+    }
+
+    /**
+     * 내용 필드 1개에 대한 기본값 추종 처리: yml 기본값이 바뀌었을 때
+     * 현재값이 구 기본값과 같으면(관리자 미수정) 현재값도 새 기본값으로 갱신한다.
+     */
+    private void followDefault(PortalMenuItem item, boolean[] changed, String newDefault,
+                               Function<PortalMenuItem, String> defaultGetter,
+                               Function<PortalMenuItem, String> currentGetter,
+                               BiConsumer<PortalMenuItem, String> currentSetter,
+                               BiConsumer<PortalMenuItem, String> defaultSetter) {
+        String oldDefault = defaultGetter.apply(item);
+        if (Objects.equals(oldDefault, newDefault)) {
+            return;
+        }
+        if (Objects.equals(currentGetter.apply(item), oldDefault)) {
+            currentSetter.accept(item, newDefault);
+        }
+        defaultSetter.accept(item, newDefault);
+        changed[0] = true;
+    }
+
+    private void applyStructure(PortalMenuItem item, FlatMenuDef def) {
+        item.setGroupYn(def.source.isGroup() ? "Y" : "N");
+        item.setMenuSection(def.section());
+        item.setIconClass(def.source.getIcon());
+        item.setNewWindowYn(def.source.isNewWindow() ? "Y" : "N");
+    }
+
+    private void applyDefaults(PortalMenuItem item, FlatMenuDef def) {
+        item.setDfltMenuName(def.name());
+        item.setDfltMenuPath(def.path());
+        item.setDfltExposeRoles(def.exposeCsv());
+        item.setDfltAccessRoles(def.accessCsv());
+        item.setDfltParentId(def.parentId);
+        item.setDfltSortOrder(def.sortOrder);
+        item.setDfltVisibleYn("Y");
+    }
+
+    // ─────────────── 배치 ───────────────
+
+    private void seedPlacementsIfEmpty() {
+        if (menuPlacementRepository.count() > 0) {
+            log.info("메뉴 배치 존재 - 최초 시딩 건너뜀 (관리자 배치 보존)");
+            return;
+        }
+        List<PortalMenuItem> portalItems =
+            menuItemRepository.findAllBySourceType(PortalMenuItem.SOURCE_PORTAL);
+        List<PortalMenuPlacement> placements = menuDataService.buildDefaultPlacements(portalItems);
+        placements.forEach(placement -> placement.setCreatedBy(SYSTEM_AUDITOR));
+        menuPlacementRepository.saveAll(placements);
+        log.info("메뉴 배치 최초 시딩 완료 - {}건", placements.size());
+    }
+
+    // ─────────────── 평탄화 / 검증 ───────────────
+
+    private List<FlatMenuDef> flatten(List<PortalMenuYmlProperties.MenuItemDef> roots) {
+        List<FlatMenuDef> result = new ArrayList<>();
+        int sortOrder = 10;
+        for (PortalMenuYmlProperties.MenuItemDef root : roots) {
+            result.add(new FlatMenuDef(root, null, sortOrder, null));
+            int childOrder = 10;
+            for (PortalMenuYmlProperties.MenuItemDef child : root.getChildren()) {
+                result.add(new FlatMenuDef(child, root.getId(), childOrder, root));
+                childOrder += 10;
+            }
+            sortOrder += 10;
+        }
+        return result;
+    }
+
+    private void validate(List<FlatMenuDef> defs) {
+        Set<String> seen = new HashSet<>();
+        for (FlatMenuDef def : defs) {
+            if (def.id == null || !MENU_ID_PATTERN.matcher(def.id).matches()) {
+                throw new IllegalStateException("menu.yml 항목 id 형식 오류(kebab-case 필수): " + def.id);
+            }
+            if (!seen.add(def.id)) {
+                throw new IllegalStateException("menu.yml 항목 id 중복: " + def.id);
+            }
+        }
+    }
+
+    /** yml 트리 항목의 평탄화 뷰 (부모/기본 정렬 포함) */
+    private static class FlatMenuDef {
+        final PortalMenuYmlProperties.MenuItemDef source;
+        final String parentId;
+        final Integer sortOrder;
+        final PortalMenuYmlProperties.MenuItemDef parent;
+        final String id;
+
+        FlatMenuDef(PortalMenuYmlProperties.MenuItemDef source, String parentId, Integer sortOrder,
+                    PortalMenuYmlProperties.MenuItemDef parent) {
+            this.source = source;
+            this.parentId = parentId;
+            this.sortOrder = sortOrder;
+            this.parent = parent;
+            this.id = source.getId();
+        }
+
+        String name() {
+            return source.getName();
+        }
+
+        String path() {
+            return trimToNull(source.getPath());
+        }
+
+        /** 자식은 섹션 미지정 시 부모 섹션 상속 */
+        String section() {
+            String own = trimToNull(source.getSection());
+            if (own != null) {
+                return own;
+            }
+            if (parent != null) {
+                String parentSection = trimToNull(parent.getSection());
+                if (parentSection != null) {
+                    return parentSection;
+                }
+            }
+            return PortalMenuItem.SECTION_GNB;
+        }
+
+        String exposeCsv() {
+            return toCsv(source.getExposeRoles());
+        }
+
+        String accessCsv() {
+            return toCsv(source.getAccessRoles());
+        }
+
+        private static String toCsv(List<String> roles) {
+            if (roles == null || roles.isEmpty()) {
+                return null;
+            }
+            return String.join(",", roles);
+        }
+
+        private static String trimToNull(String value) {
+            if (value == null || value.trim().isEmpty()) {
+                return null;
+            }
+            return value.trim();
+        }
+    }
+}
@@ -0,0 +1,179 @@
+package com.eactive.apim.portal.djb.menu;
+
+import com.eactive.apim.portal.menu.entity.PortalMenuItem;
+import com.eactive.apim.portal.menu.entity.PortalMenuPlacement;
+import com.eactive.apim.portal.menu.service.PortalMenuDataService;
+import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/**
+ * 메뉴 트리 스냅샷 캐시.
+ *
+ * <p>매 요청 DB 조회를 피하기 위해 role 비의존 트리를 메모리에 유지한다
+ * (기존 수제 캐시 관례: PageService 의 volatile 필드). TTL 은
+ * PTL_PROPERTY {@code Portal / menu.cache.ttl-seconds} (기본 3600초)이며,
+ * eapim-admin 의 reload 명령(/internal/menu/reload)으로 즉시 갱신된다.
+ * 요청별 role 필터링은 {@link MenuModelAdvice} 가 수행한다.
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class MenuService {
+
+    static final String PROP_GROUP = "Portal";
+    static final String PROP_CACHE_TTL = "menu.cache.ttl-seconds";
+    static final String DEFAULT_CACHE_TTL = "3600";
+    /** 스냅샷이 비어있을 때의 재시도 TTL(초) — 시딩 전 기동 직후 요청 대비 */
+    private static final long EMPTY_RETRY_TTL_SECONDS = 60;
+
+    private final PortalMenuDataService menuDataService;
+    private final PortalPropertyService portalPropertyService;
+
+    private volatile MenuSnapshot snapshot;
+
+    public MenuSnapshot getSnapshot() {
+        MenuSnapshot current = snapshot;
+        if (current != null && !current.isExpired()) {
+            return current;
+        }
+        synchronized (this) {
+            current = snapshot;
+            if (current != null && !current.isExpired()) {
+                return current;
+            }
+            return reload();
+        }
+    }
+
+    /**
+     * DB 에서 트리를 재구축한다. 시더 완료 시점과 admin reload 명령이 호출한다.
+     */
+    public synchronized MenuSnapshot reload() {
+        long ttlSeconds = resolveTtlSeconds();
+        List<PortalMenuItem> items = menuDataService.loadAllItems();
+        List<PortalMenuPlacement> placements = menuDataService.loadAllPlacements();
+
+        Map<String, PortalMenuItem> itemsById = items.stream()
+            .collect(Collectors.toMap(PortalMenuItem::getMenuId, item -> item, (a, b) -> a, LinkedHashMap::new));
+
+        // 가시(visible=Y) 배치만 렌더 트리에 포함
+        Map<String, List<PortalMenuPlacement>> byParent = placements.stream()
+            .filter(PortalMenuPlacement::isVisible)
+            .filter(placement -> itemsById.containsKey(placement.getMenuId()))
+            .collect(Collectors.groupingBy(
+                placement -> placement.getParentId() == null ? "" : placement.getParentId(),
+                LinkedHashMap::new, Collectors.toList()));
+
+        List<MenuNode> roots = buildNodes(byParent.getOrDefault("", Collections.emptyList()), itemsById, byParent);
+
+        // 접근 권한 맵은 배치/노출과 무관하게 항목 기준으로 구성 (숨김 메뉴도 접근 통제 유지)
+        Map<String, List<String>> accessRolesByPath = new LinkedHashMap<>();
+        for (PortalMenuItem item : items) {
+            if (item.getMenuPath() != null && item.getAccessRoles() != null
+                && !item.getAccessRoles().trim().isEmpty()) {
+                accessRolesByPath.put(normalizePath(item.getMenuPath()), splitCsv(item.getAccessRoles()));
+            }
+        }
+
+        if (roots.isEmpty()) {
+            ttlSeconds = Math.min(ttlSeconds, EMPTY_RETRY_TTL_SECONDS);
+        }
+        MenuSnapshot rebuilt = new MenuSnapshot(roots, accessRolesByPath, items.size(),
+            System.currentTimeMillis(), ttlSeconds);
+        snapshot = rebuilt;
+        log.info("메뉴 캐시 갱신 - 항목 {}건, 최상위 {}건, TTL {}초", items.size(), roots.size(), ttlSeconds);
+        return rebuilt;
+    }
+
+    private List<MenuNode> buildNodes(List<PortalMenuPlacement> placements,
+                                      Map<String, PortalMenuItem> itemsById,
+                                      Map<String, List<PortalMenuPlacement>> byParent) {
+        List<MenuNode> nodes = new ArrayList<>();
+        for (PortalMenuPlacement placement : placements) {
+            PortalMenuItem item = itemsById.get(placement.getMenuId());
+            MenuNode node = toNode(item);
+            node.setChildren(buildNodes(
+                byParent.getOrDefault(item.getMenuId(), Collections.emptyList()), itemsById, byParent));
+            nodes.add(node);
+        }
+        return nodes;
+    }
+
+    private MenuNode toNode(PortalMenuItem item) {
+        MenuNode node = new MenuNode();
+        node.setMenuId(item.getMenuId());
+        node.setName(item.getMenuName());
+        node.setPath(normalizePath(item.getMenuPath()));
+        node.setGroup(item.isGroup());
+        node.setSection(item.getMenuSection());
+        node.setIcon(item.getIconClass());
+        node.setNewWindow("Y".equals(item.getNewWindowYn()));
+        node.setExposeRoles(splitCsv(item.getExposeRoles()));
+        node.setAccessRoles(splitCsv(item.getAccessRoles()));
+        return node;
+    }
+
+    private long resolveTtlSeconds() {
+        try {
+            String value = portalPropertyService.getOrCreateProperty(PROP_GROUP, PROP_CACHE_TTL,
+                DEFAULT_CACHE_TTL, "포탈 메뉴 캐시 TTL(초)");
+            return Long.parseLong(value.trim());
+        } catch (Exception e) {
+            log.warn("메뉴 캐시 TTL 조회 실패 - 기본값 {}초 사용", DEFAULT_CACHE_TTL, e);
+            return Long.parseLong(DEFAULT_CACHE_TTL);
+        }
+    }
+
+    private static List<String> splitCsv(String csv) {
+        if (csv == null || csv.trim().isEmpty()) {
+            return Collections.emptyList();
+        }
+        return Arrays.stream(csv.split(","))
+            .map(String::trim)
+            .filter(token -> !token.isEmpty())
+            .collect(Collectors.toList());
+    }
+
+    private static String normalizePath(String path) {
+        if (path == null || path.trim().isEmpty()) {
+            return null;
+        }
+        String normalized = path.trim();
+        int queryIndex = normalized.indexOf('?');
+        return queryIndex >= 0 ? normalized.substring(0, queryIndex) : normalized;
+    }
+
+    /** role 비의존 메뉴 스냅샷 (불변 취급) */
+    @Getter
+    public static class MenuSnapshot {
+        private final List<MenuNode> roots;
+        private final Map<String, List<String>> accessRolesByPath;
+        private final int itemCount;
+        private final long loadedAt;
+        private final long ttlSeconds;
+
+        MenuSnapshot(List<MenuNode> roots, Map<String, List<String>> accessRolesByPath,
+                     int itemCount, long loadedAt, long ttlSeconds) {
+            this.roots = roots;
+            this.accessRolesByPath = accessRolesByPath;
+            this.itemCount = itemCount;
+            this.loadedAt = loadedAt;
+            this.ttlSeconds = ttlSeconds;
+        }
+
+        boolean isExpired() {
+            return System.currentTimeMillis() - loadedAt > ttlSeconds * 1000L;
+        }
+    }
+}
@@ -0,0 +1,108 @@
+package com.eactive.apim.portal.djb.menu;
+
+import lombok.Getter;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 요청별(role 필터 적용) 메뉴 뷰 — 템플릿 모델 {@code menuView}.
+ *
+ * <ul>
+ *   <li>{@link #getGnb()} — 상단 글로벌 네비(GNB 섹션 최상위)</li>
+ *   <li>{@link #getMypage()} — 마이페이지 드롭다운 루트 (미노출 시 null)</li>
+ *   <li>{@link #activeGroup(String)} — service_sidebar 용 활성 그룹 탐색</li>
+ * </ul>
+ */
+@Getter
+public class MenuView {
+
+    /**
+     * service_sidebar 기존 호출부의 activeMenu 키 → 메뉴 ID 브리지.
+     * 호출 페이지 수정 없이 DB 메뉴 기반 사이드바로 전환하기 위한 레거시 맵.
+     */
+    private static final Map<String, String> LEGACY_ACTIVE_KEYS = new HashMap<>();
+
+    static {
+        LEGACY_ACTIVE_KEYS.put("intro", "service-intro");
+        LEGACY_ACTIVE_KEYS.put("guide", "service-guide");
+        LEGACY_ACTIVE_KEYS.put("oauth2", "service-oauth2-guide");
+        LEGACY_ACTIVE_KEYS.put("webhookGuide", "service-webhook-dev-guide");
+        LEGACY_ACTIVE_KEYS.put("notice", "support-notice");
+        LEGACY_ACTIVE_KEYS.put("faq", "support-faq");
+        LEGACY_ACTIVE_KEYS.put("qna", "support-qna");
+        LEGACY_ACTIVE_KEYS.put("feedback", "support-partnership");
+        LEGACY_ACTIVE_KEYS.put("users", "my-page-users");
+        LEGACY_ACTIVE_KEYS.put("apiKey", "my-page-clients");
+        LEGACY_ACTIVE_KEYS.put("webhook", "my-page-webhook");
+        LEGACY_ACTIVE_KEYS.put("statistics", "my-page-statistics");
+        LEGACY_ACTIVE_KEYS.put("profile", "my-page-profile");
+        LEGACY_ACTIVE_KEYS.put("password", "my-page-password");
+    }
+
+    private final List<MenuNode> gnb;
+    private final MenuNode mypage;
+    private final String currentPath;
+
+    public MenuView(List<MenuNode> gnb, MenuNode mypage, String currentPath) {
+        this.gnb = gnb;
+        this.mypage = mypage;
+        this.currentPath = currentPath;
+    }
+
+    /**
+     * 사이드바용 활성 그룹. legacy activeMenu 키 → 메뉴 ID 우선,
+     * 실패 시 현재 경로(정확/prefix) 매칭으로 폴백.
+     */
+    public MenuNode activeGroup(String activeMenu) {
+        String targetId = activeMenu == null ? null : LEGACY_ACTIVE_KEYS.get(activeMenu);
+        MenuNode byId = targetId == null ? null : findRootContaining(node -> targetId.equals(node.getMenuId()));
+        if (byId != null) {
+            return byId;
+        }
+        return findRootContaining(this::matchesCurrentPath);
+    }
+
+    /**
+     * 사이드바 항목 활성 여부: legacy 키 매칭 우선, 경로 매칭 폴백.
+     */
+    public boolean isActive(MenuNode node, String activeMenu) {
+        String targetId = activeMenu == null ? null : LEGACY_ACTIVE_KEYS.get(activeMenu);
+        if (targetId != null) {
+            return targetId.equals(node.getMenuId());
+        }
+        return matchesCurrentPath(node);
+    }
+
+    private MenuNode findRootContaining(java.util.function.Predicate<MenuNode> predicate) {
+        for (MenuNode root : allRoots()) {
+            if (predicate.test(root) || root.getChildren().stream().anyMatch(predicate)) {
+                return root;
+            }
+        }
+        return null;
+    }
+
+    private List<MenuNode> allRoots() {
+        if (mypage == null) {
+            return gnb;
+        }
+        java.util.ArrayList<MenuNode> roots = new java.util.ArrayList<>(gnb);
+        roots.add(mypage);
+        return roots;
+    }
+
+    private boolean matchesCurrentPath(MenuNode node) {
+        if (!node.hasPath() || currentPath == null) {
+            return false;
+        }
+        return currentPath.equals(node.getPath())
+            || currentPath.startsWith(node.getPath() + "/");
+    }
+
+    public static MenuView empty() {
+        return new MenuView(Collections.emptyList(), null, null);
+    }
+}
@@ -0,0 +1,38 @@
+package com.eactive.apim.portal.djb.menu;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.stereotype.Component;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * menu.yml 바인딩 (spring.config.import 로 로드).
+ * 트리(children 중첩) 형태 그대로 바인딩하며, 평탄화는 {@link MenuSeeder} 가 수행한다.
+ */
+@Data
+@Component
+@ConfigurationProperties(prefix = "portal-menu")
+public class PortalMenuYmlProperties {
+
+    private List<MenuItemDef> items = new ArrayList<>();
+
+    @Data
+    public static class MenuItemDef {
+        /** kebab-case 자연키 (^[a-z0-9-]+$) */
+        private String id;
+        private String name;
+        private String path;
+        /** true = 클릭 없는 상위 그룹 */
+        private boolean group;
+        /** GNB(기본) | MYPAGE */
+        private String section;
+        /** FontAwesome 아이콘 클래스 (마이페이지 드롭다운) */
+        private String icon;
+        private boolean newWindow;
+        private List<String> exposeRoles = new ArrayList<>();
+        private List<String> accessRoles = new ArrayList<>();
+        private List<MenuItemDef> children = new ArrayList<>();
+    }
+}
@@ -0,0 +1,47 @@
+package com.eactive.apim.portal.djb.menu;
+
+import com.eactive.apim.portal.portaluser.entity.PortalUserEnums.RoleCode;
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.stereotype.Component;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * roles.yml 바인딩 (spring.config.import 로 로드).
+ * 기존 application.yml 의 {@code portal.portal_security} 를 대체한다.
+ * 로그인 시 권한 확장(PortalUserAuthService)이 직접 사용하며,
+ * DB 미러(PTL_ROLE / PTL_ROLE_AUTHORITY)는 {@link MenuSeeder} 가 적재한다.
+ */
+@Data
+@Component
+@ConfigurationProperties(prefix = "portal-roles")
+public class PortalRolesProperties {
+
+    private List<RoleDef> roles = new ArrayList<>();
+
+    /** AUTHORITY 유형 역할 코드 → 한글 라벨 (admin UI 표기용) */
+    private Map<String, String> authorityNames = new LinkedHashMap<>();
+
+    @Data
+    public static class RoleDef {
+        private String code;
+        private String name;
+        private List<String> authorities = new ArrayList<>();
+    }
+
+    /**
+     * 기본 역할의 파생 권한 목록. 미정의 역할이면 빈 목록.
+     */
+    public List<String> getAuthorities(RoleCode roleCode) {
+        return roles.stream()
+            .filter(role -> role.getCode().equals(roleCode.name()))
+            .findFirst()
+            .map(RoleDef::getAuthorities)
+            .orElse(Collections.emptyList());
+    }
+}
@@ -23,6 +23,10 @@ server:


 spring:
+  config:
+    import:
+      - classpath:menu.yml
+      - classpath:roles.yml
  data:
    web:
      pageable:
@@ -218,26 +222,7 @@ portal:
      view-name: apps/apis/static/tokenApiSpec
      bean: apiHandler

-  portal_security:
-    ROLE_USER:
-      - ROLE_INQUIRY
-      - ROLE_ACCOUNT
-    ROLE_CORP_USER:
-      - ROLE_API_KEY_REQUEST
-      - ROLE_API_KEY_REQUEST_VIEW
-      - ROLE_INQUIRY
-      - ROLE_APP
-      - ROLE_ACCOUNT
-    ROLE_CORP_MANAGER:
-      - ROLE_API_KEY_REQUEST
-      - ROLE_API_KEY_REQUEST_VIEW
-      - ROLE_WEBHOOK
-      - ROLE_INQUIRY
-      - ROLE_APP
-      - ROLE_ACCOUNT
-      - ROLE_CORP_API
-      - ROLE_DASHBOARD
-      - ROLE_USER_MANAGER
+  # portal_security 는 roles.yml (portal-roles) 로 이동
 page:
  home:
    name: "Home"
@@ -0,0 +1,55 @@
+# ------------------------------------------------------------------------------
+# 포탈 GNB 메뉴 정의 (menu.yml)
+#
+# - 부팅 시 PTL_MENU_ITEM 으로 자동 적재(upsert by id). 동일 id 의 내용이 바뀌면
+#   기본값(DFLT_*)이 갱신되고, 관리자가 수정하지 않은 필드만 새 기본값을 따라간다.
+# - 배치(위치) 정보는 PTL_MENU_PLACEMENT 가 비어있을 때만 최초 적재된다.
+#   이후 배치 관리는 eapim-admin "포탈메뉴관리" 화면에서 수행.
+# - id: kebab-case (^[a-z0-9-]+$). 변경 시 새 항목으로 인식되므로 변경 금지.
+# - group: true → 상위 그룹(클릭 없음). path 를 주면 그룹도 링크 동작.
+# - section: GNB(기본) | MYPAGE(마이페이지 드롭다운)
+# - expose-roles / access-roles: 생략=전체 허용, AUTHENTICATED=로그인 사용자,
+#   그 외 역할 코드 나열 시 하나라도 보유하면 허용(any-of)
+# ------------------------------------------------------------------------------
+portal-menu:
+  items:
+    - id: service
+      name: "서비스 소개"
+      group: true
+      children:
+        - { id: service-intro,             name: "API 포탈 소개",    path: /service/intro }
+        - { id: service-guide,             name: "회원가입 안내",     path: /service/guide }
+        - { id: service-oauth2-guide,      name: "OAuth2 개발가이드", path: /service/oauth2-guide }
+        - { id: service-webhook-dev-guide, name: "웹훅 개발가이드",   path: /service/webhook-dev-guide }
+
+    - { id: open-api, name: "오픈 API", path: /apis }
+
+    - id: support
+      name: "고객지원"
+      group: true
+      children:
+        - { id: support-notice,      name: "공지사항",        path: /portalnotice }
+        - { id: support-faq,         name: "FAQ",            path: /faq_list }
+        - { id: support-qna,         name: "Q&A",            path: /inquiry }
+        - { id: support-partnership, name: "피드백/개선요청",  path: /partnership }
+
+    - { id: api-status, name: "API Status", path: /apistatus }
+
+    - id: my-page
+      name: "마이페이지"
+      group: true
+      section: MYPAGE
+      expose-roles: [AUTHENTICATED]
+      children:
+        - { id: my-page-users,      name: "개발자 관리",   path: /users,           icon: fa-users,
+            expose-roles: [ROLE_CORP_MANAGER], access-roles: [ROLE_CORP_MANAGER] }
+        - { id: my-page-clients,    name: "API 신청 관리", path: /clients,         icon: fa-key,
+            expose-roles: [ROLE_APP],          access-roles: [ROLE_APP] }
+        - { id: my-page-webhook,    name: "Webhook 관리",  path: /webhook,         icon: fa-bell,
+            expose-roles: [ROLE_WEBHOOK],      access-roles: [ROLE_WEBHOOK] }
+        - { id: my-page-statistics, name: "이용 통계",     path: /statistics/api,  icon: fa-chart-bar,
+            expose-roles: [ROLE_APP],          access-roles: [ROLE_APP] }
+        - { id: my-page-profile,    name: "내 정보 관리",  path: /mypage,          icon: fa-user-circle,
+            expose-roles: [AUTHENTICATED],     access-roles: [AUTHENTICATED] }
+        - { id: my-page-password,   name: "비밀번호 변경", path: /password/change, icon: fa-lock,
+            expose-roles: [AUTHENTICATED],     access-roles: [AUTHENTICATED] }
@@ -0,0 +1,47 @@
+# ------------------------------------------------------------------------------
+# 포탈 역할 정의 (roles.yml)
+#
+# - 기존 application.yml 의 portal.portal_security 를 이동한 파일.
+# - 로그인 시 권한 확장(PortalUserAuthService)은 이 파일 바인딩을 직접 사용한다.
+# - 부팅 시 PTL_ROLE / PTL_ROLE_AUTHORITY 로 미러 적재되며,
+#   해당 테이블은 eapim-admin 메뉴 권한 선택 UI 소스로만 소비된다.
+# ------------------------------------------------------------------------------
+portal-roles:
+  roles:
+    - code: ROLE_USER
+      name: "개인사용자"
+      authorities:
+        - ROLE_INQUIRY
+        - ROLE_ACCOUNT
+    - code: ROLE_CORP_USER
+      name: "법인사용자"
+      authorities:
+        - ROLE_API_KEY_REQUEST
+        - ROLE_API_KEY_REQUEST_VIEW
+        - ROLE_INQUIRY
+        - ROLE_APP
+        - ROLE_ACCOUNT
+    - code: ROLE_CORP_MANAGER
+      name: "법인관리자"
+      authorities:
+        - ROLE_API_KEY_REQUEST
+        - ROLE_API_KEY_REQUEST_VIEW
+        - ROLE_WEBHOOK
+        - ROLE_INQUIRY
+        - ROLE_APP
+        - ROLE_ACCOUNT
+        - ROLE_CORP_API
+        - ROLE_DASHBOARD
+        - ROLE_USER_MANAGER
+
+  # PTL_ROLE(AUTHORITY 유형) 한글 라벨 — admin 권한 선택 UI 표기용
+  authority-names:
+    ROLE_INQUIRY: "문의 작성"
+    ROLE_ACCOUNT: "계정 관리"
+    ROLE_API_KEY_REQUEST: "인증키 신청"
+    ROLE_API_KEY_REQUEST_VIEW: "인증키 신청 조회"
+    ROLE_APP: "앱/API 신청 관리"
+    ROLE_WEBHOOK: "웹훅 관리"
+    ROLE_CORP_API: "법인 API 조회"
+    ROLE_DASHBOARD: "대시보드"
+    ROLE_USER_MANAGER: "개발자 관리"
@@ -1188,7 +1188,7 @@ hr {
  transition: all 0.3s ease;
 }
 .mobile-drawer .drawer-welcome .btn-drawer-login:hover {
-  background: rgb(0%, 25.7647058824%, 63.5294117647%);
+  background: rgb(0, 65.7, 162);
 }
 .mobile-drawer .drawer-welcome.authenticated {
  flex-direction: row;
@@ -2499,7 +2499,7 @@ hr {
  color: #FFFFFF;
 }
 .btn-success:hover {
-  background: rgb(32.662665066%, 78.1608643457%, 41.762304922%);
+  background: rgb(83.2897959184, 199.3102040816, 106.493877551);
  transform: translateY(-3px);
 }
 .btn-danger {
@@ -2507,7 +2507,7 @@ hr {
  color: #FFFFFF;
 }
 .btn-danger:hover {
-  background: rgb(100%, 27.7647058824%, 27.7647058824%);
+  background: rgb(255, 70.8, 70.8);
  transform: translateY(-3px);
 }
 .btn-ghost {
@@ -2773,7 +2773,7 @@ hr {
 .action-btn-delete:hover {
  transform: translateY(-2px);
  box-shadow: 0 4px 12px rgba(75, 155, 255, 0.1);
-  background: rgb(100%, 34.862745098%, 34.862745098%);
+  background: rgb(255, 88.9, 88.9);
 }
 .action-btn-delete:active {
  transform: translateY(0);
@@ -2891,7 +2891,7 @@ hr {
  background: #a4d6ea;
 }
 .btn-input-action.btn-change:hover {
-  background: rgb(51.6323529412%, 78.2079831933%, 88.8382352941%);
+  background: rgb(131.6625, 199.4303571429, 226.5375);
  transform: translateY(-2px);
  box-shadow: 0 4px 12px rgba(75, 155, 255, 0.1);
 }
@@ -2966,7 +2966,7 @@ hr {
  border: none;
 }
 .btn-action-primary:hover {
-  background: rgb(12.4992826399%, 36.3615494978%, 80.6771879484%);
+  background: rgb(31.8731707317, 92.7219512195, 205.7268292683);
  transform: translateY(-2px);
  color: #fff;
 }
@@ -3016,7 +3016,7 @@ hr {
 }
 .status-badge.status-processing {
  background: rgba(255, 217, 61, 0.1);
-  color: rgb(86.7450980392%, 69.7537901759%, 0%);
+  color: rgb(221.2, 177.8721649485, 0);
 }
 .status-badge.status-failed {
  background: rgba(255, 107, 107, 0.1);
@@ -3056,7 +3056,7 @@ hr {
 }
 .status-badge-header.status-processing {
  background: rgba(255, 217, 61, 0.1);
-  color: rgb(86.7450980392%, 69.7537901759%, 0%);
+  color: rgb(221.2, 177.8721649485, 0);
 }

 .badge-sm {
@@ -4244,7 +4244,7 @@ select.form-control {
 .file-upload-wrapper .file-remove-btn:hover {
  transform: translateY(-2px);
  box-shadow: 0 4px 12px rgba(75, 155, 255, 0.1);
-  background: rgb(100%, 34.862745098%, 34.862745098%);
+  background: rgb(255, 88.9, 88.9);
 }
 .file-upload-wrapper .file-remove-btn:active {
  transform: translateY(0);
@@ -4565,7 +4565,7 @@ select.form-control {
  transition: all 0.3s ease;
 }
 .form-actions--with-withdrawal .withdrawal-link:hover {
-  background: rgb(82.4349376114%, 91.2174688057%, 95.2709447415%);
+  background: rgb(210.2090909091, 232.6045454545, 242.9409090909);
 }
 .form-actions--with-withdrawal .withdrawal-link img {
  width: 22px;
@@ -4720,7 +4720,7 @@ select.form-control {
  text-decoration: underline;
 }
 .notice-content-box a:hover {
-  color: rgb(0%, 25.7647058824%, 63.5294117647%);
+  color: rgb(0, 65.7, 162);
 }

 .form-row--content .form-label-wrapper {
@@ -5656,7 +5656,7 @@ select.form-control {
  font-size: 16px;
 }
 .drawer-logout-btn:hover {
-  background: rgb(100%, 27.7647058824%, 27.7647058824%);
+  background: rgb(255, 70.8, 70.8);
  transform: translateY(-2px);
  box-shadow: 0 8px 24px rgba(75, 155, 255, 0.15);
 }
@@ -6369,7 +6369,7 @@ select.form-control {
  color: #64748b;
 }
 .list-table-btn--default:hover {
-  background-color: rgb(91.512605042%, 91.512605042%, 90.6638655462%);
+  background-color: rgb(233.3571428571, 233.3571428571, 231.1928571429);
 }
 .list-table-btn--primary {
  background-color: #ecf0fa;
@@ -6377,7 +6377,7 @@ select.form-control {
  color: #2a69de;
 }
 .list-table-btn--primary:hover {
-  background-color: rgb(85.0049019608%, 88.1617647059%, 96.0539215686%);
+  background-color: rgb(216.7625, 224.8125, 244.9375);
 }
 .list-table-btn--secondary {
  background-color: #f5f5f4;
@@ -6385,7 +6385,7 @@ select.form-control {
  color: #64748b;
 }
 .list-table-btn--secondary:hover {
-  background-color: rgb(91.512605042%, 91.512605042%, 90.6638655462%);
+  background-color: rgb(233.3571428571, 233.3571428571, 231.1928571429);
 }
 .list-table-btn--danger {
  background-color: #fbe7e9;
@@ -6393,7 +6393,7 @@ select.form-control {
  color: #bb1026;
 }
 .list-table-btn--danger:hover {
-  background-color: rgb(97.081232493%, 82.487394958%, 83.9467787115%);
+  background-color: rgb(247.5571428571, 210.3428571429, 214.0642857143);
 }

 .table-pagination {
@@ -7043,7 +7043,7 @@ select.form-control {
 .alert.alert-error {
  background: rgba(255, 107, 107, 0.1);
  border: 1px solid rgba(255, 107, 107, 0.3);
-  color: rgb(100%, 27.7647058824%, 27.7647058824%);
+  color: rgb(255, 70.8, 70.8);
  align-items: center;
 }
 .alert.alert-error svg {
@@ -7057,7 +7057,7 @@ select.form-control {
 .alert.alert-success {
  background: rgba(107, 207, 127, 0.1);
  border: 1px solid rgba(107, 207, 127, 0.3);
-  color: rgb(24.12484994%, 74.3849539816%, 34.1768707483%);
+  color: rgb(61.5183673469, 189.6816326531, 87.1510204082);
 }
 .alert.alert-info {
  background: rgba(0, 73, 180, 0.1);
@@ -8860,8 +8860,9 @@ button.djb-comment-submit:disabled {
 }
 .api-showcase .api-cards-container {
  display: flex;
+  flex-wrap: wrap;
  gap: 29px;
-  justify-content: center;
+  justify-content: flex-start;
 }
@media (max-width: 1024px) {
  .api-showcase .api-cards-container {
@@ -8878,6 +8879,9 @@ button.djb-comment-submit:disabled {
  }
 }
 .api-showcase .api-card {
+  flex: 0 0 calc((100% - 87px) / 4);
+  max-width: calc((100% - 87px) / 4);
+  box-sizing: border-box;
  height: 288px;
  background: #FFFFFF;
  border: 1px solid var(--border-color);
@@ -8903,12 +8907,16 @@ button.djb-comment-submit:disabled {
 }
@media (max-width: 1024px) {
  .api-showcase .api-card {
+    flex: 0 0 calc(50% - 9px);
+    max-width: calc(50% - 9px);
    width: calc(50% - 9px);
    min-width: 250px;
  }
 }
@media (max-width: 768px) {
  .api-showcase .api-card {
+    flex: 1 1 auto;
+    max-width: 100%;
    width: 100%;
    height: auto;
    min-width: unset;
@@ -11420,10 +11428,10 @@ body.index-page-body {
  line-height: 20px;
 }
 .login-button:hover {
-  background: rgb(10.0588235294%, 27.568627451%, 68.1764705882%);
+  background: rgb(25.65, 70.3, 173.85);
 }
 .login-button:active {
-  background: rgb(9.5294117647%, 26.1176470588%, 64.5882352941%);
+  background: rgb(24.3, 66.6, 164.7);
 }
 .login-button:disabled {
  opacity: 0.6;
@@ -11466,10 +11474,10 @@ body.index-page-body {
  border-bottom-right-radius: 8px;
 }
 .login-links-container .link-btn:hover {
-  background: rgb(86.5137254902%, 89.3529411765%, 96.4509803922%);
+  background: rgb(220.61, 227.85, 245.95);
 }
 .login-links-container .link-btn:active {
-  background: rgb(80.4784313725%, 84.5882352941%, 94.862745098%);
+  background: rgb(205.22, 215.7, 241.9);
 }

 .login-alert {
@@ -11978,12 +11986,12 @@ body.index-page-body {
 }
 .auth-request-button:hover,
 .auth-verify-button:hover {
-  background: rgb(14.6320689023%, 60.3648891332%, 92.1600879604%);
+  background: rgb(37.3117757009, 153.9304672897, 235.0082242991);
  transform: none !important;
 }
 .auth-request-button:active,
 .auth-verify-button:active {
-  background: rgb(8.3967014843%, 57.3774601429%, 91.4307494961%);
+  background: rgb(21.411588785, 146.3125233645, 233.148411215);
 }
 .auth-request-button:disabled,
 .auth-verify-button:disabled {
@@ -12032,10 +12040,10 @@ body.index-page-body {
  background: #f0f2f5;
 }
 .account-recovery-card .form-actions .cancel-button:hover {
-  background: rgb(88.4117647059%, 89.9568627451%, 92.2745098039%);
+  background: rgb(225.45, 229.39, 235.3);
 }
 .account-recovery-card .form-actions .cancel-button:active {
-  background: rgb(82.7058823529%, 85.0117647059%, 88.4705882353%);
+  background: rgb(210.9, 216.78, 225.6);
 }
 .account-recovery-card .form-actions .submit-button {
  color: #FFFFFF;
@@ -12045,7 +12053,7 @@ body.index-page-body {
  background: rgb(6, 54, 125);
 }
 .account-recovery-card .form-actions .submit-button:active {
-  background: rgb(0%, 25.7647058824%, 63.5294117647%);
+  background: rgb(0, 65.7, 162);
 }
 .account-recovery-card .form-actions .submit-button:disabled {
  opacity: 0.6;
@@ -12281,7 +12289,7 @@ body.index-page-body {
  transition: color 0.3s ease;
 }
 .result-info-box .info-text .info-link:hover {
-  color: rgb(0%, 25.7647058824%, 63.5294117647%);
+  color: rgb(0, 65.7, 162);
 }
@media (max-width: 576px) {
  .result-info-box .info-text {
@@ -12747,7 +12755,7 @@ body.index-page-body {
  display: flex;
  align-items: center;
  gap: 15px;
-  border-bottom: 1px solid #000;
+  border-bottom: 1px solid #818181;
  padding-bottom: 12px;
  margin-bottom: 32px;
 }
@@ -17481,7 +17489,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  transition: background 0.2s ease;
 }
 .btn-copy-action:hover {
-  background: rgb(51.6323529412%, 78.2079831933%, 88.8382352941%);
+  background: rgb(131.6625, 199.4303571429, 226.5375);
 }
@media (max-width: 768px) {
  .btn-copy-action {
@@ -17508,7 +17516,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  transition: background 0.2s ease;
 }
 .btn-view-secret:hover {
-  background: rgb(12.5057724024%, 59.377680044%, 91.9648158329%);
+  background: rgb(31.8897196262, 151.4130841121, 234.5102803738);
 }
 .btn-view-secret svg {
  width: 20px;
@@ -17693,7 +17701,7 @@ input[type=checkbox]:checked + .custom-checkbox {
    border-radius: 8px;
  }
  .btn-copy-action:hover {
-    background: rgb(51.6323529412%, 78.2079831933%, 88.8382352941%);
+    background: rgb(131.6625, 199.4303571429, 226.5375);
  }
  .btn-view-secret {
    width: 100% !important;
@@ -17709,7 +17717,7 @@ input[type=checkbox]:checked + .custom-checkbox {
    height: 16px;
  }
  .btn-view-secret:hover {
-    background: rgb(12.5057724024%, 59.377680044%, 91.9648158329%);
+    background: rgb(31.8897196262, 151.4130841121, 234.5102803738);
  }
  #revealedSecretBox {
    width: 100%;
@@ -17982,7 +17990,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  flex-shrink: 0;
 }
 .detail-wrap .dt-btn-copy:hover {
-  background: rgb(74.3529411765%, 90.2296918768%, 100%);
+  background: rgb(189.6, 230.0857142857, 255);
 }
 .detail-wrap .dt-btn-copy svg {
  color: #2a69de;
@@ -18159,7 +18167,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  transition: background 0.2s ease;
 }
 .detail-wrap .dt-btn-gray:hover {
-  background: rgb(66.9250773994%, 71.9364293086%, 75.9455108359%);
+  background: rgb(170.6589473684, 183.4378947368, 193.6610526316);
 }
 .detail-wrap .dt-btn-red {
  width: 156px;
@@ -18177,7 +18185,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  transition: background 0.2s ease;
 }
 .detail-wrap .dt-btn-red:hover {
-  background: rgb(100%, 27.4868759774%, 25.1921568627%);
+  background: rgb(255, 70.0915337423, 64.24);
 }
 .detail-wrap .dt-btn-blue {
  width: 156px;
@@ -19751,7 +19759,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  }
 }
 .btn-inquiry-list:hover {
-  background: rgb(84.6615515772%, 85.8414322251%, 88.2011935209%);
+  background: rgb(215.8869565217, 218.8956521739, 224.9130434783);
 }
 .btn-inquiry-list:active {
  transform: scale(0.98);
@@ -19784,7 +19792,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  }
 }
 .btn-inquiry-edit:hover {
-  background: rgb(0%, 27.1960784314%, 67.0588235294%);
+  background: rgb(0, 69.35, 171);
 }
 .btn-inquiry-edit:active {
  transform: scale(0.98);
@@ -19817,7 +19825,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  }
 }
 .btn-inquiry-delete:hover {
-  background: rgb(85.4839910648%, 16.2218912882%, 22.8577810871%);
+  background: rgb(217.9841772152, 41.3658227848, 58.2873417722);
 }
 .btn-inquiry-delete:active {
  transform: scale(0.98);
@@ -19889,7 +19897,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  margin-left: 8px;
 }
 .file-upload-inline .btn-remove-file-inline:hover {
-  background: rgb(82.1236038719%, 14.2293373045%, 20.7341772152%);
+  background: rgb(209.4151898734, 36.2848101266, 52.8721518987);
 }
 .file-upload-inline .btn-remove-file-inline svg {
  width: 12px;
@@ -19921,7 +19929,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  }
 }
 .file-upload-inline .btn-file-attach:hover {
-  background: rgb(14.6320689023%, 60.3648891332%, 92.1600879604%);
+  background: rgb(37.3117757009, 153.9304672897, 235.0082242991);
 }
 .file-upload-inline .btn-file-attach svg {
  width: 22px;
@@ -19981,7 +19989,7 @@ input[type=checkbox]:checked + .custom-checkbox {
    border: none;
  }
  .inquiry-form-container .form-actions .btn-secondary:hover {
-    background: rgb(84.6615515772%, 85.8414322251%, 88.2011935209%);
+    background: rgb(215.8869565217, 218.8956521739, 224.9130434783);
  }
  .inquiry-form-container .form-actions .btn-primary {
    background: #0049b4;
@@ -19989,7 +19997,7 @@ input[type=checkbox]:checked + .custom-checkbox {
    border: none;
  }
  .inquiry-form-container .form-actions .btn-primary:hover {
-    background: rgb(0%, 27.1960784314%, 67.0588235294%);
+    background: rgb(0, 69.35, 171);
  }
  .inquiry-form-container .file-upload-inline .file-input-display {
    min-height: 50px;
@@ -20778,7 +20786,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  cursor: pointer;
 }
 .djb-board-write-container .form-actions .btn-submit:hover {
-  background-color: rgb(13.193687231%, 38.3816355811%, 85.1592539455%);
+  background-color: rgb(33.643902439, 97.8731707317, 217.156097561);
 }
@media (max-width: 768px) {
  .djb-board-write-container .form-actions .btn-submit {
@@ -20900,7 +20908,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  background: none;
  padding: 0 0 16px 0;
  border-radius: 0;
-  border-bottom: 1px solid #212529;
+  border-bottom: 1px solid #818181;
  margin-bottom: 32px;
 }
 .org-section-header--agreement h3 {
@@ -21314,7 +21322,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  transition: all 0.3s ease;
 }
 .org-file-remove:hover {
-  background: rgb(100%, 27.7647058824%, 27.7647058824%);
+  background: rgb(255, 70.8, 70.8);
 }

 .org-file-notice {
@@ -22326,7 +22334,7 @@ input[type=checkbox]:checked + .custom-checkbox {
 }
 .status-indicator.status-active {
  background-color: rgba(107, 207, 127, 0.1);
-  color: rgb(32.662665066%, 78.1608643457%, 41.762304922%);
+  color: rgb(83.2897959184, 199.3102040816, 106.493877551);
 }
 .status-indicator.status-active .status-dot {
  background-color: #6BCF7F;
@@ -25997,7 +26005,7 @@ input[type=checkbox]:checked + .custom-checkbox {
  justify-content: space-between;
  margin-bottom: 20px;
  padding-bottom: 16px;
-  border-bottom: 1.5px solid #4a4a4a;
+  border-bottom: 1.5px solid #818181;
 }
 .step1-wrap .s1-form-card .webhook-card-head .head-title-group {
  display: flex;
@@ -859,8 +859,9 @@

  .api-cards-container {
    display: flex;
+    flex-wrap: wrap;
    gap: 29px;
-    justify-content: center;
+    justify-content: flex-start;

    //@include respond-to('lg') {
    //  gap: 22px;
@@ -881,6 +882,10 @@
  }

  .api-card {
+    // 1행 4열 고정 (gap 29px * 3 = 87px)
+    flex: 0 0 calc((100% - 87px) / 4);
+    max-width: calc((100% - 87px) / 4);
+    box-sizing: border-box;
    height: 288px;
    background: #FFFFFF;
    border: 1px solid var(--border-color);
@@ -909,12 +914,16 @@
    }

    @include respond-to('md') {
+      flex: 0 0 calc(50% - 9px);
+      max-width: calc(50% - 9px);
      width: calc(50% - 9px);
      min-width: 250px;
    }

    @include respond-to('sm') {
      // Figma 모바일: 144px width, auto height, padding 18px 17px
+      flex: 1 1 auto;
+      max-width: 100%;
      width: 100%;
      height: auto;
      min-width: unset;
@@ -55,7 +55,7 @@
    display: flex;
    align-items: center;
    gap: 15px;
-    border-bottom: 1px solid #000;
+    border-bottom: 1px solid #818181;
    padding-bottom: 12px;
    margin-bottom: 32px;

@@ -137,7 +137,7 @@
    background: none;
    padding: 0 0 $spacing-md 0;
    border-radius: 0;
-    border-bottom: 1px solid #212529;
+    border-bottom: 1px solid #818181;
    margin-bottom: $spacing-xl;

    h3 {
@@ -654,7 +654,7 @@ $wh-bg-soft: #f9f9f9;
    justify-content: space-between;
    margin-bottom: 20px;
    padding-bottom: 16px;
-    border-bottom: 1.5px solid #4a4a4a;
+    border-bottom: 1.5px solid #818181;

    .head-title-group {
      display: flex;
@@ -226,8 +226,8 @@
        </div>

        <div class="api-cards-container">
-          <!-- Services 데이터를 반복하여 API 카드 표시 (최대 4개) -->
-          <div class="api-card" th:each="service, iterStat : ${services}" th:if="${iterStat.index < 4}"
+          <!-- main.service.list 에 등록된 서비스 전체 표시 (1행 4열, 초과분은 다음 행으로) -->
+          <div class="api-card" th:each="service : ${services}"
            th:onclick="${service.id != null} ? |location.href='@{/apis(groupIds=${service.id})}'| : |location.href='@{/apis}'|">
            <h3 class="card-title" th:text="${service.groupName}">API 서비스</h3>
            <p class="card-description">
@@ -114,7 +114,6 @@
                      <input type="checkbox" name="eventTypes" th:value="${et.code}"
                        th:checked="${#lists.contains(webhookModification.eventTypes, et.code)}">
                      <span class="eventtype-name" th:text="${et.name}">이벤트명</span>
-                      <span class="eventtype-code" th:text="${et.code}">CODE</span>
                    </label>
                  </div>
                  <p class="field-error" th:if="${#fields.hasErrors('eventTypes')}" th:errors="*{eventTypes}">이벤트 오류</p>
@@ -24,18 +24,31 @@
          <p class="footer-copyright">Copyright &copy; 2026 JEJU Bank. All Rights Reserved.</p>
        </div>
        <div class="footer-right">
-          <div class="footer-related-sites">
-            <select class="related-sites-select">
-              <option>DJBank 관련 사이트</option>
-              <option>DJBank 홈페이지</option>
-              <option>DJBank 인터넷뱅킹</option>
-              <option>DJBank 모바일뱅킹</option>
+          <!-- 관련 사이트: PortalProperty(Portal/footer.related-sites[.label])로 제어. 목록이 비면 미노출 -->
+          <div class="footer-related-sites" th:if="${!#lists.isEmpty(relatedSites)}">
+            <select class="related-sites-select" data-related-sites th:aria-label="${relatedSitesLabel}">
+              <option value="" th:text="${relatedSitesLabel}">DJBank 관련 사이트</option>
+              <option th:each="site : ${relatedSites}" th:value="${site.url}" th:text="${site.name}"></option>
            </select>
          </div>
          <p class="footer-contact" th:text="'고객센터 ' + ${customerCenterContact}">고객센터 1588-3388</p>
        </div>
      </div>
    </div>
+
+    <script th:inline="none">
+      // 관련 사이트 셀렉트: 선택 시 새 창으로 이동 후 라벨(첫 항목)로 되돌린다.
+      (function () {
+        document.addEventListener('change', function (e) {
+          var el = e.target;
+          if (!el || !el.hasAttribute || !el.hasAttribute('data-related-sites')) return;
+          var url = el.value;
+          el.selectedIndex = 0;
+          if (!url) return;
+          window.open(url, '_blank', 'noopener,noreferrer');
+        });
+      })();
+    </script>
  </footer>
 </body>

@@ -27,28 +27,22 @@
            </div>
          </div>

+          <!-- 상단 GNB: DB 메뉴(menuView) 기반 렌더 — .nav-menu > li / .sub-menu 구조는 하단 JS 의존 -->
          <nav class="header-center">
            <ul class="nav-menu">
-              <li>
-                <a href="#" class="nav-link">서비스 소개</a>
-                <ul class="sub-menu">
-                  <li><a th:href="@{/service/intro}">API 포탈 소개</a></li>
-                  <li><a th:href="@{/service/guide}">회원가입 안내</a></li>
-                  <li><a th:href="@{/service/oauth2-guide}">OAuth2 개발가이드</a></li>
-                  <li><a th:href="@{/service/webhook-dev-guide}">웹훅 개발가이드</a></li>
-                </ul>
+              <li th:each="menu : ${menuView.gnb}">
+                <th:block th:if="${!menu.children.isEmpty()}">
+                  <a th:href="${menu.hasPath()} ? @{${menu.path}} : '#'" class="nav-link" th:text="${menu.name}">메뉴</a>
+                  <ul class="sub-menu">
+                    <li th:each="child : ${menu.children}">
+                      <a th:href="@{${child.path}}" th:target="${child.newWindow} ? '_blank' : null"
+                         th:text="${child.name}">하위 메뉴</a>
+                    </li>
+                  </ul>
+                </th:block>
+                <a th:if="${menu.children.isEmpty()}" th:href="${menu.hasPath()} ? @{${menu.path}} : '#'"
+                   th:target="${menu.newWindow} ? '_blank' : null" class="nav-link" th:text="${menu.name}">메뉴</a>
              </li>
-              <li><a href="/apis" class="nav-link">오픈 API</a></li>
-              <li>
-                <a href="#playground" class="nav-link">고객지원</a>
-                <ul class="sub-menu">
-                  <li><a th:href="@{/portalnotice}">공지사항</a></li>
-                  <li><a th:href="@{/faq_list}">FAQ</a></li>
-                  <li><a th:href="@{/inquiry}">Q&amp;A</a></li>
-                  <li><a th:href="@{/partnership}">피드백/개선요청</a></li>
-                </ul>
-              </li>
-              <li><a th:href="@{/apistatus}" class="nav-link">API Status</a></li>
            </ul>
          </nav>

@@ -76,20 +70,18 @@
                <span class="divider">•</span>
                <a th:href="@{/actionLogout.do}" class="header-link">로그아웃</a>
                <span class="divider">•</span>
-                <div class="mypage-dropdown">
-                  <button class="header-link mypage-toggle" type="button">마이페이지</button>
+                <!-- 마이페이지 드롭다운: DB 메뉴(menuView.mypage) 기반, 노출 권한은 서버 필터 적용 -->
+                <div class="mypage-dropdown" th:if="${menuView.mypage != null}">
+                  <button class="header-link mypage-toggle" type="button"
+                          th:text="${menuView.mypage.name}">마이페이지</button>
                  <div class="mypage-dropdown-menu">
                    <ul class="mypage-menu-list">
-                      <li sec:authorize="hasRole('ROLE_CORP_MANAGER')">
-                        <a th:href="@{/users}"><i class="fas fa-users"></i>개발자 관리</a>
+                      <li th:each="child : ${menuView.mypage.children}">
+                        <a th:href="@{${child.path}}" th:target="${child.newWindow} ? '_blank' : null">
+                          <i th:if="${child.icon != null}" th:class="'fas ' + ${child.icon}"></i>
+                          <th:block th:text="${child.name}">메뉴</th:block>
+                        </a>
                      </li>
-                      <li sec:authorize="hasRole('ROLE_APP')">
-                        <a th:href="@{/clients}"><i class="fas fa-key"></i>API 신청 관리</a>
-                        <a th:href="@{/webhook}" sec:authorize="hasRole('ROLE_WEBHOOK')"><i class="fas fa-bell"></i>Webhook 관리</a>
-                        <a th:href="@{/statistics/api}"><i class="fas fa-chart-bar"></i>이용 통계</a>
-                      </li>
-                      <li><a th:href="@{/mypage}"><i class="fas fa-user-circle"></i>내 정보 관리</a></li>
-                      <li><a th:href="@{/password/change}"><i class="fas fa-lock"></i>비밀번호 변경</a></li>
                    </ul>
                  </div>
                </div>
@@ -184,72 +176,43 @@
        </div>
      </div>

-      <!-- Navigation Menu (Accordion Style) -->
+      <!-- Navigation Menu (Accordion Style): DB 메뉴(menuView) 기반 렌더 -->
+      <!-- .drawer-menu-item / .drawer-menu-btn / .drawer-submenu 구조는 하단 JS 의존 -->
      <nav class="drawer-nav">
        <ul class="drawer-menu-list">
-          <!-- 서비스 소개 -->
-          <li class="drawer-menu-item has-submenu">
-            <button class="drawer-menu-btn" type="button">
-              <span>서비스 소개</span>
-              <svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
-                <path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
-              </svg>
-            </button>
-            <ul class="drawer-submenu">
-              <li><a th:href="@{/service/intro}">API 포탈 소개</a></li>
-              <li><a th:href="@{/service/guide}">회원가입 안내</a></li>
-              <li><a th:href="@{/service/oauth2-guide}">OAuth2 개발가이드</a></li>
-              <li><a th:href="@{/service/webhook-dev-guide}">웹훅 개발가이드</a></li>
-            </ul>
+          <li th:each="menu : ${menuView.gnb}" class="drawer-menu-item"
+              th:classappend="${!menu.children.isEmpty()} ? 'has-submenu' : ''">
+            <th:block th:if="${!menu.children.isEmpty()}">
+              <button class="drawer-menu-btn" type="button">
+                <span th:text="${menu.name}">메뉴</span>
+                <svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
+                  <path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+                </svg>
+              </button>
+              <ul class="drawer-submenu">
+                <li th:each="child : ${menu.children}">
+                  <a th:href="@{${child.path}}" th:target="${child.newWindow} ? '_blank' : null"
+                     th:text="${child.name}">하위 메뉴</a>
+                </li>
+              </ul>
+            </th:block>
+            <a th:if="${menu.children.isEmpty()}" th:href="${menu.hasPath()} ? @{${menu.path}} : '#'"
+               th:target="${menu.newWindow} ? '_blank' : null" class="drawer-menu-btn" th:text="${menu.name}">메뉴</a>
          </li>

-          <!-- API -->
-          <li class="drawer-menu-item has-submenu">
+          <!-- 마이페이지 (노출 권한 서버 필터 — 미노출 시 null) -->
+          <li class="drawer-menu-item has-submenu" th:if="${menuView.mypage != null}">
            <button class="drawer-menu-btn" type="button">
-              <span>API</span>
+              <span th:text="${menuView.mypage.name}">마이페이지</span>
              <svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
              </svg>
            </button>
            <ul class="drawer-submenu">
-              <li><a th:href="@{/apis}">API 마켓</a></li>
-            </ul>
-          </li>
-          <!-- 고객지원 -->
-          <li class="drawer-menu-item has-submenu">
-            <button class="drawer-menu-btn" type="button">
-              <span>고객지원</span>
-              <svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
-                <path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
-              </svg>
-            </button>
-            <ul class="drawer-submenu">
-              <li><a th:href="@{/portalnotice}">공지사항</a></li>
-              <li><a th:href="@{/faq_list}">FAQ</a></li>
-              <li><a th:href="@{/inquiry}">Q&amp;A</a></li>
-              <li><a th:href="@{/partnership}">사업 제휴 문의</a></li>
-            </ul>
-          </li>
-          <!-- API Status -->
-          <li class="drawer-menu-item">
-            <a th:href="@{/apistatus}" class="drawer-menu-btn">API Status</a>
-          </li>
-
-          <!-- 마이페이지 (Authenticated Only) -->
-          <li class="drawer-menu-item has-submenu" sec:authorize="isAuthenticated()">
-            <button class="drawer-menu-btn" type="button">
-              <span>마이페이지</span>
-              <svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
-                <path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
-              </svg>
-            </button>
-            <ul class="drawer-submenu">
-              <li sec:authorize="hasRole('ROLE_CORP_MANAGER')"><a th:href="@{/users}">개발자 관리</a></li>
-              <li sec:authorize="hasRole('ROLE_APP')"><a th:href="@{/clients}">API 신청 관리</a></li>
-              <li sec:authorize="hasRole('ROLE_WEBHOOK')"><a th:href="@{/webhook}">Webhook 관리</a></li>
-              <li sec:authorize="hasRole('ROLE_APP')"><a th:href="@{/statistics/api}">이용 통계</a></li>
-              <li><a th:href="@{/mypage}">내 정보 관리</a></li>
-              <li><a th:href="@{/password/change}">비밀번호 변경</a></li>
+              <li th:each="child : ${menuView.mypage.children}">
+                <a th:href="@{${child.path}}" th:target="${child.newWindow} ? '_blank' : null"
+                   th:text="${child.name}">하위 메뉴</a>
+              </li>
            </ul>
          </li>
        </ul>
@@ -2,41 +2,13 @@
 <html xmlns:th="http://www.thymeleaf.org">

 <body>
-   <!-- Service Left Sidebar Fragment -->
-   <aside class="service-sidebar" th:fragment="sidebar(activeMenu)">
-      <nav class="service-nav">
-         <!-- 서비스 소개 그룹 (Service) -->
-         <th:block
-            th:if="${activeMenu == 'intro' or activeMenu == 'guide' or activeMenu == 'oauth2' or activeMenu == 'webhookGuide'}">
-            <a th:href="@{/service/intro}" th:classappend="${activeMenu == 'intro'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">API 포탈 소개</a>
-            <a th:href="@{/service/guide}" th:classappend="${activeMenu == 'guide'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">회원가입 안내</a>
-            <a th:href="@{/service/oauth2-guide}"
-               th:classappend="${activeMenu == 'oauth2'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">OAuth2 개발가이드</a>
-            <a th:href="@{/service/webhook-dev-guide}"
-               th:classappend="${activeMenu == 'webhookGuide'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">웹훅 개발가이드</a>
-         </th:block>
-
-         <!-- 고객지원 그룹 (Customer Support) -->
-         <th:block
-            th:if="${activeMenu == 'notice' or activeMenu == 'faq' or activeMenu == 'qna' or activeMenu == 'feedback'}">
-            <a th:href="@{/portalnotice}" th:classappend="${activeMenu == 'notice'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">공지사항</a>
-            <a th:href="@{/faq_list}" th:classappend="${activeMenu == 'faq'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">FAQ</a>
-            <a th:href="@{/inquiry}" th:classappend="${activeMenu == 'qna'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">Q&A</a>
-            <a th:href="@{/partnership}" th:classappend="${activeMenu == 'feedback'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">피드백/개선요청</a>
-         </th:block>
-
-         <!-- 마이페이지 그룹 (My Page) -->
-         <th:block
-            th:if="${activeMenu == 'users' or activeMenu == 'apiKey' or activeMenu == 'statistics' or activeMenu == 'webhook' or activeMenu == 'profile' or activeMenu == 'password'}">
-            <!-- Profile Section -->
+   <!-- Service Left Sidebar Fragment: DB 메뉴(menuView) 기반 렌더.
+        activeMenu 파라미터는 기존 호출부 호환용 레거시 키(MenuView.LEGACY_ACTIVE_KEYS 브리지). -->
+   <aside class="service-sidebar" th:fragment="sidebar(activeMenu)"
+          th:with="grp=${menuView.activeGroup(activeMenu)}">
+      <nav class="service-nav" th:if="${grp != null}">
+         <!-- 마이페이지 그룹 프로필 -->
+         <th:block th:if="${grp.section == 'MYPAGE'}">
            <div class="service-sidebar__profile">
               <div class="avatar">
                  <svg viewBox="0 0 24 24" fill="currentColor">
@@ -48,29 +20,14 @@
            </div>

            <div class="service-sidebar__divider"></div>
-
-            <a th:href="@{/users}" th:classappend="${activeMenu == 'users'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item" sec:authorize="hasRole('ROLE_CORP_MANAGER')">개발자 관리</a>
-
-            <a th:href="@{/clients}" th:classappend="${activeMenu == 'apiKey'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item" sec:authorize="hasRole('ROLE_APP')">API 신청 관리</a>
-
-            <a th:href="@{/webhook}" th:classappend="${activeMenu == 'webhook'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item" sec:authorize="hasRole('ROLE_WEBHOOK')">Webhook 관리</a>
-
-            <a th:href="@{/statistics/api}"
-               th:classappend="${activeMenu == 'statistics'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item" sec:authorize="hasRole('ROLE_APP')">이용통계</a>
-
-            <a th:href="@{/mypage}" th:classappend="${activeMenu == 'profile'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">내정보 관리</a>
-
-            <a th:href="@{/password/change}"
-               th:classappend="${activeMenu == 'password'} ? 'service-nav__item--active' : ''"
-               class="service-nav__item">비밀번호 변경</a>
         </th:block>
+
+         <a th:each="child : ${grp.children}" th:href="@{${child.path}}"
+            th:target="${child.newWindow} ? '_blank' : null"
+            th:classappend="${menuView.isActive(child, activeMenu)} ? 'service-nav__item--active' : ''"
+            class="service-nav__item" th:text="${child.name}">메뉴</a>
      </nav>
   </aside>
 </body>

-</html>
+</html>
Author	SHA1	Message	Date
Rinjae	63d4d7268c	Merge branch 'master' into design eapim-portal CI / build (push) Has been cancelled Details eapim-portal Test / test (push) Has been cancelled Details	2026-08-07 10:19:52 +09:00
Rinjae	c42a278c8e	수신자 이름 지정 인증번호 발송 기능 추가: eapim-portal CI / build (push) Has been cancelled Details eapim-portal Test / test (push) Has been cancelled Details - %USER_NAME% 지원 위한 createMessageRecipient 수정 - GUEST_USER_NAME 상수 및 관련 기본값 처리 로직 추가	2026-08-07 09:20:39 +09:00
hong	83352e3669	fix : css 수정	2026-08-06 13:21:41 +09:00
hong	317b8d781d	Merge branch 'design' of http://172.30.1.50:3000/djb-eapim/eapim-portal into design	2026-08-06 13:20:27 +09:00
hong	206e72edde	fix : 디자인 수정	2026-08-06 13:20:21 +09:00
Rinjae	34dce308dc	메뉴 내부 API 허용 IP 검증 로직 개선: eapim-portal CI / build (push) Has been cancelled Details eapim-portal Test / test (push) Has been cancelled Details - IpAddressMatcher로 CIDR/와일드카드 지원 - 허용 IP 목록 설명 필드 추가 - RemoteAddr 정규화 로직 제거	2026-08-06 09:59:34 +09:00
Rinjae	b3fc5c06bf	webhook 수정 화면에서 이벤트 코드 출력 제거. eapim-portal CI / build (push) Has been cancelled Details eapim-portal Test / test (push) Has been cancelled Details	2026-08-06 09:24:48 +09:00
Rinjae	eb74a99a5a	- PersonalDataEncryptConverter: `isFakeMode` 메서드 추가 eapim-portal CI / build (push) Has been cancelled Details eapim-portal Test / test (push) Has been cancelled Details - LegacyEncryptionMigration: 허용 IP 검증 로직 추가 - 스킵 내역 로그 강화 - 암호화 대상 컬럼 추가 및 DamoMode 구분 지원	2026-08-05 17:47:37 +09:00
Rinjae	38e5a7f13c	API 카드 레이아웃 수정: eapim-portal CI / build (push) Has been cancelled Details eapim-portal Test / test (push) Has been cancelled Details - 1행 4열 고정 및 반응형 flex-wrap 적용 - 카드 간격/정렬 방식 및 max-width 설정 추가	2026-08-05 15:42:48 +09:00
Rinjae	3b7c2e5a8f	푸터 "관련 사이트" 조회 및 렌더링 기능 추가: eapim-portal CI / build (push) Has been cancelled Details eapim-portal Test / test (push) Has been cancelled Details - RelatedSite/RelatedSiteService 생성 및 PortalProperty 연계 - GlobalControllerAdvice에서 셀렉트 라벨/목록 주입 - footer.html 템플릿 및 관련 JS 수정	2026-08-05 15:23:59 +09:00
Rinjae	47099ec485	Merge branch 'feats/menu-control' eapim-portal CI / build (push) Has been cancelled Details eapim-portal Test / test (push) Has been cancelled Details	2026-08-05 14:21:22 +09:00
Rinjae	5585df9133	메뉴 기능 추가 - menu.yml GNB 정의 - 접근 인터셉터/뷰 주입/내부 API 구현	2026-08-05 14:19:33 +09:00