mirror of
https://github.com/ktds-dg0501/kt-event-marketing.git
synced 2025-12-06 14:06:23 +00:00
166 lines
5.3 KiB
Plaintext
166 lines
5.3 KiB
Plaintext
@startuml 사용자인증플로우
|
|
!theme mono
|
|
|
|
title KT AI 기반 소상공인 이벤트 자동 생성 서비스 - 사용자 인증 플로우 (외부 시퀀스)
|
|
|
|
actor "사용자\n(소상공인)" as User
|
|
participant "Frontend\n(Web/Mobile)" as Frontend
|
|
participant "API Gateway" as Gateway
|
|
participant "User Service" as UserService
|
|
database "User DB\n(PostgreSQL)" as UserDB
|
|
|
|
== UFR-USER-010: 회원가입 플로우 ==
|
|
|
|
User -> Frontend: 회원가입 화면 접근
|
|
activate Frontend
|
|
|
|
User -> Frontend: 회원 정보 입력\n(이름, 전화번호, 이메일, 비밀번호,\n매장명, 업종, 주소, 사업자번호)
|
|
Frontend -> Frontend: 클라이언트 측 유효성 검증\n(이메일 형식, 비밀번호 8자 이상 등)
|
|
|
|
Frontend -> Gateway: POST /api/users/register\n(회원 정보)
|
|
activate Gateway
|
|
|
|
Gateway -> Gateway: Request 검증\n(필수 필드, 데이터 타입)
|
|
|
|
Gateway -> UserService: POST /api/users/register\n(회원 정보)
|
|
activate UserService
|
|
|
|
UserService -> UserService: 서버 측 유효성 검증\n(이름 2자 이상, 전화번호 형식 등)
|
|
|
|
UserService -> UserDB: 전화번호로 사용자 조회\n(중복 가입 확인)
|
|
activate UserDB
|
|
UserDB --> UserService: 기존 사용자 확인 결과
|
|
deactivate UserDB
|
|
|
|
alt 중복 사용자 존재
|
|
UserService --> Gateway: 400 Bad Request\n(이미 등록된 전화번호)
|
|
Gateway --> Frontend: 400 Bad Request
|
|
Frontend --> User: "이미 가입된 전화번호입니다"
|
|
else 신규 사용자
|
|
|
|
UserService -> UserService: 비밀번호 해싱\n(bcrypt, Cost Factor 10)
|
|
|
|
UserService -> UserService: 사업자번호 암호화\n(AES-256)
|
|
|
|
UserService -> UserDB: 트랜잭션 시작
|
|
activate UserDB
|
|
|
|
UserService -> UserDB: 사용자 정보 저장\n(이름, 전화번호, 이메일,\n비밀번호해시, 생성일시)
|
|
UserDB --> UserService: user_id 반환
|
|
|
|
UserService -> UserDB: 매장 정보 저장\n(사용자ID, 매장명, 업종,\n주소, 암호화된사업자번호,\n영업시간)
|
|
UserDB --> UserService: store_id 반환
|
|
|
|
UserService -> UserDB: 트랜잭션 커밋
|
|
deactivate UserDB
|
|
|
|
UserService -> UserService: JWT 토큰 생성\n(user_id, role=OWNER,\nexp=7일)
|
|
|
|
UserService --> Gateway: 201 Created\n(JWT 토큰, 사용자 정보)
|
|
deactivate UserService
|
|
|
|
Gateway --> Frontend: 201 Created\n(JWT 토큰, 사용자 정보)
|
|
deactivate Gateway
|
|
|
|
Frontend -> Frontend: JWT 토큰 저장\n(LocalStorage 또는 Cookie)
|
|
|
|
Frontend --> User: "회원가입이 완료되었습니다"
|
|
|
|
Frontend -> Gateway: 대시보드 화면으로 이동
|
|
deactivate Frontend
|
|
end
|
|
|
|
== UFR-USER-020: 로그인 플로우 ==
|
|
|
|
User -> Frontend: 로그인 화면 접근
|
|
activate Frontend
|
|
|
|
User -> Frontend: 전화번호, 비밀번호 입력
|
|
|
|
Frontend -> Frontend: 클라이언트 측 유효성 검증\n(필수 필드 확인)
|
|
|
|
Frontend -> Gateway: POST /api/users/login\n(전화번호, 비밀번호)
|
|
activate Gateway
|
|
|
|
Gateway -> Gateway: Request 검증
|
|
|
|
Gateway -> UserService: POST /api/users/login\n(전화번호, 비밀번호)
|
|
activate UserService
|
|
|
|
UserService -> UserDB: 전화번호로 사용자 조회\n(로그인 인증용)
|
|
activate UserDB
|
|
UserDB --> UserService: 사용자 정보\n(user_id, password_hash, role)
|
|
deactivate UserDB
|
|
|
|
alt 사용자 없음
|
|
UserService --> Gateway: 401 Unauthorized\n(인증 실패)
|
|
Gateway --> Frontend: 401 Unauthorized
|
|
Frontend --> User: "전화번호 또는 비밀번호를\n확인해주세요"
|
|
else 사용자 존재
|
|
|
|
UserService -> UserService: 비밀번호 검증\n(bcrypt compare)
|
|
|
|
alt 비밀번호 불일치
|
|
UserService --> Gateway: 401 Unauthorized\n(인증 실패)
|
|
Gateway --> Frontend: 401 Unauthorized
|
|
Frontend --> User: "전화번호 또는 비밀번호를\n확인해주세요"
|
|
else 비밀번호 일치
|
|
|
|
UserService -> UserService: JWT 토큰 생성\n(user_id, role=OWNER,\nexp=7일)
|
|
|
|
UserService -> UserDB: 최종 로그인 시각 업데이트\n(현재 시각으로 갱신)
|
|
activate UserDB
|
|
UserDB --> UserService: 업데이트 완료
|
|
deactivate UserDB
|
|
|
|
UserService --> Gateway: 200 OK\n(JWT 토큰, 사용자 정보)
|
|
deactivate UserService
|
|
|
|
Gateway --> Frontend: 200 OK\n(JWT 토큰, 사용자 정보)
|
|
deactivate Gateway
|
|
|
|
Frontend -> Frontend: JWT 토큰 저장\n(LocalStorage 또는 Cookie)
|
|
|
|
Frontend --> User: 로그인 성공
|
|
|
|
Frontend -> Gateway: 대시보드 화면으로 이동
|
|
deactivate Frontend
|
|
end
|
|
end
|
|
|
|
== UFR-USER-040: 로그아웃 플로우 ==
|
|
|
|
User -> Frontend: 프로필 탭 접근
|
|
activate Frontend
|
|
|
|
User -> Frontend: "로그아웃" 버튼 클릭
|
|
|
|
Frontend -> Frontend: 확인 다이얼로그 표시\n"로그아웃 하시겠습니까?"
|
|
|
|
User -> Frontend: "확인" 클릭
|
|
|
|
Frontend -> Gateway: POST /api/users/logout\nAuthorization: Bearer {JWT}
|
|
activate Gateway
|
|
|
|
Gateway -> Gateway: JWT 토큰 검증
|
|
|
|
Gateway -> UserService: POST /api/users/logout\n(JWT 토큰)
|
|
activate UserService
|
|
|
|
UserService -> UserService: JWT 토큰 블랙리스트에 추가\n(만료 시까지 유효)
|
|
|
|
UserService --> Gateway: 200 OK\n(로그아웃 성공)
|
|
deactivate UserService
|
|
|
|
Gateway --> Frontend: 200 OK
|
|
deactivate Gateway
|
|
|
|
Frontend -> Frontend: JWT 토큰 삭제\n(LocalStorage 또는 Cookie)
|
|
|
|
Frontend --> User: "안전하게 로그아웃되었습니다"
|
|
|
|
Frontend -> Gateway: 로그인 화면으로 이동
|
|
deactivate Frontend
|
|
|
|
@enduml
|