mirror of
https://github.com/ktds-dg0501/kt-event-marketing.git
synced 2025-12-06 10:46:23 +00:00
f7f16e2d18
- 회원가입: 사업자번호 암호화 위치 명시, 성능 지표 추가, 에러 코드 표준화 (USER_001, USER_002) - 로그인: 비동기 처리 설명 추가, Rate Limiting 보안 강화, 성능 목표 추가, 에러 코드 표준화 (AUTH_001) - 프로필수정: 트랜잭션 범위 명확화, Optimistic Locking 추가, 동시성 제어, 에러 코드 표준화 (USER_003~005) - 로그아웃: API Gateway 연계 시나리오, 로그아웃 이벤트 발행, 성능 목표 추가, 에러 코드 표준화 (AUTH_002) - .gitignore 추가: .npm-global 및 기타 임시 파일 제외 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
148 lines
5.3 KiB
Plaintext
148 lines
5.3 KiB
Plaintext
@startuml user-로그인
|
|
!theme mono
|
|
|
|
title User Service - 로그인 내부 시퀀스 (UFR-USER-020)
|
|
|
|
actor Client
|
|
participant "UserController" as Controller <<API Layer>>
|
|
participant "UserService" as Service <<Business Layer>>
|
|
participant "AuthenticationService" as AuthService <<Business Layer>>
|
|
participant "UserRepository" as UserRepo <<Data Layer>>
|
|
participant "PasswordEncoder" as PwdEncoder <<Utility>>
|
|
participant "JwtTokenProvider" as JwtProvider <<Utility>>
|
|
participant "Redis\nCache" as Redis <<E>>
|
|
participant "User DB\n(PostgreSQL)" as UserDB <<E>>
|
|
|
|
note over Controller, UserDB
|
|
**UFR-USER-020: 로그인**
|
|
- 입력: 전화번호, 비밀번호
|
|
- 비밀번호 검증 (bcrypt compare)
|
|
- JWT 토큰 발급
|
|
- 세션 저장 (Redis)
|
|
- 최종 로그인 시각 업데이트
|
|
end note
|
|
|
|
Client -> Controller: POST /api/users/login\n(LoginRequest DTO)
|
|
activate Controller
|
|
|
|
Controller -> Controller: @Valid 어노테이션 검증\n(필수 필드 확인)
|
|
|
|
Controller -> AuthService: authenticate(phoneNumber, password)
|
|
activate AuthService
|
|
|
|
== 1단계: 사용자 조회 ==
|
|
|
|
AuthService -> Service: findByPhoneNumber(phoneNumber)
|
|
activate Service
|
|
Service -> UserRepo: findByPhoneNumber(phoneNumber)
|
|
activate UserRepo
|
|
UserRepo -> UserDB: SELECT user_id, password_hash,\nrole, name, email\nFROM users\nWHERE phone_number = ?
|
|
activate UserDB
|
|
UserDB --> UserRepo: 사용자 정보 또는 NULL
|
|
deactivate UserDB
|
|
UserRepo --> Service: Optional<User>
|
|
deactivate UserRepo
|
|
Service --> AuthService: Optional<User>
|
|
deactivate Service
|
|
|
|
alt 사용자 없음
|
|
AuthService --> Controller: throw AuthenticationFailedException\n("전화번호 또는 비밀번호를 확인해주세요")
|
|
Controller --> Client: 401 Unauthorized\n{"code": "AUTH_001",\n"error": "전화번호 또는 비밀번호를\n확인해주세요"}
|
|
deactivate AuthService
|
|
deactivate Controller
|
|
|
|
else 사용자 존재
|
|
|
|
== 2단계: 비밀번호 검증 ==
|
|
|
|
AuthService -> PwdEncoder: matches(rawPassword, passwordHash)
|
|
activate PwdEncoder
|
|
PwdEncoder -> PwdEncoder: bcrypt compare\n(입력 비밀번호 vs 저장된 해시)
|
|
PwdEncoder --> AuthService: boolean (일치 여부)
|
|
deactivate PwdEncoder
|
|
|
|
alt 비밀번호 불일치
|
|
AuthService --> Controller: throw AuthenticationFailedException\n("전화번호 또는 비밀번호를 확인해주세요")
|
|
Controller --> Client: 401 Unauthorized\n{"code": "AUTH_001",\n"error": "전화번호 또는 비밀번호를\n확인해주세요"}
|
|
deactivate AuthService
|
|
deactivate Controller
|
|
|
|
else 비밀번호 일치
|
|
|
|
== 3단계: JWT 토큰 생성 ==
|
|
|
|
AuthService -> JwtProvider: generateToken(userId, role)
|
|
activate JwtProvider
|
|
JwtProvider -> JwtProvider: JWT 토큰 생성\n(Claims: userId, role=OWNER,\nexp=7일)
|
|
JwtProvider --> AuthService: JWT 토큰
|
|
deactivate JwtProvider
|
|
|
|
== 4단계: 세션 저장 ==
|
|
|
|
AuthService -> Redis: SET user:session:{token}\n(userId, role, TTL 7일)
|
|
activate Redis
|
|
Redis --> AuthService: 세션 저장 완료
|
|
deactivate Redis
|
|
|
|
== 5단계: 최종 로그인 시각 업데이트 (비동기) ==
|
|
|
|
AuthService ->> Service: updateLastLoginAt(userId)
|
|
activate Service
|
|
note right of Service
|
|
**비동기 처리**
|
|
- @Async 어노테이션 사용
|
|
- 로그인 응답 지연 방지
|
|
- 별도 스레드풀에서 실행
|
|
end note
|
|
Service ->> UserRepo: updateLastLoginAt(userId)
|
|
activate UserRepo
|
|
UserRepo ->> UserDB: UPDATE users\nSET last_login_at = NOW()\nWHERE user_id = ?
|
|
activate UserDB
|
|
UserDB -->> UserRepo: 업데이트 완료
|
|
deactivate UserDB
|
|
UserRepo -->> Service: void
|
|
deactivate UserRepo
|
|
Service -->> AuthService: void (비동기 완료)
|
|
deactivate Service
|
|
|
|
note over AuthService, Service
|
|
**비동기 화살표 설명**
|
|
- `->>`: 비동기 호출 (호출 후 즉시 반환)
|
|
- `-->>`: 비동기 응답 (별도 스레드에서 완료)
|
|
end note
|
|
|
|
== 6단계: 응답 반환 ==
|
|
|
|
AuthService -> AuthService: 응답 DTO 생성\n(LoginResponse)
|
|
AuthService --> Controller: LoginResponse\n(token, userId, userName,\nrole, email)
|
|
deactivate AuthService
|
|
|
|
Controller --> Client: 200 OK\n{"token": "jwt_token",\n"userId": 123,\n"userName": "홍길동",\n"role": "OWNER",\n"email": "hong@example.com"}
|
|
deactivate Controller
|
|
end
|
|
end
|
|
|
|
note over Controller, UserDB
|
|
**보안 처리**
|
|
- 비밀번호: bcrypt compare (원본 노출 안 됨)
|
|
- 에러 메시지: 전화번호/비밀번호 구분 없이 동일 메시지 반환 (Timing Attack 방어)
|
|
- JWT 토큰: 7일 만료, 서버 세션과 동기화
|
|
|
|
**보안 강화 (향후 구현)**
|
|
- Rate Limiting: IP당 5분에 5회 로그인 실패 시 임시 차단 (15분)
|
|
- Account Lockout: 동일 계정 10회 실패 시 계정 잠금 (관리자 해제)
|
|
- MFA: 2단계 인증 추가 (SMS/TOTP)
|
|
- Anomaly Detection: 비정상 로그인 패턴 감지 (지역, 디바이스 변경)
|
|
|
|
**성능 최적화**
|
|
- 최종 로그인 시각 업데이트: 비동기 처리 (@Async)
|
|
- 평균 응답 시간: 0.5초 이내
|
|
- P95 응답 시간: 1.0초 이내
|
|
- Redis 세션 조회: 0.1초 이내
|
|
|
|
**에러 코드**
|
|
- AUTH_001: 인증 실패 (전화번호 또는 비밀번호 불일치)
|
|
end note
|
|
|
|
@enduml
|