초기 프로젝트 설정 및 설계 문서 추가

🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2026-06-13 16:59:10 +00:00 · 2025-10-24 10:10:16 +09:00
commit 3f6e005026
76 changed files with 37842 additions and 0 deletions
@@ -0,0 +1,149 @@
+@startuml user-회원가입
+!theme mono
+
+title User Service - 회원가입 내부 시퀀스 (UFR-USER-010)
+
+participant "UserController" as Controller <<API Layer>>
+participant "UserService" as Service <<Business Layer>>
+participant "UserRepository" as UserRepo <<Data Layer>>
+participant "StoreRepository" as StoreRepo <<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>>
+actor Client
+
+note over Controller, UserDB
+**UFR-USER-010: 회원가입**
+- 기본 정보: 이름, 전화번호, 이메일, 비밀번호
+- 매장 정보: 매장명, 업종, 주소, 영업시간, 사업자번호
+- 이메일/전화번호 중복 검사
+- 트랜잭션 처리
+- JWT 토큰 발급
+end note
+
+Client -> Controller: POST /api/users/register\n{"name": "홍길동",\n"phoneNumber": "01012345678",\n"email": "hong@example.com",\n"password": "password123"}
+activate Controller
+
+Controller -> Controller: 입력값 검증\n(이메일 형식, 비밀번호 8자 이상 등)
+
+Controller -> Service: register(RegisterRequest)
+activate Service
+
+== 1단계: 이메일 중복 확인 ==
+
+Service -> UserRepo: findByEmail(email)
+activate UserRepo
+UserRepo -> UserDB: 이메일로 사용자 조회\n(중복 가입 확인)
+activate UserDB
+UserDB --> UserRepo: 조회 결과 반환 또는 없음
+deactivate UserDB
+UserRepo --> Service: Optional<User>
+deactivate UserRepo
+
+alt 이메일 중복 존재
+    Service --> Controller: throw DuplicateEmailException\n("이미 가입된 이메일입니다")
+    Controller --> Client: 400 Bad Request\n{"code": "USER_001",\n"message": "이미 가입된 이메일입니다"}
+    deactivate Service
+    deactivate Controller
+
+else 이메일 신규
+
+    == 2단계: 전화번호 중복 확인 ==
+
+    Service -> UserRepo: findByPhoneNumber(phoneNumber)
+    activate UserRepo
+    UserRepo -> UserDB: 전화번호로 사용자 조회\n(중복 가입 확인)
+    activate UserDB
+    UserDB --> UserRepo: 조회 결과 반환 또는 없음
+    deactivate UserDB
+    UserRepo --> Service: Optional<User>
+    deactivate UserRepo
+
+    alt 전화번호 중복 존재
+        Service --> Controller: throw DuplicatePhoneException\n("이미 가입된 전화번호입니다")
+        Controller --> Client: 400 Bad Request\n{"code": "USER_002",\n"message": "이미 가입된 전화번호입니다"}
+        deactivate Service
+        deactivate Controller
+
+    else 신규 사용자
+
+        == 3단계: 비밀번호 해싱 ==
+
+        Service -> PwdEncoder: encode(rawPassword)
+        activate PwdEncoder
+        PwdEncoder -> PwdEncoder: bcrypt 해싱\n(Cost Factor 10)
+        PwdEncoder --> Service: passwordHash
+        deactivate PwdEncoder
+
+        == 4단계: 데이터베이스 트랜잭션 ==
+
+        Service -> UserDB: 트랜잭션 시작
+        activate UserDB
+
+        Service -> UserRepo: save(User)
+        activate UserRepo
+        UserRepo -> UserDB: 사용자 정보 저장\n(이름, 전화번호, 이메일,\n비밀번호해시, 생성일시)\n저장 후 사용자ID 반환
+        UserDB --> UserRepo: 생성된 사용자ID
+        UserRepo --> Service: User 엔티티\n(userId 포함)
+        deactivate UserRepo
+
+        Service -> StoreRepo: save(Store)
+        activate StoreRepo
+        StoreRepo -> UserDB: 매장 정보 저장\n(사용자ID, 매장명, 업종,\n주소, 사업자번호, 영업시간)\n저장 후 매장ID 반환
+        UserDB --> StoreRepo: 생성된 매장ID
+        StoreRepo --> Service: Store 엔티티\n(storeId 포함)
+        deactivate StoreRepo
+
+        Service -> UserDB: 트랜잭션 커밋
+        UserDB --> Service: 커밋 완료
+        deactivate UserDB
+
+        == 5단계: JWT 토큰 생성 ==
+
+        Service -> JwtProvider: generateToken(userId, role)
+        activate JwtProvider
+        JwtProvider -> JwtProvider: JWT 토큰 생성\n(Claims: userId, role=OWNER,\nexp=7일)
+        JwtProvider --> Service: JWT 토큰
+        deactivate JwtProvider
+
+        == 6단계: 세션 저장 ==
+
+        Service -> Redis: 세션 정보 저장\nKey: user:session:{token}\nValue: {userId, role}\nTTL: 7일
+        activate Redis
+        Redis --> Service: 저장 완료
+        deactivate Redis
+
+        == 7단계: 응답 반환 ==
+
+        Service -> Service: 회원가입 응답 DTO 생성
+        Service --> Controller: RegisterResponse\n{token, userId, userName, storeId, storeName}
+        deactivate Service
+
+        Controller --> Client: 201 Created\n{"token": "eyJhbGc...",\n"userId": 123,\n"userName": "홍길동",\n"storeId": 456,\n"storeName": "맛있는집"}
+        deactivate Controller
+    end
+    end
+end
+
+note over Controller, UserDB
+**Transaction Rollback 처리**
+- 트랜잭션 실패 시 자동 Rollback
+- User/Store INSERT 중 하나라도 실패 시 전체 롤백
+- 예외: DataAccessException, ConstraintViolationException
+
+**보안 처리**
+- 비밀번호: bcrypt 해싱 (Cost Factor 10)
+- JWT 토큰: 7일 만료, 서버 세션과 동기화
+
+**성능 목표**
+- 평균 응답 시간: 1.0초 이내
+- P95 응답 시간: 1.5초 이내
+- 트랜잭션 처리: 0.5초 이내
+
+**에러 코드**
+- USER_001: 이메일 중복
+- USER_002: 전화번호 중복
+end note
+
+@enduml