[refactor/#442] Auth security 내부 책임 명명 정리 (#446)

* refactor: 리프레시 토큰 저장소 명명 정리

* refactor: auth 캐시 서비스를 redis 의존성에 맞게 Store로 변환

* refactor: auth 캐시 리스너를 cache 패키지 하위로 이동

* refactor: 리프레시 토큰 쿠키 Writer를 Util에서 분리

* docs: 문서를 코드 변경사항에 맞게 정리

* refactor: 리프레시 토큰 쿠키 정책을 Writer에 캡슐화

Author: Dimo-2562

docs/ddd-test-refactoring-roadmap.md

@@ -859,7 +859,7 @@ global/util/ContentCleaner          -> Source / Post shared content support 후
 
 ```text
 1. User Account 4.3
-   - 필요 시 Auth / Security shared seam(UserAuthCacheService, UserPrincipal)만 함께 정리
+   - 필요 시 Auth / Security shared seam(UserAuthCacheStore, UserPrincipal)만 함께 정리
    - Auth / Security 전체 경계 이동은 별도 이슈에서 진행한다
 
 2. Personalization Profile 4.4

docs/domain-strategy.md

@@ -152,7 +152,7 @@ TechFork의 비즈니스 도메인은 다음으로 정의할 수 있다.
 
 1. `UserCommandService`와 `InterestCommandService`는 사용자 상태/관심사 변경 후 이벤트만 발행한다.
 2. `PersonalizationProfileEventListener`가 `OnboardingCompletedEvent`, `UserInterestsChangedEvent`를 `AFTER_COMMIT`에서 받아 개인화 프로필 생성을 요청한다.
-3. `UserAuthCacheEventListener`가 `OnboardingCompletedEvent`는 `AFTER_COMMIT`, `UserWithdrawnEvent`는 `BEFORE_COMMIT + AFTER_COMMIT`으로 받아 인증 캐시를 무효화한다.
+3. `UserAuthCacheInvalidationListener`가 `OnboardingCompletedEvent`는 `AFTER_COMMIT`, `UserWithdrawnEvent`는 `BEFORE_COMMIT + AFTER_COMMIT`으로 받아 인증 캐시를 무효화한다.
 4. `PersonalizationProfileService`는 프로필 생성 orchestration과 생성 완료 이벤트 발행을 맡고, 활동 수집/LLM 분석/저장은 하위 application component로 분리되었다.
 5. 추천 생성은 `PersonalizedProfileGeneratedEvent`를 통해 Recommendation 리스너가 커밋 이후 처리한다.
 6. `PersonalizationProfileDocument`는 독립 write aggregate보다 검색·추천용 read model/projection에 가깝다.
@@ -232,7 +232,7 @@ U/D 표기: **U** = Upstream(상류, 공급자), **D** = Downstream(하류, 소
 | Pair | Seam | From (D, 소비자) | To (U, 공급자) | 관계 유형(현재 As-Is) | 관계 유형(목표 To-Be) | 통신/통합 패턴(목표) | 현재 구현 / 의존 방식 | 해석 및 개선 후보 |
 |---|---|---|---|---|---|---|---|---|
 | Auth / Security ↔ User Account | 사용자 식별/권한 | `Auth / Security` | `User Account` | **SK** | **SK** (Shared Kernel) | 공유 식별자/권한 kernel | `UserRepository`, `User`, `UserPrincipal` 직접 참조 | `UserId`, `Role`, `UserStatus`를 최소 공유 커널로 공유한다. User 전체 모델 공유는 줄이는 것이 목표다. |
-| Auth / Security ↔ User Account | 인증 캐시 무효화 | `Auth / Security` | `User Account` | **OHS/PL 이벤트 handoff** | **OHS/PL** | `OnboardingCompletedEvent`, `UserWithdrawnEvent` | `UserAuthCacheEventListener`가 이벤트를 구독해 `UserAuthCacheService`를 호출 | 온보딩은 커밋 후 캐시 반영 지연을 허용한다. 탈퇴는 보안 민감 seam이라 `BEFORE_COMMIT`에서 실패 시 롤백하고 `AFTER_COMMIT`에서 한 번 더 무효화한다. |
+| Auth / Security ↔ User Account | 인증 캐시 무효화 | `Auth / Security` | `User Account` | **OHS/PL 이벤트 handoff** | **OHS/PL** | `OnboardingCompletedEvent`, `UserWithdrawnEvent` | `UserAuthCacheInvalidationListener`가 이벤트를 구독해 `UserAuthCacheStore`를 호출 | 온보딩은 커밋 후 캐시 반영 지연을 허용한다. 탈퇴는 보안 민감 seam이라 `BEFORE_COMMIT`에서 실패 시 롤백하고 `AFTER_COMMIT`에서 한 번 더 무효화한다. |
 | Notification ↔ User Account | 알림 토큰 소유자 식별 | `Notification` | `User Account` | **SK** (최소 shared identity) | **SK** (최소 Shared Identity) | 사용자 귀속 참조 | `NotificationToken.user` 직접 참조 | 장기적으로는 `UserId` 중심 참조로 축소할 수 있다. |
 | Source / Ingestion ↔ 외부 RSS | 피드 포맷 적응 | `Source / Ingestion` | 외부 RSS | **ACL** | **ACL** (Anti-Corruption Layer) | 외부 어댑터 / 포맷 변환 | `WebClient`, Rome RSS parser | Source가 외부 RSS 형식을 내부 `RssFeedItem`으로 변환한다. 외부 스키마 변경 시 변환 로직만 수정하면 된다. |
 | Source / Ingestion ↔ Post / Content | 기술 게시글 후보 전달 | `Post / Content` | `Source / Ingestion` | **CS + 동기 직접 호출** | **OHS/PL** (Open Host Service / Published Language) | 게시글 후보 Published DTO / 이벤트 handoff | 현재는 `RssFeedItem`을 `Post`로 변환하고 `PostBatchWriter`가 `posts`에 저장 | 현재 구현은 Source가 Post 생성까지 책임지는 동기 직접 호출이다. 목표 상태는 `TechnicalPostDiscovered` 같은 published language/event handoff다. |

docs/test-gap-analysis.md

@@ -275,7 +275,7 @@ ContentChunkerServiceTest
 | `InterestCommandServiceTest` | unit/mock | 관심사 저장, 기존 관심사 clear, invalid keyword category, 관심사 수정 이벤트 발행 |
 | `UserCommandServiceTest` | unit/mock | 온보딩, 계정 프로필 수정, 탈퇴, 온보딩/탈퇴 이벤트 발행 |
 | `PersonalizationProfileEventListenerTest` | unit/mock | 온보딩/관심사 변경 이벤트의 `AFTER_COMMIT` 개인화 프로필 생성 요청 |
-| `UserAuthCacheEventListenerTest` | unit/mock | 온보딩 `AFTER_COMMIT` 캐시 evict, 탈퇴 `BEFORE_COMMIT + AFTER_COMMIT` 캐시 evict |
+| `UserAuthCacheInvalidationListenerTest` | unit/mock | 온보딩 `AFTER_COMMIT` 캐시 evict, 탈퇴 `BEFORE_COMMIT + AFTER_COMMIT` 캐시 evict |
 | `UserAccountAfterCommitEventIntegrationTest` | integration | 커밋 후 후처리 실행, 롤백 시 후처리 미실행, 탈퇴 evict 실패 시 트랜잭션 롤백 |
 | `UserQueryServiceTest` | unit/mock | 계정 프로필 조회 |
 | `PersonalizationProfileServiceTest` | unit/mock | 프로필 생성 성공 시 이벤트 발행, 생성 실패 시 이벤트 미발행 |
@@ -453,8 +453,8 @@ SearchControllerIntegrationTest
 | `OAuth2AuthenticationFailureHandlerTest` | unit/mock | OIDC 로그인 실패 redirect |
 | `CustomOidcUserServiceTest` | unit/mock | Kakao/Apple OIDC 사용자 생성/재사용/재활성화 |
 | `HttpCookieOAuth2AuthorizationRequestRepositoryTest` | unit/mock | OAuth authorization request cookie 저장/로드/삭제 |
-| `UserAuthCacheServiceTest` | unit/mock | auth cache serialization/deserialization |
-| `UserAuthCacheEventListenerTest` | unit/mock | User Account 이벤트 기반 auth cache eviction |
+| `UserAuthCacheStoreTest` | unit/mock | auth cache serialization/deserialization |
+| `UserAuthCacheInvalidationListenerTest` | unit/mock | User Account 이벤트 기반 auth cache eviction |
 
 #### 평가
 

docs/ubiquitous-language/auth-security.md

@@ -37,11 +37,12 @@
 | 내부 용어 | 코드상 표현 | 설명 |
 |---|---|---|
 | 토큰 발급기 | `JwtUtil` | 액세스/리프레시/개발자 토큰 생성과 검증을 담당 |
-| 리프레시 토큰 저장소 | `RefreshTokenService` | Redis/Cookie 기반 리프레시 토큰 저장/검증 서비스 |
+| 리프레시 토큰 저장소 | `RefreshTokenStore` | Redis 기반 리프레시 토큰 저장/검증/삭제 store |
 | 인증 필터 | `JwtAuthenticationFilter` | 요청에서 JWT를 읽어 인증 컨텍스트를 채우는 필터 |
 | OAuth 요청 저장소 | `HttpCookieOAuth2AuthorizationRequestRepository` | OAuth 인증 요청 상태를 쿠키로 보관하는 구성요소 |
-| 사용자 인증 캐시 | `UserAuthCacheService` | 로그인/토큰 갱신 이후 사용자 인증 조회를 보조하는 캐시 |
-| 인증 캐시 이벤트 리스너 | `UserAuthCacheEventListener` | User Account 이벤트를 받아 사용자 인증 캐시를 무효화하는 리스너 |
+| 리프레시 토큰 쿠키 writer | `RefreshTokenCookieWriter` | refresh token `Set-Cookie` 작성/삭제 정책을 담당하는 응답 writer |
+| 사용자 인증 캐시 저장소 | `UserAuthCacheStore` | 로그인/토큰 갱신 이후 사용자 인증 조회를 보조하는 Redis cache store |
+| 인증 캐시 무효화 리스너 | `UserAuthCacheInvalidationListener` | User Account 이벤트를 받아 사용자 인증 캐시를 무효화하는 transactional event adapter |
 
 ## 혼동 금지
 
@@ -75,8 +76,9 @@
 - `src/main/java/com/techfork/auth/security/AuthSecurityConstants.java`
 - `src/main/java/com/techfork/auth/security/config/SecurityConfig.java`
 - `src/main/java/com/techfork/auth/security/jwt/JwtUtil.java`
-- `src/main/java/com/techfork/auth/security/service/RefreshTokenService.java`
-- `src/main/java/com/techfork/auth/security/service/UserAuthCacheService.java`
+- `src/main/java/com/techfork/auth/security/token/RefreshTokenStore.java`
+- `src/main/java/com/techfork/auth/security/cache/UserAuthCacheStore.java`
+- `src/main/java/com/techfork/auth/security/cookie/RefreshTokenCookieWriter.java`
 - `src/main/java/com/techfork/auth/security/util/HeaderUtil.java`
-- `src/main/java/com/techfork/auth/security/listener/UserAuthCacheEventListener.java`
+- `src/main/java/com/techfork/auth/security/cache/UserAuthCacheInvalidationListener.java`
 - `src/main/java/com/techfork/auth/security/oauth/UserPrincipal.java`

src/main/java/com/techfork/auth/application/command/AuthCommandService.java

@@ -9,8 +9,8 @@
 import com.techfork.auth.security.jwt.JwtDTO;
 import com.techfork.auth.security.jwt.JwtProperties;
 import com.techfork.auth.security.jwt.JwtUtil;
-import com.techfork.auth.security.service.RefreshTokenService;
-import com.techfork.auth.security.service.UserAuthCacheService;
+import com.techfork.auth.security.token.RefreshTokenStore;
+import com.techfork.auth.security.cache.UserAuthCacheStore;
 import com.techfork.global.exception.GeneralException;
 import com.techfork.useraccount.application.auth.UserAuthAccountService;
 import com.techfork.useraccount.application.auth.UserAuthProfile;
@@ -29,10 +29,10 @@
 public class AuthCommandService {
 
     private final JwtUtil jwtUtil;
-    private final RefreshTokenService refreshTokenService;
+    private final RefreshTokenStore refreshTokenStore;
     private final UserAuthAccountService userAuthAccountService;
     private final JwtProperties jwtProperties;
-    private final UserAuthCacheService userAuthCacheService;
+    private final UserAuthCacheStore userAuthCacheStore;
 
     public TokenRefreshResult refreshToken(RefreshTokenCommand command) {
         String refreshToken = command.refreshToken();
@@ -48,7 +48,7 @@ public TokenRefreshResult refreshToken(RefreshTokenCommand command) {
         long expiration = jwtProperties.getRefreshTokenExpiration();
         saveRefreshToken(userId, newTokens.refreshToken(), expiration);
 
-        userAuthCacheService.put(userId, userAuthProfile, jwtProperties.getAccessTokenExpiration());
+        userAuthCacheStore.put(userId, userAuthProfile, jwtProperties.getAccessTokenExpiration());
 
         log.info("Token refreshed");
 
@@ -98,18 +98,18 @@ private void validateRefreshTokenRequest(String refreshToken) {
     }
 
     private void validateRefreshTokenInRedis(Long userId, String refreshToken) {
-        if (!refreshTokenService.validateRefreshToken(userId, refreshToken)) {
-            refreshTokenService.deleteRefreshToken(userId);
+        if (!refreshTokenStore.validateRefreshToken(userId, refreshToken)) {
+            refreshTokenStore.deleteRefreshToken(userId);
             log.warn("Refresh token mismatch detected for userId: {}. Session invalidated.", userId);
             throw new GeneralException(AuthErrorCode.REFRESH_TOKEN_MISMATCH);
         }
     }
 
     private void saveRefreshToken(Long userId, String refreshToken, long expiration) {
-        refreshTokenService.saveRefreshToken(userId, refreshToken, expiration);
+        refreshTokenStore.saveRefreshToken(userId, refreshToken, expiration);
     }
 
     private void deleteRefreshToken(Long userId) {
-        refreshTokenService.deleteRefreshToken(userId);
+        refreshTokenStore.deleteRefreshToken(userId);
     }
 }

src/main/java/com/techfork/auth/application/command/KakaoLoginCommandService.java

@@ -8,7 +8,7 @@
 import com.techfork.auth.security.jwt.JwtDTO;
 import com.techfork.auth.security.jwt.JwtProperties;
 import com.techfork.auth.security.jwt.JwtUtil;
-import com.techfork.auth.security.service.RefreshTokenService;
+import com.techfork.auth.security.token.RefreshTokenStore;
 import com.techfork.useraccount.application.auth.UserAuthAccountService;
 import com.techfork.useraccount.application.auth.UserAuthProfile;
 import com.techfork.useraccount.domain.enums.SocialType;
@@ -27,7 +27,7 @@ public class KakaoLoginCommandService {
     private final UserAuthAccountService userAuthAccountService;
     private final JwtUtil jwtUtil;
     private final JwtProperties jwtProperties;
-    private final RefreshTokenService refreshTokenService;
+    private final RefreshTokenStore refreshTokenStore;
 
     public KakaoLoginResult login(KakaoLoginCommand command) {
         KakaoUserInfoResponse kakaoUserInfo = kakaoOAuthService.getUserInfo(command.accessToken());
@@ -45,7 +45,7 @@ public KakaoLoginResult login(KakaoLoginCommand command) {
 
         JwtDTO tokens = jwtUtil.generateTokens(userAuthProfile.id(), userAuthProfile.role());
         long expiration = jwtProperties.getRefreshTokenExpiration();
-        refreshTokenService.saveRefreshToken(userAuthProfile.id(), tokens.refreshToken(), expiration);
+        refreshTokenStore.saveRefreshToken(userAuthProfile.id(), tokens.refreshToken(), expiration);
 
         log.info("Direct Kakao login successful - userId: {}, isRegistered: {}",
                 userAuthProfile.id(), userAuthProfile.active());

src/main/java/com/techfork/auth/presentation/controller/AuthController.java

@@ -7,14 +7,13 @@
 import com.techfork.auth.presentation.annotation.AuthApi;
 import com.techfork.auth.presentation.converter.AuthTokenConverter;
 import com.techfork.auth.presentation.response.TokenRefreshResponse;
-import com.techfork.auth.security.util.CookieUtil;
+import com.techfork.auth.security.cookie.RefreshTokenCookieWriter;
 import com.techfork.global.common.code.SuccessCode;
 import com.techfork.global.response.BaseResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import jakarta.servlet.http.HttpServletResponse;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
-import org.springframework.beans.factory.annotation.Value;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.CookieValue;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -30,9 +29,7 @@ public class AuthController {
 
     private final AuthCommandService authCommandService;
     private final AuthTokenConverter authTokenConverter;
-
-    @Value("${server.domain}")
-    private String domain;
+    private final RefreshTokenCookieWriter refreshTokenCookieWriter;
 
     @Operation(
             summary = "토큰 갱신",
@@ -45,7 +42,7 @@ public ResponseEntity<BaseResponse<TokenRefreshResponse>> refreshToken(
     ) {
         RefreshTokenCommand command = authTokenConverter.toRefreshTokenCommand(refreshToken);
         TokenRefreshResult result = authCommandService.refreshToken(command);
-        CookieUtil.addRefreshTokenCookie(response, domain, result.refreshToken(), result.refreshTokenExpiration());
+        refreshTokenCookieWriter.write(response, result.refreshToken(), result.refreshTokenExpiration());
 
         TokenRefreshResponse tokenResponse = authTokenConverter.toTokenRefreshResponse(result);
         return BaseResponse.of(SuccessCode.OK, tokenResponse);
@@ -62,7 +59,7 @@ public ResponseEntity<BaseResponse<Void>> logout(
     ) {
         LogoutCommand command = authTokenConverter.toLogoutCommand(refreshToken);
         authCommandService.logout(command);
-        CookieUtil.deleteRefreshTokenCookie(response, domain);
+        refreshTokenCookieWriter.delete(response);
         return BaseResponse.of(SuccessCode.OK);
     }
 }

src/main/java/com/techfork/auth/presentation/controller/KakaoLoginController.java

@@ -7,15 +7,14 @@
 import com.techfork.auth.presentation.converter.KakaoLoginConverter;
 import com.techfork.auth.presentation.request.KakaoLoginRequest;
 import com.techfork.auth.presentation.response.KakaoLoginResponse;
-import com.techfork.auth.security.util.CookieUtil;
+import com.techfork.auth.security.cookie.RefreshTokenCookieWriter;
 import com.techfork.global.common.code.SuccessCode;
 import com.techfork.global.response.BaseResponse;
 import io.swagger.v3.oas.annotations.Operation;
 import jakarta.servlet.http.HttpServletResponse;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
-import org.springframework.beans.factory.annotation.Value;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -31,9 +30,7 @@ public class KakaoLoginController {
 
     private final KakaoLoginCommandService kakaoLoginCommandService;
     private final KakaoLoginConverter kakaoLoginConverter;
-
-    @Value("${server.domain}")
-    private String domain;
+    private final RefreshTokenCookieWriter refreshTokenCookieWriter;
 
     @Operation(
             summary = "카카오 로그인",
@@ -46,7 +43,7 @@ public ResponseEntity<BaseResponse<KakaoLoginResponse>> kakaoLogin(
     ) {
         KakaoLoginCommand command = kakaoLoginConverter.toKakaoLoginCommand(request);
         KakaoLoginResult result = kakaoLoginCommandService.login(command);
-        CookieUtil.addRefreshTokenCookie(response, domain, result.refreshToken(), result.refreshTokenExpiration());
+        refreshTokenCookieWriter.write(response, result.refreshToken(), result.refreshTokenExpiration());
 
         KakaoLoginResponse loginResponse = kakaoLoginConverter.toKakaoLoginResponse(result);
         return BaseResponse.of(SuccessCode.OK, loginResponse);

…listener/UserAuthCacheEventListener.java …e/UserAuthCacheInvalidationListener.javasrc/main/java/com/techfork/auth/security/listener/UserAuthCacheEventListener.java renamed to src/main/java/com/techfork/auth/security/cache/UserAuthCacheInvalidationListener.java src/main/java/com/techfork/auth/security/listener/UserAuthCacheEventListener.java renamed to src/main/java/com/techfork/auth/security/cache/UserAuthCacheInvalidationListener.java

@@ -1,6 +1,5 @@
-package com.techfork.auth.security.listener;
+package com.techfork.auth.security.cache;
 
-import com.techfork.auth.security.service.UserAuthCacheService;
 import com.techfork.useraccount.application.event.OnboardingCompletedEvent;
 import com.techfork.useraccount.application.event.UserReactivatedEvent;
 import com.techfork.useraccount.application.event.UserWithdrawnEvent;
@@ -13,14 +12,14 @@
 @Slf4j
 @Component
 @RequiredArgsConstructor
-public class UserAuthCacheEventListener {
+public class UserAuthCacheInvalidationListener {
 
     private static final String ONBOARDING_COMPLETED_AFTER_COMMIT = "onboarding-completed-after-commit";
     private static final String USER_REACTIVATED_AFTER_COMMIT = "user-reactivated-after-commit";
     private static final String USER_WITHDRAWN_BEFORE_COMMIT = "user-withdrawn-before-commit";
     private static final String USER_WITHDRAWN_AFTER_COMMIT = "user-withdrawn-after-commit";
 
-    private final UserAuthCacheService userAuthCacheService;
+    private final UserAuthCacheStore userAuthCacheStore;
 
     @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
     public void evictOnOnboardingCompletedAfterCommit(OnboardingCompletedEvent event) {
@@ -47,7 +46,7 @@ public void evictOnUserWithdrawnAfterCommit(UserWithdrawnEvent event) {
     }
 
     private void evictUserAuthCache(Long userId, String reason) {
-        userAuthCacheService.evict(userId);
+        userAuthCacheStore.evict(userId);
         log.info("User auth cache eviction requested - userId: {}, reason: {}", userId, reason);
     }
 }

…curity/service/UserAuthCacheService.java …h/security/cache/UserAuthCacheStore.javasrc/main/java/com/techfork/auth/security/service/UserAuthCacheService.java renamed to src/main/java/com/techfork/auth/security/cache/UserAuthCacheStore.java src/main/java/com/techfork/auth/security/service/UserAuthCacheService.java renamed to src/main/java/com/techfork/auth/security/cache/UserAuthCacheStore.java

@@ -1,4 +1,4 @@
-package com.techfork.auth.security.service;
+package com.techfork.auth.security.cache;
 
 import com.techfork.auth.security.oauth.UserPrincipal;
 import com.techfork.global.constant.RedisKey;
@@ -9,12 +9,12 @@
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.data.redis.core.StringRedisTemplate;
-import org.springframework.stereotype.Service;
+import org.springframework.stereotype.Component;
 
 @Slf4j
-@Service
+@Component
 @RequiredArgsConstructor
-public class UserAuthCacheService {
+public class UserAuthCacheStore {
 
     private static final String DELIMITER = "|";
     private static final int FIELD_COUNT = 4;