diff --git a/design/backend/api/user-service-api.yaml b/design/backend/api/user-service-api.yaml index 75832d1..4bf6415 100644 --- a/design/backend/api/user-service-api.yaml +++ b/design/backend/api/user-service-api.yaml @@ -7,7 +7,7 @@ info: 사용자 인증 및 매장정보 관리를 담당하는 마이크로서비스 **주요 기능:** - - 회원가입 (사업자번호 검증 포함) + - 회원가입 - 로그인/로그아웃 - 프로필 조회 및 수정 - 비밀번호 변경 @@ -15,7 +15,6 @@ info: **보안:** - JWT Bearer 토큰 기반 인증 - bcrypt 비밀번호 해싱 - - AES-256-GCM 사업자번호 암호화 version: 1.0.0 contact: name: Digital Garage Team @@ -48,17 +47,14 @@ paths: **주요 기능:** - 기본 정보 및 매장 정보 등록 - - 사업자번호 검증 (국세청 API 연동) - 비밀번호 bcrypt 해싱 - JWT 토큰 자동 발급 **처리 흐름:** 1. 중복 사용자 확인 (전화번호 기반) - 2. 사업자번호 검증 (국세청 API, Circuit Breaker 패턴) - 3. 비밀번호 해싱 (bcrypt) - 4. 사업자번호 암호화 (AES-256-GCM) - 5. User/Store 데이터베이스 트랜잭션 처리 - 6. JWT 토큰 생성 및 세션 저장 (Redis) + 2. 비밀번호 해싱 (bcrypt) + 3. User/Store 데이터베이스 트랜잭션 처리 + 4. JWT 토큰 생성 및 세션 저장 (Redis) operationId: registerUser x-user-story: UFR-USER-010 x-controller: UserController @@ -80,7 +76,6 @@ paths: industry: 음식점 address: 서울시 강남구 테헤란로 123 businessHours: "월-금 11:00-22:00, 토-일 12:00-21:00" - businessNumber: "1234567890" cafe: summary: 카페 회원가입 예시 value: @@ -92,7 +87,6 @@ paths: industry: 카페 address: 서울시 서초구 서초대로 456 businessHours: "매일 09:00-20:00" - businessNumber: "9876543210" responses: '201': description: 회원가입 성공 @@ -122,12 +116,6 @@ paths: code: USER_001 message: 이미 가입된 전화번호입니다 timestamp: 2025-10-22T10:30:00Z - invalidBusinessNumber: - summary: 사업자번호 검증 실패 - value: - code: USER_002 - message: 유효하지 않은 사업자번호입니다. 휴폐업 여부를 확인해주세요. - timestamp: 2025-10-22T10:30:00Z validationError: summary: 입력 검증 오류 value: @@ -610,7 +598,6 @@ components: - storeName - industry - address - - businessNumber properties: name: type: string @@ -657,11 +644,6 @@ components: maxLength: 200 description: 영업시간 (선택 사항) example: "월-금 11:00-22:00, 토-일 12:00-21:00" - businessNumber: - type: string - pattern: '^\d{10}$' - description: 사업자번호 (10자리 숫자) - example: "1234567890" RegisterResponse: type: object @@ -990,7 +972,6 @@ components: example: USER_001 enum: - USER_001 # 중복 사용자 - - USER_002 # 사업자번호 검증 실패 - USER_003 # 사용자 없음 - USER_004 # 현재 비밀번호 불일치 - USER_005 # 동시성 충돌